订单发货

POST

/ark/open_api/v3/common_controller

	错误码	错误码描述
	-2000101	包裹不存在
	-2000201	包裹数据异常
	-2000202	包裹状态错误
	-2000301	更新包裹状态失败
	-2000302	更新订单包裹状态失败
	-2000303	更新包裹失败
	-2000400	参数异常
	-2000500	系统调用异常
	-2000502	业务验证异常
	-2000203	包裹已停止履约(查看是否有取消申请)

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \
--header 'Content-Type: application/json;charset=utf-8' \
--data-raw '{
    "orderId": "P032***1421",
    "expressNo": "1074****2048",
    "expressCompanyCode": "zto",
    "expressCompanyName": "中通",
    "deliveringTime": 1612341639394,
    "unpack": true,
    "skuIdList": [
        "string"
    ]
}'

响应示例

{
  "error_code": 1,
  "data": "",
  "success": true
}

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

orderId

string

订单号

必需

expressNo

string

必需

快递单号（如使用的是无物流发货，expressNo为发货内容）

expressCompanyCode

string

必需

快递公司编码（如使用无物流发货，expressCompanyCode为selfdelivery）

expressCompanyName

string

可选

快递公司名称(如传入，则以传入为准，如未传入，则根据expressCompanyCode进行匹配)

deliveringTime

integer

可选

发货时间不传默认当前时间（ms）

unpack

boolean

可选

是否拆包发货 true 拆包发货 false正常发货

skuIdList

array[string]

拆包发货时必填

可选

示例

返回响应

🟢200成功

application/json

Body

error_code

integer

错误码

必需

data

string

返回信息

必需

success

boolean

是否成功

必需

修改于 2023-08-01 06:03:40

修改订单备注

修改快递单号