快手本地生活(原生自建团购)对接操作指南

自我游发表于:2023年04月13日 21:06:18更新于:2024年07月26日 16:39:07


接口实现功能

产品同步

支持订单同步

支持退款同步

支持核销同步

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


对接前提

1.已注册快手本地生活商家账号并通过资质审核http://lbs.kuaishou.com/league/login)

2.已有自我游SaaS系统运营商账户。

 

对接注意事项:

1、10分钟不出票快手就自动退款给客人,*快手不会把退款状态传给自我游,订单状态需商家到快手后台核实。

2、如需发布日历产品,请参考《快手本地生活-日历票》接口:http://kf.zowoyoo.cn/hc/kb/article/1636503/

3、只支持自我游门票、套餐、抢购类目产品对接

4、只支持一人一码产品对接,一码多验需要对接的建议限购一份。当订单一单多套,只发一个码的情况,快手会自动退款,或造成核销/退款不同步的情况!!!!

5、订单退款:需要客人在快手端发起退款请求,收到退款申请后必须在72小时内处理退款,如无按时处理订单审核,快手会自动强制退款给客人。
(快手会监控退款时长超过3小时的订单,因为会对用户体验有影响,快手后期会对退款时效慢的商家做处罚)

6、过期退款:订单超过有效期后,快手会自动发起退款请求,收到退款申请后必须在72小时内处理退款,如无按时处理订单审核,快手会自动强制退款给客人。

7、撤回核销:验证后一个小时内,支持在自我游后台"渠道门票对接管理"页面找到对应订单撤回核销操作。

8、产品延期:需要在自我游系统和快手后台同时操作延期。

9、快手本地生活商家必须要在快手后台先认领门票POI,POI关联后才能推送产品同步。

10、请在有效期内及时核销订单,订单有效期过期无法同步核销。如:有效期至6月16日,过期后6月17日核销则无法同步。

11、支持部分退款,但目前不支持扣退款手续费、设置支持随时退的退款时间(排期升级中)

 

一.提供以下参数给自我游配置快手本地生活接口

自我游系统网址:

渠道接口备注名称:

快手账号ID:

商家ID:

备注:本地生活商家账号登录后台,点击右上角商家名称就可以看到快手账号id和商家id。

00164380078639c8d491c09ae6c13af 

客服电话:

客服服务开始时间:

客服服务结束时间:

绑定接口的分销商id:【分销商需要设置授信额度,接口支付方式:授信扣除】

0016438007897591944cb297958b056

以上参数提供给公众号【自我游运营中心】备份配置接口。


二、授权自我游

接口配置后,会收到短信提醒授权自我游。
店铺主账号在PC端商家中心-店铺管理-应用授权下操作“去授权”,或在APP内我的店铺-生活服务-商家应用-应用授权下操作“去授权”,将跳转到授权页面。
店铺主账号确认应用、权限组等信息,点击“授权并登陆”。

0016475a4f5b4053b51e38c1b112339

 

三、产品POI关联

注意:快手本地生活商家必须要在快手后台先认领门票POI,POI关联后才能推送产品同步。

001643800787c4947b5b9673f08f532 

 

到自我游渠道门票对接管理进入管理,点击POI关联。

001643800787bcbf07037cc333a6722

001643800784c080dc7180c3b632e90 

搜索产品对应的自我游景点ID(POI管理只会显示产品管理中已有绑定的景点)
点击手工绑定门店,填写快手POIID(注意:快手poiid为纯数字)

00164380078920ee7ecad38cbf593e4 

已在快手绑定门店,自我游点击快手POI管理,可直接复制POIID填写

0016438007c56d0c2494d505c10a390 

 

四、自我游后台发布产品

3.1 选择对应类目发布产品

目前支持类目:门票,套餐,抢购

 001643800784f79ac9ae77c9f3f287c

3.2 发布产品注意事项

①设置产品有效期

0016438014ac2417520d3b59860733c 


预订成功短信

按照实际情况设置,如需发送短信:编辑好短信模板【二维码代码:$url$,数字码代码:$password$】

image.png

产品限购设置【限购条件需要跟快手后台限购条件保持一致】

对接供应商接口/绑定码库出票

门票类目:通知单选择在预订(支付)成功后自动锁定订单,无需生成通知单

出票:需要

出票短信:按实际需求设置

对应接口:选择对应接口

供应商产品编码:绑定供应商系统产品编码(按实际情况设置)/码库编码

image.png

image.png

订单自动完成:必须人工验证订单才能完成状态

image.png

门票类目应到未到处理:人工做退改处理(如果支持多次验证必选这项)

image.png

⑦设置一人一码,发码数量选择包含人数发码

0016438033d2864e6b03d4e595346ae

⑧设置图片头图:图片格式需大于360*360,并点击标志图

001648847935a19658ca14bf87d4a73


3.3 供应商账号设置核销配置

是否可以验证:建议选择支持供应商验证(订单多次,不支持增值项目多次)

二维码内容:验证码转成二维码

支持验证内容:勾选实际支持进行核销验证方式

image.png

 

五、产品授权

产品授权有两种方式二选一操作:

①无需在快手后台手动创建产品,自我游产品直接推送产品同步到快手后台;
②快手后台已创建产品,在快手后台绑定自我游产品编码


第一种:自我游产品同步到快手

对应接口点击产品授权

0016438021da2a2798d0948ac2650a2

选择对应产品点击授权

001645ced15b2bc47798e32311093d6

