Resources

EDI 对接资料库

11 份可自由使用的文档:对接模板、技术规范、AS2 与 SFTP 实施手册、故障排查与术语表。 Markdown 格式,下载后可直接改造成你项目里的对接文档。

可直接下载

对接模板(5 份)

拿去改名字就能用,减少从零起草的时间。

MD

上线前检查清单

edi-checklist.md

下载

通道、证书、映射、回执、归档、告警共 12 项逐条勾选,避免测试通过但上线翻车。

Checklist上线
MD

向买方索要 IG 的英文邮件模板

edi-ig-request-mail.md

下载

含 AS2 参数、证书、测试环境、校验规则清单,可直接发给买方 EDI 团队。

邮件模板IG
MD

字段映射表模板

edi-field-mapping.md

下载

EDI 段与元素、业务字段、转换规则、必填与示例四列对照,按买方一份。

Mapping开发
MD

验收测试用例

edi-test-cases.md

下载

9 条核心用例,覆盖正常单据、字段缺失、重复报文、回执超时与损坏文件。

测试验收
MD

X12 5010 报文样例集

x12-samples.md

下载

850 / 855 / 856 / 810 / 997 骨架与关键段说明,用于本地解析器调试。

X12样例
自研文档

实施规范与手册(6 份)

从对接说明书到技术规范、协议手册与排障流程,覆盖项目全周期。

MD

EDI 对接方案说明书(对外版)

edi-integration-guide.md

下载

可直接发给买方 EDI 团队的方案文档:接入参数、格式约定、流转时序、异常责任边界。

对外文档方案
MD

EDI 服务技术规范(内部版)

edi-technical-spec.md

下载

架构分层、报文状态机、PostgreSQL 表结构、映射模板 JSON、重试与安全约束。

技术架构
MD

AS2 对接实施手册

as2-implementation-manual.md

下载

AS2 头字段、签名与 MDN 配置、OpenSSL 证书生成命令、常见报错与轮换流程。

AS2证书
MD

SFTP 对接实施手册

sftp-implementation-manual.md

下载

目录约定、密钥认证、原子写、文件命名、轮询归档与回执约定。

SFTP通道
MD

EDI 故障排查手册

edi-troubleshooting.md

下载

按方向与层级定位问题:收不到、解析失败、无 MDN、业务拒收、证书与跨境链路。

排障运维
MD

EDI 术语表

edi-glossary.md

下载

X12 交易集、报文结构、传输协议、物流编码与 997 错误码对照,沟通对齐用。

术语入门
样例

X12 5010 报文骨架

用于理解段结构,正式开发必须对照买方 IG。

850 · Purchase Order入站
ISA*00*          *00*          *ZZ*BUYER       *ZZ*VEEKE        *261116*1430*U*00501*000000001*0*T*:~
GS*PO*BUYER*VEEKE*20261116*1430*1*X*005010~
ST*850*0001~
BEG*00*NE*PO-20261116-001*20261116~
N1*BY*BUYER DC #4021~
PO1*1*1200*EA*8.40*UP*SKU-8842~
PO1*2* 640*EA*3.15*UP*SKU-1190~
SE*6*0001~
GE*1*1~
IEA*1*000000001~
856 · ASN 层级结构出站
ST*856*0001~
BSN*00*ASN-20261116-01*20261116*1430~
HL*1**S~                    <--  shipment
TD1*CTN25*3~
HL*2*1*T~                   <--  pallet
HL*3*2*P~                   <--  carton (SSCC)
MAN*GM*00012345678901234~
HL*4*3*I~                   <--  item
LIN*1*UP*SKU-8842~
SN1*1*1200*EA~
SE*22*0001~
提示

分隔符由 ISA 段定义,不要在代码里硬编码 * 与 ~;循环段与层级(HL)是解析最容易出错的地方。

需要完整资料包?

含对外对接说明、内部技术规范、AS2/SFTP 实施手册、验收用例、故障排查手册与映射表模板。 留资后我们会把整包发到你的邮箱。