淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
out_uuid	String	必须	1		请求流水
hotel_code	String	可选	1		商家酒店编码
vendor	String	可选	taobao	默认值：taobao	商家vendor
type	String	可选	1	默认值：1	1
page_no	Number	可选	1	默认值：1	页码

名称	类型	示例值	描述
hotel_sign_info	DchotelSignDo	结果对象	hotelSignInfo，当入参中包含hotelcode和vendor的时候，返回该对象
└ private_receipt_account_status Number 1 privateReceiptAccountStatus └ hotelier_id_status Number 身份证 0=未提供，1=已提交，2=审核打回，3=审核完成 hotelierIdStatus └ stl_status Number 特种行业许可证 0=未提供，1=已提交，2=审核打回，3=审核完成 stlStatus └ bl_status Number 1 blStatus └ tacc_auth_letter_allow_date Date ID确认函手工确认时间 taccAuthLetterAllowDate └ id_confirm_letter_status Number ID确认函 0=未提供，1=已提交，2=审核打回，3=审核完成 idConfirmLetterStatus └ qlf_type Number 资质类型 1=企业资质，2=个体工商户资质，3=个人资质 qlfType └ pay_type Number 支付类型 0=个人支付宝,1=企业支付宝，2=对私银行卡,3=对公银行卡 payType └ phone String 电话 phone └ email String 邮箱 email └ name String 姓名 name └ is_kezhan_sign Number 是否客栈签约 isKezhanSign └ sign_status Number 签约状态 signStatus └ pid Number 签约ID pid └ hid Number 阿里酒店code hid └ intent_achieve_date Date intentAchieveDate intentAchieveDate └ hotel_account String hotelAccount hotelAccount └ hotel_pictures_status Number 门头照 0=未提供，1=已提交，2=审核打回，3=审核完成 hotelPicturesStatus └ comm_letter_status Number 承诺函 0=未提供，1=已提交，2=审核打回，3=审核完成 commLetterStatus └ to_dc_hotel_status Number 空=直连，1=补签，3=已转换 toDcHotelStatus
out_uuid	String	返回外部请求流水号	outUuid
ds_nhotel_info_d_o_list	DsNhotelInfoDo []	分页查询出参数列表	dsNhotelInfoDOList，当入参不包含hotelcode的时候，只有vendor的时候返回该对象
└ online_status Number 上线状态 onlineStatus └ online_date Date 上线时间 onlineDate └ qualification_type Number 资质类型 qualificationType └ account_type Number 账号类型（0：个人支付宝账号 1：企业支付宝 2：对私银行卡账号 3：对公银行卡账号） accountType └ train_status Number 培训状态。0-未培训；1-已培训；2-通过；3-培训未通过 trainStatus └ comm_letter_status Number ID承诺函审批状态(0未提交，1已提交，2审核失败, 3审核通过) commLetterStatus └ private_receipt_account_status Number 个人收款账号授权(0未提交，1已提交，2审核失败, 3审核通过) privateReceiptAccountStatus └ hotelier_id_status Number 身份证审批状态(0未提交，1已提交，2审核失败, 3审核通过) hotelierIdStatus └ srl_status Number 特种行业许可证审批状态(0未提交，1已提交，2审核失败, 3审核通过) srlStatus └ business_license_status Number 营业执照审批状态(0未提交，1已提交，2审核失败, 3审核通过) businessLicenseStatus └ id_confirm_letter_status Number ID授权函状态修改时间 idConfirmLetterStatus └ sign_date Date 酒店首次次签约时间 signDate └ is_signed Number 是否签约 1：是 0：否 isSigned └ is_account_apply Number 账号申请状态：1：已经申请 0：未申请 isAccountApply └ name String 酒店实例名称 name └ hid Number 酒店实例hid hid └ outer_id String 商家酒店编码 outerId └ is_kezhan Number 是否是客栈，0不是，1是 isKezhan └ hotel_pictures_status Number 门头照审批状态(0未提交，1已提交，2审核失败, 3审核通过) hotelPicturesStatus └ can_sell_status Number 酒店可售状态， 1可售，0不可售 canSellStatus └ can_sell_date Date 可售时间 canSellDate

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelOrderHotelsignQueryRequest req = new XhotelOrderHotelsignQueryRequest();
req.setOutUuid("1");
req.setHotelCode("1");
req.setVendor("taobao");
req.setType("1");
req.setPageNo(1L);
XhotelOrderHotelsignQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

XML示例
JSON示例

