实现业务透明度：管易云与金蝶云集成最佳实践

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   监听层    │ →  │   缓冲层    │ →  │   执行层    │
│  (Webhook/  │    │ (内存队列   │    │ (分布式事务) │
│   Binlog)   │    │  削峰填谷)  │    │             │
└─────────────┘    └─────────────┘    └─────────────┘

┌─────────────────────────────────────────────────────────────┐
│                        业务层                                │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
│  │   订单同步    │    │   库存同步    │    │   财务对接    │  │
│  └──────────────┘    └──────────────┘    └──────────────┘  │
├─────────────────────────────────────────────────────────────┤
│                        转换层                                │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
│  │  字段映射    │    │  格式转换    │    │  数据清洗    │  │
│  └──────────────┘    └──────────────┘    └──────────────┘  │
├─────────────────────────────────────────────────────────────┤
│                        连接层                                │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
│  │  安全认证    │    │  通道加密    │    │  连接池管理  │  │
│  └──────────────┘    └──────────────┘    └──────────────┘  │
└─────────────────────────────────────────────────────────────┘

{
  "API名称": "gy.erp.trade.deliverys.get",
  "请求方法": "POST",
  "关键参数": {
    "start_delivery_date": "{{LAST_SYNC_TIME|datetime}}",
    "end_delivery_date": "{{CURRENT_TIME|datetime}}",
    "page_no": "{PAGINATION_START_PAGE}",
    "page_size": "{PAGINATION_PAGE_SIZE}"
  },
  "响应字段": {
    "订单基础信息": ["code", "outer_code"],
    "物流数据": ["express_no", "express_name"],
    "商品明细": ["details.item_name", "details.qty"]
  }
}

{
  "接口名称": "batchSave",
  "业务对象": "SAL_OUTSTOCK",
  "请求方法": "POST",
  "核心字段映射": {
    "FBillNo": "{{code}}",
    "FDate": "{{delivery_date}}",
    "FCustomerID": "{{shop_code}}",
    "FMaterialID": "{{item_code}}",
    "FQty": "{{qty}}"
  },
  "其他参数": {
    "FormId": "SAL_OUTSTOCK",
    "Operation": "Save",
    "IsAutoSubmitAndAudit": true
  }
}

POST /api/v1/material/query
Headers:
  Content-Type: application/json
  Authorization: Bearer {token}

请求示例：
{
  "FilterString": "FApproveDate>='2023-01-01'",
  "FieldKeys": ["FNumber", "FName", "FSpecification"],
  "FormId": "BD_MATERIAL"
}

// 根据店铺代码和仓库代码动态映射销售组织
function mapSaleOrg(shopCode, warehouseCode) {
  const specialWarehouses = ['095', '0361', '001', '034', '055', '017', '008'];
  if (shopCode === 'x01' && specialWarehouses.includes(warehouseCode)) {
    return '107';
  }
  return shopCode;
}