美团企业版技术文档

# API接口

注：以下接口中$API_HOST对应值

  • 线下环境 $API_HOST = https://inf-openapi.apigw.test.meituan.com/api/sqt/openapi
  • 线上环境 $API_HOST = https://bep-openapi.meituan.com/api/sqt/openapi

# 1.查询周边运力

# 1.1 接口说明

名称 描述
功能 用于查询用户当前位置附近司机，包括当前位置附近的全部车型
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
url $API_HOST/dache/queryNearByDrivers
method dache.query.nearby.driver

# 1.2 公共参数

详见：公共参数说明-公共请求参数

# 1.3 业务参数

名称 类型 是否必填 示例 说明
supplyCode int 是 1 供给类型，1:打车
longitude double 是 116.375598 经度,GCJ-02（火星坐标系）
latitude double 是 40.099965 纬度,GCJ-02（火星坐标系）
carTypeIds String 否 1 运力类型，多个运力类型用","分割，举例：1,2,3

# 1.4 业务响应

名称 类型 是否非空 示例 说明
code int 是 0 业务状态码。0成功，非0标识失败
message string 否 参数错误 响应提示信息
data array 否 结果列表
data[].longitude double 是 116.375598 经度
data[].latitude double 是 40.099965 纬度
data[].carTypeId int 是 1 运力ID. 1:出租车 2:经济型 3:舒适型 4:六座商务 5:豪华 6:代驾
data[].partnerId int 是 1 运力供应商id
data[].partnerCarTypeId int 否 1 供应商车型id
data[].direction double 是 100 车头方向[0,360),0表示正北，数组顺时针
data[].distance int 否 100 接驾导航距离单位m
data[].duration int 否 100 接驾时长单位ms
data[].timestamp long 否 1557207812000 司机位置时间戳单位ms

# 1.5 示例结果

请求

{
    "supplyCode": 1,
    "entId": 617,
    "method": "dache.query.nearby.driver",
    "ts": 1629857463,
    "longitude": 116.488541,
    "latitude": 40.006428
}

响应

{
    "code": 0,
    "data": [
        {
            "longitude": 116.48602565294897,
            "latitude": 40.01041636564252,
            "direction": 1.0,
            "duration": 82166,
            "timestamp": 1629858386087,
            "distance": 493,
            "carTypeId": 1,
            "partnerId": 1,
            "partnerCarTypeId": 1
        },
        {
            "longitude": 116.484057,
            "latitude": 40.009581,
            "direction": 1.0,
            "duration": 86500,
            "timestamp": 1629858387152,
            "distance": 519,
            "carTypeId": 1,
            "partnerId": 1,
            "partnerCarTypeId": 1
        },
        {
            "longitude": 116.48508699999998,
            "latitude": 40.0116,
            "direction": -1.0,
            "duration": 107666,
            "timestamp": 1629858280444,
            "distance": 646,
            "carTypeId": 1,
            "partnerId": 1,
            "partnerCarTypeId": 1
        },
        {
            "longitude": 116.485522,
            "latitude": 40.011942,
            "direction": -1.0,
            "duration": 110833,
            "timestamp": 1629858367364,
            "distance": 665,
            "carTypeId": 1,
            "partnerId": 1,
            "partnerCarTypeId": 1
        },
        {
            "longitude": 116.48544976128473,
            "latitude": 40.01148654513889,
            "direction": -1.0,
            "duration": 103500,
            "timestamp": 1629858333542,
            "distance": 621,
            "carTypeId": 2,
            "partnerId": 1,
            "partnerCarTypeId": 2
        },
        {
            "longitude": 116.48499077690973,
            "latitude": 40.0117054578993,
            "direction": 300.0,
            "duration": 110000,
            "timestamp": 1629858382389,
            "distance": 660,
            "carTypeId": 2,
            "partnerId": 1,
            "partnerCarTypeId": 2
        },
        {
            "longitude": 116.4849888780382,
            "latitude": 40.01171006944445,
            "direction": 300.0,
            "duration": 110166,
            "timestamp": 1629858382399,
            "distance": 661,
            "carTypeId": 2,
            "partnerId": 1,
            "partnerCarTypeId": 2
        },
        {
            "longitude": 116.485522,
            "latitude": 40.011942,
            "direction": -1.0,
            "duration": 110833,
            "timestamp": 1629858314407,
            "distance": 665,
            "carTypeId": 2,
            "partnerId": 1,
            "partnerCarTypeId": 2
        }
    ],
    "message": "成功"
}

