编写人：简翠婷
编写日期：2023.12.04
接口实现功能
支持订单同步
支持退款同步
支持核销同步
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
对接前提
1.已注册快手本地生活商家账号并通过资质审核（https://lbs.kuaishou.com/league/login）
2.已有自我游SaaS系统运营商账户。
对接注意事项：
1、10分钟不出票快手就自动退款给客人
2、只支持自我游门票、套餐产品对接
3、只支持一人一码产品对接；一码多验需要对接的建议限购一份。
4、订单退款：需要客人在快手端发起退款请求，收到退款申请后必须在72小时内处理退款，如无按时处理订单审核，快手会自动强制退款给客人。
5、过期退款：订单超过有效期后，快手会自动发起退款请求，收到退款申请后必须在72小时内处理退款，如无按时处理订单审核，快手会自动强制退款给客人。
6、撤回核销：验证后一个小时内支持在自我游后台操作撤销核销，过期不可撤销核销，撤销后自我游后台订单状态不变。
7、目前只支持整单或者验证后剩余全部退。（如果需要部分退款，快手后台发起退款不能选择张数。需要自我游或景区先验证不可退数量后，再让客人在快手发起申请退款剩余数量，不能进行二次退款）
8、产品延期：需要在自我游系统和快手后台同时操作延期。
9、快手本地生活商家必须要在快手后台先认领门票POI，POI关联后添加适用人群的设置才能推送产品同步。
一、提供以下参数给自我游配置快手本地生活接口
1、自我游系统网址：
2、渠道接口备注名称：
3、快手账号ID：
4、商家ID：
备注：本地生活商家账号登录后台，点击右上角商家名称就可以看到快手账号id和商家id。
5、客服电话：
6、绑定接口的分销商id：
【分销商需要设置授信额度，接口支付方式：授信扣除】
二、授权自我游
自我游配置完接口后，商家自行到快手店铺后台去确认应用授权
三、产品POI关联
注意：快手本地生活商家必须要在快手后台先认领门票POI，POI关联后才能推送产品同步。
自我游后台【渠道门票对接管理】--【进入管理】，点击【POI关联】--手工绑定快手门店
已在快手绑定门店，自我游点击快手POI管理，可直接复制POIID填写
设置适用人群--poi产品推送
四、自我游后台发布产品
1、选择对应类目发布产品（目前支持类目：门票，套餐）
2、发布产品注意事项
3、短信 【预订成功短信&出票短信二选一】
按照实际情况设置，如果需要自我游发送短信的话：
①：产品没有对接第三方供应系统/自我游码库发码，可以用预订成功短信：
编辑好短信模板【二维码代码：$url$，数字码代码：$password$】
②：产品对接了第三方供应系统/自我游码库发码，可以用出票短信：
编辑好短信模板【二维码代码：$excode2$，数字码代码：$excode$】
4、订单自动完成：必须人工验证订单才能完成状态
5、门票类目应到未到处理：人工做退改处理（如果支持多次验证必选这项）
6、设置一人一码
注意：如果是一单一码，产品必须设置限购一张
7、供应商账号设置核销配置
是否可以验证：建议选择支持供应商验证（订单多次，不支持增值项目多次）
二维码内容：验证码转成二维码
支持验证内容：勾选实际支持进行核销验证方式
五、推送产品（产品授权--推送产品给快手）
1、【渠道门票对接管理】--【产品授权】
2、选择需要上架的产品--【授权】
3、授权后点击【信息设置】，完善信息后保存设置，点击同步产品。
注意：目前自我游是直接推送产品同步给快手
4、同步产品，审核通过后上架
六、下单测试【对接完成后必须按照以下情况分别下单进行测试】
①发码环节测试（测试发码数量是否与预定数量一致）
一次下单张数量，一次下多张数量
②取消环节测试
*整单取消，未核销情况下申请部分数量取消，部分数量核销后取消，另外未核销数量申请取消，
注意：目前只支持整单或者验证后剩余全部退（如果需要部分退款，快手后台发起退款不能选择张数。需要自我游或景区先验证不可退数量后，再让客人在快手发起申请退款剩余数量，不能进行二次退款。）
*取消申请审核中，对订单申请取消数量进行核销，
*取消申请审核中，对订单未申请取消数量进行核销
③核销环节测试
整单核销，分次进行核销
七、相关问题
Q1：同步产品报错：同步失败:商品创建失败, 图片头图不可为空
A1：【产品描述】没有上传图片或者上传的图片尺寸过小，需要删除后重新上传图片
Q2：快手日历票同步产品的时候提示报错：同步失败:模板不存在 三级类目id:70100004,商品类型:日历票
A2：日历票是有指定类目的，目前支持日历票的类目如下图，其他类目同步就会报错
Q3：同步产品提示：同步失败：可用时间格式不正确
A3：注意【信息设置】里面的时间格式：
Q4：同步产品报错：同步失败:创建/编辑商品失败，图文描述不支持富文本格式内容
A4：要检查推送的快手【信息设置】内，产品详情内容是不是出现<>等特殊符号
Q5：信息设置--商品类目没法选择
A5：检查快手后台是否正常授权