授权后点击信息设置,完善信息后保存设置,点击同步产品。

注意:
快手产品编码为空不填,同步成功后自动会绑定快手编码。
快手商品类目按照实际快手POI类型选择。

001645ccb4a35b62d143e621cbd64e2

快手POI类目查看方式:快手搜索POI名称,选择地点。名称左下角的是POI类目001645ccbad92cf43cbb518dfee83ca

同步产品后审核状态显示【待审核】。当审核通过,手工点击上架同步,显示审核通过,快手后台产品即可下单。

001643802bfb59458f5ae47d03a9ae9 



第二种:
快手后台已创建产品,在快手后台绑定自我游产品编码

快手后台发布产品,填写自我游编码。

0016475a6104bdbcd8c6b465fab19a2

格式按照:自我游产品id_分销商id(注意:分销商编号为步骤一中配置快手接口的分销商编号)

选择服务商名称:自我游门票酒旅

001645cecad81fec2f4bbf9e2ec9408

商家系统sku编码格式:产品id_分销商id_产品id_分销商id

image.png


自我游选择对应产品点击授权

001645ced15b2bc47798e32311093d6

授权后点击信息设置,必须填写快手产品编码,完善信息后保存设置

001645cecada9ae5032f93b77052824

001645cecad88e5fc5ab6304be11957

点击【同步产品】,直接点击【上架同步】,后续产品上下架会同步状态。001645ddb9d0fdfe32d70203ac6b3dc

 

验证后一个小时内撤回核销操作

点击"渠道门票对接管理”,进入日志管理,显示所有快手订单,关键字搜索自我游或快手单号。00164afa75de53a2c2340673461a58a

点击"券码详情”跳转到券码状态及"撤销核销"。

00164afa7664ab979b5df1461829d1f注意:所有已核销订单都会显示"撤销核销"的操作按钮,但是只有验证后一个小时内的订单点击才会撤销成功。撤销成功后自我游订单状态还是已完成不变,只有快手核销状态会撤销。00164afa77a4d25d6363c63592c0259


六、下单测试【对接完成后必须按照以下情况分别下单进行测试】

①发码环节测试(测试发码数量是否与预定数量一致)

一次下单张数量,一次下多张数量

②取消环节测试

整单取消,未核销情况下申请部分数量取消,部分数量核销后取消,另外未核销数量申请取消,

取消申请审核中,对订单申请取消数量进行核销,

取消申请审核中,对订单未申请取消数量进行核销

③核销环节测试

整单核销,分次进行核销
注意:请在有效期内及时核销订单,订单有效期过期无法同步核销。如:有效期至6月16日,过期后6月17日核销则无法同步。

 

七. 相关问题

Q1同步产品报错  同步失败:1

A1:检查产品是否有产品库存,并点击“信息设置”,检查快手商品类目是否对应POI类目选择

001643802cf93642194fd03b26c4fd0 001645ccb4a35b62d143e621cbd64e2

 

Q2:客人成功下单后自我游订单管理没有生成订单,快手10分钟后自动退款

A2:点击渠道门票对接管理,进入日志管理。点击对应快手订单号,可查看报错原因

0016438030710f0c49c6820ee4994b1 001643800789643824dc191621c525f


Q3:同步失败:团购价应小于9999999.99元!
A3:

①检查自我游后台,产品销售时间是否开售。

检查自我游后台,最大可预订天数,建议设置0。

③检查自我游后台,价格库存:是否有设置开始销售日期--游玩结束日期的价格库存。

(ex:产品开售时间23/1/10-23/1/15,可游玩日期:23/1/10-23/3/31,那需设置23/1/10-23/3/31的价格库存)


Q4:快手是否支持授权多个服务商

A4:快手支持一个账号授权多个服务商,但是一个产品只能选择一个服务商发码,产品选择了某个服务商的应用后,该产品就无法修改选择其他服务商。


Q5:快手后台产品绑定过别的服务商,要更换成自我游服务商发码,已授权自我游,但是产品无法选择自我游服务商
A5:产品一旦绑定了某个服务商的应用是不支持修改的,只能重新发布产品才能选择自我游


Q6:同步失败:商品创建失败,图片头图不可为空

001648848d6b8228b0b29fefb9a6dd7A6:产品详情上传的图片标志图格式需大于360*360像素
001648847935a19658ca14bf87d4a73


Q7:快手产品同步失败:该商户商品列表中有不唯一的商品

00164c1e4e846064990aa4753ad8ef7

A7:因为快手不能重复创建相同产品编码,如果快手后台出现了2个产品信息,要删掉其中一个。


Q8:接口日志报错:预定数量跟码数量不一致,请检查是否一人一码产品。

A8:对接快手产品必须设置一人一码!!不设置一人一码出票快手会发码失败,就算订单发码成功了,也还会导致客人使用后核销状态无法同步到快手,相当于客人使用后还可以发起退款申请,过期还会自动退款。


Q9:快手团购产品是从自我游推送过去的,但是产生订单没有到自我游系统并且不是自我游发码,变成了快手发码。

A9:

1、修改产品如果保存操作太快右侧的诊断还没完成,保存的时候会有几率保存信息不成功

0016682ac3a8880b8d5a9576187107f2、建议每次在快手后台修改完产品,点进去查看  【选择接入系统】这个位置有没有绑定成功自我游0016682ac56f0b0307f4dfbddf70b8b

    您需要登录后才可以回复