跳到主要内容

库存域开放(144 个接口)

Avery
Risemap 开放平台

库存能力接入开放平台,新增 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)与待处理队列属内部机制,同样未开放。