调用流程

合作方调用美团配送技术服务合作中心API，需要按照以下步骤：填充参数 > 生成签名 > 拼装HTTP请求 > 发起HTTP请求> 得到HTTP响应 > 解释json结果

流量控制

为保证系统稳定，针对每个接口都做了流量控制，如果接口请求的QPS大于设置的阈值，会返回 {"code":11,"message":"接口流控"}，如果遇到流量控制，建议三次重试，每次间隔10秒。如需详细了解，联系美团技术。

注意：美团配送API（含联调测试API）不支持压测场景，禁止合作方压测场景直接调用美团配送API。

请求规则

返回值规则

{
	"code": 状态代码,
	"message": 描述信息,
	"data": 返回数据信息
}

详细状态码定义请参照 请求返回状态码定义

美团配送技术服务合作中心API请求参数分为两种。访问API接口时需要同时提供两种参数。

系统参数：必传，包含appkey，签名，时间戳，接口版本信息

应用参数：请参照具体接口的参数定义 API列表

系统参数介绍

业务参数介绍

具体请参照 API列表各接口的参数定义。

签名算法

假设请求参数如下

secret: test

系统参数：

应用参数：

加密前的字符串为

testappkeytestbooleantruedouble123.123number123string测试timestamp1477395862version1.0

sha1计算所得sign为

8943ba698f4b009f80dc2fd69ff9b313381263bd

以java举例，签名算法代码如下

为提升对接效率，可以参考如下demo:

合作方将订单发送给美团配送平台。

此接口为已废弃的发单模式，未来将不再支持。

推荐未接入的合作方使用 订单创建（门店方式）接口。

已接入的合作方请逐步迁移到 订单创建（门店方式），迁移步骤详见 订单创建（门店方式）接口迁移步骤。

方法名：order/create

返回信息：

成功返回{"code":0, data: {"mt_peisong_id": 美团配送内部订单id, "delivery_id": 配送活动标识, "order_id": 外部订单id}}
失败返回{"code":错误码, "message": 错误描述}

合作方根据已录入的门店信息 将订单发送给美团配送平台。

本接口暂不支持测试门店（test_0001）调试使用余额支付的订单，账期支付与余额支付的发单流程无差异，使用账期支付方式发单联调完成后即可上线。

流量控制

同一AppKey每秒超过40次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

方法名：order/createByShop

{
	"business": "peisong-qrfetch",
	"content": "1623988921138003398"
}

{
"goods":[
    {
      "goodCount": 1,
      "goodName": "货品名称",
      "goodPrice": 9.99,
			"goodUnit": "个",
			"goodUnitCode":"10008"
    }
  ]
}

返回信息：

成功返回

{
	"code":0,
	"data": data信息
}

data 格式如下：

失败返回

{
	"code":错误码,
	"message": 错误描述
}
							

根据合作方的送件地址，自动选择合适的中间仓库作为线下货物的交接地点，并完成末端配送。

方法名：order/createByCoordinates

{
  "goods":[
    {
      "goodCount": 1,
      "goodName": "货品名称",
      "goodPrice": 9.99,
			"goodUnit": "个",
			"goodUnitCode":"10008"
    }
  ]
}

返回信息：

成功返回

{
	"code":0,
	"data": data信息
}

data 格式如下：

失败返回

{
	"code":错误码,
	"message": 错误描述
}

订单在未完成状态下，合作方可以取消订单。若订单支付方式为余额，则余额会原返至付款账户，优惠券会按照相应规则进行原返。

方法名：order/delete

返回信息：

成功返回

{
	"code":0,
	"data": {
		"mt_peisong_id": 美团配送内部订单id,
		"delivery_id": 配送活动标识,
		"order_id": 外部订单id
	}
}

失败返回

{
	"code":错误码,
	"message": 错误描述
}

注：如果订单已配送完成，则返回错误

查询订单状态及对应的骑手信息（仅支持90天内产生的订单）

方法名：order/status/query

流量控制

同一AppKey每秒超过10次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

返回信息：

成功返回

{
	"code":0,
	"data": 订单状态信息
}

data 格式如下：

返回信息：

失败返回

{
	"code":错误码,
	"message": 错误描述
}

每次订单状态发生变化时，会对合作方提供的回调url进行回调。

注：回调url必须使用80或8080端口

签名算法

跟配送平台签名算法一致。使用配送平台的appkey跟secret做签名计算。

成功与重试

回调接口说明

