与 Transferz 通过 VBK 连接

提示: 阅读本文章大概需要 10 分钟

主要操作步骤：

1.在 BookingMeta 中创建代理商；

2.设置车型匹配与用车规则；

3.高级功能介绍;

4.FAQ;

1.在 BookingMeta 中创建代理商

1.1 在【代理商管理】 -> 【代理商列表】 ->【新建代理商】中选择 【transferZ】进入，创建代理商，并保存。

注意：代理商结算币种最好设置为美元，如果有手工补单情况，便于与transferz平台订单收入币种一致。

1.2 创建好该代理商后，进入该代理商【API设置】页面，填写 authToken，进行【确定】完成授权（点击此处查看如何获取 authtoken）。

如何获取 transferz 网站的 authtoken 说明：

1. 登录 transferz 网站（https://rides.transferz.com）
2. 用鼠标右击页面，选择检查
    
3. 按照下图指引，value 即序号 5 处 是 authToken
4. 把 authToken 信息全部粘贴到 BookingMeta 系统【authToken】中，点击确认完成授权。

授权成功后系统会以第一次授权时间开始，每 30 分钟同步 transferz 新增的订单到 BookingMeta 系统中（历史订单不会同步）。在系统同步订单的时候，您可继续完成第 2 步骤的工作，即 设置车型匹配与用车规则。

注意：authToken 授权有有效期，如果授权过期，失效期间产生的新订单，再次授权成功后，系统会自动同步。

2.设置车型匹配与用车规则

2.1 在【用车管理】 -> 【车型匹配】中选择已创建好的 transferz 用车类代理商，点击进入到车型匹配页面。

列表中左侧显示的是 transferz 所有的车型，右侧是您映射到 BookingMeta 系统中对应的车型。点击【匹配 BM 车型】按钮后，可选择 BookingMeta 具体车型，并操作【确定】。

说明：BookingMeta 在交通接驳类商品管理中可选择设置具体的车型，如：舒适5座。这里会显示BookingMeta 所有的预设车型信息，车型匹配时可支持将不同车型在不同国家/地区映射到 transferz 的车型中，例如：您可将 BookingMeta 系统内舒适5座在泰国地区映射到 transferz 的舒适5座车型，同时可在日本地区映射到 transferz 的舒适 5 座车型。

匹配好车型映射后，点击【查看报价】按钮，可查询到您在 BookingMeta 系统内设置的商品信息，这里会按照您商品设置的城市自动展示商品信息。

2.2 由于系统同步匹配车型需要用车规则，所以需要对用车商品的套餐设置并绑定用车规则。

在【用车管理】 -> 【用车规则】中创建用车规则。如果 BookingMeta 系统内已经有用车规则，可不用再新增。直接对套餐进行绑定用车规则即可。

注意：这里的用车规则需要创建一个并绑定到商品-套餐中即可，实际在订单对接导入中并不起作用。只是将订单导入到 BookingMeta 系统中，报价是在transferz后台设置的，所以用车规则内的逻辑并不生效。

创建并绑定好用车规则后，回到车型匹配菜单，点击【查看报价】，可查看 SKU 的可用状态及规则设置。

注意：需确保您的 SKU 规格保持出售中的状态，设置好库存及价格，并且帮定了上一步已添加好的用车规则。原有商品如果绑定了用车规则，需要重新发布才可生效。

在车型匹配-查看报价中，需手工设置【是否可用】状态为【启用】。

此步骤很重要，通过 VBK 模式同步的订单，会根据 transferz 订单中的上车、下车地点自动匹配对应到 BookingMeta 系统中的 SKU 。

以上步骤均为基础的设置工作，虽然有些繁琐，但通常来讲只需设置一次。完成以上步骤后，transferz 订单就会自动同步到 BookingMeta 系统中了。

3.高级功能介绍

3.1异常订单的提醒

当订单自动导入时如 BookingMeta 系统发现异常情况，将停止导入该订单，且异常订单会显示在【订单缓冲池】-【用车VBK订单 】中。您可在【代理商管理】->【编辑】—>【合作信息】标签下，新增联系人并填写邮箱。系统会发送邮件提醒您有异常订单。同时如果 transferz 授权失效后，系统也会通过此邮箱发送邮件提醒，您可重新复制 authToken 到 BookingMeta 系统中，完成授权操作。

