文档中心 > 旅游度假

境内门票&境外门票

更新时间:2018/01/11 访问次数:593

门票商品维护

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,查询商家发布在此景点下的 景点映射关系、收费项目映射关系及收费项目列表。

收费项目(商品)详情

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

规则详情

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

FAQ

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