# EDI 对接方案说明书（对外版）

> 用途：发给买方 EDI 团队或客户 IT 负责人，说明我方的对接能力、参数与流程。
> 使用时替换 `[]` 中的信息。

## 1. 概述

本文档描述我方（[公司名称]）与贵司之间的 EDI 电子数据交换对接方案。通过 ANSI X12 005010
标准报文实现订单、发货通知、发票的自动流转，替代邮件与手工表格，双方通过回执确认报文接收状态。

- 报文标准：ANSI X12 Version 005010
- 传输方式：AS2 v1.2（首选）/ SFTP over SSH
- 计划对接单据：

| 单据 | 名称 | 方向 |
|---|---|---|
| 850 | Purchase Order 采购订单 | 买方 → 我方 |
| 855 | PO Acknowledgement 订单确认 | 我方 → 买方 |
| 856 | Advance Ship Notice 发货通知 | 我方 → 买方 |
| 810 | Invoice 发票 | 我方 → 买方 |
| 997 | Functional Acknowledgment 功能回执 | 双向 |

## 2. 接入参数

### 2.1 测试环境

| 项 | 值 |
|---|---|
| AS2 URL | `https://edi-test.[domain]/as2` |
| AS2 Identifier | `[VEEKE_TEST]` |
| 公钥证书 | 附件 `veeke-test.cer` |
| 出口 IP | `[x.x.x.x]`（请加入白名单） |
| SFTP 主机 | `edi-test.[domain]:22`（如走 SFTP） |

### 2.2 生产环境

| 项 | 值 |
|---|---|
| AS2 URL | `https://edi.[domain]/as2` |
| AS2 Identifier | `[VEEKE_PROD]` |
| 公钥证书 | 附件 `veeke-prod.cer` |
| 出口 IP | `[x.x.x.x]` |
| SFTP 主机 | `edi.[domain]:22` |

### 2.3 需要贵司提供

1. 贵司 AS2 接收 URL 与 AS2 Identifier
2. 贵司公钥证书（用于我方签名校验与报文加密）
3. 贵司出口 IP（用于我方防火墙白名单）
4. 官方 Implementation Guide（PDF 或门户链接）
5. 测试环境参数与测试数据
6. 联调联系人与验收标准

## 3. 数据格式约定

- 字符集：ASCII，禁止在报文中直接写入非 ASCII 字符
- 日期：CCYYMMDD，例 `20261116`
- 时间：HHMM，24 小时制
- 币种：ISO 4217，如 USD / CNY
- 计量单位：按买方 IG 的代码表，如 EA / CTN / PL
- 金额：保留 2 位小数，不使用千分位
- 分隔符：从 ISA 段读取，不固定假设

## 4. 业务流转

1. 买方下发 850 → 我方解析、校验、写入业务系统
2. 校验通过返回 997 Accept；校验失败返回 997 Reject（AK4 指出错误段与元素）
3. 我方确认订单后发送 855
4. 出库后发送 856（含 SSCC 箱码与托盘层级）
5. 开票后发送 810
6. 买方对我方报文返回 997，我方更新单据状态

## 5. 异常与责任边界

| 场景 | 处理方式 |
|---|---|
| 报文格式错误 | 我方生成 997 Reject，买方按 AK4 修正后重发 |
| 通道不可达 | 双方检查 IP 白名单、证书有效期与防火墙策略 |
| MDN 超时 | 我方按退避策略重试，达上限后告警并人工介入 |
| 业务数据争议 | 以归档的原始报文与回执作为对账依据 |

## 6. 上线流程

1. 交换证书 / 密钥，连通性测试
2. 按《验收测试用例》逐条联调
3. 买方 EDI 团队书面确认
4. 切换生产，首日盯盘
5. 进入日常监控与证书轮换周期

## 7. 联系

- 技术联系人：[姓名] / [邮箱] / [电话]
- 支持时间：工作日 9:00–18:00（UTC+8），紧急问题走电话
