途牛门票供应接口（10002913、10003657）.md
途牛门票供应接口
接口实现功能
合作协议
途牛门票提供参数
运营商须知
途牛门票配置回调地址
自我游系统发布及设置
测试环节
订单退款
常见问题
修改日期：20170103
修改人：张语嫣
途牛门票供应接口
接口实现功能
查看订单详细信息（支持）
查看订单日志（支持）
取消订单、退单（支持）
接口返码（不支持）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
合作协议
（运营商与途牛系统之间的合作协议）
途牛门票提供参数
运营商需要提供参数
运营商给途牛供应商接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/】
运营商须知
途牛门票供应接口价格分为2种：途牛价格和自设价格
自设价格：运营商在自我游系统可以直接设置对接途牛产品的分销价和零售价。但是途牛的产品价格发生变化后需要运营商手动及时更改自我游系统的产品价格，要不然就会导致订单的价格与途牛的价格不一致的错误。
途牛价格：自我游系统直接同步途牛系统的采购价，在客人下单前会抓取途牛的最新价格，不会出现订单价格错误的情况，但是不利于设置分销价和零售价。需要通过价格规则进行设置。
因此，运营商对接前一定要跟自我游运营部说明需要配置是哪一个接口。
途牛门票配置回调地址
途牛需要添加的ip
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
14.17.112.62
14.17.96.66
14.17.96.67
14.17.96.68
14.17.96.69
14.17.96.70
14.17.96.71
14.17.96.72
14.17.96.73
14.17.96.74
14.17.96.75
14.17.96.76
14.17.96.77
14.17.96.78
183.6.117.81
订单变更通知接口地址http://运营商域名/api/tuniu/finish.jsp
自我游系统发布及设置
方法一：
【供应商接口管理】---【已开通接口】，找到对应的途牛接口，操作同步供应商产品进入产品列表，搜索途牛后台的商品id，进行同步产品到系统。同步成功之后，在当前页面可以直接点击修改产品进入到产品详情完善产品资料（产品基本信息都会同步，但是产品景点标志图等还有其他信息需要手工完善跟供应商产品设置一致即可）。同步到自我游系统的产品在【产品管理】中也可以看到。
客人资料要求：客人必填信息选择“姓名”，“手机号码”。身份证根据“客人信息限制”来判断。
产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到途牛
产品短信：若是使用途牛的出票短信，在发布产品的时候就无需设置短信。
如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$，$excode2$这个是二维码链接
对应接口：产品导入时自动对应接口。
产品编码：导入时自动对应途牛系统查询产品编号。
方法二：
运营商手工在自我游后台发布属性一致的门票产品，将以下列出的信息严格按照下面的要求来设置。
客人资料要求：客人必填信息选择“姓名”，“手机号码”。身份证“客人信息限制”来判断。
产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到途牛
产品短信：若是使用途牛的出票短信，在发布产品的时候就无需设置短信。
如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$，$excode2$这个是二维码链接
对应接口：由自我游配置好接口后才会显示，选择自我游配置的途牛供应接口。
产品编码：通过点击产品编码参考进入产品列表查询对应的途牛产品，将对应的绑定编码填写上。
测试环节
使用分销商账号进行下单并支付。
订单退款
途牛门票接口不支持部分退款，退款需要途牛审核，审核工作日在一周内。
常见问题
问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志
Q：下单提示如图：
A：检查接口产品编码是否正确。