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

上传运单号接口返回了错误 “INVALID_STATUS”

上传运单号接口返回错误 “INVALID_STATUS”的原因是订单不在商品准备中（INSTRUCT）状态。如果订单是在已结算（ACCEPT）状态，请使用订单状态更改为准备中接口修改订单状态到商品准备中（INSTRUCT）状态。如果订单在其它状态，请使用更新运单号接口来更新运单号。错误示例： [ { "shipmentBoxId": 38273723,... 查看更多

订单处于商品准备中时，买家的收货地址可能会变吗？

可能，买家的收货地址在付款完成时就可能会被买家改变。在将订单改为商品准备中后，请再次讲求这些订单来确认收货地址，以防止买家在付款完成时改变了收货地址。查看更多

使用订单状态更改为准备中接口时，接口返回了成功，但是在 Wing 后台订单状态依旧是付款完成

这种情况是由于短时间内 Coupang 收到的订单过多，造成了系统延迟，使得内部状态不同步。通常情况下，这种延迟不会超过30分钟。如果超过了一个小时订单状态依然没有更改为商品准备中，请在线问询。查看更多

在使用 “停止出库”处理 API 时，我应该为 "cancelCount" 参数字段赋什么值？

在 “停止出库”处理 API 的请求体中， "cancelCount" 参数字段指的是需要停止出库的商品数量。请按照登记数目（receiptId）来决定这个值。示例问：我的客户让我将一个订单中的2个商品 A和3个商品 B停止出库，我应该将 "cancelCount" 字段赋值 5 还是 2？答：应赋值 5，因为这个数量是根据登记数目（receiptId）来决定的。（这个... 查看更多

订单API 的返回中有 splitShipping 和 ableSplitShipping 两个字段，这两个字段有什么区别？

这两个字段的区别如下： - splitShipping: 这个字段表明这个订单是否已经被拆分运送- ableSplitShipping: 这个字段表明这个订单是否可以被拆分运送更多详情，请查看常见问题中的“我想将订单拆分运送” 查看更多

当我使用物流公司 Direct Courier Delivery (DIRECT) 上传运单号时，订单不会变为运送完成状态

订单状态的改变是根据商品的物流状态决定的，而 Direct Courier Delivery (DIRECT) 指的是卖家直接运送商品到买家手中，物流状态只存在于卖家的系统中，Coupang 无法通过物流公司或者物流信息集成公司获知，所以订单就不会运送完成状态。请注意这样的订单也会被视为正常销售，即使订单状态没有变为运送完成状态。查看更多

订单中有部分商品取消时，订单内容会有更新吗？

订单中有四个字段跟商品运送数量有关。其中的 shippingCount 是最开始的购买数量，这个字段值不会变。商品取消的数目可以读取 cancelCount 字段值下面是四个字段的关系： shippingCount = 买家初始购买数量 holdCountForCancel = 已经被取消和要被退款的商品数量 cancelCount = 已经被确认取消的商品数量 Orderable c... 查看更多

什么情况下可以用停止出库 API？

买家要求卖家不要发送产品，卖家在发货之前要使用停止出库 API。（如果卖家已经发货，可以使用已经出库 API 来处理）查看更多

API 返回了错误信息 "Can not change the delivery status. Please check the order history"

返回这个错误的原因是请求的订单处于退款中或者部分付款取消中。请查看订单日志查看更多

订单信息中的 shipmentBoxId 和 orderId 有什么区别？

ShipmentBoxId 和 orderId 是两个不同的概念。当买家下单时， orderID（订单号码）就产生了。shipmentBoxId（合并配送号码）是订单中可以一起配送的物品组；ShipmentBoxId 是 OrderID 的一部分。例如：一个订单中含有需要冷冻配送的物品A 和玩具B，显然这两个物品不可以一起配送，此时 Coupang 会给物品A分配一个 ShipmentB... 查看更多

订单信息中的 salesPrice(per unit price), orderPrice(price to be paid), and discountPrice(discounted price) 字段分别是什么意思？

- salesPrice : 每件产品的价格 - orderPrice : salesPrice (每件产品价格) x shippingCount (订单中的商品数量)- discountPrice : 使用立减或者购物车/品类优惠券打折后的价格。基本上，Coupang 不会使用三方卖家的购物车/品类优惠券。如果买家使用了这些优惠券，Coupang 会弥补因此产生的差价。所以此项并不会影响卖... 查看更多

可以使用商品ID来取代 receiptId 做停止出库请求吗？

不可以，只能使用 receiptId 来请求停止出库API 或者已经出库 API。查看更多

接口返回了'[INTERNAL_SERVER_ERROR] The cancellation/return quantity doesn't match cancelCount' 错误

这个错误是因为取消请求中商品数量与停止出库的商品数量不相同。请将将请求中的数量修改为相同。查看更多

上传运单号返回了错误 "Can't upload this waybill as its serial number is already registered in the system (it can be uploaded only if the recipient info is identical)."

Coupang 对过去6个月上传的运单号有校检，防止重复的运单号上传到不同的订单。如果您的上传运单号请求因为这个错误失败了，但这个运单号是正确的，请使用 deliveryCompanyCode 为 DIRECT 来上传此运单号。 "deliveryCompanyCode": "DIRECT", 对于 deliveryCompanyCode 为 DIRECT 的订单，Coupang 不支持物流... 查看更多

我想将订单拆分运送

如果一个订单的 ableSplitShipping 字段值为 True 表示这个订单可以被拆分运送。拆分运送的订单在第一次上传运单号的时候，需要在请求中的orderSheetInvoiceApplyDtos加入两个运单信息，为第二次上传运单号做准备。以下是一个例子：例) 情景： <当一个买家在一个订单中购买了两个可以打包在一起运送的产品，但是这两个产品需要被分开运送时> 比如说，首先要运... 查看更多

当请求订单信息时，收货地址中的旧地址/新地址系统有没有分离？

没有，Coupang 不分离旧地址/新地址系统。查看更多

使用订单列表查询 API 查不到退货或取消的订单

订单列表查询 API 的返回中不包括退换货和取消的订单。请使用 [退货/取消申请列表查询] API 来查询这些订单。如果一个订单在配送完成之后被退货，这个退货订单可以同时在订单列表查询 API 和退货/取消申请列表查询 API 中查到。查看更多

已经设置为分开运送的订单可以改回为捆绑运送吗？

不可以，已经设置为分开运送的订单不可以改回为捆绑运送。查看更多

上传运单号 API 返回了“ invalid delivery status”错误

当订单不在”产品准备中（INSTRUCT）”状态时，上传运单号就会返回这个错误。请确定一下订单是否在”产品准备中（INSTRUCT）”状态。如果订单是在“付款完成（ACCEPT）”状态，请使用订单状态更改为准备中 API 改订单状态到”产品准备中（INSTRUCT）”状态。如果订单在”配送指示（DEPARTURE）” 时，请使用更新运单号 API 修改运单号。查看更多

订单满额免运费时，如何设置商品运费相关字段值？

<设置满额免运费> -需要设置商品基本运费和退货运费 -设置初始退货运费为 0 韩元 -买家退货费计算方法为“基本运费+退货费” <运费类型> 以下三个运费类型都是单程。请根据实际运费情况来设置运费。 -初始退货运费（deliveryChargeOnReturn）：卖家向买家收取的运费。因为是满额免运费，所以设置为 0. -退货费（returnCharge）：单程退货运费 -基本运费（de... 查看更多

我找不到我刚刚下的订单

通常情况下，需要10分钟左右才能让订单从付款完成状态转到订单列表中。如果您希望早些看到，可以一个一个搜索订单。查看更多

对于定制类商品，上传商品时，卖家需要填写 extraInfoMessage 字段值（买家定制产品指南）。在订单中可以看到对应的信息吗？

可以的。请查看订单信息中的 etcInfoHeader 字段值。etcInfoValues 字段值是买家写给卖家的备注信息。查看更多

什么情况下需要使用已经出库 API？

当退货订单列表中的订单取消状态为 RELEASE_STOP_UNCHECKED 且商品已经发货时，需要使用已经出库 API。使用此 API 后，退货流程立即启动。请注意，如果卖家在订单处于“产品准备中”状态时使用，卖家需要付退货运费。查看更多

日期段/时间段/订单号/合并配送号码四种方法的订单信息请求有什么不同点？

获取的数据是一致的，唯一的不同是查询方法。请查看以下不同点：订单列表查询指南 <日期段分页查询> -可以查询最多31天的订单信息 -可以指定每页返回的订单数目（maxPerPage参数） <时间段分页查询> -可以查询指定日期的最大24小时内的订单信息 -不可以指定每页返回的订单数目 <合并配送号码/订单号码> -只能通过合并配送号码或者订单号码请求单个订单查看更多

上传商品的时候，接口返回了错误“[code: VALIDATION , error: For general delivery products, the return shipping fee is limited to 100% to 150% of the initial shipping fee on return. Please change the return shipping fee.]”

返回这个错误的原因是此商品的退货运费大于此商品的发货运费太多。对于免运费的订单退货时，买家需要支付的运费是首次退货运费和退货运费之和。请查看下面的相关定义： <运费类型> 以下三种运费类型都是指单程运费，请根据其类型设置 -首次退货运费（deliveryChargeOnReturn 字段）：对免运费的订单退货时买家支付的退货运费 -退货运费（returnCharge 字段）：买家退... 查看更多

OPENAPI 관련 안내