Centurio System- & Moduldokumentation
🔍
🏛️ Plattform-Architektur
🇩🇪 Deutsch 🇬🇧 English 🇫🇷 Français 🇪🇸 Español 🇮🇹 Italiano 🇳🇱 Nederlands 🇵🇱 Polski 🇵🇹 Português 🇨🇿 Čeština 🇸🇰 Slovenčina 🇭🇺 Magyar 🇷🇴 Română 🇧🇬 Български 🇬🇷 Ελληνικά 🇩🇰 Dansk 🇫🇮 Suomi 🇸🇪 Svenska 🇱🇹 Lietuvių 🇱🇻 Latviešu 🇪🇪 Eesti 🇭🇷 Hrvatski 🇸🇮 Slovenščina 🇲🇹 Malti 🇮🇪 Gaeilge 🇷🇺 Русский 🇺🇦 Українська 🇹🇷 Türkçe 🇳🇴 Norsk bokmål 🇷🇸 Српски 🇮🇸 Íslenska 🇨🇭 Schwiiz/Suisse
🔑 Login
🏠 Alle Module / crm_office / Posteingang & Belegeingang
📥

Posteingang & Belegeingang

inbox crm_office 🛡️ RLS Protected

Zentraler Trichter für alle Belege (Scans, E-Mails, Fotos), OCR-Erkennung und automatische Vorkontierung.

Fachliche Bestimmung: Der zentrale Eingangskanal für Dokumente aller Art. Belege können per Drag & Drop, E-Mail-Weiterleitung oder Mobile-Upload hochgeladen werden. Ein deterministischer OCR- und KI-Parser extrahiert Kopfdaten, Beträge und Positionen und leitet den Beleg zur Prüfung oder Buchung weiter.
⚡ Workflows & Lebenszyklen (19) 🗄️ Datenmodelle & Felder (1) 🔌 Einstiegspunkte (UI & APIs) (11) 🛡️ Regulatorik & Compliance

⚡ Workflows & Lebenszyklen

