Update return inventory handling
退货库存
更新 Return Inventory Handling
POST
Update return inventory handling
更新单条退件库存记录的处理决定——告诉仓库该如何处置已收到的包裹。多在仓库登记包裹后调用；从此库存便会沿着所选处理路径（上架、销毁、召回、补寄等）继续。
何时调用
- 客服或运营团队决定处理方式后。
必填字段
returnInventoryId— 长整型；必须存在且属于您的账户。在仓库登记包裹时，由newInventoryCreatedwebhook 事件推送；请在自有侧缓存以备后续操作。webhook 流是库存 ID 的真实数据源。handlingCode— 字符串，必须是 取得所有处理类型 返回的值之一。不能直接使用rsd（补寄）或tbc（待确认）——这两类有专属端点。常用值：ohd（暂存）、rtn（退回）、rst（上架）、dsp（销毁）。
handlingStatusCode 为 pending 且新处理为 ohd（暂存），调用始终允许——便于在调查期间将库存挂起。
下列情况无法更新处理：
- 库存所属行项目存在待处理的 VAS（增值服务）请求。请先透过 取得所有 VAS 与 VAS 端点取消或完成 VAS。
副作用
- 库存记录上的
handlingCode与handlingStatusCode会被更新。 - 若新处理不是
ohd或oth（其他），将锁定 RMA 映射，禁止对该库存进行 RMA 交换。
相关
- 取消退件库存处理 — 在仓库执行前撤销处理决定。
- 按退件库存 ID 创建召回 — 透过专属召回流程处理被召回的库存。
- 建立补寄订单 — 走补寄路径（同样无法直接透过本端点到达）。
- Webhooks —
newInventoryCreated、vasUpdated、库存处理完成事件与notifyUserRmaSwapped都会推送库存生命周期至您的端点。
授权
Your API key
Your API token — keep this private
请求体
application/json
响应
Success
Universal response envelope. Successful responses include the business payload as additional top-level fields alongside correlationId and meta. Failed responses (auth errors, validation errors) only populate correlationId and meta, with meta.errorCode and meta.error describing the failure.