Zum Inhalt springen
Schritt 5 - Bestellabgleich und Freigabe
ConnectINVOICE - Technische Referenz

Schritt 5 - Bestellabgleich und Freigabe

Abgleich der Eingangsrechnung mit Bestellung und Wareneingängen, Statusentscheidung, automatische und manuelle Freigabe, Freigabe-Workflows und Statusübergänge.

Zuletzt geändert am 18.11.2026

Auf dieser Seite

Zielgruppe & Rolle

Rolle: Technik / Entwickler & Support | Schritt: 5 von 5 der Verarbeitungspipeline

Bestellabgleich und Freigabe

In diesem Schritt wird die geprüfte Rechnung gegen Bestellung und Wareneingang abgeglichen, ihr Status entschieden und die Rechnung freigegeben oder abgelehnt. Bestellungen und Wareneingänge sind Belege in trade selbst (Einkauf); eine Anlage oder Verbuchung in microtech gehört nicht mehr zur Strecke.

Ziel des Schritts

Aus einem geprüften Beleg wird eine freigegebene Eingangsrechnung – direkt, automatisch oder nach Klärung der Sperrgründe.

Bestellung finden

Der Abgleich läuft nur für Rechnungen (Code 380); Gutschriften und Rechnungskorrekturen werden nicht abgeglichen (matchingStatus: not_applicable). Die Bestellung wird in dieser Reihenfolge gesucht:

Reihenfolge Quelle Hinweis
1 Von einer Person gewählte Bestellung über POST /inbound-invoices/:id/match
2 Bereits verknüpfte Bestellung aus einem früheren Abgleich
3 Bestellnummern auf der Rechnung (Kopf und Positionen) nur Bestellungen, die zum Lieferanten passen
4 Offene Bestellungen des Lieferanten höchstens 10 werden geprüft

Von mehreren Kandidaten gewinnt die Bestellung mit den wenigsten blockierenden Abweichungen. Ohne Bestellung gilt:

  • Nennt die Rechnung eine Bestellnummer, die keine Bestellung ist: BESTELLUNG_NICHT_GEFUNDEN (immer blockierend).
  • Ohne Bestellbezug: FEHLENDE_BESTELLUNG (blockierend), wenn der Lieferant laut masterdata Bestellungen verlangt (fehlende Angabe gilt als verlangt); sonst ist der Abgleich not_required und nichts blockiert.

Abgleich je Position

Jede Rechnungsposition (ohne ignorierte Artikel) wird der passenden Bestellposition zugeordnet und geprüft:

Prüfung Bedingung Sperrgrund
Position in der Bestellung keine passende Bestellposition UNBEKANNTE_POSITION
Einzelpreis höher als bestellt, über der prozentualen und der absoluten Toleranz (Standard 1 % und 1,00 €) PREISABWEICHUNG
Menge mehr als bestellt, sofern Mehrmengen nicht erlaubt sind MENGENABWEICHUNG
Steuersatz weicht von der Bestellposition ab STEUERABWEICHUNG
Wareneingang für die Bestellposition liegt kein Wareneingang vor FEHLENDER_WARENEINGANG
Gelieferte Menge Rechnungsmenge übersteigt gelieferte minus bereits berechnete Menge MENGE_NICHT_GELIEFERT
EGIS Beträge weichen von den Rechnungsdaten ab, die der Distributor an EGIS gemeldet hat EGIS_ABWEICHUNG

Alle Sperrgründe des Abgleichs sind blockierend. Toleranzen und Mehrmengen stellt der Mandant in den Einstellungen des Rechnungseingangs ein. Zusatzpositionen aus EGIS (Fracht, Zuschläge, Versicherung) ohne Bestellposition blockieren nicht.

Statusentscheidung