每次配送员上报订单异常（如商家未营业、顾客留错电话等等）时，会对合作方提供的异常回调url进行回调。

注：回调url必须使用80或8080端口

签名算法

跟配送平台签名算法一致。使用配送平台的appkey跟secret做签名计算。

成功与重试

回调接口说明

接口功能说明

为了将合作方端的顾客对骑手的评价及时反馈给美团，提高美团侧的配送质量，美团配送技术服务合作中心提供了对骑手的评价接口。合作方可以将顾客对骑手的评价信息通过此接口反馈给美团，同时需要注意以下几点：

1. 因各合作方的评分规则和量级的差异化，目前此接口传入的评分不作为骑手的考量参考（评分字段作为预留），仅评价信息会作为对骑手的反馈信息；

2. 仅接受已完成订单的评价， 未完成及删除的订单不接受评价；

3. 每笔订单只可进行一次评价，不允许重复评价；

接口说明

方法名：order/evaluate

请求方式：post

请求格式：application/x-www-form-urlencoded

请求参数：key = value形式

流量控制

同一AppKey每秒超过10次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

返回信息

失败返回

{
	"code":错误码,
	"message": 错误描述
}

成功返回

{
	"code":0,
	"data": 订单状态信息
}

data 格式如下：

根据合作方提供的模拟发单参数，确定美团是否可配送。主要校验项：门店是否存在、门店配送范围、门店营业时间、门店支持的服务包（目前只支持基础能力校验，暂不支持门店预约相关能力校验）。建议使用预发单接口，配送能力校验接口不再维护。

方法名：order/check

流量控制

同一AppKey每秒超过30次访问将被限流，返回{"code":11,"message":"接口流控"}。如需要高频访问，可以通过【查询门店配送范围】接口将配送范围缓存到本地，然后利用缓存的配送范围进行配送能力校验。

返回信息

成功返回

{
	"code":0,
	"message": "校验通过",
	"data": ""
}

失败返回

{
	"code": 错误码,
	"message": "错误描述"
}

接口功能说明

通过订单 id 获取当前订单下骑手的实时位置信息，需要注意以下几点：

1. 骑手位置的更新频率为 30s；

2. 接口返回的骑手坐标为火星坐标（高德地图和腾讯地图均采用火星坐标），而非百度坐标；

3. 接口返回的坐标量级为真实坐标的基础上乘以 10 的 6 次方的整数，例如：骑手真实坐标为（116.255596, 40.029185），则接口返回结果为（116255596, 40029185）；

4. 订单状态只有为“已接单”、“已取货”和“已送达”时，才会返回骑手位置信息，接口返回结果与订单状态的对应关系如下：

接口说明

方法名：order/rider/location

请求方式：post

请求格式：application/x-www-form-urlencoded

请求参数：key = value 形式

流量控制

同一AppKey每秒超过40次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

返回信息：

成功返回：

{
	"code": 0,
	"data": {
		"lat": 40029185, //纬度
		"lng": 116255596 //经度
	}
}

失败返回

{
	"code": 错误码,
	"message": "错误描述"
}

增加小费接口，目前只适用于4031服务包；根据订单支付方式进行扣款，若是支付方式为余额且余额不足时，增加小费失败。

方法名：order/addTip

流量控制

同一AppKey每秒超过40次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

返回信息：

成功返回{"code":0, "message": "成功"}

失败返回{"code":错误码, "message": 错误描述}

接口功能说明

根据配送服务代码、取货门店id获取该门店支持的配送范围。

接口说明

方法名：shop/area/query

请求方式：post

请求格式：application/x-www-form-urlencoded

请求参数：key = value 形式

流量控制

同一AppKey每秒超过2次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

返回信息：

失败返回{"code":错误码, "message": 错误描述}

成功返回{"code":0, data: 门店范围信息}

data 格式如下：

每次美团运营新增、修改配送范围时，会对合作方提供的配送范围变更回调url进行回调。

注：回调url必须使用80或8080端口

签名算法

跟配送平台签名算法一致。使用配送平台的appkey跟secret做签名计算。

成功与重试

回调根据http响应码为200且返回{"code":0} 判断为成功，否则为失败。

若回调失败，会在之后每小时重试一次，直到当天结束。

回调接口说明

请求方式：post

请求格式：application/x-www-form-urlencoded

配送风险等级变更时，会对合作方提供的URL进行回调。（配送风险等级指的是受不可抗力如天气、交通管制等因素导致的配送失败可能性。配送风险等级0为正常，1-4即为出现风险或无法完成配送）

