淘宝开放平台

请求地址：

环境	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	必须	100212121		主订单ID

名称	类型	示例值	描述
result	Result		业务接口响应结果
└ discountTotalAmt String 100 订单总优惠金额 discountList DiscountList [] 订单优惠项 └ discountAmt String 100 折扣金额 └ discountDesc String tims咖啡折扣描述 └ orderType Number 1 订单类型 1 外送（外卖） 2 外带（自取） 3 堂食 └ orderTime Number 167122121111 下单时间 └ orderId String 1002332132 订单id └ orderTotalAmt String 10000 订单总金额 └ posNo String 12 取餐号 subOrderList SubOrderList [] 子订单列表 └ skuName String tims咖啡商品名称 └ realPriceAmt String 16.5 商品金额 └ quantity Number 2 商品数量 └ finalAmt String 15 商品实付金额 └ refundUpperLimitAmt String 3.5 子订单可退总额 └ parentGuid String 1003134 如果是套餐子项，所属套餐头的子订单id └ guid String 101212121 子订单id childSubOrderList ChildSubOrderList [] 套餐子项-子订单列表 └ skuName String 奶油洽洽商品名称 └ realPriceAmt String 2 商品金额 └ quantity Number 5 商品数量 └ finalAmt String 8 商品实付金额 └ refundUpperLimitAmt String 6 子订单可退总额 └ parentGuid String 120021 如果是套餐子项，所属套餐头的子订单id └ guid String 1212112 子订单id subOrderModifyList SubOrderModifyList [] 子订单加料信息 └ unitPrice String 2 加料单价 └ modifyDesc String 糖心加料名称 └ modifyPlu String tx 加料code └ modifyAmt String 6 加料总金额 └ modifyQty Number 3 加料数量 └ skuId String twss 商品skuCode └ status Number 1 子订单状态未退单=1 退单成功=97 退单失败=98 subOrderModifyList SubOrderModifyList [] 子订单加料信息 └ unitPrice String 20 加料单价 └ modifyDesc String 芝麻加料名称 └ modifyPlu String zmmm 加料code └ modifyAmt String 20 加料总金额 └ modifyQty Number 1 加料数量 └ skuId String sree 商品skuCode └ status Number 1 子订单状态未退单=1 退单成功=97 退单失败=98 └ orderNetAmt String 10000 用户实付金额 └ cardNo String string 会员号 paymentList PaymentList [] 订单支付项 └ paymentAmt String 100 支付金额 └ paymentDesc String 现金支付支付描述
msgCode	String	200	返回错误码，和http status保持概念相同
errorMessage	String	系统异常	错误秒速
errorSubCode	String	10001	子错误码
errorSubMessage	String	参数为空	具体错误描述

{"orderId":"100212121"}

{
    "result":{
        "discountTotalAmt":"100",
        "discountList":[
            {
                    "discountAmt":"100",
                    "discountDesc":"tims咖啡"
            }
        ],
        "orderType":1,
        "orderTime":167122121111,
        "orderId":"1002332132",
        "orderTotalAmt":"10000",
        "posNo":"12",
        "subOrderList":[
            {
                    "skuName":"tims咖啡",
                    "realPriceAmt":"16.5",
                    "quantity":2,
                    "finalAmt":"15",
                    "refundUpperLimitAmt":"3.5",
                    "parentGuid":"1003134",
                    "guid":"101212121",
                    "childSubOrderList":[
                        {
                                "skuName":"奶油洽洽",
                                "realPriceAmt":"2",
                                "quantity":5,
                                "finalAmt":"8",
                                "refundUpperLimitAmt":"6",
                                "parentGuid":"120021",
                                "guid":"1212112",
                                "subOrderModifyList":[
                                    {
                                            "unitPrice":"2",
                                            "modifyDesc":"糖心",
                                            "modifyPlu":"tx",
                                            "modifyAmt":"6",
                                            "modifyQty":3
                                    }
                                ],
                                "skuId":"twss",
                                "status":1
                        }
                    ],
                    "subOrderModifyList":[
                        {
                                "unitPrice":"20",
                                "modifyDesc":"芝麻",
                                "modifyPlu":"zmmm",
                                "modifyAmt":"20",
                                "modifyQty":1
                        }
                    ],
                    "skuId":"sree",
                    "status":1
            }
        ],
        "orderNetAmt":"10000",
        "cardNo":"string",
        "paymentList":[
            {
                    "paymentAmt":"100",
                    "paymentDesc":"现金支付"
            }
        ]
    },
    "msgCode":"200",
    "errorMessage":"系统异常",
    "errorSubCode":"10001",
    "errorSubMessage":"参数为空"
}

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

错误码	错误描述	解决方案

错误码查询工具 SDK下载

XSPACE餐饮行业服务API

qimen.alibaba.cco.xspace.catering.partialrefund.suborderlist.get (获取tims主订单下的子订单列表详细信息)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