淘宝开放平台

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
orderId	String	必须	2022918831918282912		外卖订单id
foreignId	String	必须	L1i29fooe194ad		商家会员id

名称	类型	示例值	描述
msgCode	Number	200	返回错误码，和http status保持概念相同
errorSubCode	String	order-service-error	错误子码
errorSubMessage	String	订单服务异常	具体错误描述
result	Result		接口返回结果
orderInfo OrderInfo 订单信息 └ orderId String 20223939182819283912 订单id └ packagePrice Number 1000 包装费金额，单位分 └ pickupId String 456 取餐号 └ isPlatform String 是是否平台配送 └ platformType String 78 平台配送类型 └ merchantRemark String 速度要快商家备注 └ customerRemark String 不要餐具客户备注 └ thirdSerialId String 12 第三方流水号 └ thirdOrderId String 11 第三方订单号 └ systemSerialId String 23 系统流水号 └ systemOrderId String 220127140832308749 系统订单号 └ refundAmount String 1000 订单可退金额--部分退新增 └ warningMessage String 退款异常订单异常原因--部分退新增 └ totalRefundAmount String 40000 订单可退总额--部分退新增 └ totalPackageAmount String 300 订单可退包装费总额--部分退新增 └ totalOfflineAmount String 10000 线下支付可退总额--部分退新增 └ totalDeliveryAmount String 100000 订单可退配送费总额--部分退新增 └ storeNo String 10012112 门店id--部分退新增 └ canInvoiceAmount String 1000 订单支持开票金额--部分退新增 └ orderType String 2 订单类型 └ orderStatus String 1 订单状态 └ price Number 3000 应付金额，单位分 └ realPrice Number 2000 实付金额，单位分 └ discountPrice Number 2500 优惠金额，单位分 └ merchPrice Number 1500 商品金额，单位分 └ deliveryPrice Number 1000 配送金额，单位分 └ payDetail String {'a': 1, 'b': 2} 支付明细，包含现金，优惠券，礼品卡等 └ payId String 20223939381839193 支付单号 └ payChannel String ALIPAY 支付方式 └ orderChannel String ALIPAY-MINIAPP 订单下单渠道 discountItemList DiscountItem [] 订单优惠项列表 └ itemName String 满5-1 优惠项名称 └ itemPrice Number 1000 优惠金额，单位分 └ cancelStatus Boolean false 订单取消状态 └ orderModelType String 1 订单模型类型【仅区分外卖与自提】枚举值: 外卖为1 自提为2 └ cancelSide String CUSTOMER 订单取消方 └ orderCreateDate String 2021-12-31 14:00:00 订单创建时间【下单时间】 └ cancelReason String 不想要了订单取消原因 └ memberLevel String 大咖会员等级 └ memberPhone String 139xxxxxxxx 会员手机号 └ nickname String 张三会员名 └ expectMakingTime String 2021-02-11 12:00:11 预计制作时间 └ expectDeliverTime String 2021-02-11 12:50:11 预计配送时间 └ orderScore Number 12 订单单笔积分 timeline Timeline [] 订单时间轴 └ status String 1 时间轴状态 └ statusTime String 2021-02-11 12:50:11 时间轴时间 comboInfoList ComboInfoItem [] 套餐信息列表 └ comboId String 394819 套餐id └ comboPrice Number 5000 套餐原价 └ comboDiscountPrice Number 3000 套餐折扣价，单位分 merchInfoList MerchInfoItem [] 套餐内商品列表 └ merchId String 9184919922 商品id └ merchName String 拿铁商品名称 └ merchPhoto String https://xxx.com/merch.png 商品图片链接 └ merchSpecs String 大杯商品规格 └ merchPrice Number 2300 商品原价，单位分 └ merchDiscountPrice Number 2100 商品优惠价，单位分 └ merchCount Number 3 商品数量 └ perCouponPrice Number 20 优惠券分摊价格 merchAttrList MerchAttrItem [] 商品属性列表 └ name String 加奶x2 商品属性名称（包含具体种类和数量） └ price Number 100 商品属性价格，单位分 └ extraData String {'a': 1, 'b': 2} 其他扩展属性 merchInfoList MerchInfoItem [] 商品信息列表（除套餐外单点商品） └ merchId String 9184919922 商品id └ merchName String 拿铁商品名称 └ merchPhoto String https://xxx.com/merch.png 商品图片链接 └ merchSpecs String 大杯商品规格 └ merchPrice Number 2300 商品原价，单位分 └ merchDiscountPrice Number 2100 商品优惠价，单位分 └ merchCount Number 3 商品数量 └ perCouponPrice Number 20 优惠券分摊价格 merchAttrList MerchAttrItem [] 商品属性列表 └ name String 加奶x2 商品属性名称（包含具体种类和数量） └ price Number 100 商品属性价格，单位分 └ extraData String {'a': 1, 'b': 2} 其他扩展属性 storeInfo StoreInfo 门店信息 └ storeId String 2039932 门店id └ storeType String Level-1 门店类型 └ storeName String 阿里巴巴A区店门店名称 └ storePhone String 0571-8xxxxxxxx 门店电话 └ storeManPhone String 133xxxxxxxx 门店负责人电话 deliveryInfo DeliveryInfo 配送信息 └ deliveryId String 20339192829182991 配送单号 └ logisticsId String 201111919282 配送公司物流单号 └ riderStatus String 配送中骑手状态 └ deliveryChannel String SF 配送渠道，顺丰/蜂鸟等 └ consigneeName String 张三收货人名称 └ consigneePhone String 133xxxxxxxx 收货人电话 └ consigneeAddress String xx市xx区xx小区xx号101室收货人地址 └ courierId String 1923889182 骑手id └ courierName String 李四骑手名称 └ courierPhone String 133xxxxxxxx 骑手电话 └ deliveryITotalDistance Number 1300 配送总距离，单位米 └ deliveryILastDistance Number 200 当前剩余距离，单位米 └ preDeliveryTime Number 1000 预计配送时长，单位秒 └ deliveryTime Number 400 实际配送时长，单位秒 └ deliveryLastTime Number 400 预计剩余配送时长，单位秒 └ courierLong String 133.2222 配送当前经度 └ courierLati String 33.2222 配送当前纬度 invoiceInfo InvoiceInfo 发票信息 └ isInvoice Boolean true 是否开票 └ invoiceTime String 2021-02-22 12:45:11 开票时间 └ invoiceType String ONLINE 开票形式，自主开票、客服人工开票 └ invoiceStatus String VAILD 发票状态（冲红冲蓝） └ invoicePrice Number 4000 开票金额 └ invoiceLink String https://xxx.com/invoice.png 发票链接 orderLog OrderLog [] 订单日志 └ holdTime String 30分钟状态持续时间 └ deliveryStatus String 配送中配送状态 └ orderStatus String 处理中订单状态 └ orderTime String 2022-10-20 18:26:53 时间 └ riderCompanyName String 顺丰配送渠道 └ riderPhone String 100212121 骑手电话 └ riderName String 张三骑手姓名 complaintList Complaint [] 投诉催单 └ feedbackChannel String 投诉渠道反馈渠道 └ synchronizeStore String 123门店同步门店 └ feedbackContent String 门店找不到反馈内容 └ feedbackType String 投诉门店反馈类型 └ feedbackTime String 2022-10-20 18:26:53 反馈时间 refundRecordList RefundRecord [] 退款记录 └ dealTime String 2022-10-20 18:26:53 处理时间 └ refundPriceMerchant String 1.0 商家承担金额 └ refundGoods String 咖啡退款餐品 └ refundType String 全额退款退款类型 └ refundReason String 买错了退款原因 └ refundStatus String 退款成功退款状态

