修改日期：20170103
 修改人：张语嫣

特别说明

采购要出发的产品再对接到抖音抖音/美团/飞猪/快手等渠道进行分销，订单退改申请，商家必须按时处理。目前对接所有第三方渠道（包括但不限于抖音/美团/飞猪/快手等，及未来新增加的渠道），客人发起退改申请，超过要求的期限商家未处理，第三方会直接退款给客人。如因商家逾期未处理造成损失，由商家承担，自我游不承担责任。
    商家每天应登录自我游系统查看订单退改申请列表，及时联系供应商处理订单退改。
    目前已知的退改时限（客人发起推该请求算起），抖音72小时，美团24小时，去哪儿24小时，飞猪24小时（部分景区产品飞猪是按即时退款执行）。
关于退改时限要求会有调整，请以各平台官方通告为准。

接口实现功能

下单（是在运营商发送通知单给要出发时才下单至要出发系统)
取消订单、退单（不支持部分退款）
查看订单日志（支持）
取消订单、退单（支持）
重新发码（支持）
查看订单详细信息orderDetail（支持）
系统自动核销订单（支持）
接口返码（不支）持****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心

合作协议

（运营商与要出发系统之间的合作协议）

要出发系统提供参数

注：
目前商家都是结算价模式。

产品同步类型，接口默认的是都是要出发推送产品就可以同步产品到系统，运营商也可以选择手工发布，因此配置时要跟自我游运营部说明是配置哪种同步类型。

运营商提供参数

运营商在自我游新增加一个供应商帐号，用于与要出发门票对接。将供应商账号编码提供给自我游运营部人员绑定。【供应商帐号开通，参考该链接：http://kf.zowoyoo.cn/hc/kb/article/1002143/】

要出发技术配置回调地址

推送产品信息 http://运营商域名/api/yaochufa/pushProducts.jsp
推送库存卖价格http://运营商域名/api/yaochufa/pushStockPrice.jsp
推送订单状态变化 http://运营商域名/api/yaochufa/pushOrderStatus.jsp
推送订单退款通知 http://运营商域名/api/yaochufa/refundNotice.jsp

价格接口选择

要出发供应接口价格分为2种：自设价格和要出发价格

自设价格：运营商在自我游系统可以直接设置对接要出发产品的分销价和零售价。但是要出发的产品价格发生变化后需要运营商手动及时更改自我游系统的产品价格，要不然就会导致订单的价格与要出发的价格不一致的错误。

要出发价格：自我游系统直接同步要出发系统的采购价和零售价，在客人下单前会抓取要出发的最新价格，不会出现订单价格错误的情况，但是不利于设置分销价和零售价。
因此，运营商对接前一定要跟自我游运营部说明需要配置是哪一个接口。

自我游系统发布及设置

要出发推送产品给运营商会同步产品的基本属性，运营商可以到产品管理中通过定位供应商快速找到要出发推送的产品，选择所需的产品，修改对应景点，上传图片（产品的图片不能同步，需要运营商自己上传产品图片），进行价格及库存设置，分销商授权，再点击上架。

产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到要出发门票系统。

产品短信：产品可以不用设置成功预订等短信，客人下单支付成功后会下达到要出发系统，客人就会收到要出发那边发送的信息。

客人资料要求选择：(1)要出发出行人需要信息人数为一人那么对应自我游的客人要求资料是“只需要输入一个客人资料”。(2)要出发出行人需要信息人数为一人以上那么对应自我游的客人要求资料是客人“要求输入每个客人资料”。必填信息选择根据要出发的出行人的信息选择。

要出发订单必须在30分钟完成支付，所以订单取消设置为（30）分钟。

如对接运营商手工发布产品的，需要选择要出发门票接口，并填写对应产品编码。

对应接口：选择要出发门票接口。

产品编码：点击接口产品编号参考获取，产品编码填写对应要出发的产品编号。如下图：

 

价格及库存：（自设价格）要出发的结算价对应的是自我游采购价，在自我游设置的零售价一定要大于或者等于要出发的结算价，不然会对接失败

测试环节

使用分销商账号进行下单并支付。

订单退款

订单状态“已出票”：客人/分销商系统发起退改申请，自我游系统会自动将退改申请请求推送到要出发系统，如存在自动推送退改申请请求到要出发系统失败的情况，运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到要出发系统，要出发系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。要出发系统返回取消成功后，自我游系统的订单直接显示“撤单”。

订单状态“已完成”：客人/分销商系统先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到要出发系统。然后要出发系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。要出发系统返回取消成功后，自我游系统的订单直接显示“撤单”

常见问题

问题描述：订单出现异常？

解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志