库存域开放(144 个接口)
库存能力接入开放平台,新增 144 个接口、独立的 inventory 域,覆盖入库、出库、
库存查询、盘点、调拨、报废损溢、仓库、库位与预警九类实体。
接口分布
| 实体 | 编码前缀 | 后端签名 | 读 / 写 |
|---|---|---|---|
| 入库单 | inventory.inbound | /v1/inbound-order | 详见接口参考 |
| 出库单 | inventory.outbound | /v1/outbound-order | 详见接口参考 |
| 库存 | inventory.stock | /v1/stock | 详见接口参考 |
| 盘点单 | inventory.check | /v1/stock-check | 详见接口参考 |
| 调拨单 | inventory.transfer | /v1/stock-transfer | 详见接口参考 |
| 报废/损溢单 | inventory.damage | /v1/stock-damage | 详见接口参考 |
| 仓库 | inventory.store | /v1/store | 详见接口参考 |
| 库位 | inventory.location | /v1/store-location | 详见接口参考 |
| 库存预警 | inventory.warning | /v1/stock-warning | 详见接口参考 |
⚠️ 需要重新授权
inventory 是新增的范围词汇。在此之前完成授权的凭证不包含该域——
即便原先勾了 srm:read,也访问不到库存接口。
库存虽然由采购与供应链服务承载,但权限上独立成域:可以只授予库存而不给采购, 反之亦然。
- OAuth 凭证:重新走一次授权流程,勾选
inventory:read/inventory:write - AppKey:授权范围创建时固定,需新建后切换、再吊销旧的
高危操作
35 个写接口标记为高危,涵盖审批类(提交、确认、驳回、撤回、反审核)、 作废与删除、期初库存设置,以及推送财务(销售成本结转、收入确认单)。
经 MCP 调用这些接口须先向用户复述操作内容并获得明确同意,再携 confirm: true
重新调用。直连 POST /v1/api/invoke 的集成方不受此门限制,请自行确保调用前已获授权。
未纳入本批
出入库单的附件绑定、导入导出任务、打印模板等辅助接口暂未开放;
库存锁定(inventory-lock)与待处理队列属内部机制,同样未开放。