淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	描述
UpdateRQ	UpdateRQ	可选		无
AuthenticationToken AuthenticationToken 可选无 └ Username String 可选 taobao taobao └ Password String 可选 taobao taobao └ CreateToken String 可选 taobao1387784033263-1387784033266 taobao1387784033263-1387784033266 └ TaoBaoOrderId Number 可选 1387784033263 1387784033263 └ OrderId String 可选 R387784033263 R387784033263 └ RequestID String 可选请求唯一标识,此值需要在结果中返回请求唯一标识,此值需要在结果中返回 └ HotelCode String 可选外部酒店编码外部酒店编码 └ OperateType Number 可选 1 1 └ Action Number 可选 0 0 └ DisplayText String 可选用户张三需要提前准备发票用户张三需要提前准备发票 Invoice Invoice 可选预约发票 └ InvoiceType String 可选发票类型（1:普通发票；2：增值税专用发票，）发票类型（1:普通发票；2：增值税专用发票，） └ InvoiceTitle String 可选阿里巴巴集团阿里巴巴集团 └ TaxpayerID String 可选纳税人识别号：纳税人识别号,一律由15位、18或者20位码（字符型）组成。纳税人识别号：纳税人识别号,一律由15位、18或者20位码（字符型）组成。 └ RegAddress String 可选公司注册地址：抬头公司注册地址公司注册地址：抬头公司注册地址 └ CompanyTel String 可选公司电话：抬头公司电话，区号-电话号码公司电话：抬头公司电话，区号-电话号码 └ BankName String 可选开户行：抬头公司银行开户行名称开户行：抬头公司银行开户行名称 └ BankAccount String 可选银行账户：抬头公司银行账号银行账户：抬头公司银行账号 └ PostType Number 可选 0 0 └ EarlyPrepare Number 可选 0 0 └ ReceiverName String 可选张三张三 └ ReceiverMobile Number 可选 13601083188 13601083188 └ ReceiverAddress String 可选北京国家广告产业园B座北京国家广告产业园B座 └ Provider Number 可选 1 1 └ Payer Number 可选 1 1 └ WantTime String 可选需要发票时间(格式yyyy-MM-dd HH:mm:ss) 需要发票时间(格式yyyy-MM-dd HH:mm:ss) └ Comment String 可选备注信息备注信息 └ Extensions String 可选无扩展值
sellerId	String	可选	1234	卖家id
hid	String	可选	1234	酒店Id
vendor	String	可选	chinaonline	系统商
pmsType	String	可选	11	pms类型

名称	类型	示例值	描述
Result	Result		无
└ Message String 描述描述 └ ResultCode String 0 0:成功；1:失败；101：订单还未下达酒店PMS，请稍后再试 └ OrderId String 商家外部订单号商家外部订单号

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

QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
TaobaoXhotelFuturehotelInvoiceRequest req = new TaobaoXhotelFuturehotelInvoiceRequest();
TaobaoXhotelFuturehotelInvoiceRequest.UpdateRQ obj1 = new TaobaoXhotelFuturehotelInvoiceRequest.UpdateRQ();
TaobaoXhotelFuturehotelInvoiceRequest.AuthenticationToken obj2 = new TaobaoXhotelFuturehotelInvoiceRequest.AuthenticationToken();
obj2.setsername("taobao");
obj2.setassword("taobao");
obj2.setreateToken("taobao1387784033263-1387784033266");
obj1.setuthenticationToken(obj2);
obj1.setaoBaoOrderId(1387784033263L);
obj1.setrderId("R387784033263");
obj1.setequestID("请求唯一标识,此值需要在结果中返回");
obj1.setotelCode("外部酒店编码");
obj1.setperateType(1L);
obj1.setction(0L);
obj1.setisplayText("用户张三需要提前准备发票");
TaobaoXhotelFuturehotelInvoiceRequest.Invoice obj3 = new TaobaoXhotelFuturehotelInvoiceRequest.Invoice();
obj3.setnvoiceType("发票类型（1:普通发票；2：增值税专用发票，）");
obj3.setnvoiceTitle("阿里巴巴集团");
obj3.setaxpayerID("纳税人识别号：纳税人识别号,一律由15位、18或者20位码（字符型）组成。");
obj3.setegAddress("公司注册地址：抬头公司注册地址");
obj3.setompanyTel("公司电话：抬头公司电话，区号-电话号码");
obj3.setankName("开户行： 抬头公司银行开户行名称");
obj3.setankAccount("银行账户：抬头公司银行账号");
obj3.setostType(0L);
obj3.setarlyPrepare(0L);
obj3.seteceiverName("张三");
obj3.seteceiverMobile(13601083188L);
obj3.seteceiverAddress("北京国家广告产业园B座");
obj3.setrovider(1L);
obj3.setayer(1L);
obj3.setantTime("需要发票时间(格式yyyy-MM-dd HH:mm:ss)");
obj3.setomment("备注信息");
obj1.setnvoice(obj3);
obj1.setxtensions("无");
req.setpdateRQ(obj1);
req.setSellerId("1234");
req.setHid("1234");
req.setVendor("chinaonline");
req.setPmsType("11");
TaobaoXhotelFuturehotelInvoiceResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TaobaoXhotelFuturehotelInvoiceRequest req = new TaobaoXhotelFuturehotelInvoiceRequest();
TaobaoXhotelFuturehotelInvoiceRequest.UpdateRQDomain obj1 = new TaobaoXhotelFuturehotelInvoiceRequest.UpdateRQDomain();
TaobaoXhotelFuturehotelInvoiceRequest.AuthenticationTokenDomain obj2 = new TaobaoXhotelFuturehotelInvoiceRequest.AuthenticationTokenDomain();
obj2.sername = "taobao";
obj2.assword = "taobao";
obj2.reateToken = "taobao1387784033263-1387784033266";
obj1.uthenticationToken= obj2;
obj1.aoBaoOrderId = 1387784033263L;
obj1.rderId = "R387784033263";
obj1.equestID = "请求唯一标识,此值需要在结果中返回";
obj1.otelCode = "外部酒店编码";
obj1.perateType = 1L;
obj1.ction = 0L;
obj1.isplayText = "用户张三需要提前准备发票";
TaobaoXhotelFuturehotelInvoiceRequest.InvoiceDomain obj3 = new TaobaoXhotelFuturehotelInvoiceRequest.InvoiceDomain();
obj3.nvoiceType = "发票类型（1:普通发票；2：增值税专用发票，）";
obj3.nvoiceTitle = "阿里巴巴集团";
obj3.axpayerID = "纳税人识别号：纳税人识别号,一律由15位、18或者20位码（字符型）组成。";
obj3.egAddress = "公司注册地址：抬头公司注册地址";
obj3.ompanyTel = "公司电话：抬头公司电话，区号-电话号码";
obj3.ankName = "开户行： 抬头公司银行开户行名称";
obj3.ankAccount = "银行账户：抬头公司银行账号";
obj3.ostType = 0L;
obj3.arlyPrepare = 0L;
obj3.eceiverName = "张三";
obj3.eceiverMobile = 13601083188L;
obj3.eceiverAddress = "北京国家广告产业园B座";
obj3.rovider = 1L;
obj3.ayer = 1L;
obj3.antTime = "需要发票时间(格式yyyy-MM-dd HH:mm:ss)";
obj3.omment = "备注信息";
obj1.nvoice= obj3;
obj1.xtensions = "无";
req.pdateRQ_ = obj1;
req.SellerId = "1234";
req.Hid = "1234";
req.Vendor = "chinaonline";
req.PmsType = "11";
TaobaoXhotelFuturehotelInvoiceResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TaobaoXhotelFuturehotelInvoiceRequest;
$UpdateRQ = new UpdateRQ;
$AuthenticationToken = new AuthenticationToken;
$AuthenticationToken->username="taobao";
$AuthenticationToken->password="taobao";
$AuthenticationToken->create_token="taobao1387784033263-1387784033266";
$UpdateRQ->AuthenticationToken = $AuthenticationToken;
$UpdateRQ->tao_bao_order_id="1387784033263";
$UpdateRQ->order_id="R387784033263";
$UpdateRQ->request_i_d="请求唯一标识,此值需要在结果中返回";
$UpdateRQ->hotel_code="外部酒店编码";
$UpdateRQ->operate_type="1";
$UpdateRQ->action="0";
$UpdateRQ->display_text="用户张三需要提前准备发票";
$Invoice = new Invoice;
$Invoice->invoice_type="发票类型（1:普通发票；2：增值税专用发票，）";
$Invoice->invoice_title="阿里巴巴集团";
$Invoice->taxpayer_i_d="纳税人识别号：纳税人识别号,一律由15位、18或者20位码（字符型）组成。";
$Invoice->reg_address="公司注册地址：抬头公司注册地址";
$Invoice->company_tel="公司电话：抬头公司电话，区号-电话号码";
$Invoice->bank_name="开户行： 抬头公司银行开户行名称";
$Invoice->bank_account="银行账户：抬头公司银行账号";
$Invoice->post_type="0";
$Invoice->early_prepare="0";
$Invoice->receiver_name="张三";
$Invoice->receiver_mobile="13601083188";
$Invoice->receiver_address="北京国家广告产业园B座";
$Invoice->provider="1";
$Invoice->payer="1";
$Invoice->want_time="需要发票时间(格式yyyy-MM-dd HH:mm:ss)";
$Invoice->comment="备注信息";
$UpdateRQ->Invoice = $Invoice;
$UpdateRQ->extensions="无";
$req->setpdateRQ(json_encode($UpdateRQ));
$req->setSellerId("1234");
$req->setHid("1234");
$req->setVendor("chinaonline");
$req->setPmsType("11");
$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=qimen.taobao.xhotel.futurehotel.invoice' \
-d 'partner_id=apidoc' \
-d 'sign=50F9DE86F3B9459F4575C03C04BEBFF6' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-07-21+07%3A21%3A33' \
-d 'v=2.0' \
-d 'UpdateRQ=null' \
-d 'hid=1234' \
-d 'pmsType=11' \
-d 'sellerId=1234' \
-d 'vendor=chinaonline'

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

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

req.UpdateRQ="数据结构示例JSON格式"
req.sellerId="1234"
req.hid="1234"
req.vendor="chinaonline"
req.pmsType="11"
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,"qimen.taobao.xhotel.futurehotel.invoice");
add_param(pRequest,"UpdateRQ","数据结构JSON示例");
add_param(pRequest,"sellerId","1234");
add_param(pRequest,"hid","1234");
add_param(pRequest,"vendor","chinaonline");
add_param(pRequest,"pmsType","11");
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('qimen.taobao.xhotel.futurehotel.invoice', {
	'UpdateRQ':'数据结构JSON示例',
	'sellerId':'1234',
	'hid':'1234',
	'vendor':'chinaonline',
	'pmsType':'11'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<Result>
    <Message>描述</Message>
    <ResultCode>0</ResultCode>
    <OrderId>商家外部订单号</OrderId>
</Result>

{
    "Result":{
        "Message":"描述",
        "ResultCode":"0",
        "OrderId":"商家外部订单号"
    }
}

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下载

qimen.taobao.xhotel.futurehotel.invoice (未来酒店-预约发票)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