快手本地生活（日历票）对接操作指南

快手

自我游 • 发表于：2023年12月04日 11:02:19 • 更新于：2024年06月19日 16:41:23

编写人：简翠婷

编写日期：2023.12.04


接口实现功能

支持订单同步

支持退款同步

支持核销同步

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

 

对接前提

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

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


对接注意事项：

1、10分钟不出票快手就自动退款给客人

2、只支持自我游门票、套餐产品对接

3、只支持一人一码产品对接；一码多验需要对接的建议限购一份。

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

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

6、撤回核销：验证后一个小时内支持在自我游后台操作撤销核销，过期不可撤销核销，撤销后自我游后台订单状态不变。

7、目前只支持整单或者验证后剩余全部退。（如果需要部分退款，快手后台发起退款不能选择张数。需要自我游或景区先验证不可退数量后，再让客人在快手发起申请退款剩余数量，不能进行二次退款）

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

9、快手本地生活商家必须要在快手后台先认领门票POI，POI关联后添加适用人群的设置才能推送产品同步。

10、如需发布快手期票产品，请参考《快手本地生活(原生自建团购)》接口：http://kf.zowoyoo.cn/hc/kb/article/1605445/


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

1、自我游系统网址：

2、渠道接口备注名称：

3、快手账号ID：

4、商家ID：

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

image.png

5、客服电话：

6、绑定接口的分销商id：

【分销商需要设置授信额度，接口支付方式：授信扣除】

image.png


二、授权自我游

自我游配置完接口后，商家自行到快手店铺后台去确认应用授权

image.png


三、产品POI关联

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

image.png

自我游后台【渠道门票对接管理】--【进入管理】，点击【POI关联】--手工绑定快手门店

image.png

image.png 

image.png

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

image.png

设置适用人群--poi产品推送

image.png

image.png


四、自我游后台发布产品

1、选择对应类目发布产品（目前支持类目：门票，套餐）

image.png

2、发布产品注意事项

image.png

3、短信 【预订成功短信&出票短信二选一】

按照实际情况设置，如果需要自我游发送短信的话：

①：产品没有对接第三方供应系统/自我游码库发码，可以用预订成功短信：

编辑好短信模板【二维码代码：$url$，数字码代码：$password$】

image.png 

②：产品对接了第三方供应系统/自我游码库发码，可以用出票短信：

编辑好短信模板【二维码代码：$excode2$，数字码代码：$excode$】

image.png

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

image.png 

5、门票类目应到未到处理：人工做退改处理（如果支持多次验证必选这项）

image.png

6、设置一人一码

image.png

注意：如果是一单一码，产品必须设置限购一张

image.png

7、供应商账号设置核销配置

image.png 

是否可以验证：建议选择支持供应商验证（订单多次，不支持增值项目多次）

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

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


五、推送产品（产品授权--推送产品给快手）

1、【渠道门票对接管理】--【产品授权】

image.png

2、选择需要上架的产品--【授权】

image.png

3、授权后点击【信息设置】，完善信息后保存设置，点击同步产品。

image.png

注意：目前自我游是直接推送产品同步给快手

image.png

image.png

4、同步产品，审核通过后上架

image.png

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

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

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

②取消环节测试

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

注意：目前只支持整单或者验证后剩余全部退（如果需要部分退款，快手后台发起退款不能选择张数。需要自我游或景区先验证不可退数量后，再让客人在快手发起申请退款剩余数量，不能进行二次退款。）

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

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

③核销环节测试

整单核销，分次进行核销


七、相关问题

Q1：同步产品报错：同步失败:商品创建失败, 图片头图不可为空

image.png

A1：【产品描述】没有上传图片或者上传的图片尺寸过小，需要删除后重新上传图片

image.png

Q2：快手日历票同步产品的时候提示报错：同步失败:模板不存在 三级类目id:70100004,商品类型:日历票

c816ec74641e66359f3e19a16893de10.png

A2：日历票是有指定类目的，目前支持日历票的类目如下图，其他类目同步就会报错

163acc68e381cc17e095a13d5ad0157b.jpg

00165c0b01f18fa83055de90e777e61Q3：同步产品提示：同步失败：可用时间格式不正确

image.png

A3：注意【信息设置】里面的时间格式：

image.png


spacer.gif

spacer.gif


Q4：同步产品报错：同步失败:创建/编辑商品失败，图文描述不支持富文本格式内容

00165bcb11a4071553a2accb91400ff
A4：要检查推送的快手【信息设置】内，产品详情内容是不是出现<>等特殊符号00165bcb16622e8c60c9e347bd9eaa500165bcb16c126b2fc1b744f007f61a

Q5：信息设置--商品类目没法选择

8a87089d95c7e00ad4045f6cfbe17426.png

A5：检查快手后台是否正常授权

d05f88dfe4f7e598d31a48a651e1536.png









    您需要登录后才可以回复

    最多浏览的文档