更改登记错误的运单号。
更改后的运单配送状态为 待配送(DEPARTURE),之后可能会根据物流跟踪信息发生变化。
<注意!>此接口只能更新 CGF LITE 订单的物流运单号。自发货订单物流运单号更新请转到此页面对接。 只有订单在配送状态为 待配送(DEPARTURE)及卖家直接配送(NONE_TRACKING) 时,才可以更改运单信息。 (其余订单状态发生错误).
路径
POST
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/orders/global/updateInvoices
示例
请求参数
Name |
Required |
Type |
Description |
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g. C00012345 |
请求体参数
Name |
Required |
Type |
Description |
|
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g. C00012345 |
|
orderSheetInvoiceApplyDtos |
O |
Array |
要变更为待配送状态的信息列表 |
|
|
shipmentBoxId |
O |
Number |
配送号码(合并配送号码) |
|
orderId |
O |
Number |
订单号 |
|
deliveryCompanyCode |
O |
String |
快递公司代码 请务必注意输入正确的公司代码,此参数为空或格式错误均会引起报错! |
|
invoiceNumber |
O |
String |
物流运单号 卖家直接配送(DIRECT)时可输入任意数字,因其不支持物流跟踪。 |
请求体示例
{
"vendorId": "C00012345",
"orderSheetInvoiceApplyDtos": [
{
"shipmentBoxId": 4037219645,
"orderId": 11000154200196,
"deliveryCompanyCode": "sf_express",
"invoiceNumber": "SF1152738062699"
},
{
"shipmentBoxId": 4037004312,
"orderId": 11000154200196,
"deliveryCompanyCode": "sf_express",
"invoiceNumber": "SF1152738062699"
}
]
}
返回消息
名称 | 数据类型 | 描述 | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
code | Number |
服务器返回代码
|
||||||||||||||||||||||||||||||||||
message | String |
服务器返回消息
|
||||||||||||||||||||||||||||||||||
data | Object |
|
||||||||||||||||||||||||||||||||||
responseCode | Number |
请求结果状态码
|
||||||||||||||||||||||||||||||||||
responseMessage | String |
请求结果状态消息
|
||||||||||||||||||||||||||||||||||
responseList | Array |
单个上传结果集
|
||||||||||||||||||||||||||||||||||
shipmentBoxId | Number |
合并配送号码
|
||||||||||||||||||||||||||||||||||
data | String |
Result code
|
||||||||||||||||||||||||||||||||||
comment | String |
错误信息
|
返回消息示例
{
"code": 200,
"message": "OK",
"data": {
"responseCode": 1,
"responseMessage": "SUCCESS",
"responseList": [
{
"shipmentBoxId": 4037219645,
"data": "OK",
"comment": null
},
{
"shipmentBoxId": 4037004312,
"data": "OK",
"comment": null
}
]
}
}
错误代码
HTTP 状态码 (错误类型) |
错误消息 |
解决方法 |
400 (check request variable) |
无效物流公司代码: |
查看是否输入了正确的物流公司代码(deliveryCompanyCode). |
URL API Name
GLOBAL_UPDATE_ORDER_INVOICE