Ferrari AVIEXP EDI 对接指南:报文解析、发运通知与 ERP 集成
© All rights reserved. • 西安知行软件有限公司 • 陕ICP备09022277号
AVIEXP 是 Ferrari 使用的 ODETTE 发运通知报文,可理解为 ASN / Dispatch Advice。它的业务作用类似 Renault DESADV:供应商在发货时告诉客户“这次实际发了哪些物料、数量是多少、对应哪张交货单、使用了什么包装”。
本文参考当前 Ferrari 项目使用的 AVIEXP OD3 / INTESA 规范,并结合完整测试报文与 JSON 解析结果,说明 AVIEXP 的关键字段、样例业务含义和对接注意事项。文中示例已脱敏;为避免文档过长,报文原文只保留关键骨架。
AVIEXP 要解决什么问题?
| 问题 | AVIEXP 中的典型信息 |
|---|---|
| 谁发给 Ferrari | UNB、CDT、SDT |
| 发到哪里 | CSG 收货方、工厂/装卸点代码 |
| 发什么 | ARD Ferrari 物料号、描述、数量、订单号 |
| 怎么包装 | TCO 包装类型、包装数量、包装内数量、Dispatch Note Date |
| 对应哪张单据 | DAN,例如 630 Delivery note |
本项目使用 Ferrari/INTESA 约定的 AVIEXP:3:0:OD:INTESA 报文结构,虽然带有 EDIFACT 信封,但业务段为 Ferrari 项目约定的 MID/CDT/SDT/CSG/ARD/ADP/TCO/DAN 结构,不能直接套用标准 EDIFACT DESADV 的 BGM/NAD/CPS/PAC/LIN/QTY 段结构。
Ferrari AVIEXP 需求概览
| 项目 | Ferrari AVIEXP 要求 |
|---|---|
| 报文标准 | 当前 Ferrari 项目使用的 AVIEXP OD3 报文版本 |
| 测试报文类型 | AVIEXP:3:0:OD:INTESA |
| 业务用途 | 发运通知 / Dispatch Advice / ASN |
| 报文编号 | MID Identification number of dispatch advice |
| 发货方 | CDT Consignor details |
| 供应商 | SDT Seller details |
| 收货方 | CSG Consignee details |
| 物料明细 | ARD Article details |
| 批次/行项目扩展 | ADP Line item specific data |
| 包装信息 | TCO Type of Package |
| 单据引用 | DAN Document reference |
报文原文示例(已脱敏)
下面保留测试报文的关键骨架。重复的 ARD/ADP/TCO 明细用省略号表示;省略号不是正式 EDI 内容,生产报文必须完整展开并重新计算 UNT 段数。
UNA:+.?*'
UNB+UNOA:1+27****:AA+FERRARI:AA+260623:1457+000000***++++++1'
UNH+1+AVIEXP:3:0:OD:INTESA'
MID+27****20260623***+260623:0000'
CDT+:SUPPLIER-NAME-DEMO:SUPPLIER-ADDR-1:SUPPLIER-ADDR-2:SUPPLIER-ADDR-3'
SDT+::::::27****'
CSG+0940********0366:Ferrari Spa-****:WAREHOUSE-DEMO:ADDRESS-DEMO:::030'
ARD+055087***::BLACK SCREEN FISSO DX CPL+23:PCE+000012****'
ADP++20260623'
TCO+PALLET:260623+18+1:PCE'
TCO+PALLET:260623+5+1:PCE'
ARD+055086***::BLACK SCREEN FISSO SX CPL+22:PCE+000012****'
ADP++20260623'
TCO+PALLET:260623+18+1:PCE'
TCO+PALLET:260623+4+1:PCE'
...
ARD+055090***::CONDOTTO PORTA ANT. SX CPL OPT+5:PCE+000012****'
ADP++20260623'
TCO+PALLET:260623+1+5:PCE'
DAN+630+260623***+260623:0000'
UNT+33+1'
UNZ+1+000000***'
样例报文传递了什么?
以下统计基于完整测试报文及 JSON 解析结果,正文仅展示脱敏节选。测试报文包含 7 个物料、12 条 TCO 包装信息;JSON 解析结果中还可看到包装尺寸、毛重、净重等扩展字段。
| 业务信息 | 脱敏示例 | 说明 |
|---|---|---|
| 报文类型 | AVIEXP:3:0:OD:INTESA |
ODETTE AVIEXP V3 |
| 发运通知编号 | 27****20260623*** |
MID 中的 dispatch advice number |
| 报文日期时间 | 2026-06-23 00:00 |
MID 日期时间 |
| 供应商代码 | 27**** |
SDT / UNB 中出现 |
| 收货方代码 | 0940********0366 |
CSG 中出现 |
| 装卸/工厂代码 | 030 |
CSG Loading point / warehouse code |
| 单据类型 | 630 |
DAN,Delivery note |
| 单据号 | 260623*** |
可作为随货单/交货单引用 |
| 物料数量 | 7 个 | 每个 ARD 一条物料 |
| 包装行数 | 12 条 | 每个 TCO 一条包装信息;统计基于完整测试报文 |
| 发运总数量 | 98 PCE | 7 个物料数量合计 |
| 包装数量合计 | 74 | 按 TCO/7224 Number of Packages 汇总 |
| 毛重 / 净重 | 423.00 / 279.00 KGM | 来自 JSON 解析结果 |
样例物料汇总如下:
| 序号 | Ferrari 零件号 | 描述 | 数量 | 单位 | 订单号 | 包装行 |
|---|---|---|---|---|---|---|
| 1 | 055087*** |
BLACK SCREEN FISSO DX CPL | 23 | PCE | 000012**** |
2 |
| 2 | 055086*** |
BLACK SCREEN FISSO SX CPL | 22 | PCE | 000012**** |
2 |
| 3 | 055086*** |
BLACK SCREEN MOBILE CPL OPT SURR VI | 23 | PCE | 000012**** |
4 |
| 4 | 055059*** |
CONDOTTO PORTA ANT. DX CPL | 10 | PCE | 000012**** |
1 |
| 5 | 055090*** |
CONDOTTO PORTA ANT. DX CPL OPT | 5 | PCE | 000012**** |
1 |
| 6 | 055059*** |
CONDOTTO PORTA ANT. SX CPL | 10 | PCE | 000012**** |
1 |
| 7 | 055090*** |
CONDOTTO PORTA ANT. SX CPL OPT | 5 | PCE | 000012**** |
1 |
关键段详解
1. UNB / UNH / MID
| 段 | 作用 | 样例含义 |
|---|---|---|
UNB |
交换信封 | 供应商发给 Ferrari,含交换日期时间和控制号 |
UNH |
消息头 | 指定报文为 AVIEXP:3:0:OD:INTESA |
MID |
发运通知编号与创建日期 | 当前样例编号由供应商代码和日期/流水类信息组成;实际编号规则以 Ferrari 项目规范为准 |
MID 是业务层面的发运通知编号,建议作为 ASN 主键之一;UNB/UNZ 更适合用于通信追踪和重发排查。编号生成规则不要按通用 ODETTE 经验写死,应以当前 Ferrari MIG 和项目约定为准。
2. CDT / SDT / CSG
| 段 | 规范含义 | 对接建议 |
|---|---|---|
CDT |
Consignor details,发货方/托运方 | 保存发货方名称和地址,涉及敏感信息时对外文档应脱敏 |
SDT |
Seller details,卖方/供应商 | 保存 Ferrari 分配的供应商代码 |
CSG |
Consignee details,收货方 | 保存 Ferrari 收货方、仓库/工厂/装卸点代码 |
这几个字段看起来都像公司或地点信息,但角色不同。ERP 映射时建议拆成发货方、卖方、收货方、装卸点四类字段。
3. ARD:物料与订单
ARD 是 AVIEXP 的物料明细段,包含 Ferrari 物料号、描述、发运数量、单位和订单/合同号。
ARD+055087***::BLACK SCREEN FISSO DX CPL+23:PCE+000012****'
| 字段 | 含义 |
|---|---|
7304 |
Ferrari 买方物料号 |
7008 |
物料描述 |
6270 |
发运数量 |
6410 |
计量单位,例如 PCE |
1022 |
合同号/订单号与行号组合 |
当前 Ferrari MIG 对 ARD/1022 的说明为合同/订单识别字段,常见实现会包含订单/合同号与位置号组合。若 ERP 需要拆分,不应凭经验固定截取,必须以当前 Ferrari 项目规范确认的长度规则处理。
4. ADP:批次和行项目扩展
样例中的 ADP++20260623 位于物料 ARD 之后,按当前 Ferrari MIG 字段表对应 Article Batch Number。实施时可先作为批次/批号字段保存到物料明细层;若业务要解释为生产日期、发运批次或其它项目字段,应以 Ferrari 项目确认口径为准。
5. TCO:包装信息
TCO 表示包装类型和包装数量,是 AVIEXP 中最容易出错的段。
TCO+PALLET:260623+18+1:PCE'
TCO+PALLET:260623+5+1:PCE'
| 字段 | 示例 | 含义 |
|---|---|---|
| Package Type | PALLET |
包装类型 |
| Dispatch Note Date | 260623 |
Ferrari MIG 中 1906 的字段名为 Dispatch Note Date;不要改写为 Package Reference Number,除非项目补充规范另有说明 |
| Number of Packages | 18、5 |
包装数量 |
| Quantity in Package | 1、1 |
每个包装中的物料数量,字段为 6853 |
| UOM | PCE |
数量单位 |
按 Ferrari MIG 字段含义,TCO/7224 是 Number of Packages,TCO/6853 是 Quantity of articles in package。两者在当前业务中的计算口径属于待确认项,文档中仅按 Ferrari MIG 字段名记录,不展开数量关系或校验公式。
6. DAN:交货单/随货单引用
DAN+630+260623***+260623:0000'
| 字段 | 示例 | 含义 |
|---|---|---|
| Document Code | 630 |
当前 Ferrari MIG 中用于 Delivery note;适用范围以当前项目规范为准 |
| Document Number | 260623*** |
交货单/随货单号 |
| Document Date | 260623 |
单据日期 |
DAN 应与 ERP 出库单、随货 DN、客户收货对账保持一致。
建议的 ERP 接口结构
FerrariAVIEXP
├─ Header
│ ├─ MessageType
│ ├─ DispatchAdviceNumber
│ ├─ MessageDateTime
│ ├─ SupplierCode
│ ├─ Consignor
│ ├─ Consignee
│ └─ LoadingPointCode
├─ Items[]
│ ├─ FerrariPartNumber
│ ├─ Description
│ ├─ QuantityDelivered
│ ├─ UnitOfMeasure
│ ├─ OrderNumber
│ ├─ BatchNumber
│ └─ Packages[]
│ ├─ PackageType
│ ├─ DispatchNoteDate
│ ├─ NumberOfPackages
│ ├─ QuantityInPackage
│ ├─ Dimensions
│ └─ GrossWeight / NetWeight
└─ DocumentReference
├─ DocumentCode
├─ DocumentNumber
└─ DocumentDate
推荐校验规则
| 校验项 | 建议规则 |
|---|---|
| 报文类型 | UNH 必须为双方约定的 Ferrari AVIEXP 类型 |
| 发送/接收方 | UNB 发送方为供应商,接收方为 Ferrari |
| 发运通知编号 | MID 不为空,且在年度内唯一 |
| 供应商代码 | SDT 与主数据匹配 |
| 收货方/装卸点 | CSG 代码在 Ferrari 主数据中存在 |
| 物料号 | ARD 物料号在 ERP 主数据或订单中存在 |
| 数量 | ARD 数量为正数,单位与订单一致 |
| 包装信息 | TCO 包装类型、包装数量、包装内数量等字段按 Ferrari MIG 解析;具体业务校验口径以项目确认为准 |
| 单据引用 | DAN 单据号与 ERP DN / 出库单一致 |
| 段数 | UNT 段数与实际消息段数一致 |
常见错误
1. 把 AVIEXP 当成 EDIFACT DESADV
本项目使用 Ferrari/INTESA 约定的 AVIEXP:3:0:OD:INTESA 业务段。若直接套用标准 EDIFACT DESADV 的 BGM/NAD/CPS/PAC/LIN 段结构,会找不到当前 Ferrari 项目规范中的 MID/ARD/TCO/DAN 关键字段。
2. 未确认包装字段业务口径
TCO/7224、TCO/6853 的字段名应按 Ferrari MIG 记录,但不要在未确认前固化为系统计算公式。若后续需要做包装校验,应由 Ferrari 项目方或客户业务确认口径后再实现。
3. 混淆 Number of Packages 和 Quantity in Package
TCO/7224 表示 Number of Packages,TCO/6853 表示 Quantity of articles in package。不同项目对 PALLET、箱、件的表达可能有差异,实施时必须结合 Ferrari MIG、包装协议和客户确认结果处理。
4. 订单号不按组合字段处理
ARD/1022 是 Ferrari MIG 中的订单/合同识别字段。ERP 若需要拆分订单号与行号,应按双方确认规则拆分,不要直接按通用经验截取或丢弃后四位。
5. DAN 与随货单不一致
AVIEXP、DN 单、ERP 出库单之间的单据号和日期应一致,否则客户收货时无法顺利匹配。
落地建议
对接 Ferrari AVIEXP 时,建议从 ERP/WMS 自动取数生成报文:ERP 提供订单、物料、数量、DN;WMS 提供包装、重量、尺寸;EDI 系统负责字段映射、脱敏测试、段数校验和归档。这样可以减少人工录入,并确保 AVIEXP、随货单、标签和出库记录的一致性。
更多报文:Ferrari DELINS


