Skip to main content
Version: Latest
User ManualNeed configuration, code or deployment details? In the Technical Manual: Business Documents

Document Templates and Number Series

Business documents are the papers your business sends: receipts, payment requests, invoices, estimates and credit notes. A document template gives them your look: a logo, an accent color, a paper size and a footer. Number series decide how their numbers are written, such as INV-2026-0001.

MenuSettings > Business documents > Document templates, Settings > Business documents > Number series
PermissionManage business document templates (templates), Manage number series (number series)
FeatureBusiness Documents, and Business Documents PDF for PDF files
Can't find it?

What you see depends on your role. If the menu, a button or a setting on this page is missing, ask your administrator to give you the permission listed above or to turn on the feature. Only administrators can turn features on and change site settings.

Add a document template​

  1. Go to Settings > Business documents > Document templates.
  2. Click Add template.
  3. Fill in the fields below.
  4. Click Save.

The list shows each template with the kinds of documents it is for and whether it is the default. You can show the list as rows or as a grid. Click a template's name or Edit to change it, and Delete to remove it.

The template​

FieldWhat it does
NameA name staff recognize, such as Standard or Wholesale. Required.
NotesNotes for staff. They are not printed.
Used forThe kinds of documents the template is for, such as Receipts or Payment requests (the invoice of a balance a customer pays themselves, with the Transactions and Receipts features on). Tick none to use it for every kind. Only the kinds of the features you have enabled are listed.
Default templateDocuments of its kinds that name no template are printed with it. When you save a template as the default, the template that was the default for the same kinds stops being the default.

Look​

FieldWhat it does
LogoThe address of a PNG or JPEG image in the media library, such as /media/logo.png. PDF files show only an image from the media library.
Use an accent colorTick it to print the title, the header of the line table and the total in the accent color.
Accent colorThe accent color.
Paper sizeLetter or A4, for PDF files and printed pages. The renderer's default (Letter) leaves the choice to the document, and prints on Letter when it has none.
FooterText printed at the bottom of the documents, such as a registration number or a thank-you note.

A document that has its own logo, accent color, paper size or footer keeps it. The template only fills what the document leaves empty.

Which template is used

A document that names a template is printed with it when the template is for the document's kind. Otherwise it is printed with the default template for its kind. A default made for the kind wins over a default for every kind. When no template fits, the document is printed with its own look only.

Choose how document numbers are written​

  1. Go to Settings > Business documents > Number series. Every number series of the features you have enabled is listed, such as receipts and invoices.
  2. For a series, change the fields below. The Example changes as you type.
  3. Click Save.
FieldWhat it does
PatternHow the numbers are written: text with tokens in braces. The hint under the field shows the pattern the series started with.
First numberWhere a new series starts, and where it starts again each year or month. Numbers already issued do not change.
Start againNever, Each year or Each month: when the numbers start again from the first number.
ExampleThe first number of the series, written with today's date.

The tokens are:

TokenIs written as
{seq}The number, such as 42.
{seq:0000}The number with at least as many digits as zeros, such as 0042.
{yyyy}The year, such as 2026.
{yy}The year in two digits, such as 26.
{MM}The month in two digits, such as 05.

The dates are the day the number is issued, in your site's time zone.

Rules for a pattern​

  • A pattern has exactly one {seq} token, so that each number is different.
  • Numbers that start again each year need {yyyy} or {yy}, and numbers that start again each month need {MM} too, or numbers would repeat.
  • A pattern has at most 40 characters, and the first number is 1 or more.

When a series breaks a rule, the page shows the message next to it and saves nothing until you correct it. A series that you set back to the pattern, first number and restart it started with goes back to following the feature that registered it, and its Customized badge goes away.