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

qimen.taobao.logistics.express.service.update (派件要求更新接口)

淘天物流根据消费者的诉求，更新服务要求

公共参数

请求地址：

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

请求参数

名称	类型	是否必须	示例值	更多限制	描述
service_type	String	必须	1		服务类型（1-送货上门；2-放指定驿站；21-选时达）
update_type	String	必须	1		更新服务类型（1-送货上门；2-放代收点；99-需要电联）
biz_code	String	必须	1234567		业务单号
supplier_id	String	必须	100000001		服务商ID
cp_code	String	可选	XXX		服务商资源编码
delivery_code	String	可选	XXX		服务商配资源唯一编码
mail_no	String	必须	1234567		包裹运单号
delivery_date	String	可选	XXXX		服务日期
delivery_time_range	String	可选	XXXX		服务时间范围
site_id	String	可选	XXXX		驿站ID
site_name	String	可选	XXXX		驿站名称
site_address	String	可选	XXXX		驿站地址
remark	String	可选	XXXX		备注
version	String	可选	1710750165		时间戳
preference	PreferenceDO	可选			扩展属性
└ default_preference String 可选 1 兜底偏好(1-联系不上放代收2-联系不上放门口3-无人签收放门口，空的情况直接下发) └ phone_call_preference String 可选 1 电联偏好(1-需电联2-无需电联，空的情况直接下发)
phone_call_type	String	可选	99		电联要求（98-禁止电联；99-需要平台电联；100-需要小件员人工电联）
feature	FeatureDO	可选			拓展属性
└ extra_protect_flag String 可选 1 重保 └ instant_delivery_flag String 可选 1 及时送达 └ yztp_source String 可选 1 驿站退坡下发来源（1-物流部规则/2-CCO创建）
requirements	ServiceRequirement []	可选		最大列表长度：100	服务要求
└ finish_time String 可选 2020-06-02 12:00:00 要求完成时间 └ content String 可选 DELIVERY_INSTANT 要求内容（DELIVERY_INSTANT 及时派送， SIGN_IN_PERSON 本人签收，SIGN_PHOTO 签收拍照片） └ action String 可选 DELIVERY 操作节点(DELIVERY 派送 SIGN 签收)
item_list	ItemsDO []	可选		最大列表长度：100	商品明细
└ trade_id String 可选 232323 交易单号 └ consign_time String 可选 2024-12-13 12:00:00 发货时间 └ item_name String 可选 XX牌衣服商品名称 └ leaf_category_name String 可选衣服类目名称 feature ItemFeatureDO 可选商品属性 └ is_replenish String 可选 1 是否补发 └ alg_weight String 可选 33 预估重量，单位 g
quality_detail	QualityDetailDO	可选			服务质检详情
└ quailty_unpass_reason String 可选 1,2,3 质检未通过项明细（逗号分隔） └ quailty_result String 可选 1 服务质检最终结果(1-通过/0-不通过)

响应参数

名称	类型	示例值	描述
success	String	true	系统成功失败 true\|false
error_code	String	10002	响应码
error_message	String	系统异常	响应信息
is_retry	Boolean	true	是否可重试
data	DataDO		业务处理结果
└ bizCode String 123456 唯一标识单号（送货上门订单号）

请求示例

{"update_type":"1","requirements":[{"action":"DELIVERY","finish_time":"2020-06-02 12:00:00","content":"DELIVERY_INSTANT"}],"biz_code":"1234567","preference":{"default_preference":"1","phone_call_preference":"1"},"remark":"XXXX","quality_detail":{"quailty_unpass_reason":"1,2,3","quailty_result":"1"},"version":"1710750165","cp_code":"XXX","mail_no":"1234567","site_name":"XXXX","service_type":"1","delivery_date":"XXXX","delivery_code":"XXX","site_address":"XXXX","feature":{"extra_protect_flag":"1","yztp_source":"1","instant_delivery_flag":"1"},"phone_call_type":"99","item_list":[{"consign_time":"2024-12-13 12:00:00","trade_id":"232323","leaf_category_name":"衣服","feature":{"is_replenish":"1","alg_weight":"33"},"item_name":"XX牌衣服"}],"site_id":"XXXX","delivery_time_range":"XXXX","supplier_id":"100000001"}

响应示例

{
    "success":"true",
    "error_code":"10002",
    "error_message":"系统异常",
    "is_retry":true,
    "data":{
        "bizCode":"123456"
    }
}

验签示例

{"error_message":"Illegal request","success":"false","error_code":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部