Lingxing
切换旧版

释放已锁定库存

POST/erp/sc/routing/owms/overseaStockPlan/releaseOverseaStockPlanStock

仅支持海外仓计划；每个计划独立加锁并执行事务，成功的提交，失败的回滚，继续处理后续计划。

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/owms/overseaStockPlan/releaseOverseaStockPlanStockHTTPSPOST待确认

请求参数

order_snsarray<any>必填
待释放库存的海外仓备货计划单号列表；重复单号会自动去重。

请求cURL示例

示例中的单号和 ID 为占位值，使用时请替换为实际值。

curl --location 'https://openapi.lingxing.com/erp/sc/routing/owms/overseaStockPlan/releaseOverseaStockPlanStock?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "order_sns": [
        "PLAN-EXAMPLE"
    ]
}'

返回结果

Json Object

codeinteger必填
业务结果码，与 HTTP 状态码不同；常见值为 1=成功、102=参数错误、1000=业务处理失败、500=系统错误。
msgstring必填
响应消息。
dataobject
库存释放实际执行后的结果；仅处理前置校验失败时，此 data 不返回。
隐藏子属性
errorarray<object>必填
释放失败的计划列表；全部成功时为空数组。
隐藏子属性
order_snstring必填
失败计划单号。
msgstring必填
业务失败原因；非业务异常返回固定系统错误提示。
fail_numinteger必填
释放失败的计划数量。
最小值：0
succ_numinteger必填
成功释放库存的计划数量。
最小值：0
require_idstring
请求追踪 ID；错误响应的 msg 还会附加请求码，便于排查。
error_detailsarray<any>
仅错误响应携带；执行失败时首条为统计，其余逐条为失败单号及原因。

附加说明

  • 库存操作执行完后返回 data.error、data.fail_num、data.succ_num；error 中每条包含失败单号 order_sn 和原因 msg。
  • 全部成功：code=1、msg=success、data.error=[]、data.fail_num=0。
  • 部分失败或全部失败：code=1000，data 保留真实成功/失败数量；已成功计划不会回滚。
  • 失败时 error_details 第一条为成功/失败数量，后续逐条列出失败单号及原因；msg 同步保留这些信息。
  • 单号不存在、计划类型不符或无权限等前置检查失败时整批拒绝，不执行释放，也不返回 data 统计。
  • 参数或业务校验信息正常反馈；非业务异常返回固定系统错误提示。
  • 以上业务结果均通过 HTTP 200 的 JSON 响应返回；成功与否以响应体 code 为准。