修改日期：20161230
 修改人:许焕引

特别说明

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

接口实现功能

下单（自我游订单是生成通知单的情况下才同步系统到小泥人系统）
取消订单、退单（支持）小泥人票务系统不支持部分退款,申请取消订单后需要等待小泥人客服审核。
查看小泥人票务系统的订单详细（支持）
查看小泥人票务系统的订单日志（支持）
接口返码（支持）
系统自动核销订单（支持，订单的核销状态是自我游系统主动去抓取，订单会自动变成已完成状态。但是有时也存在是抓取不到核销信息的可能，所以运营商要留意订单的状态）
重新发码（接口不支持）
***温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心

合作协议

（运营商与小泥人票务系统之间的合作协议）。

小泥人票务系统提供参数

小泥人技术配置回调地址

退款,核销回调地址http://运营商域名/api/xiaoniren/finish.jsp

自我游系统发布及设置

运营商给供应商接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/】

产品的【通知单生成控制】的设置，选择第三，出票设置选择为“需要”

对应接口：选择为“小泥人票务系统接口”。

产品编码：对应的是小泥人票务系统上的产品ID。小泥人票务系统的产品ID获取，点击“接口产品编号参考”,进入小泥人票务系统的产品列表，直接将产品ID输入即可。

测试环节

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

对接小泥人票务系统的产品，在自我游系统预订该产品时需要填写游玩日期，预定票数，游玩客人姓名和手机号。

预订成功后，订单的联系人手机会收到小泥人票务系统发出的短信，短信模版为：【小泥人】小泥人测试产品下单成功，电子编码。9000130811334138，可消费5次，有效期：2015-12-31；商家电话：01088333559, 地址：海淀区学院南路33号艺海商务酒店。

订单退款

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

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

常见问题

问题描述：订单出现异常？
解决方法：通过点击订单编号，进入“查看详细的接口日志”可以查看本订单的日志