# 2.查询预估价

# 2.1 接口说明

名称 描述
功能 出发位置到目的地位置打车需要的价格预估，是下单前的参考价格
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
url $API_HOST/dache/queryEstimatedPrice
method dache.query.estimated.price

# 2.2 公共参数

详见：公共参数说明-公共请求参数

# 2.3 业务参数

名称 类型 是否必填 示例 说明
supplyCode int 是 1 供给类型，1:打车
fromLongitude double 是 116.375598 出发地经度,GCJ-02（火星坐标系）
fromLatitude double 是 40.099965 出发地纬度,GCJ-02（火星坐标系）
startPointName string 是 xxx 出发地名称
endPointName string 是 xxx 目的地名称
toLongitude double 是 116.975598 目的地经度,GCJ-02（火星坐标系）
toLatitude double 是 40.999965 目的地纬度,GCJ-02（火星坐标系）
reserveType int 是 1 服务类型，1.实时、2.预约
partnerId int 否 1 合作商id
carTypeId int 否 2 运力类型id.1:出租车 2:经济型 3:舒适型 4:六座商务 5:豪华 6:代驾
partnerCarTypeIdList string 否 1 具体车型id列表（同时预估以','分隔），传递时默认取参数中的车型与美团配置车型交集车型的预估价；不传时使用美团对合作方配置的车型集合预估价
departureTime long 否 1557207812000 出发时间.单位毫秒（ms).

# 2.4 业务响应

名称 类型 是否非空 示例 说明
code int 是 0 业务状态码。0成功，非0标识失败
message String 否 参数错误 响应提示信息
data object 否 结果列表
data.estimatePrices array 否 运力预估价格信息列表
data.estimatePrices[].partnerId int 是 1123 合作方ID
data.estimatePrices[].partnerName string 是 曹操出行 合作方名称
data.estimatePrices[].carTypeId int 是 1 运力id。1:出租车 2:经济型 3:舒适型 4:六座商务 5:豪华 6:代驾
data.estimatePrices[].carTypeName string 是 1 运力类型中文
data.estimatePrices[].partnerCarTypeId int 是 1 合作商车型ID：首汽专车，神州舒享型，阳光经济型等
data.estimatePrices[].partnerCarTypeName string 是 聚合经济型 合作商车型名称
data.estimatePrices[].estimateId string 是 e100 预估标识，创建订单时使用，有效期10分钟
data.estimatePrices[].selfReduce int 是 100 平台自身优惠金额，单位分
data.estimatePrices[].partnerReduce int 是 100 合作方优惠金额，单位分
data.estimatePrices[].distance int 是 1 预估距离，单位米（m），不足1m，返回1
data.estimatePrices[].estimateTime int 是 60 预估时间，单位秒（S），不足60秒，返回60
data.estimatePrices[].travelPrice int 是 60 基础车费原价，单位分
data.estimatePrices[].distancePrice int 是 0 行驶里程费，单位分
data.estimatePrices[].timePrice int 是 60 行驶时长费，单位分
data.estimatePrices[].initPrice int 是 0 订单起步价，单位分
data.estimatePrices[].minPrice int 是 60 最少费用/套餐费,单位分
data.estimatePrices[].nightPrice int 是 0 夜间里程费，单位分
data.estimatePrices[].driveLongDistancePrice int 是 60 远途行使里程费，单位分
data.estimatePrices[].driveHighwayPrice int 否 0 高速费，单位分
data.estimatePrices[].deliveringStartTime int 否 60 预计送驾时间，单位秒
data.estimatePrices[].servicePrice int 否 60 服务金额费，单位分
data.estimatePrices[].dynamicPrice int 否 0 动态调价费，单位分
data.estimatePrices[].priceDifference int 否 0 基础车费补足，单位分
data.estimatePrices[].priceTagGroupId int 否 0 特殊区域计价ID
data.estimatePrices[].estimateUserPayableTotalPrice int 是 60 用户预估阶段应付原价，单位分
data.estimatePrices[].estimateUserPayableBalancePrice int 是 60 用户预估阶段应付尾款，单位分
data.estimatePrices[].estimateTotalDiscounts int 是 60 预估阶段总的优惠金额，单位分

