运输/退货接口 – 简体中文

订单列表查询 (按天分页)

可通过按天分页的方式查询订单列表。例) (2022-02-01~2022-02-03) 可通过maxPerPage参数调整每页row的大小，下一页可通过[nextToken]获取。除部分Path Parameter外，整体配置与订单列表查询相同（以分钟为单位）。 ※ 顾客可在付款完成后修改收货地址，因此将商品状态处理为“商品准备中”后，请务必更新配送地信息("receiver")（使用单... 查看更多

订单列表查询（以分钟为单位）

可以分钟为单位查询24小时内的订单列表。例) (2022-08-10T00:00～2022-08-10T23:59) 搜索超过 24 小时时出现错误。除部分Path Parameter外，整体配置与订单列表查询（以天为单位）相同。订单列表中无法查看已完成退货的订单，请通过“退货/取消申请列表查询”API查看。顾客可在付款完成后修改收货地址，因此将商品状态处理为“商品准备中... 查看更多

单个订单查询（使用合并配送号码）

此为通过合并配送号码（shipmentBoxId）查询单个订单的API。顾客可在付款完成后修改收货地址，因此将商品状态处理为“商品准备中”后，请务必通过单件订单查询来确认是否修改或更新了配送地信息("receiver")。发货前，请一定要确认"sellerProductName + sellerProductItemName"和"vendorItemName"上的信息是否一致。构... 查看更多

单个订单查询（使用订单号）

此为通过订单号（orderId）查询单个订单的API。顾客可在付款完成后修改收货地址，因此将商品状态处理为“商品准备中”后，请务必通过单件订单查询来确认是否修改或更新了配送地信息("receiver")。发货前，请一定要确认"sellerProductName + sellerProductItemName"和"vendorItemName"上的信息是否一致。构成、数量、容量等... 查看更多

查询配送状态变更历史

查看特定订单的配送状态历史记录。路径 GET /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/ordersheets/{shipmentBoxId}/history 示例 https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A000123... 查看更多

订单状态更改为准备中

将订单状态从“付款完成”更改为“商品准备中”。如果在请求状态更改的订单中有取消的商品，则返回部分错误（Partial Error）。 ※如果订单中包含正在通过取消全部或部分付款而进行的退款的商品时，则该订单将返回“无法更改配送状态，请查看订单历史记录。”的消息。退款完成时，包含其它未申请取消商品的订单可以更改为“商品准备中”。仅适用于付款完成阶段的合并配送号码（shippingBo... 查看更多

上传运单号

上传运单，将订单状态变为待配送状态。运单上传仅适用于处于商品准备中状态的三方运送订单。 CGF lite 订单上传运单号请查看此页面。如需要分开配送，请参阅FAQ 了解运单上传的示例。如果在 6 个月内有输入重复的运单号码，可能会出现运单重复错误。输入了错误的运单无法跟踪到正确的物流情况，或顾客因卖家未在时限内输入运单而要求取消订单，由此产生的运费由卖家承担。路径 POST /v... 查看更多

更新运单号

更改登记错误的三方运送订单的运单号。 CGF lite 订单更新运单号请查看此页面。更改后的运单配送状态为待配送（DEPARTURE），之后可能会根据物流跟踪信息发生变化。 <注意！> 只有订单在配送状态为待配送（DEPARTURE）、配送中（DELIVERING）、配送完成（FINAL_DELIVERY）及卖家直接配送（NONE_TRACKING）时，才可以更改运单信息。（... 查看更多

“停止出库”处理

该API在顾客取消订单，通过退货请求列表查看到状态为申请停止出库（RELEASE_STOP_UNCHECKED）或退货处理未确认（RETURNS_UNCHECKED），且releaseStatus为“N”时才可使用。商品若还未发货，则可按照顾客要求，使用该功能停止该商品的出库。 <注意!>申请停止出库的商品若已发货，往返退货配送费由卖家承担。路径 PATCH PUT /v2/pro... 查看更多

“已经出库“处理

该API在顾客取消订单，通过退货请求列表查看到状态为申请停止出库（RELEASE_STOP_UNCHECKED）或退货处理未确认（RETURNS_UNCHECKED），且releaseStatus为“N”时才可使用。可在卖家已将商品发货时使用该API。 <注意!>即使顾客已申请停止出库，商品若已发货，往返退货配送费由卖家承担。路径 PATCH PUT /v2/providers/ope... 查看更多

取消订单

取消处于【已付款】或【商品准备中】状态商品时使用的API。(用于其它状态时会发生错误）该API会立即取消[已付款]状态的商品，并停止发货[商品准备中]状态的商品。如果一个订单号中含不同的捆绑配送编号(shipmentBoxId)，则须分别申请取消shipmentBoxId。 ※使用订单取消API会降低卖家分数（订单履行），因此请管理您的库存和价格，尽量避免使用该功能。路径 PO... 查看更多

将长时间未配送订单处理为“已配送”

运单号登记后已过去1个月，依然无法确认物流跟踪结果，将处于该情况的订单状态更改为已配送。如因已结算订单未发货而引起顾客纠纷，相关费用需由卖家承担，因此请仔细确认。仅可处理自 DEPARTURE 起 30 天后仍处于交货状态的订单。只有在待配送(DEPARTURE)状态开始30天后，仍然处于待配送、配送中的订单才可进行此操作。路径 POST /v2/providers/open... 查看更多

韩国省市对照表

韩国现用的邮编是5位数字，其中前三位数字表示市、郡、区，后两位表示镇、面、洞的对应编号。中国的物流商需要收货地址的省市信息，所以用邮编的前三位就可以确定。请用下表做一个对照表，使用订单中收货人的 postCode 前三位来找到对应的省市即可。省市区名区名（韩语）邮政编码前三位首尔 서울 江北區 강북구 010 011 012 道峰區 도봉구 ... 查看更多

OPENAPI 관련 안내