外部测试内部绑定ok

2026-04-12 13:16:50 +08:00
parent a95247cd01
commit 0029147bc4
31 changed files with 2826 additions and 124 deletions
@@ -0,0 +1,31 @@
+{
+  "item_id": 1033324289962,
+  "seller_id": 2209880145223,
+  "MsgTypeDes": "订单已付款",
+  "biz_order_id": "2701827483088138281",
+  "order_status": 2,
+  "_agisoTradeDetail": {
+    "sku": "6046726460016|商品名称:奥利奥动作",
+    "item": {
+      "price": 70,
+      "title": "【自动发货】蛋仔派对奥利奥皮肤、奥利奥呦呦、奥利奥动作",
+      "item_id": 1033324289962,
+      "pic_url": "https://gw.alicdn.com/bao/uploaded/i1/2209880145223/O1CN01QAHaJL1oSBmQaGffk_!!4611686018427387207-53-xy_item.heic"
+    },
+    "payment": 70,
+    "end_time": 0,
+    "pay_time": 1775953431000,
+    "post_fee": 0,
+    "isEticket": false,
+    "ship_time": 1775953434000,
+    "buy_amount": 1,
+    "buyer_nick": "梦里梦",
+    "isRecharge": false,
+    "create_time": 1775953408000,
+    "seller_nick": "大锤号商",
+    "biz_order_id": "2701827483088138281",
+    "order_status": 3,
+    "coupon_eticket_info": [],
+    "encryption_buyer_id": "enV7xJs5DRbJBzIH8uUUcg=="
+  }
+}
@@ -0,0 +1,77 @@
+# 商品识别与履约 SKU 配置
+
+当前后端已支持把外部商品先识别为内部履约 SKU，再继续匹配库存或人工履约。
+配置来源已经统一为后台管理页和后端数据文件，不再使用 `.env` 里的 `ORDER_FULFILLMENT_BINDINGS_JSON`。
+
+## 配置目标
+
+- `match` 负责识别外部商品
+- `skuCode` 代表内部履约 SKU
+- `profileKey` 决定后续走库存自动链路还是人工链路
+
+## 推荐配置格式
+
+后台保存后会写入后端数据文件：
+
+- `/app/data/order-fulfillment-bindings.json`
+
+配置结构如下：
+
+```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`
+- 未匹配到规则的商品会自动落到人工处理