上传运单，将订单状态变为待配送状态。
运单上传仅适用于处于商品准备中状态的三方运送订单。 CGF lite 订单上传运单号请查看此页面。
如需要分开配送，请参阅FAQ 了解运单上传的示例。
如果在 6 个月内有输入重复的运单号码，可能会出现运单重复错误。输入了错误的运单无法跟踪到正确的物流情况，或顾客因卖家未在时限内输入运单而要求取消订单，由此产生的运费由卖家承担。
路径
POST
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/orders/invoices
示例
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/orders/invoices
请求参数
|
Name |
|
Required |
Type |
Description |
|
vendorId |
O |
|
String |
卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
请求体参数
|
Name |
Required |
Type |
Description |
|
|
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
|
|
orderSheetInvoiceApplyDtos |
O |
Object |
要变更为待配送状态的信息列表 |
|
|
|
shipmentBoxId |
O |
Number |
配送号码(=捆绑配送号码) 分开配送时，已发送的商品的shipmentBoxId会变更。 (调用单笔订单查询API，使用orderId来确认) |
|
|
orderId |
O |
Number |
订单号 |
|
|
deliveryCompanyCode |
O |
String |
快递公司代码 请务必注意输入正确的公司代码，此参数为空或格式错误均会引起报错！ |
|
|
invoiceNumber |
O |
String |
运单号 分开配送时选择，不输入或保留“”空白。 分开配送时，运单号或预计发货日两者择一输入。 卖家直接配送(DIRECT)时可输入任意数字，因其不支持物流跟踪。 |
|
|
vendorItemId |
O |
Number |
属性ID 输入要更新运单的商品属性ID. 分开配送时，要按照该shipmentBoxId的vendorItemId为单位受理。 |
|
|
splitShipping |
O |
Boolean |
是否为分开配送
一个订单号中包含的所有商品都发送同一运单号
|
|
|
preSplitShipped |
O |
Boolean |
是否为分开配送中 ● false 不进行分开配送时（= 当 splitshipping 为 false 时） 该订单号首次进行分开配送时 ● true 该订单号中已有分开配送的商品 |
|
|
estimatedShippingDate |
O |
String |
(分开配送) 预计发货日 仅在以 YYYY-MM-DD 格式分开配送时可选择性输入。 如果不输入，则保留“”空白。 分开配送时，运单号或预计发货日两者择一输入 |
请求体示例
{
"vendorId": "A00034612",
"orderSheetInvoiceApplyDtos": [
{
"shipmentBoxId": 123456789012345678,
"orderId": 4000019469460,
"vendorItemId": 3823839899,
"deliveryCompanyCode": "KDEXP",
"invoiceNumber": "20180731040123",
"splitShipping": false,
"preSplitShipped": false,
"estimatedShippingDate": ""
},
{
"shipmentBoxId": 123456789012345679,
"orderId": 4000019469460,
"vendorItemId": 3834780191,
"deliveryCompanyCode": "KDEXP",
"invoiceNumber": "20180731040123",
"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_SHIPPING_INFO