自我游发表于：2023年04月13日21:06:18更新于：2024年07月26日16:39:07
产品同步
支持订单同步
支持退款同步
支持核销同步
****温馨提示****:API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
2.已有自我游SaaS系统运营商账户。
1、10分钟不出票快手就自动退款给客人，*快手不会把退款状态传给自我游，订单状态需商家到快手后台核实。
3、只支持自我游门票、套餐、抢购类目产品对接
4、只支持一人一码产品对接，一码多验需要对接的建议限购一份。当订单一单多套，只发一个码的情况，快手会自动退款，或造成核销/退款不同步的情况！！！！
5、订单退款：需要客人在快手端发起退款请求，收到退款申请后必须在72小时内处理退款，如无按时处理订单审核，快手会自动强制退款给客人。（快手会监控退款时长超过3小时的订单，因为会对用户体验有影响，快手后期会对退款时效慢的商家做处罚）
6、过期退款：订单超过有效期后，快手会自动发起退款请求，收到退款申请后必须在72小时内处理退款，如无按时处理订单审核，快手会自动强制退款给客人。
7、撤回核销：验证后一个小时内，支持在自我游后台"渠道门票对接管理"页面找到对应订单撤回核销操作。
8、产品延期：需要在自我游系统和快手后台同时操作延期。
9、快手本地生活商家必须要在快手后台先认领门票POI，POI关联后才能推送产品同步。
10、请在有效期内及时核销订单，订单有效期过期无法同步核销。如：有效期至6月16日，过期后6月17日核销则无法同步。
自我游系统网址：
渠道接口备注名称：
快手账号ID：
商家ID：
绑定接口的分销商id：【分销商需要设置授信额度，接口支付方式：授信扣除】
以上参数提供给公众号【自我游运营中心】备份配置接口。
注意：快手本地生活商家必须要在快手后台先认领门票POI，POI关联后才能推送产品同步。
到自我游渠道门票对接管理进入管理，点击POI关联。
搜索产品对应的自我游景点ID（POI管理只会显示产品管理中已有绑定的景点）点击手工绑定门店，填写快手POIID（注意：快手poiid为纯数字）
已在快手绑定门店，自我游点击快手POI管理，可直接复制POIID填写
目前支持类目：门票，套餐，抢购
①设置产品有效期
②预订成功短信
按照实际情况设置，如需发送短信：编辑好短信模板【二维码代码：$url$，数字码代码：$password$】
③产品限购设置【限购条件需要跟快手后台限购条件保持一致】
④对接供应商接口/绑定码库出票
门票类目：通知单选择在预订（支付）成功后自动锁定订单，无需生成通知单
出票：需要
出票短信：按实际需求设置
对应接口：选择对应接口
供应商产品编码：绑定供应商系统产品编码（按实际情况设置）/码库编码
⑤订单自动完成：必须人工验证订单才能完成状态
⑥门票类目应到未到处理：人工做退改处理（如果支持多次验证必选这项）
⑦设置一人一码，发码数量选择包含人数发码
⑧设置图片头图：图片格式需大于360*360，并点击标志图
是否可以验证：建议选择支持供应商验证（订单多次，不支持增值项目多次）
二维码内容：验证码转成二维码
支持验证内容：勾选实际支持进行核销验证方式
①无需在快手后台手动创建产品，自我游产品直接推送产品同步到快手后台；②快手后台已创建产品，在快手后台绑定自我游产品编码
第一种：自我游产品同步到快手
注意：①快手产品编码为空不填，同步成功后自动会绑定快手编码。②快手商品类目按照实际快手POI类型选择。
同步产品后审核状态显示【待审核】。当审核通过，手工点击上架同步，显示审核通过，快手后台产品即可下单。
第二种：快手后台已创建产品，在快手后台绑定自我游产品编码
快手后台发布产品，填写自我游编码。
格式按照：自我游产品id_分销商id（注意：分销商编号为步骤一中配置快手接口的分销商编号）
选择服务商名称：自我游门票酒旅
商家系统sku编码格式：产品id_分销商id_产品id_分销商id
验证后一个小时内撤回核销操作
点击"券码详情”跳转到券码状态及"撤销核销"。
六、下单测试【对接完成后必须按照以下情况分别下单进行测试】
①发码环节测试（测试发码数量是否与预定数量一致）
一次下单张数量，一次下多张数量
②取消环节测试
整单取消，未核销情况下申请部分数量取消，部分数量核销后取消，另外未核销数量申请取消，
取消申请审核中，对订单申请取消数量进行核销，
取消申请审核中，对订单未申请取消数量进行核销
③核销环节测试
整单核销，分次进行核销注意：请在有效期内及时核销订单，订单有效期过期无法同步核销。如：有效期至6月16日，过期后6月17日核销则无法同步。
Q1：同步产品报错同步失败：1
A1：检查产品是否有产品库存，并点击“信息设置”，检查快手商品类目是否对应POI类目选择
Q2：客人成功下单后自我游订单管理没有生成订单，快手10分钟后自动退款
A2：点击渠道门票对接管理，进入日志管理。点击对应快手订单号，可查看报错原因
Q3：同步失败:团购价应小于9999999.99元!A3：
②检查自我游后台，最大可预订天数，建议设置0。
③检查自我游后台，价格库存：是否有设置开始销售日期--游玩结束日期的价格库存。
Q6：同步失败:商品创建失败,图片头图不可为空
Q7：快手产品同步失败:该商户商品列表中有不唯一的商品
A7：因为快手不能重复创建相同产品编码，如果快手后台出现了2个产品信息，要删掉其中一个。
Q8：接口日志报错：预定数量跟码数量不一致，请检查是否一人一码产品。
A8：对接快手产品必须设置一人一码！！不设置一人一码出票快手会发码失败，就算订单发码成功了，也还会导致客人使用后核销状态无法同步到快手，相当于客人使用后还可以发起退款申请，过期还会自动退款。
Q9：快手团购产品是从自我游推送过去的，但是产生订单没有到自我游系统并且不是自我游发码，变成了快手发码。
A9：
1、修改产品如果保存操作太快右侧的诊断还没完成，保存的时候会有几率保存信息不成功