首页 / 帮助中心 / 开放平台 / 仓库、入库、出库、调拨和库存接口
开放平台

仓库、入库、出库、调拨和库存接口

分类:开放平台 页面粒度:完整功能点/模块 适用角色:技术对接人, 仓库主管 更新日期:2026-06-07

用于对接 WMS 或 ERP 的仓库、入库、出库、调拨、盘点和库存查询。 企业已有 WMS 或 ERP 仓库系统,需要同步仓库、入库、出库、调拨、盘点和库存查询。 建议先确定库存主账和出入库状态口径,再做接口开发。

功能入口与菜单路径

开放平台
OpenAPI>仓库库存接口

界面截图与操作演示

录屏/视频覆盖点

  1. 同步仓库和商品编码
  2. 联调入库、出库和库存查询
  3. 测试订单占用、发货和退货对库存的影响

录屏建议覆盖入口、关键字段、保存/提交后的状态变化,以及前台或移动端刷新后的效果。

典型业务场景

  • 企业已有 WMS 或 ERP 仓库系统,需要同步仓库、入库、出库、调拨、盘点和库存查询。
  • 仓库主管需要接口数据与实际出入库流程一致,避免系统库存和仓库库存分裂。

适用角色与业务对象

适用角色技术对接人、仓库主管
业务对象仓库、入库、出库、调拨、库存

关键字段说明

字段/配置 所在位置 是否必填 说明 影响
仓库 仓库、入库、出库、调拨和库存接口页面 必填 仓库是仓库、入库、出库、调拨和库存接口中的关键字段或业务对象,用于识别、筛选或驱动后续流程。 同步仓库和商品编码
入库 仓库、入库、出库、调拨和库存接口页面 必填 入库是仓库、入库、出库、调拨和库存接口中的关键字段或业务对象,用于识别、筛选或驱动后续流程。 联调入库、出库和库存查询
出库 仓库、入库、出库、调拨和库存接口页面 按场景 出库是仓库、入库、出库、调拨和库存接口中的关键字段或业务对象,用于识别、筛选或驱动后续流程。 测试订单占用、发货和退货对库存的影响
调拨 仓库、入库、出库、调拨和库存接口页面 按场景 调拨是仓库、入库、出库、调拨和库存接口中的关键字段或业务对象,用于识别、筛选或驱动后续流程。 用于对接 WMS 或 ERP 的仓库、入库、出库、调拨、盘点和库存查询。
库存 仓库、入库、出库、调拨和库存接口页面 按场景 库存是仓库、入库、出库、调拨和库存接口中的关键字段或业务对象,用于识别、筛选或驱动后续流程。 用于对接 WMS 或 ERP 的仓库、入库、出库、调拨、盘点和库存查询。

权限与数据范围

建议开通角色
技术对接人仓库主管
权限点 控制内容 默认角色
warehouse:api:view 查看仓库、入库、出库、调拨和库存接口 技术对接人、仓库主管
warehouse:api:manage 新增、编辑、审核或处理仓库、入库、出库、调拨和库存接口 仓库主管

数据范围:按开放平台应用、接口授权范围、企业数据范围和接口调用凭证控制;接口仅返回已授权的数据。

使用前准备

  • 仓库编码、批次规则和库存占用规则已确认
  • WMS 与订货系统的库存主从关系已明确

操作流程

  1. 同步仓库和商品编码
  2. 联调入库、出库和库存查询
  3. 测试订单占用、发货和退货对库存的影响

配置规则与口径说明

  • 仓库接口要明确哪个系统负责库存主账,哪个系统负责订单履约。
  • 入库、出库和调拨单据要有唯一单号和状态回写。
  • 库存查询要区分仓库、批次、可售、锁定和在途口径。

上线后检查点

  • 入库和出库是否生成库存流水。
  • 调拨状态是否能区分调出、在途和调入。
  • 库存查询结果是否能支撑前台下单。

常见误区

  • 两个系统都能直接改库存,导致库存主账不清。
  • 只同步库存余额,不同步出入库单据和状态。

常见异常与排查步骤

接口调用失败或数据不同步

可能原因
接口凭证失效字段映射或必填参数不一致第三方系统回调或重试失败
检查步骤
  1. 库存不同步时检查仓库编码和批次字段
  2. 出库失败时检查订单状态和可用库存
处理方式
  • 重新授权或更换有效凭证
  • 按接口文档补齐字段并重新提交
  • 处理第三方异常后重试同步任务

检查点与异常排查

  • 库存不同步时检查仓库编码和批次字段
  • 出库失败时检查订单状态和可用库存

常见问题

仓库、入库、出库、调拨和库存接口操作前要确认什么?

仓库编码、批次规则和库存占用规则已确认;WMS 与订货系统的库存主从关系已明确

仓库、入库、出库、调拨和库存接口异常时怎么排查?

库存不同步时检查仓库编码和批次字段;出库失败时检查订单状态和可用库存

WMS 对接后库存不准怎么办?

先确认库存主账、同步方向、出入库单据、订单占用、调拨在途和批次口径。

库存接口需要支持批次吗?

食品、冻品、生鲜、医药和医疗器械等行业建议支持批次、效期和可售状态。

后续操作手册沉淀建议

  • 仓库基础资料接口
  • 入库和出库接口
  • 调拨和盘点接口
  • 库存查询和状态回写

下一步建议

建议先确定库存主账和出入库状态口径,再做接口开发。

开放平台仓库、入库、出库、调拨和库存接口技术对接人仓库主管仓库入库出库调拨库存仓库编码、批次规则和库存占用规则已确认WMS 与订货系统的库存主从关系已明确同步仓库和商品编码