Invoice Configuration Reference

Diese Seite dokumentiert die wichtigsten Variablen unter config['invoice']. Die Liste basiert auf den Invoice-Config-Dateien und den direkten Code-Zugriffen in apps/invoice.

Nicht enthalten sind Profile, Profilfelder, Tabellenprofile, Sprachdateien und Value-Assistance-Definitionen. Diese Bereiche sind bewusst ausgeklammert, weil sie eigene Strukturreferenzen benötigen.

Grundlagen

Variable	Bedeutung
invoice.install_invoice	Aktiviert die Installation und Initialisierung der Invoice-App für eine Umgebung.
invoice.is_invoice_light	Schaltet eine reduzierte Invoice-Variante ein. In dieser Variante werden gewisse ERP-, OCR- oder Buchungsfunktionen vereinfacht oder übersprungen.
invoice.multi_client	Aktiviert mandantenfähige Verarbeitung. Rechnungen werden dann stärker über cq_client_accounting und Mandantenrollen getrennt.
invoice.default_client_accounting	Standardmandant, der verwendet wird, wenn kein Mandant aus Benutzer, Import oder Dokument ermittelt werden kann.
invoice.hide_client_accounting	Blendet die Mandantenauswahl in der Oberfläche aus, sofern die Installation mit fixem Mandanten arbeitet.
invoice.is_admin	Ausdruck, der bestimmt, ob der aktuelle Benutzer als Invoice-Administrator gilt. Wird in Templates evaluiert.
invoice.is_accountant	Ausdruck, der bestimmt, ob der aktuelle Benutzer als Buchhaltung/Accounting gilt. Wird für Buchungs- und Freigabefunktionen verwendet.
invoice.buha_roles	Liste der Rollen, die als Buchhaltungsrollen gelten.
invoice.allow_edit_address	Ausdruck, der steuert, ob Adressdaten im Invoice-Kontext bearbeitet werden dürfen.
invoice.show_assignment	Ausdruck oder Boolean, der die Anzeige der Kontierungs-/Buchungsbereiche steuert.
invoice.show_assignee	Steuert, ob Zuständigkeitsfelder angezeigt werden.
invoice.obj_assignee_count	Anzahl der unterstützten Zuständigkeitsfelder im Invoice-UI. Üblich sind Werte von 0 bis 4.
invoice.assignee_type_default	Standardtyp für leere Zuständigkeitsfelder, z. B. user oder group.

Verarbeitung und Jobs

Variable	Bedeutung
invoice.thread_amount	Anzahl paralleler Worker-Threads für Invoice-Verarbeitung.
invoice.time_wait_for_log	Wartezeit für Log-/Verarbeitungsprüfungen in Tests oder asynchronen Abläufen.
invoice.invoice_temp_path	Temporäres Arbeitsverzeichnis für Invoice-Dateien.
invoice.invoice_archiv_folder_id	Zielordner oder Archiv-Folder-ID für archivierte Invoice-Dokumente.
invoice.run_address_ref_mandant_update	Aktiviert einen Hintergrundlauf zur Aktualisierung von Adress-/Mandantenreferenzen.
invoice.transform_attachments	Aktiviert die Vorverarbeitung oder Umwandlung von E-Mail-Anhängen.
invoice.analyse_content_if_invoice	Steuert, ob Inhalt nur dann analysiert wird, wenn das Dokument als Rechnung erkannt wurde.
invoice.get_booking_reference	Aktiviert die Ermittlung einer Buchungsreferenz, z. B. über bestehende Buchungen oder AI-Regeln.
invoice.set_auto_approval	Aktiviert automatische Freigabelogik, falls die ermittelten Bedingungen erfüllt sind.
invoice.workflow_engine_enabled	Aktiviert die externe oder generische Workflow-Engine für Invoice-Freigaben.
invoice.workflow_engine_definition_key	Schlüssel der Workflow-Definition, z. B. invoice_approval.
invoice.workflow_engine_start_states	Lifecycle-Status, bei denen die Workflow-Engine gestartet wird.
invoice.allow_unassigned_workflow_tasks	Erlaubt Workflow-Aufgaben ohne expliziten Bearbeiter.
invoice.is_workflow	Aktiviert klassische Workflow-Funktionalität in der Invoice-App.
invoice.simple_wf	Aktiviert einen vereinfachten Workflow ohne vollständige Freigabelogik.

