EDI-Kunden-Zuordnung (EDI02)

Transaktion: EDI02 EDI Kunden Zuordnung
UI-Pfad: /customerConfigList
API-Basis: /api/commCustomerConfig
Domäne: CommCustomerConfig

Business-Zweck

Die Kunden-Zuordnung verbindet einen Handelspartner (Debitor oder Lieferant) mit einem EDI-Protokoll (EDI01), einer Belegart (docType) und den Übertragungsparametern (FTP, Export-Modus, Zeitpunkt der CommMessage-Erzeugung).

Ohne passende Zuordnung erzeugt reybex keine EDI-Nachricht – auch wenn der Vertriebs- oder Einkaufsbeleg korrekt gespeichert ist.

Kernbegriffe

Feld	Bedeutung
customerNo	Kunden-/Lieferantennummer in reybex (SAL01, PUR01)
customerGln	GLN des Partners (EDI-Adressierung)
contactNo	Partner-interne Kunden-/Lieferantennummer
docType	ID des SalesDocType bzw. PurDocType (Belegart)
commProtocoll	Referenz auf EDI01-Protokoll
type	0 = Vertrieb, 1 = Einkauf, 2 = Eingangsrechnung, 3 = Verifikation Vertrieb
exportMode	0 = manuell, 1 = mit Nachfrage, 2 = vollautomatisch
saveMode	0 = CommMessage beim Speichern des Belegs, 1 = bei FiBu-Übergabe
isCollectiveInvoice	Sammelrechnung ja/nein (Gruppierung über Protokoll groupCollectiveBy)
targetTenant	Zielmandant bei Intercompany
fileExtension / fileCharset	Dateiendung und Zeichensatz (Default oft edi / UTF-8)

FTP-Verbindung

Feld	Beschreibung
ftp	FTP-Host (Legacy-Feld, oft redundant zu ftpUploadUrl)
ftpUploadUrl	Hostname für FTP/SFTP
ftpPort	Port (FTP: 21, SFTP: 22)
user / password	Zugangsdaten (Passwort verschlüsselt in DB)
isSecured	true → SFTP (JSch), false → FTP
savePath	Remote-Pfad bzw. lokales Import-Verzeichnis
ftpCheckConnection	Verbindungstest (API, siehe Integration)

Import-Pfad-Logik

• Mit ftpUploadUrl: Dateien werden per FTP/SFTP aus savePath gelesen
• Ohne FTP: lokales Verzeichnis {fileuploader.path}/{tenantId}/edi/import/{customerNo}
• Import-Protokolle haben commProtocoll.postway = 0

Kunden-Mapping – Partner-Sicht

Vertrieb (type = 0)

Typische Zuordnung für Aufträge (SAL16), Lieferscheine (SAL17), Rechnungen (SAL18):

• Protokoll postway=1, kind=INVOICE / ORDERDISPATCH / …
• saveMode=0: Nachricht entsteht beim Speichern des Belegs
• saveMode=1: Nachricht entsteht bei FiBu-Übergabe (SAL11)
• exportMode=2: automatischer Export nach Erzeugung

Einkauf (type = 1)

Zuordnung für Bestellungen (PUR02):

• Export per POST /api/commMessage/exportEdi (E-Mail-Anhang oder EDI)
• Import eingehender DESADV (commProtocoll.kind=DESADV)

Export-Modi im Vergleich

exportMode	Verhalten
0 – Manuell	Partner startet Export in EDI03 oder per API
1 – Mit Nachfrage	Dialog vor Übertragung
2 – Vollautomatisch	Hintergrund-Job / Speichern löst Export aus

Beim Import-Job (importEdi) werden nur Konfigurationen mit exportMode=2 berücksichtigt, wenn isJob=true.

Fehlerbilder

Symptom	Ursache	Maßnahme
Keine CommMessage am Beleg	Keine passende EDI02-Zuordnung	customerNo, docType, type, Protokoll prüfen
FTP-Verbindung fehlgeschlagen	Host/Port/Credentials	ftpCheckConnection nutzen
Falsche Belegart	docType-ID stimmt nicht	SalesDocType/PurDocType-ID aus SAL/PUR ermitteln
Import liest keine Dateien	savePath / postway=0	Import-Protokoll und Verzeichnis prüfen

Weiterlesen

• EDI-Protokolle (EDI01)
• Übertragungen (EDI03)
• Integrator Channels (BAS15) – alternative Shop-Anbindung