要出发酒店类抢购供应接口
接口实现功能
合作协议
要出发系统提供参数
运营商提供参数
要出发技术配置回调地址
运营商需知
自我游系统发布及设置
测试环节
订单退款
常见问题
修改日期：20191125
修改人：王佳惠
要出发酒店抢购供应接口
接口实现功能
下单（是在运营商发送通知单给要出发时才下单至要出发系统)
取消订单、退单（支持）
查看订单日志（支持）
取消订单、退单（支持，但不支持部分退款）
重新发码（支持）
查看订单详细信息（支持）
系统自动核销订单（支持）
接口返码（支持）
****温馨提示**** :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
自我游系统发布及设置
要出发推送产品给运营商会同步产品的基本属性，运营商可以到产品管理中通过定位供应商快速找到要出发推送的产品，选择所需的产品，修改对应景点，上传图片（产品的图片不能同步，需要运营商自己上传产品图片），编辑好价格库存（产品的采购价和零售价会默认同步过来），再点击上架。
产品短信：产品可以不用设置成功预订等短信，客人下单支付成功后会下达到要出发系统，客人就会收到要出发那边发送的信息。
客人资料要求选择：
(1)要出发出行人需要信息人数为一人那么对应自我游的客人要求资料是“只需要输入一个客人资料”。
(2)要出发出行人需要信息人数为一人以上那么对应自我游的客人要求资料是客人“要求输入每个客人资料”。必填信息选择根据要出发的出行人的信息选择。
需要和要出发核实订单是需要在多少分钟完成支付，产品订单取消设置要与要出发一致。
如对接运营商手工发布产品的，需要选择要出发门票接口，并填写对应产品编码。
对应接口：选择要出发门票接口。
产品编码：点击接口产品编号参考获取，产品编码填写对应要出发的产品编号。如下图：
价格库存：找到对应的产品，点击【抢购设置】进入设置价格库存。
测试环节
使用分销商账号进行下单并支付。
订单退款（不支持部分退款）
退款后需要等待要出发系统客服审核，该接口不支持部分取消。
1：订单状态“已出票”：分销商登录系统，【订单管理】点击【退改申请】，运营商在退改申请功能里允许取消并点击退款后，取消的申请才会下发到要出发系统。然后要出发系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。要出发系统返回取消成功后，自我游系统的订单直接显示“撤单”。
1：订单状态“已完成”：分销商先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到要出发系统。然后要出发系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。要出发系统返回取消成功后，自我游系统的订单直接显示“撤单”。
常见问题
问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志