EDI/EDIFACT verstehen und einführen

Planen oder entwickeln Sie einen automatisierten Geschäftsdokumentenaustausch mit einem Handelspartner, lernen Sie hier die wichtigsten Begriffe kennen. Sie grenzen Standard, Partnerprofil, Mapping und Transport voneinander ab und erkennen, welche Teile Workspace nativ unterstützt.

Die wichtigste Entscheidung lautet: Passt der vereinbarte Partnervertrag zu ORDERS und ORDRSP in D.96A oder D.25A über Partner-API oder SFTP? Wenn Nachricht, Verzeichnis oder Transport davon abweichen, planen Sie einen getrennten Integrationsscope ein.

Unterstützten Vertrag zuerst prüfen

Richtung	Workspace-Vertrag	Bedeutung
Eingehend	`ORDERS` in D.96A oder D.25A	Der Käufer sendet eine Bestellung. Workspace prüft, mappt und verarbeitet sie nach der aktiven Anwendungsrichtlinie.
Ausgehend	`ORDRSP` in D.96A oder D.25A	Workspace nimmt die Bestellung vollständig an oder lehnt sie vollständig ab.
Syntaxbestätigung	`CONTRL` 2.2 bei Syntaxversion 3 oder `CONTRL` 4.1 bei Syntaxversion 4	Der Empfänger bestätigt oder verwirft die EDIFACT-Syntax. `CONTRL` gehört nicht zum D.96A-/D.25A-Nachrichtenverzeichnis.
Anwendungsbestätigung	`APERAK` in D.96A oder D.25A	Der Empfänger meldet einen fachlichen oder Mapping-bezogenen Annahme- oder Ablehnungsstatus.
Transport	Partner-API oder SFTP	Der Transport überträgt Bytes. Er ersetzt weder Syntaxprüfung noch fachliche Bestätigung.

Der aktuelle native Vertrag enthält weder DESADV, INVOIC noch AS2. Ein UN/EDIFACT-Verzeichnis kann eine Nachricht beschreiben, ohne dass Workspace sie bereits als Produktfunktion verarbeitet.

Die Ebenen auseinanderhalten

EDI/EDIFACT-Projekte scheitern häufig, wenn Beteiligte verschiedene Ebenen mit demselben Wort „Format“ bezeichnen. Halten Sie diese Verträge getrennt:

Ebene	Leitfrage	Beispiel
EDI	Welcher Geschäftsprozess läuft systemübergreifend?	Bestellung und Bestellantwort ohne manuelle Neueingabe.
UN/EDIFACT-Syntax	Wie werden Interchange, Nachrichten, Segmente und Datenelemente geschrieben?	Trennzeichen, `UNB`/`UNZ`, `UNH`/`UNT`, Release-Zeichen und Syntaxversion.
Verzeichnis	Welche Struktur besitzt ein Nachrichtentyp in einem Release?	`ORDERS:D:96A:UN` oder `ORDERS:D:25A:UN`.
Partnerprofil	Welche Teilmenge, Qualifier und Regeln vereinbaren zwei Partner?	Pflicht-GTIN, erlaubte Mengeneinheiten, Datumsformat, Käufer- und Verkäuferkennung.
Mapping	Wie werden Partnerfelder in das kanonische Workspace-Modell übersetzt?	`BGM.2.1` wird zur externen Bestellreferenz.
Transport	Wie gelangen unveränderte Bytes zum Empfänger?	Partner-API oder SFTP.
Verarbeitung	Welche fachliche Wirkung darf die Nachricht auslösen?	Automatisch anwenden, bei Abweichung prüfen oder manuell freigeben.

Ein EDIFACT-Parser allein ist deshalb noch keine fertige EDI-Integration. Erst der freigegebene Partnervertrag verbindet alle Ebenen.

Aufbau einer EDIFACT-Nachricht lesen

Dieses gekürzte Beispiel zeigt eine ORDERS-Nachricht in D.96A. Es dient der Orientierung und ist kein Partnerprofil:

edifact

UNA:+.? '
UNB+UNOC:3+4000001000001:14+4000002000008:14+260716:1030+1'
UNH+1+ORDERS:D:96A:UN'
BGM+220+PO-1001+9'
DTM+137:20260716:102'
LIN+1++04012345000016:EN'
QTY+21:2:PCE'
UNS+S'
UNT+7+1'
UNZ+1+1'

Segment	Aufgabe im Beispiel
`UNA`	Kündigt die verwendeten Servicezeichen an. Fehlt `UNA`, gelten die vereinbarten Standardzeichen.
`UNB`	Öffnet den Interchange und nennt Syntax, Sender, Empfänger, Zeitpunkt und Kontrollreferenz.
`UNH`	Öffnet eine Nachricht und nennt Typ, Version, Release und verantwortliche Organisation.
`BGM`	Identifiziert das Geschäftsdokument und seine Referenz.
`DTM`	Überträgt ein qualifiziertes Datum oder eine Uhrzeit.
`LIN`	Beginnt eine Bestellposition und trägt eine Artikelreferenz.
`QTY`	Überträgt eine qualifizierte Menge mit Einheit.
`UNS`	Trennt Abschnitte der Nachricht.
`UNT`	Schließt die Nachricht mit Segmentanzahl und Nachrichtenreferenz.
`UNZ`	Schließt den Interchange mit Nachrichtenanzahl und Kontrollreferenz.

