新版宏理票务供应接口

修改人：树丹

修改时间：2025年5月26日

接口实现功能

下单同步(支持)
取消订单（不支持部分退款）
查看宏理接口订单详细（支持）
查看订单日志（支持）
查看对方订单详情（支持）
主动抓取核销信息（支持）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心

合作协议

（运营商与宏理票务之间的合作协议）

宏理票务系统提供参数

图片.png

宏理票务系统技术配置

核销通知地址:http://运营商/api/hongli2/consumeNotice.jsp

运营商须知

宏理门票供应接口价格分为2种：宏理价格和自设价格

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

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

自我游系统发布及设置

方法一：产品导入

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

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

②产品短信：若宏理发短信

出票操作选择：需要

出票短信：不发送短信

③如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$（验证码），$excode2$（二维码链接）

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

⑤产品编码：导入时自动对应宏理系统查询产品编号

方法二：手工发布产品

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

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

②产品短信：若宏理发短信

出票操作选择：需要

出票短信：不发送短信

④对应接口：自我游配置好接口后才会显示，选择自我游配置的宏理接口。

⑤产品编码：通过点击产品编码参考进入产品列表查询对应的宏理产品，然后将对应的绑定编码填写上。

测试环节

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

订单退款

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

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