爱找票门票供应接口

接口实现功能

订单同步（是在自我游系统下达通知单时订单才会同步到爱找票门票系统）
取消退票（支持）
重新发码（不支持）
查看爱找票的订单详情（支持）
系统自动核销订单（支持）
接口返码（不支持）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心

合作协议

（运营商与爱找票系统之间的合作协议）

爱找票门票系统提供参数

00158cb95ec202b602fec4535494788

爱找票技术配置回调地址

http://运营商域名/api/aizhaopiao/finish.jsp

运营商需知

爱找票门票供应接口价格分为2种：【爱找票价格&自设价格】

自设价格：运营商在自我游系统可以直接设置对接爱找票产品的分销价和零售价。但是爱找票的产品价格发生变化后需要运营商手动及时更改自我游系统的产品价格，要不然就会导致订单的价格与同程的价格不一致的错误。
爱找票价格：自我游系统直接同步爱找票系统的采购价和零售价，在客人下单前会抓取同程的最新价格，不会出现订单价格错误的情况，但是不利于设置分销价和零售价。需要通过价格规则进行设置
因此，运营商对接前一定要跟自我游运营部说明需要配置是哪一个接口。

自我游系统发布及设置

系统【产品管理】→【产品发布】选择“门票”类型发布产品
供应商：选择新增加的对应中景信供应商名称，运营商给爱找票接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/ 】
产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到爱找票。
对接爱找票系统后，是由爱找票系统发送短信。则在自我游系统产品的“预定成功短信、生成通知单短信、出票短信”都设置为不发送短信。
显示产品的证件为“一人一证”，自我游系统的产品-客人必填信息：姓名、手机号码、身份证号码；证件包含数量为“0”，客人资料要求：只需要输入一个客人资料。
对应接口：由自我游配置好接口后才会显示。
点击“接口产品编号参考”，进入获取产品基本信息的页面，将产品ID复制粘贴到【供应商接口信息】-【产品编码】。然后将产品的名称等信息内容手工在自我游系统上发布设置
产品的采购价获取:【供应商接口信息】-【接口产品编号参考】，点击“获取产品价格库存ID”。
自我游系统【产品管理】→【价格及库存】设置价格。

测试环节

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

预订时需要填写游玩日期，预订票数，游客姓名和手机号，身份证号码。
下单成功后，取票人的手机收到一条下订单预订成功短信。

订单退款

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

常见问题

问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志
问题描述：对接爱找票的订单显示“通知对接失败”，提示错误是：爱找票返回的错误提示-请求频率超限

解决方法：
爱找票的系统对访问频率限制，请求间隔要有2秒。
处理办法：1）自我游系统每隔2分钟会自动执行对接失败的订单，等待系统自动刷新；2）运营商在自我游系统的订单详细-接口信息的‘通知同步错误’点击【重新执行】。
PS：针对这种对接失败的订单，商户请不要到爱找票的系统手工下单。如手工下单后，一旦自我游系统每隔2分钟会自动执行失败订单，订单也会自动同步到爱找票的系统，这样会导致订单重复。
问题描述：对接爱找票的订单显示“通知对接失败”，提示错误是：查询产品类型失败，爱找票方返回的错误提示-产品不存在。商户直接登录爱找票的系统是可以正常预订该产品的。

解决方法：
1.运营商在自我游系统上检查产品的【供应商接口信息】-【产品编码】绑定的产品ID与爱找票系统的产品ID是否一致。
2.运营商联系爱找票，让对方技术查询一下该产品在getProductInfo接口上是否可以正常分销