千鱼-亲子周末门票供应接口对接(10018243).md
千鱼-亲子周末门票供应接口
接口实现功能
合作协议
千鱼-亲子周末系统提供参数
千鱼-亲子周末技术配置回调地址
自我游系统发布及设置
测试环节
订单退款
常见问题
编辑日期：20191203
编辑人：卢晓晴
千鱼-亲子周末门票供应接口
接口实现功能
取消订单和退改申请（支持）
支持整单退订。
不支持部分退订
查看千鱼-亲子周末接口订单详细（支持）
查看订单日志（支持）
系统自动核销订单（支持）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
合作协议
（运营商与千鱼-亲子周末系统之间的合作协议）
千鱼-亲子周末系统提供参数
运营商需要提供参数
运营商给千鱼-亲子周末接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/】
千鱼-亲子周末技术配置回调地址
核销测试通知地址 ： http://运营商/api/qianyu/finish.jsp
退订测试通知地址 ： http://运营商/api/qianyu/refundNotice.jsp
自我游系统发布及设置
运营商手工在自我游后台发布属性一致的门票产品，将以下列出的信息严格按照下面的要求来设置。
预定成功短信、生成通知单短信、出票短信都设置为不发送短信（备注：连连团系统发短信）。
产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到连连团。
发码数量，看对方产品核销是否支持多次验证
对应接口：由自我游配置好接口后才会显示，选择自我游配置的千鱼-亲子周末。
产品编码：通过点击产品编码参考进入产品列表查询对应的千鱼-亲子周末产品，然后将对应的绑定编码填写上。
测试环节
使用分销商账号进行下单并支付。
订单退款
已安排→分销商登录系统，【订单管理】点击【退改申请】，运营商在退改申请功能里允许取消并点击退款后，取消的申请才会下发到千鱼-亲子周末系统。然后千鱼-亲子周末系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。千鱼-亲子周末系统返回取消成功后，自我游系统的订单直接显示“撤单”。
已完成→分销商先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到千鱼-亲子周末系统。然后千鱼-亲子周末系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。千鱼-亲子周末系统返回取消成功后，自我游系统的订单直接显示“撤单”。
常见问题
问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志