Logwin Validierungsregeln Sea & Air Freight

Vollständige Geschäftslogik-Engine fßr Logwin See- und Luftfracht-Rechnungen mit Incoterm-Validierung und Multi-Währungs-Unterstßtzung

Logwin Service-Abdeckung
Seefracht (FCL/LCL) und Luftfracht mit differenzierter Validierung nach Transportart
🚢 SEEFRACHT (Sea Freight)
ASC-Rechnungen
Container-basierter Transport per Seefracht mit vollständiger Vorlauf-, Hauptlauf- und Nachlauf-Validierung
Rechnungsnummern-Präfix: ASC (z.B. ASC25008124)
Transporttypen: 20'DC, 40'DC, 40'HC, 45'HC
Routen: Brasilien → Deutschland, Türkei → Europa
Währungen: USD (Ursprung), EUR (Ziel)
GebĂźhren: Frachtkosten, Vorlaufkosten, Nachlaufkosten, THC, T1-Abfertigung
✈️ LUFTFRACHT (Air Freight)
FRA-Rechnungen
Expressversand per Luftfracht mit gewichtsbasierter Abrechnung
Rechnungsnummern-Präfix: FRA (z.B. FRA25027122)
Gewichtsbasis: Tatsächliches Gewicht + Volumengewicht
Routen: Frankfurt → Asien, Europa → weltweit
Währung: EUR
GebĂźhren: Frachtkosten, Vorlaufkosten, x-Ray GebĂźhr, Handling
🆕 Incoterm-Validierung
Automatische PrĂźfung der GebĂźhrenstruktur basierend auf Incoterm
FOB (Free On Board) Regel
Kritisch
Bei FOB-Incoterm dĂźrfen KEINE Vorlaufkosten (Pre-Carriage) berechnet werden
Validierungslogik:
IF (Incoterm = "FOB") AND (Vorlaufkosten > 0) THEN
  â†’ FEHLER "Vorlaufkosten bei FOB-Incoterm nicht erlaubt"

Erkannte Vorlauf-GebĂźhren:
• "Vorlaufkosten" / "Truck (Origin)"
• "Pre-Carriage Charges"
• "Origin Trucking"
📍 Incoterm-Extraktion:
Parsing-Pattern: "FRANKATUR: FOB gebze" oder "FCA SCHROEDER"
Validierung: Incoterm.toUpperCase() === 'FOB'
FCA (Free Carrier) / CIF / EXW
Standard
Bei anderen Incoterms werden Vorlaufkosten normal validiert
FCA: Vorlaufkosten erlaubt, wenn vereinbart
CIF: Alle Kosten bis Zielhafen inklusive
EXW: Käufer trägt alle Transportkosten
Steuer-Validierung (MwSt.)
Automatische Prßfung der 19% Mehrwertsteuer auf inländische Nachlaufkosten
19% MwSt. auf Nachlaufkosten
Pflicht
Alle Nachlaufkosten (Destination Charges) in Deutschland unterliegen der 19% Mehrwertsteuer
Steuerpflichtige GebĂźhren:
• Nachlaufkosten / Truck (Destination)
• Terminal Handling Charges (DTHC)
• T1 Abfertigung
• Documentation Fees (inland)

Validierung:
IF (GebĂźhr.includes("Nachlaufkosten")) THEN
  â†’ INFO "19% MwSt. PrĂźfung erforderlich"
🧮 Steuerberechnung:
Netto-Betrag: 1.258,00 EUR
MwSt. 19%: 1.258,00 × 0.19 = 239,02 EUR
Brutto-Betrag: 1.258,00 + 239,02 = 1.497,02 EUR
Steuerfreie Positionen
Ausnahme
Internationale Seefracht und ausländische Vorlaufkosten sind steuerfrei
Steuerfreie Gebßhren (§ 4 UStG):
• Frachtkosten (Ocean Freight)
• Vorlaufkosten (Origin Charges)
• Origin THC
• Export Documentation