常见的异常原因及建议：

• 没有找到对应的 SKU

您未设置系统内与渠道的车型对应关系或订单上下车地点不在可用规格的接送范围内。可添加对应关系或者重新调整套餐接送范围 后，可点击重试按钮，系统可将订单导入到订单列表中。

• SKU:{BookingMeta 系统中的 SKU 编码}已下架或被禁用

您映射的车型所对应的 SKU 已经下架或被禁用了。可尝试将 SKU 所在的商品重新发布上架后，点击重试按钮，系统可将此渠道订单导入到订单列表中。

• SKU :{ BookingMeta 系统中的 SKU 编码}库存不足

此 SKU 的库存不足，建议您可增加库存数量后点击重试按钮，系统可将此渠道订单导入到订单列表中。

• SKU : {BookingMeta 系统中的 SKU 编码}不满足用车或预订规则

请检查此 SKU 所在商品设置的预订时间限制是否满足要求。修改并发布商品后，可点击重试按钮，系统可将此渠道订单导入到订单列表中。

• 未知设置的错误

遇到了未知的数据异常，可点击联系技术支持 support@bookingmeta.com ，我们将收到此异常订单的信息反馈，会从后台来帮助您定位问题并及时通知到您。

• 疑似重复订单

系统根据订单重复判断规则（详见：快速下单重复提醒）判断已存在相同订单，订单号：{ BookingMeta 系统中的订单号}，如您已手工录单可忽略并删除此异常订单；点击“忽略并导入”则系统会再次导入此订单。

• 订单状态变更提醒

此订单在 transferz VBK 后台的状态已变更为“已取消”，建议您在系统中手工操作取消此订单，订单号：{ BookingMeta 系统中的订单号}。处理完后，可点击删除按钮忽略掉此提醒。

 

3.2授权超时的提醒

如您在 BookingMeta 系统中授权已超时，建议您在代理商管理-合作信息标签下，新增联系人并填写邮箱。系统会发送邮件提醒您授权超时。

 

3.3订单自动确认的设置方法

您可找到车型匹配中设置的 SKU ，找到其所在的商品/套餐，设置为即时确认。点击保存并发布商品。

4.FAQ

1.授权超时后再次重新授权，订单会自动同步吗？

会的。您再次授权成功后，系统会自动将订单同步到 BookingMeta 系统中，通常最多1小时会完成历史订单的同步，但是系统在授权失效期间最多缓存 5000 条历史订单，所以请根据自身每小时产生订单量及时完成授权（例如每小时会有 200 个订单，最好在24小时内完成重新授权），防止历史订单丢失。

2.同步进来的订单为什么没能即时确认？
transferz 用车要求供应商提供的服务均为即时确认。订单进入到 BookingMeta 系统后，不会依赖 transferz的政策要求，而是遵循您在商品/套餐中的设置，如果设置为即时确认，则会自动变更为预定成功状态。如您设置的为二次确认，则需要人工手工点击完成预定。

3.为什么有的订单没导入到 BookingMeta 系统里？
可能授权超时了；请检查API设置标签栏中的授权状态。
可能出现异常订单了，可到 【订单缓冲池】-【用车VBK订单】查看原因及处理。

4.通过 VBK 模式导入的订单会和手工录单重复吗？
系统有校验，可在【系统设置】-【全局设置】-快速下单重复提醒中，开启重复录单提醒功能。如系统校验为重复订单，会进入到异常订单，可查看具体原因及处理。

5.订单的取消如何处理？
需要您手工的在 BookingMeta 系统中取消订单，目前还不支持取消状态的自动变更。但如 transferz 中的订单状态发生变更，我们会将此订单判定为异常订单，做提醒处理。

6.我能在 BookingMeta 系统中分配司导信息并自动同步到 transferz 系统中吗？
目前还不可以。您需要在 transferz 的 VBK 后台录入司导信息，并按 transferz 要求完成派单操作。