Elbuz takes a document's type, number, status, delivery and payment method, and print form from directories you edit yourself: custom color-coded statuses, numbering with the year, a multilingual invoice template.
When you need this:
- Year in the invoice number — the counter resets each new year.
- Orders stuck in a status — a time limit in hours flags them in the document list.
- A tracking link for the customer — Elbuz appends the waybill number to the carrier's address.
- An English invoice for a foreign customer — one template stores text per language.
Where to start: Documents window menu → “Dictionaries” → the directory you need.
What document directories do
- Document types — your own type with its own name and accounting behavior, including its settlement role.
- Numbering — prefix, year, month and a counter of the width you need, separately for each of your companies.
- Document statuses — your own status and color, pipeline stages for the “Next stage” button, a time limit.
- Delivery and payment statuses — color in the list and matching to the site's statuses.
- Delivery and payment methods — new options for the order card and a tracking link.
- Print templates — document fields in the text, a separate version for each language, printing to PDF.
How to create your own document type
Each row of the “Document types” window is one type: “Active”, “Name”, “Number prefix”, “Document number” (the current counter value), “Number format”, “Color”, “Note”, “Order”, “Code” and the behavior columns: “Stock movement”, “Settlement role”, “Reserves stock”, “Fulfills order”, “Delivery”, “Payment”.
System types cannot be renamed. Built-in types — “Sales invoice”, “Customer order”, “Invoice” and others — are system types, except “Deal”. Double-clicking their name doesn't open editing but shows: “This is a system type. Its name cannot be changed - print forms, integrations and card logic rely on its code. Create your own type and configure it instead.”
System type behavior is fixed too: “an outgoing invoice must write stock off, an incoming one must add it”. For another name or accounting scheme, add your own type with “Add”: its name and behavior are editable. If your type already has documents, a behavior change affects only future postings; past ones aren't recalculated.
1
Number format samples2
Number format column3
Title of the sales invoice type- Sample chips — click one to copy a number template such as prefix, year and counter.
- Number format column — holds the template that builds the document number for the type.
- Title column — the row for the sales invoice type.
How to set up numbering: prefix, year, counter
A new document's number is built from the “Number format” column of its type. Samples sit above the grid; clicking one copies it: {PREFIX}, {YYYY}, {MM}, {NNNNN}, {PREFIX}{YYYY}-{NNNNN}. What the placeholders mean:
{NNNNN}— the counter; the number of N letters sets its width with leading zeros:{NNNNN}gives 00001;{PREFIX}— the value of the “Number prefix” column;{YYYY}or{YY}— year,{MM}— month,{DD}— day; taken from the date the number is assigned;- any other text goes into the number as is.
To number invoices like INV-2026-00001, enter INV-{YYYY}-{NNNNN} in “Number format” in the “Invoice” row. If the format contains {YYYY} or {YY}, the counter resets itself when a new year starts — the first invoice in January gets 00001.
The counter remembers the year from the first number issued under the new format, so right after you first add the year to the format, numbering for that type starts from 1. An empty “Number format” means the old behavior: prefix plus number. If a document has one of your companies selected, the counter runs separately for each company.
How to add your own document status and set its color
The “Document statuses” window is a shared status list for all types. Columns: “Active”, “Title”, “Color”, “Note”, “Order”, “Pipeline stage”, “SLA, h”, “Code”. To add a status such as “Awaiting call” and make it yellow:
- Open “Document statuses” from the Documents window menu.
- Click “+” in the toolbar (tooltip “Add”) and type the name in the new row.
- In the “Color” column, pick yellow from the palette — the status is shown as a badge in this color in the document list.
- If the status is a step in your workflow, tick “Pipeline stage” and set “Order” between the neighboring stages: the “Next stage” button in a document follows this order.
- If needed, enter “SLA, h” — the time limit for the status. If a document stays longer, a yellow dot “In the current status longer than the limit” appears in the list. 0 means no time limit.
You can give a document type its own chain of stages: in the “Document types” window, an icon in the type's row opens “Status pipeline”, where you tick stages and drag them into the order you need. A type with no ticked stages follows the shared pipeline.
1
Color2
Pipeline stage3
SLA, h- Color column — the status color shown in the documents list.
- Pipeline stage column — tick it for statuses that form the workflow used by the “Next stage” button.
- SLA, h column — the time limit for a status; 0 means no limit.
Delivery and payment statuses: color and the “Code” field
Delivery and payment statuses are two directories named the same in the left menu (“Directories” → “Documents”) and in the Documents window menu (“Dictionaries”). Both have “Name”, “Color”, “Note”, “Order”, “Active”, “Code”. The “Color” cell sets how the status looks in the document list's “Payment status” and “Delivery status” columns and in the order card.
1
Add button2
Color3
Code- Add button — creates a new payment status row.
- Color column — the color of the payment status badge.
- Code column — the system code of the status (wait, paid, prepayment and others).
The “Code” field is the status's machine key; you usually leave it alone. Elbuz fills it in when a row is created (like delivery_status_code_17 or payment_status_code_14) and stores the code in the document, not the name. List filters, the API and rules rely on it: the “Need attention” filter template means document status “New” or payment status code wait.
Built-in statuses have readable codes: for payments — wait (“Pending”), paid (“Paid”), prepayment (“Prepayment”), not_paid (“Not paid”), return (“Refunded”); for delivery — wait_sender (“Awaiting sender”), in_road (“On the way”), delivered (“Delivered”). You can rename a status freely — the code stays the same, so nothing breaks.
Matching to site or carrier statuses is set not here but in the connection orders come from: the “Delivery statuses” and “Payment statuses” buttons in the order import template form (section “Related settings”) and in the API connection card (block “Notification settings”). They open the same directory with a “Code (name) on site (API)” column instead of “Color”: enter the external status code or name, several separated by commas.
If the directory is opened from a Nova Poshta connection, a “Delivery service statuses” list with its status codes appears below the table. Without this matching, order import can't set your status — how matches are found is described in the article on order import.
How to add a delivery or payment method and a tracking link
“Delivery methods” (“Delivery types” in the left menu) and “Payment methods” (“Payment types”) are the lists for the order card's “Delivery type” and “Payment type”. Both have the columns “Active”, “Name”, “Color”, “Note”, “Order”. Add a new method, say “Transfer to business card”, with “Add” in the “Payment methods” window, and it appears in the card's dropdown.
A delivery method also has a “Tracking link” column. Enter the carrier's tracking page address there, to the end of which the shipment number should be added (the number, declaration number).
When an order with this delivery method is saved with a waybill number, Elbuz appends the number to the address and puts the ready link into the order card's “Delivery service: link” field (section “Delivery” → “More fields”). There's no separate variable: the number always goes at the very end. Like any document field, it can go into a customer message template, so the customer gets a link to track the parcel.
How to set up a print template: fields, languages, format
The “Print templates” window from the Documents window menu shows templates of all types (the “Type” column); the printer icon in a “Document types” row shows the templates of one type. “Add” in the general window opens a list of document types; the pencil in a row opens the template editor.
The editor has language tabs (flags) and a “List of fields” block. Each tab has “Name”, “Description” and “Template” — the print form text in a visual editor.
The “List of fields” block lists insertable macros in four columns: contact fields ({Contractor: …}), document fields ({Document: …}), your company's fields ({Company: …}) and the contact's organization ({Contact's organization: …}) — invoices go to a legal entity, while the contact in the document is often its employee. When printing, each macro becomes a value from this document.
The template outputs product rows in a loop — there's an example in the standard template: {% for product in p %} … {{ product.name }}, {{ product.quantity }}, {{ product.unit_name }}, {{ product.price }}, {{ product.price_sum }} … {% endfor %}.
1
Contractor macros2
Document macros- Contractor column — macros that insert contractor data into the template.
- Document column — macros that insert document data into the template.
Amount in words. It isn't in the “List of fields” — add it to the template by hand: {{ d.document_sum_to_word }} — the document total in words, {{ d.document_sum_tax_word }} — VAT in words (20% of the document total).
The words and the currency name in the amount in words follow the document language (section “Additional” → “Language”), and if no language is selected, the language of your company's country; the currency is the document's or your company's. For a language or currency missing from the dictionary, the amount in words prints empty.
Language versions. A template has a tab for each Elbuz language. An English invoice for a foreign customer needs no separate template: fill in the English tab and set “Language” to English in the document's “Additional” section; printing uses the version matching the document language. Tabs other than the main language have a translate icon, “Translate from the main language value”, that translates the template text from the main language; check the macros afterwards.
Format. A document's print form comes out only as PDF — both for one document and for a batch (“1 PDF” or a “ZIP” of PDF files). There's no export to DOCX or for documents; to edit an invoice in Word, you'll have to copy the text from the PDF.
For a one-off invoice or sales invoice without setting up a template, you can fill it in online and save it as PDF with the free sales invoice and invoice form; an Elbuz template is what you need when documents are printed from orders every day.
FAQ
Why can't I rename “Sales invoice”?
It's a system type: print forms, integrations and card logic rely on its code, so its name and behavior can't be edited. Create your own type with the “Add” button — see document types.
I changed my type's behavior — why weren't past documents recalculated?
A behavior change applies only to future postings. Elbuz doesn't recalculate documents that are already posted.
Why did the number restart at 00001 after I changed the format?
The counter remembers the year from the first number issued under the new format. So as soon as you first add the year to “Number format”, numbering for that type starts from 1 — and then resets with each new year.
The “Next stage” button skips my status. Why?
A status joins the chain only if “Pipeline stage” is ticked for it, and “Order” sets its place in the chain. If the document type has its own “Status pipeline”, that one applies instead of the shared one.
Can I export an invoice to Word?
No. A document's print form comes out only as PDF; there's no DOCX or HTML for documents. To edit an invoice in Word, you'll have to copy the text from the PDF.
How is “Code” different from “Code (name) on site (API)”?
“Code” is the status's machine key; Elbuz fills it in itself. “Code (name) on site (API)” appears when the directory is opened from a connection, and you enter there the external system's status that should become yours.
Where to find them and who has access
- Menu
- Directories → Documents → “Document types”, “Document statuses”, “Payment statuses” and others
- Other entry points
- the Documents window menu → “Dictionaries”; “Print templates” — only from here
A document card takes its type, status, delivery type and payment type from lists edited in separate directory windows. Open them from the Documents window menu (“Additional operations” in the toolbar), section “Dictionaries”, or from the left menu “Directories” → “Documents”. Some item names differ between the two menus, but they open the same windows:
| Window menu → “Dictionaries” | Left menu “Directories” → “Documents” | What it contains |
|---|---|---|
| “Document types” | “Document types” | type name, number prefix and format, color, accounting behavior |
| “Document statuses” | “Document statuses” | statuses, their color, pipeline stages and time limit |
| “Delivery statuses” | “Delivery statuses” | order delivery statuses, their color and code |
| “Payment statuses” | “Payment statuses” | order payment statuses, their color and code |
| “Delivery methods” | “Delivery types” | delivery methods and tracking links |
| “Payment methods” | “Payment types” | payment methods |
| “Tax classes” | “Tax classes” | VAT rates and the default class (tax classes) |
| “Print templates” | — | document print forms; also opened by the printer icon in a row of the “Document types” window |
In every directory, the “Add” button in the toolbar adds a new row; you edit values right in the grid by clicking or double-clicking a cell, and pick a color from the palette in the “Color” column.
If you open a status or method directory not from the menu but from an order import template or an connection card, the grid has one more column, “Code (name) on site (API)” — the value this row has on the marketplace (more in delivery and payment statuses).
Related topics
- If you need the big picture of the Documents window — Document list.
- If site statuses aren't set in imported orders — Order import.
- If a batch doesn't print because a template is missing — Printing a batch of documents.
- If your own type should add to a customer's debt — Customer debt and payments.
- If you're choosing software to manage orders — what it gives your store.
