携龙门票供应接口
接口实现功能
合作协议
携龙门票系统提供参数
携龙系统技术配置
运营商须知
自我游系统发布及设置
测试环节
订单退款
常见问题
修改日期:20171121
修改人:莫润乐
携龙门票供应接口
接口实现功能
下单同步(支持)
价格和库存同步(支持)
重新发码接口(不支持)
返码(根据供应商产品是否有码)
取消订单(支持)
订单退款(退款后需要等待携龙系统审核,不支持部分退款)
查看对接订单日志、订单详情(支持)
系统自动核销订单(支持)
****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款如有问题,请联系自我游公众号:自我游运营中心
合作协议
(运营商与携龙门票系统之间的合作协议)
携龙门票系统提供参数
携龙系统技术配置
订单确认通知:http://运营商域名/api/xielong/confirmNotice.jsp
订单支付通知:http://运营商域名/api/xielong/payNotice.jsp
订单出票通知:http://运营商域名/api/xielong/printNotice.jsp、
订单取消通知:http://运营商域名/api/xielong/cancelNotice.jsp
订单退改通知:http://运营商域名/api/xielong/changeApplyOrderNotice.jsp
订单核销通知:http://运营商域名/api/xielong/finishNotice.jsp
产品变更通知:http://运营商域名/api/xielong/updateProduct.jsp
IP地址列表:
14.17.112.54, 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
122.13.172.21, 14.17.112.52, 58.248.137.132,
122.13.172.21,14.17.112.62, 14.17.96.76
运营商须知
携龙门票供应接口目前只有携龙价格接口
携龙价格:自我游系统直接同步同程系统的采购价和零售价,在客人下单前会抓取携龙的最新价格,不会出现订单价格错误的情况,但是不利于设置分销价和零售价。需要通过价格规则进行设置
商户可以在【供应商管理】里针对同程这个供应商设置一个统一的价格规则,设置分销价。
自我游系统发布及设置
配置好接口过后在自我游【携龙产品管理】中同步携龙产品,必须自我游系统添加同程的供应商账号,在【携龙产品管理】页面输入并定位这个供应商,点击保存后,在进行导入产品。这样操作后自我游系统就会自动生成新产品到【产品管理】,【供应商帐号开通,参考该链接:http://kf.zowoyoo.cn/hc/kb/article/191732/】
会自动同步产品的基本属性,对应景点,产品的图片不能同步,需要运营商自己上传产品图片
3.产品的【通知单生成控制】的设置,自我游系统的订单是在下达通知单时才同步到同程。建议此项选择为“在预订(支付)成功后自动锁定订单,无需生成通知单”
4.客人资料要求设置为:【只需要输入一个客人资料】,客人必填信息选择姓名、手机号码。
对应接口:由自我游配置好接口后才会显示,选择自我游配置的携龙门票接口。
接口产品编码查询:点击参考产品编号进入产品列表,携龙门票系统的产品编码参考如下图
短信发送:运营商需跟携龙核实谁发送短信,如是自我游商家发送短信,自我游必须要设置出票短信,短信内容含有excodeexcode代码(excodeexcode获取就是对方返回的码)。
对应接口:由自我游配置好接口后才会显示。
查询产品接口编码:点击参考产品编号进入到产品列表,携龙门票系统的产品编码参考如下图
测试环节
下单:使用分销商账号进行下单并支付。
订单退款
自我游系统先发起退款申请,发起了退款申请后退款要求会下达到携龙门票系统那边,需要等待携龙门票系统【审核】才可退款,但是【不支持部分退款】。
已安排:分销商登录系统,【订单管理】点击【退改申请】,退改请求会下发到携龙门票系统,等携龙门票系统审核处理退款。然后携龙门票系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。携龙门票系统返回取消成功后,自我游系统的订单直接显示“撤单”。
已完成:分销商先线下联系运营商,然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后,取消的申请才会下发到携龙门票系统,等携龙门票系统审核处理退款。然后携龙门票系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。携龙门票系统返回取消成功后,自我游系统的订单直接显示“撤单”。
常见问题
问题描述:如何产品对方订单详情?
解决方法:通过点击“查看对方订单详细内容”可以查看本订单在对方系统的详情
如果查看订单日志?
解决办法:通过点击“查看详细的接口日志”可以查看本订单的日志情况