Saas-voc/docs/JD-FIRST-BATCH-IMPORT.md

京东首批商品导入

当前状态

• 京东商品、SKU、库存接口已经在同一授权进程中验证成功。
• 当前授权店铺商品总数会随店铺实时变化；最近一次复测为 821 条。
• 线上 https://server.fmode.cn/backend/vO3T8gAdwB/data 仍返回 404，说明多应用 Parse 后端还没有挂载，暂时不能写入目标库。

导入内容

默认导入前 10 个商品，并写入：

• ProductDetail：商品主档、类目、品牌、价格、原始详情响应；
• Product：现有系统商品主表兼容字段；
• AsinSkuMapping：京东商品与 SKU 关系；
• JdStockSnapshot：库存、预占库存、仓库和采集时间。

订单、销量、GMV、流量、退款、评价不会由商品接口伪造填充。

运行方式

先设置环境变量，不把密钥写进脚本或前端：

$env:JD_SOURCE_PARSE_URL = "https://server.fmode.cn/parse"
$env:JD_SOURCE_PARSE_APP_ID = "主 Parse 应用 ID"
$env:JD_SOURCE_PARSE_MASTER_KEY = "主 Parse Master Key"
$env:JD_TARGET_PARSE_URL = "https://server.fmode.cn/backend/vO3T8gAdwB/data"
$env:JD_TARGET_PARSE_APP_ID = "vO3T8gAdwB_main"
$env:JD_TARGET_PARSE_MASTER_KEY = "目标应用 Master Key"
$env:JD_APP_KEY = "京东 AppKey"
$env:JD_APP_SECRET = "京东 AppSecret"

npm run import:jd-products -- --dry-run --limit 10
npm run import:jd-products -- --limit 10

--dry-run 只读取京东并输出数量和商品 ID；正式导入使用业务键更新，重复运行不会重复创建同一商品、SKU 或当天库存快照。