Status Wann
MATCHED keine blockierenden Sperrgründe (Ereignis trade.inboundinvoice.matched)
DISCREPANCY mindestens ein blockierender Sperrgrund aus Pipeline oder automatischem Abgleich (Ereignis trade.inboundinvoice.blocked)
IN_REVIEW blockierende Sperrgründe nach einer Korrektur oder einem Abgleich durch eine Person
DUPLICATE Dublette (siehe Schritt 4)

Nach einem Wareneingang zur Bestellung gleicht trade die zugehörigen Rechnungen automatisch erneut ab (außer IN_REVIEW), sodass FEHLENDER_WARENEINGANG sich von selbst auflöst.

Freigabe

  • Automatische Freigabe (Einstellung autoRelease: off, dryRun, on; Standard aus): Eine Rechnung, die im Abgleich MATCHED wird, wird in derselben Transaktion freigegeben, wenn die Regel sie zulässt (bekannter Lieferant mit genügend freigegebenen Rechnungen, Höchstbetrag, Erlaubt- und Ausschlusslisten). Hat eine Person die Rechnung schon bearbeitet, wird nie automatisch freigegeben. Eine automatisch freigegebene Rechnung lässt sich mit POST /inbound-invoices/:id/reopen (Kommentar Pflicht) zurück nach MATCHED holen und wird danach nie wieder automatisch freigegeben.
  • Freigabe durch eine Person: POST /inbound-invoices/:id/release aus MATCHED, DISCREPANCY oder IN_REVIEW (Berechtigung tenant:trade:inbound:approve). Bei blockierenden Sperrgründen nur mit ausdrücklicher Übersteuerung und Kommentar.
  • Freigabe-Workflows: Vorlagen des Moduls workflow greifen Rechnungen nach Belegart und Status auf (z. B. MATCHED zur Freigabe, DISCREPANCY/IN_REVIEW zur Klärung) und schreiben das Ergebnis über die interne API von trade zurück. Solange ein Workflow läuft, ist die Rechnung gesperrt.
  • Ablehnung: POST /inbound-invoices/:id/reject setzt REJECTED (Ereignis trade.inboundinvoice.rejected).

RELEASED ist der Endpunkt der Strecke (Ereignis trade.inboundinvoice.released mit Rechnungsnummer, Lieferant, Bestellung, Betrag und DMS-Dokument). Eine Übergabe freigegebener Eingangsrechnungen an microtech gibt es derzeit nicht.

Klärung von Sperrgründen

  • Korrigieren: PATCH /inbound-invoices/:id ändert Kopf und Positionen; Prüfung und Abgleich laufen danach erneut.
  • Erneut abgleichen: POST /inbound-invoices/:id/match, optional gegen eine bestimmte Bestellung. POST /api/trade/v1/inbound/compare mit der Rechnungsnummer tut dasselbe für Aufrufe von außen.
  • Sperrgrund akzeptieren: POST /inbound-invoices/:id/lock-reasons/resolve nimmt einen blockierenden Sperrgrund mit Kommentar an; er blockiert bis zum nächsten Neueinlesen des Dokuments nicht mehr. …/lock-reasons/reopen hebt das wieder auf.

Technische Nachläufe

Prozess Verhalten
Verlauf Jede Statusänderung steht mit Akteur (Person, Workflow, System) und Notiz im Protokoll der Rechnung.
Ereignisse Statusänderungen werden im Outbox-Feed von trade angekündigt (trade.inboundinvoice.*) – in derselben Transaktion wie die Änderung.
Dokumentverknüpfung Nach der Auswertung verknüpft trade das DMS-Dokument mit der Rechnung und dem Lieferanten; ein Fehler wird nur protokolliert und beim nächsten Lauf nachgeholt.
Erneute Verarbeitung FAILED oder hängende Rechnungen werden mit POST /inbound-invoices/:id/reprocess neu verarbeitet.

Nächster technischer Schritt

Detaillierte Übersicht über alle möglichen Sperrgründe und deren Behebung: Sperrgründe

Hat das geholfen?