接口实现功能

产品同步

支持订单同步

支持退款同步

支持核销同步

****温馨提示**** :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。

客服电话：

客服服务开始时间：

客服服务结束时间：

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

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

二、授权自我游

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

三、产品POI关联

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

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

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

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

四、自我游后台发布产品

3.1 选择对应类目发布产品

目前支持类目：门票，套餐，抢购

3.2 发布产品注意事项

①设置产品有效期

②预订成功短信

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

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

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

门票类目：通知单选择在预订（支付）成功后自动锁定订单，无需生成通知单

出票：需要

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

对应接口：选择对应接口

供应商产品编码：绑定供应商系统产品编码（按实际情况设置）/码库编码

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

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

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

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

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

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

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

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

五、产品授权

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

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

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

对应接口点击产品授权

选择对应产品点击授权

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

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

快手POI类目查看方式：快手搜索POI名称，选择地点。名称左下角的是POI类目

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

②取消环节测试

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

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

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

③核销环节测试

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

七. 相关问题

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

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

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

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

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：同步失败:商品创建失败,图片头图不可为空

A6：产品详情上传的图片标志图格式需大于360*360像素

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

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

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

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

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

A9：

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

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