coupang
API 文档
商品 API品类 API品牌 API运输 / 订单 API退货 API换货 API促销 / 优惠券物流信息客服 / 咨询结算CGF / CGF liteRocket Growth
POST/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/orders/invoices2609170000

上传运单号

# 01

简介

上传运单号

# 02

详细内容

API支持的买家用户地区：韩国

上传运单，将订单状态变为待配送状态。

运单上传仅适用于处于商品准备中状态的三方运送订单。 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
# 03

Path 参数

NameTypeDescription
vendorId*object
卖家ID

酷澎分配给卖家的固有代码

e.g. A00012345
# 04

请求体参数

请求参数

请求体参数

NameTypeDescription
vendorId*string
卖家ID

酷澎分配给卖家的固有代码

e.g. A00012345
orderSheetInvoiceApplyDtos*object[]
要变更为待配送状态的信息列表
shipmentBoxId*
orderSheetInvoiceApplyDtos[].shipmentBoxId
integer
配送号码(=捆绑配送号码)

分开配送时，已发送的商品的shipmentBoxId会变更。 (调用单笔订单查询API，使用orderId来确认)
orderId*
orderSheetInvoiceApplyDtos[].orderId
integer
订单号
deliveryCompanyCode*
orderSheetInvoiceApplyDtos[].deliveryCompanyCode
string
快递公司代码

请务必注意输入正确的公司代码，此参数为空或格式错误均会引起报错！

跳转至快递公司代码
invoiceNumber*
orderSheetInvoiceApplyDtos[].invoiceNumber
string
运单号

分开配送时选择，不输入或保留“”空白。

分开配送时，运单号或预计发货日两者择一输入。

卖家直接配送(DIRECT)时可输入任意数字，因其不支持物流跟踪。
vendorItemId*
orderSheetInvoiceApplyDtos[].vendorItemId
integer
属性ID

输入要更新运单的商品属性ID.

分开配送时，要按照该shipmentBoxId的vendorItemId为单位受理。
splitShipping*
orderSheetInvoiceApplyDtos[].splitShipping
boolean
是否为分开配送
  • false (整体配送)
一个订单号中包含的所有商品都发送同一运单号
preSplitShipped*
orderSheetInvoiceApplyDtos[].preSplitShipped
boolean
是否为分开配送中

● false

不进行分开配送时（= 当 splitshipping 为 false 时）

该订单号首次进行分开配送时

● true

该订单号中已有分开配送的商品
estimatedShippingDate*
orderSheetInvoiceApplyDtos[].estimatedShippingDate
string
(分开配送) 预计发货日

仅在以 YYYY-MM-DD 格式分开配送时可选择性输入。

如果不输入，则保留“”空白。

分开配送时，运单号或预计发货日两者择一输入
codestring
服务器返回代码
messagestring
服务器返回消息
dataobject
responseCode
data.responseCode
string
请求结果状态码
状态码 消息 备注
-1 NONE 无结果
0 SUCCESS 成功
1 PARTIAL_ERROR 部分失败
99 FAILED 失败
responseMessage
data.responseMessage
string
请求结果状态消息
responseList
data.responseList
string
单个上传结果集
shipmentBoxId
data.responseList.shipmentBoxId
string
合并配送号码
succeed
data.responseList.succeed
string
是否成功 Y/N
resultCode
data.responseList.resultCode
number
Result code
code retry required remark
OK false 成功
NOT_FOUND_SHIPMENT_BOX false 合并配送号码不存在
INVALID_STATUS false 订单状态不正确
PERMISSION_DENIED true 无权限更新此订单
DUPLICATE_INVOICE_NUMBER true 运单号已存在
INVALID_INVOICE_NUMBER true 运单号格式不正确
ORDER_DELIVERY_CANCELED false 订单已经取消或者已经申请了暂停发货
ORDER_DELIVERY_PARTIAL_STOP_REQUESTED true 已经申请了暂停发货
ORDER_DELIVERY_CANCELED_HOLDING_FOR_CANCEL true 订单正在被取消
UNDEFINED_ERROR_OCCUR true 未知错误
NOT_ALLOW_INVOICE_NUMBER_RE_UPLOAD false 此运单号已存在，不能上传。 (场景：同一个运单号重复上传到同一个订单中)
NOT_FOUND_INVOICE_NUMBER false 预计运送时间已经填写，请填写运单号
NOT_FOUND_VENDOR_ITEM false 产品单项代码缺失
NOT_ALLOW_VENDOR_DIRECT false 自配送订单不能被拆分运送
PSD_NOT_ALLOW_TO_CHANGE false 一旦上传了预计运送时间，就不能更改
NOT_ALLOW_SEPARATE_AFTER_NORMAL_DELIVERY false 上传合并发货运单号之后不能申请分开发货
IS_SEPARATE_MUST_BE_TRUE_WHEN_SEPARATE_DELIVERY false 申请分开发货之后不能再合并发货
NOT_ALLOW_SEPARATE_WHEN_ONE_VENDOR_ITEM false 一件商品不能分开发货
resultMessage
data.responseList.resultMessage
string
请求结果消息
retryRequired
data.responseList.retryRequired
string
重试 Y/N
400 (check request variable)string
查看是否输入了正确的运单号。
请求示例application/json
{
  "vendorId": "A00034612",
  "orderSheetInvoiceApplyDtos": [
    {
      "shipmentBoxId": 123456789012345680,
      "orderId": 4000019469460,
      "vendorItemId": 3823839899,
      "deliveryCompanyCode": "KDEXP",
      "invoiceNumber": "20180731040123",
      "splitShipping": false,
      "preSplitShipped": false,
      "estimatedShippingDate": ""
    },
    {
      "shipmentBoxId": 123456789012345680,
      "orderId": 4000019469460,
      "vendorItemId": 3834780191,
      "deliveryCompanyCode": "KDEXP",
      "invoiceNumber": "20180731040123",
      "splitShipping": false,
      "preSplitShipped": false,
      "estimatedShippingDate": ""
    }
  ]
}
# 05

