文档中心 > 旅行门票

门票商品维护/查询

更新时间:2017/04/01 访问次数:14463

门票商品维护

image

业务场景

商户拥有自己的商品管理系统,需要将商品同步到飞猪平台。

对接说明

获取阿里标准景点信息

根据关键词查找景点信息,包括景点名称、收费项目列表、每个收费项目包含的票种、票种的场次区域信息(场次门票才有)等信息,用于后续的商品发布。注:在飞猪平台上发布门票商品有两个必须的id编码:阿里标准景点编码,阿里标准收费项目编码。这两个编码都可以通过该接口获取(该接口的返回参数说明:scenicId(阿里标准景点编码),spuId(阿里标准收费项目编码))。

image

绑定景点

为了方便商家发布商品,飞猪门票API支持外键(即使用商家系统的景点编码和收费项目编码)发布。需要先将商家系统的景点编码与飞猪系统的景点编码绑定,做好本地映射关系,后续可以直接使用商家系统的景点编码。若商家不需要外键功能,可以忽略此接口。

维护收费项目(商品)

收费项目(门票商品)接口主要维护库存类型、预定限制、发码方式等商品级别参数。该接口同样支持外键功能(商家自定义收费项目编码,out_product_id),系统会自动将商家收费项目编码绑定到阿里标准收费项目编码。请注意:使用外键功能必须先进行景点绑定(收费项目挂靠在景点下,必须先进行商家景点编码和阿里景点编码的绑定)。

  • 注1、该接口同时支持商品的新发布和增量更新功能。对于新发商品有一些参数是必填,对于商品更新情况大部分都是可选,请注意看参数说明。商家在一个收费项目下只能发布一个商品,如果不清楚是否已在某景点的收费项目下发布过商品,请使用alitrip.ticket.scenic.query或alitrip.ticket.product.query接口进行查询。如果已经发布过商品,则该接口会判断为是商品更新操作
  • 注2、对于新发布商品的情况,系统会对商品部分属性进行默认设置:1)实体票商品 默认设置卖家承担运费;2)门票商品 宝贝所在地默认设置为景点所在地(境外门票则默认设置成浙江 杭州);3)如果商家没有传商品标题,图片,详情描述,则系统会默认设置为该景点的标题,图片,详情。
  • 注3、登陆码商管理后台,查询核销门店库信息。若没有,则需要新增
    image

维护景点规则

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

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

维护价格库存

image

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

上下架商品

对门票商品进行上下架操作,目前只支持立即上下架操作。

相关查询服务

业务场景

商家对已发布在飞猪的商品、规则等信息进行相关查询操作。

对接说明

映射关系及收费项目列表查询

根据景点ID,查询商家发布在此景点下的 景点映射关系、收费项目映射关系及收费项目列表。

收费项目(商品)详情

返回含收费项目、价格规则等详细商品信息

规则详情

根据商家维护的规则ID返回具体规则信息。

FAQ

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