Vermerk auf Rechnung: "Steuerfrei 1."
Multi-Währungs-Verarbeitung
Extraktion und Validierung von USD/EUR Beträgen mit Wechselkursen
USD → EUR Konvertierung
Automatisch
System extrahiert Wechselkurs aus Rechnungszeilen und validiert die Umrechnung
Format-Beispiel:
"Frachtkosten USD 7.800,00 @ 1,124928 → 6.933,78 EUR"

Extraktion:
• USD-Betrag: 7.800,00
• Wechselkurs: 1,124928
• EUR-Betrag: 6.933,78

Regex-Pattern:
USD\s+([\d,.]+)\s+@\s+([\d,.]+)
💱 Umrechnungsvalidierung:
Berechnung: USD_Betrag á Wechselkurs = EUR_Betrag
Beispiel: 7.800,00 á 1,124928 = 6.933,78 EUR
Toleranz: Âą0,02 EUR (Rundungsdifferenz)
Reine EUR-Positionen
Standard
Nachlaufkosten und deutsche GebĂźhren werden direkt in EUR abgerechnet
EUR-GebĂźhren:
• Nachlaufkosten: Container-basiert
• Terminal Handling (DTHC): 270,00 EUR / 20'DC
• T1 Abfertigung: 40,00 EUR
• Luftfracht: Alle Positionen in EUR

Format-Beispiel: "1.258,00 EUR" (ohne Wechselkurs)
🆕 Intelligentes Manuelles Prüf-System
Prioritätsbasierte automatische Erkennung von Sonderfällen mit Orange-Warnsystem
ABSENDER-Extraktion aus OCR-Text
Das System extrahiert automatisch den Absender aus der Rechnung (Tabellen-Format mit "ABSENDER | EMPFÄNGER" Spalten) und wendet basierend darauf prioritätsbasierte Validierungsregeln an.
📋 Prioritäts-Reihenfolge (höchste zuerst):
1. SCHULZ-SENDER → Überschreibt alle anderen Regeln
2. DEMURRAGE/DETENTION → Verzögerungsgebühren
3. FEHLENDE REFERENZ → Ziellager unbekannt
4. ANDERER JOST-WORKFLOW → Andere Jost-Entität
5. AUSSCHREIBUNG → Jost-Warenausgang ohne Biebesheim
🔴 Priorität 1: Schulz-Sender
HÖCHSTE PRIORITÄT
Alle Sendungen von Schulz S/A (Brasilien-Partner) erfordern IMMER manuelle PrĂźfung - Ăźberschreibt alle anderen Regeln
Erkennung:
• ABSENDER enthält "Schulz" oder "SCHULZ"
• Regex: /schulz/i (case-insensitive)

Beispiel OCR-Text:
"ABSENDER    EMPFÄNGER
Schulz S/A    Jost-Werke Deutschland GmbH"

Reason-Code: schulz_sender
UI-Status: 🟠 Schulz-Sendung - Manuelle Prüfung
Aktion: Alle Positionen auf PRÜFEN, Sonderkonditionen beachten
🟠 Priorität 2: Demurrage/Detention
VERZÖGERUNGS-GEBÜHREN
Standgeld und ContainerverzÜgerungskosten - Ursache und Verantwortlichkeit klären
Erkennung:
• Charge-Beschreibung enthält "demurrage", "detention" oder "standgeld"
• Case-insensitive Matching

Beispiele:
• "Container Demurrage"
• "Detention Charges"
• "Standgeld - 5 Tage"

Reason-Code: demurrage_detention
UI-Status: 🟠 Demurrage/Detention - Manuelle Prüfung
Aktion: Gegen Free-Time-Vereinbarungen prßfen, Verantwortung klären
🟡 Priorität 3: Fehlende Referenz
ZIELLAGER UNBEKANNT
Wenn "IHRE REFERENZ / PO NUMMER" leer ist, kann das Ziellager nicht bestimmt werden
Erkennung:
• Feld "IHRE REFERENZ / PO NUMMER" ist leer oder nur Whitespace
• Gilt für ALLE Absender (auch nicht-Jost)

