此文档详细为您介绍如何把 Get Your Guide 的订单通过API对接到 BookingMeta 系统,阅读全文大概需要 8 分钟。
引言:BookingMeta 系统已经与 GetYourGuide(以下简称 GYG )完成 API 对接, 如果您希望把 GYG 中预定订单对接到 BookingMeta 系统,并在系统内处理预定,请联系 BookingMeta 的专属 BD 完成商务流程,Client Success 团队(support@bookingmeta.com)会在您完成商务流程后,按照此说明文档协助您完成 API 对接。
主要操作步骤及内容
1. 前期准备;
2. 在 BookingMeta 系统创建代理商;
3. 在 BookingMeta 系统设置关联商品;
4. 在 GetYourGuide mapping商品编码;
5. FAQ;
一、前期准备
请确保您已完成与 GYG 的商务合作,如还未建立合作,请通过 GYG 供应商注册入口 提交申请建立合作。之后在 GYG 供应商后台完成以下准备工作:
- 商品创建及审核通过(参考 GYG《供应商商品管理规范》)
二、在 BookingMeta 系统创建 GYG 代理商
1. 完成准备工作后,使用有代理商管理权限的账号登录 BookingMeta 系统,通过【代理商管理】 -> 【代理商列表】 ->【新建代理商】中选择【Get Your Guide】,填写代理商名称及与 GYG 结算币种,并保存。
2. 点击 【API设置】,点击【开通】,完成 GYG 代理商创建。并继续第三步。
三、在 BookingMeta 系统设置关联商品
实现 API 对接,需要在 BookingMeta 系统及 GYG 后台分别进行商品关联设置。首先完成 BookingMeta 系统内商品 API 的设置。此步给您详细说明如何在 BookingMeta 系统进行商品关联设置。
1. 添加商品:
在 BookingMeta 系统【代理商管理】 -> 【代理商列表】,选择上一步创建的 GYG 代理商,点击【编辑】,进入【API设置】页面,点击【添加商品】,输入 GYG 中要对接的商品名称和 Reference code,并【确定】。
GYG中查看要对接的商品名称和Reference code,如图所示:
2. 创建 Option,并生成对接编码:
点击 【Option 详情】进入创建详情页面,点击【创建Option】,把 GYG 中要对接的商品 Option 信息创建添加,【确定】后,即完成了在 BookingMeta 系统商品关联的设置,操作步骤如下:
注意:
- 在此需把要对接的商品中全部 Option 及其下全部 Category 都创建添加完成,否则可能会导致订单对接失败。
- 其中每个 Category 对应的 Mapping SKU 填写 BookingMeta 中要对接商品的规格 ID,如 Syjl84q7k。
- 其中 Option ID、Option Cut-off Time 及 Price Category 一定与 GYG 中一致。GYG 中 Option 信息查看路径如图所示:
四、在 GetYourGuide mapping 商品编码
1. 登录到 GYG 后台商品管理,在商品详情页,点击 Connectivity Settings(连接设置)标签页,点击 Edit(编辑)按钮,进入配置模式。
2. 在 【Select your Reservation system】下拉菜单中选择 "BookingMeta" 作为集成的预订系统;【External product ID】填写第三步 BookingMeta 中生成的 Mapping Code。
至此,恭喜您已完成了 BookingMeta 与 GYG 的对接,已经设置对接的商品订单将会自动对接到 Booking Meta 系统中。后续有任何关于系统使用的疑问,请邮件至 support@bookingmetal.com 或通过系统服务对接群与我们取得联系。
五、FAQ
1. GYG 订单对接到 BookingMeta 系统后,客人在 GYG 发起修改订单,修改会同步到 BookingMeta 系统吗?
目前GYG并没有修改订单信息相关 API (只有追加规格或取消规格的 API) ,即:如果客人发起修改信息,不同步到 BookingMeta 系统,需手动在 BookingMeta 对该订单进行修改,使 GYG 与 Bookingmeta 内订单信息保持一致;
如果客人在 GYG 发起追加规格的修改,则 GYG 追加生成的新订单自动对接到您 Bookingmeta 系统订单列表,您在 Bookingmeta 内操作订单预定即可,同时原(老)订单取消申请同步到 BookingMeta 系统原订单的申请列表中,您处理【同意】取消,从而完成订单追加规格业务场景的处理。
2. GYG 订单对接到 BookingMeta 系统后,客人在 GYG 发起取消,会同步到 BookingMeta 吗?
客人在 GYG 申请取消订单,订单以 GYG 设置的退改规则进行扣款取消订单,并同步取消申请到 BookingMeta 系统中,建议在 BookingMeta 也同意取消,完成 BookingMeta系统内订单取消,实现与 GYG 取消状态一致。
2. BookingMeta 系统内更新规格库存,如何同步到 GYG 中?
目前 GYG 接通 API 对接后,客人在 GYG 下单过程中,GYG 会调用 BookingMeta 系统内该品(或该规格)设置的库存。