Typenschildfoto hochgeladen plan:asset_capture

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. asset_capture_agent
asset_capture_agent
{"key": "step_0", "label": "Hersteller, Modell, Seriennummer auslesen", "adapter": "agent.execute", "agent": "asset_capture_agent", "condition_fact": null}
Aktionen: asset_capture_agent
2. filing_agent
filing_agent
{"key": "step_1", "label": "Foto mit Anlage verknuepfen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

Benutzerbefehl: inbox agent plan:command_inbox_agent

Geprüfter Durable-Plan (durable_plan), Start: manual_command.

1. inbox_agent
inbox_agent
{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "inbox_agent", "condition_fact": null}
Aktionen: inbox_agent

Benutzerbefehl: voice agent plan:command_voice_agent

Geprüfter Durable-Plan (durable_plan), Start: manual_command.

1. voice_agent
voice_agent
{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "voice_agent", "condition_fact": null}
Aktionen: voice_agent

Vertrag hochgeladen plan:contract_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. contract_agent
contract_agent
{"key": "step_0", "label": "Vertrag klassifizieren und erfassen", "adapter": "agent.execute", "agent": "contract_agent", "condition_fact": null}
Aktionen: contract_agent
2. filing_agent
filing_agent
{"key": "step_1", "label": "Vertrag mit Kunde und Projekt verknuepfen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

Lieferschein hochgeladen plan:delivery_note_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. delivery_note_agent
delivery_note_agent
{"key": "step_0", "label": "Lieferschein erkennen, Lieferant finden/anlegen, Wareneingang (DRAFT) mit Positionen erstellen", "adapter": "agent.execute", "agent": "delivery_note_agent", "condition_fact": null}
Aktionen: delivery_note_agent
2. material_capture_agent
material_capture_agent
{"key": "step_1", "label": "Geliefertes Material als Produktkandidaten erfassen", "adapter": "agent.execute", "agent": "material_capture_agent", "condition_fact": "has_materials"}
Aktionen: material_capture_agent
3. filing_agent
filing_agent
{"key": "step_2", "label": "Lieferschein in der richtigen Akte ablegen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

Dokument hochgeladen (kein Beleg) plan:document_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. document_agent
document_agent
{"key": "step_0", "label": "Dokumenttyp erkennen", "adapter": "agent.execute", "agent": "document_agent", "condition_fact": null}
Aktionen: document_agent
2. filing_agent
filing_agent
{"key": "step_1", "label": "Dokument in der richtigen Akte ablegen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

E-Mail empfangen plan:email_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. inbox_agent
inbox_agent
{"key": "step_0", "label": "E-Mail klassifizieren (Anfrage, Reklamation, etc.)", "adapter": "agent.execute", "agent": "inbox_agent", "condition_fact": null}
Aktionen: inbox_agent
2. inquiry_agent
inquiry_agent
{"key": "step_1", "label": "Anfrage in Angebot oder Aufgabe umwandeln", "adapter": "agent.execute", "agent": "inquiry_agent", "condition_fact": "is_inquiry"}
Aktionen: inquiry_agent
3. reply_agent
reply_agent
{"key": "step_2", "label": "Antwort-Entwurf erstellen", "adapter": "agent.execute", "agent": "reply_agent", "condition_fact": "needs_reply"}
Aktionen: reply_agent

Ausgabenbeleg hochgeladen plan:expense_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. expense_agent
expense_agent
{"key": "step_0", "label": "Ausgabe erkennen, Betrag und Kategorie extrahieren", "adapter": "agent.execute", "agent": "expense_agent", "condition_fact": null}
Aktionen: expense_agent
2. filing_agent
filing_agent
{"key": "step_1", "label": "Beleg in der richtigen Akte ablegen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

Inbox: Erkennen, prüfen und kaskadieren plan:inbox_intake

Geprüfter Durable-Plan (durable_plan), Start: inbox.

1. step_0
Schritt 1
{"key": "process_inbox", "label": "Eingang verarbeiten und freigeben", "adapter": "inbox.process", "agent": null, "condition_fact": null}

ISM-Nachweis hochgeladen plan:ism_evidence_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. ism_evidence_agent
ism_evidence_agent
{"key": "step_0", "label": "Nachweis klassifizieren und mit Massnahme verknuepfen", "adapter": "agent.execute", "agent": "ism_evidence_agent", "condition_fact": null}
Aktionen: ism_evidence_agent
2. filing_agent
filing_agent
{"key": "step_1", "label": "Nachweisdokument ablegen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

Sicherheitsvorfall gemeldet plan:ism_incident_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. ism_incident_agent
ism_incident_agent
{"key": "step_0", "label": "Vorfall klassifizieren und im ISM-Register anlegen", "adapter": "agent.execute", "agent": "ism_incident_agent", "condition_fact": null}
Aktionen: ism_incident_agent
2. filing_agent
filing_agent
{"key": "step_1", "label": "Vorfalldokument ablegen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

Sicherheitsrichtlinie hochgeladen plan:ism_policy_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. ism_policy_agent
ism_policy_agent
{"key": "step_0", "label": "Richtlinie klassifizieren und als Entwurf anlegen", "adapter": "agent.execute", "agent": "ism_policy_agent", "condition_fact": null}
Aktionen: ism_policy_agent
2. filing_agent
filing_agent
{"key": "step_1", "label": "Richtlinie in der ISM-Akte ablegen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

Wartungsprotokoll hochgeladen plan:maintenance_report_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. maintenance_report_agent
maintenance_report_agent
{"key": "step_0", "label": "Wartungsprotokoll klassifizieren und optional an Anlage haengen", "adapter": "agent.execute", "agent": "maintenance_report_agent", "condition_fact": null}
Aktionen: maintenance_report_agent
2. filing_agent
filing_agent
{"key": "step_1", "label": "Protokoll in der richtigen Akte ablegen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

Anfrage/Kostenvoranschlag empfangen plan:quote_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. inquiry_agent
inquiry_agent
{"key": "step_0", "label": "Anfrage erkennen und Kunde zuordnen", "adapter": "agent.execute", "agent": "inquiry_agent", "condition_fact": null}
Aktionen: inquiry_agent
2. quote_agent
quote_agent
{"key": "step_1", "label": "Angebotsentwurf erstellen", "adapter": "agent.execute", "agent": "quote_agent", "condition_fact": "is_quote_request"}
Aktionen: quote_agent
3. filing_agent
filing_agent
{"key": "step_2", "label": "Anfrage in der richtigen Akte ablegen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

Beleg oder Quittung hochgeladen plan:receipt_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. receipt_agent
receipt_agent
{"key": "step_0", "label": "Beleg erkennen, Lieferant und Betrag extrahieren", "adapter": "agent.execute", "agent": "receipt_agent", "condition_fact": null}
Aktionen: receipt_agent
2. filing_agent
filing_agent
{"key": "step_1", "label": "Dokument in der richtigen Akte ablegen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent
3. material_capture_agent
material_capture_agent
{"key": "step_2", "label": "Material aus Beleg erfassen", "adapter": "agent.execute", "agent": "material_capture_agent", "condition_fact": "has_materials"}
Aktionen: material_capture_agent

Baustellenfoto hochgeladen plan:site_documentation

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. site_documentation_agent
site_documentation_agent
{"key": "step_0", "label": "Foto als Baustellenbericht klassifizieren", "adapter": "agent.execute", "agent": "site_documentation_agent", "condition_fact": null}
Aktionen: site_documentation_agent
2. filing_agent
filing_agent
{"key": "step_1", "label": "Bericht mit Projekt verknuepfen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

Lieferantenrechnung hochgeladen plan:supplier_invoice_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. supplier_invoice_agent
supplier_invoice_agent
{"key": "step_0", "label": "Rechnung erkennen, Lieferant finden/anlegen, Beleg + Buchungsvorschlag + Projektkosten erstellen", "adapter": "agent.execute", "agent": "supplier_invoice_agent", "condition_fact": null}
Aktionen: supplier_invoice_agent
2. filing_agent
filing_agent
{"key": "step_1", "label": "Rechnung in der richtigen Akte ablegen", "adapter": "agent.execute", "agent": "filing_agent", "condition_fact": null}
Aktionen: filing_agent

Sprachnotiz empfangen plan:voice_processing

Geprüfter Durable-Plan (durable_plan), Start: inbox_review.

1. voice_agent
voice_agent
{"key": "step_0", "label": "Sprache erkennen und weiterleiten", "adapter": "agent.execute", "agent": "voice_agent", "condition_fact": null}
Aktionen: voice_agent
2. time_capture_agent
time_capture_agent
{"key": "step_1", "label": "Zeiterfassung erstellen", "adapter": "agent.execute", "agent": "time_capture_agent", "condition_fact": "has_time_entry"}
Aktionen: time_capture_agent

Posteingang status:inbox_item

Beobachtbare Zustandsmaschine (observable_only). Übergänge hier nicht erzwungen — siehe Service-Validierung.

1. new
new
Status «new» der Zustandsmaschine Posteingang.
2. routing
routing
Status «routing» der Zustandsmaschine Posteingang.
3. processing
processing
Status «processing» der Zustandsmaschine Posteingang.
4. needs_review
needs_review
Status «needs_review» der Zustandsmaschine Posteingang.
5. completed
completed
Status «completed» der Zustandsmaschine Posteingang.
6. failed
failed
Status «failed» der Zustandsmaschine Posteingang.

🗄️ Datenmodelle & Felder

InboxItems inbox_items RLS Aktiv
27 Felder / Spalten

Tabelle inbox_items

Feldname Datentyp Pflicht Schlüssel Fachliche Bedeutung
source VARCHAR(48) Ja * - Feld source
raw_text TEXT Nein - Feld raw_text
document_id UUID Nein FK ➔ documents.id Feld document_id
audio_document_id UUID Nein FK ➔ documents.id Feld audio_document_id
sender VARCHAR(320) Nein - Feld sender
recipient VARCHAR(320) Nein - Feld recipient
received_at DATETIME Ja * - Feld received_at
status VARCHAR(48) Ja * - Feld status
detected_intent VARCHAR(64) Nein - Feld detected_intent
routing_confidence NUMERIC(4, 3) Nein - Feld routing_confidence
assigned_agent VARCHAR(64) Nein - Feld assigned_agent
context_project_id UUID Nein FK ➔ projects.id Feld context_project_id
context_customer_id UUID Nein FK ➔ customers.id Feld context_customer_id
context_work_order_id UUID Nein FK ➔ work_orders.id Feld context_work_order_id
error TEXT Nein - Feld error
classified_module VARCHAR(32) Nein - Feld classified_module
classification_label VARCHAR(64) Nein - Feld classification_label
idempotency_key VARCHAR(128) Nein - Feld idempotency_key
id UUID Nein PK Feld id
tenant_id UUID Ja * FK ➔ organizations.id Feld tenant_id
created_at DATETIME Ja * - Feld created_at
updated_at DATETIME Ja * - Feld updated_at
created_by UUID Nein - Feld created_by
updated_by UUID Nein - Feld updated_by
source_type VARCHAR(32) Nein - Feld source_type
source_id UUID Nein - Feld source_id
metadata JSONB Ja * - Feld metadata

🔌 Einstiegspunkte (UI & APIs)

Art Methode Endpunkt / Pfad Titel & Zweck Berechtigung
⚡ REST API GET /api/v1/inbox
list_items
Semantic binding: inventory_only; mutation=False
 inbox
⚡ REST API GET /api/v1/inbox/{item_id}
get_item
Semantic binding: inventory_only; mutation=False
 inbox
⚡ REST API GET /inbox
inbox_page
Semantic binding: inventory_only; mutation=False
 inbox
⚡ REST API POST /api/v1/inbox/approve-all-recognized
approve_all_recognized
Semantic binding: operator_surface; mutation=True
 inbox
⚡ REST API POST /api/v1/inbox/capture
capture
Semantic binding: operator_surface; mutation=True
 inbox
⚡ REST API POST /api/v1/inbox/{item_id}/analyze-portal-upload
analyze_portal_upload
Semantic binding: operator_surface; mutation=True
 inbox
⚡ REST API POST /api/v1/inbox/{item_id}/approve
approve_item
Semantic binding: operator_surface; mutation=True
 inbox
⚡ REST API POST /api/v1/inbox/{item_id}/process
process_item
Semantic binding: operator_surface; mutation=True
 inbox
⚡ REST API POST /api/v1/inbox/{item_id}/retry
retry_failed_item
Semantic binding: operator_surface; mutation=True
 inbox
⚡ REST API POST /api/v1/inbox/{item_id}/supervisor-requeue
supervisor_requeue_orphan
Semantic binding: operator_surface; mutation=True
 inbox
⚡ REST API POST /api/v1/inbox/upload
Beleg hochladen
Nimmt neue Dokumente entgegen und stößt OCR an
 inbox:write

🛡️ Regulatorik & Compliance

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

  • GoBD Elektronische Belegerfassung
  • Ersetzendes Scannen (RESISCAN TR-03138)
Verknüpfte Module:
➔ documents ➔ agents ➔ expenses ➔ matching