Invoice Configuration Reference

This page documents the most important variables below config['invoice']. The list is based on Invoice configuration files and direct code access in apps/invoice.

Profiles, profile fields, table profiles, language files, and value-assistance definitions are intentionally excluded because they have their own structure references.

Basics

Variable	Meaning
invoice.install_invoice	Enables installation and initialization of the Invoice application.
invoice.is_invoice_light	Enables a reduced Invoice variant with simplified ERP, OCR, or accounting behavior.
invoice.multi_client	Enables client-aware processing, mainly through cq_client_accounting and client roles.
invoice.default_client_accounting	Default accounting client when no client can be derived from user, import, or document.
invoice.hide_client_accounting	Hides client selection in installations with a fixed client.
invoice.is_admin	Expression that determines whether the current user is an Invoice administrator.
invoice.is_accountant	Expression that determines whether the current user is treated as accounting.
invoice.buha_roles	Roles considered accounting roles.
invoice.allow_edit_address	Expression that controls whether address data may be edited in the Invoice context.
invoice.show_assignment	Expression or Boolean that controls display of accounting-assignment areas.
invoice.show_assignee	Controls whether responsibility fields are shown.
invoice.obj_assignee_count	Number of supported responsibility fields in the Invoice UI. Common values are 0 to 4.
invoice.assignee_type_default	Default type for empty assignee fields, for example user or group.

Processing and Jobs

Variable	Meaning
invoice.thread_amount	Number of parallel worker threads for Invoice processing.
invoice.time_wait_for_log	Wait time for log or processing checks in tests and asynchronous flows.
invoice.invoice_temp_path	Temporary working directory for Invoice files.
invoice.invoice_archiv_folder_id	Target folder or archive folder ID for archived Invoice documents.
invoice.run_address_ref_mandant_update	Enables a background run that updates address and client references.
invoice.transform_attachments	Enables preprocessing or conversion of e-mail attachments.
invoice.analyse_content_if_invoice	Controls whether content is analyzed only after a document was detected as an invoice.
invoice.get_booking_reference	Enables booking-reference detection, for example from previous postings or AI rules.
invoice.set_auto_approval	Enables automatic approval logic if configured conditions match.
invoice.workflow_engine_enabled	Enables the external or generic workflow engine for Invoice approvals.
invoice.workflow_engine_definition_key	Workflow definition key, for example invoice_approval.
invoice.workflow_engine_start_states	Lifecycle states that start the workflow engine.
invoice.allow_unassigned_workflow_tasks	Allows workflow tasks without an explicit assignee.
invoice.is_workflow	Enables classic workflow behavior in Invoice.
invoice.simple_wf	Enables a simplified workflow without the full approval logic.

E-Mail Import and Attachments

Variable	Meaning
invoice.email_accounts	Mailboxes from which Invoice e-mails are retrieved.
invoice.email_accountsx	Legacy or alternative key for mail accounts in older configurations.
invoice.att_mail_profile	Profile used for stored e-mail attachments.
invoice.att_email_profile	Alternative code key for the e-mail attachment profile.
invoice.att_mail_doctype	Document type for imported e-mail attachments.
invoice.att_mail_client_name	Client used for stored e-mail attachments.
invoice.att_mail_top_folder_name	Top-level folder for e-mail attachments.
invoice.att_mail_lifecycle	Lifecycle for stored e-mail attachments.
invoice.att_mail_lifecycle_state	Initial lifecycle state for stored e-mail attachments.
invoice.att_mail_direction	E-mail direction, typically incoming.
invoice.sender_name	Display name for outgoing Invoice notifications.
invoice.alert_test_mode	Redirects alert e-mails to a test address for validation.

OCR, PDF, and Barcode

Variable	Meaning
invoice.convert_to_searchable_pdf	Creates a searchable PDF, usually by OCR.
invoice.convert_to_lower_pdf	Creates a reduced PDF variant for preview or further processing.
invoice.pdf_conversion_factor	Scaling factor for PDF conversion.
invoice.pdf_compression_quality	Compression quality for generated PDFs.
invoice.use_barcode_scan	Enables barcode detection.
invoice.use_barcode_split	Enables document splitting by barcode.
invoice.barcode_split	Legacy or test key for barcode splitting.
invoice.barcode_split_value	Barcode value that triggers a split, for example 0101.
invoice.barcode_split_code_type	Barcode type used for splitting, such as QRCODE, CODE128, or CODE39.
invoice.barcode_scan_code_type	Barcode type used for general scanning.
invoice.barcode_import_type	Barcode type used during import.
invoice.barcode_remove_cover_sheet	Removes cover sheets during barcode splitting.
invoice.barcode_prefix	Prefix for generated or detected barcodes.
invoice.import_barcode_folder	Import folder for barcode files.
invoice.import_qrcode_splitted_folder	Import folder for files split by QR code.

