SuperAPI AI 工具集

inventory-adjustment

通用与其它

查看项目

更新于 10-16 06:51

技能介绍

用途:对指定地点的指定变体应用库存数量修正,相当于在 Shopify 后台手动编辑库存的程序化版本。适用于循环盘点发现差异后、3PL 退货批次延迟入账后,或多地点库存审计识别出可用/已承诺数量漂移后。

前置条件:执行 shopify auth login --store <domain>;API 权限范围 read_products、write_inventory。

参数:store(必填,店铺域名);format(可选,human 或 json,默认 human);dry_run(可选,默认 false,仅预览不执行变更);adjustments(必填,{sku, location_id, delta} 数组,delta 为带符号数量变化);reason(可选,默认 correction,可选值 correction、cycle_count、damaged、received、reservation_created、reservation_deleted、shrinkage);reference_document_uri(可选,关联采购单、退货或盘点文档)。

工作流程:先用 productVariants 查询按 SKU 获取 inventoryItem.id 与当前 inventoryQuantity,任一 SKU 未找到则中止;再用 inventoryAdjustQuantities 变更提交 changes 数组,返回 quantityAfterChange 与 userErrors。

输出:生成 CSV 文件 inventory-adjustments-<YYYY-MM-DD>.csv,列为 sku、product_title、location_name、quantity_before、delta、quantity_after、reason;format 为 json 时输出含步骤与结果摘要的 JSON。

限制与安全:变更会立即改动线上库存,调整错误可能导致超卖或库存虚高,建议先以 dry_run: true 预览前后数量;reason 会永久记录在 Shopify 库存活动历史中。常见错误包括 SKU 不存在、变体未启用库存跟踪、userErrors(delta 或地点无效、权限不足)、delta 使数量低于 0。建议将同一次盘点的修正合并为一条命令,调整后再次运行多地点库存审计确认差异已解决。