库存跟踪 · 导入数据（Excel）

与站内页面库存跟踪 → 导入数据行为一致：使用与「竞品商品批量导入」相同的 Excel 列模板；为每行创建或更新竞品商品，并以您指定的 import_time 写入竞品商品跟踪快照（来源 inventory_import）。

鉴权说明

与「竞品商品批量导入」开放接口相同：username（登录名）+ token（个人中心 API Token）。
Token 存数据库，多进程部署下与生成 Token 的 worker 无关。

请求

方法	`POST`
URL	`https://aifor1.com/api/open/v1/inventory-tracking/import/`
Content-Type	`multipart/form-data`

表单字段

字段名	必填	说明
`username`	是	登录用户名
`token`	是	个人中心 API Token
`import_time`	是	快照时间。支持 `YYYY-MM-DDTHH:MM`（与 `datetime-local` 一致）、`YYYY-MM-DD HH:MM:SS`、或仅日期 `YYYY-MM-DD`；无法解析时服务端会回退为当前时间（建议显式传准）
`file` 或 `excel_file`	是	Excel 文件
`category_id`	否	类目 ID；与站内导入一致，可不传

Excel 模板

必填 skuId、商品名称；列要求与竞品商品批量导入 API / 站内批量导入说明一致。

成功响应 HTTP 200

{
  "success": true,
  "imported_count": 120,
  "skipped_count": 3,
  "import_time_applied": "2026-03-25T16:17:00+08:00",
  "message": "成功处理 120 条，跳过 3 条；跟踪快照时间已应用"
}

错误响应

401：鉴权失败
400：缺少 import_time、文件或 Excel 无法解析
500：导入过程异常

调用示例（curl）

curl -X POST "https://aifor1.com/api/open/v1/inventory-tracking/import/" \
  -F "username=YOUR_USERNAME" \
  -F "token=YOUR_TOKEN" \
  -F "import_time=2026-03-25T16:17" \
  -F "file=@/path/to/inventory.xlsx"

安全建议：生产环境请使用 HTTPS；勿泄露 Token。