🔗 GOMS ECMS 全流程文档

请求参数

返回结构

BaseWarehouseEcmsDataVO
├── areaName / areaCode           // 区域
├── provinceName / provinceCode   // 府/州
├── districtName / districtCode   // 市/县
├── coverProvinceName             // 覆盖范围
└── warehouseList[]
    ├── priority                  // 优先级
    ├── warehouseCode             // 仓库编码
    ├── warehouseName             // 仓库名称
    └── locationList[]
        ├── location              // ← 这个值填入订单行!
        └── locationName

查询涉及的表

POST /goms/open-api/order/create
│
├─ [1] OrderController.createOrder()
│   └─ 提取 eventId，填充到参数
│
├─ [2] OmsOrderServiceImpl.createOrder()
│   └─ 日志记录 + 转发
│
├─ [3] OmsOrderServiceStubImpl.createOrder()
│   ├─ JSR303 参数校验
│   ├─ OpenOrderCreateParam → OrderCreateParam 转换
│   ├─ 设置履约模式 (PICKUP / NON_INTEGRATED)
│   ├─ 解密敏感信息 (手机号、地址 - DES)
│   ├─ 处理订单行 (仓库编码继承、赠品标记)
│   └─ 调用 FulfillmentOrderClient.createOrder() [Feign RPC]
│
├─ [4] FulfillmentOrderServiceStubImpl.createOrder()
│   ├─ ★ completeWarehouseInfo() ← 仓库补全
│   │   ├─ 从第一条订单行取 location
│   │   ├─ 查 oms_base_location_mapping 做映射
│   │   ├─ 查 oms_base_warehouse_location 取仓库
│   │   └─ 回填 warehouseCode + warehouseId
│   ├─ standardizeOrderParams() 参数标准化
│   │
│   ├─ [分支A: sourceDataValidate=true 校验模式]
│   │   ├─ checkIfOrderExist() 去重校验
│   │   ├─ updateMaterialStock() 库存预校验
│   │   ├─ 发送 MQ 消息
│   │   └─ 保存入池记录 (SUCCESS/ERROR)
│   │
│   └─ [分支B: sourceDataValidate=false 创建模式]
│       ├─ ★ 创建订单 (Redis 分布式锁)
│       │   ├─ 生成订单号: OL + 时间戳 + 5位序号
│       │   ├─ INSERT oms_order_outbound
│       │   ├─ INSERT oms_order_line_outbound
│       │   └─ INSERT oms_order_outbound_shipping_provider
│       ├─ 查询已创建订单
│       ├─ ★ createDownstreamAssets()
│       │   ├─ tryCreateWarehouseOrder() → 仓储单
│       │   ├─ tryCreateShippingOrder() → 运单
│       │   └─ tryCreateUserInfo() → 用户敏感信息
│       ├─ 更新库存关联记录
│       ├─ MQ 同步物流状态到 ECMS
│       └─ 入池状态更新为 MQ_SUCCESS

5.2 库位映射表作用

oms_base_location_mapping 用于库位编码的映射转换：

ECMS 和 GOMS 可能使用不同的库位编码体系，此表做桥接。

6.1 OrderStatusEnum 订单状态枚举

6.3 状态流转图

              ┌──────────────┐
              │ 01 INVOICE   │
              └──────┬───────┘
                     ▼
┌────────────────────────────────────────────┐
│ 02 PENDING ──→ 03 ASSIGNED ──→ 04 SHIPPING │
└───────┬───────────────────────────┬────────┘
        │                           │
        │ 库存校验失败                ▼
        ▼                   ┌───────────────┐
┌─────────────────┐         │ 10 SIGNED     │
│ 09 EXCEPTION    │         │ 11 REJECTED   │
│    _WAIT        │         │ 12 PART_SIGN  │
└─────────────────┘         └───────┬───────┘
                                    ▼
                            ┌───────────────┐
                            │ 06 COMPLETED  │
                            └───────────────┘