# 2.5 示例结果

请求

{
    "supplyCode": 1,
    "entId": 617,
    "method": "dache.query.estimated.price",
    "ts": 1629857638,
    "fromLongitude": 116.488541,
    "fromLatitude": 40.006428,
    "toLongitude": 116.419153,
    "toLatitude": 40.003063,
    "reserveType": 1
}

响应

{
    "code": 0,
    "data": {
        "estimatePrice": [
            {
                "partnerId": 200000,
                "partnerName": "聚合服务商",
                "carTypeId": 2,
                "carTypeName": "经济",
                "partnerCarTypeId": 2000001,
                "partnerCarTypeName": "聚合经济型",
                "estimateId": "test-estimate-price",
                "estimatePrice": 7000,
                "selfReduce": 0,
                "partnerReduce": 0,
                "distance": 10000,
                "estimateTime": 1800000,
                "travelPrice": 7000,
                "distancePrice": 1500,
                "timePrice": 500,
                "initPrice": 1500,
                "minPrice": 0,
                "nightPrice": 0,
                "driveLongDistancePrice": 0,
                "driveHighwayPrice": 0,
                "deliveringStartTime": 0,
                "servicePrice": 0,
                "dynamicPrice": 0,
                "priceDifference": 3500,
                "priceTagGroupId": null,
                "estimateUserPayableTotalPrice": 7000,
                "estimateUserPayableBalancePrice": 7000,
                "estimateTotalDiscounts": 0
            }
        ]
    },
    "message": "成功"
}

# 3.下单

# 3.1 接口说明

名称 描述
功能 提交订单
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
url $API_HOST/dache/submitOrder
method dache.submit.order

# 3.2 公共参数

详见：公共参数说明-公共请求参数

# 3.3 业务参数

名称 类型 是否必填 示例 说明
supplyCode int 是 1 供给类型，1:打车
channelPartnerOrderId string 是 111111 合作方订单id
mobile string 否 18511111111 下单用户手机号,对于identifyType=50可以不传值，但是需要保证mobile能标识企业员工的唯一性
userIdentifyCode string 是 70000183 下单用户唯一标识值！对于某些企业mobile使用虚拟号且可能存在重复情况，使用此标识值标定企业下的员工/用户
identifyType int 是 30 20:邮箱 30:工号 50:手机号
fLng double 是 120.099965 起点经度
fLat double 是 40.099965 起点纬度
fromAddress String 是 北京市朝阳区望京东路4号 起点地址
tLng double 是 120.999965 终点经度
tLat double 是 40.399965 终点纬度
toAddress String 是 北京西站 终点地址
networkType String 否 4G 网络类型，例如wifi、4G
clientIp String 否 4G 客户端IP
reserveType int 是 1 订单类型1:实时单2：预约单
reserveTime long 否 1 预约时间，若为预约单需要有此时间
passengerVirtualMobile string 否 "123456789" 下单用户手机虚拟号
passengerMobileLastNumber string 否 "2020" 下单用户手机尾号
carTypeRequestList List<CarTypeRequestDTO 是 见下面CarTypeRequestDTO字段说明 用车请求参数

CarTypeRequestDTO字段说明

名称 类型 是否非空 示例 说明
estimateId string 是 1123 预估id
estimateAmount int 是 1 预估价，单位分
carTypeId int 是 1 运力id，例如出租车，舒适，豪华
partnerId int 是 1 供应商id
partnerCarTypeId int 是 1 具体车型id，例如曹操专车
originFee int 是 100 没有减去优惠的原始预估价，单位分

# 3.4 业务响应

名称 类型 是否非空 示例 说明
code int 是 0 业务状态码。0成功，非0标识失败
message string 否 参数错误 响应提示信息
data object 否 结果列表
data.mtOrderId string 是 28739832749183724129 美团订单号

# 3.5 示例结果

请求

{
    "supplyCode": 1,
    "entId": 617,
    "method": "dache.submit.order",
    "ts": 1629857312,
    "channelPartnerOrderId": "4fccd962-1ef3-4b0c-9442-6c40eb682387",
    "mobile": "1366489439",
    "userIdentifyCode": "70000185",
    "identifyType": 30,
    "fLng": 116.488541,
    "fLat": 40.006428,
    "fromAddress": "望京国际研发园(东南门)",
    "tLng": 116.419153,
    "tLat": 40.003063,
    "toAddress": "大屯路东(地铁站)",
    "networkType": "4G",
    "clientIp": "172.30.194.206",
    "reserveType": 1,
    "carTypeRequestList": [
        {
            "estimateId": "1000000001-1428228663219847187-1629351223174",
            "estimateAmount": 2380,
            "carTypeId": 2,
            "partnerCarTypeId": 1,
            "originFee": 2380
        }
    ]
}

