跳到主内容

与抖音来客进行分销API对接

  • 更新
本文将为您介绍抖音 API “预售券” 类型相关商品的对接，阅读全文大概需要 10 分钟。

引言：BookingMeta 目前仅支持抖音 API “预售券” 类型的对接，如果您希望将抖音作为您的分销商，请联系您的 BD 完成商务流程，Client Success 团队（support@bookingmeta.com）会在您完成商务流程后，协助开通 API 对接功能。

主要操作步骤及内容

1.前期准备工作；

2.在系统创建代理商；

3.BookingMeta技术配置及验收；

4.订单对接；

5.商品映射；

6.FAQ；

一、准备工作

1.主动向抖音侧 BD 提交 API 对接申请

请您主动联系抖音侧 BD 申请“抖音来客-预售券类” 商品订单 API 对接需求，并等待审核结果。
 

2.抖音侧 BD 将在审核完成后，创建飞书对接群

抖音审核同意您的 API 申请后，会创建飞书对接群，您以及我们 BookingMeta 技术负责人都会被邀请进群，在等待期间您可进行下方的第二步操作。
 

3.BookingMeta 技术进行验收相关工作对接

BookingMeta 技术对接工作人员将进行 API 相关配置并验收；如无异常，约 7个工作日可完成验收并上线。
 

二、在 BookingMeta 系统中创建代理商

1.创建代理商

待完成第一步，通过抖音的审核后，即可在 BookingMeta 系统【代理商管理】 -> 【代理商列表】 ->【新建代理商】中选择【抖音】，完成创建抖音代理商。

注意：
  • 请务必选择 【抖音】入口（参考下图），否则 API 无法实现对接
  • 代理商结算币种只支持人民币

创建代理商图1.png创建代理商图2.png创建代理商图3.png

2.将 BookingMeta 系统中代理商 ID 及抖音来客登录账号信息提供给 BookingMeta

创建好代理商后，请把以下内容通过邮件发送到 BookingMeta 的support@bookingmeta.com 邮箱，并抄送至 weiyuan.yang@bookingmeta.com ：
1）代理商 ID： （代理商ID信息）
2）抖音来客登录账号信息：（账号登录信息）
3）是否需要配置飞书群订单提醒：（是或否）
 
注意事项：
  • 账号信息说明：如果您是通过手机号注册抖音来客，则提供手机号，后续会涉及到接收并提供验证码；如果您是通过邮箱注册抖音来客，则提供注册登录账号及登录密码。
  • 如需配置飞书群，请提前自行下载并注册飞书。
  • 代理商 ID 查看位置参考下图：

查询代理商ID.png

三、BookingMeta 侧技术配置及验收

1.BookingMeta 将为您排期开通相关开放平台和申请应用，并进行后台技术配置验收工作。

如无异常情况，约在 7 个工作日左右完成。BookingMeta 侧 Client Success 人员会在系统专属服务群同步您配置完成消息，您可继续第四步操作，实现订单对接。

2.BookingMeta 支持配置飞书群订单提醒，群消息提醒类型如下三种：

  • 预售单商品校验失败提醒
飞书群校验失败图.png
  • 预售单预约提醒 (新订单&异常）
    • 新订单

新订单通知.png

    • 新订单存在异常

新订单异常通知.png

  • 预约单取消提醒

预约取消通知图.png

四、在抖音来客后台调整商品设置，实现订单对接

当 BookingMeta 侧Client Success人员告知您已经完成 API 的技术配置后，请到抖音来客后台【商品管理】，对商品进行如下相关设置，并提交审核，待抖音来客审核通过，即可实现该商品订单对接到 BookingMeta 系统中。具体操作说明如下：
商品管理1.png
  1. 在抖音来客后台【商品管理】，进入要对接订单的商品，点击【查看】->【编辑】->【编辑更多信息】
抖音来客商品编辑2.png
抖音来客商品编辑3.png
 
设置【接单规则】中【订单对接方式】为直连；【对接系统】下拉选择BookingMeta配置的系统（温馨提示：系统名称不一定带有 BookingMeta 字样，如对接多个系统则核实后选择，如只对接到 BookingMeta 系统则直接选择即可。）；【商品编码】填写 BookingMeta 系统中该 SKU 的规格ID（如 S7mx1nxk3）。
抖音来客商品编辑接单规则.png
 
  1. 点击【提交审核】
  1. 待抖音来客审核通过，该品产生预售订单，预售订单将第一时间对接到 BookingMeta 系统的【订单缓冲池】->【抖音酒旅 API】模块中。
         您可在BookingMeta 系统【订单缓冲池】->【抖音酒旅 API】页面查看对应的预售订单信息。
         温馨提示：如果您的菜单栏查看不到【抖音酒旅 API 】，请到系统的【账号管理】->【角色与权限】->找到对应的角
         色，点击【菜单管理】，勾选【订单缓冲池】板块的【抖音酒旅 API 】，刷新或重新登录 BookingMeta 系统即可。
订单缓冲池查单.png
注意事项：
  • 抖音来客后台预售订单号对应 BookingMeta 系统【订单缓冲池】->【抖音酒旅API】中预售订单号。
  • 抖音来客后台预约订单号为 BookingMeta 系统【全部订单】中对应订单的分销订单号。
    4.当预售订单被预约后，同时预约订单对接到 BookingMeta 系统中【订单管理】->【全部订单】中，如果该品在 BookingMeta 设置的是二次确认，则该预约订单状态为 “待确认” 。您在 BookingMeta 系统点击【查看预约详情】查询预售订单预约明细，亦可从预约详情点击【查看订单】进入对应的预约订单，进行查看和处理该笔订单。

查看预约单.png预约订单.png

查看预约2.png
  1. 订单处理说明
在 BookingMeta 系统，订单操作预定完成后，订单状态为 “待服务” ，订单状态同步到抖音来客为 “已预约” 。
 
  1. 订单对接异常说明
  如果订单对接异常，在 BookingMeta 系统【订单缓冲池】->【抖音酒旅 API 】，预售订单上会有详细的异常原因说明，具体情况如下：
  • 在抖音来客后台没有对商品设置 OTA【商品编码】
  • OTA【商品编码】设置错误 (格式错误或编码取值错误)
  • 设置的【商品编码】为 BookingMeta 中 "不可单独预定" 的附加项或规格
  • 设置的【商品编码】对应的规格在 BookingMeta 中没有库存、状态为已停用、备货中、已下架等不可售状态
  • 未知其他异常
  1). 如果属于 OTA【商品编码】异常（未设置/设置错误等），请及时到抖音来客后台【商品管理】重新设置【商品编码】并点击提交审核，新订单可正常对接。
  2). 对接失败的预售订单，可在 BookingMeta 系统->【订单缓冲池】->【抖音酒旅 API】，对预售订单进行重新导入，把正确的规格 ID 填写，实现该订单重新对接。

