更改登记错误的三方运送订单的运单号。 CGF lite 订单更新运单号请查看此页面。
更改后的运单配送状态为 待配送(DEPARTURE),之后可能会根据物流跟踪信息发生变化。
<注意!> 只有订单在配送状态为 待配送(DEPARTURE)、配送中(DELIVERING)、配送完成(FINAL_DELIVERY)及卖家直接配送(NONE_TRACKING) 时,才可以更改运单信息。 (其余订单状态发生错误)。
路径
POST
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/orders/updateInvoices
示例
请求参数
名称 |
必须 |
数据类型 |
描述 |
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g.A00012345 |
请求体参数
名称 |
必须 |
数据类型 |
描述 |
|
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
|
orderSheetInvoiceApplyDtos |
O |
Object |
要变更为待配送状态的信息列表 |
|
|
shipmentBoxId |
O |
Number |
合并配送号码 |
|
orderId |
O |
Number |
订单号 |
|
deliveryCompanyCode |
O |
String |
要变更的快递公司代码 |
|
invoiceNumber |
O |
String |
要变更的运单号 |
|
vendorItemId |
O |
Number |
属性ID 输入要更新运单的商品的属性ID. |
|
splitShipping |
O |
Boolean |
是否为分开配送
一个订单号中包含的所有商品都发送同一运单号
包含在一个订单号中的商品被分开发送多个运单号 |
|
preSplitShipped |
O |
Boolean |
是否为分开配送中 ● false 不进行分开配送时(= 当 splitshipping 为 false 时) 该订单号首次进行分开配送时 ● true 该订单号中已有分开配送的商品 |
|
estimatedShippingDate |
O |
String |
(分开配送) 预计发货日 仅在以 YYYY-MM-DD 格式分开配送时可选择性输入。 如果不输入,则保留“”空白。 分开配送时,运单号或预计发货日两者择一输入
|
请求体示例
{
"vendorId": "A00012345",
"orderSheetInvoiceApplyDtos": [
{
"shipmentBoxId": 123456789012345678,
"orderId": 2000019631453,
"vendorItemId": 3819657333,
"deliveryCompanyCode": "KDEXP",
"invoiceNumber": 201808231414,
"splitShipping": "False",
"preSplitShipped": "False",
"estimatedShippingDate": ""
}
]
}
返回消息
名称 | 数据类型 | 描述 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
code | Number |
服务器返回代码
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
message | String |
服务器返回消息
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data | Array |
数据
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
responseCode | Number |
请求结果状态码
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
responseMessage | String |
请求结果状态消息
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
responseList | Array |
单个上传结果集
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
shipmentBoxId | Number |
合并配送号码
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
succeed | Boolean |
是否成功 Y/N
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resultCode | String |
Result code
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resultMessage | String |
请求结果消息
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
retryRequired | Boolean |
重试 Y/N
|
返回消息示例
{
"code": 200,
"message": "OK",
"data": {
"responseCode": 0,
"responseMessage": "SUCCESS",
"responseList": [
{
"shipmentBoxId": 123456789012345678,
"succeed": true,
"resultCode": "OK",
"retryRequired": false,
"resultMessage": null
}
]
}
}
错误代码
HTTP 状态码 (错误类型) |
错误消息 |
解决方法 |
400 (check request variable) |
运单号格式不符合CJ 物流. [6255*****632] |
查看是否输入了正确的运单号。 |
400 (check request variable) |
CJ物流的运单号只由数字组成。 InvoiceNumber 必须是数字。 [6257-6**2-10***] |
查看是否输入了正确的运单号,运单号中是否包含除数字以外的其它字符。 |
400 (check request variable) |
卖家直接配送的运单号必须由数字组成。[***] |
卖家直接配送(DIRECT)的运单号由数字组成。 e.g.202002031830 |
400 (check request variable) |
无效物流公司代码: |
查看是否输入了正确的物流公司代码(deliveryCompanyCode). |
400 (check request variable) |
运单号格式不符合OO物流. [956****734] |
查看是否输入了正确的运单号。 |
接口名称
UPDATE_ORDER_INVOICE