Files
vda-to-edifact-converter/docs/walkthrough.md
2026-03-13 09:53:40 +01:00

3.9 KiB
Raw Blame History

ERP EDI Bridge v2.5 Komplettübersicht & Walkthrough

Die ERP EDI Bridge ist eine moderne Web-App (basierend auf Electron oder Browser), die den Datenaustausch zwischen ERP-Systemen und Partnern durch Konvertierung von VDA- und EDIFACT-Nachrichten vereinfacht.


🛠 Hauptfunktionen

1. Multi-Format Converter

Unterstützt bidirektionale Konvertierung mit verschiedenen Business-Logiken:

  • VDA 4913 → Bosch DESADV: Erzeugt EDIFACT DESADV Nachrichten inkl. NAD-Anreicherung und Gewichts-Editor.
  • VDA 4913 → IFM DELVRY03: Erzeugt IFM-spezifische XML-IDocs.
  • DELFOR → VDA 4905: Konvertiert EDIFACT Lieferabrufe in das VDA-Format.
  • IFM DELFOR → VDA 4905: Spezieller Flow für IFM D04A Nachrichten.
  • INVRPT → VDA 4913: Konvertiert EDIFACT Lagerbestandsberichte in VDA EDL36.

2. Visueller EDI Editor (Neu!)

Ein interaktiver Editor zur strukturierten Bearbeitung von EDI-Dateien:

  • Segment-Ansicht: Stellt EDIFACT-Segmente (UNH, BGM, NAD, etc.) als Karten mit bearbeitbaren Feldern dar.
  • VDA-Unterstützung: Bearbeitung von VDA-Sätzen mit Live-Längenprüfung, um die Festlängen-Struktur beizubehalten.
  • Integration: Dateien können direkt hochgeladen oder per "Edit"-Button aus dem Konvertierungsergebnis übernommen werden.
  • Export: Generiert korrekte EDI-Dateien (inkl. UNA-Header und Separatoren) mit dem Suffix _edited.

3. Premium EDI-Viewer (Neu!)

Visualisiert EDI-Daten als moderne, druckfreundliche Dokumente mit erweitertem Datenumfang:

  • DELFOR: Lieferplan mit Abrufmengen, Zeitplan (Wochen/Monate) und Lieferhistorie.
  • DESADV: Lieferschein mit Anzeige von Kunden- vs. Lieferanten-Materialnummern, Chargennummern (PIA+NB) und detaillierter Verpackungsauflistung (PAC).
  • INVRPT: Lagerbestandsbericht mit Bestandsmengen, Lagerorten und Material-Revisionen.
  • VDA 4913: Transport-Hierarchie (Transport -> Lieferschein -> Position) mit VDA-Labelnummern und Packstücken.
  • Interaktivität: Nutzung von Lucide-Icons für bessere Scanbarkeit und integrierte Druckfunktion.

4. Automatisierung (Watcher)

Nur in der Electron-Version verfügbar:

  • Ordner-Überwachung: Überwacht einen Eingangsordner auf neue Dateien.
  • Auto-Konvertierung: Konvertiert Dateien basierend auf hinterlegten Regeln vollautomatisch.
  • Status-Dashboard: Zeigt Live-Logs und den Status des Watchers in den Einstellungen an.

🏗 Technische Struktur

Komponent Beschreibung
index.html Zentrales UI mit Glassmorphism-Design und Tab-Navigation.
js/app.js Haupt-Orchestrierung der UI und Converter-Logik.
js/editor.js Logik für den visuellen Segment-Editor.
js/viewer.js Parsing und Rendering der Dokumententypen (XSL-ähnlich).
js/watcher-bridge.js Schnittstelle zum Electron Dateisystem-Watcher.
styles.css Modernes Dark-Mode/Glassmorphism Design-System.

🚀 Installation & Start (Electron)

  1. Voraussetzung: Node.js (v18+) installieren.
  2. Setup:
    npm install
    
  3. Start:
    npm start
    

Tip

Die App kann auch direkt über die index.html im Browser genutzt werden (ohne Watcher-Funktionalität).


⚙️ Einstellungen & Konfiguration

In den Settings können Netzwerkpfade für den Watcher gewählt und die Kundennummern-Zuordnung (CUSTOMER_MAPPING) konfiguriert werden.

Intelligente Formaterkennung (Auto-Detect)

Die App erkennt beim Hochladen einer Datei automatisch das Format und den Partner:

  • VDA Dateien: Identifikation über die Kundennummer im Satz 711/511.
  • EDIFACT Dateien: Identifikation über den Absender im UNB-Segment (Sender ID) oder NAD+BY.
  • Mapping: Ist die ID in der CUSTOMER_MAPPING (Einstellungen) hinterlegt, wird automatisch der richtige Konverter (z.B. DELFOR → VDA 4905) aktiviert.

Die Konfiguration wird lokal im Browser-Storage gespeichert oder kann aus einer config.txt geladen werden.