Coupang Developer Center

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

请求参数

Name

Required

Type

Description

vendorId

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	是否为分开配送 false (整体配送) 一个订单号中包含的所有商品都发送同一运单号 true (分开配送) 包含在一个订单号中的商品被分开发送多个运单号 * 分开配送示例 (点击)
	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

请求结果状态码

状态码	消息	备注
-1	NONE	无结果
0	SUCCESS	成功
1	PARTIAL_ERROR	部分失败
99	FAILED	失败

responseMessage

String

请求结果状态消息

responseList

Array

单个上传结果集

shipmentBoxId

Number

合并配送号码

succeed

Boolean

是否成功 Y/N

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	一件商品不能分开发货

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-62-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

上传运单号

简介

详细内容

路径

示例