E-Mail-Import und E-Mail-Anhänge

Variable	Bedeutung
invoice.email_accounts	Liste der Postfächer, aus denen Invoice-E-Mails abgeholt werden.
invoice.email_accountsx	Legacy-/Alternativschlüssel für E-Mail-Konten in älteren Configs.
invoice.att_mail_profile	Profil für abgelegte E-Mail-Anhänge.
invoice.att_email_profile	Alternativer Code-Schlüssel für das E-Mail-Anhangsprofil.
invoice.att_mail_doctype	Dokumenttyp für importierte E-Mail-Anhänge.
invoice.att_mail_client_name	Mandant/Client für abgelegte E-Mail-Anhänge.
invoice.att_mail_top_folder_name	Oberordner für E-Mail-Anhänge.
invoice.att_mail_lifecycle	Lifecycle für abgelegte E-Mail-Anhänge.
invoice.att_mail_lifecycle_state	Initialer Lifecycle-Status für abgelegte E-Mail-Anhänge.
invoice.att_mail_direction	Richtung der E-Mail, typischerweise Eingang.
invoice.sender_name	Anzeigename des Absenders für Invoice-Benachrichtigungen.
invoice.alert_test_mode	Leitet Alert-E-Mails an eine Testadresse um. Wird für Tests und produktionsnahe Validierung verwendet.

OCR, PDF und Barcode

Variable	Bedeutung
invoice.convert_to_searchable_pdf	Erzeugt ein durchsuchbares PDF, meist über OCR.
invoice.convert_to_lower_pdf	Erzeugt eine reduzierte PDF-Variante, z. B. für Vorschau oder Weiterverarbeitung.
invoice.pdf_conversion_factor	Skalierungsfaktor bei PDF-Konvertierung.
invoice.pdf_compression_quality	Kompressionsqualität bei PDF-Erzeugung.
invoice.use_barcode_scan	Aktiviert Barcode-Erkennung.
invoice.use_barcode_split	Aktiviert Dokumenttrennung anhand von Barcodes.
invoice.barcode_split	Legacy-/Testschlüssel für Barcode-Splitting.
invoice.barcode_split_value	Barcode-Wert, der einen Split auslöst, z. B. 0101.
invoice.barcode_split_code_type	Barcode-Typ für Splitting, z. B. QRCODE, CODE128 oder CODE39.
invoice.barcode_scan_code_type	Barcode-Typ für allgemeines Scanning.
invoice.barcode_import_type	Barcode-Typ beim Import.
invoice.barcode_remove_cover_sheet	Entfernt Deckblätter beim Barcode-Splitting.
invoice.barcode_prefix	Präfix für erzeugte oder erkannte Barcodes.
invoice.import_barcode_folder	Importordner für Barcode-Dateien.
invoice.import_qrcode_splitted_folder	Importordner für per QR-Code getrennte Dateien.

Nummern, Beleg-IDs und Stempel

Variable	Bedeutung
invoice.invoice_counter_format	Format für erzeugte Rechnungs-/Belegnummern, z. B. %08d.
invoice.creditor_counter_start_value	Startwert für Kreditorenzähler.
invoice.creditor_counter_prefix	Präfix für Kreditorenbelege.
invoice.debitor_counter_prefix	Präfix für Debitorenbelege.
invoice.receipt_counter_prefix	Präfix für Quittungen/Belege.
invoice.creditcard_counter_prefix	Präfix für Kreditkartenbelege.
invoice.order_counter_prefix	Präfix für Bestellungen oder Order-Belege.
invoice.custom_open_post_id	Feld, das als Offene-Posten-ID oder externe Beleg-ID verwendet wird.
invoice.custom_open_post_booking_text_id	Feld, das als Buchungstext-ID für offene Posten verwendet wird.
invoice.custom_booking_id	Feld, das als Buchungs-ID für Kreditorenbelege verwendet wird.
invoice.custom_debitor_booking_id	Feld, das als Buchungs-ID für Debitorenbelege verwendet wird.
invoice.print_counter_to_invoice	Druckt die interne Belegnummer auf die Rechnung.
invoice.force_stamp_to_invoice	Erzwingt einen Stempel auf dem Rechnungsdokument.
invoice.force_stamp_on_state_prefixes	Statuspräfixe, bei denen ein erneuter Stempel erzwungen wird.
invoice.counter_value_font	Schriftart für den aufgedruckten Zähler.
invoice.counter_value_font_size	Schriftgröße für den aufgedruckten Zähler.
invoice.counter_value_color_rgb	RGB-Farbe für den aufgedruckten Zähler.
invoice.counter_value_left_margin	Linker Abstand des Zählerstempels.
invoice.counter_value_bottom_margin	Unterer Abstand des Zählerstempels.

