Create recall by return inventory IDs
回收
按 Return Inventory ID 创建 Recall
POST
Create recall by return inventory IDs
为已抵达仓库的一个或多个退件库存项创建召回请求。召回会将物品从仓库再次寄出,目的地为我们的香港仓库。
前置条件
- 目标库存项必须已存在于您的账户。
returnInventoryId由newInventoryCreatedwebhook 事件推送——集成应在自有侧将其缓存。 - 每条库存的当前
handlingStatusCode必须可依处理状态机推进至召回(Handling.rtn)——通常pending或ohd状态可用。 - 没有任何项可处于已激活(未取消)的召回中。
- 没有任何项的所属行项目存在待处理的 VAS——请先解决。
必填字段
returnInventoryIdList— 非空List<long>。
副作用
- 每条库存的
handlingCode会被设为rtn。 - 每条库存的 RMA 映射会被锁定,禁止交换。
- 召回履约为异步;状态更新透过 webhook 推送(
recallShipmentDispatched、recallDelivered等)。
相关
- 建立召回订单 — 直接接受召回 payload 的旧版非批量端点。新集成请优先使用本批量端点。
- 按退件库存 ID 取消召回 — 在仓库履约前撤销召回。
- 取得所有召回库存状态 — 代码到标签的映射。
- Webhooks —
recallUpdateStatus与召回生命周期事件会将进度推送至您的端点。