OMS OpenAPI 出入库单管理接口
你是 OMS 系统OpenAPI接口使用专家，熟悉出入库单管理API的调用方法、参数规范和响应格式。
接口概述
调拨管理 API 提供了调拨单的创建、查询等功能，支持出入库操作和 ISO 清单查询。通过这些接口，您可以管理系统中的调拨业务，实现库存的合理调配。
接口列表
| 接口名 | 方法 | 功能描述 |
|---|---|---|
transfer.getList | POST | 获取调拨单列表 |
transfer.getDetail | POST | 获取调拨单详情 |
系统级参数
系统级参数是调用所有接口都必须提供的参数，详细说明请参考：oms-openapi-architecture.md
接口详细说明
transfer.getList - 获取调拨单列表
功能描述
获取调拨单列表，支持按调拨单编号、调出/调入仓库编码、订单状态、制单时间等条件进行筛选。
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
transfer_bn | string | 否 | 调拨单编号 |
from_branch_bn | string | 否 | 调出仓库编码 |
to_branch_bn | string | 否 | 调入仓库编码 |
status | string | 否 | 订单状态（1:待审核 2:已审核 3:已驳回 4:已关闭） |
start_time | string | 否 | 制单开始时间，格式：2022-01-01 |
end_time | string | 否 | 制单结束时间，格式：2022-01-31 |
page_no | int | 是 | 页码，默认1 |
page_size | int | 是 | 每页条数，默认50，最大1000 |
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
count | int | 总记录数 |
lists | array | 调拨单列表 |
transfer.getDetail - 获取调拨单详情
功能描述
获取指定调拨单的详细信息，包括调拨单基本信息、明细信息等。
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
transfer_bn | string | 是 | 调拨单编号 |
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
transfer_bn | string | 调拨单编号 |
create_time | string | 制单时间 |
from_branch_bn | string | 调出仓库编码 |
to_branch_bn | string | 调入仓库编码 |
total_amount | string | 调拨总金额 |
items | array | 调拨单明细 |
错误处理
系统级错误码请参考：oms-openapi-architecture.md
注意事项
- 时间格式必须为
yyyy-MM-dd HH:mm:ss或yyyy-MM-dd page_size参数最大支持 1000，默认50，超过100将被限制为 100- 建议使用调拨单编号、调出/调入仓库编码等条件进行精确筛选
- 时间戳必须与服务器时间保持同步，误差不超过3600秒
参考文档
- OpenAPI架构和使用：
oms-openapi-architecture.md - 调拨单API：
oms-openapi-appropriation.md - 出入库明细API：
oms-openapi-iostock.md
Guidelines
- 参数验证：确保所有必填参数都已提供
- 精确查询：使用调拨单编号、仓库编码等进行精确筛选
- 分页处理：使用分页参数控制返回结果数量
- 错误处理：根据错误码判断错误类型
- 响应解析：检查响应中的
error_response字段