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

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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三选一,至少填写其中一个
item_id Number 可选 1223 特殊必填,淘宝商品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
    • 可选,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为准

    响应参数

    名称 类型 示例值 描述
    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");
    req.setItemId(1223L);
    List<TicketPriceRule> list2 = new ArrayList<TicketPriceRule>();
    TicketPriceRule obj3 = new TicketPriceRule();
    list2.add(obj3);
    obj3.setTicketType("成人票");
    obj3.setTicketSeason("上午场");
    obj3.setTicketArea("贵宾席");
    List<PriceRule> list6 = new ArrayList<PriceRule>();
    PriceRule obj7 = new PriceRule();
    list6.add(obj7);
    obj7.setOutRuleId("111");
    obj7.setOutSkuId("12345");
    obj7.setUploadType(1L);
    List<DateInventory> list10 = new ArrayList<DateInventory>();
    DateInventory obj11 = new 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);
    AlitripTicketSkusBatchUploadResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • 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>

    异常示例

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

    如何获得此API

    拥有此API的权限组 可获得/可申请此API权限组的应用类型
    门票-商品管理 飞猪-系统商   飞猪-度假  

    FAQ

    返回
    顶部