Ablagepfade und Ordner

Variable	Bedeutung
invoice.invoice_folder1	Erste Ordnerebene für Invoice-Ablage.
invoice.invoice_folder2	Zweite Ordnerebene für Invoice-Ablage.
invoice.invoice_debitor_folder3	Dritte Ordnerebene für Debitorenbelege.
invoice.invoice_creditor_folder3	Dritte Ordnerebene für Kreditorenbelege.
invoice.invoice_accounting_folder3	Dritte Ordnerebene für reine FiBu-/Accounting-Belege.
invoice.invoice_creditcard_folder3	Dritte Ordnerebene für Kreditkartenbelege.
invoice.invoice_order_folder3	Dritte Ordnerebene für Bestellungen.

Buchung, Referenzdaten und Fremdwährung

Variable	Bedeutung
invoice.use_reference_datas	Aktiviert die Verwendung eines Referenzmandanten für Stammdaten oder Buchungsreferenzen.
invoice.reference_client_accounting	Mandant, aus dem Referenzdaten gelesen werden.
invoice.use_online_address_interface	Aktiviert eine Online-Schnittstelle zur Adresssuche oder Adressübernahme.
invoice.daily_rates_update_url	URL für den Import von Tageskursen. Standardmäßig wird der BAZG-Dienst verwendet.
invoice.show_tax_in_assignment	Zeigt Steuer-/MwSt.-Felder in Kontierungszeilen.
invoice.show_plantno_in_assignment	Zeigt Anlagen-/Werk-Felder in Kontierungszeilen.
invoice.show_kst_in_assignment	Zeigt Kostenstelle 1 in Kontierungszeilen.
invoice.show_kst2_in_assignment	Zeigt Kostenstelle 2 in Kontierungszeilen.
invoice.show_dropdown_in_accounting_area	Zeigt den Geschäftsbereich als Dropdown statt als freies Feld.
invoice.check_similar_booking_references	Sucht ähnliche frühere Buchungsreferenzen.
invoice.amount_similar_booking_references	Anzahl ähnlicher Buchungsreferenzen, die berücksichtigt oder angezeigt werden.
invoice.allow_generic_ai_booking_rules	Erlaubt AI-Regeln ohne konkrete Referenzbindung.
invoice.ai.model	Modellname für AI-gestützte Analyse oder Buchungsregel-Ermittlung.

Dashboard und Listen

Variable	Bedeutung
invoice.dashboard_server_side	Aktiviert serverseitiges Laden für Invoice-Dashboards.
invoice.creditor_dashboard_server_side	Aktiviert serverseitiges Laden für Kreditoren-Dashboards.
invoice.dashboard_chunk_initial	Initiale Anzahl geladener Dashboard-Zeilen.
invoice.dashboard_chunk_step	Schrittgröße beim Nachladen weiterer Dashboard-Zeilen.
invoice.dashboard_search_chunk_initial	Initiale Anzahl Treffer bei Dashboard-Suche.
invoice.dashboard_search_chunk_step	Schrittgröße beim Nachladen weiterer Suchtreffer.
invoice.creditor_dashboard_chunk_initial	Legacy-/spezifischer Initialwert für Kreditoren-Dashboard-Laden.
invoice.creditor_dashboard_chunk_step	Legacy-/spezifische Schrittgröße für Kreditoren-Dashboard-Laden.
invoice.dashboard_tiles_show_amounts	Zeigt Beträge auf Dashboard-Kacheln.
invoice.dashboard_tiles_hide_amounts_clients	Mandantenliste, für die Beträge auf Kacheln ausgeblendet werden.
invoice.invoices_result_sort_order	Sortierung für Rechnungsergebnislisten. DQL-seitig ohne DESC verwenden.
invoice.order_result_sort_order	Sortierung für Order-/Inbox-Listen.
invoice.show_paid_invoices_in_invoices_result	Zeigt bezahlte Rechnungen in Ergebnislisten.
invoice.show_exported_invoices_in_invoices_result	Zeigt exportierte Rechnungen in Ergebnislisten.