注：回调url必须使用80或8080端口

签名算法

跟配送平台签名算法一致。使用配送平台的appkey跟secret做签名计算。

成功与重试

回调根据http响应码为200且返回{"code":0} 判断为成功，否则为失败。

若回调失败，会在之后每小时重试一次，直到当天结束。

回调接口说明

请求方式：post

请求格式：application/x-www-form-urlencoded

合作方提交门店信息（注意测试推单仍然用系统默认test_0001门店）

流量控制

同一AppKey每秒超过10次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

方法名：shop/create

返回信息：

成功返回{"code":0, "data": {"shop_id": test, "status": 0}}

失败返回{"code":错误码, "message": 错误描述}

合作方提交门店信息（注意测试推单仍然用系统默认test_0001门店）；门店信息不能同时为空，则返回报错；若参数和原门店数据一致，则返回报错；若存在门店修改未审核任务时，则返回报错。

流量控制

同一AppKey每秒超过15次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

方法名：shop/update

返回信息：

成功返回{"code":0, "data": {"shop_id": test, "status": 0}}

失败返回{"code":错误码, "message": 错误描述}

查询门店基本信息

方法名：shop/query

流量控制

同一AppKey每秒超过30次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

返回信息：

成功返回{"code":0, data: 门店信息}

data 格式如下：

失败返回{"code":错误码, "message": 错误描述}

门店审核驳回、审核通过、门店信息录入完毕、门店首次设置营业、以及修改门店信息时，会对合作方提供的回调url进行回调。

注：回调url必须使用80或8080端口

六种状态：10-创建审核驳回、20-创建审核通过、30-创建成功、40-上线可发单、50-修改审核驳回、60-修改审核通过

签名算法

跟配送平台签名算法一致。使用配送平台的appkey跟secret做签名计算。

成功与重试

回调根据http响应码为200且返回{"code":0} 判断为成功，否则为失败

若第一次回调失败，会在10分钟内重试5次，且每次重试时间间隔逐步延长

若5次重试全部失败，会在之后每小时重试一次，直到当天结束。

回调接口说明

请求方式：post

请求格式：application/x-www-form-urlencoded

配送员上下班打卡时，会对合作方提供的回调url进行回调。

注：回调url必须使用80或8080端口

签名算法

跟配送平台签名算法一致。使用配送平台的appkey跟secret做签名计算。

成功与重试

回调根据http响应码为200且返回{"code":0} 判断为成功，否则为失败

若第一次回调失败，会在 10 分钟内重试 5 次，且每次重试时间间隔逐步延长

回调接口说明

请求方式：post

请求格式：application/x-www-form-urlencoded

客户门店使用自有或三方取餐柜时，可以通过当前接口下发取餐码至骑手，支持骑手通过取餐柜完成取餐；若是骑手已完成取餐，则接口同样返回成功。

方法名：mealCode/saveMealCodeByPkgId

{
	"type": 0,
	"cabinetNum": "xxxxxx",
	"cabinetDoor": "xxxxx,xxxxx",
	"cabinetCode": "xxxxxx"
}

返回信息：

成功返回

{
	"code":0
}

失败返回

{
	"code":错误码,
	"message": 错误描述
}
								

根据合作方提供的模拟发单参数，确定美团是否可配送，并且实现发单信息预览，适用于门店方式发单预览。

流量控制

同一AppKey每秒超过80次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

方法名：order/preCreateByShop

{
	"goods":[
			{
				"goodCount": 1,
				"goodName": "货品名称",
				"goodPrice": 9.99,
				"goodUnit": "个",
				"goodUnitCode":"10008"
			}
		]
	}

返回信息：

成功返回

{
		"code":0,
		"data": data信息
	}

data 格式如下：

失败返回

{
		"code":错误码,
		"message": 错误描述
	}
								

获取配送码适用于商家选择使用骑手扫码配送的场景。通过当前接口获取配送码后，需要门店以二维码的形式将配送码打印在门店取餐小票上，并且在订单创建时将配送码传输至美配侧，以便骑手到门店取餐时可直接扫码取餐、配送；使用扫码配送模式时，订单状态回调时，“已接单”状态不再进行回调。

流量控制

同一AppKey每秒超过50次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

方法名：order/createDeliveryCode

返回信息：

成功返回

{
		"code":0,
		"data": {"business":"peisong-qrfetch","content":"1623988992138003281"}
	}