Elemente werden mit +, Komponenten mit : und Segmente im Beispiel mit ' getrennt. Das Release-Zeichen ? maskiert ein nachfolgendes Servicezeichen. Teilen Sie eine Nachricht deshalb niemals naiv am Apostroph oder Pluszeichen auf.

Verzeichnis, Syntaxversion und Partnerprofil wählen

Workspace bindet das Verzeichnis an eine unveränderliche Profilrevision:

Verzeichnis	Syntaxversion im nativen Vertrag	Typische Kennzeichnung in `UNH`
D.96A	3	`ORDERS:D:96A:UN`
D.25A	4	`ORDERS:D:25A:UN`

Wählen Sie nicht automatisch das neuere Verzeichnis. Verwenden Sie exakt die Version, auf die sich beide Partner mit Beispieldateien, Pflichtfeldern, Qualifiern und Codewerten geeinigt haben. Ein EANCOM-Profil ist eine von GS1 definierte Teilmenge von UN/EDIFACT und nicht automatisch mit einem beliebigen UN/EDIFACT-Partnerprofil identisch. Der aktuelle Workspace-Vertrag verspricht kein allgemeines EANCOM-Profil; prüfen Sie eine solche Anforderung gesondert.

Bestätigungen richtig deuten

Signal	Beantwortete Frage	Nicht bewiesen
HTTP `202` oder erfolgreicher SFTP-Upload	Hat Workspace die Bytes für die Verarbeitung angenommen?	Syntax, Mapping oder Commerce-Anwendung.
`CONTRL`	War der Interchange syntaktisch akzeptabel?	Fachliche Annahme der Bestellung.
`APERAK`	War die Nachricht fachlich beziehungsweise für das Mapping akzeptabel?	Annahme der Bestellung durch Commerce.
`ORDRSP`	Wurde die Bestellung vollständig angenommen oder abgelehnt?	Transportbestätigung für eine andere Nachricht.

Überwachen Sie Transport-, Syntax-, Mapping-, Anwendungs- und Bestätigungsstatus getrennt. Ein einzelner Status „erfolgreich“ reicht für einen belastbaren EDI-Betrieb nicht aus.

Offizielle Standards und Verzeichnisse

Nutzen Sie Primärquellen, um Syntax und Standardnachrichten nachzuschlagen. Die Quellen beschreiben den Standard, nicht automatisch den in Workspace aktivierten Partnervertrag.

Quelle	Wofür Sie sie verwenden
UNECE: Einführung und Regeln zu UN/EDIFACT	Begriffe, Syntaxregeln, Entwurfs- und Implementierungsleitlinien.
UNECE: UN Trade Data Interchange Directory	Verzeichnisse, Nachrichtentypen, Segmente, Datenelemente und Codelisten.
UNECE: Verzeichnis-Downloads	Offizielle Releasepakete und historische Verzeichnisse.
UNECE: UN/EDIFACT Executive Guide	Management- und Projekteinstieg in den Standard.
ISO 9735-2:2002	Batch-EDI-Syntaxregeln für Syntaxversion 4. Die vollständige Norm kann lizenzpflichtig sein.
ISO 9735-11:2022	Kompatibilitätsprofil für den Übergang von Syntaxversion 3 zu 4.
GS1 EANCOM	Offizielle GS1-Teilmenge von UN/EDIFACT; nur nutzen, wenn das Partnerprofil sie ausdrücklich vereinbart.
IANA: `application/EDIFACT`	Registrierung des EDIFACT-Medientyps. HTTP-Werte sind nicht case-sensitiv; Workspace dokumentiert `application/edifact`.
UNECE: Recommendation 20	Codes für Maßeinheiten im internationalen Handel.
UNECE: UN/LOCODE	Offizielle Codes für Handels- und Transportorte.
GS1 Standards Repository	GS1-Regeln für EANCOM, GLN, GTIN und weitere Identifikationsstandards.

Kopieren Sie keine komplette Standarddefinition in ein Partner-Mapping. Versionieren Sie stattdessen das konkret vereinbarte Profil und bewahren Sie die verwendete Quellen- und Releasebezeichnung in Ihrer Projektakte auf.

Den passenden nächsten Schritt wählen

Ihre Aufgabe	Nächste Seite
Sie planen ein neues Partnerprojekt.	EDIFACT-Partner einrichten
Sie administrieren Profile, Verbindungen, SFTP und Status.	B2B Exchange betreiben
Sie entwickeln Mapping, Tests oder einen Partnerclient.	Als Entwickler mit EDIFACT arbeiten
Sie implementieren den Partner-API-Worker.	B2B-Exchange-Partner-API integrieren
Sie vergleichen EDI mit REST, CSV oder XML.	Datenaustausch für Integrationen

Sie haben den Einstieg abgeschlossen, wenn Nachricht, Richtung, Verzeichnis, Syntaxversion, Partnerprofil, Transport, fachliche Verantwortung und Bestätigungsweg für beide Partner schriftlich feststehen.