Startseite und Dashboard-Layout

Variable	Bedeutung
invoice.show_tags_on_entry_page	Zeigt Tags auf der Invoice-Einstiegsseite.
invoice.show_drag_and_drop_on_entry_page	Zeigt Drag-and-drop Upload auf der Einstiegsseite.
invoice.dashboard_layout.show_news	Zeigt News-Karten im Dashboard.
invoice.dashboard_layout.show_links	Zeigt Link-Karten im Dashboard.
invoice.dashboard_layout.show_dragndrop	Zeigt Drag-and-drop-Karten im Dashboard.
invoice.dashboard_layout.show_sum_documents	Zeigt Dokument-Summen im Dashboard.
invoice.dashboard_layout.show_tasks	Zeigt Aufgaben im Dashboard.
invoice.dashboard_layout.show_photos_on_entry_page	Zeigt Fotos/Bilder auf der Einstiegsseite.
invoice.dashboard_layout.show_tags_on_entry_page	Dashboard-spezifischer Schalter für Tag-Anzeige.
invoice.dashboard_layout.default_cards	Liste der standardmäßig verfügbaren Dashboard-Karten.
invoice.dashboard_layout.layout	Spalten-/Kartenlayout des Dashboards.
invoice.dashboard_layout.cardStates.*	Initialzustände einzelner Karten, z. B. expanded oder collapsed.
invoice.tags.tag_boxes	Definition von Tag-Boxen auf der Einstiegsseite inklusive Filterausdruck.

Tabs und Detaildialoge

Variable	Bedeutung
invoice.show_invoice_inbox	Zeigt die Invoice-Inbox.
invoice.show_tasks_in_invoice	Zeigt Aufgaben direkt im Invoice-Kontext.
invoice.show_creditors_to_pay_tab	Zeigt den Tab für zu zahlende Kreditoren.
invoice.show_open_creditor_tab	Zeigt den Tab für offene Kreditoren.
invoice.show_creditor_tab	Zeigt den Kreditoren-Tab auf der Start-/Übersichtsseite.
invoice.show_purchase_order_tab	Zeigt den Purchase-Order-Tab.
invoice.show_order_tab	Zeigt den Order-Tab.
invoice.show_creditcard_tab	Zeigt den Kreditkarten-Tab.
invoice.show_receipt_tab	Zeigt den Quittungs-/Receipt-Tab.
invoice.show_debitor_tab	Zeigt den Debitoren-Tab.
invoice.show_open_debitor_tab	Zeigt den Tab für offene Debitoren.
invoice.show_accounting_tab	Zeigt den Buchhaltungs-/Accounting-Tab.
invoice.show_email_tab	Zeigt den E-Mail-Tab.
invoice.show_tasks_tab	Zeigt den Aufgaben-Tab.
invoice.show_clipboard_tab	Zeigt den Clipboard-Tab.
invoice.show_splitted_files_tab	Zeigt getrennte Dateien/Split-Files.
invoice.show_billable_tab	Zeigt den Billable-Tab.
invoice.show_postbox_tab	Zeigt den Postbox-Tab.
invoice.show_workflow_tab	Zeigt den Workflow-Tab.
invoice.show_accounting_assignment_tab	Zeigt den Kontierungs-Tab im Detaildialog.
invoice.show_relations_tab	Zeigt Beziehungen/Anhänge im Detaildialog.
invoice.show_versions_tab	Zeigt Versionen im Detaildialog.
invoice.show_system_tab	Zeigt Systeminformationen im Detaildialog.
invoice.show_paid_tab	Zeigt Zahlungsinformationen im Detaildialog.
invoice.show_alerts_tab	Zeigt Alert-Integration im Detaildialog, wenn Prozessintegration aktiv ist.
invoice.show_article_tab	Zeigt Artikelpositionen.
invoice.show_billable	Aktiviert Billable-Funktionalität in Masken oder Auswertungen.
invoice.show_project	Zeigt Projektfelder.
invoice.show_article	Zeigt Artikel-/Positionsfunktionen.
invoice.show_rising_fields	Zeigt Teuerungs-/Rising-Felder in der Maske.
invoice.show_discount_fields	Zeigt Rabattfelder in der Maske.
invoice.show_rising	Aktiviert Anzeige von Teuerungsinformationen.
invoice.show_discount	Aktiviert Anzeige von Rabattinformationen.
invoice.enable_rising	Aktiviert Teuerungslogik technisch.
invoice.show_ocr	Zeigt OCR-Text oder OCR-Tab.
invoice.show_preview	Zeigt Dokumentvorschau.
invoice.show_admin	Zeigt Admin-Informationen in der Maske.
invoice.show_alerts	Zeigt Alert-Informationen.
invoice.is_complex_mask	Aktiviert komplexe Buchungsmaske mit erweiterten Feldern.
invoice.ui_group_colors.*	Optionale farbliche Hervorhebung von Gruppen in der UI.

