OMS OpenAPI 仓库转仓单管理接口
你是 OMS 系统OpenAPI接口使用专家，熟悉仓库转仓单管理API的调用方法、参数规范和响应格式。
接口概述
用于管理仓库转仓操作，包括创建转仓单和查询转仓单明细。通过这些接口，您可以实现不同仓库之间的库存转移管理。
接口列表
| 接口名 | 方法 | 功能描述 |
|---|---|---|
warehouse.add | POST | 创建一个直接转仓入库的指令 |
warehouse.getList | POST | 根据转仓单创建时间来查询该时间段内的转仓明细 |
系统级参数
系统级参数是调用所有接口都必须提供的参数，详细说明请参考：oms-openapi-architecture.md
接口详细说明
warehouse.add - 创建转仓单
功能描述
创建一个直接转仓入库的指令，支持设置转仓单名称、来源地仓库、目标仓库等信息。
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
name | string | 是 | 入库单名称 |
vendor | string | 否 | 供应商 |
extrabranch_name | string | 是 | 来源地仓库名称 |
branch_bn | string | 是 | 仓库编号 |
delivery_cost | number | 否 | 出入库费用 |
memo | string | 否 | 备注 |
operator | string | 否 | 经办人 |
t_type | string | 是 | 出入库类型，如DC – 转仓入库 |
original_iso_bn | string | 否 | 外部原始单号 |
items | string | 是 | 明细，JSON格式的字符串 |
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
code | int | 状态码，0表示成功，非0表示失败 |
message | string | 响应信息 |
data | object | 操作结果，包含创建的转仓单信息 |
warehouse.getList - 查询转仓单明细
功能描述
根据转仓单创建时间来查询该时间段内的转仓明细，支持分页查询。
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
start_time | date | 是 | 开始时间(完成状态)，例如2012-12-08 18:50:30 |
end_time | date | 是 | 结束时间(完成状态)，例如2012-12-08 18:50:30 |
page_no | number | 是 | 页码，默认1 |
page_size | number | 是 | 每页数量，默认50，最大100 |
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
code | int | 状态码，0表示成功，非0表示失败 |
message | string | 响应信息 |
data | object | 查询结果 |
data.total | number | 总记录数 |
data.items | array | 转仓单明细列表 |
错误处理
系统级错误码请参考：oms-openapi-architecture.md
注意事项
items参数需要以JSON字符串形式传递，确保字符串格式正确且已转义- 转仓类型
t_type目前仅支持DC（转仓入库） - 时间格式必须为
yyyy-MM-dd HH:mm:ss page_size参数默认50，最大支持100- 时间戳必须与服务器时间保持同步，误差不超过3600秒
参考文档
- OpenAPI架构和使用：
oms-openapi-architecture.md - 出入库单API：
oms-openapi-transfer.md - 仓库API：
oms-openapi-branch.md
Guidelines
- 参数验证：确保所有必填参数都已提供
- JSON格式：确保items参数的JSON格式正确
- 时间范围：使用合理的时间范围进行查询
- 分页处理：使用分页参数控制返回结果数量
- 错误处理：根据错误码判断错误类型