coupang
POST/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/exchangeRequests/{exchangeId}/invoicesv1

换货商品运单上传

# 01

简介

API 支持的买家用户地区:韩国 输 入要 换货 的商品的 运单 。 执行 [ 换货商品入库确认 API] 后, [ 查看换货请求列表 ] 时 , 回收 状态 ( collectStatus ) 为已发送给卖家( CompleteCollect ) 时 可以 执 行 [ 换货运单上传 API ] 。 换货商品入库后,查看换货请求列表,即可创建 DeliveryInvoiceGroupDtos 信息。 上 传换货运单时 , 须查找并输 入新 创 建的 shippingBoxId 。

# 02

详细内容

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

入要换货的商品的运单 

执行[换货商品入库确认API]后,[查看换货请求列表]回收状态collectStatus为已发送给卖家(CompleteCollect可以[换货运单上传API] 

换货商品入库后,查看换货请求列表,即可创建DeliveryInvoiceGroupDtos 信息。 

传换货运单时须查找并输入新建的shippingBoxId 

换货商品确认入库后,最多10钟后可上传换货运单

路径

POST

/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/exchangeRequests/{exchangeId}/invoices

示例

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/exchangeRequests/100000170/invoices

请求参数

Name 

Required 

Type 

Description 

vendorId 

 

String 

卖家ID 

酷澎分配给卖家的固有代 

ex) A00012345 

exchangeId 

O 

Number  

换货受理ID 

输入查看换货申请列表时,标示的exchangeId 

请求体参数

Name 

Required 

Type 

Description 

exchangeId 

O 

Number 

换货受理ID 

输入查看换货申请列表时,标示的exchangeId 

vendorId 

O 

String 

卖家ID 

酷澎分配给卖家的固有代 

ex) A00012345 

goodsDeliveryCode 

O 

String 

快递公司代码 

至快公司代 

invoiceNumber 

O 

String 

运单号 

shipmentBoxId 

O 

Number 

配送号码 

再次配送的配送号码 

处理为入库完成后,查看换货请求列表时,输入deliveryInvoiceGroupDtos信息下方,新创建的shipmentBoxId 

请求体示例

[
  {
    "exchangeId": "100000170",
    "vendorId": "A00012345",
    "shipmentBoxId": "123456789012345678",
    "goodsDeliveryCode": "CJGLS",
    "invoiceNumber": "680405450931"
  }
]

返回消息

Name 

Type 

Description 

code 

Number 

结果代码 

message 

String 

信息 

data 

Object 

返回结果 

  

resultCode 

String 

SUCCESS or FAIL 

  

resultMessage 

String 

结果信息 

返回消息示例

{
  "code": "200",
  "message": "SUCCESS",
  "data": {
    "resultCode": "SUCCESS",
    "resultMessage": "Invoice number save successfully"
  }
}

错误代码

HTTP status code (error type) 

Error message 

How to resolve 

400 (check request parameter) 

参数不可为空... 

查看参数值是否都输入了。 

接口名称

UPDATE_INVOICE_EXCHANGE_REQUEST