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

alitrip.ticket.skus.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_type String 必须 成人票 必填,门票 票种类型
ticket_season String 可选 上午场 可选,门票场次(场次门票专用,对于场次门票必选)
ticket_area String 可选 贵宾席 可选,门票区域(场次门票专用,对于场次门票必选)
price_rules PriceRule [] 必须
  • 最大列表长度:50
  • 必填,该票种下使用的价格规则。
    • └ out_rule_id
    • String
    • 必须
    • 111
    • 必填,商户票种规则id
    • └ 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为准
    • └ out_sku_id
    • String
    • 可选
    • 12345
    • 可选,sku的商家编码(用于区分在 不同票种下使用同一outRuleId的情况)

    响应参数

    名称 类型 示例值 描述
    first_result TicketItemResult 价格库存同步结果
    • └ modifyed_time
    • Date
    • 2016-10-10 00:00:00
    • 修改时间
    • └ item_id
    • Number
    • 12335
    • 商品id
    • └ ali_scenic_id
    • Number
    • 123
    • 标准景点id
    • └ out_scenic_id
    • String
    • 111
    • 商户景点id
    • └ ali_product_id
    • Number
    • 123
    • 标准收费项目id
    • └ out_product_id
    • String
    • 2222
    • 商户收费项目id
    • └ ticket_type
    • String
    • 成人票
    • 票种
    • └ out_rule_ids
    • String []
    • ["111","222"]
    • 商户票种规则id
    • └ extend
    • String
    • 预留
    • 预留,扩展字段

    请求示例

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

    响应示例

    • XML示例
    • JSON示例
    <alitrip_ticket_skus_upload_response>
        <first_result>
            <modifyed_time>2016-10-10 00:00:00</modifyed_time>
            <item_id>12335</item_id>
            <ali_scenic_id>123</ali_scenic_id>
            <out_scenic_id>111</out_scenic_id>
            <ali_product_id>123</ali_product_id>
            <out_product_id>2222</out_product_id>
            <ticket_type>成人票</ticket_type>
            <out_rule_ids>
                <string>[&quot;111&quot;</string>
                <string>&quot;222&quot;]</string>
            </out_rule_ids>
            <extend>预留</extend>
        </first_result>
    </alitrip_ticket_skus_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-parameter:ERROR 参数异常,一般是规则不存在 请根据错误提示修改
    isv.invalid-parameter:PARAM_ERROR 参数错误,一般是收费项目不存在 请根据错误提示修改
    isv.invalid-parameter:NOTNULL 关键字段为空 关键字段为空,一般是收费项目为空,请根据提示修改
    isv.biz-error:ITEM_NOT_FOUNT 未找到该商品,无法编辑 请检查参数商品ID
    isv.IPM_OPERATION_SUCCESS 部分操作成功 重试解决
    isv.invalid-parameter:ILLEGAL_DATE 同一票种下的区间日期存在重复 请检查票种下的区间日期
    isv.biz-eror:INVENTORY_NOT_BETWEEN_DATE_RANGE 库存的日期,不在sku的有效期范围之内 修改sku的有效期,或者删除该日期库存
    isv.GENERIC_FAILUREIC_DB_ACCESS_ERROR DB访问错误 重试解决
    isv.123:IC商品编辑错误 IP_Inventory_Data_null 请不要授权C店铺调用商品发布API
    isv.PARAM_EXCEPTION 参数异常,一般是收费项目不存在 请根据错误提示修改
    isv.remote-service-error 调用商品服务异常,一般是更新商品失败 请根据错误提示修改
    rights-invalid:EDIT_NOT_PERMIT 没有权限,一般是因为你编辑了不属于你的商品 请根据错误提示修改
    isv.QUERY_ITEM_ERROR 商品查询失败 一般是因为商品Id不存在,或者商品已经被删除了,无法查询和修改
    isv.rights-invalid:PUBLISH_NOT_PERMIT 没有发布此类目商品的权限 没有发布此类目商品的权限
    isv.TICKET_RULE_NOT_EXISTS 规则不存在 请根据错误提示修改
    isv.UN_KNOWN 未知错误 请根据错误提示修改
    isv.FORBIDDEN_QUANTITY_ZERO_ERROR 商品没有有效的价格库存 请根据错误提示修改
    isp.SYS_EXCEPTION 系统异常 请根据错误提示修改,或重试
    isv.old_sq_not_match 数据已发生变更 请根据错误提示修改
    isv.IC_CHECKSTEP_SKU_DUPLICATE sku重复 请根据错误提示修改
    isv.biz-error:SCENIC_NOT_FOUND 没有查到景点 请确认传入的景点ID是否正确
    isv.invalid-parameter:PARAM_ERROR:charge_item 收费项目不存在 收费项目不存在
    isv.invalid-parameter:ILLEGAL_DATE:date_duplicate 日期重复 请检查同一个票种下日期是否重复
    isv.invalid-parameter:ILLEGAL_DATE:date_invalid 日期无效 请根据错误提示修改
    isv. 根据错误提示修改 根据错误提示修改

    API工具

    如何获得此API

    FAQ

    返回
    顶部