Dashboard-Kacheln

Die Schlüssel unter invoice.dashboard.tabs.creditor.* und invoice.dashboard.tiles.creditor.* steuern einzelne Tabs und Kacheln im Kreditoren-Dashboard.

Variable	Bedeutung
invoice.dashboard.tabs.creditor.dashboard	Zeigt den Dashboard-Tab.
invoice.dashboard.tabs.creditor.tasks	Zeigt den Aufgaben-Tab.
invoice.dashboard.tabs.creditor.recent	Zeigt zuletzt bearbeitete Rechnungen.
invoice.dashboard.tabs.creditor.marked	Zeigt markierte Rechnungen.
invoice.dashboard.tiles.creditor.work	Kachel für allgemeine Arbeitseingänge.
invoice.dashboard.tiles.creditor.accounting_work	Kachel für Buchhaltungsarbeit.
invoice.dashboard.tiles.creditor.my_approvals	Kachel für eigene Freigaben.
invoice.dashboard.tiles.creditor.no_assignment	Kachel für Rechnungen ohne Kontierung.
invoice.dashboard.tiles.creditor.errors	Kachel für Fehlerfälle.
invoice.dashboard.tiles.creditor.no_client	Kachel für Rechnungen ohne Mandant.
invoice.dashboard.tiles.creditor.approved	Kachel für freigegebene Rechnungen.
invoice.dashboard.tiles.creditor.exported_paid	Kachel für exportierte oder bezahlte Rechnungen.
invoice.dashboard.tiles.creditor.in_review	Kachel für Rechnungen in Prüfung.
invoice.dashboard.tiles.creditor.in_approval	Kachel für Rechnungen in Freigabe.
invoice.dashboard.tiles.creditor.controlling	Kachel für Controlling-Schritte.
invoice.dashboard.tiles.creditor.buha_in_progress	Kachel für Rechnungen in Bearbeitung durch Buchhaltung.
invoice.dashboard.tiles.creditor.overdue	Kachel für überfällige Rechnungen.
invoice.dashboard.tiles.creditor.my_review_dashboard	Kachel für das persönliche Review-Dashboard.

Reports, Statusmeldungen und Alerts

Variable	Bedeutung
invoice.report_dashboard_widgets.report_my_review_dashboard.*	Aktiviert einzelne Widgets im persönlichen Review-Dashboard, z. B. KPI, Approval-Rate, Trend, Bereich, Lieferanten, Summary und Datentabelle.
invoice.report_dashboard_widgets.report_my_review_dashboard.color_limit.green	Grenzwert für grüne Bewertung im Review-Dashboard.
invoice.report_dashboard_widgets.report_my_review_dashboard.color_limit.orange	Grenzwert für orange Bewertung im Review-Dashboard.
invoice.report_dashboard_widgets.report_my_review_dashboard.color_limit.red	Grenzwert für rote Bewertung im Review-Dashboard.
invoice.status_message_broadcast_enabled	Aktiviert Broadcast von Statusmeldungen.
invoice.status_message_broadcast_include_admin	Bezieht Administratoren in Statusmeldungen ein.
invoice.status_message_broadcast_cache_ttl_sec	Cache-Lebensdauer für Statusmeldungen.
invoice.status_message_broadcast_roles	Rollen, die Statusmeldungen erhalten dürfen.

