文档中心 > 旅游度假

门票商品价格库存推送

更新时间:2021/10/11 访问次数:6781

门票商品价格库存推送

门票商品的价格库存维护分为以下两个步骤:1、维护景点规则(必须使用商家自定义规则id)。2、维护sku的价格库存(通过收费项目id+票种+规则id 唯一确定一个sku)

业务场景

商家通过API接口将指定门票商品(收费项目)的实时价格库存信息同步到飞猪平台。

对接说明

维护景点规则

该接口主要维护景点相关的退票规则,是否要求出游人信息,是否限购,入园方式以及费用包含等信息。规则必须使用外键功能(即商家必须对每个规则设置 商户票种规则id,out_rule_id),out_rule_id将用于后续对商品的价格库存进行维护。

  • 注1、规则必须挂靠在某个景点下,即商户景点编码 和 阿里旅行景点编码 二者必须填写一个。
  • 注2、该接口同时支持 新发布规则和增量更新现有规则。对于新发规则有一些参数是必填,对于更新情况大部分都是可选,请注意看参数说明。如果不清楚是否已在某个out_rule_id下发布过规则,请使用alitrip.ticket.rule.query接口进行查询。如果在out_rule_id下已发布过规则,则该接口会判断为是规则更新操作,否则认为是新增一个规则。

维护价格库存

(废弃)单票种价格库存维护接口:alitrip.ticket.skus.upload
(推荐使用)多票种价格库存批量维护接口:alitrip.ticket.skus.batch.upload

image

  • 注1、多票种批量维护接口,顾名思义允许同时更新一个门票商品下多个票种的价格库存信息,多票种维护接口可以完全替代实现单票种维护接口的功能 ,建议商家对接时直接对接多票种批量维护接口alitrip.ticket.skus.batch.upload即可。
  • 注2、一个票种下可以挂多个规则(规则id必须不一样,每个规则实际对应了一个sku),同一个规则可以在不同票种下使用。
  • 注3、日历库存和区间库存门票,统一使用DateInventory结构。对于日历库存门票请上传每一天的价格库存;对于区间库存门票,建议只上传开始和结束日期的价格库存,也支持上传每天的价格库存,系统会自动进行聚合(取第一天的价格为区间价格,累计所有天的库存为区间库存)。
  • 注4、该接口同时支持 新增某个规则的价格库存 和 更新现有规则的价格库存。如果不清楚是否已在某个规则下上传过价格库存,请使用alitrip.ticket.product.query接口进行查询。如果该规则在该票种下已经存在,则该接口会判断为是对该规则的价格库存进行更新操作,否则认为是在该票种下新增一个规则的价格库存(即新增了一个sku)。
  • 注5、对于接口中外部商家编码(参数out_sku_id和out_sku_date_id)的说明:商品上的外部商家编码在用户下单时将写入到订单详情,用户拉取订单详情时可以获取到该商家编码。
  • 注6、如果该门票是场次门票,则维护价格库存时,除了票种必填外,门票场次和门票区域也必填。

FAQ

关于此文档暂时还没有FAQ
返回
顶部