<xhotel_order_hotelsign_query_response>
    <hotel_sign_info>
        <private_receipt_account_status>1</private_receipt_account_status>
        <hotelier_id_status>身份证 0=未提供，1=已提交，2=审核打回，3=审核完成</hotelier_id_status>
        <stl_status>特种行业许可证  0=未提供，1=已提交，2=审核打回，3=审核完成</stl_status>
        <bl_status>1</bl_status>
        <tacc_auth_letter_allow_date>ID确认函手工确认时间</tacc_auth_letter_allow_date>
        <id_confirm_letter_status>ID确认函  0=未提供，1=已提交，2=审核打回，3=审核完成</id_confirm_letter_status>
        <qlf_type>资质类型  1=企业资质，2=个体工商户资质，3=个人资质</qlf_type>
        <pay_type>支付类型 0=个人支付宝,1=企业支付宝，2=对私银行卡,3=对公银行卡</pay_type>
        <phone>电话</phone>
        <email>邮箱</email>
        <name>姓名</name>
        <is_kezhan_sign>是否客栈签约</is_kezhan_sign>
        <sign_status>签约状态</sign_status>
        <pid>签约ID</pid>
        <hid>阿里酒店code</hid>
        <intent_achieve_date>intentAchieveDate</intent_achieve_date>
        <hotel_account>hotelAccount</hotel_account>
        <hotel_pictures_status>门头照 0=未提供，1=已提交，2=审核打回，3=审核完成</hotel_pictures_status>
        <comm_letter_status>承诺函  0=未提供，1=已提交，2=审核打回，3=审核完成</comm_letter_status>
        <to_dc_hotel_status>空=直连，1=补签，3=已转换</to_dc_hotel_status>
    </hotel_sign_info>
    <out_uuid>返回外部请求流水号</out_uuid>
    <ds_nhotel_info_d_o_list>
        <ds_nhotel_info_do>
            <online_status>上线状态</online_status>
            <online_date>上线时间</online_date>
            <qualification_type>资质类型</qualification_type>
            <account_type>账号类型（0：个人支付宝账号 1：企业支付宝 2：对私银行卡账号 3：对公银行卡账号）</account_type>
            <train_status>培训状态。0-未培训；1-已培训；2-通过；3-培训未通过</train_status>
            <comm_letter_status>ID承诺函审批状态(0未提交，1已提交，2审核失败, 3审核通过)</comm_letter_status>
            <private_receipt_account_status>个人收款账号授权(0未提交，1已提交，2审核失败, 3审核通过)</private_receipt_account_status>
            <hotelier_id_status>身份证审批状态(0未提交，1已提交，2审核失败, 3审核通过)</hotelier_id_status>
            <srl_status>特种行业许可证审批状态(0未提交，1已提交，2审核失败, 3审核通过)</srl_status>
            <business_license_status>营业执照审批状态(0未提交，1已提交，2审核失败, 3审核通过)</business_license_status>
            <id_confirm_letter_status>ID授权函状态修改时间</id_confirm_letter_status>
            <sign_date>酒店首次次签约时间</sign_date>
            <is_signed>是否签约 1： 是 0：否</is_signed>
            <is_account_apply>账号申请状态：1： 已经申请 0：未申请</is_account_apply>
            <name>酒店实例名称</name>
            <hid>酒店实例hid</hid>
            <outer_id>商家酒店编码</outer_id>
            <is_kezhan>是否是客栈，0不是，1是</is_kezhan>
            <hotel_pictures_status>门头照审批状态(0未提交，1已提交，2审核失败, 3审核通过)</hotel_pictures_status>
            <can_sell_status>酒店可售状态， 1可售，0不可售</can_sell_status>
            <can_sell_date>可售时间</can_sell_date>
        </ds_nhotel_info_do>
    </ds_nhotel_info_d_o_list>
</xhotel_order_hotelsign_query_response>

{
    "xhotel_order_hotelsign_query_response":{
        "hotel_sign_info":{
            "private_receipt_account_status":1,
            "hotelier_id_status":身份证 0=未提供，1=已提交，2=审核打回，3=审核完成,
            "stl_status":特种行业许可证  0=未提供，1=已提交，2=审核打回，3=审核完成,
            "bl_status":1,
            "tacc_auth_letter_allow_date":"ID确认函手工确认时间",
            "id_confirm_letter_status":ID确认函  0=未提供，1=已提交，2=审核打回，3=审核完成,
            "qlf_type":资质类型  1=企业资质，2=个体工商户资质，3=个人资质,
            "pay_type":支付类型 0=个人支付宝,1=企业支付宝，2=对私银行卡,3=对公银行卡,
            "phone":"电话",
            "email":"邮箱",
            "name":"姓名",
            "is_kezhan_sign":是否客栈签约,
            "sign_status":签约状态,
            "pid":签约ID,
            "hid":阿里酒店code,
            "intent_achieve_date":"intentAchieveDate",
            "hotel_account":"hotelAccount",
            "hotel_pictures_status":门头照 0=未提供，1=已提交，2=审核打回，3=审核完成,
            "comm_letter_status":承诺函  0=未提供，1=已提交，2=审核打回，3=审核完成,
            "to_dc_hotel_status":空=直连，1=补签，3=已转换
        },
        "out_uuid":"返回外部请求流水号",
        "ds_nhotel_info_d_o_list":{
            "ds_nhotel_info_do":[
                {
                    "online_status":上线状态,
                    "online_date":"上线时间",
                    "qualification_type":资质类型,
                    "account_type":账号类型（0：个人支付宝账号 1：企业支付宝 2：对私银行卡账号 3：对公银行卡账号）,
                    "train_status":培训状态。0-未培训；1-已培训；2-通过；3-培训未通过,
                    "comm_letter_status":ID承诺函审批状态(0未提交，1已提交，2审核失败, 3审核通过),
                    "private_receipt_account_status":个人收款账号授权(0未提交，1已提交，2审核失败, 3审核通过),
                    "hotelier_id_status":身份证审批状态(0未提交，1已提交，2审核失败, 3审核通过),
                    "srl_status":特种行业许可证审批状态(0未提交，1已提交，2审核失败, 3审核通过),
                    "business_license_status":营业执照审批状态(0未提交，1已提交，2审核失败, 3审核通过),
                    "id_confirm_letter_status":ID授权函状态修改时间,
                    "sign_date":"酒店首次次签约时间",
                    "is_signed":是否签约 1： 是 0：否,
                    "is_account_apply":账号申请状态：1： 已经申请 0：未申请,
                    "name":"酒店实例名称",
                    "hid":酒店实例hid,
                    "outer_id":"商家酒店编码",
                    "is_kezhan":是否是客栈，0不是，1是,
                    "hotel_pictures_status":门头照审批状态(0未提交，1已提交，2审核失败, 3审核通过),
                    "can_sell_status":酒店可售状态， 1可售，0不可售,
                    "can_sell_date":"可售时间"
                }
            ]
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

酒店API

taobao.xhotel.order.hotelsign.query (获取直连酒店（客栈）签约上线进度信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