文档中心 > API类目 > 门票-商品管理API

alitrip.ticket.skus.batch.upload (【门票API2.0】门票价格库存同步接口（多票种批量更新）)

飞猪度假新版门票商品价格库存同步接口（多票种批量更新）。注1、一个票种下可以挂多个规则（规则id必须不一样，每个规则实际对应了一个sku），同一个规则可以在不同票种下使用。注2、日历库存和区间库存门票，统一使用DateInventory结构。对于日历库存门票请上传每一天的价格库存；对于区间库存门票，建议只上传开始和结束日期的价格库存，也支持上传每天的价格库存，系统会自动进行聚合（取第一天的价格为区间价格，累计所有天的库存为区间库存）。注3、该接口同时支持新增某个规则的价格库存和更新现有规则的价格库存。如果不清楚是否已在某个规则下上传过价格库存，请使用alitrip.ticket.product.query接口进行查询。如果该规则在该票种下已经存在，则该接口会判断为是价格库存更新操作。

公共参数

请求地址：

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

请求参数

名称	类型	是否必须	示例值	更多限制	描述
ali_product_id	Number	可选	1212		特殊必填，阿里标准收费项目id。ali_product_id, item_id与out_product_id三选一，至少填写其中一个
out_product_id	String	可选	1111		特殊必填，商户收费项目id。ali_product_id, item_id与out_product_id三选一，至少填写其中一个
ticket_price_rules	TicketPriceRule []	必须		最大列表长度：50	必填，各票种下sku的价格库存参数。
└ ticket_type String 必须成人票必填，门票票种类型 └ ticket_season String 可选上午场可选，门票场次（场次门票专用，对于场次门票必选） └ ticket_area String 可选贵宾席可选，门票区域（场次门票专用，对于场次门票必选） price_rules PriceRule [] 必须必填，该票种下使用的价格规则。 └ out_rule_id String 必须 111 必填，商户票种规则id └ out_sku_id String 可选 12345 可选，sku的商家编码（用于区分在不同票种下使用同一outRuleId的情况） └ upload_type Number 可选 1 可选，1-全量更新，2-增量更新（增加或覆盖某一天的价格库存），不传默认为1。 date_inventorys DateInventory [] 必须必填，每日价格库存。 └ date Date 必须 2016-12-10 23:59:00 日期。格式：2016-12-10 23:59:00 └ price Number 必须 1000 价格，以分为单位，必须大于0。 └ stock Number 必须 12 库存，必须大于等于0 └ out_sku_date_id String 可选 2222 可选，日期级别自定义商家编码，为该sku下每一天都设置一个自定义商家编码。如果outSkuDateId不传，则该天的商家自定义编码将以outSkuId为准
item_id	Number	可选	1223		特殊必填，淘宝商品id。ali_product_id, item_id与out_product_id三选一，至少填写其中一个

响应参数

名称	类型	示例值	描述
update_result	TicketItemResult		价格库存同步结果
└ modifyed_time Date 2016-10-10 00:00:00 修改时间 └ item_id Number 1244 商品id └ ali_scenic_id Number 123 标准景点id └ out_scenic_id String 123 商户景点id └ ali_product_id Number 2222 标准收费项目id └ out_product_id String 2233 商户收费项目id └ extend String 预留，扩展字段预留，扩展字段

