跳到主内容

携手Klook拓展全球商机：供应 API 对接指南

  • 更新
提示: 阅读本文章大概需要3分钟
引言：Booking Meta 支持客路(KLook) 的 API 对接，如果您希望将客路 (KLook) 作为您的供应商，把Booking Meta 系统中订单通过API对接到客路 (KLook) 后台实现自动采购及出票，请联系 Booking Meta 的 Client Success 团队（support@bookingmeta.com），并参考此文档协助开通 API 对接功能。
注意：该API接口可能涉及额外费用，仅专业及以上的版本支持此功能，请先与您的专属BD确认是否支持。
 

主要操作步骤：

1.前期准备；

2.在 Booking Meta 系统创建 Klook 供应商；

3.提供相关对接信息给 Booking Meta 侧；

4. Booking Meta 技术侧进行API配置；

5.在 Booking Meta 系统完成商品映射实现订单对接；

6.FAQ；

一、前期准备

1.请联系客路（ Klook ）业务人员申请API对接

       如果您需要进行客路（ Klook ）供应API对接，请先联系客路（ Klook ）业务人员，进行商务沟通，申请API对接，并等待客路（ Klook ）反馈结果。

2.创建三方技术沟通群

      客路（ Klook ）给出结果后，请创建一个技术沟通群（微信、企业微信、WhatsApp 、Line 等群均可），并邀请 Klook 及 Bookingmeta 的技术入群。

3.向 KLook 提供系统IP地址并向其获取 Client ID 与 Client Secret 

      您向 Klook 发送邮件获取 Client ID 及 Client Secret,并告知 KLook 我们 Bookingmeta 系统IP地址为 

112.124.44.197
8.210.145.231
49.7.66.2
49.7.66.3

二、在 Booking Meta 系统内创建KLook供应商

       在 Booking Meta 系统创建 KLook 供应商，路径：【供应商管理】->【供应商列表】，点击右上角【新增供应商】，具体步骤参考供应商创建详情 – BookingMeta的帮助中心。

三、提供相关配置信息给 Booking Meta 侧

       完成前两步后，把以下信息邮件到 Booking Meta 的 support@bookingmeta.com 邮箱并抄送至 weiyuan.yang@bookingmeta.com 邮箱。

  • Booking Meta 系统内 KLook 供应商ID
  • Client ID与Client Secret
  • 订单对接到 KLook ，订单联系人信息是否写死，如需写死，则提供联系人字段名称及对应赋值信息。此说明如下图所示：

微信图片_20250224180749.jpg

四、Booking Meta 技术人员进行API配置

       您完成以上邮件发送后，可在系统专属服务群内告知我们Client Success 团队，我们 Bookingmeta 内部安排技术人员进行API配置，一般在3-7工作日内完成，且会在系统专属服务群内同步您结果。

五、在 Booking Meta 系统 完成商品映射实现订单对接

1.获取与选择 Klook 资源

        技术配置完成后，您可在 Booking Meta 系统【供应商管理】—>【供应商API配置】页面直接查看搜索客路( KLook )所提供的 Activity(活动)列表。

微信图片_20250224180908.jpg

在如图页面搜索 Activity ID，即可查询活动信息并获取到 Mapping ID。

微信图片_20250224181817.jpg

2.智能映射商品，构建您的产品库

      在 Booking Meta 系统内创建要销售的商品，创建步骤参考此步骤，并把上步获取的 Mapping ID 填写到【供应商商品SKUID】中，并选择【自动向供应商下单】，保存并发布商品。

编码Mapping新.png

至此，意味着：​ 当您 Bookingmeta 系统有新订单，BookingMeta 将自动向Klook采购并自动同步 KLook 出票结果，无需您任何手动操作，营收自动生成。

3.【高阶玩法】自由组合，打造独家套餐

您不仅可以销售 Klook 的单个商品，更能发挥自家运营策略，将多个商品或规格组合成独具竞争力的“专属套餐”，满足客户多样化需求，提升客单价，编码 Mapping 规则如下：

