启明芯门票接口(驴小宝新版)供应接口文档

自我游发表于:2018年08月24日 09:59:40更新于:2025年05月26日 17:54:19


修改日期:2025-05-26
修改人:邓媚娜

特别说明

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

接口实现功能

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

合作协议

(运营商与启明芯之间合作的合作协议)

启明芯系统提供参数

spacer.gifimage.png

运营商需要提供参数

自我游运营商给启明芯接口开一个供应商账号,用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通,参考该链接: http://kf.zowoyoo.cn/hc/kb/article/191732/

image.png

启明芯系统技术配置回调地址

消费通知地址:http://运营商域名/api/qimingxin/finish.jsp 
退款通知地址:http://运营商域名/api/qimingxin/cancelReturn.jsp

自我游系统发布及设置

方法一:产品导入

【供应商接口管理】---【已开通接口】,找到对应的启明芯接口,操作同步供应商产品进入产品列表,搜索启明芯后台的产品id,进行同步产品到系统。同步成功之后,在当前页面可以直接点击修改产品进入到产品详情完善产品资料(产品基本信息都会同步,但是产品景点标志图等还有其他信息需要手工完善跟供应商产品设置一致即可)。同步到自我游系统的产品在【产品管理】中也可以看到。

image.png

①产品生成通知单需设置为:在预订(支付)成功后自动锁定订单,无需生成通知单。自我游系统的订单是在下达通知单时才同步到启明芯系统。 

spacer.gif image.png

产品短信:若启明芯发短信

出票操作选择:需要

出票短信:不发送短信

image.png

③如需要自我游运营商发短信:【出票操作】设置为“需要”;【短信内容】需要编辑出票短信。出票短信内容编辑加入:$excode$(验证码)$excode2$(二维码链接)

image.png

④对应接口:产品导入时自动对应接口。

⑤产品编码:导入时自动对应启明芯系统查询产品编号

spacer.gif 


方法二:手工发布产品

运营商手工在自我游后台发布属性一致的门票产品,将以下列出的信息严格按照下面的要求来设置。

①产品生成通知单需设置为:在预订(支付)成功后自动锁定订单,无需生成通知单。自我游系统的订单是在下达通知单时才同步到启明芯。

image.png

②对应接口:自我游配置好接口后才会显示,选择自我游配置的启明芯接口。

③产品编码:通过点击产品编码参考进入产品列表查询对应的启明芯产品,然后将对应的绑定编码填写上。

image.pngspacer.gif

测试环节

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

订单退款

订单退款流程只能通过自我游系统操作退款,运营商不能直接到供应商系统进行退款】 
订单状态——》已出票:(1)分销商登录系统,【订单管理】点击【退改申请】,运营商在退改申请功能里允许取消并点击退款后,。取消的申请会直接推送到启明芯系统,然后启明芯系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。启明芯系统返回取消成功后,自我游系统的订单直接显示“撤单”。 
(2)对接分销商渠道接口:游客直接在分销商渠道接口发起退改申请,运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后,取消的申请才会下发到启明芯门票系统。启明芯门票系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。启明芯门票系统返回取消成功后,自我游系统的订单直接显示“撤单”。 
订单状态——》完成:分销商先线下联系运营商,然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后,取消的申请才会下发到启明芯系统。然后启明芯系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。启明芯系统返回取消成功后,自我游系统的订单直接显示“撤单

常见问题

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


    您需要登录后才可以回复