# ConnectINVOICE - Technische Referenz

> **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.

- [Prozessverlauf & Systemarchitektur](/knowledge/docs/products/invoice/process-flow.md)
- [Dokumentenklassifizierung & UN/EDIFACT](/knowledge/docs/products/user-docs/classification.md)
- [Eingang und Übernahme](/knowledge/docs/products/invoice/step-1-receipt-and-intake.md)
- [Extraktion](/knowledge/docs/products/invoice/step-2-extraction.md)
- [Feldzuordnung E-Rechnung](/knowledge/docs/products/invoice/field-mapping.md)
- [Währung und Enrichment](/knowledge/docs/products/invoice/step-3-currency-and-enrichment.md)
- [Belegprüfung](/knowledge/docs/products/invoice/step-4-business-and-legal-validation.md)
- [Bestellabgleich und Freigabe](/knowledge/docs/products/invoice/step-5-audit-erp-posting-and-status.md)
- [Sperrgründe](/knowledge/docs/products/invoice/lock-reasons.md)

```mermaid
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)**](/knowledge/docs/products/invoice/process-flow.md)