Numbers, Document IDs, and Stamps

Variable	Meaning
invoice.invoice_counter_format	Format for generated invoice or receipt numbers, for example %08d.
invoice.creditor_counter_start_value	Start value for creditor counters.
invoice.creditor_counter_prefix	Prefix for creditor documents.
invoice.debitor_counter_prefix	Prefix for debtor documents.
invoice.receipt_counter_prefix	Prefix for receipts.
invoice.creditcard_counter_prefix	Prefix for credit-card receipts.
invoice.order_counter_prefix	Prefix for orders or order-related documents.
invoice.custom_open_post_id	Field used as open-item ID or external document ID.
invoice.custom_open_post_booking_text_id	Field used as booking-text ID for open items.
invoice.custom_booking_id	Field used as booking ID for creditor documents.
invoice.custom_debitor_booking_id	Field used as booking ID for debtor documents.
invoice.print_counter_to_invoice	Prints the internal document number on the invoice.
invoice.force_stamp_to_invoice	Forces a stamp on the invoice document.
invoice.force_stamp_on_state_prefixes	Status prefixes for which stamping is forced again.
invoice.counter_value_font	Font for the printed counter value.
invoice.counter_value_font_size	Font size for the printed counter value.
invoice.counter_value_color_rgb	RGB color for the printed counter value.
invoice.counter_value_left_margin	Left margin for the counter stamp.
invoice.counter_value_bottom_margin	Bottom margin for the counter stamp.

Archive Paths and Folders

Variable	Meaning
invoice.invoice_folder1	First folder level for Invoice storage.
invoice.invoice_folder2	Second folder level for Invoice storage.
invoice.invoice_debitor_folder3	Third folder level for debtor documents.
invoice.invoice_creditor_folder3	Third folder level for creditor documents.
invoice.invoice_accounting_folder3	Third folder level for pure accounting documents.
invoice.invoice_creditcard_folder3	Third folder level for credit-card receipts.
invoice.invoice_order_folder3	Third folder level for orders.

Accounting, Reference Data, and Foreign Currency

Variable	Meaning
invoice.use_reference_datas	Enables use of a reference client for master data or booking references.
invoice.reference_client_accounting	Client from which reference data is read.
invoice.use_online_address_interface	Enables an online interface for address search or address transfer.
invoice.daily_rates_update_url	URL for daily-rate import. The default usually points to the Swiss customs service.
invoice.show_tax_in_assignment	Shows tax or VAT fields in accounting lines.
invoice.show_plantno_in_assignment	Shows asset or plant fields in accounting lines.
invoice.show_kst_in_assignment	Shows cost center 1 in accounting lines.
invoice.show_kst2_in_assignment	Shows cost center 2 in accounting lines.
invoice.show_dropdown_in_accounting_area	Shows accounting area as dropdown instead of free text.
invoice.check_similar_booking_references	Searches similar previous booking references.
invoice.amount_similar_booking_references	Number of similar booking references considered or displayed.
invoice.allow_generic_ai_booking_rules	Allows AI rules without a specific reference binding.
invoice.ai.model	Model name used for AI-supported analysis or booking-rule detection.

Dashboard and Lists

Variable	Meaning
invoice.dashboard_server_side	Enables server-side loading for Invoice dashboards.
invoice.creditor_dashboard_server_side	Enables server-side loading for creditor dashboards.
invoice.dashboard_chunk_initial	Initial number of dashboard rows loaded.
invoice.dashboard_chunk_step	Number of additional rows loaded per step.
invoice.dashboard_search_chunk_initial	Initial number of search results loaded.
invoice.dashboard_search_chunk_step	Number of additional search results loaded per step.
invoice.creditor_dashboard_chunk_initial	Legacy or creditor-specific initial loading value.
invoice.creditor_dashboard_chunk_step	Legacy or creditor-specific loading step value.
invoice.dashboard_tiles_show_amounts	Shows amounts on dashboard tiles.
invoice.dashboard_tiles_hide_amounts_clients	Clients for which amounts are hidden on dashboard tiles.
invoice.invoices_result_sort_order	Sorting for invoice result lists. Follow the project rule and do not use DESC in DQL.
invoice.order_result_sort_order	Sorting for order and inbox lists.
invoice.show_paid_invoices_in_invoices_result	Shows paid invoices in result lists.
invoice.show_exported_invoices_in_invoices_result	Shows exported invoices in result lists.

