Zum Inhalt springen
Schritt 3 - Währung und Enrichment
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:

  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)

Hat das geholfen?