07 CANCELLED — 任意阶段可取消
08 FAILURE   — 拆包失败

6.4 入池状态（Inbound Pool）

7.1 核心订单表

7.2 仓储相关表

7.3 物流相关表

7.4 库存相关表

7.5 辅助表

阶段一：openapi 层预处理

🏗️ 架构设计

📊 涉及的模块总览

📌 模式说明

当 sourceDataValidate = true 时，系统不创建实际订单，仅执行数据校验、库存预占用并发送 MQ 消息。实际的订单创建在 MQ 消费端以 sourceDataValidate = false 模式异步完成。

ECMS 调用 API（sourceDataValidate=true）
       │
       ▼
  ┌──────────────────────────────────────┐
  │  goms-access-openapi 层              │
  │  1. JSR303 参数校验                  │
  │  2. 订单数据转换                     │
  │  3. 敏感信息解密（手机/地址）         │
  └──────────────┬───────────────────────┘
                 │ 调用履约服务
                 ▼
  ┌──────────────────────────────────────┐
  │  goms-agg-fulfillment 层             │
  │  1. 补齐仓库与库位映射信息            │
  │  2. 标准化处理入参字段               │
  │  3. 校验是否重复建单                 │
  │  4. 库存预占用校验                   │
  │     └─ 失败：标记异常待处理，继续     │
  │  5. 发送 MQ（源数据同步）            │
  │  6. 落库接单池（成功记录）           │
  └──────────────┬───────────────────────┘
                 │ 返回成功
                 ▼
    ┌─────────────────────────┐
    │  oms_inbound_ecms_order │
    │  status = SUCCESS (1)   │
    │  dataValidateStatus = 1 │
    └────────────┬────────────┘
                 │
                 │  (异步消费 MQ)
                 ▼
  ┌──────────────────────────────────────┐
  │  MQ 消费端（sourceDataValidate=false）│
  │  1. 创建销售出库订单                 │
  │  2. 创建仓储作业单                   │
  │  3. 创建运输作业单                   │
  │  4. 创建用户基础信息                 │
  │  5. 更新库存关联字段                 │
  │  6. 同步 ECMS 发货状态               │
  │  7. 更新接单池状态为 MQ_SUCCESS      │
  └──────────────────────────────────────┘

📨 发送 MQ 前的处理

📤 发送 MQ 详情

✅ 发送 MQ 成功后 — 落库接单池

调用 saveSuccessInboundEcmsOrderInfo(inboundOrderCreateParam)，写入表 oms_inbound_ecms_order：

❌ 发送 MQ 失败怎么办？

⚠️ 当前代码存在明显缺陷：

💡 建议改进：在 MQ 发送外层加 try-catch，失败时调用 saveErrorInboundEcmsOrderInfo(inboundOrderCreateParam, errorMsg, returnMsg) 记录失败数据，并考虑加入重试机制。

🔄 MQ 消费后处理（sourceDataValidate = false）

MQ 消息被 InboundSourceDataValidateConsumer 消费后（匹配 tag tag_inbound_order_source），以 sourceDataValidate=false 模式调用 omsOrderService.createOrder()，执行实际订单创建：

⚡ 消费失败处理：若 MQ 消费端抛出异常，InboundSourceDataValidateConsumer 会调用 omsInboundEcmsOrderClient.updateByOuterNo() 将接单池状态更新为 MQ_FAILED。

🗃️ 创建订单涉及的数据库表汇总（销售出库）

📊 接单池状态流转

oms_inbound_ecms_order.status 状态值：

  0 (ERROR)        数据校验未通过 / 校验阶段异常
  1 (SUCCESS)      MQ 发送成功（校验阶段写入）
  2 (MQ_SUCCESS)   MQ 消费成功（订单创建完成后更新）
  3 (MQ_FAILED)    MQ 消费失败（消费端异常时更新）

oms_inbound_ecms_order.data_validate_status 状态值：

  0 (ERROR)        校验失败
  1 (SUCCESS)      校验成功

🔑 关键代码位置