# Schritt 3 - Währung und Enrichment

> **Zielgruppe & Rolle**
>
> **Rolle**: Technik / Entwickler & Support | **Schritt**: 3 von 5 der Verarbeitungspipeline


# Währung und Enrichment

Nach der Extraktion wird der Beleg fachlich angereichert. Ziel ist, dass für Prüfung und Bestellabgleich möglichst viele Felder bereits belastbar vorliegen (Lieferant, Artikel, EUR-Betrag, Zahlungsbedingungen). Quelle der Stammdaten ist das Modul **masterdata**; trade hält nur einen abgeleiteten Suchindex.

> **Ziel des Schritts**
>
> Aus Extraktionsdaten einen belastbaren Buchungsvorschlag erzeugen.


## Währungsbehandlung

Quelle für den Tageskurs sind die [EZB-Referenzkurse](https://www.ecb.europa.eu/stats/eurofxref/eurofxref-hist-90d.xml). Die Stammdaten
(masterdata) laden sie täglich nach 16:30 Uhr (Europe/Berlin) und speichern sie; trade liest sie dort
(`GET /internal/exchange-rates`) und ruft die EZB nie selbst auf.

- Maßgeblich ist das Rechnungsdatum (ohne Rechnungsdatum der heutige Tag).
- Bei fehlendem Tageskurs (z. B. Wochenende/Feiertag) wird auf den letzten verfügbaren Kurs innerhalb von 6 Tagen ausgewichen.
- Der gefundene Kurs wird an der Rechnung als Wechselkurs gespeichert (`exchangeRate`); der EUR-Betrag (`totalAmountEur`) wird daraus berechnet.

Wenn kein Kurs ermittelt werden kann, läuft die Verarbeitung weiter: der EUR-Betrag bleibt leer und der nicht blockierende Sperrgrund `WECHSELKURS_FEHLT` wird gesetzt.

## Skonto und Zahlungsziel

Aus den gelesenen Skontostufen und dem Text der Zahlungsbedingungen werden bis zu zwei Skontostufen (Tage, Prozent), die Nettotage und – wenn die Rechnung keines nennt – das Fälligkeitsdatum bestimmt.

## Lieferanten- und Artikel-Enrichment

Der Schritt besteht aus zwei aufeinander aufbauenden Teilen: zuerst Lieferant, dann Positionen.

> **Lieferantenzuordnung**
>
> Ist der Rechnung noch kein Lieferant zugeordnet, sucht trade in dieser Reihenfolge:
> 1. **USt-IdNr** exakt in masterdata: ein Treffer wird übernommen; mehrere Treffer entscheidet ein KI-Modell (Modul `ai`, Rolle `decision`).
> 2. **IBAN** exakt in masterdata: genau ein Treffer wird übernommen.
> 3. **Vektorsuche** über Name und Anschrift im semantischen Index (pgvector, die 5 besten Treffer). Ein Treffer ab einer Ähnlichkeit von 0,92 wird direkt übernommen, sobald der Index des Mandanten vollständig synchronisiert ist; sonst entscheidet das KI-Modell zwischen den Kandidaten.
> 4. **Sammellieferant**: Ist in den Einstellungen ein Fallback-Lieferant hinterlegt, wird er gesetzt.
>
> Wie der Lieferant gefunden wurde, steht an der Rechnung (`exact_vat`, `exact_iban`, `semantic`, `llm`, `fallback`, `manual`). Bleibt die Suche ohne Ergebnis, wird der blockierende Sperrgrund `FEHLENDER_LIEFERANT` gesetzt; ist der Lieferant in masterdata gesperrt oder zahlungsgesperrt, `LIEFERANT_GESPERRT`.


| Ergebnis Lieferantenzuordnung | Systemverhalten | Wirkung im weiteren Ablauf |
| --- | --- | --- |
| Eindeutig gefunden | Lieferant wird gesetzt | Basis für Prüfung und Bestellabgleich ist stabil |
| Mehrdeutig | KI-Entscheidung zwischen den Kandidaten; ist sie unsicher, keine Zuordnung | Ohne Zuordnung: Sammellieferant oder Sperrgrund |
| Nicht gefunden | Sammellieferant, wenn konfiguriert | Ohne Sammellieferant: `FEHLENDER_LIEFERANT` (blockierend) |

> **Sammellieferant**
>
> Wenn kein Lieferant aufgelöst werden kann, kann ein konfigurierter Sammellieferant (Fallback-Kreditor) gesetzt werden.
>
> Damit bleibt der Beleg technisch verarbeitbar, auch wenn die finale fachliche Zuordnung noch offen ist.


> **Artikelzuordnung**
>
> Nach dem Lieferanten werden die Positionen ohne Artikel angereichert, in fester Reihenfolge:
> - Artikel auf der Ignorierliste der Einstellungen werden übersprungen und nicht abgeglichen,
> - exakter Abgleich der Artikelnummer bzw. Lieferanten-Artikelnummer gegen die Artikelnummern in masterdata (nur aktive Artikel),
> - exakter Abgleich der Lieferanten-Artikelnummer gegen die Artikel-Lieferanten des zugeordneten Lieferanten in masterdata,
> - Vektorsuche über Artikelnummer und Positionstext im semantischen Index; ab einer Ähnlichkeit von 0,92 bei vollständig synchronisiertem Index direkt, sonst entscheidet das KI-Modell (höchstens 30 Entscheidungen je Rechnung).
>
> Ein exakter Treffer hat damit immer Vorrang vor einem semantischen Treffer. Bei Treffer werden Artikel-ID und Artikelnummer an der Position gesetzt.
>
> Ohne Treffer bleibt die Position erhalten und erhält den blockierenden Sperrgrund `FEHLENDER_ARTIKEL`.


## Semantischer Index

Lieferanten und aktive Artikel aus masterdata liegen mit ihren Embeddings in trade (Tabellen `masterdata_index_suppliers`, `masterdata_index_products`, pgvector, ADR 0036). Gefüllt wird der Index aus dem Feed von masterdata, über die Synchronisation in den Einstellungen (`POST /api/trade/v1/inbound/index/sync`) und den Job `trade.index-backfill` für Mandanten ohne vollständige Synchronisation. Die Embeddings erzeugt das Modul `ai`.

---

> **Nächster technischer Schritt**
>
> Nach der Datenanreicherung folgt die gesetzliche und steuerliche Belegprüfung:
> [**Schritt 4: Belegprüfung (§ 14 UStG & Dubletten)**](/knowledge/docs/products/invoice/technical/step-4-business-and-legal-validation.md)