Entry Page and Dashboard Layout

Variable	Meaning
invoice.show_tags_on_entry_page	Shows tags on the Invoice entry page.
invoice.show_drag_and_drop_on_entry_page	Shows drag-and-drop upload on the entry page.
invoice.dashboard_layout.show_news	Shows news cards in the dashboard.
invoice.dashboard_layout.show_links	Shows link cards in the dashboard.
invoice.dashboard_layout.show_dragndrop	Shows drag-and-drop cards in the dashboard.
invoice.dashboard_layout.show_sum_documents	Shows document totals in the dashboard.
invoice.dashboard_layout.show_tasks	Shows tasks in the dashboard.
invoice.dashboard_layout.show_photos_on_entry_page	Shows photos or images on the entry page.
invoice.dashboard_layout.show_tags_on_entry_page	Dashboard-specific switch for tag display.
invoice.dashboard_layout.default_cards	List of default dashboard cards.
invoice.dashboard_layout.layout	Column and card layout of the dashboard.
invoice.dashboard_layout.cardStates.*	Initial state of individual cards, such as expanded or collapsed.
invoice.tags.tag_boxes	Definition of tag boxes on the entry page including filter expressions.

Tabs and Detail Dialogs

Variable	Meaning
invoice.show_invoice_inbox	Shows the Invoice inbox.
invoice.show_tasks_in_invoice	Shows tasks directly in the Invoice context.
invoice.show_creditors_to_pay_tab	Shows the creditors-to-pay tab.
invoice.show_open_creditor_tab	Shows the open-creditors tab.
invoice.show_creditor_tab	Shows the creditor tab on the entry or overview page.
invoice.show_purchase_order_tab	Shows the purchase-order tab.
invoice.show_order_tab	Shows the order tab.
invoice.show_creditcard_tab	Shows the credit-card tab.
invoice.show_receipt_tab	Shows the receipt tab.
invoice.show_debitor_tab	Shows the debtor tab.
invoice.show_open_debitor_tab	Shows the open-debtors tab.
invoice.show_accounting_tab	Shows the accounting tab.
invoice.show_email_tab	Shows the e-mail tab.
invoice.show_tasks_tab	Shows the tasks tab.
invoice.show_clipboard_tab	Shows the clipboard tab.
invoice.show_splitted_files_tab	Shows split files.
invoice.show_billable_tab	Shows the billable tab.
invoice.show_postbox_tab	Shows the postbox tab.
invoice.show_workflow_tab	Shows the workflow tab.
invoice.show_accounting_assignment_tab	Shows the accounting-assignment tab in the detail dialog.
invoice.show_relations_tab	Shows relations and attachments in the detail dialog.
invoice.show_versions_tab	Shows versions in the detail dialog.
invoice.show_system_tab	Shows system information in the detail dialog.
invoice.show_paid_tab	Shows payment information in the detail dialog.
invoice.show_alerts_tab	Shows alert integration in the detail dialog when process integration is active.
invoice.show_article_tab	Shows item lines.
invoice.show_billable	Enables billable behavior in forms or reports.
invoice.show_project	Shows project fields.
invoice.show_article	Shows article or line-item functions.
invoice.show_rising_fields	Shows escalation or price-increase fields.
invoice.show_discount_fields	Shows discount fields.
invoice.show_rising	Enables display of escalation information.
invoice.show_discount	Enables display of discount information.
invoice.enable_rising	Technically enables escalation logic.
invoice.show_ocr	Shows OCR text or OCR tab.
invoice.show_preview	Shows document preview.
invoice.show_admin	Shows administration information in the form.
invoice.show_alerts	Shows alert information.
invoice.is_complex_mask	Enables a complex accounting form with extended fields.
invoice.ui_group_colors.*	Optional color highlighting for UI groups.

Dashboard Tiles

Keys below invoice.dashboard.tabs.creditor.* and invoice.dashboard.tiles.creditor.* control individual tabs and tiles in the creditor dashboard.

