Ein Wiegeschein wird zu mehreren zusammengehörigen Angaben
Für unser Beispiel sendet die Waage am Standort Nord den Beleg W-104. Er gehört zu Auftrag A-204, Position 10, und enthält 19.000 kg Nettogewicht. Das ERP soll daraus 19 Tonnen für die Abrechnung übernehmen. Die Feldnamen der folgenden Tabelle sind ein Entwurf für diese Übergabe. Sie behaupten keinen vorhandenen Branchenstandard.
Vor der Entwicklung müssen beide Seiten dieselbe Bedeutung vereinbaren. Eine Kundennummer im Waagesystem kann eine Anlieferadresse bezeichnen, während das ERP darunter den Rechnungsempfänger führt. Die Gleichheit der Zeichenfolge beweist dann keine richtige Zuordnung.
| Quelle Waage | Beispiel | Ziel / Prüfung |
|---|---|---|
| standort + beleg_id | NORD + W-104 | Eindeutiger Belegschlüssel |
| revision | 1 | Änderungsstand dieses Belegs |
| auftrag + position | A-204 / 10 | Vorhandene, offene Auftragsposition |
| netto_kg | 19000 | 19,000 t nach expliziter Umrechnung |
| material_id | MAT-17 | Zuordnung zum Artikel im ERP |
| leistungszeit | 19.08.2026, 10:42, Europe/Berlin | Leistungsdatum mit Zeitzonenbezug |
| ereignis_id | NORD-W104-R1 | Kennung dieser Übertragung |
| originalbeleg | W-104.pdf | Abrufbarer Belegbezug |
Der Schlüssel unterscheidet Standorte. Die Ereignis-ID unterscheidet Fassungen desselben Belegs.
Welche Seite etwas ändern darf
Die Nettomenge stammt in diesem Entwurf aus der freigegebenen Wägung. Preisvereinbarung und Rechnungsstatus führt das ERP. Die Disposition führt die geplante Fahrt. Ein Schnittstellenvertrag hält diese Zuständigkeiten je Feld fest, einschließlich der erlaubten Korrektur.
Fehlt die Materialzuordnung, darf die Schnittstelle nicht irgendeinen ähnlichen Artikel verwenden. Sie legt einen Fehlerfall mit Beleg und unbekannter Material-ID an. Nach der Zuordnung wird dasselbe Ereignis erneut verarbeitet. Das Bedienpersonal muss die Menge nicht noch einmal von Hand abschreiben.
Das gilt auch für Einheiten. Ein Zahlenwert 19000 ohne Einheit darf nicht als 19.000 Tonnen erscheinen. Die Übernahme prüft das Format und die vereinbarte Maßeinheit. Zusätzlich kann eine betriebliche Plausibilitätsprüfung ungewöhnliche Werte markieren. Deren Grenzen ergeben sich aus den konkreten Fahrzeugen und Leistungen, nicht aus einer universellen Zahl.
Eine Wiederholung bleibt dieselbe Lieferung
Der Empfänger speichert die Ereignis-ID zusammen mit dem Verarbeitungsergebnis. Kommt NORD-W104-R1 unverändert erneut an, liefert er das bereits vorhandene Ergebnis zurück. Er erzeugt keine neue Abrechnungsposition. Dieses Verhalten heißt idempotent.
AWS beschreibt dieses Prinzip mit einer vom Aufrufer vergebenen Kennung. Im selben Beitrag wird auch der Fall behandelt, dass eine bekannte Kennung plötzlich andere Parameter enthält. Für unsere Waage ist das eine widersprüchliche Nachricht, die nicht als gewöhnliche Wiederholung durchlaufen sollte.
Belegnummer allein genügt dafür nicht: Eine spätere Korrektur gehört weiterhin zu W-104, ist aber ein neues Ereignis. Ein reiner Vergleich des Inhalts genügt ebenfalls nicht. Zwei verschiedene Lieferungen können dasselbe Gewicht, Material und Datum haben.
Für die technische Umsetzung müssen Übernahme und Registrierung der Ereignis-ID zusammenpassen. Ein Absturz zwischen diesen beiden Schritten darf nicht dazu führen, dass die Lieferung bereits gebucht ist, die Doppelprüfung davon aber nichts weiß. Diese Eigenschaft gehört in den technischen Test, auch wenn das Bedienpersonal sie später nicht sieht.
19,0 Tonnen werden zu 18,6 Tonnen
Nehmen wir an, W-104 wird fachlich geprüft und die Nettomenge mit einem dokumentierten Grund auf 18.600 kg berichtigt. Die Waage sendet Revision 2 mit neuer Ereignis-ID und Bezug auf Revision 1. Das ERP erkennt eine Korrektur um minus 0,4 Tonnen. Eine wiederholte Revision 1 darf diesen neueren Stand anschließend nicht zurücksetzen.
Ist die Leistung noch nicht abgerechnet, kann die freigegebene Korrektur die offene Abrechnungsmenge ersetzen. Besteht bereits eine freigegebene oder versandte Rechnung, braucht die Abrechnung einen Folgefall. Die Schnittstelle verändert dieses Dokument nicht stillschweigend. Welche Rechnungskorrektur folgt, richtet sich nach dem dokumentierten Rechnungsprozess.
- 1Revision 1W-104 wird mit 19,0 t übernommen.
- 2KorrekturRevision 2 meldet 18,6 t und den Änderungsgrund.
- 3StatusprüfungOffene Abrechnungsmenge oder bereits abgerechnete Leistung?
- 4FolgeaktionOffene Menge berichtigen oder Rechnungskorrektur zur Bearbeitung geben.
Die Mengendifferenz beträgt -0,4 t. Bei 28 €/t entspricht sie -11,20 € für diese Annahmeposition.
Die Tageskontrolle findet stille Lücken
Ein grüner Verbindungsstatus sagt wenig darüber aus, ob alle Belege angekommen sind. Eine tägliche Gegenprüfung kann die freigegebenen Belegkennungen der Waage mit den übernommenen Belegkennungen im ERP vergleichen. Mengen werden zusätzlich je Standort, Einheit und Material summiert.
Angenommen, die Waage hat 42 freigegebene Belege, das ERP kennt 41. Die Gegenprüfung nennt den fehlenden Schlüssel. Bei identischer Belegzahl können sich trotzdem Mengen unterscheiden, etwa nach einer nicht übertragenen Revision. Deshalb gehören Anzahl, Schlüssel und Mengenstand zusammen.
Ein länger offener Fehler braucht eine zuständige Person und einen sichtbaren Zeitpunkt. Eine automatische Wiederholung hilft bei einer kurz unterbrochenen Verbindung. Bei einer unbekannten Auftragsnummer wiederholt sie nur denselben Fehler. Der Bearbeiter muss erkennen, welche Art von Problem vorliegt.
Was vor einer Beauftragung feststehen sollte
Eine API ist nicht bei jedem System vorhanden. Ein geplanter Dateiexport kann für eine Übergabe genügen, wenn Dateiverarbeitung, Bestätigung und Fehlerbearbeitung zuverlässig geregelt sind. Direkte Änderungen an der Herstellerdatenbank sind kein beiläufiger Ersatz für eine fehlende Schnittstelle.
- Welche Version der Wiegesoftware läuft, und welche dokumentierten Export- oder API-Funktionen sind freigeschaltet?
- Welche Belegzustände dürfen übertragen werden, und wie werden Storno und Korrektur kenntlich gemacht?
- Welche Kennungen verbinden Kunde, Auftrag, Position und Material zwischen den Systemen?
- Wie meldet das Ziel eine erfolgreiche Verarbeitung zurück, und wie wird ein offener Fehler erneut bearbeitet?
- Wer betreut die Verbindung nach Updates und kontrolliert die tägliche Gegenprüfung?
Ein kleiner Abnahmetest mit klaren Ergebnissen
Senden Sie denselben Beleg zweimal, dann seine Korrektur, danach noch einmal die alte Fassung. Es darf am Ende genau eine aktuelle Abrechnungsmenge von 18,6 Tonnen geben. Ergänzen Sie einen Beleg mit unbekanntem Material und unterbrechen Sie einmal die Bestätigung. Beide Fälle müssen ohne doppelte Lieferung wiederaufnehmbar sein.
Das Feldmapping als CSV kann mit dem Waagenhersteller und dem ERP-Partner ausgefüllt werden. Die technische Verbindung ist dann als konkrete Übergabe prüfbar: welche Daten, welche Fassungen und welches Ergebnis.