导入提示.png

添加规格ID.png添加规格ID2.png
 
3). 如果是库存不足或规格不可售，则可在 BookingMeta 系统编辑对应的商品规格，点击 “保存并发布” 后，新订单可正常对接；已经对接失败的预售订单，可在 BookingMeta 系统->【订单缓冲池】->【抖音酒旅 API 】，对预售订单进行【重试】实现再次对接。
 
  1. 历史预售单处理说明
如果您在抖音来客后台配置好商品订单的 API 对接，新的预售单可直接对接到 Bookingmeta 的【订单缓冲池】中，但抖音来客后台的历史预售单（对接API前抖音来客后台产生的预售未预约订单），客人操作预约时会预定失败，即 Bookingmeta 系统无法自动对接抖音来客后台历史预售单的预约。故避免丢单，您需要将抖音来客后台的历史【未预约】单手工导入到 Bookingmeta 系统中。导入之后，客人发起预约，Bookingmeta 可完成预约服务。具体操作如下：
  • 在抖音来客后台导出您要对接的历史【未预约单】
如导出商品名称为“测试勿购 上海博物馆”的历史未预约单。在抖音来客后台进入【订单管理】->【预约管理】->【未预约 】，输入查询商品名称，点击【查询】，并点击【导出数据】，并【下载】导出记录。
image.png下载导出数据.png
  • 将下载数据导入到 Bookingmeta 的【订单缓冲池】中
进入 Bookingmeta 系统【订单缓冲池】页面，点击【导入历史预售订单】，对接渠道选择对应的抖音店铺，点击上传文件，上传上一步下载的文件，并确定。则该批历史未预约的订单成功导入到 Bookingmeta 系统中。image2.png
  之后这些预售单，如果客人预约，会在系统生成有效预约单，后续处理参考第四步中的第四项说明。
 
注意事项：
  • 手工导入到【订单缓冲池】的预售单会显示对接失败，失败原因为：“未设置对接规格编码”。这是因为预售单生成时还没有进行API编码设置。对于手工导入的预售单，可忽略此提示说明。

image3.png

  • 如果预售订单已经在Bookingmeta的订单缓冲池内，则不会重复导入。
  • 未导入的历史预售订单，在抖音来客配置了API对接后，客户预约时订单会预约失败。
  • 导入的预售单【订单实收】金额为抖音来客后台商家实收金额（订单金额-平台优惠），无优惠明细。
      如：商品A，在抖音设置售价100元，设置商家优惠10元，客人下单使用抖音平台优惠20元和商家优惠10元，实际支付70元。则该笔预售单导入到 Bookingmeta 系统的【订单缓冲池】中，订单实收金额为80元。

五、商品映射说明

映射说明图新.png

六、FAQ

1.如果客人取消预约或订单，已对接订单怎么处理？
 答: 客人在抖音来客预售订单，申请取消分以下三种情况：
  • 客人在未预约前取消订单：订单未预约之前，客人可随时取消订单，无需您进行任何审核，取消后该预售单在 BookingMeta 系统中【订单缓冲池】状态为 “已取消” 。
  • 客人在预约后，待确认前取消预约：
     此时，客人申请取消预约，您抖音来客后台直接取消预约单，预售订单变为“未预约”。BookingMeta 系统中【订单缓冲池】状态为“待预约”，BookingMeta 系统对应的【全部订单】中该预约单会收到取消申请，为避免损失，需要您在 BookingMeta 系统对该笔预约订单操作同意取消。
image.png
  • 客人在预约成功后，BookingMeta 中预约单状态为 “待服务”时，申请取消预约
    预约成功后客人联系商家或平台发起取消申请，您在抖音来客后台收到消息提醒，需您在抖音来客后台点击【立即查看】处理申请（如同意/驳回）。如果同意，选择【仅取消预约】还是【取消并退款】；如超时未处理，抖音来客默认全额退款取消预售单。
image (1).png
当您处理抖音来客后台申请【同意】时，BookingMeta 系统对应的【全部订单】中该预约待服务订单也会收到取消申请，为避免损失，需要您在 BookingMeta 系统对该预约订单同意申请；如果您拒绝申请，则预约单将保持有效状态。

相关文章