# 广联智通 — 集成约定与接口规范
> 本文件记录广联智通 SAP 系统与外围系统的集成架构、接口规范和开发清单。
> 更新日期：2026-07-06

## 使用说明
- 本文件是广联智通系统集成的总纲，定义了SAP与6大外围系统的集成关系
- 共134项开发（92项系统对接 + 48项SAP端开发）
- 接口规格来源：`02-实现阶段/系统开发/开发功能说明书/` 下各接口功能说明书
- 状态标记：✅ 已有 = 功能说明书已确认；待现场确认 = 规格未完成，需后续补充
- 如需复核原文，按接口名称在 `02-实现阶段/系统开发/开发功能说明书/` 下查找

---

## 一、集成架构总览

### 系统集成拓扑
```
                    ┌─────────────┐
                    │   SAP S/4   │
                    │  HANA Cloud │
                    └──────┬──────┘
                           │
        ┌──────────────────┼──────────────────┐
        │                  │                  │
   ┌────┴────┐       ┌────┴────┐       ┌────┴────┐
   │  CRM    │       │  MES    │       │  WMS    │
   │ (小满)  │       │ (生产)  │       │ (仓储)  │
   └─────────┘       └─────────┘       └─────────┘
        │                  │                  │
   ┌────┴────┐       ┌────┴────┐       ┌────┴────┐
   │   OA    │       │  OMS    │       │  费控   │
   │ (审批)  │       │ (电商)  │       │ (报销)  │
   └─────────┘       └─────────┘       └─────────┘
```

### 集成方式
| 集成方式 | 说明 | 适用场景 |
|---------|------|---------|
| SAP CPI | 云端集成平台，API-based | 主数据同步、业务数据推送 |
| OData API | SAP标准API | 查询/更新SAP业务对象 |
| REST API | HTTP接口 | 外围系统调用 |
| 文件接口 | CSV/Excel批量传输 | 历史数据迁移、批量主数据 |

---

## 二、开发项统计（已提取自蓝图汇报）

### 总体统计
| 类别 | 开发项数 | 优先级 | 说明 |
|------|---------|--------|------|
| **费控集成** | 3项 | 高 | OA→SAP费用报销/借款/还款 |
| **CRM集成** | 26项 | 高 | 客户/报价/订单/发货/退货/开票 |
| **MES集成** | 10项 | 高 | 生产订单/投料/报工/完工入库/关单 |
| **OA集成** | 14项 | 中 | 供应商/费用/付款/成本中心等审批 |
| **OMS集成** | 14项 | 高 | 2C电商订单/发货/退货/库存同步 |
| **WMS集成** | 24项 | 高 | 收货/发货/移库/盘点/库存查询 |
| **SAP报表** | 14项 | 中 | 自定义报表开发 |
| **SAP功能** | 29项 | 中 | 增强功能开发 |
| **合计** | **134项** | | |

### 已提取的开发规格文档（31份）
| 序号 | 接口名称 | 涉及系统 | 开发类型 |
|------|---------|---------|---------|
| 1 | 客户主数据创建接口 | CRM→SAP | 接口 |
| 2 | 供应商创建接口 | OA→SAP | 接口 |
| 3 | 供应商更改接口 | OA→SAP | 接口 |
| 4 | 供应商发票接口 | OA→SAP | 接口 |
| 5 | 物料主数据创建接口 | WMS→SAP | 接口 |
| 6 | BOM主数据查询接口 | SAP→MES | 接口 |
| 7 | 工艺路线创建及修改接口 | OA→SAP | 接口 |
| 8 | 生产订单投料接口 | MES→SAP | 接口 |
| 9 | 生产报工及报工冲接口 | MES→SAP | 接口 |
| 10 | 生产完工入库接口 | MES→SAP | 接口 |
| 11 | 生产订单技术性关闭接口 | MES→SAP | 接口 |
| 12 | 生产订单查询及更改接口 | SAP→MES | 接口 |
| 13 | 生产订单状态修改接口 | SAP→MES | 接口 |
| 14 | 生产备料调拨接口 | MES→WMS→SAP | 接口 |
| 15 | 委外发料、退料接口 | MES→SAP | 接口 |
| 16 | 销售发货接口 | WMS→SAP | 接口 |
| 17 | 销售退货接口 | WMS→SAP | 接口 |
| 18 | 销售订单行WBS自动填充 | SAP增强 | 功能 |
| 19 | 采购入库、退货、冲销接口 | WMS→SAP | 接口 |
| 20 | 采购订单查询接口 | SAP→WMS | 接口 |
| 21 | 采购信息记录接口 | SAP→WMS | 接口 |
| 22 | 其他出入库接口 | WMS→SAP | 接口 |
| 23 | 工厂内两步法调拨接口 | WMS→SAP | 接口 |
| 24 | STO&UB转储单查询接口 | SAP→WMS | 接口 |
| 25 | 货源清单接口 | SAP→WMS | 接口 |
| 26 | 资产创建与采购接口 | OA→SAP | 接口 |
| 27 | 员工借款还款接口 | OA→SAP | 接口 |
| 28 | 费用报销接口 | OA→SAP | 接口 |
| 29 | 项目创建维护接口 | OA→SAP | 接口 |
| 30 | B2C结算表设计 | SAP报表 | 报表 |
| 31 | 生产订单API | SAP→MES | 接口 |

