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

京东首批商品导入

当前状态

• 京东商品、SKU、库存接口已经在同一授权进程中验证成功。
• getProduct 已修复：URL path 中的 productId 必须加入 MD5 待签名字段，不能重复放入 query。
• 当前授权店铺商品总数会随店铺实时变化；2026-08-21 最近一次复测为 824 条。
• https://server.fmode.cn/backend/vO3T8gAdwB/data 是挂载前缀，直接 GET 返回 404；正确 class 资源为 {base}/classes/<ClassName>。
• 已通过 {base}/classes/ProductDetail 完成读取和正式幂等写入。详细证据见 JD-PRODUCT-DETAIL-PARSE-VERIFICATION-2026-08-21.md。
• Listing AI 新同步器已完成 824 个动态目录商品的全量源快照同步和评分验收；结果见 LISTING-AI-IMPLEMENTATION-REPORT-2026-08-21.md。本页旧 import:jd-products 命令仅保留兼容/小批诊断用途。

导入内容

默认导入前 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 = "目标 Parse Application ID"
$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 或当天库存快照。

不要用目标 Parse 挂载前缀的根 GET 作为健康检查，也不要依赖当前环境的 count=1 结果判断是否有数据。现阶段 readiness 应请求：

{JD_TARGET_PARSE_URL}/classes/ProductDetail?limit=1

并校验 HTTP 200、JSON body 和 results 数组。上游存在间歇性 HTTP 403 / Parse code 119；仅对此精确错误做有限退避重试。