# Schritt 5 - Bestellabgleich und Freigabe

> **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](/knowledge/docs/products/invoice/technical/step-4-business-and-legal-validation.md)) |

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**](/knowledge/docs/products/invoice/technical/lock-reasons.md)