Purchase Order

Variable	Bedeutung
invoice.purchase_order.offer_text_engine	Textanalyse-Engine für Angebote oder Bestellunterlagen.
invoice.purchase_order.offer_text_timeout_sec	Timeout für Textanalyse.
invoice.purchase_order.offer_text_ocr_timeout_sec	Timeout für OCR-Textanalyse.
invoice.purchase_order.offer_text_ocr_dpi	OCR-Auflösung für Angebotsanalyse.
invoice.purchase_order.offer_text_address_pages	Anzahl Seiten, die für Adressanalyse berücksichtigt werden.
invoice.purchase_order.offer_text_min_len	Mindestlänge für verwertbaren Angebotstext.
invoice.purchase_order.offer_visual_llm_fallback	Erlaubt einen visuellen LLM-Fallback, wenn Textanalyse nicht genügt.
invoice.purchase_order_mail.template_folder_id	Ordner-ID für Purchase-Order-Mailvorlagen.
invoice.purchase_order_mail.template_folder_parent_id	Parent-Ordner der Mailvorlagen.
invoice.purchase_order_mail.template_folder_name	Anzeigename des Vorlagenordners.
invoice.purchase_order_mail.subject	Standardsubjekt für Purchase-Order-Mails.
invoice.purchase_order_mail.body	Standardinhalt für Purchase-Order-Mails.

MQTT und externe Agenten

Variable	Bedeutung
invoice.mqtt	Invoice-spezifische MQTT-Konfiguration.
invoice.mqtt.request_topic	Topic für Requests an den MQTT-Agenten.
invoice.mqtt.status_topic	Topic für Statusantworten des MQTT-Agenten.

Admin-Menü

Variable	Bedeutung
invoice.invoice_admin_menu	Konfiguriert die Kacheln, Gruppen, Links, Jobs und Berechtigungen der Invoice-Adminseite.

Typische Felder pro Menüeintrag:

Feld	Bedeutung
section	Gruppenname im Admin-Menü.
label	Sichtbarer Titel des Links oder Jobs.
description	Kurzbeschreibung für die Adminseite.
icon	Icon-Name aus dem verwendeten Iconset.
url	Ziel-URL oder Job-Ausführungs-URL.
push	Steuert, ob die Navigation per Push/SPA-Verhalten erfolgt.
confirm	Steuert, ob vor Job-Ausführung ein Dialog angezeigt wird.
acl	Rollenliste, die den Eintrag sehen oder ausführen darf.
order	Sortierung innerhalb der Gruppe.

Testkonfiguration

Variable	Bedeutung
invoice.test	Container für Invoice-Testeinstellungen.
invoice.test.clean_environment	Bereinigt Testumgebung vor Testlauf.
invoice.test.use_unittests	Aktiviert Unit-Test-Ausführung in Invoice-Testjobs.
invoice.export_path	Exportpfad, der in Tests oder Exportprüfungen verwendet wird.

Kundenspezifische Bereiche

Variable	Bedeutung
invoice.gemeinde	Kundenspezifischer Bereich für Gemeindelogik. Unterstrukturen wie social oder soziales steuern kommunale Spezialfälle.

Hinweise für Administratoren

• Boolean-Schalter sollten konsistent als echte YAML-Booleans (true/false) gepflegt werden.
• Ausdrücke wie invoice.is_admin, invoice.is_accountant, invoice.allow_edit_address und invoice.show_assignment werden teilweise evaluiert. Änderungen daran sollten besonders vorsichtig getestet werden.
• DQL-Sortierungen in invoice.invoices_result_sort_order und invoice.order_result_sort_order dürfen gemäß Projektkonvention kein DESC verwenden.
• Profile und Tabellenprofile sind nicht Teil dieser Seite. Sie werden separat dokumentiert.