Appearance
Numbering sequences
Also known as
- sequence
- document number
- prefix
- auto number
- series
- numbering
- invoice number
- gapless
- number format
- running number
Every document gets its number from a numbering sequence the moment it is first saved: PO-2026-00037, INV-2026-00128, JE-2026-00834. Each document type has its own sequence with a format (prefix, year, counter) and the next number. An account administrator can change the format, for example to match your old system or your tax authority's rules, in Settings › Numbering sequences.
How a number is built
A format is text with tokens in braces:
| Token | Gives | Example in 2026-10-15 |
|---|---|---|
{YYYY} | Four-digit year | 2026 |
{YY} | Two-digit year | 26 |
{MM} | Month, 01–12 | 10 |
{DD} | Day, 01–31 | 15 |
{0000} | Counter, zero-padded to the number of zeros ({0} = no padding) | 0042 |
Example: SO-{YYYY}-{00000} gives SO-2026-00416.
- A format needs exactly one counter, at most 64 characters, and only these tokens.
- When the format contains a year (
{YYYY}or{YY}), the counter restarts at 1 every year. - The year is taken from the document date, not today: an invoice dated 30 December 2025 and entered on 2 January 2026 is numbered in the 2025 series.
- Numbers are unique and gap-free per saved document: two people saving at the same time never get the same number.
Change a document's numbering (administrators)
- Go to SettingsNumbering sequences.
- Find the document, for example Sales orders (the rows are grouped by module) and select its pencil (Edit Sales orders numbering).
- Edit the Format. Click a token in the Format tokens panel to insert it at the cursor.
- Optional: change the Next number.
- Check the Next document column: it previews the next numbers. A wrong format shows the error there instead, for example "must contain exactly one counter token such as {0000}" or "unknown token {Q}".
- Select Save (or press Enter). Press Esc or Cancel to leave it unchanged.
You see "Sales orders numbering saved" with the next number. The change applies to the next document; documents that already have a number keep it.
WARNING
Lowering the next number can collide with numbers already used; the server refuses a number that already exists, and the user who saves the document sees an error. Only raise the next number (for example to continue after your old system's last invoice number).
The Procurement and Manufacturing settings show the same sequences filtered to their documents: Procurement › Settings › Numbering and Manufacturing › Settings › Numbering.
Sequences per module (demo company)
| Module | Documents and their formats |
|---|---|
| Finance | Journal entries JE-{YYYY}-{00000}, Vendor bills BILL-{YYYY}-{00000}, Customer invoices INV-{YYYY}-{00000}, Credit notes CN-…, Customer receipts RCT-…, Vendor payments PAY-…, Payment runs PAYRUN-{YYYY}-{0000}, Fixed assets FA-{00000}, Bank statements, depreciation, dunning, consolidation, revenue recognition and intercompany journals |
| Procurement | Purchase requisitions PR-{YYYY}-{00000}, RFQs RFQ-…, Purchase orders PO-{YYYY}-{00000}, PO receipts PRC-…, Blanket orders BPO-…, Vendor contracts CTR-… |
| Sales & CRM | Leads LEAD-…, Opportunities OPP-…, Quotes QT-…, Sales orders SO-{YYYY}-{00000}, Returns (RMA) RMA-…, Direct deliveries DN-…, invoice and commission runs |
| Inventory | Goods receipts GRN-{YYYY}-{00000}, Shipments SHP-…, Transfer orders TRF-…, Stock adjustments ADJ-…, Cycle counts CC-… |
| Manufacturing | Work orders WO-{YYYY}-{00000}, MRP runs MRP-…, Engineering change orders ECO-…, Cost roll-ups CR-… |
| People | Employees EMP-{00000}, Leave requests LV-…, Employment contracts CTR-…, Job requisitions REQ-…, Job offers OFR-…, Pay runs PR-{YYYY}-{0000} |
| Projects | Projects PRJ-…, Timesheets TS-…, Expense claims EXP-…, Project invoices PINV-…, Project revenue runs PRR-… |
| Quality | Inspections INS-…, Non-conformance reports NCR-…, CAPAs CAPA-…, Audits AUD-…, Controlled documents QD-{0000}, Calibration records CAL-… |
| Service | Service cases CASE-…, Service work orders SWO-…, Service contracts SC-…, Warranties WAR-…, Knowledge base articles KB-{00000} |
| Assets | Asset tags AST-{00000}, Maintenance plans PM-{0000}, Maintenance work orders MWO-{YYYY}-{00000} |
| Supply chain, Planning, Compliance | Carrier shipments CSH-…, Landed cost documents LC-…, forecast and DRP runs; S&OP plans SOP-…, Scenarios SCN-…, Rolling forecasts RF-…; Controls, Risks, Policies, Incidents, Control tests, Deficiencies, Data subject requests, Attestation campaigns |
Permissions
| What | Who |
|---|---|
| See the sequences | Account administrators and roles with company settings access (Permission: settings.company.view). |
| Change a format or the next number | Permission: settings.company.manage ("Manage company settings, sequences, custom fields, localisation"); on the module pages also the module's settings permission, for example procurement.settings.manage. |
Limits and things to know
- Different document types may share a prefix (in the demo, HR pay runs use
PR-{YYYY}-{0000}and procurement requisitionsPR-{YYYY}-{00000}). They are separate sequences, so the same number can exist twice; search by number may find both. Give each a distinct prefix if that confuses your users. - A document gets its number when it is first saved, even as a draft. A cancelled draft keeps its number, so the series has no gaps but contains cancelled documents.
- Every change of a format is recorded in Activity ("Changed format to …").
- Numbers do not depend on the legal entity: all entities share one series per document type.
Related
- Numbering sequences settings
- Documents and their states
- Audit trail and activity
- Legal entities and currencies
- Imports and exports: opening balances and migrated documents