Logik:
IF (reference.trim() === '') THEN
  â†’ Manual Review erforderlich

Reason-Code: missing_reference
UI-Status: 🟠 Referenz fehlt - Manuelle Prüfung
Aktion: Ziellager identifizieren (Biebesheim/Polen/etc.)
🔵 Priorität 4: Anderer Jost-Workflow
ANDERE ENTITÄT
Sendungen an andere Jost-Entitäten (kein "Biebesheim" in Referenz) - anderer Workflow zuständig
Erkennung:
• Referenz existiert (nicht leer)
• ABER: Referenz enthält NICHT "Biebesheim" (typo-tolerant)
• Regex: /[bi]*ebeshe[il]m/i

Typo-Toleranz:
• Akzeptiert: "Biebesheim", "iebesheim", "ebesheim", "Bebesheim"
• Toleriert fehlende führende Buchstaben und i/l Verwechslungen

Beispiel-Referenzen:
✅ "PO: 669647/SE217206748 Biebesheim" → Normale Validierung
❌ "PO: 123456/SE789012345" (kein Biebesheim) → Manual Review

Reason-Code: other_jost_entity
UI-Status: 🟠 Anderer Jost-Workflow - Manuelle Prüfung
Aktion: An zuständigen Workflow weiterleiten
🟢 Priorität 5: Ausschreibung (Jost-Warenausgang)
OUTBOUND SHIPMENT
Wenn Jost-Werke der Absender ist (nicht Empfänger) und kein Biebesheim in Referenz - Ausschreibungs-Workflow
Erkennung:
• ABSENDER ist "Jost-Werke Deutschland GmbH"
• Referenz existiert
• ABER: Kein "Biebesheim" in Referenz

Beispiel OCR-Text:
"ABSENDER    EMPFÄNGER
Jost-Werke Deutschland GmbH    Jost Japan Co., Ltd."

Bedeutung:
Jost verschickt Ware (Export) statt zu empfangen (Import)
→ Anderer Tarif-Workflow (Ausschreibung)

Reason-Code: no_biebesheim
UI-Status: 🟠 Ausschreibung - Manuelle Prüfung
Aktion: Ausschreibungs-Tarife anwenden, Export-Validierung
🎨 Orange Warn-System:
Summary Widget: 🟠 Orange Statusanzeige mit spezifischem Titel
Audit Log: Orange Warnung mit Grund-Erklärung
Charge Items: Alle Positionen auf "PRÜFEN" Status
Detailed Table: Orange Hinterlegung der Bemerkungen

Status-Texte:
• schulz_sender → "Schulz-Sendung - Manuelle Prüfung"
• demurrage_detention → "Demurrage/Detention - Manuelle Prüfung"
• missing_reference → "Referenz fehlt - Manuelle Prüfung"
• other_jost_entity → "Anderer Jost-Workflow - Manuelle Prüfung"
• no_biebesheim → "Ausschreibung - Manuelle Prüfung"
Tarif-Zuordnung (ETD-basiert)
Automatische Auswahl des gĂźltigen Tarifblatts basierend auf Abgangsdatum (ETD)
Intelligente Datum-Extraktion
Das System extrahiert das ETD (Estimated Time of Departure) aus der BELADUNG-Spalte der Rechnung und wählt automatisch das passende Tarifblatt aus.
Tarifblatt GĂźltigkeit Routen Status
Q1 V1 (01.01.2025) 01.01.2025 - 31.01.2025 Brasilien, Türkei → DE/PL Aktiv
Q1 V2 (01.02.2025) 01.02.2025 - 31.03.2025 Brasilien, Türkei → DE/PL Aktiv
Q2 V1 (01.04.2025) 01.04.2025 - 30.04.2025 Brasilien, Türkei → DE/PL Aktiv
Q2 V2 (01.05.2025) 01.05.2025 - 30.06.2025 Brasilien, Türkei → DE/PL Aktiv
Q3 V1 (01.07.2025) 01.07.2025 - 31.07.2025 Brasilien, Türkei → DE/PL Aktiv
Q3 V2 (01.08.2025) 01.08.2025 - 30.09.2025 Brasilien, Türkei → DE/PL Aktiv
📅 ETD-Extraktion Logik:
1. Finde Zeile mit "BELADUNG" und "ETD"
2. Extrahiere nächste Zeile mit Datumsangaben
3. Wähle drittes Datum (BELADUNG-Spalte)
4. Format: DD-Mmm-YY (z.B. "24-Aug-25")
5. Vergleiche mit Tarif-GĂźltigkeiten
6. Wähle ältesten passenden Tarif
Routen-Struktur (Lanes)
Vordefinierte Transport-Lanes mit spezifischen Tarifen pro Route und Containertyp
🇧🇷 Brasilien → Deutschland
LOG 1.x
Hauptrouten von brasilianischen Häfen nach Hamburg (DEHAM)
Lane LOG 1: BRIOA (Itajaí) → DEHAM
Lane LOG 1.2: BRPNG (Paranaguá) → DEHAM
Lane LOG 1.3: BRSSZ (Santos) → DEHAM

