快速接入
对接流程
配送商入驻流程
1.申请接入

若配送商有合作需求,请先 【注册】 并按要求提交申请。美团运营人员会根据提供的配送商资料进行审核, 请耐心等待3-5个工作日,重新 【登录】 即可查看审核结果。若申请信息仍在审核中,申请信息不得修改。若审核驳回,您可根据驳回意见作修改,然后继续申请。若审批通过后,即配送商申请创建成功,即可作后续的开发联调动作。

2.获取秘钥

配送商申请通过后,您可在开发者管理模块申请开发者ID和秘钥。平台为每个配送商提供了两个开发者ID,一个正式,一个测试。配送商可通过测试的开发者ID先作开发联调,后续再用正式的开发者ID作线上接单。请谨慎保管开发者ID和秘钥,避免泄漏而造成不必要的损失。若无法获取,请联系美团运营人员。

3.接口开发和联调

请阅读 【开发文档】 ,按要求完成接口的开发。针对信息方向是青云聚信系统→配送商系统的接口,配送商需提前在开发者管理模块维护推送URL。

接口名称 方向 对接场景 对接建议
商家授权配送商 青云聚信系统→配送商系统 配送商提前提供授权页面url,当聚合平台门店上的商家要授权聚合平台可以给配送商发单时,通过该接口去配送商系统上作授权。 必接
商家授权配送商结果回调 配送商系统→青云聚信系统 配送商页面自行定义商家账号的登陆和鉴权方式,并引导商家根据青云聚信系统提供的青云门店选择绑定配送商侧对门店信息。配送商系统需记录商家的授权情况。在商家完成配送商侧的授权后,即通过该接口返回授权结果。青云聚信系统会存储返回的青云平台id+配送商门店id。授权完成,即代表后续美团系统可以在授权范围内,替商家作履约流程的操作对接。 必接
商家解除配送商授权 青云聚信系统→配送商系统 当商家需要取消对青云聚信系统和配送商系统的授权关系,则可在青云聚信系统发起解绑流程。 必接
配送商门店授权失效回调 配送商系统→青云聚信系统 配送商授权若有生效时间,则需失效时,通知青云,青云将引导商家重新授权。
若配送商系统的授权是长期有效,则可不对接该场景的接口
必接
门店信息查询 青云聚信系统→配送商系统 门店相关信息查询 必接
门店询价 青云聚信系统→配送商系统 询价,获取预估配送费、配送时间等信息。
与地址询价的区别是:询价时青云把门店信息告知配送商,由配送商通过门店id获取发货地址(发货地址在配送商系统维护),然后基于此预估配送费、配送时间等。
与地址询价二选一,建议地址询价
地址询价 青云聚信系统→配送商系统 询价,获取预估配送费、配送时间等信息。
与门店询价的区别是:询价时青云把发货地址的经纬度信息告知配送商,配送商通过经纬度计算发货地址,并基于此预估配送费、配送时间等。
与门店询价二选一,建议地址询价
门店发单 青云聚信系统→配送商系统 正式发单。
与地址发单的区别是:发单时青云把门店信息告知配送商,由配送商通过门店id获取发货地址(发货地址在配送商系统维护),然后基于此发单。
与地址发单二选一,建议地址发单。
在自动发单场景下,青云不询价直接发单
地址发单 青云聚信系统→配送商系统 正式发单。
与门店发单的区别是:发单时青云把发货地址的经纬度信息告知配送商,配送商通过经纬度计算发货地址,并基于此发单。
与门店发单二选一,建议地址发单。
在自动发单场景下,青云不询价直接发单
加小费 青云聚信系统→配送商系统 加小费 可选,推荐
取消订单 青云聚信系统→配送商系统 取消订单 必接
订单状态及骑手/司机变更回调 配送商系统→青云聚信系统 订单状态、骑手/司机信息发生变更时,告知青云聚信系统 必接
骑手/司机经纬度查询 青云聚信系统→配送商系统 查询骑手/司机位置 必接
配送详情查询 青云聚信系统→配送商系统 配送详情查询 必接
异常上报 配送商系统→青云聚信系统 配送过程中的异常上报 可选,推荐
批量门店授权接口 青云聚信系统→配送商系统 当商家要批量授权多个配送商门店时,通过该接口去配送商系统上作授权。 可选,推荐
批量门店绑定接口 青云聚信系统→配送商系统 当商家要批量绑定多个配送商门店时,通过该接口去配送商系统上作绑定;需要和门店批量授权接口配合使用 可选,推荐
修改订单 青云聚信系统→配送商系统 修改订单 必接
账户充值接口 青云聚信系统→配送商系统 商户通过青云对配送商门店进行充值 可选,推荐
账户余额查询接口 青云聚信系统→配送商系统 商户通过青云对配送商门店账户余额进行查询 可选,推荐
出餐接口 青云聚信系统→配送商系统 订单出餐完成或拣货完成时,青云将出餐完成或拣货完成状态告知配送商 可选,推荐

配送商完成接口开发后,可在开发联调模块,使用测试开发者信息做接口联调。开发联调模块的使用手册参考联调工具使用手册
验签工具是承运商和青云联调的第一步,青云调用承运商系统、承运商调用青云系统都涉及到sign的加签、验签,如果不通过,后续所有流程都将阻塞。
开发联调需要先在API名称里选择需要测试的接口,在API推送URL中会带出配送商在测试类型开发者上维护的推送URL链接。配送商可在请求参数中附上期望接收到的系统参数,最后点击提交。青云系统将会将请求参数的报文推送至带出的URL中。

开发联调 开发联调
4.正式上线

联调完成后,请联系美团运营人员进行上线申请。
上线申请通过,将需要灰度的青云门店id提供给美团运营人员,由美团运营人员为配送商配置灰度门店。
配送商工作人员在灰度门店测试通过后,联系美团运营人员进行功能验收。验收通过后,由美团运营人员操作,对所有商户全量。

5.功能变更

配送商各项功能上线后,后续如果需要进行功能变更,请先联系美团运营人员,沟通确认功能变更内容后,再推进开发上线。