Settings & Configuration

General Settings Panel

The General Settings panel is the central configuration hub for Quickenerp. Every global setting – from company details to module-specific toggles – is managed here.

Navigation

Go to Settings > General Settings. This opens a single long form page organised into collapsible sections by module.

How Settings Are Organised

The page is divided into sections. Each section corresponds to a module and contains relevant toggles, dropdowns, and fields:

Working with Settings

• Toggles – Click a toggle switch to enable/disable a feature. Changes are saved immediately.
• Dropdowns – Select a value from a predefined list. Some are dependent on other settings (e.g. "Default Tax" only appears if a fiscal position is selected).
• Text/Number Fields – Enter values directly. Some fields require a page reload after saving for the change to take effect.
• Related Settings Links – Some settings have a "Configure" link that opens a separate configuration page (e.g. "Chart of Accounts" – "Configure" opens the full chart of accounts list).

Recent Settings Improvements

• Search Settings – Use the search bar at the top of General Settings to find any setting instantly. Type "currency", "tax", "email", etc.
• Settings Visibility – Only settings for installed modules appear. If a module is not installed, its settings section is hidden, keeping the page clean.
• Company-Specific Settings – In multi-company setups, settings can be configured per company. The settings page shows a company selector at the top if you have access to multiple companies.
• Auto-Save – Most settings save automatically when you change them. A green "Saved" indicator briefly appears at the top of the page. Some critical settings still require an explicit Save button.

Settings vs Configuration Menus

Not all settings are in General Settings. Module-specific configuration is often in the module's own Configuration menu:

• General Settings – Global toggles and high-level defaults.
• Module – Configuration – Specific records (e.g. Sales – Configuration – Price Lists, Sales Teams, Shipping Methods).
• Technical Menu (Developer Mode) – Low-level system settings (Scheduled Actions, Automated Actions, System Parameters).

Developer Mode

Developer mode (also known as debug mode) unlocks advanced technical features that are hidden from regular users. It is essential for system administrators who need to customise forms, create automated rules, inspect system data, or configure security.

How to Enable Developer Mode

There are three ways to enable it:

1. From Settings: Go to Settings > General Settings, scroll to the bottom of the page, and click Activate Developer Mode (wrench/spanner icon). The page reloads with developer features visible.
2. URL Parameter: Add ?debug=1 to any URL. Example: https://quickenerp.com/web?debug=1. This enables developer mode for your session.
3. Developer Tools (Assets): Add ?debug=assets to enable developer mode with unminified JavaScript/CSS assets. This is useful for debugging UI issues but the page loads slower.

What Developer Mode Adds

1. Technical Menu

A new top-level Technical menu appears (in Settings or as a standalone menu). It contains:

2. Edit View Option

On any form view, the Actions (gear) menu now includes Edit View. This opens the XML view definition, letting you:

• Add or rearrange fields in the form layout.
• Modify field attributes (readonly, required, invisible).
• Add custom buttons and logic.
• Changes apply immediately. No deployment or restart needed.

3. Field Tracking Configuration

Tracked fields show a history of changes in the chatter – who changed what and when. Enable tracking on any field from the field configuration in Technical – Fields.

4. Additional Context Menu Options

Right-clicking on many elements shows developer options:

• Inspect View – Shows the view architecture and technical IDs.
• View Metadata – Shows record metadata (External ID, model name, creation/modification details).
• Manage Fields – Opens the field configuration for the current model.

Caution

Developer mode gives access to settings that can break the system if misconfigured. Follow these rules:

• Only enable developer mode when you need to make technical changes.
• Disable it when you are done (click the "Deactivate Developer Mode" link at the bottom of General Settings).
• Never modify views or security rules unless you fully understand the implications.
• Take screenshots of default values before changing them.
• Test changes in a staging environment first (if available).

System Parameters

System parameters store key-value configuration pairs. They are used to customise Quickenerp's behaviour without writing code.

Navigation

Go to Settings > Technical > System Parameters (developer mode required).

Commonly Used System Parameters

Creating a System Parameter

1. Click Create.
2. Key – Use dot notation (e.g. mycompany.some_setting). Follow existing conventions for consistency.
3. Value – The string value. Quickenerp automatically parses booleans, integers, and floats.
4. Click Save. The parameter takes effect immediately (some may require a page reload).

Sequences

Sequences control auto-numbering of documents – invoice numbers, quotation numbers, order references, etc.

Navigation

Go to Settings > Technical > Sequences > Sequences (developer mode).

Sequence Structure

Each sequence has:

• Name – e.g. "Sales Order Sequence".
• Code – Internal code (e.g. sale.order for sales orders).
• Prefix – Text before the number: SO/{{year}}/ produces SO/2026/0001.
• Suffix – Text after the number.
• Padding – Number of digits (4 = 0001, 5 = 00001).
• Next Number – The next number in the sequence. You can manually change this.
• Reset Period – Reset the counter: No Reset, Daily, Monthly, Yearly.

Customising Numbering

Example: Change invoice numbering from INV/2026/0001 to INV-2026-00001:

1. Find the "Customer Invoice Sequence" in the sequence list.
2. Change Prefix from INV/{{year}}/ to INV-{{year}}-.
3. Change Padding from 4 to 5.
4. Save. The next invoice will be numbered INV-2026-00001.
5. Already-issued invoices are not affected.

Note: Some localisation packages set numbering according to legal requirements. In the EU, invoices must be numbered sequentially without gaps. Adjust with care.