与飞猪通过API连接

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

主要操作步骤：

1.在 BookingMeta 系统创建飞猪旅行代理商；

2.在淘宝服务市场订购 ISV 服务并完成店铺绑定；

3.为飞猪 API 设置报警邮箱；

4.在飞猪后台做好商品授权；

5.做好规格 SKU 的映射；

6.高级配置玩法；

7.FAQ；

一、在 BookingMeta 系统中创建飞猪旅行代理商

1.在 BookingMeta 系统创建代理商

        在【代理商管理】 -> 【代理商列表】 ->【新建代理商】中选【飞猪旅行】

提示：这里必须要选择飞猪旅行

输入代理商名称及结算币种：

注意：

• 代理商名称必须与飞猪的店铺名称一致，否则无法成功连接API。例如：飞猪店铺名称为“广州奇流旅游专营店”，则代理商名称也必须为“广州奇流旅游专营店”。
• 结算币种只支持人民币 CNY ，如为非中国大陆地区的商家可联系系统支持邮箱(support@bookingmeta.com )以帮助配置其他结算币种。

2.开通代理商的主账号，以便完成后面的授权认证

在代理商列表，可点击“开通主账号”

注意：请牢记此主账号及密码，例如：fliggy_bm_admin，后续会用于从飞猪跳转到BookingMeta的授权验证使用。

二、在淘宝服务市场订购ISV服务并完成店铺绑定

使用您在飞猪系统中店铺的主账号登录后，访问淘宝的服务市场，连接地址：奇流旅游

订购奇流旅游服务成功后，在飞猪后台已购买的服务中找到奇流旅游并点击使用，会跳转到BookingMeta系统的授权页面

注意：

在BookingMeta系统中可支持开通多家飞猪店铺并使用API对接，上图展示了所有已创建的飞猪代理商，如有多家，务必请选择飞猪对应已登录的店铺，否则会出现对接订单错误。

选择后，点击验证按钮

出现下图的登录验证

注意：

这里要使用在 BookingMeta 系统中已创建的飞猪代理商主账号及密码登录验证，不能使用登录BookingMeta 后台的账号。例如：在本章节开通代理商主账号示例中的 fliggy_bm_admin 账号及密码。

输入正确后，会显示授权成功，此步骤完成。

三、为飞猪API设置报警邮箱

经过上述操作步骤后，已完成飞猪的授权，但很多原因可能造成对接失败，可在 BookingMeta 系统中设置报警邮箱，当API对接失败后，系统会自动发送报警邮件。常见的对接失败情况如下：

• BookingMeta 系统中的商品不是出售中的
• BookingMeta 系统中的 SKU 处于备货中，无法销售
• 商品的 SKU 无库存或没有设置采购价格
• 下单时间不满足商品中设置的提前预订时间

在代理商管理中，找到对应的飞猪店铺，点击编辑按钮。如果飞猪已授权成功，可看到API Setting 的栏目，可添加报警邮箱，如下图：

四、在飞猪后台做好商品授权

1.新建资源方

• 资源方名称：奇流旅游
• 被授权方appkey：34049872
• 授权范围：交易权限包和商品授权包建议全部勾选

2.完成商品授权

您在飞猪店铺中会有很多的售卖商品，对于需要使用 BookingMeta 系统对接的商品则需要一个一个完成授权添加。

在 飞猪后台 的 特色服务->API资源方授权 -> 新增授权

 

 

在飞猪完成商品授权后，还需要完成商品 SKU 的映射，即在飞猪后台填写 BookingMeta 的 SKUID 。

五、做好规格 SKU 的映射

最后一步是需要将 BookingMeta 系统中的规格ID，即 SKUID 填写到飞猪的后台，这样当飞猪产生订单后，BookingMeta 系统就会获得下单、支付等消息的通知，同时可以在消息中自动获取到 SKUID ，从而将飞猪的订单自动的同步到 BookingMeta 系统中了。

 

首先，需要在 BookingMeta 系统中找到对应的 SKUID 或附加项ID，如下图：

注意：