Variable	Meaning
invoice.dashboard.tabs.creditor.dashboard	Shows the dashboard tab.
invoice.dashboard.tabs.creditor.tasks	Shows the tasks tab.
invoice.dashboard.tabs.creditor.recent	Shows recently edited invoices.
invoice.dashboard.tabs.creditor.marked	Shows marked invoices.
invoice.dashboard.tiles.creditor.work	Tile for general work queues.
invoice.dashboard.tiles.creditor.accounting_work	Tile for accounting work.
invoice.dashboard.tiles.creditor.my_approvals	Tile for the current user's approvals.
invoice.dashboard.tiles.creditor.no_assignment	Tile for invoices without accounting assignment.
invoice.dashboard.tiles.creditor.errors	Tile for error cases.
invoice.dashboard.tiles.creditor.no_client	Tile for invoices without client.
invoice.dashboard.tiles.creditor.approved	Tile for approved invoices.
invoice.dashboard.tiles.creditor.exported_paid	Tile for exported or paid invoices.
invoice.dashboard.tiles.creditor.in_review	Tile for invoices in review.
invoice.dashboard.tiles.creditor.in_approval	Tile for invoices in approval.
invoice.dashboard.tiles.creditor.controlling	Tile for controlling steps.
invoice.dashboard.tiles.creditor.buha_in_progress	Tile for invoices being processed by accounting.
invoice.dashboard.tiles.creditor.overdue	Tile for overdue invoices.
invoice.dashboard.tiles.creditor.my_review_dashboard	Tile for the personal review dashboard.

Reports, Status Messages, and Alerts

Variable	Meaning
invoice.report_dashboard_widgets.report_my_review_dashboard.*	Enables widgets in the personal review dashboard, such as KPIs, approval rate, trend, area, suppliers, summary, and data table.
invoice.report_dashboard_widgets.report_my_review_dashboard.color_limit.green	Threshold for green rating in the review dashboard.
invoice.report_dashboard_widgets.report_my_review_dashboard.color_limit.orange	Threshold for orange rating in the review dashboard.
invoice.report_dashboard_widgets.report_my_review_dashboard.color_limit.red	Threshold for red rating in the review dashboard.
invoice.status_message_broadcast_enabled	Enables broadcast of status messages.
invoice.status_message_broadcast_include_admin	Includes administrators in status messages.
invoice.status_message_broadcast_cache_ttl_sec	Cache lifetime for status messages.
invoice.status_message_broadcast_roles	Roles allowed to receive status messages.

Purchase Order

Variable	Meaning
invoice.purchase_order.offer_text_engine	Text-analysis engine for quotations or order documents.
invoice.purchase_order.offer_text_timeout_sec	Timeout for text analysis.
invoice.purchase_order.offer_text_ocr_timeout_sec	Timeout for OCR text analysis.
invoice.purchase_order.offer_text_ocr_dpi	OCR resolution for quotation analysis.
invoice.purchase_order.offer_text_address_pages	Number of pages considered for address analysis.
invoice.purchase_order.offer_text_min_len	Minimum length for usable quotation text.
invoice.purchase_order.offer_visual_llm_fallback	Allows visual LLM fallback when text analysis is insufficient.
invoice.purchase_order_mail.template_folder_id	Folder ID for purchase-order mail templates.
invoice.purchase_order_mail.template_folder_parent_id	Parent folder of the mail templates.
invoice.purchase_order_mail.template_folder_name	Display name of the template folder.
invoice.purchase_order_mail.subject	Default subject for purchase-order mails.
invoice.purchase_order_mail.body	Default body for purchase-order mails.

MQTT and External Agents

Variable	Meaning
invoice.mqtt	Invoice-specific MQTT configuration.
invoice.mqtt.request_topic	Topic for requests to the MQTT agent.
invoice.mqtt.status_topic	Topic for status replies from the MQTT agent.

Admin Menu

Variable	Meaning
invoice.invoice_admin_menu	Configures tiles, groups, links, jobs, and permissions of the Invoice admin page.

Typical fields per menu entry:

Field	Meaning
section	Group name in the admin menu.
label	Visible title of the link or job.
description	Short description shown on the admin page.
icon	Icon name from the configured icon set.
url	Target URL or job execution URL.
push	Controls whether navigation uses push or SPA behavior.
confirm	Controls whether a dialog is shown before job execution.
acl	Roles allowed to see or execute the entry.
order	Sort order within the group.

Test Configuration

Variable	Meaning
invoice.test	Container for Invoice test settings.
invoice.test.clean_environment	Cleans the test environment before a test run.
invoice.test.use_unittests	Enables unit-test execution in Invoice test jobs.
invoice.export_path	Export path used by tests or export checks.

Customer-Specific Areas

Variable	Meaning
invoice.gemeinde	Customer-specific area for municipality logic. Substructures such as social or soziales control special municipal cases.

Administrator Notes

• Maintain Boolean switches consistently as real YAML booleans (true/false).
• Expressions such as invoice.is_admin, invoice.is_accountant, invoice.allow_edit_address, and invoice.show_assignment are evaluated in some places. Changes should be tested carefully.
• DQL sort expressions in invoice.invoices_result_sort_order and invoice.order_result_sort_order must follow the project convention and not use DESC.
• Profiles and table profiles are not part of this page. They are documented separately.