data 格式如下：

失败返回

{
		"code":错误码,
		"message": 错误描述
	}
								

接口功能说明

1、此接口可获取一个订单的骑手位置H5链接，可支持内嵌或发送给用户（内嵌时无法保证界面的兼容性，如发现兼容性问题可使用获取骑手位置接口自行开发轨迹H5）;

2、此接口针对不同服务包会返回不同H5链接；

3、订单取消后，H5页面不会产生骑手位置信息；

4、骑手已接单至已送达时，都会产生骑手位置；

5、订单完成后8-24小时，骑手位置则不展示（美配会根据流量进行时段控制）。

流量控制

同一AppKey每秒超过10次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

方法名：/api/order/rider/location/h5url

请求方式：post

请求格式：application/x-www-form-urlencoded

请求参数：key = value形式

返回信息：

成功返回

{
		"code":0,
		"message": "成功",
		"data": data信息
	}

data 格式如下：

失败返回

{
		"code":错误码,
		"message": 错误描述
	}
								

当订单使用取件码或收货码服务时，在取件码或收货码生成或变更时，会对客户提供的收货码、取货码回调url进行回调。

注：回调url必须使用80或8080端口

签名算法

跟配送平台签名算法一致。使用配送平台的appkey跟secret做签名计算。

成功与重试

回调根据http响应码为200且返回{"code":0} 判断为成功，否则为失败

若第一次回调失败，会在10分钟内重试5次，且每次重试时间间隔逐步延长

若5次重试全部失败，会在之后每小时重试一次，直到当天结束。

回调接口说明

请求方式：post

请求格式：application/x-www-form-urlencoded

接口描述

商家图片上传。

使用场景

商家可根据该接口用于找店引导图片上传，以便用于「门店创建、门店修改」接口中的门店图片信息参数中，商家上传门店找店引导图片后，骑手可以更快的找到取货门店。

注：图片后缀支持后缀名，如 「jpg、jpeg、png、bmp」，图片不得大于 5M。

流量控制

同一客户每秒超过10次访问将被限流，返回{"code":11,"message":"接口流控"}。可以通过降低查询频次解决。

请求路径

file/image/upload

请求参数

返回信息

成功返回{"code":0, "message": "成功"}

失败返回{"code":错误码, "message": 错误描述}

返回结果

data结构

异常code

接口描述

门店履约信息变更时，会对合作方提供的URL进行回调请求。包括门店营业时间变更、门店营业状态变更、门店配送服务变更、门店支持的预订单时间变更，后续还会增加类型。

签名算法

跟配送平台签名算法一致。使用配送平台的appkey跟secret做签名计算

成功与重试

回调根据http响应码为200且返回{"code":0} 判断为成功，否则为失败

若第一次回调失败，会在 10 分钟内重试 5 次，且每次重试时间间隔逐步延长

接口说明

请求方式：post

请求格式：application/x-www-form-urlencoded请求参数

回调请求参数

[
  {
    "reason": "",
    "pre_business_hours": "[{\"beginTime\":\"00:00\",\"endTime\":\"24:00\"}]",
    "shop_delivery_type": "1",
    "utime": "1675391677",
    "current_business_hours": "[{\"beginTime\":\"00:00\",\"endTime\":\"23:59\"}]"
  },
  {
    "current_isOpen": "1",
    "pre_isOpen": "0",
    "reason": "",
    "shop_delivery_type": "2",
    "utime": "1675391677"
  },
  {
    "shop_delivery_type": "3",
    "utime": "1675391677",
    "pre_serviceTypes": "100000,100002,100005,100007,100305,100001",
    "current_serviceTypes": "100000,100001,100002,100005,100007,100305,100006"
  },
  {
    "pre_prebook_status": "0",
    "shop_delivery_type": "4",
    "utime": "1675391677",
    "current_prebook_out_biz_time": "1",
    "current_prebook_time_range": "{\"start\":0,\"end\":6}",
    "pre_prebook_out_biz_time": "0",
    "current_prebook_status": "1",
    "pre_prebook_time_range": "{\"start\":0,\"end\":0}"
  }
]

门店履约信息字段说明

回调返回信息

客户系统提供的url需返回的信息

1. 1.使用测试账号，创建一个测试订单，验证创建订单成功
2. 2.使用模拟接单及模拟取货接口，验证回调成功
3. 3.取消该测试订单，验证取消订单成功
4. 4.请将该测试订单的订单号告知美团工作人员，执行对接验收工作