响应

{
  "message": "成功",
  "code": 0,
  "data": 
    {
      "mtOrderId": "143035144198107963915429100000"
    }
}

# 4.向企业提交运力

# 4.1 接口说明

名称 描述
功能 企业提单后向接入企业反馈可用运力。在下单锁定运力成功后发起调用,需要企业客户提供http接口
HTTP方法 POST
请求方 美团企业版平台
响应方 第三方平台
url 企业客户提供

# 4.2 公共参数

详见：公共参数说明-公共请求参数

# 4.3 业务参数

名称 类型 是否必填 示例 说明
mtOrderId string 是 152946668566360890609920000280 美团订单id
mtDispatchSubOrderId string 是 12121212 美团调度子单号
estimateId string 否 113-1530039552432234530-1653624830718 预估id
submitCarInfo SubmitCarInfo 是 接单车辆信息
submitDriveInfo SubmitDriveInfo 是 接单司机信息

SubmitCarInfo字段说明

名称 类型 是否非空 示例 说明
partnerId int 是 1 接单服务商id
partnerName string 否 美团打车 接单服务商名称
carTypeId int 否 2 运力类型id
carTypeName string 否 经济型 运力类型名称。比如经济型，舒适型等
partnerCarTypeId int 是 1 接单服务商车型id
partnerCarTypeName string 是 美团快车 接单服务商车型名称。比如美团快车
carColor string 否 白色 车辆颜色
carNumber string 否 苏ADD3850 车牌号
brandName string 否 比亚迪秦 车品牌名称

SubmitDriveInfo字段说明

名称 类型 是否非空 示例 说明
driverId string 是 1894167704 司机id
driverName string 否 杨师傅 司机名字
lng string 是 121.22 司机所在经度
lat string 是 12.2 司机所在维度
driverPic string 否 司机头像

# 4.4 业务响应

名称 类型 是否非空 示例 说明
code int 是 0 业务状态码。0成功，非0标识失败
message String 否 参数错误 响应提示信息

# 4.5 示例结果

请求

{
    "mtOrderId": "152946668566360890609920000280",
    "mtDispatchSubOrderId": "121212121",
    "estimateId": "113-1530039552432234530-1653624830718",
    "submitCarInfo": {
        "partnerId": 1,
        "partnerName": "美团打车",
        "carTypeId": 2,
        "carTypeName": "经济型",
        "partnerCarTypeId": 1,
        "partnerCarTypeName": "美团快车",
        "carColor": "白色",
        "carNumber": "苏ADD3850",
        "brandName": "比亚迪秦"
    },
    "submitDriveInfo": {
        "driverId": "1894167704",
        "driverName": "杨师傅",
        "lng": "12.22",
        "lat": "121.21",
        "driverPic": ""
    }
}

响应

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

# 5.企业派单

# 5.1 接口说明

名称 描述
功能 上游企业经过运力pk后，对选中的美团运力进行确认派单
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
url $API_HOST/dache/confirmOrder
method dache.confirm.order

# 5.2 公共参数

详见：公共参数说明-公共请求参数

# 5.3 业务参数

名称 类型 是否必填 示例 说明
supplyCode int 是 1 供给类型,1：打车
mtOrderId string 是 143009655634578641215429100000 美团订单id
driverId string 是 1932170586217 司机id

# 5.4 业务响应

名称 类型 是否非空 示例 说明
code int 是 0 业务状态码。0成功，非0标识失败
message String 否 参数错误 响应提示信息
data object 否 结果 一般无返回

# 5.5 示例结果

请求

{
  "method":"dache.confirm.order",
  "ts":1512963578,
  "entId":1,
  "supplyCode": 1,
    "mtOrderId": "143009655634578641215429100000",
    "driverId": "1932170586217"
}

响应

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

# 6.取消订单

# 6.1 接口说明

