快手本地生活(日历票)对接操作指南

自我游发表于: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









    您需要登录后才可以回复