温馨提示：确保所有的分隔符（| 和 +）都是英⽂半角符号。

使用场景 系统商品示例 对应KLook商品 在Booking Meta 编码填写示例 说明
系统单个SKU对应 客路(KLOOK) 单个SKU 惊叹号豪华巨型双 游海上豪华⾳乐帆 船派对 成⼈  惊叹号豪华巨型双体帆船 皇帝岛⼀⽇游 
海上豪华⾳乐帆船派对 成⼈ 		80041202-8004120203 80041202-8004120203为客路(KLOOK)系统 成⼈的SKUID
系统单个SKU对应（KLOOK) 单个SKU，但是多数量 惊叹号豪华巨型双 游海上豪华⾳乐帆 船派对 情侣票 惊叹号豪华巨型双体帆船 皇帝岛⼀⽇游 
海上豪华⾳乐帆船派对 成⼈×2 		80041202-8004120203|2 80041202-8004120203为客路(KLOOK)系统成⼈的 SKUID
在系统上将客路(KLOOK)⼀件商品的不同规格打包销售或将(KLOOK)不同商品打包销售  东京迪⼠尼1⽇护照 家庭票（两⼤⼀⼩） 东京迪⼠尼1⽇护照成⼈票 
东京迪⼠尼1⽇护照⼉童票 		80041201-8004120101|2+ 80041201-8004120102|1
或者
80041201-8004120101|2+ 80041201-8004120102

80041201-8004120101为客路 ( KLOOK )东京迪⼠尼1⽇护照成⼈票

80041201-8004120102为客路 (KLOOK)东京迪⼠尼1⽇护照⼉童票

在系统上将客路(KLOOK)⼀件商品的不同规格打包销售或

将客路(KLOOK) 的不同商品打包销售

 ⼤阪环球影城⻔票 +快速券家庭套餐 （2⼤1⼩） ⼤阪环球影城⻔票成⼈票 
⼤阪环球影城快速券成⼈票 
⼤阪环球影城⻔票⼉童票
⼤阪环球影城快速券⼉童票 		80041201-8004120101|2+
80041201-8004120102|2+ 80041902-8004190201|1+ 80041902-8004190202|1 

80041201-8004120101⻔票成⼈票 80041201-8004120102快速成⼈票

80041902-8004190201⻔票⼉童票 80041902-8004190202快速⼉童票

4. 开启 Klook 价库变更自动同步，保障您的价格与库存精准

当Klook的库存紧张或价格变动时，您无需熬夜手动调整，只需在后台开启“订阅配置”设置一次，系统会为您自动完成价格库存同步，避免因价格库存不准而产生超售或直接损失。配置路径如下：

进入 【供应商管理】 ->点击【Klook API v3】-> 【Klook商品订阅配置】，输入已完成mapping klook 商品的系统 SKU ID（如：Soyw71ejk），并点击【检查Mapping状态】

KLook价库同步1.png

开启订阅【价格库存变更】事件，并开启自动执行，点击订阅完成配置。

KLook价库同步2.PNG

六、FAQ

  1. 为什么系统内 映射 KLook 的规格，价格库存与 KLook 后台不一样？

    1.1 开启【价格库存变更】事件后，系统会根据一定计算逻辑自动获取 KlooK 最新的价格与库存数据和 Bookingmeta 现有价格库存数据进行对比并更新，故与 KLook 的同步会有一定时间的缓冲。

    1.2 当KLook 对应资源库存余量<=20时，系统自动触发同步事件，故如果变化后库存余量>20,则保持原数据等待下轮更新。

  2.  为什么订阅了【价格库存变更】，系统内对应规格的价格和库存没有自动更新？

    需在订阅【价格库存变更】时，同时开启自动执行，系统在完成数据对比后才自动更新商品规格中价格库存数据。如果未开启自动执行，则需要人工操作 同步事件，之后系统数据才会更新。

相关文章