Validierungsregeln

Umfassende Geschäftslogik-Engine für die Validierung von Frachtabrechnungen

Frachttarif-Struktur
Gewichtsbasierte Preismatrix mit zonenspezifischen Tarifen
Zone 66-63 (Eingang Beispiel)
€32.01
Mindestpreis
€471.95
Höchstpreis
25
Gewichtsstufen
Gewichtsbereich (kg) Tarif je kg Beispielberechnung
0 bis <100 €0.3258 50kg × €0.3258 = €16.29
100 bis <150 €0.2944 125kg × €0.2944 = €36.80
150 bis <200 €0.2628 175kg × €0.2628 = €46.00
200 bis <250 €0.2314 225kg × €0.2314 = €52.07
250 bis <300 €0.1998 275kg × €0.1998 = €54.95
300 bis <400 €0.1885 350kg × €0.1885 = €65.98
400 bis <500 €0.1772 450kg × €0.1772 = €79.74
500 bis <750 €0.1681 625kg × €0.1681 = €105.06
750 bis <1.000 €0.1554 875kg × €0.1554 = €135.98
1.000 bis <1.250 €0.1382 1.125kg × €0.1382 = €155.48
1.250 bis <1.500 €0.1269 1.375kg × €0.1269 = €174.49
1.500 bis <1.750 €0.1269 1.625kg × €0.1269 = €206.21
1.750 bis <2.000 €0.1140 1.875kg × €0.1140 = €213.75
2.000 bis <2.500 €0.1011 2.250kg × €0.1011 = €227.48
2.500 bis <3.000 €0.0884 2.750kg × €0.0884 = €243.10
3.000 bis <3.500 €0.0757 3.250kg × €0.0757 = €246.03
3.500 bis <4.000 €0.0630 3.750kg × €0.0630 = €236.25
4.000 bis <5.000 €0.0503 4.500kg × €0.0503 = €226.35
5.000 bis <7.500 €0.0452 6.250kg × €0.0452 = €282.50
7.500 bis <10.000 €0.0400 8.750kg × €0.0400 = €350.00
10.000 bis <12.500 €0.0366 11.250kg × €0.0366 = €411.75
12.500 bis <15.000 €0.0332 13.750kg × €0.0332 = €456.50
15.000 bis <17.500 €0.0314 16.250kg × €0.0314 = €510.25
17.500 bis <20.000 €0.0297 18.750kg × €0.0297 = €556.88
20.000+ €0.0297 22.500kg × €0.0297 = €668.25
Erweiterte Frachtberechnungslogik
Alternativabrechnung und Sonderregelungen für Schwertransporte
⚡ Alternativabrechnung (für alle Gewichte)
Für alle Sendungen (unabhängig vom Gewicht):
Das System berechnet automatisch ZWEI verschiedene Preise und wählt den günstigeren für den Kunden:

📊 Standard-Methode:
Fracht = Gewicht × Tarif je kg

📊 Alternative-Methode:
Fracht = Gewicht × Tarif je kg aus dem nächsten Gewichtsbereich
💡 Beispielrechnung (5.000 kg, Zone 66-63):
• Standard: 5000 × 0,050305 = 251,53
• Alternative: 5000 × 0,070199 = €350,99
→ System wählt: €251,53 (Standard günstiger)
🔧 Wichtige technische Details:
• Gilt für ALLE Zonen und Richtungen (Inbound/Outbound)
• Min/Max-Preis-Grenzen werden auf BEIDE Berechnungen angewendet
• Wird automatisch angewendet, keine manuelle Auswahl

💾 Quelle: Dashboard-Code Zeilen 1342-1386 ("JOST Fix #1: Alternative Billing Logic")
📐 Gewichtsklassen-Logik (Bracket Selection):

Das System verwendet "<" (kleiner als) statt "≤" für Gewichtsklassen-Grenzen:

Beispiele:
• 99,9 kg → Klasse "bis 100kg" (99,9 < 100 ✓)
• 100,0 kg → Klasse "bis 150kg" (100 < 100 ✗, daher nächste Klasse)
• 150,0 kg → Klasse "bis 200kg" (150 < 150 ✗, daher nächste Klasse)
Grund: Verhindert Rundungsfehler an exakten Klassengrenzen und gewährleistet konsistente Tarifzuordnung.

💾 Quelle: Dashboard-Code Zeile 1326 ("JOST Fix #2: Change bracket selection from '≤' to '<'")
Zuschlagsregeln
Zusätzliche Gebühren und Berechnungsmethoden
Diesel
Prozentual
Aktiv
Kraftstoffzuschlag auf alle Frachtberechnungen angewendet
Satz: 7,0% des Frachtbetrags
Berechnung: Fracht × 0,07
Beispiel: €200,00 × 7% = €14,00
Straßenbenutzungsgebühr / Maut
Gewichtsstufen
Gewichtsbasiert
Straßenmautgebühren basierend auf Fahrzeuggewicht
• ≤ 3.000kg: 5,6% der Fracht
• > 3.000kg: 7,8% der Fracht
Premiumdienst HoBi NextDay
Festtarif
€12,50 ⚠️ Prüfpflichtig
Express-Lieferservice mit Nächster-Tag-Garantie
Fester Betrag: €12,50
Gilt für: Alle JOST-Unternehmen
• JOST NI: €12,50
• JOST WE: €12,50
• ROCKINGER WH: €12,50