---

## 三、各系统集成详细清单

### 3.1 CRM集成（26项）
> 来源：02-实现阶段/系统开发/开发功能说明书/客户主数据创建接口_20260521 + 小满CRM接口文档

#### 已确认接口
| 接口名称 | 方向 | 说明 | 功能说明书/状态 |
|---------|------|------|-----------|
| 客户主数据创建 | CRM→SAP | 成单客户同步SAP | ✅ 已有 |
| 报价单同步 | CRM→SAP | 报价→SAP报价单 | 待现场确认 |
| 销售订单同步 | CRM→SAP | 成单→SAP销售订单 | 待现场确认 |
| 发货通知 | SAP→CRM | SAP发货→CRM通知 | 待现场确认 |
| 退货处理 | WMS→SAP→CRM | 退货流程 | ✅ 已有 |
| 开票同步 | SAP→CRM | SAP开票→CRM | 待现场确认 |
| 客户查询 | SAP→CRM | 查询SAP客户数据 | 待现场确认 |
| 库存查询 | SAP→CRM | 查询SAP库存 | 待现场确认 |
| ... | | 共26项 | |

#### 关键业务规则
- **触发时机**：CRM成单后实时同步
- **数据映射**：CRM客户编码↔SAP客户编码
- **审批流程**：CRM报价→OA审批→SAP订单

---

### 3.2 MES集成（10项）
> 来源：02-实现阶段/系统开发/开发功能说明书/下各MES接口功能说明书（2026-06）

#### 已确认接口
| 接口名称 | 方向 | 说明 | 功能说明书/状态 |
|---------|------|------|-----------|
| 生产订单同步 | SAP→MES | SAP订单→MES执行 | ✅ 已有 |
| 生产投料 | MES→SAP | MES投料→SAP物料凭证 | ✅ 已有 |
| 生产报工 | MES→SAP | MES报工→SAP工时确认 | ✅ 已有 |
| 生产完工入库 | MES→SAP | 完工→SAP入库 | ✅ 已有 |
| 生产订单关闭 | MES→SAP | TECO标记 | ✅ 已有 |
| 生产订单查询 | SAP→MES | 查询订单状态 | ✅ 已有 |
| 生产订单状态修改 | SAP→MES | 修改订单状态 | ✅ 已有 |
| BOM查询 | SAP→MES | 查询生产BOM | ✅ 已有 |
| 工艺路线同步 | OA→SAP→MES | 工艺路线变更 | ✅ 已有 |
| 生产备料调拨 | MES→WMS→SAP | 备料发料 | ✅ 已有 |

#### 关键业务规则
- **触发时机**：MES实物操作后实时同步
- **数据流向**：MES→SAP（投料/报工/入库）；SAP→MES（订单/BOM/工艺路线）
- **异常处理**：接口失败→重试3次→告警→人工处理

---

### 3.3 OA集成（14项）
> 来源：02-实现阶段/系统开发/开发功能说明书/下各OA接口功能说明书（2026-06）

#### 已确认接口
| 接口名称 | 方向 | 说明 | 功能说明书/状态 |
|---------|------|------|-----------|
| 供应商创建 | OA→SAP | 供应商审批→SAP创建 | ✅ 已有 |
| 供应商更改 | OA→SAP | 供应商变更→SAP更新 | ✅ 已有 |
| 供应商发票 | OA→SAP | 发票审批→SAP过账 | ✅ 已有 |
| 费用报销 | OA→SAP | 报销审批→SAP过账 | ✅ 已有 |
| 员工借款 | OA→SAP | 借款审批→SAP过账 | ✅ 已有 |
| 员工还款 | OA→SAP | 还款审批→SAP过账 | ✅ 已有 |
| 付款申请 | OA→SAP | 付款审批→SAP过账 | 待现场确认 |
| 成本中心变更 | OA→SAP | CC审批→SAP维护 | ✅ 已有 |
| 采购申请 | OA→SAP | PR审批→SAP | 待现场确认 |
| 资产创建 | OA→SAP | 资产审批→SAP创建 | ✅ 已有 |
| 项目创建 | OA→SAP | 项目审批→SAP创建 | ✅ 已有 |
| ... | | 共14项 | |

#### 关键业务规则
- **触发时机**：OA审批通过后实时同步
- **审批层级**：费用金额决定审批层级
- **数据映射**：OA申请单号↔SAP凭证号

---

