淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
create_req	CreateReq	必须			请求类
hotel_contact HotelContact 必须联系人信息 └ phone String 必须 13000000000 联系人电话 └ name String 必须言五联系人姓名 └ email String 可选 yanwu@163.com 联系人邮箱 └ rate_plan_id Number 必须 5034684006007 价格政策id hotel_invoice_do HotelInvoiceDO 可选发票信息 └ invoice_content String 可选发票内容发票内容 receiver_do ReceiverDO 可选收件人信息 └ receiver_address String 可选测试收件人地址收件人完整地址 └ receiver_tel String 可选 18817654300 收件人电话 └ province String 可选浙江省份 └ city String 可选杭州城市 └ receiver_name String 可选测试收件人收件人姓名 └ postal_code String 可选 311600 邮编 └ district String 可选测试行政区 └ express_payer_type Number 可选 0 0:未知,1:卖家承担,2:买家承担 └ invoice_type Number 可选 0 发票类型：0:增值税普通发票(纸质),1:增值税专用发票(纸质),2:增值税普通发票(电子),21:增值税普通发票(电子/商家自主开票) sp_invoice_do SpInvoiceDO 可选专票信息 └ account_no String 可选测试银行账户公司银行账户 └ register_addr String 可选浙江省杭州市公司注册地址 └ tel String 可选 10086 公司电话 └ tax_no String 可选测试公司税号公司税号 └ opening_bank String 可选测试公司开户行公司开户行 └ invoice_email String 可选 yanwu@163.com 接收发票邮箱，电子发票场景，必填 └ invoice_category Number 可选 0 发票种类：0:公司 1：个人 └ invoice_title String 可选飞猪发票抬头 └ invoice_remark String 可选测试发票备注发票备注 └ number_of_rooms Number 必须 1 房间数 └ ex_params String 可选 {} 扩展参数,Map └ number_of_adults_per_room Number 必须 1 每间房的成人数 └ customers String 必须 {} 每间房入住人信息 └ create_key String 必须 1668599700194_2136014816685996989693333e0cdc_2a49fe84ff0e4557b5f988e86d25512a 数据验证接口返回的key hotel_order_validate_do HotelOrderValidateDO 必须需要校验的下单商品数据 └ promotion_total_price Number 必须 0 优惠总金额, 单位为分 └ distributor String 必须 hello 分销渠道 └ user_id Number 可选 456487 用户绑定的淘宝号 └ item_id Number 必须 577125383862 商品id └ check_in Date 必须 2022-11-16 15:00:00 入住日期 hotel_arrival_time HotelArrivalTime 必须到店时间 └ latest_arrival_time Date 必须 2022-11-16 15:00:00 最早到店时间 └ earliest_arrival_time Date 必须 2022-11-16 15:00:00 最晚到店时间 └ out_order_id String 必须 4684153154 外部订单号 └ total_room_price Number 必须 10000 总房价 └ check_out Date 必须 2022-11-17 14:00:00 离店时间 promotion_list HotelPromotionDetailDO [] 可选 [] 优惠明细 └ promotion_name String 可选百亿补贴优惠名称 └ promotion_type Number 可选 0 优惠类型 └ promotion_price Number 可选 1000 优惠金额 └ promotion_id String 可选 10sfgv 优惠唯一标识 └ user_uniq_key String 可选 156468478 外部用户唯一标识 └ after_promotion_price Number 可选 2222 优惠后价格（分） = 总房价（分） - 优惠总金额（分） └ buyer_payment Number 可选 198 买家实付金额（分）

