Etsy库存配送API迁移审计

适用场景与前置条件

适用于 Etsy Open API 集成从旧 includes 参数切换到专用 Inventory/Shipping 端点，检查截止日期、400、listing scope 和字段空值。前置条件：Python 3.10+、脱敏请求快照；当前官方文档优先。

输入与输出

输入：请求快照 CSV。输出：etsy_inventory_shipping_migration_audit.json，含迁移旗标和 REVIEW_REQUIRED。

安装与执行

无第三方依赖。运行 python scripts/audit_etsy_migration.py --snapshot examples/request_snapshot.csv --output examples/etsy_inventory_shipping_migration_audit.json。

错误恢复

缺少请求模式、端点、状态或 scope 时进入复核，不猜测 API 是否已经迁移；补齐脱敏快照后重跑。

权限与隐私边界

只处理本地脱敏元数据，不读取 OAuth、API key、access token、店铺、买家或原始请求载荷。

验收

样例应区分旧 includes、已迁移、截止后 400 和 public shipping null，并保留 external_write_executed=false。