Darstellung
EDI – Modulübersicht
Das Modul EDI (Electronic Data Interchange) steuert den strukturierten Datenaustausch zwischen reybex und Handels-/Industriepartnern: Protokolldefinition, Kunden- bzw. Lieferanten-Zuordnung, FTP/SFTP-Übertragung und Nachverfolgung aller Ein- und Ausgangs-Nachrichten.
EDI baut auf Stammdaten (BAS), Vertrieb (SAL) und Einkauf (PUR) auf. Freemarker-Templates rendern Belegdaten (CommHead/CommItem) in EDI-, XML- oder E-Mail-Formate; der Integrator (BAS15) deckt parallel Shop-/Middleware-Anbindungen ab.
Rolle für Partner
Partner arbeiten in EDI typischerweise in diesen Rollen:
- Protokolle definieren (EDI01) – Nachrichtentyp, Richtung, Template und Nummernkreis festlegen
- Kunden-Zuordnung pflegen (EDI02) – Debitor/Lieferant, DocType, FTP-Zugang und Export-Modus konfigurieren
- Übertragungen steuern (EDI03) – Export aus SAL/PUR-Belegen, Import von Bestellungen und DESADV, Status prüfen
- Fehler nachbearbeiten –
CommMessage-Status, Retry-Zähler und Tageszusammenfassung auswerten
Ohne konsistente EDI-Konfiguration schlagen automatische Belegübertragungen fehl, bevor Vertriebs- oder Einkaufsprozesse greifen.
Architektur – EDI in reybex
Kern-Domänen
→ Kern-Domänen Übersicht · Domain-Struktur
| Domäne | Bedeutung | Partner-Relevanz |
|---|---|---|
| CommProtocoll | Protokoll-Definition | EDI01 |
| CommCustomerConfig | Partner-Zuordnung | EDI02 |
| CommMessage | Übertragung/Status | EDI03 Monitoring |
Transaktionen im Partner-Kontext
| Code | Transaktion | UI-Pfad | Partner-Relevanz | Business-Doku | Default-Rollen |
|---|---|---|---|---|---|
| EDI01 | EDI Protokolle | /protocolList | Sehr hoch – Template & Nachrichtentyp | Protokolle | ROLE_ADMIN |
| EDI02 | EDI Kunden Zuordnung | /customerConfigList | Sehr hoch – FTP, Export-Modus, Mapping | Kunden-Zuordnung | ROLE_ADMIN |
| EDI03 | EDI Übertragungen | /messageList | Sehr hoch – Export/Import, Status | Übertragungen | ROLE_CEO, ROLE_MANAGEMENT … +2 |
Typische Integrations-Reihenfolge
- Nummernkreis (BAS) – EDI-Datei-ID (
edi) und ggf. Sammelrechnungsnummer (invoice_list) - Kunden/Lieferanten (SAL01 / PUR01) – GLN, Kundennummer, DocTypes
- Protokoll (EDI01) – z. B.
type=EDI,kind=INVOICE,postway=1(Export), Freemarker-Template - Kunden-Zuordnung (EDI02) – Debitor/Lieferant, DocType-ID, FTP/SFTP,
exportMode - Beleg anlegen (SAL16/PUR02) – löst bei passender Konfiguration
CommMessage-Eintrag aus - Export (EDI03 / API) –
POST /api/commMessage/exportSalesHeadsoder automatisch beiexportMode=2 - Import (EDI03 / API) –
GET /api/commMessage/importOrdersliest FTP/Verzeichnis und erzeugt Aufträge/Bestellungen - Monitoring – EDI03-Liste,
GET /api/salesHead/getSalesHeadEdisam Beleg, Tagesmail viasendCommMessageSummary
Abhängigkeiten zu anderen Modulen
| EDI-Thema | Modul | Hinweis |
|---|---|---|
| Aufträge, Lieferscheine, Rechnungen | SAL | Exportquelle für Vertrieb (CommCustomerConfig.type=0) |
| Bestellungen | PUR | Export/Import Einkauf (type=1), exportEdi |
| Integrator / Shop | BAS Integrator | Alternative zu klassischem EDI für Online-Kanäle |
| EDI-Nachrichten am Beleg | — | GET /api/salesHead/getSalesHeadEdis |
Technische Integration
Alle API-Details: API
Mandantenbezug
Protokolle, Zuordnungen und Nachrichten sind mandantenisoliert. FTP-Pfade enthalten typischerweise die Tenant-ID; Passwörter werden verschlüsselt gespeichert.