哈罗本地生活供应接口

接口实现功能

重新发码(不支持)
主动抓取核销(支持)
取消订单(支持)
获取对方订单详情(支持)
查询对方接口日志(支持)
接口返码（支持，并支持回传二维码）
商品详情同步(支持)
产品上下架(支持）
产品更新（支持）

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

合作协议

（运营商与哈罗本地生活之间的合作协议）

哈罗本地生活系统提供参数

图片.png

运营商需要提供参数

运营商给哈罗本地生活接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/】

哈啰本地生活技术配置

核销，出票，商品详情推送回调通知统一为 :http://ticket-app.zowoyoo.com/helloLocalLife/finishNotice

自我游系统发布及设置

方法一：

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

方法二：哈啰本地生活系统会自动推送产品，对方推送产品会在产品管理页面自动生成，商户到产品管理页面去针对产品操作上架，自我游系统直接同步哈啰本地生活系统的采购价和零售价，需要通过价格规则进行设置分销价给同行

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

产品短信：若是使用哈啰的出票短信，在发布产品的时候就无需设置短信。

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

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

产品编码：导入时自动对应哈啰本地生活系统查询产品编号。

测试环节

产品发布完毕，用分销商账号下单测试。

处理订单

查看订单状态，若订单状态显示【已成功，已支付。待出票】且哈啰本地生活通那边没有订单同步，检查一下订单是否已经生成了通知单，需要生成了通知单才会下单到哈啰本地生活通系统。
出票无误之后，测试验证，系统是会自动抓取核销信息的，观察一下哈啰本地生活通核销之后自我游系统的订单状态是否变成【已完成】。
一旦出现错误：让运营商截图，点击重新执行，查看失败原因；查看接口详细日志，是出现什么异常；查看产品编号是否已经填写正确。

订单退款

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