途牛门票分销接口文档
接口实现功能
合作协议
途牛需提供参数
运营商需提供参数
自我游需提供给途牛参数
自我游产品发布及设置*
途牛系统设置及操作
产品推送步骤
测试环节
订单退款
常见问题
修改日期：20161229
修改人：语嫣
途牛门票分销接口文档
接口实现功能
产品名称同步； 提前预订天数，产品编码
价格及库存同步（只同步分销价即是运营商与途牛之间的结算价）；
订单、退款和核销同步。
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款，如有问题，请联系自我游公众号：自我游运营中心
合作协议
（运营商需与途牛先达成合作并签署合作协议）
途牛需提供参数
运营商需提供参数
【该分销商编号获取方法，参考该链接：http://kf.zowoyoo.cn/hc/kb/article/1009468/】
自我游需提供给途牛参数
以下3个推送地址需要运营商提供给途牛，不可改动该推送链接。
1.产品回调通知地址
http://api.zowoyoo.cn/channel/tuniu/tuniuProdSync.jsp
2.产品取消接口
http://api.zowoyoo.cn/channel/tuniu/cancelLvOrder.jsp
3.产品下单支付接口
http://api.zowoyoo.cn/channel/tuniu/createLvOrder.jsp
白名单：
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
14.17.112.61
自我游产品发布及设置*
【合作伙伴→分销商管理】点击“管理”，设置接口支付方式为“授信扣除”；点击“信用授权”设置信用额度。（建议额度大一点，便于接口下单，授信不足会下单失败）。
运营商在自我游系统以“门票”产品类型来发布。
如果是门票+门票的套餐产品也是可以支持对接途牛旅游门票分销接口。如有商户将这种套餐产品对接到途牛，必须是用自我游系统的“产品发布–套餐”或“产品打包管理–套餐或联票”来发布该套餐产品。如下图所示：
产品的销售范围必选为允许”对同行和直客销售“的产品。
途牛系统设置及操作
运营商必须先将在自我游系统需要对接的产品编号提供给途牛的业务，让对方在途牛后台绑定。
产品必须要等途牛业务在途牛系统将产品绑定后自我游系统才会给产品授权成功的，更新团期时才能正常售卖，如果没有给产品ID给途牛绑定，是不会展示的，因此建议给途牛对应的分销商设置产品授权为白名单。
将产品提供给途牛业务时，一定要跟途牛业务说明产品的退款规则。目前途牛的订单退款接口分为2种：
1）人工取消–即是途牛客服线下电话联系运营商申请取消；
2）通过调用接口自动取消。
特别是需要审核的产品，途牛直接选择支持“人工取消”，就不调自动取消接口。产品推送步骤
运营商回到自我游系统【途牛旅游门票管理】给产品操作授权：【授权】——【更新团期】。
【途牛旅游门票管理】点击“产品授权”进入门票产品管理的页面（PS：该功能只授权产品跟推送，修改产品内容需要在“产品管理”中修改），选择需要对接的产品，点击“授权”。
授权产品后点击“更新团期”，进行推送团期即是推送价格（PS：目前自我游系统只推送3个月的价格给途牛）。另外，运营商如果在【产品管理】修改了产品的价格后，需要再回到【途牛旅游门票管理】——【更新团期】进行推送团期。
温馨提示：产品需要停止推送给途牛，运营商除了在自我游系统点击【途牛旅游门票管理】——【取消授权】外，建议运营商最好是线下跟途牛业务联系，让途牛业务将产品在途牛网站下架。因为点击【取消授权】的功能后，只是客人无法在途牛网站预订下单，但产品还是可以正常显示在途牛网站上。
途牛产品推送，是根据途牛异步回调通知是否成功的，请勿连续点更新团期和取消授权操作。
在自我游系统上已授权给途牛的产品后会显示【关闭团期】，该功能是用于产品的价格在某日或某段时间已对途牛停止销售时，运营商需要在自我游系统【产品管理】将产品售卖日期关闭后，除了点击【更新团期】后，必须要点击该功能。这样才会将已停止售卖的日期推送给途牛。
测试环节
在途牛网上找到自己的产品，并下一个测试单。
订单退款
一：如果途牛设置的是人工取消–即是途牛客服线下电话联系运营商申请取消。
二：如果是通过调用接口自动取消，那客人在途牛后台发起取消申请，运营商在自我游系统中审核。请在平台规定时间内处理退款，如逾期未处理造成损失，自行承担。
自营订单退款处理
①如接口要求自营产品需要人工审核，客人在途牛发起退款申请，自我游商户必须在自我游系统【退改申请处理】，点击【处理】。自我游商户请勿对订单做异常处理，此操作退款状态是无法同步到途牛。
7.2、对接第三方供应商系统的订单退款处理
①客人在途牛发起退款申请，该订单对接的供应商接口还没升级自动推送退款请求，自我游商户需在自我游系统针对订单操作“异常处理”，选择“允许取消”保存后，再点击“退款”。接口自动将退款信息推送给供应商，等供应商返回退款处理结果。（退改申请处理里暂时不要进行任何操作） ，供应商同意退款，运营商再回到自我游【退改申请处理】，点击【处理】“同意取消”。若供应商拒绝退款，点击“拒绝取消”。状态会直接同步到途牛。
②该订单对接的供应商接口还没升级自动推送退款请求，商户想实现自动推送退款请求给到供应商接口，自我游系统产品可设置退款规则，客人发起退款申请时，自我游系统会自动将退款请求推送给供应商接口，等供应商返回退款处理结果。自我游会将“同意”或“拒绝”状态推送给途牛。PS：该设置以实际下单退款后结果为准，因不是所有供应商接口都支持，在设置之后下单测试后产品再上线
③客人在途牛发起退款申请，该订单对接的供应商接口可实现自动推送退款请求，接口自动将退款信息推送给供应商，等供应商返回退款处理结果。（退改申请处理里暂时不要进行任何操作） ，等供应商返回“同意退款”或“拒绝退款”状态给自我游，自我游再推送给途牛。
常见问题
Q:授权产品提示以下错误，是什么原因？
A：商户是否将对接的产品编号提供给途牛的业务，让对方在途牛后台绑定。
Q: 在途牛旅游门票管理点击更新团期提示
A：原因：首先需要授权产品给途牛，然后产品ID给到 途牛产品人员，途牛会把 自我游产品ID与途牛产品ID 做个映射关系配置，配置好以后， 再操作更新团期操作。