• SKUID 是S开头的一串字符及数字，代表可售卖的最小单元，例如：成人、儿童、经济5座车、0.25毫米子弹等
• 附加项ID是A开通的一串字符及数字，代表可额外提供的服务，例如：儿童座椅、香蕉船、拖曳伞、深浅体验、超范围接送费等

找到BookingMeta的SKUID或附加项ID后可点击复制，并填写到飞猪后台对应的位置。以下是飞猪系统的后台截图，可参考。

注意：由于飞猪系统也在升级优化，可能出现界面显示的位置有差异，但基础映射的逻辑是相同的

几种典型品类的截图参考：

境外玩乐套餐

• 一般为日历库存
• 在套餐设置位置映射SKUID
• 如在飞猪有更新价格或库存，映射好的编码不会改变
• 延长库存日期编码不会改变

用车服务类

• 一般为日历库存
• 在套餐设置位置映射SKUID
• 如在飞猪有更新价格或库存，映射好的编码不会改变
• 延长库存日期要注意编码更新

日游类

• 一般为日历库存
• 在套餐设置位置映射SKUID
• 如在飞猪有更新价格或库存，映射好的编码不会改变
• 延长库存日期编码不会改变
• 如有成人儿童可使用英文逗号分隔SKUID，中间及前后不要有空格，例如：S037mw63d,S54m9r23y

电子票卡类

• 一般为日历库存或普通库存（开放日期）
• 在每一个票种中设置映射SKUID
• 如在飞猪有更新价格或库存，映射好的编码不会改变
• 延长库存日期要注意编码更新

六、高级配置玩法

6.1 高级映射说明：

在飞猪体系内会有很多高级运营的技巧，例如：可以组合多个商品一起售卖，或者区分成人儿童不同规格的价格，下表详细说明了组合映射的方法。

说明：

英文竖线“|”：表示乘的意思

英文逗号“,”：表示分隔成人与儿童

英文加号“+”：表示组合的意思

以上符号都必须为英文符号，如果输入错误会导致对接错误或失败。

最复杂的组合场景：新加坡环球影城家庭VIP套票（2大1小含快速券）

S0y860om5|2+S8yvvnzy2|2+Soyw77rkd|1+S0mznnpmz|1

S0y860om5为成人门票，S8yvvnzy2为成人快速券；Soyw77rkd为儿童门票，S0mznnpmz为儿童快速券

6.2 同步商品库存到飞猪店铺

当 BookingMeta 系统中的库存发生变化后，可通过API实时同步到飞猪系统。具体实现说明参考API对接库存同步高阶配置说明。

6.3 添加飞猪子账号授权，实现在 BookingMeta 中直接操作同意取消，并完成支付宝的退款。

1.用admin账号登录 BookingMeta 系统，进入代理商管理，找到飞猪店铺代理商，进入【编辑】页面

2.进⼊【API设置】⻚⾯，点击【新增⼦账号授权】跳转⻜猪授权⻚⾯，使⽤⻜猪⼦账号（该账号至少有退款权限及⾦额额度和调用第三方应用权限）登录并完成授权"bookingmeta"

 注意：1.⻜猪⼦账号后台权限说明如下：

2. 如没有使⽤⻜猪⼦账号登录或有错误，则会跳转系统授权⻚⾯提醒错误信息，反之会跳转代理商编 辑页面。

⼦账号授权失败⻚⾯如下：

⼦账号授权成功⻚⾯如下：

系统可以关联多个⻜猪⼦账号，同时只有⼀个⼦账号⽣效，如果想关闭系统同意取消申请功 能，操作⼦账号中的【关闭】即可。如果想切换其他⼦账号，操作⼦账号中的【开启】即可。

6.4 在飞猪后台对订单进行如下相关备注，可实现把订单信息解析同步到Booking Meta后台订单中。

说明：其中涉及到的符号均为英文符号。

七、FAQ

1. 飞猪API对接订单，在 BookingMeta 系统预定完成时如果不勾选分销侧通知对象，那飞猪客户端订单详情是否可收到voucher信息？