Zum Inhalt springen
ConnectINVOICE - Technische Referenz
ConnectINVOICE

ConnectINVOICE - Technische Referenz

Technische Referenz der Verarbeitungsstrecke für Eingangsbelege - Belegeingang in comms, Ablage und Texterkennung im DMS, Auswertung, Prüfung und Bestellabgleich in trade.

Zuletzt geändert am 18.11.2026

Auf dieser Seite

Zielgruppe & Rolle

Rolle: Technik / Entwickler & Support | Bereich: Technische Verarbeitungsstrecke

Invoice Ablauf

Die Verarbeitungsstrecke für Eingangsbelege verteilt sich auf drei Module mit klaren Zuständigkeiten:

  • comms empfängt die Mails des Belegeingangs (Plattform-Adresse über Amazon SES oder ein Microsoft-365-Postfach) und übergibt PDF- und XML-Anhänge an das DMS.
  • DMS speichert jedes Dokument, prüft es mit ClamAV auf Schadsoftware, liest den Text (Textebene, KI-OCR über das Modul ai, E-Rechnungs-XML), ordnet den Dokumenttyp zu und kündigt das Ergebnis in seinem Outbox-Feed an (ADR 0002).
  • trade folgt diesem Feed, legt je Dokument eine Eingangsrechnung an, liest die Belegdaten aus (E-Rechnung oder KI-Extraktion), ordnet Lieferant und Artikel aus den Stammdaten zu, prüft die Pflichtangaben nach § 14 UStG, Dubletten und den Bestellbezug und gibt die Rechnung frei – automatisch oder durch eine Person bzw. einen Freigabe-Workflow.

Der Zustand jeder Eingangsrechnung liegt in Postgres (trade, Tabelle sales_transactions), die Dateien liegen im DMS. S3-Zustandspräfixe gibt es nur noch im SES-Eingangs-Bucket von comms. KI-Aufrufe (OCR, Klassifizierung, Extraktion, Zuordnungsentscheidungen, Embeddings) laufen ausschließlich über das Modul ai.

Themen

Kompakter Überblick über den End-to-End-Prozess. Details stehen auf den Unterseiten.

graph TD

    %% Eingang in comms
    Start["<b>Belegeingang (comms)</b><br/>SES-Plattformadresse oder<br/>Microsoft-365-Postfach"] --> Intake["<b>Mail-Intake</b><br/>Mail-Datensatz in Postgres,<br/>PDF/XML-Anhänge als Upload-Befehle an das DMS"]

    %% DMS
    Intake --> Store["<b>DMS-Ablage</b><br/>Dokument mit Rolle<br/>Original-Eingangsbeleg"]
    Store --> Scan{"<b>ClamAV-Prüfung</b><br/>Version sauber?"}
    Scan -- "Nein (INFECTED)" --> Blocked["<b>Gesperrt</b><br/>keine Extraktion,<br/>keine Auslieferung"]
    Scan -- "Ja (CLEAN)" --> TextExtraction["<b>Textextraktion</b><br/>E-Rechnungs-XML, PDF-Textebene,<br/>KI-OCR (ai), Tika"]
    TextExtraction --> DocClass["<b>Dokumentklassifizierung</b><br/>Dokumenttyp und Zielmodul<br/>(E-Rechnungen ohne KI)"]
    DocClass --> Feed["<b>DMS-Outbox-Feed</b><br/>dms.document.text_extracted /<br/>text_extraction_failed / classified"]

    %% trade
    Feed --> Ensure["<b>trade: Eingangsrechnung</b><br/>idempotent je DMS-Dokument<br/>Status RECEIVED"]
    Ensure --> IsEInvoice{"<b>E-Rechnung?</b><br/>XRechnung (CII/UBL)<br/>oder ZUGFeRD"}
    IsEInvoice -- "Ja" --> Kosit["<b>E-Rechnung auslesen</b><br/>kosit-Bibliothek → Common-Format"]
    IsEInvoice -- "Nein" --> Classify["<b>KI-Klassifizierung</b><br/>380 / 381 / 384 / 270 / 999"]
    Classify -- "999" --> RejectOther["<b>REJECTED</b><br/>keine Rechnung"]
    Classify -- "270" --> DeliveryNote["<b>Lieferschein</b><br/>Übergabe an die Lieferscheine"]
    Classify -- "Rechnung" --> Extract["<b>KI-Extraktion</b><br/>Kopf- und Positionsdaten"]
    Kosit --> Extracted["<b>EXTRACTED</b><br/>Extraktion gespeichert"]
    Extract --> Extracted

    subgraph Evaluate [Auswertung]
        Extracted --> Supplier["<b>Lieferant</b><br/>USt-IdNr / IBAN exakt,<br/>Vektorsuche (pgvector), KI-Entscheidung,<br/>Sammellieferant"]
        Supplier --> Articles["<b>Artikel</b><br/>Artikelnummer, Lieferanten-Artikelnummer,<br/>Vektorsuche, KI-Entscheidung"]
        Articles --> Currency["<b>Währung & Skonto</b><br/>EZB-Kurs aus masterdata"]
        Currency --> UStG["<b>§ 14 UStG</b><br/>Pflichtangaben"]
        UStG --> Duplicate{"<b>Dublette?</b>"}
        Duplicate -- "Nein" --> Match["<b>Bestellabgleich</b><br/>Bestellung & Wareneingang"]
    end

    Duplicate -- "Ja" --> Dup["<b>DUPLICATE</b>"]
    Match --> Blocking{"<b>Blockierende<br/>Sperrgründe?</b>"}
    Blocking -- "Nein" --> Matched["<b>MATCHED</b>"]
    Blocking -- "Ja" --> Discrepancy["<b>DISCREPANCY</b>"]

    Matched --> AutoRelease{"<b>Automatische<br/>Freigabe?</b>"}
    AutoRelease -- "Ja" --> Released["<b>RELEASED</b>"]
    AutoRelease -- "Nein" --> Workflow["<b>Freigabe</b><br/>Person oder Freigabe-Workflow"]
    Discrepancy --> Review["<b>Prüfung</b><br/>Korrektur, Sperrgrund akzeptieren,<br/>Abgleich erneut"]
    Review --> Workflow
    Workflow --> Released
    Workflow --> Rejected["<b>REJECTED</b>"]

    %% Hintergrund
    subgraph Background [Hintergrund-Prozesse]
        MDFeed["<b>masterdata-Feed</b><br/>Lieferanten & Artikel"] --> VectorDB["<b>Semantischer Index</b><br/>pgvector in trade"]
        ECBFetch["<b>masterdata</b><br/>EZB-Referenzkurse täglich"] --> Rates[("<b>Kurse in masterdata</b><br/>/internal/exchange-rates")]
    end

    style Evaluate fill:#e8f2ff,stroke:#7ea6d8,stroke-width:1px,fill-opacity:0.35
    style Background fill:#f3f6fb,stroke:#98a7c0,stroke-width:1px,fill-opacity:0.35

Nächster technischer Schritt

Beginnen Sie mit dem vollständigen Verarbeitungsablauf und der Systemarchitektur: Prozessverlauf (End-to-End Visualisierung & Architektur)

Hat das geholfen?