UltimateInvoice v24.0

📌 Module version: 24.0.2 📅 Last update: July 28, 2026 👤 Publisher/License: Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Interface languages: 📧 Support: by e-mail at contact@atoo-net.com ✅ Dolibarr compatibility: Dolibarr 23.0 and 24.0 ✅ Required module: Invoices ✅ Required PHP version: PHP 7.4 or higher 💡 Free updates for 1 year within the same version, then 50% off the next version.

Make your Dolibarr invoices look like your company with UltimateInvoice

The UltimateInvoice module replaces the native Dolibarr PDF template for invoices with a fully customizable template named ultimate_invoice.

A true Swiss army knife for PDF invoices, it lets you define your own graphic identity (logo, colors, margins, page background, column widths), choose exactly what is printed on the document, append your general sales conditions or additional PDF files, add barcodes and QR codes, and digitally sign the generated file.

No coding required: everything is configured from the module admin pages, with graphic previews and mouse handles to resize widths.

UltimateInvoice is the light edition of the UltimatePDF module: it covers invoices only. For proposals, orders, contracts, shipments, expense reports, interventions, projects, products/BOMs or supplier documents, the full UltimatePDF edition is required.

🎨 What you can customize

🧩 Two configuration levels not to be confused

The module is built on two distinct notions:

1. The Design (Models tab) defines what the document looks like: colors, margins, logo, company alias, page background, column widths.

2. The Options and Invoices pages decide what is printed on the document: visible columns, address blocks, legal mentions, printed signatures.

Several Designs can coexist. Only one is active by default, and a selector at the top right of the application switches between them instantly, without going back to the setup pages.

Each block of the Design form has its own Save button: you validate block by block without losing your input in the others.

🖌️ Graphic customization (Designs)

• Page background: background image or background PDF, to reuse an already designed letterhead, with transparency and X/Y positioning.

• Header: logo height and width, second logo for a partner or a certification, sender block width with drag-and-drop preview and a preset for French postal standard window envelopes.

• Company alias: print a company name, an address, a share capital or a VAT number that differ from the actual legal entity, for a trade name or a subsidiary.

• Margins and columns: PDF margins and width of every column of the line table (reference, image, date, type, project, VAT, unit price, quantity, unit, discount), each resizable with the mouse on a graphic preview.

• Footer: font size, height reserved for the free text, text and background colors.

• Font: choice of the document font, with DejaVuSans for extended or Cyrillic character sets.

📄 Invoice content

Options are enabled independently from each other, with simple checkboxes:

• Line columns: numbering, product photo, unit price excl. tax, discount, unit price after discount, quantity, weight and total weight, unit.

• Address blocks: recipient, customer and sales representative details, professional identifiers, intra-community VAT number, vertical stacking of the contact blocks.

• Layout: header not repeated on every page, fold mark, text next to the date, paper format.

• Invoice specific: linked shipments, payment terms, situation invoice, online payment link, customer outstanding balance, amount in words, total incl. tax line, generation without the VAT column.

• Printed signatures: signature of the person in charge on the document and signature of the sales representative in the note. These are images added to the PDF, not to be confused with the cryptographic signature described below.

📎 PDF merging and general sales conditions

🔏 Electronic signature of invoices (PAdES)

UltimateInvoice can apply a digital signature to the PDF as it is generated. It proves to the recipient the authenticity of the document (it really comes from you) and its integrity (it has not been modified since). Adobe Acrobat Reader shows it in its Signatures panel, and a visible signature box is drawn at the bottom right of the last page.

This feature is described here without ambiguity, so that its scope is clear before purchase:

Accepted certificate formats: .pem, .crt, .p12, .pfx. The file must contain both the certificate and the private key. It is stored in the Dolibarr documents directory, outside the web folder of the module: it is therefore not downloadable from a browser.

Important limitation: merging additional files rewrites the PDF after generation and would break the signature. On an invoice where files are merged, the signature is therefore automatically skipped, with a warning written to the Dolibarr log, rather than produced invalid. Appending the GSC, on the other hand, remains compatible.

🔎 Barcodes, QR codes and Swiss QR-bill

• Product barcodes (EAN13 with check digit, CODE128, CODE39) and third party barcodes, at the top or the bottom of the page.

• QR codes for your own company, for third parties or for the invoice.

• SEPA payment QR code (EPC069-12 standard) and Swiss QR-bill, including the full payment slip on a dedicated page.

Those last two settings belong to the Dolibarr core (Home → Setup → PDF → Specific parameters tab, Invoices section) and not to the module, which simply honors them when generating the document.

For the full Swiss payment slip, the payment mode must be bank transfer, a bank account must be set on the invoice, your company address must be complete and the IBAN valid. QR-IBAN are not supported yet. This dedicated page requires PHP 8.1 or higher.

🧱 Compatibility with the Milestone module

