Coupang Developer Center

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

更改登记错误的三方运送订单的运单号。 CGF lite 订单更新运单号请查看此页面。

更改后的运单配送状态为待配送（DEPARTURE），之后可能会根据物流跟踪信息发生变化。

<注意！> 只有订单在配送状态为待配送（DEPARTURE）、配送中（DELIVERING）、配送完成（FINAL_DELIVERY）及卖家直接配送（NONE_TRACKING）时，才可以更改运单信息。（其余订单状态发生错误）。

路径

POST

/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/orders/updateInvoices

示例

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/orders/updateInvoices

请求参数

名称

必须

数据类型

描述

vendorId

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

请求结果状态码

状态码	消息	备注
-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_INVOICE

更新运单号

简介

详细内容

路径

示例