名称 描述
功能 取消订单接口。例如：在有取消费的情况，接收响应超时，会再次发起取消调用，能返回取消费
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
url $API_HOST/dache/cancelOrder
method dache.cancel.order

# 6.2 公共参数

详见：公共参数说明-公共请求参数

# 6.3 业务参数

名称 类型 是否必填 示例 说明
supplyCode int 是 1 供给类型，1:打车
mtOrderId string 是 111111 美团订单号
channelPartnerOrderId string 是 18511111111 合作方订单号
cancelCode Integer 否 10 取消原因，参见附录【用户取消原因】
type int 是 1 取消类型，1：询问取消费；2：确认取消

# 6.4 业务响应

名称 类型 是否非空 示例 说明
code int 是 0 业务状态码。0成功，非0标识失败
message String 否 参数错误 响应提示信息
data Object 否 结果列表
data.cancelPrice int 是 100 取消费，单位为分

# 6.5 示例结果

请求

{
    "supplyCode": 1,
    "entId": 617,
    "method": "dache.cancel.order",
    "ts": 1629857773,
    "mtOrderId": "143009655634578641215429100000",
    "channelPartnerOrderId": "314253f8-912b-4c7e-9f25-bcd5ae4be8cc",
    "cancelCode": 10,
    "type": 2
}

响应

{
    "code": 0,
    "data": {
        "cancelPrice": 0
    },
    "message": "成功"
}

# 7.实时订单状态拉取

# 7.1 接口说明

名称 描述
功能 查询订单详情
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
url $API_HOST/dache/queryRealTimeOrder
method dache.query.real.time.order

# 7.2 公共参数

详见：公共参数说明-公共请求参数

# 7.3 业务参数

名称 类型 是否必填 示例 说明
supplyCode int 是 1 供给类型，1:打车
mtOrderId string 是 1851101101102112 美团订单号
channelPartnerOrderId string 是 18511111111 合作方订单号

# 7.4 业务响应