Beispiel LOG 1.3 (20'DC):
• Ocean Freight: 2.150 USD
• Truck Origin: 1.900 USD
• Truck Destination: 1.455 EUR
• Destination THC: 270 EUR
🇹🇷 Türkei → Europa
LOG 2-4
Routen von Gebze (TĂźrkei) nach Polen und Deutschland
Lane LOG 2-3: TRGEB (Gebze) → PLGDY (Gdynia)
Lane LOG 4: TRGEB → PLGDY (45'HC Special)

Beispiel LOG 2 (20'DC):
• Ocean Freight: 1.795 USD
• Truck Destination: 850 EUR
• Destination THC: 184 EUR

Besonderheit LOG 4 (45'HC):
• All-inclusive Rate: 3.750 USD
• Truck Origin/Destination: inklusive
• Keine separaten THC-Charges
Implementierungsstatus
Übersicht der implementierten und geplanten Funktionen
Feature Status Version
OCR Text-Extraktion
PDF → Strukturierter Text		 ✓ Live v1.0
Header-Parsing
Rechnungsnummer, Datum, Sendungsnummer, ETD		 ✓ Live v1.0
Charge-Extraktion
USD/EUR Beträge mit Wechselkursen		 ✓ Live v1.0
Incoterm-Validierung
FOB Pre-Carriage Check		 ✓ Live v1.0
Steuer-Validierung
19% MwSt. auf Nachlaufkosten		 ✓ Live v1.0
Intelligentes Manuelles PrĂźf-System
Prioritätsbasierte ABSENDER-Erkennung mit 5 Trigger-Typen		 ✓ Live v1.0
ABSENDER-Extraktion
Tabellen-Format OCR-Parsing		 ✓ Live v1.0
Schulz-Sender Detection
Höchste Priorität, überschreibt alle Regeln		 ✓ Live v1.0
Demurrage/Detention Erkennung
Verzögerungsgebühren-Warnung		 ✓ Live v1.0
Biebesheim-Validierung
Typo-tolerante Referenz-Prüfung		 ✓ Live v1.0
Ausschreibungs-Erkennung
Jost-Warenausgang (Outbound) Detection		 ✓ Live v1.0
Orange Warn-System
UI-weite Statusanzeigen mit Reason-Codes		 ✓ Live v1.0
ETD-basierte Tarif-Auswahl
Automatische Tarifblatt-Zuordnung		 ✓ Live v1.0
Tarif-Datenbank
6 Quartals-Tarife (Q1-Q3 2025)		 ✓ Live v1.0
Detaillierte Tarif-Validierung
Lane-basierter Preis-Vergleich		 ✓ Live v1.0
Währungskonvertierungs-Check
USD→EUR Validierung		 ✓ Live v1.0