若合作方需要测试订单调度的回调消息，可使用以下接口模拟改变订单状态

请求参数（模拟url接口与正常API接口一样，也需要附带系统参数及计算签名信息）

返回信息：

成功返回

{
	"code":0
}

失败返回

{
	"code": 错误码,
	"message":错误描述
}

注：此接口只适用于测试订单，若测试订单出现错误，则接口根据不同错误类型返回不同的原因，{"code":124, "message":"模拟操作失败，（括号内为下面对应的错误信息）"}

模拟操作错误信息：

若合作方需要测试门店配送范围变更的回调，可使用以下接口模拟门店配送范围变更

请求参数（模拟url接口与正常API接口一样，也需要附带系统参数及计算签名信息）

返回信息：

成功返回

{
	"code":0
}

失败返回

{
	"code": 错误码,
	"message":错误描述
}

注：此接口只适用于测试模拟门店范围变更回调，若测试过程中出现错误，则接口根据不同错误类型返回不同的原因，{"code":124, "message":"模拟操作失败，（括号内为下面对应的错误信息）"}

模拟操作错误信息：

若合作方需要测试门店配送风险等级变更的回调，可使用以下接口模拟门店配送风险等级变更

请求参数（模拟url接口与正常API接口一样，也需要附带系统参数及计算签名信息）

返回信息：

成功返回

{
	"code":0
}

失败返回

{
	"code": 错误码,
	"message":错误描述
}

注：此接口只适用于测试模拟门店配送风险等级变更回调，若测试过程中出现错误，则接口根据不同错误类型返回不同的原因，{"code":124, "message":"模拟操作失败，（括号内为下面对应的错误信息）"}

模拟操作错误信息：

若合作方需要测试门店门店状态的回调，可使用以下接口模拟

请求参数（模拟url接口与正常API接口一样，也需要附带系统参数及计算签名信息）

返回信息：

成功返回

{
	"code":0
}

失败返回

{
	"code": 错误码,
	"message":错误描述
}

注：此接口只适用于测试模拟门店状态回调，若测试过程中出现错误，则接口根据不同错误类型返回不同的原因，{"code":124, "message":"模拟操作失败，（括号内为下面对应的错误信息）"}

模拟操作错误信息：

若合作方需要测试配送员上下班打卡的回调，可使用以下接口模拟

请求参数（模拟url接口与正常API接口一样，也需要附带系统参数及计算签名信息）

返回信息：

成功返回

{
	"code":0
}
							

失败返回

{
	"code": 错误码,
	"message":错误描述
}
								

注：此接口只适用于测试配送员上下班打卡回调，若测试过程中出现错误，则接口根据不同错误类型返回不同的原因，{"code":124, "message":"模拟操作失败，（括号内为下面对应的错误信息）"}

模拟操作错误信息：

客户取消订单原因

客户调用订单取消接口时可以选择的取消原因。

系统取消订单原因

美团配送系统在发生异常状况自动取消订单时使用的取消原因。

更新时间：2021-08-17 16:10:00

尊敬的合作伙伴：

为了给美团配送的各位合作伙伴提供多样的履约费用支付方式，美团配送新增了”实时支付“场景下的的”余额支付“，美团配送技术服务合作中心接口能力因此做了升级；

接口升级详细内容参考下方。

您需在8月30日前，完成系统能力的兼容性检查或升级，使系统兼容美团配送技术服务合作中心接口返回字段新增的变化；

建议：由于美团配送技术服务合作中心会持续为您提供更优质的系统对接服务，接口能力会不定期持续升级，返回字段的数量也会随接口升级有所增加，请您做好系统兼容。

一、新增接口

接口名：预发单接口
文档地址：https://peisong.meituan.com/open/doc#section2-20

二、变更接口

接口名：订单创建(门店方式)
文档地址：https://peisong.meituan.com/open/doc#section2-20
变更内容：新增4个返回字段（已更新到接口文档）：base_delivery_fee、pay_amount、settlement_mode_code、coupons_amount

接口名：查询订单状态
文档地址：https://peisong.meituan.com/open/doc#section2-20
变更内容：新增5个返回字段（已更新到接口文档）：delivery_distance、delivery_fee、pay_amount、settlement_mode_code、coupons_amount

与订单创建（坐标方式）不同，订单创建（门店方式）面向签订服务包合同的客户。 所以在迁移前请确保与美团签订服务包合同。