⚠️ Manuelle Prüfung erforderlich:
Das System validiert die Tarif-Höhe (12,50€),
aber die Anwendbarkeit muss manuell gegen
Buchung/Bestellung (PO) geprüft werden.
Status: PRÜFEN (auch wenn Betrag korrekt)
Globale Richtlinien
Systemweite Validierungseinstellungen
19,0%
MwSt.-Satz
15+
Unterstützte Zonen
3
Zuschlagsarten
99,9%
Genauigkeitsrate
Validierungsstatus-Kategorien
4-Stufen-System zur Klassifizierung von Prüfergebnissen
Status Bedeutung Farbe Erforderliche Aktion
OK Keine Abweichung erkannt
(auf Cent-Ebene gerundet)		 ● Grün ✓ Keine Aktion erforderlich
Position ist korrekt abgerechnet
VORTEIL Vorteilhafte Abweichung
Sie zahlen WENIGER als erwartet		 ● Hellgrün ℹ️ Zu Ihren Gunsten
Optional: Klärung mit Spediteur
Keine Reklamation nötig
ABWEICHUNG Nachteilige Abweichung
Sie zahlen MEHR als erwartet		 ● Rot ⚠️ Reklamation erforderlich
Zu Ihren Lasten - bitte prüfen und reklamieren
PRÜFEN Manuelle Prüfung erforderlich
Zwei Fälle:
1. Premiumdienst
2. Route nicht gefunden		 ● Orange Fall 1 - Premiumdienst (Code 172):
→ Tarif €12,50 ist korrekt
→ Prüfen gegen Buchung/PO ob Service bestellt wurde

Fall 2 - Route nicht gefunden:
→ Tarif existiert nicht im System
→ Könnte Sonderfahrt sein (separat vereinbart)
→ Manuelle Tarifprüfung bei JOST erforderlich
💡 Hinweis zur Abweichungsrichtung:

• Positiver Betrag (+) in Audit-Log = Vorteilhaft (Sie zahlen weniger)
• Negativer Betrag (-) in Audit-Log = Nachteilig (Sie zahlen mehr)

Die Abweichung wird immer berechnet als: Erwartet - Tatsächlich
Beispiel: Erwartet €100, Tatsächlich €95 → Abweichung +€5 (VORTEIL)
📊 Statistik im Dashboard:
Das Audit-Log zeigt Gesamtabweichungen:
• Anzahl vorteilhafter Positionen + Gesamtbetrag (grün)
• Anzahl nachteiliger Positionen + Gesamtbetrag (rot)
• Anzahl manuell zu prüfender Positionen (orange)
• Netto-Abweichung (vorteilhaft - nachteilig)
💾 Quelle: Dashboard-Code Zeilen 2893-2948 (createValidationRow function) und 2764-2849 (performValidation categorization)
Validierungsprozess-Ablauf
Schritt-für-Schritt Rechnungsverifizierungsmethodik
Schritt Validierungsprüfung Geschäftsregel Status
1.1 Zeilensummierung Summe aller Detailpositionen = Rechnungs-Nettobetrag Kritisch
1.2 Gesamtbetrag-Verifizierung Nettobetrag + MwSt. = Rechnungs-Gesamtbetrag Kritisch
2.1 MwSt.-Satz-Verifizierung MwSt.-Berechnung mit 19,0% Satz Kritisch
3.1 Frachttarif-Logik Gewichtsbasierte Zonen-Matrix-Validierung Kern
3.2 Zuschlagsvalidierung Regelbasierte Zuschlagsberechnung Kontextbezogen
3.3 Spezialvereinbarungen Streckenspezifische Ausnahmebehandlung Optional
Systemfähigkeiten
Erweiterte Funktionen der Validierungs-Engine
Multi-Zonen-Unterstützung
15+ Zonen
Umfassende Abdeckung aller wichtigen europäischen Frachtrouten mit Ein- und Ausgangs-Tarifmatrizen.
Dynamische Datumslogik
Zeitbewusst
Automatische Anwendung von Tarifänderungen basierend auf Rechnungsdaten für historische Genauigkeit.
Ausnahmebehandlung
Intelligente Regeln
Intelligente Verarbeitung spezieller Streckenvereinbarungen und benutzerdefinierter Geschäftsregeln.
Leistungskennzahlen
Echtzeit-Validierungsstatistiken
< 60s
Verarbeitungszeit
99,7%
Genauigkeitsrate
50+
Validierungsregeln
24/7
Verfügbarkeit
Qualitätssicherung
Alle Validierungsregeln werden kontinuierlich anhand echter Rechnungsdaten getestet, um maximale Genauigkeit und Zuverlässigkeit in Produktionsumgebungen zu gewährleisten.