一、接入流程说明

二、接入流程说明

1、POI信息及票型信息拉取

商家首先需要调用接口获取马蜂窝门票业务可售卖门票的POI信息及对应的票型信息，POI信息和票型信息是商家创建SKU时的必要信息；

请求aciton：

action：sales.ticket.poi.search，地址：http://open.mafengwo.cn/docs/api/511.html

action：sales.ticket.poi.item.info.get，地址：http://open.mafengwo.cn/docs/api/512.html

注意：

- 此接口只能拉取马蜂窝门票业务支持售卖的POI及票型信息，如果通过接口未能搜索到对应的POI信息，可以通过马蜂窝商家后台或者线下联系对接业务，完成POI、票型信息的创建和管理；

- POI所在的目的地mdd_id信息请商家进行记录，此字段为创建商品时的必要字段；

2、门票商品创建与修改

商家调用此接口，可完成对门票业务下的8个二级类目的商品创建；

包括：11-景区/场馆、90-节庆/嘉年华、91-游乐园、92-温泉票、93-滑雪票、94-通票/年票、95-游船票、96-观光巴士票；

商品基础信息主要包括：商品标题、头图、图文详情、退改规则等信息等；

1）请求aciton：

action：sales.ticket.product.update，地址：http://open.mafengwo.cn/docs/api/513.html

注意：

- 商品创建/修改所需要的目的地id，请传递对应POI的关联目的地id；

- 商品图文详情，仅支持商家传递图片URL链接；

3、门票SKU信息创建

一个商品（sales_id）下，可包括多个SKU信息，创建SKU主要包括以下流程：

1）绑定SKU创建模版属性

该接口用于确认此商品下SKU的属性结构，商家可根据实际情况选择商品下的SKU属性组合；同一个商品下，多个SKU的属性组合必须一致；

action：sales.ticket.product.sku.template.bind，地址：http://open.mafengwo.cn/docs/api/514.html

2）创建门票SKU

确认商品下SKU的属性模版之后，根据具体的属性及属性值取值，可完成门票SKU的创建；

action：sales.ticket.sku.add，地址：http://open.mafengwo.cn/docs/api/515.html

4、SKU关联门票规则信息编辑

该接口用于商家对SKU的基础信息进行管理，主要包括SKU关联POI、票型信息，以及SKU预订规则信息维护，包括：限购规则、生效规则、换票规则、核销规则等；

action：sales.ticket.sku.rule.update，地址：http://open.mafengwo.cn/docs/api/516.html

action：sales.ticket.sku.rule.get，地址：http://open.mafengwo.cn/docs/api/521.html

 

5、门票出行人模版编辑

马蜂窝出行人模版，用于设置用户下单时所需要的出行人信息，包括出行人姓名、出行人电话、出行人证件信息等；

action：sales.sku.traveler.template.bind，地址：http://open.mafengwo.cn/docs/api/520.html

action：sales.ticket.traveler.template.list.get，地址：http://open.mafengwo.cn/docs/api/519.html

action：sales.ticket.traveler.template.info.get，地址：http://open.mafengwo.cn/docs/api/518.html

action：sales.ticket.traveler.template.update，地址：http://open.mafengwo.cn/docs/api/517.html

 

6、SKU库存日历更新

完成SKU基础信息创建及出行人模版关联后，需要对SKU的价格日历进行更新。马蜂窝提供多种SKU库存日历更新方法供商家进行调用；

1）请求aciton：

action：sales.sku.calendar.batch.update，地址：http://open.mafengwo.cn/docs/api/158.html

action：sales.sku.calendar.override，地址：http://open.mafengwo.cn/docs/api/146.html

 

7、SKU状态更新

商品在提交审核前，需要商家对商品中的SKU进行上线操作，一个待审核上线的商品，至少需要有一个SKU处于上线状态；

1）请求action：

action：sales.sku.online，地址：http://open.mafengwo.cn/docs/api/69.html

action：sales.sku.offline，地址：http://open.mafengwo.cn/docs/api/73.html

 

8、商品提交审核流程

马蜂窝商品上线前需要提交商品上线申请，待马蜂窝审核通过后，完成商品的上线工作；

请求action：

action：sales.product.online.review.apply，地址：http://open.mafengwo.cn/docs/api/298.html

action：sales.product.online.review.cancel，地址：http://open.mafengwo.cn/docs/api/305.html

action：sales.product.review.status.get，地址：http://open.mafengwo.cn/docs/api/312.html

 

注意：以上主要对景点门票业务产品创建流程主要涉及调用接口进行说明，其他接口内容，请访问马蜂窝开放平台文档中心：http://open.mafengwo.cn/docs/