coupang
POST/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/orders/global/invoicesv1

CGF lite 订单上传运单号接口

# 01

简介

API 支持的买家用户地区:韩国。 不可用于台湾店铺。 上传运单号至 CGF lite 订单,将订单状态变为待配送状态。 运单上传仅适用于处于商品准备中状态的CGF lite 订单。 允许将同一个运单号上传至同一个店铺下的不同 CGF lite 订单. <注意!>此接口只能上传 CGF LITE 订单的物流运单号。自发货订单物流运单号上传请转到 此页面 对接。

# 02

详细内容

API支持的买家用户地区:韩国。不可用于台湾店铺。

上传运单号至 CGF lite 订单,将订单状态变为待配送状态。

运单上传仅适用于处于商品准备中状态的CGF lite 订单。

允许将同一个运单号上传至同一个店铺下的不同 CGF lite 订单.

<注意!>此接口只能上传 CGF LITE 订单的物流运单号。自发货订单物流运单号上传请转到此页面对接。

路径

POST

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

示例

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/C00012345/orders/global/invoices

 

请求参数

Name 

Required 

Type 

Description 

vendorId 

 O

String 

卖家ID 

酷澎分配给卖家的固有代 

 e.g. C00012345 

 

请求体参数 

Name 

Required 

Type 

Description 

vendorId 

O 

String 

卖家ID 

酷澎分配给卖家的固有代 

e.g. C00012345 

orderSheetInvoiceApplyDtos 

O 

Array 

为待配送状态的信息列表 

  

shipmentBoxId 

O

Number 

配送号码(合并配送号码) 

  

orderId 

O

Number 

订单号 

  

deliveryCompanyCode 

O

String 

公司代 

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

跳转至快递公司代码 

  

invoiceNumber 

O

String 

物流运单号 

卖家直接配送(DIRECT)时可输入任意数字,因其不支持物流跟踪。 

请求体示例

{
"vendorId": "C00012345",
"orderSheetInvoiceApplyDtos": [
{
"shipmentBoxId": 4037219645,
"orderId": 11000154200196,
"deliveryCompanyCode": "sf_express",
"invoiceNumber": "SF1152738062699"
},
{
"shipmentBoxId": 4037004312,
"orderId": 11000154200196,
"deliveryCompanyCode": "sf_express",
"invoiceNumber": "SF1152738062699"
}
]
}

返回消息

名称 数据类型 描述
code Number
服务器返回代码
message String
服务器返回消息
data Object
 
  responseCode Number
请求结果状态码
状态码 消息 备注
-1 NONE 无结果
0 SUCCESS 成功
1 PARTIAL_ERROR 部分失败
99 FAILED 失败
  responseMessage String
 
请求结果状态消息
 
  responseList Array
单个上传结果集
    shipmentBoxId Number
合并配送号码
    data String

Result code

code

retry required

remark

OK

false

成功

NOT_FOUND_SHIPMENT_BOX

false

合并配送号码不存在

INVALID_STATUS

false

订单状态不正确

PERMISSION_DENIED

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

未知错误

    comment String
错误信息

 

返回消息示例

{
"code": 200,
"message": "OK",
"data": {
"responseCode": 1,
"responseMessage": "SUCCESS",
"responseList": [
{
"shipmentBoxId": 4037219645,
"data": "OK",
"comment": null
},
{
"shipmentBoxId": 4037004312,
"data": "OK",
"comment": null
}
]
}
}

错误代码

HTTP 状态码 (错误类型) 

错误消息

解决方法

400 (check request variable) 

无效物流公司代: 

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

 

URL API Name

GLOBAL_UPDATE_ORDER_SHIPPING_INFO