EDIFACT#

EDIFACT – Eingang für klassische EDI-Nachrichten nach UN-Standard. Benötigtes Addon: connector_edifact.

Überblick#

EDIFACT (Electronic Data Interchange For Administration, Commerce and Transport) ist ein UN-Standard für den elektronischen Austausch von Geschäftsdokumenten. Im deutschsprachigen B2B-Handel ist EDIFACT besonders bei Großhändlern, Einkaufsgenossenschaften und im Einzelhandel verbreitet.

EDIFACT-Nachrichten sind weder XML noch JSON, sondern ein spezielles Textformat mit Trennzeichen:

UNA:+.? '
UNB+UNOC:3+AbsenderGLN:14+EmpfaengerGLN:14+240906:0846+Referenz++ORDERS'
UNH+1+ORDERS:D:01B:UN:EAN010'
BGM+220+Bestellnummer+9'
...

Orderport empfängt und parst EDIFACT-ORDERS-Nachrichten, normalisiert sie und transformiert sie in Ihr Zielformat (openTrans XML oder JSON).

Kompatibilität#

Unterstützte Versionen#

Bekannte Einschränkungen#

• Nur ORDERS. Andere Nachrichtentypen (ORDRSP, DESADV, INVOIC) werden nicht unterstützt.
• Keine ORDRSP zurück. Orderport sendet keine Bestellbestätigungen ins sendende System. Ist eine ORDRSP vertraglich verlangt, muss sie aus Ihrem Zielsystem (ERP) stammen.
• Adressdaten-Lücken. Wenn die NAD-Segmente nur GLN enthalten (ohne Klartext-Adresse), müssen Straße/PLZ/Ort als Static-Mapping im Feldmapping hinterlegt werden.
• Keine Signaturprüfung. EDIFACT-Inhalte werden nicht kryptografisch validiert – Authentifizierung erfolgt ausschließlich über die Transport-Schicht (HTTP-Auth oder IP-Allowlist).
• EDIFACT-Subsets jenseits EANCOM D:01B sind in Einzelfällen zu prüfen; wir reagieren auf gemeldete Parsing-Probleme.

Authentifizierung#

EDIFACT selbst trägt keine Authentifizierung. In Orderport sichern Sie den Eingang über eine Credential vom Typ Bearer Token oder Shared-Secret-Header – je nachdem, was Ihr Partner liefern kann.

• Empfohlen: Bearer Token im Authorization-Header
• Alternativ: Custom-Header (z. B. X-API-Key) mit Shared-Secret-Header

Zusätzlich kann die IP-Allowlist auf Tenant-Ebene den Zugriff auf bekannte Absender-IPs beschränken.

Einrichten in Orderport#

Pipeline anlegen#

1. Pipelines → Neue Pipeline
2. Eingabeformat: EDIFACT, Ausgabeformat: openTrans oder JSON
3. Auto-Mapping wird generiert
4. Transport wählen: HTTP, REST API, E-Mail oder FTP

Credential anlegen#

Auf der Pipeline-Detailseite Credentials → Hinzufügen:

• Typ: Bearer Token oder Shared-Secret-Header
• Secret wird einmalig angezeigt und dem Partner mitgeteilt

Festwerte im Mapping#

Weil NAD-Segmente oft nur GLN enthalten, fehlen häufig Klartext-Adressen für den Käufer oder die Lieferadresse. Hinterlegen Sie die fehlenden Werte als Static-Mapping:

Einrichten im Quellsystem#

Der konkrete Versandweg hängt vom Partner ab:

• HTTP POST mit Content-Type application/edifact auf Ihre Webhook-URL
• SFTP-Drop durch einen EDI-Konverter (z. B. SEEBURGER, Lobster, ecosio) – Orderport akzeptiert derzeit nur HTTP-Inbound; der Konverter müsste den SFTP-Drop per Worker in einen HTTP-Request umsetzen
• EANCOM-Gateways (wie IBM Sterling, SEEBURGER Cloud Services) konfigurieren Sie so, dass die ORDERS-Nachricht an die Orderport-Webhook-URL zugestellt wird

Technische Details#

Unterstützte Segmente#

Verfügbare Quellfelder (nach Parsing)#

Bestellkopf#

Parteien#

Positionen#

Endpoint#

Webhook-URL je Pipeline: https://orderport.app/api/v1/webhook/{token}.

Fehlerbehebung#

Nächste Schritte#

• Feldmapping
• Zugangsdaten
• Limits & Kontingente