收客易线路供应接口
接口实现功能
合作协议
收客易系统提供参数
对方技术配置回调地址
运营商提供参数
运营商需知
自我游系统发布及设置
测试环节
订单退款
常见问题
修改日期:20161230
修改人:许焕引
收客易线路供应接口
接口实现功能
订单同步(支持,是在订单支付成功后直接同步到收客易系统)。
取消订单、退单(支持) 收客易系统不支持部分退款。
查看收客易系统的订单详细(支持)。
查看收客易系统的订单日志(支持)。
重发短信(接口不支持)收客易未提供相应接口。
系统抓取订单详细核销验证(接口不支持)。
接口返码(不支持)
收客易订单详情接口并没有订单已完成的状态,所以未能开发。
****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款如有问题,请联系自我游公众号:自我游运营中心
合作协议
(运营商与收客易系统之间的合作协议)
收客易系统提供参数
在收客易注册的开发者的appId
在收客易注册的开发者的appSecret
对方技术配置回调地址
无
运营商提供参数
供应商ID必填。是运营商在系统里给收客易系统新增加一个供应商账号,用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通,参考该链接: http://kf.zowoyoo.cn/hc/kb/article/191732/】
加价规则必填:最少为加1。
运营商需知
无
自我游系统发布及设置
系统【产品管理】→【供应商产品接入】选择“收客易线路接口”类型-【管理产品】。
产品的【供应商】设置,选择为收客易系统对应自我游系统的供应商名称。
产品的【供应商产品接入】设置,由于收客易线路产品类型分为两种,分别是“散客产品”和“度假产品”。
“散客产品”的设置,在自我游系统的供应商产品接入的管理产品设置界面,【团队类型】的设置则选择为“拼团”。
“度假产品”的设置,在自我游系统的供应商产品接入的管理产品设置界面,【团队类型】的设置则选择为“度假套餐”。
运营商可点击引用:引用直接把产品引用到自我游系统的【产品管理】中,设置好供应商,价格规则,直接上架即可。
运营商可点击绑定:输入自我游系统已有线路的产品名称以及产品编号可直接绑订对应的线路产品。(适用于在自我游已经发布了的产品,绑定就不会重复)。
产品的【客人必填信息】一般都勾选为“姓名”和“手机号码”,否则会导致下单失败。
收客易的部分产品预订时需要提供“身份证号码”和“性别”的,在自我游系统产品的【客人必填信息】设置需要提供“身份证号码”和“性别”。
对接收客易系统的产品,是由收客易系统发送短信的。在自我游系统上是无需给产品设置短信,故产品的预定成功短信、生成通知单短信都设置为不发送短信即可。
测试环节
使用分销商账号进行下单并支付。
订单退款
对接收客易的订单处于:“新订单/预留位/申请计划位”这三种状态的情况下,收客易才可以直接取消。若退款时收客易系统响应可以退款则我方系统才做退款处理。
而其它状态的订单需向收客易申请取消,再由收客易审核,若收客易审核通过取消订单,则会将通知推送给自我游系统,只有此时自我游系统才会做退款处理。此类订单只支持退款一次。目前收客易方暂没提供退款推送接口的相关文档,所以暂不支持。
常见问题
问题描述:订单出现异常?
解决方法:通过点击订单编号,进入“查看详细的接口日志”可以查看本订单的日志