EDI-Übertragungen (EDI03)

Transaktion: EDI03 EDI Übertragungen
UI-Pfad: /messageList
API-Basis: /api/commMessage
Domäne: CommMessage

Business-Zweck

CommMessage ist die laufende Instanz einer EDI-/E-Mail-/XML-Übertragung: Inhalt, Status, Retry-Zähler, Dateipfad und Verknüpfung zum Belegkopf (CommHead). EDI03 ist das Partner-Monitoring für alle Ein- und Ausgänge.

Kernbegriffe

Feld	Bedeutung
type	Kanal: EDI, EMAIL, INTERCOMPANY, INVOICETR, …
postway	0 = Import, 1 = Export
status	SENT, ERROR, WORKING, COMPLETE (Import abgeschlossen)
tryCount	Anzahl Export-/Import-Versuche (Import max. 2 Retries)
content	Gerenderte Nachricht / EDI-Text
filePath	Ablagepfad nach erfolgreichem Export
customerNo, docNumber, docType	Belegreferenz
ediNumber	EDI-Datei-/Nachrichtennummer
commCustomerConfig	Verweis auf EDI02-Zuordnung
commHead	Normalisierter Beleg für Template/Import

Verknüpfung zu SAL und PUR

Beziehung	Domäne	Bedeutung
SalesHeadCommMessage	SAL	EDI-Nachrichten zu Auftrag/Lieferschein/Rechnung
PurHeadCommMessage	PUR	EDI-Nachrichten zu Bestellung

Am Vertriebsbeleg abrufbar: GET /api/salesHead/getSalesHeadEdis?id={salesHeadId} – liefert alle verknüpften EDI-Nachrichten inkl. Status und Inhalt (siehe SalesHead API).

Export-Flow (postway = 1)

Auslöser

1. Automatisch – EDI02 mit saveMode=0 beim Beleg-Save oder saveMode=1 bei FiBu-Übergabe
2. Manuell EDI03 – Auswahl in der UI, Export starten
3. API – POST /api/commMessage/exportSalesHeads mit commMessageIds
4. PUR E-Mail-Export – POST /api/commMessage/exportEdi mit PurHead-IDs

exportSalesHeads / exportCommMessages

• Nur ausgehende Nachrichten (postway=1)
• Baut CommHead aus SalesHead oder PurHead
• Rendert Template, lädt Datei hoch oder versendet E-Mail
• Bei Erfolg: status=SENT, filePath gesetzt
• Bei Fehler: status=ERROR, message mit Fehlertext, tryCount erhöht
• In Nicht-Development-Umgebungen: optional sendCommMessageSummary nach Batch-Export

Sammelrechnungen

Mehrere Rechnungen können über isCollectiveInvoice und Protokoll-groupCollectiveBy zu einer Nachricht zusammengefasst werden (Gruppierung nach Kundennummer, GLN oder Protokoll).

Import-Flow (postway = 0)

importOrders

GET /api/commMessage/importOrders führt für den Mandanten aus:

1. importEdi – liest FTP/SFTP/lokale Dateien aller Import-Konfigurationen (EDI02, postway=0)
2. CommMessage-Erzeugung – fehlende Nachrichten zu vorhandenen CommHead-Importköpfen
3. importSalesHead – Standard: EDI-Bestellungen → Vertriebsauftrag
4. importDesadv – bei Einkauf (type=1, kind=DESADV) → Wareneingang/Bestellbezug
5. importVerificationHead – bei type=2 oder type=XML → Eingangsrechnungsprüfung

Import-Nachrichten mit tryCount > 2 oder status=COMPLETE werden übersprungen.

exportEdi (Einkauf)

Partner exportieren Bestellungs-Anhänge per API:

• Request: PurHead-IDs (ids)
• Sucht CommCustomerConfig für Lieferant + DocType + type=1
• Erzeugt oder aktualisiert CommMessage + PurHeadCommMessage
• Rendert Inhalt (onlyContent=true für reine Vorschau)
• Rückgabe: Dateiinhalt / Metadaten für Download oder Weiterverarbeitung

Details: Comm Message API, PurHead API.

Tageszusammenfassung

GET /api/commMessage/sendCommMessageSummary versendet eine E-Mail mit allen heute geänderten CommMessage-Einträgen an berechtigte Benutzer – nützlich für Partner-Support und Monitoring.

Status- und Retry-Logik

status	Bedeutung	Partner-Aktion
(leer) / offen	Noch nicht exportiert/importiert	Export/Import anstoßen
WORKING	Import läuft	Warten
SENT	Export erfolgreich	Archiv/Follow-up beim Partner
ERROR	Fehler	message lesen, Beleg/Config korrigieren, erneut versuchen
COMPLETE	Import abgeschlossen	Beleg in SAL/PUR prüfen

Export-Fehler mit tryCount < 3 können erneut exportiert werden.

Fehlerbilder

Symptom	Ursache	Maßnahme
ERROR + Template-Meldung	EDI01 unvollständig	Protokoll/Template prüfen
ERROR + FTP	Netzwerk/Credentials	EDI02 + ftpCheckConnection
Import ohne Auftrag	Parsing/Mapping	CommHead-Inhalt, Kunden-Zuordnung
Kein Eintrag trotz Beleg	saveMode/exportMode	EDI02-Konfiguration

Weiterlesen

• Modulübersicht EDI
• Kunden-Zuordnung (EDI02)