Dokumentation › Produkte › ConnectINVOICE › ConnectINVOICE - Technische Referenz › Schritt 3 - Währung und Enrichment
Lieferanten- und Artikelzuordnung aus masterdata (exakt, Vektorsuche mit pgvector, KI-Entscheidung), Währungsumrechnung mit EZB-Kursen aus masterdata sowie Skonto und Zahlungsziel.
Zuletzt geändert am 18.11.2026
Auf dieser Seite
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. 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:
- USt-IdNr exakt in masterdata: ein Treffer wird übernommen; mehrere Treffer entscheidet ein KI-Modell (Modul
ai, Rolledecision).- IBAN exakt in masterdata: genau ein Treffer wird übernommen.
- 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.
- 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 SperrgrundFEHLENDER_LIEFERANTgesetzt; 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)
Hat das geholfen?
https://app.mbcom.cloud/knowledge/docs/products/invoice/technical/step-3-currency-and-enrichment