分销接口与供应商接口对接测试的重要说明

自我游发表于:2022年02月21日 15:43:02更新于:2024年02月04日 15:34:00


     因各个平台/系统的运营规则,退改规则,核销方式等各不相同。所以在接口配置后,商户必须按测试清单的示例测试各种情况(例如订单支付,退款,部分退款,核销/部分核销等等)后,再上线正式产品销售。如未测试而导致损失,由商家承担(测试用例不能保证包含所有情况,如商家实际情况超出测试用例,商家必须测试),自我游不承担责任。常用测试用例可通过下述方式获取:
    点击【下载】按钮,或点击https://files.kf5.com/attachments/download/22428/12963569/0016215e64defdf38f6f55d93b8f8e8/  获取对接供应商接口《测试清单》附件。
    点击【下载】按钮,或点击https://files.kf5.com/attachments/download/22428/13750313/00162f5c32e3feec3caaa9bac296994/  获取对接OTA渠道及API接口《测试清单》附件,表一测试是产品对接供应商接口,表二测试是产品是自营产品。如无法下载,请联系自我游客服/运营索取测试用例。

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


重要提示:

(1)对接第三方景区系统的产品,再分销商到OTA渠道(例如美团/飞猪/口碑/抖音/携程/去哪儿等渠道)。该情况更复杂,产品链路过长,客人在分销侧平台发起退改申请,如果景区系统还没有同意退款的,商户在自我游后台不能直接到【退改申请处理】界面操作同意取消。这会导致客人游玩后又退款的情况。商户必须应该按从供应到分销端,逐级在确认同意退款。

(2)目前第三方景区系统,仍有大量没有实现退改申请的同步。游客在OTA(渠道)前端发起退改申请,自我游系统不会将退改申请直接推送给第三方景区系统,需要自我游商户在订单管理页面针对订单操作异常并且点击退款按钮。

(3)客服人员因无法完全清楚商家的产品销售规则,订单退改规则。提供的处理意见仅限于系统操作层面,其他仅为参考。

(4)所有的api对接,必须按支持的类目要求上线销售。不符和规则的产品上线销售,后果商户自行承担。

(5)因为第三方系统的接口调整,规则变更,自我游在获悉升级,技术实施升级均需要时间。在此期间可能出现对接异常。如有发现,商户应立即暂停销售,以避免进一步造成损失。并通知自我游对相应接口进行升级。


附一:API对接术语解释

  1. 一单一码:一个订单包含多张票,只有一个入园凭证码(所有票共同用一个码)。

  2. 一人一码:供应商如果支持根据包含数量发码的话,发码的数量为订单购买数量*包含人数。

  3. 一码一验:一个订单有多少张票就有多个入园凭证码,订单张数和入园码数量一致。

  4. 部分退:下单多张票,多次发起退改申请。等景区处理完第一次推送退改申请后,再发起第二次退改申请。

  5. 随时退:景区系统没有设置退款规则,自我游发起退改申请景区直接退款,景区不需要审核。

  6. 核销:游客提供入园码给景区,景区进行核销后这个码就消费(使用)了。

  7. 退改超期未处理强制退:游客发起退改申请,商户未在平台规定内的时间去处理订单退款请求,平台会自动将订单退款给游客。


附二:订单超期强制退说明(仅包含部分接口):

注意:以下处理方式仅供提示参考。下述规则因为第三方可能随时调整,具体请咨询第三方的BD或运营。

1.抖音:

(1)已出票的订单游客在抖音前端发起退改申请,逾期72小时不处理,抖音会自动退款给游客。
(2)过了游玩日期不核销的订单抖音那边会自动发起退改,并72小时内不处理,会自动退款给客人。

2.飞猪:

    已出票的订单游客在飞猪前端发起退改申请,逾期24小时不处理,飞猪会自动退款给游客。

3.美团:

    已出票的订单游客在美团前端发起退改申请,逾期24小时不处理,美团会自动退款给游客。

4.口碑:

(1)已出票的订单游客在口碑前端发起退改申请,逾期72小时不处理,口碑会自动退款给游客。
(2)过了游玩日期不核销的订单口碑那边会自动发起退改,并72小时内不处理,会自动退款给客人。

5.携程:

    目前不详,需跟携程业务核实

6.去哪儿:

    默认已出票的订单游客在去哪儿前端发起退改申请,逾期24小时不处理,去哪儿会退款给游客。

7.快手本地生活:

(1)已出票的订单游客在快手前端发起退改申请,逾期72小时不处理,快手会自动退款给游客。
(2)过了游玩日期不核销的订单快手那边会自动发起退改,并72小时内不处理,会自动退款给客人。


附三:出现对接问题自查流程:

情况一:订单无同步到自我游系统

①订单无同步到自我游系统:如有赞/携程等渠道,可在【渠道门票对接管理】查询日志

 

00165bf3d8ebd68b391cba3b79ce0e3

00165bf3d92546daf6e5dfc6c3ebcf4

 ②:订单无同步到自我游系统,如美团,去哪儿,蚂蜂窝,途牛,可在【渠道串货管理】找到对应的接口,再点击进入日志管理查看

 

情况二:定时查看筛选对接失败订单

建议定时查看筛选对接失败订单,并及时处理,避免造成不必要的损失。

 00165bf3dac7f084edc4506afde6485

情况三:订单有红字提示报错

订单已同步到自我游系统,但有红字提示报错。

1) 可把鼠标放在红字提示处查看提示。

2) 点击订单号进去查看对应日志报错。

00165bf3dcacd6c84e76704539a3307

00165bf3dce5495dc28cb6fdba10ef6


附件:API对接测试项目清单.xls • 24KB • 下载

附件:OTA渠道及API分销接口对接测试项目清单(1).xls • 32KB • 下载

    您需要登录后才可以回复