名称 类型 是否非空 示例 说明
code int 是 0 业务状态码。0成功，非0标识失败
message string 否 参数错误 响应提示信息
data object 否 结果列表
data.orderStatus int 是 订单状态，具体值参见订单状态定义
data.updateTime long 是 订单状态更新时间，unix时间戳,ms
data.mtOrderId string 是 美团订单号
data.channelPartnerOrderId string 是 合作方订单Id
data.userPriceInfo object 是 费用信息
data.userPriceInfo.userPayableTotalPrice int 是 用户应付原价（取消费不体现）
data.userPriceInfo.userPayableBalancePrice int 是 用户应付尾款（包含取消费）建议接入方使用此字段
data.userPriceInfo.cancelFee int 是 用户应付取消费
data.userPriceInfo.totalPrice int 是 【行程费用】行程基础类费用总额,单位分。完成履约行为后，除去高速费、停车费、感谢费、其他费用四项附加类费用项外订单产生的行程费用总和
data.userPriceInfo.driveStartPrice int 是 【行程费用】起步价。订单开始履约需要收取的费用，包含一定的里程和时长。注：当时长费和里程费不满起步价，但需要按照起步价金额收取的时候，里程费和时长费不需要传递，只传起步价金额。
data.userPriceInfo.driveDistance int 是 【行程描述】行驶里程,单位m
data.userPriceInfo.driveDistancePrice int 是 【行程费用】里程费。行驶里程产生的费用总额，里程费=正常里程费+夜间里程费
data.userPriceInfo.driveTime int 是 【行程描述】行驶时长,单位ms
data.userPriceInfo.driveTimePrice int 是 【行程费用】时长费。行驶时间产生的费用总额
data.userPriceInfo.driveLongDistancePrice int 否 【行程费用】远程费。超过一定里程之后收取的远途行驶里程费用总和
data.userPriceInfo.dynamicPrice int 否 【行程费用】动态调价费。根据供需关系对订单费用进行实时调价的金额。（此值可正可负，当为正值时美团会处展示成溢价费；当为负值时美团会展示为动态折扣）
data.userPriceInfo.servicePriceAmount int 否 行程费用】服务费
data.userPriceInfo.taxiMeterFee int 否 行程费用】出租车打表费
data.userPriceInfo.driveHighwayPrice int 否 【行后费用】高速费。订单履约过程产生的高速类费用，此费用为代收代付类费用不能开票，不能抽佣，不能使用红包抵扣
data.userPriceInfo.driveTollPrice int 否 【行后费用】通行费。订单履约过程产生的过路过桥类费用，此费用为代收代付类费用不能开票，不能抽佣，不能使用红包抵扣
data.userPriceInfo.driveParkPrice int 否 【行后费用】停车费。订单履约过程产生的停车类费用，此费用为代收代付类费用不能开票，不能抽佣，不能使用红包抵扣
data.userPriceInfo.driveOtherPrice int 否 【行后费用】其他费。订单履约过程中产生的其他代收代付类费用，如：清洁费等费用项，此费用为代收代付类费用不能开票，不能抽佣，不能使用红包抵扣
data.userPriceInfo.longDispatchPrice int 否 【行前费用】远途调度费
data.userPriceInfo.waitFee int 否 【行程费用】等待费。等待时间产生的费用总和
data.userPriceInfo.waitTime int 否 行程描述】等待时长，单位ms
data.userPriceInfo.waitFee int 否 【行程费用】等待费。等待时间产生的费用总和
data.userPriceInfo.thanksFee int 否 【行前费用】感谢费
data.userPriceInfo.eDispatchPrice int 否 【行程费用】电调费金额，单位：分。出租车场景下，国家允许收取的加价费用
data.userPriceInfo.partnerReducePrice int 否 【行程费用】折扣费用。正值
data.userPriceInfo.priceDifference int 否 【行程费用】基础车费补足(正常情况下>=0）
data.driverInfo object 是 接单后司机信息,状态编码为30~100情况下必传，接单后取消的场景也必须传，其他情况不传
data.driverInfo.name string 是 司机名称
data.driverInfo.lng double 否 司机当前经度
data.driverInfo.lat double 否 司机当前纬度
data.driverInfo.direction double 否 司机车头方位
data.driverInfo.phone string 否 司机电话（虚拟号）
data.driverInfo.orderNum int 否 司机接单数
data.driverInfo.carBrand string 是 车牌品牌
data.driverInfo.carTypeId int 是 运力类型id
data.driverInfo.carColor string 是 颜色
data.driverInfo.carPlateNo string 是 车牌
data.driverInfo.driverId string 是 司机id
data.driverInfo.driverPic string 否 司机头像图片地址
data.driverInfo.driverStar string 否 司机评分
data.driverInfo.carPic string 否 车辆图片地址
data.driverInfo.companyId string 否 车辆公司id
data.driverInfo.companyName string 否 公司名称
data.driverInfo.partnerId int 否 运力供应商id
data.driverInfo.partnerCarTypeId int 否 运力供应商车型id
data.payInfo object 否 支付相关信息
data.payInfo.payUtime long 否 支付时间
data.payInfo.payMode int 否
data.payInfo.payType string 否

# 7.5 示例结果

请求

{
    "supplyCode": 1,
    "entId": 617,
    "method": "dache.query.real.time.order",
    "ts": 1629857871,
    "mtOrderId": "143231256719104411736909100000",
    "channelPartnerOrderId": "1a888420a05e4123a190164687c0107a"
}

响应

{
    "code": 0,
    "data": {
        "userPriceInfo": {
            "userPayableBalancePrice": 200,
            "cancelFee": 0,
            "userPayableTotalPrice": 200,
            "totalPrice": 200,
            "driveStartPrice": 200,
            "driveDistance": 1000,
            "driveDistancePrice": 0,
            "driveTime": 60000,
            "driveTimePrice": 0,
            "driveLongDistancePrice": 0,
            "dynamicPrice": 0,
            "servicePriceAmount": 0,
            "taxiMeterFee": 0,
            "driveHighwayPrice": 0,
            "driveTollPrice": 0,
            "driveParkPrice": 0,
            "driveOtherPrice": 0,
            "longDispatchPrice": 0,
            "waitFee": 0,
            "waitTime": 0,
            "thanksFee": 0,
            "eDispatchPrice": 0,
            "partnerReducePrice": 0,
            "priceDifference": 0
        },
        "orderStatus": 8,
        "mtOrderId": "143231256719104411736909100000",
        "channelPartnerOrderId": "1a888420a05e4123a190164687c0107a",
        "updateTime": 1639149106000,
        "driverInfo": {
            "name": "mock姓氏师傅",
            "lng": null,
            "lat": null,
            "direction": null,
            "phone": null,
            "orderNum": 64,
            "carBrand": "mock车型",
            "carTypeId": 2,
            "carColor": "mock车黑色",
            "carPlateNo": "京A00085",
            "driverId": "7501810351",
            "driverPic": null,
            "driverStar": null,
            "carPic": null,
            "companyId": null,
            "companyName": null,
            "partnerId": 200000,
            "partnerCarTypeId": 2000001
        },
        "payInfo": {
            "payUtime": 1639149106000,
            "payMode": 1,
            "payType": "meituanpay"
        }
    },
    "message": "成功"
}

# 8.通知支付完成

# 8.1 接口说明

名称 描述
功能 合作方支付订单、取消费后通知美团
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
url $API_HOST/dache/notifyPaidResult
method dache.notify.paid.result

# 8.2 公共参数

详见：公共参数说明-公共请求参数

# 8.3 业务参数

名称 类型 是否必填 示例 说明
supplyCode int 是 1 供给类型，1:打车
mtOrderId string 是 111111 美团订单号
channelPartnerOrderId string 是 18511111111 合作方订单号
price int 是 100 支付金额，单位为分。取订单的应付尾款字段-userPayableBalancePrice

# 8.4 业务响应

名称 类型 是否非空 示例 说明
code int 是 0 0成功， 非0见附录 错误状态码
message int 是 0 失败原因描述，若成功值可为空
data object 否 - -

# 8.5 示例结果

请求

{
    "supplyCode": 1,
    "entId": 617,
    "method": "dache.notify.paid.result",
    "ts": 1629858183,
    "mtOrderId": "142835622600087966587129100000",
    "channelPartnerOrderId": "06bd8376-e892-4b5b-873c-8b1ad9535e42",
    "price": 1000
}

响应

{
  "code": 0,
  "message": "成功",
  "data": null
}

# 9.订单事件变更推送

参见：订单状态变更推送

# 10.退款事件推送

# 10.1 接口说明

接入方可接入此接口，感知打车订单的退款。在接入前需注意以下事项:

  • 推送地址由接入客户提供，如需接入请客户经理协助支持配置。
  • 事件推送并不能保证100%可靠性，以及存在丢失，重复，乱序的可能，请接入方务必知晓并且接口设计能支持幂等。

# 10.2 公共参数

详见：公共参数说明-公共请求参数

# 10.3 业务参数

名称 类型 是否必填 示例 说明
mtOrderId String 是 111111 美团订单号
sqtRefundNo String 是 18511111111 美团企业版退款流水号
tradeOrderId Long 否 12121 交易单号
paySerialNum String 否 9c2asa923x 支付单号，和tradeOrderId等价
refundTime Long 是 1646982313544 退款时间（毫秒）
refundAmount Integer 是 1000 退款金额。(分)
refundStatus Integer 是 10 退款状态。目前推送的状态，只有10，即退款成功

# 10.4 业务响应

名称 类型 是否非空 示例 说明
code int 是 0 0成功， 返回0代表客户接受处理成功，非0失败，会触发重试。
message int 否 0 可为空
data object 否 - 不返回

# 附录

# 错误状态码

状态码（code） 消息（message） 描述
-1 UNKNOWN 未知错误
0 SUCCESS 成功
1 PARAM_ERROR 参数错误
2 SYSTEM_ERROR 服务异常
3 REPEAT_SUBMIT_ORDER_ERROR 重复下单
4 ENT_ACCOUNT_BALANCE_QUERY_ERROR 企业账户余额查询异常
5 ENT_BALANCE_NOT_SUFFICIENT 企业余额不足
6 LOCAL_SUBMIT_ERROR 本地下单异常
7 NOT_WAIT_PAY_ORDER_NOT_PAY 非待支付订单不能支付
8 ILLEGAL_ORDER_ID 非法订单号
9 ILLEGAL_API_ACCESS 无效访问
10 STAFF_CREATE_ERROR 员工创建失败
11 ILLEGAL_PRICE 支付金额不合法
1000 DATA_NOT_EXIST 数据不存在
1010 AUTH_ERROR 鉴权失败
1106 CANCELED_ORDER_NOT_CANCEL_AGAIN 订单不能再次取消
1020 CITY_NOT_OPEN_ERROR 当前城市暂未开通服务
1030 CITY_NOT_FOUND_ERROR 无法找到对应的城市
1129 RESERVE_TIME_ERROR 预约单预约时间校验错误
1300 ILLEGAL_CAR_TYPE_ID 编码选择错误

# 取消类型

类型编码 描述
1001 用户取消：用户主动发起的取消
1002 超时取消：合作方响应慢导致的取消，场景包括：1. 平台默认的时间窗口内(基于供需状况调整)没有响应；2. 同一订单别的合作方响应后n秒（基于供需状况调整）内没有响应。
1003 竞争失败取消：多个合作方返回候选运力场景下，平台会基于用户体验原则将订单分配给最优的一个合作方，其他合作方则为竞争失败。
1004 准入过滤取消：平台对候选运力有接驾时间和接驾距离的要求，不满足要求的运力会被平台取消。运力要求参见下单接口maxEda和maxEta参数。
1005 风控取消：平台会基于风控规则对运力进行过滤，进而导致的取消。
1006 司机不符合接单条件：因限行、司乘拉黑、司机封禁等原因导致的取消。

# 用户取消原因

类型编码 描述
10 我行程有变，暂不需要用车
11 我赶时间，换用其他交通工具
12 司机距我太远
13 与司机协商后取消订单
14 司机以各种理由拒绝接我
15 司机联系不上
16 司机迟到
17 其他
19 司机服务态度差
20 司机接驾时间过长
21 上车点不在我当前位置司机找不到
22 上车点禁止停车
23 起点填写错误
40 司机找不到我
41 车牌号和订单显示不一致
42 司机要求加价或现金交易
43 司机原地不动或反方向行驶
44 司机要求我取消

# 订单事件说明

订单事件状态 事件描述 事件码
ORDER_CREATED 已下单 10
ORDER_PUSHED 已推单 11
ORDER_CONFIRMED 已接单 20
ORDER_REASSIGNED 改派 30
ORDER_SERVICE_STARTED 司机已开始服务 40
DEPARTURE_CHANGED 订单已更改接驾点 41
DRIVER_ARRIVED 司机已达到上车点 50
TRIP_STARTED 已开始行程 60
DESTINATION_CHANGED 订单已更改目的地 61
TRIP_DELIVERED 乘客已被送达目的地 70
BILL_GENERATED 已生成账单 80
BILL_CHANGED 订单已改价 81
ORDER_PAID 订单已支付完成 90
ORDER_CANCELED 订单已被取消无取消费 100
ORDER_CANCELED_WITH_PAY 订单已被取消且有取消费，需要用户支付 110
ORDER_SUSPENDED 订单挂起 111
ORDER_UN_SUSPENDED 订单解除挂起 112
CAR_TYPE_APPENDED 已追加车型 113

# 订单状态说明

编码 状态描述
1 提交订单
2 已推单
3 已接单
4 司机已到达
5 行驶中
6 已到达
7 待支付
8 已完成
200 乘客撤单无需支付
201 乘客撤单待支付
203 乘客撤单已支付
210 司机撤单无需支付
211 司机撤单待支付
220 调度撤单
230 系统撤单

# 客服问题分类

美团五级问题 美团六级问题 美团faqId
收费异议 未上车产生费用（不包含取消费） 49608
收费异议 司机恶意绕路 49614
收费异议 司机提前计费 49611
收费异议 司机未及时结束计费 49612
收费异议 司机多收附加费 49609
收费异议 多收了夜间/长途费用 49644
收费异议 其他 49787
红包不可用 优惠券使用问题 49121
合作方工单 其他 49652
乘车环境 车内环境问题 49498
司机服务行为 态度不友好 49602
司机服务行为 [送错目的地/未送达目的地] 49604
司机服务行为 中途下车 49358
订单取消 联系不上司机 49506
订单取消 司机未到达指定上车地点 49524
订单取消 司机迟到 49530
人车不符 人车不符 49467
物品遗失 物品遗失 49479
重开/修改发票信息 重开/修改电子发票信息 69154
咨询发票进度 咨询催促电子发票 69171
人身伤害 人身伤害 49450
财产损失 财产损失 49440
其他违法问题 其他违法问题 49801
[媒体/警方]特殊来电 [媒体/警方]特殊来电 49458
[定位/导航]问题 [定位/导航]问题 49601
上次更新: 4/22/2024, 4:15:08 PM

← 供应商接入api文档 →