文档中心 > API类目 > 淘宝物流API

qimen.taobao.logistics.urgent.delivery.notify (ERP商家加急发货通知接口)

加急发货通知接口

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
trade_order_code	String	必须	T20230801123456		主交易单号
shop_id	String	必须	SHOP_1001		商家唯一标识
service_tags	String []	必须		最大列表长度：999999	服务标签
service_reason	String	必须	消费者退货保修		服务原因
service_codes	String []	必须		最大列表长度：999999	服务编码
shop_name	String	必须	店铺名称xxxx		店铺名称

响应参数

名称	类型	示例值	描述
result	Result		催发指定返回结果
└ flag String success 是否成功 └ code Number 0 业务码 urgent_delivery_notify_response UrgentDeliveryNotifyResponse 催发指令响应结果 └ is_split Boolean true 是否拆单 order_details OrderDetails [] 子交易单对象 └ item_id String ITEM_001 商品id └ sub_trade_order_status String WAREHOUSE_PENDING 子交易单状态 └ sub_trade_order_code String ST20230801123456A 子交易单号 └ status_update_time String 2023-08-01 14:30:00 子交易单状态更新时间 └ estimated_delivery_time String 2023-08-01 14:30:00 预计发货时间 └ exception_reason String 缺货异常原因 └ success Boolean true 是否成功 └ order_status String WAREHOUSE_PENDING 主交易单状态 └ trade_order_code String T20230801123456 主交易单号 └ status_update_time String 2023-08-01 14:30:00 主交易单状态更新时间 └ retry Boolean false 是否需要重试 └ estimated_delivery_time String 2023-08-01 14:30:00 预计送达时间 └ exception_reason String 缺货异常原因 └ message String 操作成功操作信息

请求示例

{"trade_order_code":"T20230801123456","shop_id":"SHOP_1001","service_tags":[""],"service_reason":"消费者退货保修","shop_name":"店铺名称xxxx","service_codes":[""]}

响应示例

{
    "result":{
        "flag":"success",
        "code":0,
        "urgent_delivery_notify_response":{
            "is_split":true,
            "order_details":[
                {
                        "item_id":"ITEM_001",
                        "sub_trade_order_status":"WAREHOUSE_PENDING",
                        "sub_trade_order_code":"ST20230801123456A",
                        "status_update_time":"2023-08-01 14:30:00",
                        "estimated_delivery_time":"2023-08-01 14:30:00",
                        "exception_reason":"缺货"
                }
            ],
            "success":true,
            "order_status":"WAREHOUSE_PENDING",
            "trade_order_code":"T20230801123456",
            "status_update_time":"2023-08-01 14:30:00",
            "retry":false,
            "estimated_delivery_time":"2023-08-01 14:30:00",
            "exception_reason":"缺货"
        },
        "message":"操作成功"
    }
}

验签示例

{"result":{"code":"sign-check-failure","urgentDeliveryNotifyResponse":{"success":"false"},"message":"Illegal request"}}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部