名称	类型	示例值	描述
error_msg	String	系统异常，请稍后重试	错误信息
result	CreateResp		结果
└ tid Number 3035909269095214604 飞猪订单号 └ out_order_id String 4564645 外部订单号
error_resp_code	Number	101	错误码
code_for_dev	String	101	提供给开发者的错误码
msg_for_dev	String	参数错误	提供给开发者的错误信息
is_success	Boolean	false	请求是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelOrderDistributionCreateRequest req = new XhotelOrderDistributionCreateRequest();
XhotelOrderDistributionCreateRequest.CreateReq obj1 = new XhotelOrderDistributionCreateRequest.CreateReq();
XhotelOrderDistributionCreateRequest.HotelContact obj2 = new XhotelOrderDistributionCreateRequest.HotelContact();
obj2.setPhone("13000000000");
obj2.setName("言五");
obj2.setEmail("yanwu@163.com");
obj1.setHotelContact(obj2);
obj1.setRatePlanId(5034684006007L);
XhotelOrderDistributionCreateRequest.HotelInvoiceDO obj3 = new XhotelOrderDistributionCreateRequest.HotelInvoiceDO();
obj3.setInvoiceContent("发票内容");
XhotelOrderDistributionCreateRequest.ReceiverDO obj4 = new XhotelOrderDistributionCreateRequest.ReceiverDO();
obj4.setReceiverAddress("测试收件人地址");
obj4.setReceiverTel("18817654300");
obj4.setProvince("浙江");
obj4.setCity("杭州");
obj4.setReceiverName("测试收件人");
obj4.setPostalCode("311600");
obj4.setDistrict("测试");
obj4.setExpressPayerType(0L);
obj3.setReceiverDo(obj4);
obj3.setInvoiceType(0L);
XhotelOrderDistributionCreateRequest.SpInvoiceDO obj5 = new XhotelOrderDistributionCreateRequest.SpInvoiceDO();
obj5.setAccountNo("测试银行账户");
obj5.setRegisterAddr("浙江省杭州市");
obj5.setTel("10086");
obj5.setTaxNo("测试公司税号");
obj5.setOpeningBank("测试公司开户行");
obj3.setSpInvoiceDo(obj5);
obj3.setInvoiceEmail("yanwu@163.com");
obj3.setInvoiceCategory(0L);
obj3.setInvoiceTitle("飞猪");
obj3.setInvoiceRemark("测试发票备注");
obj1.setHotelInvoiceDo(obj3);
obj1.setNumberOfRooms(1L);
obj1.setExParams("{}");
obj1.setNumberOfAdultsPerRoom(1L);
obj1.setCustomers("{}");
obj1.setCreateKey("1668599700194_2136014816685996989693333e0cdc_2a49fe84ff0e4557b5f988e86d25512a");
XhotelOrderDistributionCreateRequest.HotelOrderValidateDO obj6 = new XhotelOrderDistributionCreateRequest.HotelOrderValidateDO();
obj6.setPromotionTotalPrice(0L);
obj1.setHotelOrderValidateDo(obj6);
obj1.setDistributor("hello");
obj1.setUserId(456487L);
obj1.setItemId(577125383862L);
obj1.setCheckIn(StringUtils.parseDateTime("2022-11-16 15:00:00"));
XhotelOrderDistributionCreateRequest.HotelArrivalTime obj7 = new XhotelOrderDistributionCreateRequest.HotelArrivalTime();
obj7.setLatestArrivalTime(StringUtils.parseDateTime("2022-11-16 15:00:00"));
obj7.setEarliestArrivalTime(StringUtils.parseDateTime("2022-11-16 15:00:00"));
obj1.setHotelArrivalTime(obj7);
obj1.setOutOrderId("4684153154");
obj1.setTotalRoomPrice(10000L);
obj1.setCheckOut(StringUtils.parseDateTime("2022-11-17 14:00:00"));
List<XhotelOrderDistributionCreateRequest.HotelPromotionDetailDO> list9 = new ArrayList<XhotelOrderDistributionCreateRequest.HotelPromotionDetailDO>();
XhotelOrderDistributionCreateRequest.HotelPromotionDetailDO obj10 = new XhotelOrderDistributionCreateRequest.HotelPromotionDetailDO();
list9.add(obj10);
obj10.setPromotionName("百亿补贴");
obj10.setPromotionType(0L);
obj10.setPromotionPrice(1000L);
obj10.setPromotionId("10sfgv");
obj1.setPromotionList(list9);
obj1.setUserUniqKey("156468478");
obj1.setAfterPromotionPrice(2222L);
obj1.setBuyerPayment(198L);
req.setCreateReq(obj1);
XhotelOrderDistributionCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
XhotelOrderDistributionCreateRequest req = new XhotelOrderDistributionCreateRequest();
XhotelOrderDistributionCreateRequest.CreateReqDomain obj1 = new XhotelOrderDistributionCreateRequest.CreateReqDomain();
XhotelOrderDistributionCreateRequest.HotelContactDomain obj2 = new XhotelOrderDistributionCreateRequest.HotelContactDomain();
obj2.Phone = "13000000000";
obj2.Name = "言五";
obj2.Email = "yanwu@163.com";
obj1.HotelContact= obj2;
obj1.RatePlanId = 5034684006007L;
XhotelOrderDistributionCreateRequest.HotelInvoiceDODomain obj3 = new XhotelOrderDistributionCreateRequest.HotelInvoiceDODomain();
obj3.InvoiceContent = "发票内容";
XhotelOrderDistributionCreateRequest.ReceiverDODomain obj4 = new XhotelOrderDistributionCreateRequest.ReceiverDODomain();
obj4.ReceiverAddress = "测试收件人地址";
obj4.ReceiverTel = "18817654300";
obj4.Province = "浙江";
obj4.City = "杭州";
obj4.ReceiverName = "测试收件人";
obj4.PostalCode = "311600";
obj4.District = "测试";
obj4.ExpressPayerType = 0L;
obj3.ReceiverDo= obj4;
obj3.InvoiceType = 0L;
XhotelOrderDistributionCreateRequest.SpInvoiceDODomain obj5 = new XhotelOrderDistributionCreateRequest.SpInvoiceDODomain();
obj5.AccountNo = "测试银行账户";
obj5.RegisterAddr = "浙江省杭州市";
obj5.Tel = "10086";
obj5.TaxNo = "测试公司税号";
obj5.OpeningBank = "测试公司开户行";
obj3.SpInvoiceDo= obj5;
obj3.InvoiceEmail = "yanwu@163.com";
obj3.InvoiceCategory = 0L;
obj3.InvoiceTitle = "飞猪";
obj3.InvoiceRemark = "测试发票备注";
obj1.HotelInvoiceDo= obj3;
obj1.NumberOfRooms = 1L;
obj1.ExParams = "{}";
obj1.NumberOfAdultsPerRoom = 1L;
obj1.Customers = "{}";
obj1.CreateKey = "1668599700194_2136014816685996989693333e0cdc_2a49fe84ff0e4557b5f988e86d25512a";
XhotelOrderDistributionCreateRequest.HotelOrderValidateDODomain obj6 = new XhotelOrderDistributionCreateRequest.HotelOrderValidateDODomain();
obj6.PromotionTotalPrice = 0L;
obj1.HotelOrderValidateDo= obj6;
obj1.Distributor = "hello";
obj1.UserId = 456487L;
obj1.ItemId = 577125383862L;
obj1.CheckIn = DateTime.Parse(2022-11-16 15:00:00");
XhotelOrderDistributionCreateRequest.HotelArrivalTimeDomain obj7 = new XhotelOrderDistributionCreateRequest.HotelArrivalTimeDomain();
obj7.LatestArrivalTime = DateTime.Parse(2022-11-16 15:00:00");
obj7.EarliestArrivalTime = DateTime.Parse(2022-11-16 15:00:00");
obj1.HotelArrivalTime= obj7;
obj1.OutOrderId = "4684153154";
obj1.TotalRoomPrice = 10000L;
obj1.CheckOut = DateTime.Parse(2022-11-17 14:00:00");
List<XhotelOrderDistributionCreateRequest.HotelPromotionDetailDODomain> list9 = new List<XhotelOrderDistributionCreateRequest.HotelPromotionDetailDODomain>();
XhotelOrderDistributionCreateRequest.HotelPromotionDetailDODomain obj10 = new XhotelOrderDistributionCreateRequest.HotelPromotionDetailDODomain();
list9.Add(obj10);
obj10.PromotionName = "百亿补贴";
obj10.PromotionType = 0L;
obj10.PromotionPrice = 1000L;
obj10.PromotionId = "10sfgv";
obj1.PromotionList= list9;
obj1.UserUniqKey = "156468478";
obj1.AfterPromotionPrice = 2222L;
obj1.BuyerPayment = 198L;
req.CreateReq_ = obj1;
XhotelOrderDistributionCreateResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new XhotelOrderDistributionCreateRequest;
$create_req = new CreateReq;
$hotel_contact = new HotelContact;
$hotel_contact->phone="13000000000";
$hotel_contact->name="言五";
$hotel_contact->email="yanwu@163.com";
$create_req->hotel_contact = $hotel_contact;
$create_req->rate_plan_id="5034684006007";
$hotel_invoice_do = new HotelInvoiceDO;
$hotel_invoice_do->invoice_content="发票内容";
$receiver_do = new ReceiverDO;
$receiver_do->receiver_address="测试收件人地址";
$receiver_do->receiver_tel="18817654300";
$receiver_do->province="浙江";
$receiver_do->city="杭州";
$receiver_do->receiver_name="测试收件人";
$receiver_do->postal_code="311600";
$receiver_do->district="测试";
$receiver_do->express_payer_type="0";
$hotel_invoice_do->receiver_do = $receiver_do;
$hotel_invoice_do->invoice_type="0";
$sp_invoice_do = new SpInvoiceDO;
$sp_invoice_do->account_no="测试银行账户";
$sp_invoice_do->register_addr="浙江省杭州市";
$sp_invoice_do->tel="10086";
$sp_invoice_do->tax_no="测试公司税号";
$sp_invoice_do->opening_bank="测试公司开户行";
$hotel_invoice_do->sp_invoice_do = $sp_invoice_do;
$hotel_invoice_do->invoice_email="yanwu@163.com";
$hotel_invoice_do->invoice_category="0";
$hotel_invoice_do->invoice_title="飞猪";
$hotel_invoice_do->invoice_remark="测试发票备注";
$create_req->hotel_invoice_do = $hotel_invoice_do;
$create_req->number_of_rooms="1";
$create_req->ex_params="{}";
$create_req->number_of_adults_per_room="1";
$create_req->customers="{}";
$create_req->create_key="1668599700194_2136014816685996989693333e0cdc_2a49fe84ff0e4557b5f988e86d25512a";
$hotel_order_validate_do = new HotelOrderValidateDO;
$hotel_order_validate_do->promotion_total_price="0";
$create_req->hotel_order_validate_do = $hotel_order_validate_do;
$create_req->distributor="hello";
$create_req->user_id="456487";
$create_req->item_id="577125383862";
$create_req->check_in="2022-11-16 15:00:00";
$hotel_arrival_time = new HotelArrivalTime;
$hotel_arrival_time->latest_arrival_time="2022-11-16 15:00:00";
$hotel_arrival_time->earliest_arrival_time="2022-11-16 15:00:00";
$create_req->hotel_arrival_time = $hotel_arrival_time;
$create_req->out_order_id="4684153154";
$create_req->total_room_price="10000";
$create_req->check_out="2022-11-17 14:00:00";
$promotion_list = new HotelPromotionDetailDO;
$promotion_list->promotion_name="百亿补贴";
$promotion_list->promotion_type="0";
$promotion_list->promotion_price="1000";
$promotion_list->promotion_id="10sfgv";
$create_req->promotion_list = $promotion_list;
$create_req->user_uniq_key="156468478";
$create_req->after_promotion_price="2222";
$create_req->buyer_payment="198";
$req->setCreateReq(json_encode($create_req));
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.xhotel.order.distribution.create' \
-d 'partner_id=apidoc' \
-d 'sign=6EA62BEB30F4D93AFBF02B3B0160A391' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-19+15%3A43%3A35' \
-d 'v=2.0' \
-d 'create_req=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.XhotelOrderDistributionCreateRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.create_req="数据结构示例JSON格式"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.xhotel.order.distribution.create");
add_param(pRequest,"create_req","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.xhotel.order.distribution.create', {
	'create_req':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<xhotel_order_distribution_create_response>
    <error_msg>系统异常，请稍后重试</error_msg>
    <result>
        <tid>3035909269095214604</tid>
        <out_order_id>4564645</out_order_id>
    </result>
    <error_resp_code>101</error_resp_code>
    <code_for_dev>101</code_for_dev>
    <msg_for_dev>参数错误</msg_for_dev>
    <is_success>false</is_success>
</xhotel_order_distribution_create_response>

{
    "xhotel_order_distribution_create_response":{
        "error_msg":"系统异常，请稍后重试",
        "result":{
            "tid":3035909269095214604,
            "out_order_id":"4564645"
        },
        "error_resp_code":101,
        "code_for_dev":"101",
        "msg_for_dev":"参数错误",
        "is_success":false
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

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

开放平台

酒店交易API

taobao.xhotel.order.distribution.create (飞猪酒店分销创单接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