# X12 5010 报文样例集

> 用于本地解析器与生成器调试。正式开发必须对照买方官方 IG。
> 所有样例的分隔符由 ISA 段定义：元素分隔符 `*`、段分隔符 `~`、子元素分隔符 `:`（示例约定）。

## 1. 850 采购订单

```
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~
REF*IA*V8842~
N1*BY*BUYER DC #4021*9*4021~
N3*100 DISTRIBUTION WAY~
N4*ANYTOWN*CA*90001*US~
PO1*1*1200*EA*8.40*UP*SKU-8842~
PID*F****WIDGET 200MM~
PO1*2*640*EA*3.15*UP*SKU-1190~
PID*F****WIDGET 120MM~
CTT*2~
SE*14*0001~
GE*1*1~
IEA*1*000000001~
```

要点：
- `BEG03` 是买方订单号，业务主键。
- `PO1` 为循环段，每行一组，`PO1*01` 是行号。
- `CTT` 汇总行数，可用于交叉校验。

## 2. 855 订单确认

```
ST*855*0001~
BAK*00*AC*PO-20261116-001*20261116~
AK1*PO*000000001~            <-- 关联原始 850 的控制号
PO1*1*1200*EA*8.40*UP*SKU-8842~
ACK*IA*1200*EA~
PO1*2*640*EA*3.15*UP*SKU-1190~
ACK*IA*640*EA~
SE*9*0001~
```

要点：`BAK02` 表示接受状态（AC 接受 / AD 拒绝带原因），`AK1` 指回原订单。

## 3. 856 ASN（三层结构：Shipment → Pallet → Carton → Item）

```
ST*856*0001~
BSN*00*ASN-20261116-01*20261116*1430~
HL*1**S~
TD1*CTN25*3~
TD5**2*UPSN~
REF*BM*1Z999AA10123456784~
N1*SH*VEEKE WAREHOUSE~
N1*ST*BUYER DC #4021~
HL*2*1*T~                    <-- Pallet
HL*3*2*P~                    <-- Carton
MAN*GM*00012345678901234~     <-- SSCC
HL*4*3*I~                    <-- Item
LIN*1*UP*SKU-8842~
SN1*1*600*EA~
HL*5*3*I~
LIN*2*UP*SKU-8842~
SN1*2*600*EA~
SE*30*0001~
```

要点：
- `HL` 层级由 `HL01` 序号、`HL02` 父级、`HL03` 层级码组成（S/T/P/I）。
- 箱内数量必须与 `SN1` 合计一致，否则买方整单拒收。
- `MAN*GM` 后是 18 位 SSCC，含校验位。

## 4. 810 发票

```
ST*810*0001~
BIG*20261116*INV-20261116-01*PO-20261116-001*20261116~
N1*ST*BUYER DC #4021~
N1*RE*VEEKE~
IT1*1*1200*EA*8.40**SKU-8842~
PID*F****WIDGET 200MM~
IT1*2*640*EA*3.15**SKU-1190~
TDS*14976~
SAC*A*F050***0~
SE*10*0001~
```

要点：`TDS` 为总金额（分为单位或按 IG 约定），`IT1` 行金额需与 856 发货数量对应。

## 5. 997 功能回执

```
ST*997*0001~
AK1*PO*000000001~
AK2*850*0001~
AK5*A~                        <-- A 接受 / R 拒绝 / E 部分接受
AK9*A*1*1*1~
SE*5*0001~
```

拒绝时：

```
AK5*R~
AK4*1*PO1*03*7*3~
AK9*R*1*1*0~
```

要点：`AK4` 依次为「段位置、段标识、元素位置、错误代码、错误计数」，定位问题时先看这一行。

## 6. 解析实现提醒

1. 分隔符从 ISA 段首 105 个字符内推断，不要假设固定为 `*` 与 `~`。
2. 段循环按标识符分组：`PO1` 开始新行，`PID`/`REF` 归属上一行。
3. `SE` 段的计数必须与 `ST` 到 `SE` 之间的段数一致，生成时自动计算。
4. 控制号（ISA13、GS06、ST02）三层各自独立，遵循买方要求。
5. 生成报文时先做字段长度与格式校验，再拼接，避免生成后再回修。
