order_site/docs/商品识别与履约SKU配置.md

商品识别与履约 SKU 配置

当前后端已支持把外部商品先识别为内部履约 SKU，再继续匹配库存或人工履约。 配置来源已经统一为后台管理页和后端数据文件。

配置目标

• match 负责识别外部商品
• skuCode 代表内部履约 SKU
• profileKey 决定后续走库存自动链路还是人工链路

推荐配置格式

后台保存后会写入后端数据文件：

• /app/data/order-fulfillment-bindings.json

配置结构如下：

[
  {
    "provider": "agiso",
    "platform": "xianyu",
    "shopId": "2209880145223",
    "skuCode": "sjz_hdl_test01",
    "profileKey": "tencent_claim_redeem",
    "priority": 10,
    "config": {
      "note": "三角洲行动腾讯兑换码自动领取"
    },
    "match": {
      "externalSkuCode": "6228372634012",
      "externalItemId": "1040695550204",
      "externalSkuName": "周边",
      "config": {
        "resolvedSkuName": "三角洲行动-自动领取"
      }
    }
  },
  {
    "provider": "agiso",
    "platform": "xianyu",
    "shopId": "2209880145223",
    "skuCode": "danzai_manual_special",
    "profileKey": "manual_review",
    "priority": 20,
    "match": {
      "externalSkuCode": "7000000000001",
      "externalSkuName": "需要人工发货的商品"
    }
  }
]

匹配顺序

系统会按下面顺序匹配外部商品：

1. externalSkuCode
2. externalItemId
3. 归一化后的 externalSkuName
4. 名称包含关系兜底

其中店铺级规则优先于平台级和全局级规则。

当前落库行为

• 订单商品的 sku_code 会保存为内部履约 SKU
• 原始外部商品信息会保留在 item_snapshot_json
• 后续履约任务、库存预占、领取链接都会按内部履约 SKU 继续执行

生效方式

• 后台保存后会立即同步到 sku_fulfillment_bindings
• 同时会同步到 product_match_rules
• 未匹配到规则的商品会自动落到人工处理