Technische Referenz
Diese Referenz unterstützt Installation, Betrieb und Analyse. Sie ersetzt keine fachliche Berechtigungskonzeption.
Paket und Workflow-Vorlagen
| Typ | Technische Bezeichnung | Zweck |
|---|---|---|
| Paket-Namespace | SNC_INVOICE |
Namespace des SIEVERS AI Agent for ELO |
| Start-Workflow | SNC_INVOICE_AGENT.START |
Ruft den Agenten für die Verarbeitung auf |
| Clearing-Workflow | SNC_INVOICE_AGENT.CLEARING |
Klärt fehlende Unternehmens- und Geschäftspartnerdaten |
| Flow-Vorlage | SNC_INVOICE_AGENT_START |
Startet die Verarbeitung eines einzelnen Belegs |
| Flow-Vorlage | SNC_INVOICE_AGENT_START_MULTIPLE_INVOICES |
Startet die Verarbeitung mehrerer Belege |
| Flow-Vorlage | SNC_INVOICE_AGENT_ENTRY |
Einstieg in die Agentenverarbeitung |
| Flow-Vorlage | SNC_INVOICE_AGENT_EXTRACT_HEADER |
Extrahiert Belegkopfdaten |
| Flow-Vorlage | SNC_INVOICE_AGENT_EXTRACT_METADATA |
Extrahiert Metadaten |
| Flow-Vorlage | SNC_INVOICE_AGENT_SET_METADATA |
Übernimmt Metadaten am Beleg |
| Flow-Vorlage | SNC_INVOICE_SET_MISSING_METADATA |
Übernimmt im Clearing ausgewählte Metadaten |
| Flow-Vorlage | SNC_INVOICE_AGENT_ACCOUNTING_LINES_START |
Startet die KI-Vorbelegung der Kontierungszeilen |
| Flow-Vorlage | SNC_INVOICE_AGENT_ACCOUNTING_LINES_WF_TRIGGER |
Startet die Kontierung aus einem Workflow heraus |
| Flow-Vorlage | SNC_INVOICE_AGENT_ACCOUNTING_LINES_CREATE |
Erzeugt die KI-Vorbelegung aus den Positionsdaten |
Feed-Beiträge
Der Agent schreibt Statusinformationen als Beiträge in den ELO Feed des verarbeiteten Belegs. Der erste Beitrag wird unabhängig vom Eingangskanal geschrieben; für E-Rechnungen, Vorverarbeitung, KI-Erkennung, Clearing und KI-Kontierung gelten die folgenden Meldungen:
| Prozessschritt | Meldung |
|---|---|
| Start der Verarbeitung | Verarbeitung mittels Invoice Agent wurde gestartet |
| E-Rechnung erkannt | Rechnung als E-Rechnung erkannt |
| Vorverarbeitung gestartet | Vorverarbeitung wird ausgeführt |
| KI-Erkennung gestartet | KI-Erkennung wird durchgeführt |
| KI-Erkennung abgeschlossen | KI-Erkennung abgeschlossen |
| Mandant nicht gefunden | Mandant konnte im ELO nicht gefunden werden: {0} - Bitte manuell füllen. |
| Lieferant nicht gefunden | Lieferant konnte im ELO nicht gefunden werden: {0} - Bitte manuell füllen. |
| KI-Kontierung gestartet | KI-Verarbeitung gestartet |
| KI-Kontierung abgeschlossen | KI-Kontierung abgeschlossen |
{0} wird durch den erkannten Namen ersetzt. Die Meldungen sind reine Statusinformationen. Ein eigener Abschlussbeitrag für die Vorverarbeitung wird im aktuellen Paketstand nicht ausgegeben.
Masken und Aspekte
| Typ | Technische Bezeichnung | Zweck |
|---|---|---|
| Rechnungsmaske | SNC_INVOICE.INVOICE |
Erweitert ELO_INVOICE.INVOICE um fehlende Metadaten |
| Geschäftspartnermaske | SNC_INVOICE.BUSINESS_PARTNER |
Erweitert ELO_ERP.BUSINESS_PARTNER um den Zusatz-Prompt |
| Aspekt | SNC_INVOICE.INVOICE_AGENT_MISSINGDATA |
Enthält die Beziehungen zu Unternehmen und Geschäftspartner |
| Aspekt | SNC_INVOICE.INVOICE_AGENT_CONFIG_BUSINESSPARTNER |
Enthält den lieferantenspezifischen Zusatz-Prompt |
| Feld | MISSING_COMPANY_RELATION |
Beziehung zum Unternehmen |
| Feld | MISSING_BP_RELATION |
Beziehung zum Geschäftspartner |
| Feld | PROMPT_VENDOR |
Ergänzender Prompt zur Belegdatenerkennung |
| Feld | PROMPT_ACCOUNTING |
Ergänzender Prompt zur Kontierungszeilenvorbelegung |
KI-Kontierung
Die KI-Kontierung wird über die manuelle Aktion Kontierungszeilen vorbelegen (KI) oder über den Workflow-Trigger SNC_INVOICE_AGENT_ACCOUNTING_LINES_WF_TRIGGER gestartet. Voraussetzung sind vorhandene Rechnungspositionsdaten am Beleg und der aktivierte Parameter SNC_INVOICE.KONTIERUNGSVORBELEGUNG_ACTIVE.
Der Erstellungsflow SNC_INVOICE_AGENT_ACCOUNTING_LINES_CREATE übergibt die Positionsdaten an den ChatClient. Die Antwort enthält je Position Werte für GENERAL_LEDGER_ACCOUNT, COST_CENTER, COST_OBJECT und TAX_CODE. Die Werte werden gegen die jeweils gültigen Referenzlisten verwendet; unsichere oder nicht eindeutige Vorschläge bleiben leer. Beträge, Mengen und Positionstexte werden aus den vorhandenen Daten übernommen. Die Funktion nimmt keine Buchung vor.
Zuordnung von Unternehmen und Geschäftspartnern
Der Invoice Agent extrahiert für Unternehmen und Geschäftspartner unter anderem Name, Umsatzsteuer-ID, Steuer- und Registernummer, Anschrift, Kontakt- und Bankdaten. Diese Informationen stehen anschließend als Vergleichsdaten am Rechnungsbeleg zur Verfügung. Die aktive Zuordnungslogik verwendet davon jedoch nicht für beide Objekttypen dieselben Felder.
Unternehmen
Für die Zuordnung eines Unternehmens verwendet der aktive Metadaten-Flow eine Fuzzy-Suche über den Unternehmensnamen. Der Name hat in dieser Suche eine Gewichtung von 100; als Ähnlichkeitsschwelle ist 90 hinterlegt.
Eine Umsatzsteuer-ID, IBAN, Anschrift oder andere Unternehmensinformation wird in diesem Suchschritt nicht als zusätzliches Matching-Feld konfiguriert. Ist kein Unternehmensname vorhanden oder wird kein ausreichender Treffer gefunden, wird das Unternehmen nicht automatisch zugeordnet.
Geschäftspartner
Für die Zuordnung eines Geschäftspartners verwendet der aktive Metadaten-Flow eine ELO-Suche mit drei alternativen Kriterien:
- Name: Teilübereinstimmung (
CONTAINS) - IBAN: exakte Übereinstimmung (
EQUALS) - Umsatzsteuer-ID: exakte Übereinstimmung (
EQUALS)
Die Kriterien sind mit OR verbunden. Im Paket ist dafür keine Gewichtung und keine feste Reihenfolge hinterlegt. Der Flow verwendet anschließend den ersten Treffer der Suchergebnisliste. Daraus lässt sich keine belastbare Prioritätenliste wie „IBAN vor Umsatzsteuer-ID vor Name“ ableiten.
Optionale Lieferantenanreicherung während der Extraktion
Im aktiven Extraktions-Flow existiert zusätzlich ein optionaler Fuzzy-Suchschritt für Geschäftspartner. Dieser verwendet Name und Umsatzsteuer-ID mit jeweils einer Gewichtung von 50 und einer Ähnlichkeitsschwelle von 50. Wird ein Geschäftspartner gefunden, können dessen hinterlegte Zusatzinformationen in die nachfolgende KI-Abfrage einfließen.
Dieser optionale Schritt ist von der abschließenden Zuordnung am Rechnungsbeleg zu unterscheiden. Für produktive Stammdatenqualität sollten insbesondere Name, Umsatzsteuer-ID, IBAN und Unternehmensbeziehungen eindeutig gepflegt und die automatisch gesetzten Beziehungen fachlich geprüft werden.
Parameter und Gruppe
| Typ | Technische Bezeichnung | Standardwert |
|---|---|---|
| KI-Parameter | SNC_INVOICE.SYSTEMPROMPT_EXTRACTION |
Ausgelieferter JSON-Extraktionsprompt |
| KI-Parameter | SNC_INVOICE.SYSTEMPROMPT_ACCOUNTING_LINES |
Ausgelieferter Prompt für Kontierungszeilen |
| Konfigurationsparameter | SNC_INVOICE.MARKDOWN_CONVERSION_AVAILABLE |
false |
| Konfigurationsparameter | SNC_INVOICE.USE_ELOFULLTEXT |
false |
| Konfigurationsparameter | SNC_INVOICE.KONTIERUNGSVORBELEGUNG_ACTIVE |
Steuert die KI-Kontierung |
| Gruppe | SNC_INVOICE.Clearing |
keine Mitglieder im Paket |
| Gruppe | SNC_INVOICE.KONTIERUNGSZEILEN |
Parameter für Kontierungszeilen |
Externe Zugangsdaten
Die Flow-Definitionen enthalten Referenzen auf externe Credentials, aber keine Credential-Definitionen oder geheimen Werte. Die Einrichtung ist in KI-Anbindung beschrieben.