刘公岛门票供应接口.md
刘公岛门票供应接口
接口实现功能
合作协议
刘公岛系统提供参数
刘公岛技术配置回调地址
自我游系统发布及设置
测试环节
订单退款
常见问题
修改日期：2019.11.28
修改人：阿一
刘公岛门票供应接口
接口实现功能
下单（是在下达通知单时才下单到刘公岛系统）
取消订单（支持）
重发短信（不支持）
查看订单详细（支持）
查看订单日志（支持）
系统自动核销订单（支持）
接口返码（支持）
部分退款（支持）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
合作协议
（运营商与刘公岛系统之间的合作协议）
刘公岛系统提供参数
运营商需要提供参数
运营商给刘公岛接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。
【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/】
刘公岛技术配置回调地址
核销验证推送接口：http://ticket-app.zowoyoo.com/qingdaoheyou/consumeNotice
退款审核结果推送接口：http://ticket-app.zowoyoo.com/qingdaoheyou/noticeRefund
自我游系统发布及设置
方法一：
1.【供应商接口管理】---【已开通接口】，找到对应的刘公岛接口，操作同步供应商产品进入产品列表，搜索刘公岛后台的商品id，进行同步产品到系统。同步成功之后，在当前页面可以直接点击修改产品进入到产品详情完善产品资料（产品基本信息都会同步，但是产品景点标志图等还有其他信息需要手工完善跟供应商产品设置一致即可）。同步到自我游系统的产品在【产品管理】中也可以看到。
（注：客人必填信息——刘公岛所有产品都需要填写订单联系人、手机号码及身份证号码，其它字段根据刘公岛产品来确定是否为必填项。）
2.预定成功短信、生成通知单短信、出票短信都设置为不发送短信（备注：刘公岛系统发短信）。
3.产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到刘公岛。
4.对应接口：产品导入时自动对应接口。
5.产品编码：导入时自动对应刘公岛系统查询产品编号。
方法二：
运营商手工在自我游后台发布属性一致的门票产品，将以下列出的信息严格按照下面的要求进行设置。
（注：客人必填信息——刘公岛所有产品都需要填写订单联系人、手机号码及身份证号码，其它字段根据刘公岛产品来确定是否为必填项。）
2.预定成功短信、生成通知单短信、出票短信都设置为不发送短信（备注：刘公岛系统发短信）。
3.产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到刘公岛。
4.对应接口：由自我游配置好接口后才会显示，选择自我游配置的刘公岛。
5.产品编码：通过点击产品编码参考进入产品列表查询对应的刘公岛产品，然后将对应的绑定编码填写上。
注意：“产品编码”为刘公岛的“产品ID”，点击“接口产品编号参数”查找刘公岛所有产品列表 （支持多搜索产品编码如a,b,c 注意是英文状态下的逗号）；
测试环节
使用分销商账号进行下单并支付。
注：下单并支付后需要刘公岛返回出票通知，购买多少张票就录入多少名游客相关信息，成功下单后会收到对应的验证码数量；
订单退款
（注：退单需经过刘公岛人员申请审核，刘公岛工作人员申请通过并将审核通过的通知推送给自我游系统，我方系统才会自动退款。）
已安排：分销商登录系统，【订单管理】点击【退改申请】，运营商在退改申请功能里允许取消并点击退款后，取消的申请才会下发到刘公岛系统。然后刘公岛系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看），刘公岛系统返回取消成功后，自我游系统的订单直接显示“撤单”。
已完成：分销商先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到刘公岛系统。然后刘公岛系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。刘公岛系统返回取消成功后，自我游系统的订单直接显示“撤单”。
常见问题
问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志；