请求示例

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTicketSkusBatchUploadRequest req = new AlitripTicketSkusBatchUploadRequest();
req.setAliProductId(1212L);
req.setOutProductId("1111");
List<AlitripTicketSkusBatchUploadRequest.TicketPriceRule> list2 = new ArrayList<AlitripTicketSkusBatchUploadRequest.TicketPriceRule>();
AlitripTicketSkusBatchUploadRequest.TicketPriceRule obj3 = new AlitripTicketSkusBatchUploadRequest.TicketPriceRule();
list2.add(obj3);
obj3.setTicketType("成人票");
obj3.setTicketSeason("上午场");
obj3.setTicketArea("贵宾席");
List<AlitripTicketSkusBatchUploadRequest.PriceRule> list6 = new ArrayList<AlitripTicketSkusBatchUploadRequest.PriceRule>();
AlitripTicketSkusBatchUploadRequest.PriceRule obj7 = new AlitripTicketSkusBatchUploadRequest.PriceRule();
list6.add(obj7);
obj7.setOutRuleId("111");
obj7.setOutSkuId("12345");
obj7.setUploadType(1L);
List<AlitripTicketSkusBatchUploadRequest.DateInventory> list10 = new ArrayList<AlitripTicketSkusBatchUploadRequest.DateInventory>();
AlitripTicketSkusBatchUploadRequest.DateInventory obj11 = new AlitripTicketSkusBatchUploadRequest.DateInventory();
list10.add(obj11);
obj11.setDate(StringUtils.parseDateTime("2016-12-10 23:59:00"));
obj11.setPrice(1000L);
obj11.setStock(12L);
obj11.setOutSkuDateId("2222");
list8.setDateInventorys(list10);
list4.setPriceRules(list6);
req.setTicketPriceRules(list2);
req.setItemId(1223L);
AlitripTicketSkusBatchUploadResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripTicketSkusBatchUploadRequest req = new AlitripTicketSkusBatchUploadRequest();
req.AliProductId = 1212L;
req.OutProductId = "1111";
List<AlitripTicketSkusBatchUploadRequest.TicketPriceRuleDomain> list2 = new List<AlitripTicketSkusBatchUploadRequest.TicketPriceRuleDomain>();
AlitripTicketSkusBatchUploadRequest.TicketPriceRuleDomain obj3 = new AlitripTicketSkusBatchUploadRequest.TicketPriceRuleDomain();
list2.Add(obj3);
obj3.TicketType = "成人票";
obj3.TicketSeason = "上午场";
obj3.TicketArea = "贵宾席";
List<AlitripTicketSkusBatchUploadRequest.PriceRuleDomain> list5 = new List<AlitripTicketSkusBatchUploadRequest.PriceRuleDomain>();
AlitripTicketSkusBatchUploadRequest.PriceRuleDomain obj6 = new AlitripTicketSkusBatchUploadRequest.PriceRuleDomain();
list5.Add(obj6);
obj6.OutRuleId = "111";
obj6.OutSkuId = "12345";
obj6.UploadType = 1L;
List<AlitripTicketSkusBatchUploadRequest.DateInventoryDomain> list8 = new List<AlitripTicketSkusBatchUploadRequest.DateInventoryDomain>();
AlitripTicketSkusBatchUploadRequest.DateInventoryDomain obj9 = new AlitripTicketSkusBatchUploadRequest.DateInventoryDomain();
list8.Add(obj9);
obj9.Date = DateTime.Parse(2016-12-10 23:59:00");
obj9.Price = 1000L;
obj9.Stock = 12L;
obj9.OutSkuDateId = "2222";
obj6.DateInventorys= list8;
obj3.PriceRules= list5;
req.TicketPriceRules_ = list2;
req.ItemId = 1223L;
AlitripTicketSkusBatchUploadResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripTicketSkusBatchUploadRequest;
$req->setAliProductId("1212");
$req->setOutProductId("1111");
$ticket_price_rules = new TicketPriceRule;
$ticket_price_rules->ticket_type="成人票";
$ticket_price_rules->ticket_season="上午场";
$ticket_price_rules->ticket_area="贵宾席";
$price_rules = new PriceRule;
$price_rules->out_rule_id="111";
$price_rules->out_sku_id="12345";
$price_rules->upload_type="1";
$date_inventorys = new DateInventory;
$date_inventorys->date="2016-12-10 23:59:00";
$date_inventorys->price="1000";
$date_inventorys->stock="12";
$date_inventorys->out_sku_date_id="2222";
$price_rules->date_inventorys = $date_inventorys;
$ticket_price_rules->price_rules = $price_rules;
$req->setTicketPriceRules(json_encode($ticket_price_rules));
$req->setItemId("1223");
$resp = $c->execute($req, $sessionKey);

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=alitrip.ticket.skus.batch.upload' \
-d 'partner_id=apidoc' \
-d 'session=24bd6d0f-c75a-4578-b0e8-cd2c07599f3e' \
-d 'sign=4D69A672E67DE098D7952AD72AD0C6AE' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-11-21+21%3A54%3A52' \
-d 'v=2.0' \
-d 'ali_product_id=1212' \
-d 'item_id=1223' \
-d 'out_product_id=1111' \
-d 'ticket_price_rules=null'

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

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

req.ali_product_id=1212
req.out_product_id="1111"
req.ticket_price_rules=""
req.item_id=1223
try:
	resp= req.getResponse(sessionkey)
	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,"alitrip.ticket.skus.batch.upload");
add_param(pRequest,"ali_product_id","1212");
add_param(pRequest,"out_product_id","1111");
add_param(pRequest,"ticket_price_rules","数据结构JSON示例");
add_param(pRequest,"item_id","1223");
pResponse = top_execute(pClient,pRequest,sessionKey);
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('alitrip.ticket.skus.batch.upload', {
	'ali_product_id':'1212',
	'out_product_id':'1111',
	'ticket_price_rules':'数据结构JSON示例',
	'item_id':'1223'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

XML示例
JSON示例

<alitrip_ticket_skus_batch_upload_response>
    <update_result>
        <modifyed_time>2016-10-10 00:00:00</modifyed_time>
        <item_id>1244</item_id>
        <ali_scenic_id>123</ali_scenic_id>
        <out_scenic_id>123</out_scenic_id>
        <ali_product_id>2222</ali_product_id>
        <out_product_id>2233</out_product_id>
        <extend>预留，扩展字段</extend>
    </update_result>
</alitrip_ticket_skus_batch_upload_response>

{
    "alitrip_ticket_skus_batch_upload_response":{
        "update_result":{
            "modifyed_time":"2016-10-10 00:00:00",
            "item_id":1244,
            "ali_scenic_id":123,
            "out_scenic_id":"123",
            "ali_product_id":2222,
            "out_product_id":"2233",
            "extend":"预留，扩展字段"
        }
    }
}

异常示例

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工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

门票-商品管理API