UltimateInvoice recognizes the milestone lines of the Milestone module: they are not handled as regular product lines when computing the line weight and the unit price after discount, and they keep their own formatting in the PDF.

📖 Built-in user guide

A complete guide in French and English can be read straight from the module setup, User guide tab.

It details every option screen by screen, with a single storyline from beginning to end: creating a Design, setting the options, generating an invoice. It is updated with every release.

⚙️ Requirements

⚙️ Installation

1. Download the module archive file (.zip).

2. Place the file in the Dolibarr root directory.

3. Extract the archive and check that the module sits in htdocs/custom/ultimateinvoice.

4. Enable the module from Home → Setup → Modules/Applications, Atoo-Net tab.

5. Select the ultimate_invoice template in the Document template dropdown list of the invoice card.

🧭 Typical use cases

• Align invoices with your brand guidelines: reuse existing colors, logo and letterhead without having a custom PDF template developed.

• Invoice under a trade name: use the company alias to print a company name or an address different from the legal entity.

• Send invoices by post: use the window envelope preset and the fold mark for a mailing without manual adjustment.

• Always attach your GSC: automatically append the same contractual document to every invoice.

• Make payment easier: add a SEPA payment QR code, or the Swiss payment slip for Swiss customers.

• Give confidence in the origin of the document: digitally sign invoices sent by e-mail so that recipients can check they have not been altered.

❓ FAQ

• What is the difference with the UltimatePDF module?
  UltimateInvoice is the light edition of UltimatePDF, restricted to invoices. If you also need to customize proposals, orders, contracts, shipments, expense reports, interventions or supplier documents, UltimatePDF is the one to choose.

• Does the module modify the Dolibarr core?
  No. UltimateInvoice adds an extra document template and relies on standard hooks. The native PDF template stays available: you can go back at any time by selecting it again on the invoice card.

• Can I have several different layouts?
  Yes. Create as many Designs as needed. Only one is active by default, and a selector at the top right of the application switches from one to another.

• Are technical skills required?
  No. The whole configuration is done from the admin pages, with graphic previews. No file editing is needed.

• Does the electronic signature have legal value?
  It is a basic PAdES-B-B signature: it proves the integrity and the origin of the file, but it does not carry the legal value of a qualified eIDAS signature and includes neither a qualified timestamp nor long term archiving.

• Does the electronic signature replace Factur-X?
  No. These are two distinct topics. The signature guarantees the integrity of a PDF; electronic invoicing requires a structured format (Factur-X, ZUGFeRD, PDF/A-3) that UltimateInvoice does not produce.

• Where is the private key password stored?
  In the Dolibarr constants table (llx_const), in clear text, as Dolibarr has no native secret vault. Restrict database access accordingly. The certificate file itself sits outside the web folder of the module, but stays readable by the web server: apply strict permissions on that directory.

• Why is my invoice not signed?
  The most frequent case is additional file merging on that invoice: both features are mutually exclusive, and the signature is deliberately skipped, with a warning in the Dolibarr log.

• Is the payment QR code provided by the module?
  The SEPA QR code and the Swiss QR-bill are Dolibarr core settings, under Setup → PDF → Specific parameters. UltimateInvoice honors them when generating the document.

• Is the module compatible with the milestones of the Milestone module?
  Yes. Milestone lines are recognized and keep their own formatting in the PDF.

• Are my past invoices modified?
  No. Only documents regenerated after the template is selected use the new layout. PDF files already produced stay untouched.

Why use UltimateInvoice?

• Get invoices that look like your company without having a custom PDF template developed

• Set the layout from admin screens, with previews and mouse resizing

• Create several Designs and switch between them in one click

• Reuse an existing letterhead as page background, image or PDF

• Invoice under a trade name thanks to the company alias

• Choose exactly which columns and blocks are printed on the document

• Automatically append your GSC and additional PDF files

• Add barcodes, QR codes, SEPA QR code and Swiss QR-bill

• Digitally sign the invoices you send by e-mail

• Keep the native Dolibarr template available at any time

⚠️ Important recommendation

As with any module changing the appearance of business documents, test UltimateInvoice on a test instance before using it in production.

Before you start, make a full backup of:

• The Dolibarr database

• The Dolibarr documents directory

Once configured, generate a short invoice and a long multi-page one, then check the address blocks, the totals, the footer and the absence of blank pages before rolling the template out.

📖 Documentation

The complete documentation of the module is available on the official Dolibarr wiki:

👉 Dolibarr wiki – UltimateInvoice module (EN)

Documentation in other languages:

👉 Dolibarr wiki – UltimateInvoice module (FR)

👉 Dolibarr wiki – UltimateInvoice module (DE)

👉 Dolibarr wiki – UltimateInvoice module (ES)

👉 Dolibarr wiki – UltimateInvoice module (IT)

A complete user guide is also built into the module, in the User guide tab of its setup page.

More modules