休闲护照(微程之家)门票供应接口文档

自我游发表于:2018年08月24日 13:57:32更新于:2023年11月30日 14:04:38


修改日期:20180824 
修改人:符娇珠

特别说明

采购微程之家系统的产品再对接到抖音抖音/美团/飞猪/快手等渠道进行分销,订单退改申请,商家必须按时处理。目前对接所有第三方渠道(包括但不限于抖音/美团/飞猪/快手等,及未来新增加的渠道),客人发起退改申请,超过要求的期限商家未处理,第三方会直接退款给客人。如因商家逾期未处理造成损失,由商家承担,自我游不承担责任。
    商家每天应登录自我游系统查看订单退改申请列表,及时联系供应商处理订单退改。
    目前已知的退改时限(客人发起推该请求算起),抖音72小时,美团24小时,去哪儿24小时,飞猪24小时(部分景区产品飞猪是按即时退款执行)。
关于退改时限要求会有调整,请以各平台官方通告为准。

接口实现功能

查看订单详细信息orderDetail(支持) 
查看订单日志(支持) 
系统自动核销订单(支持) 
取消订单、退单(不支持部分退款) 
返码(支持) 
重新发码(不支持) 
****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款如有问题,请联系自我游公众号:自我游运营中心

合作协议

(运营商与休闲护照门票之间合作的合作协议)

休闲护照门票系统提供参数

image.png

休闲护照门票系统技术配置回调地址

核销回调地址:http://运营商域名/api/xiuxianhuzhao/finish.jsp

运营商提供参数

自我游系统发布及设置

1.运营商在系统给休闲护照门票供应接口新增一个供应商,用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通,参考该链接:http://kf.zowoyoo.cn/hc/kb/article/191732/】,注意:添加供应商时,供应商结算模式必须设置如图spacer.gif 

image.png2.发布产品时,供应商选项必须要选择给休闲护照门票系统添加的供应商,供应商选项不能为自营产品spacer.gif 

image.png

3.产品生成通知单需设置为:在预订(支付)成功后自动锁定订单,无需生成通知单。自我游系统的订单是在下达通知单时才同步到休闲护照门票系统。

 image.png

4.运营商发送短信,必须要设置出票短信,【出票操作】设置为“需要”;【短信内容】需要编辑出票短信。出票短信内容编辑加入:$excode$这个是数字码链接,必须设置两个代码! spacer.gif 【现在休闲护照门票供应商不支持返回二维码】
image.png


客人资料要求要选择“根据休闲护照门票系统的产品客人必填信息“ 去设置 
对应接口:由自我游配置好接口后才会显示。 
产品编码:登录休闲护照门票系统查看产品编码

测试环节

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

订单退

订单状态“已出票”:客人/分销商系统发起退改申请,自我游系统会自动将退改申请请求推送到微程之家系统,如存在自动推送退改申请请求到微程之家系统失败的情况,运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后,取消的申请才会下发到微程之家系统,微程之家系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。微程之家系统返回取消成功后,自我游系统的订单直接显示“撤单”。

订单状态“已完成”:客人/分销商系统先线下联系运营商,然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后,取消的申请才会下发到微程之家系统。然后票付通系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。票付通系统返回取消成功后,自我游系统的订单直接显示“撤单”。

常见问题

问题描述:订单出现异常? 
解决方法:通过点击“查看详细的接口日志”可以查看本订单的日志


    您需要登录后才可以回复