2026-03-25 23:59:29 +08:00
|
|
|
# 外部接口与集成盘点模板（ERP/财务/供应商门户/客户门户）
|
|
|
|
|
|
2026-09-01 18:05:18 +08:00
|
|
|
> 文档定位：**接口梳理与集成盘点模板文档**。
|
|
|
|
|
> 本文是用于外部系统对接时的模板，不作为当前项目状态或当前接口实现清单的权威说明。当前状态见 [../STATUS.md](../STATUS.md)，当前架构见 [../ARCHITECTURE.md](../ARCHITECTURE.md)。
|
|
|
|
|
|
2026-03-25 23:59:29 +08:00
|
|
|
## 1. 接口清单
|
|
|
|
|
|
|
|
|
|
| 接口名称 | 调用方向 | 协议 | 鉴权 | 频率 | 单次数据量 | 幂等键 | 超时 | 重试策略 | 死信/补偿 | 负责人 |
|
|
|
|
|
|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
| | | HTTP/REST / MQ / SFTP | OAuth2/JWT/签名 | | | order_no/txn_no | | | | |
|
|
|
|
|
|
|
|
|
|
## 2. 字段映射表
|
|
|
|
|
|
|
|
|
|
| 业务对象 | 源系统.源字段 | 目标系统.目标字段 | 类型转换 | 单位换算 | 币种换算 | 枚举映射 | 空值策略 | 校验规则 |
|
|
|
|
|
|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
| 客户订单 | | | | | | | | |
|
|
|
|
|
| 采购订单 | | | | | | | | |
|
|
|
|
|
| 到货/入库 | | | | | | | | |
|
|
|
|
|
| 财务收付 | | | | | | | | |
|
|
|
|
|
|
|
|
|
|
## 3. 失败重试与对账
|
|
|
|
|
|
|
|
|
|
| 场景 | 失败判定 | 重试间隔 | 最大重试 | 幂等保障 | 对账口径 | 补偿脚本 |
|
|
|
|
|
|---|---|---|---|---|---|---|
|
|
|
|
|
| | | | | | | |
|
