修改日期：20161230
修改人：张语嫣
特别说明
采购驴妈妈的产品再对接到抖音抖音/美团/飞猪/快手等渠道进行分销，订单退改申请，商家必须按时处理。目前对接所有第三方渠道（包括但不限于抖音/美团/飞猪/快手等，及未来新增加的渠道），客人发起退改申请，超过要求的期限商家未处理，第三方会直接退款给客人。如因商家逾期未处理造成损失，由商家承担，自我游不承担责任。
商家每天应登录自我游系统查看订单退改申请列表，及时联系供应商处理订单退改。
目前已知的退改时限（客人发起推该请求算起），抖音72小时，美团24小时，去哪儿24小时，飞猪24小时（部分景区产品飞猪是按即时退款执行）。
关于退改时限要求会有调整，请以各平台官方通告为准。
接口实现功能
查看订单详细信息（支持）
查看订单日志（支持）
取消订单、退单（不支持部分退款）
重新发码（支持）
抓取对方价格和库存（支持）
主动抓取核销信息（支持）
接口返码（部分产品不支持返码，具体需要跟驴妈妈人员确认）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
合作协议
（运营商与驴妈妈系统之间的合作协议）
驴妈妈系统提供参数
运营商需要提供参数
运营商给驴妈妈接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/】
驴妈妈技术配置回调地址
订单信息通知地址 http://运营商域名/api/lvmama/pushOrderInfo.jsp
退款通知地址 http://运营商域名/api/lvmama/pushOrderCancel.jsp
自我游提供参数
ip地址列表：
在为各运营商分配此接口时须向驴妈妈提供参数：
订单信息通知地址 http://运营商域名/api/lvmama/pushOrderInfo.jsp
退款通知地址 http://运营商域名/api/lvmama/pushOrderCancel.jsp
产品变更通知 http://运营商域名/api/lvmama/pushProductChange.jsp
地址列表：14.17.112.54,14.17.112.50,14.17.112.51,
14.17.112.52,14.17.112.53,14.17.112.54,
14.17.112.55,14.17.112.56,14.17.112.57,
14.17.112.58,14.17.112.59,14.17.112.60
122.13.172.21,14.17.112.52,58.248.137.132,
112.90.153.58, 58.248.137.132 ,14.17.112.62
2.5版本，xml格式
运营商提供参数
运营商需要发申请上线邮件给驴妈妈，邮件内容：公司全称、分销商名称、IP地址、推送接口地址（订单信息通知地、退款通知地址）、和接口文档版本号截图。
价格接口选择
自设价格：运营商在自我游系统可以直接设置对接驴妈妈产品的分销价和零售价。但是采购价要与驴妈妈的结算价价格一致，需要运营商手动及时更改自我游系统的产品价格，要不然就会导致订单的价格与驴妈妈的价格不一致的错误，导致下单失败。
驴妈妈价格：自我游系统直接同步驴妈妈系统的采购价和零售价，在客人下单前会抓取驴妈妈的最新价格，不会出现订单价格错误的情况，但是不利于设置分销价和零售价，需要通过价格规则进行设置 。
因此，运营商对接前一定要跟自我游运营部说明需要配置是哪一个接口。
自我游系统发布及设置
方法一：
【供应商接口管理】---【已开通接口】，找到对应的驴妈妈接口，操作同步供应商产品进入产品列表，搜索驴妈妈后台的商品id，进行同步产品到系统。同步成功之后，在当前页面可以直接点击修改产品进入到产品详情完善产品资料（产品基本信息都会同步，但是产品景点标志图等还有其他信息需要手工完善）。同步到自我游系统的产品在【产品管理】中也可以看到。
如果对接的驴妈妈价格，需要自我游后台将产品上架了才同步对方的结算价。
产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到驴妈妈。
产品短信：若是使用驴妈妈的出票短信，在发布产品的时候就无需设置短信。
如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$，$excode2$这个是二维码链接
对应接口：产品导入时自动对应接口。
产品编码：导入时自动对应驴妈妈系统查询产品编号。
方法二：
运营商手工在自我游后台发布属性一致的门票产品，将以下列出的信息严格按照下面的要求来设置。
产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到驴妈妈。
产品短信：若是使用驴妈妈的出票短信，在发布产品的时候就无需设置短信。
如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$，$excode2$这个是二维码链接
对应接口：由自我游配置好接口后才会显示，选择自我游配置的驴妈妈供应接口。
产品编码：通过点击产品编码参考进入产品列表查询对应的驴妈妈产品，将对应的绑定编码填写上。
测试环节
使用分销商账号进行下单并支付。
订单退款
退款后需要等待驴妈妈审核，驴妈妈处理退款的时间是3-5个工作日。不支持部分退款，关于退改时限要求会有调整，请以驴妈妈平台官方通告为准。
订单状态“已出票”：客人/分销商系统发起退改申请，自我游系统会自动将退改申请请求推送到驴妈妈系统，如存在自动推送退改申请请求到驴妈妈系统失败的情况，运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到驴妈妈系统，驴妈妈系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。驴妈妈系统返回取消成功后，自我游系统的订单直接显示“撤单”。
订单状态“已完成”：客人/分销商系统先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到驴妈妈系统。然后驴妈妈系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。驴妈妈系统返回取消成功后，自我游系统的订单直接显示“撤单”
常见问题
问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志
问题描述：下单对接失败，提示“获取价格失败，已经销售完毕或者取消班期”
解决方法：1. 联系驴妈妈确认产品是否有价格库存。2.确认价格库存充足，请跟驴妈妈技术确认是否已经添加此IP地址122.13.172.21
解决方法：1. 联系驴妈妈确认产品是否有价格库存。2.确认价格库存充足，请跟驴妈妈技术确认是否已经添加此IP地址122.13.172.21