响应体

响应消息

NameTypeDescription
codestring
服务器返回代码
messagestring
服务器返回消息
dataobject
responseCode
data.responseCode
integer
请求结果状态码
状态码 消息 备注
-1 NONE 无结果
0 SUCCESS 成功
1 PARTIAL_ERROR 部分失败
99 FAILED 失败
responseMessage
data.responseMessage
string
请求结果状态消息
responseList
data.responseList
object[]
单个上传结果集
shipmentBoxId
data.responseList[].shipmentBoxId
integer
合并配送号码
succeed
data.responseList[].succeed
boolean
是否成功 Y/N
resultCode
data.responseList[].resultCode
string
Result code
code retry required remark
OK false 成功
NOT_FOUND_SHIPMENT_BOX false 合并配送号码不存在
INVALID_STATUS false 订单状态不正确
PERMISSION_DENIED true 无权限更新此订单
DUPLICATE_INVOICE_NUMBER true 运单号已存在
INVALID_INVOICE_NUMBER true 运单号格式不正确
ORDER_DELIVERY_CANCELED false 订单已经取消或者已经申请了暂停发货
ORDER_DELIVERY_PARTIAL_STOP_REQUESTED true 已经申请了暂停发货
ORDER_DELIVERY_CANCELED_HOLDING_FOR_CANCEL true 订单正在被取消
UNDEFINED_ERROR_OCCUR true 未知错误
NOT_ALLOW_INVOICE_NUMBER_RE_UPLOAD false 此运单号已存在，不能上传。 (场景：同一个运单号重复上传到同一个订单中)
NOT_FOUND_INVOICE_NUMBER false 预计运送时间已经填写，请填写运单号
NOT_FOUND_VENDOR_ITEM false 产品单项代码缺失
NOT_ALLOW_VENDOR_DIRECT false 自配送订单不能被拆分运送
PSD_NOT_ALLOW_TO_CHANGE false 一旦上传了预计运送时间，就不能更改
NOT_ALLOW_SEPARATE_AFTER_NORMAL_DELIVERY false 上传合并发货运单号之后不能申请分开发货
IS_SEPARATE_MUST_BE_TRUE_WHEN_SEPARATE_DELIVERY false 申请分开发货之后不能再合并发货
NOT_ALLOW_SEPARATE_WHEN_ONE_VENDOR_ITEM false 一件商品不能分开发货
retryRequired
data.responseList[].retryRequired
boolean
重试 Y/N
resultMessage
data.responseList[].resultMessage
string
请求结果消息

Response Example

{
  "code": "200",
  "message": "OK",
  "data": {
    "responseCode": 0,
    "responseMessage": "SUCCESS",
    "responseList": [
      {
        "shipmentBoxId": 123456789012345680,
        "succeed": true,
        "resultCode": "OK",
        "retryRequired": false,
        "resultMessage": null
      }
    ]
  }
}
# 06

错误码

HTTP代码消息
400HTTP_400Bad Request

错误说明

HTTP类型错误消息解决方案
400400 (check request variable)

运单号格式不符合CJ 物流.

[6255*****632]

查看是否输入了正确的运单号。

400400 (check request variable)

CJ物流的运单号只由数字组成。 InvoiceNumber 必须是数字.

[6257-62-10*]

查看是否输入了正确的运单号，运单号中是否包含除数字以外的其它字符。

400400 (check request variable)

卖家直接配送的运单号必须由数字组成。[***]

卖家直接配送(DIRECT)的运单号由数字组成。

e.g.202002031830

400400 (check request variable)

无效物流公司代码:

查看是否输入了正确的物流公司代码(deliveryCompanyCode).

400400 (check request variable)

运单号格式不符合OO物流.

[956****734]

查看是否输入了正确的运单号。