库存

读取库存，并执行受控调整、销售上限及手动预留。

操作

获取列表 · 库存 — 库存查看产品库存、仓库和内部位置。 GET 创建 · 库存调整 — 库存更改实际和可销售产品数量。 POST 获取 · 库存 — 库存查看产品库存、仓库和内部位置。 GET 更新 · 库存 — 库存更改实际和可销售产品数量。 PATCH 更新 · 手动预留 — 库存更改手动预留. 适用于外部集成操作。 PATCH 更新 · 销售限额 — 库存更改销售限额. 适用于外部集成操作。 PATCH 创建导入创建最多1000个兑换码或100个文件的草稿。此时不会增加可售库存。 POST 取消导入放弃未完成的草稿。此操作不会撤回已确认的入库记录。 DELETE 读取导入检查状态、版本和验证结果。草稿属于创建它的API密钥。 GET 确认入库根据已验证批次创建计划或已收货的入库记录。计划中的库存暂不可售。 POST 接收计划入库接收已有库存单元，无需再次导入兑换码或文件。 POST 验证导入验证整个批次。重复或无效条目会导致批次被拒绝，兑换码不会被截短。 POST 撤回入库仅撤回空闲单元。已预留和已分配单元仍与订单关联。 POST 读取数字库存设置修改前读取设置和数量。响应不包含兑换码或文件内容。 GET 配置数字库存Professional及以上套餐可启用独立兑换码或文件。停用后仍保留历史购买的访问权限。 PATCH 列出库存单元每页读取最多100个单元。列表仅显示元数据，不披露兑换码。 GET 调整分配顺序按所需顺序提交完整且未筛选的页面。版本过期时返回409。 POST 读取空闲单元内容兑换码以JSON返回，文件以二进制返回。每次请求都需要Bearer及reveal权限。 GET 检查空闲单元访问权限不下载内容，执行与GET相同的权限检查。此操作不会预留单元。 HEAD 移除空闲单元说明原因后移除未售出的兑换码或文件。已预留或已分配单元会被拒绝。 POST 替换空闲单元替换兑换码或文件而不改变顺序。修改记录保留在仓库历史中。 POST 准备私有上传为文件预留空间，并关联到导入或待替换的单元。 POST 检查上传检查大小、校验和及格式。上传就绪不表示已完成入库。 GET 上传文件通过HTTPS以multipart/form-data发送文件。不要发送Base64或需要抓取的URL。 PUT

工作原理

库存记录区分实物 on_hand 数量、订单预留、手动预留和可售数量。请使用返回的库存记录标识符和版本；产品库存与变体库存是不同目标。

sellable_limit 为 -1 表示无限制，0 表示不可销售。无限可售量在 available 中以 null 表示。不要将 null 当作零。库存调整、销售上限和手动预留具有独立操作及权限。