Coupang Developer Center

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

将订单状态从“付款完成”更改为“商品准备中”。如果在请求状态更改的订单中有取消的商品，则返回部分错误（Partial Error）。

※如果订单中包含正在通过取消全部或部分付款而进行的退款的商品时，则该订单将返回“无法更改配送状态，请查看订单历史记录。”的消息。

退款完成时，包含其它未申请取消商品的订单可以更改为“商品准备中”。

仅适用于付款完成阶段的合并配送号码（shippingBoxIds）。

如果合并配送号码（shippingBoxIds）列表数据很多，可能会出现超时错误，因此请求须少于50件，或仅请求单件。

<注意！> 因为顾客可能在付款完成时更改收货地址，因此一定要在“商品准备中“状态之后，通过单件查询订单来确认收货地址信息是否发生变化，若有变化，须进行相应更新。

路径

PATCH PUT

/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/ordersheets/acknowledgement

示例

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

请求参数

名称

必须

数据类型

描述

vendorId

String

卖家ID

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

e.g. A00012345

请求体参数

Name

Required

Type

Description

vendorId

String

卖家ID

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

e.g. A00012345

shipmentBoxIds

Array

要更改为“商品准备中”状态的捆绑配送号码列表

最多请求50 件

请求体示例

{
  "vendorId": "A00012345",
  "shipmentBoxIds": [
    123456789012345678,
    123456789012345679
  ]
}

返回消息

名称

数据类型

描述

code

Number

服务器响应代码

message

String

服务器响应信息

data

OrderSheetResponse

Ordersheet状态变更api调用结果对象

responseKey

Number

Request的区分值

系统元数据

responseCode

Number

request所有结果值的状态代码

代码	信息
-1	None
0	All succeeded.
1	Partial errors.
99	All Failed.

responseMessage

String

request所有结果值的状态信息

responseList

Array

单件的结果组

shipmentBoxId

Number

捆绑配送号码

succeed

Boolean

成功与否

resultCode

String

结果代码

resultMessage

String

结果信息

retryRequired

Boolean

是否可以Retry

返回消息示例

{
  "code": "200",
  "message": "OK",
  "data": {
    "responseKey": -7326489997410940000,
    "responseCode": 1,
    "responseMessage": "apply instructStatus result - Partial errors.",
    "responseList": [
      {
        "shipmentBoxId": 123456789012345678,
        "succeed": true,
        "resultCode": "OK",
        "retryRequired": false,
        "resultMessage": "request succeeded."
      },
      {
        "shipmentBoxId": 123456789012345679,
        "succeed": false,
        "resultCode": "NOT_FOUND_SHIPMENT_BOX",
        "retryRequired": true,
        "resultMessage": "shipmentBoxId (123456789012345679) is not found."
      }
    ]
  }
}

错误代码

HTTP 状态码 (错误类型)	错误信息	解决方法
200 (check request variable)	"responseCode":99, "resultMessage": “无法更改配送状态。请确认订单明细。”	当包含正在通过取消全部或部分付款而进行的退款订单时，会生成此消息。退款完成时，包含其它未申请取消商品的订单可以更改为“商品准备中”。
200 (check request variable)	"responseCode":99, "resultMessage": "无法更改配送状态。请确认订单明细."	订单状态为付款完成时才可以处理为“商品准备中”。通过单笔订单查询API查看订单状态是否已经转为商品准备中或待配送状态。
200 (check request variable)	"OK Failed shipmentBoxIds: [1241*103, 1240026, 1241**223]"	查看显示的捆绑配送号码（shipmentBoxIds）是否为商品准备中或待配送状态的订单。
500 (sever error)	"code":500, "message" : "com.coupang.apigateway.pylon.ApiPreconditionException: Timeout waiting for connection from pool"	由于内部系统负载增加而导致的临时错误。稍后请重试。
504 (sever error)	"code" : "ERROR", "message" : "请求超时，如果情况继续考虑使用超时扩展."	由于内部系统负载增加而导致的临时错误。通过单笔订单查询API查看订单状态是否已经转为商品准备中，如果没有变更，请稍后重试。
521 (sever error)	"code" : "ERROR", "message" : "connection timed out: aws-openapi.coupang.net/10.211.51.172:80"	由于内部系统负载增加而导致的临时错误。通过单笔订单查询API查看订单状态是否已经转为商品准备中，如果没有变更，请稍后重试。

接口名称

UPDATE_ORDERSHEET_STATUS

订单状态更改为准备中

简介

详细内容

路径

示例