{"foreignId":"L1i29fooe194ad","orderId":"2022918831918282912"}

{
    "msgCode":200,
    "errorSubCode":"order-service-error",
    "errorSubMessage":"订单服务异常",
    "result":{
        "orderInfo":{
            "orderId":"20223939182819283912",
            "packagePrice":1000,
            "pickupId":"456",
            "isPlatform":"是",
            "platformType":"78",
            "merchantRemark":"速度要快",
            "customerRemark":"不要餐具",
            "thirdSerialId":"12",
            "thirdOrderId":"11",
            "systemSerialId":"23",
            "systemOrderId":"220127140832308749",
            "refundAmount":"1000",
            "warningMessage":"退款异常",
            "totalRefundAmount":"40000",
            "totalPackageAmount":"300",
            "totalOfflineAmount":"10000",
            "totalDeliveryAmount":"100000",
            "storeNo":"10012112",
            "canInvoiceAmount":"1000",
            "orderType":"2",
            "orderStatus":"1",
            "price":3000,
            "realPrice":2000,
            "discountPrice":2500,
            "merchPrice":1500,
            "deliveryPrice":1000,
            "payDetail":"{'a': 1, 'b': 2}",
            "payId":"20223939381839193",
            "payChannel":"ALIPAY",
            "orderChannel":"ALIPAY-MINIAPP",
            "discountItemList":[
                {
                        "itemName":"满5-1",
                        "itemPrice":1000
                }
            ],
            "cancelStatus":false,
            "orderModelType":"1",
            "cancelSide":"CUSTOMER",
            "orderCreateDate":"2021-12-31 14:00:00",
            "cancelReason":"不想要了",
            "memberLevel":"大咖",
            "memberPhone":"139xxxxxxxx",
            "nickname":"张三",
            "expectMakingTime":"2021-02-11 12:00:11",
            "expectDeliverTime":"2021-02-11 12:50:11",
            "orderScore":12,
            "timeline":[
                {
                        "status":"1",
                        "statusTime":"2021-02-11 12:50:11"
                }
            ]
        },
        "comboInfoList":[
            {
                    "comboId":"394819",
                    "comboPrice":5000,
                    "comboDiscountPrice":3000,
                    "merchInfoList":[
                        {
                                "merchId":"9184919922",
                                "merchName":"拿铁",
                                "merchPhoto":"https:\/\/xxx.com\/merch.png",
                                "merchSpecs":"大杯",
                                "merchPrice":2300,
                                "merchDiscountPrice":2100,
                                "merchCount":3,
                                "perCouponPrice":20,
                                "merchAttrList":[
                                    {
                                            "name":"加奶x2",
                                            "price":100,
                                            "extraData":"{'a': 1, 'b': 2}"
                                    }
                                ]
                        }
                    ]
            }
        ],
        "merchInfoList":[
            {
                    "merchId":"9184919922",
                    "merchName":"拿铁",
                    "merchPhoto":"https:\/\/xxx.com\/merch.png",
                    "merchSpecs":"大杯",
                    "merchPrice":2300,
                    "merchDiscountPrice":2100,
                    "merchCount":3,
                    "perCouponPrice":20,
                    "merchAttrList":[
                        {
                                "name":"加奶x2",
                                "price":100,
                                "extraData":"{'a': 1, 'b': 2}"
                        }
                    ]
            }
        ],
        "storeInfo":{
            "storeId":"2039932",
            "storeType":"Level-1",
            "storeName":"阿里巴巴A区店",
            "storePhone":"0571-8xxxxxxxx",
            "storeManPhone":"133xxxxxxxx"
        },
        "deliveryInfo":{
            "deliveryId":"20339192829182991",
            "logisticsId":"201111919282",
            "riderStatus":"配送中",
            "deliveryChannel":"SF",
            "consigneeName":"张三",
            "consigneePhone":"133xxxxxxxx",
            "consigneeAddress":"xx市xx区xx小区xx号101室",
            "courierId":"1923889182",
            "courierName":"李四",
            "courierPhone":"133xxxxxxxx",
            "deliveryITotalDistance":1300,
            "deliveryILastDistance":200,
            "preDeliveryTime":1000,
            "deliveryTime":400,
            "deliveryLastTime":400,
            "courierLong":"133.2222",
            "courierLati":"33.2222"
        },
        "invoiceInfo":{
            "isInvoice":true,
            "invoiceTime":"2021-02-22 12:45:11",
            "invoiceType":"ONLINE",
            "invoiceStatus":"VAILD",
            "invoicePrice":4000,
            "invoiceLink":"https:\/\/xxx.com\/invoice.png"
        },
        "orderLog":[
            {
                    "holdTime":"30分钟",
                    "deliveryStatus":"配送中",
                    "orderStatus":"处理中",
                    "orderTime":"2022-10-20 18:26:53",
                    "riderCompanyName":"顺丰",
                    "riderPhone":"100212121",
                    "riderName":"张三"
            }
        ],
        "complaintList":[
            {
                    "feedbackChannel":"投诉渠道",
                    "synchronizeStore":"123门店",
                    "feedbackContent":"门店找不到",
                    "feedbackType":"投诉门店",
                    "feedbackTime":"2022-10-20 18:26:53"
            }
        ],
        "refundRecordList":[
            {
                    "dealTime":"2022-10-20 18:26:53",
                    "refundPriceMerchant":"1.0",
                    "refundGoods":"咖啡",
                    "refundType":"全额退款",
                    "refundReason":"买错了",
                    "refundStatus":"退款成功"
            }
        ]
    }
}

{"errorSubCode":"sign-check-failure","errorSubMessage":"Illegal request","msgCode":"不等于200"}

错误码	错误描述	解决方案
isp.http-read-timeout

错误码查询工具 SDK下载

XSPACE餐饮行业服务API

qimen.alibaba.cco.xspace.catering.deliveryorder.detail.get (XSpace工作台获取餐饮外卖订单详情接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