### 3.4 OMS集成（14项）
> 来源：GL-EB-MR-012~025 2C电商流程蓝图；OMS接口详细规格待补充

#### 已确认接口
| 接口名称 | 方向 | 说明 | 功能说明书/状态 |
|---------|------|------|-----------|
| 2C订单同步 | OMS→SAP | 电商订单→SAP | 待现场确认 |
| 订单取消 | OMS→SAP | 取消→SAP取消 | 待现场确认 |
| 发货通知 | WMS→SAP→OMS | 发货→电商平台 | 待现场确认 |
| 退货同步 | OMS→SAP | 退货→SAP退货单 | 待现场确认 |
| 库存同步 | SAP→OMS | SAP库存→OMS | 待现场确认 |
| 结算数据 | SAP→OMS | 结算→OMS | 待现场确认 |
| ... | | 共14项 | |

#### 关键业务规则
- **触发时机**：电商平台推送→OMS→SAP
- **结算模式**：Amazon=at settlement；其他=at goods issue
- **多店铺映射**：店铺编码↔SAP客户编码

---

### 3.5 WMS集成（24项）
> 来源：02-实现阶段/系统开发/开发功能说明书/下各WMS接口功能说明书（2026-05~06）

#### 已确认接口
| 接口名称 | 方向 | 说明 | 功能说明书/状态 |
|---------|------|------|-----------|
| 采购收货 | WMS→SAP | 收货→SAP物料凭证 | ✅ 已有 |
| 采购退货 | WMS→SAP | 退货→SAP凭证 | ✅ 已有 |
| 销售发货 | WMS→SAP | 发货→SAP过账 | ✅ 已有 |
| 销售退货 | WMS→SAP | 退货→SAP凭证 | ✅ 已有 |
| 生产备料 | WMS→SAP | 备料→SAP调拨 | ✅ 已有 |
| 生产入库 | WMS→SAP | 入库→SAP凭证 | ✅ 已有 |
| 其他出入库 | WMS→SAP | 其他移动 | ✅ 已有 |
| 工厂内调拨 | WMS→SAP | 两步法调拨 | ✅ 已有 |
| STO转储查询 | SAP→WMS | 查询转储单 | ✅ 已有 |
| 库存查询 | SAP→WMS | 查询库存 | 待现场确认 |
| 盘点接口 | WMS→SAP | 盘点→SAP | 待现场确认 |
| 货源清单 | SAP→WMS | 查询货源 | ✅ 已有 |
| ... | | 共24项 | |

#### 关键业务规则
- **触发时机**：WMS实物操作后实时同步
- **数据流向**：WMS→SAP（收发货）；SAP→WMS（查询/清单）
- **库存地点映射**：WMS库位↔SAP库存地点

---

### 3.6 费控集成（3项）
> 来源：02-实现阶段/系统开发/开发功能说明书/费用报销/借款/还款接口（2026-06）

#### 已确认接口
| 接口名称 | 方向 | 说明 | 功能说明书/状态 |
|---------|------|------|-----------|
| 费用报销 | OA→SAP | 报销审批→SAP过账 | ✅ 已有 |
| 员工借款 | OA→SAP | 借款审批→SAP过账 | ✅ 已有 |
| 员工还款 | OA→SAP | 还款审批→SAP过账 | ✅ 已有 |

---

## 四、接口规范

### 4.1 认证方式
| 系统 | 认证方式 | 说明 |
|------|---------|------|
| SAP OData API | Basic Auth | 用户名+密码 |
| SAP REST API | OAuth 2.0 | Token认证 |
| CPI | Client Certificate | 证书认证 |

### 4.2 数据格式
| 格式 | 用途 |
|------|------|
| JSON | REST API主要格式 |
| XML | OData API格式 |
| CSV | 批量数据传输 |

### 4.3 错误处理
| 错误码 | 处理方式 |
|--------|---------|
| 200 | 成功 |
| 400 | 请求格式错误→检查参数 |
| 401 | 认证失败→检查凭证 |
| 403 | 权限不足→检查授权 |
| 404 | 资源不存在→检查对象 |
| 500 | 服务器错误→重试/告警 |

### 4.4 日志与监控
- **接口日志**：CPI平台记录所有接口调用
- **成功日志**：保留90天
- **失败日志**：保留365天
- **监控告警**：失败率>5%→邮件告警

---

## 五、待确认事项
> Owner & 目标日期：参见 `未决问题清单.md` #003/#007/#009/#010/#012/#013/#014

- [ ] 补充CRM集成剩余接口详细规格
- [ ] 补充OMS集成剩余接口详细规格
- [ ] 补充WMS集成剩余接口详细规格
- [ ] 补充SAP报表和功能开发详细规格
- [ ] 读取SAP报表开发清单，补充14项自定义报表
- [ ] 读取SAP功能开发清单，补充29项增强功能
- [ ] 补充接口异常处理详细流程
- [ ] 补充接口性能要求（响应时间/并发量）
