同程门票供应接口

自我游发表于:2017年02月23日 11:27:27更新于:2023年12月13日 18:31:14

修改日期:20161230
修改人:张语嫣


特别声明

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

接口实现功能

下单(是在下达通知单时才下单到同程门票系统)
重新发码(支持)
取消订单、退单(不支持部分退款)
查看同程门票系统的订单详细(支持)
查看同程门票务系统的订单日志(支持)
系统自动核销订单(支持) 
接口返码(不支持)

订单的核销状态是由自我游系统主动去抓取,订单会自动变成已完成状态。但是有时也存在是抓取不到核销信息的可能,所以运营商要留意订单的状态,抓取核销是半小时抓取一次,订单过了游玩日期系统将不在抓取。

****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款如有问题,请联系自我游公众号:自我游运营中心

合作协议

(运营商与同程系统之间的合作协议)

同程系统提供参数

image.png

其中,如果需要配置多个手机号 用英文逗号分隔

运营商提供参数

image.png

同程技术配置回调地址

同程门票退款回调接口:http://运营商域名/api/tongcheng/RefundCallback.jsp

运营商须知

同程门票供应接口价格分为2种:同程价格和自设价格

自设价格:运营商在自我游系统可以直接设置对接同程产品的分销价和零售价。但是同程的产品价格发生变化后需要运营商手动及时更改自我游系统的产品价格,要不然就会导致订单的价格与同程的价格不一致的错误。

同程价格:自我游系统直接同步同程系统的采购价和零售价,在客人下单前会抓取同程的最新价格,不会出现订单价格错误的情况,但是不利于设置分销价和零售价。需要通过价格规则进行设置
因此,运营商对接前一定要跟自我游运营部说明需要配置是哪一个接口。

自我游系统发布及设置

  1. 配置好接口过后在自我游【同程门票绑定】中同步同程产品,必须建立同程的供应商,在同程产品管理页面输入并定位这个供应商,点击保存后,再进行导入产品。这样操作后自我游系统就会自动生成新产品到【产品管理】,【供应商帐号开通,参考该链接: http://kf.zowoyoo.cn/hc/kb/article/191732/】。

    00158c799c0a572b4257b5672c116f1
    00158c799f4529df8178f89268ef050

  2. 会自动同步产品的基本属性,产品的图片不能同步,需要运营商自己上传产品图片。

  3. (自设价格接口)价格及库存:自我游的采购价必须要跟同程的结算价一致,不然会对接失败 。

  4. 同程价格接口: 如果是对接同程价格的,系统是自动抓取同程价格(采购价及零售价)和库存。
    商户可以在【供应商管理】里针对同程这个供应商设置一个统一的价格规则,设置分销价。
    00158c79a48850ca0ec49cfd8b5c02d

  5. 产品的【通知单生成控制】的设置,自我游系统的订单是在下达通知单时才同步到同程。建议此项选择为“在预订(支付)成功后自动锁定订单,无需生成通知单”  
    00158c79a14cce1d1473f5bd3f8c90c

  6. 客人资料要求要选择“只需要输入一个客人资料”,客人必填信息选择姓名,手机号码,身份证号码。

  7. 对接同程门票系统的产品,是由同程门票务系统发送短信的。在自我游系统上是无需给产品设置短信,故产品的预定成功短信、生成通知单短信、出票短信都设置为不发送短信即可。

  8. 对应接口:由自我游配置好接口后才会显示。

测试环节

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

订单退款

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

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


常见问题

问题描述:订单出现异常?
解决方法:通过点击“查看详细的接口日志”可以查看本订单的日志,根据接口提示进行处理。
00158c79a5e2eaf8560d82b38d039e2

    您需要登录后才可以回复