Module Ultimateline EN

Summary

Retour index
Documentation développeur

Retour index
Documentation Utilisateur

Information

Module name	UltimateLine
Editor / Editeur
Download or buy page / Page achat ou téléchargement	External module - www.dolistore.com
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2026-04-25
Note / Nota	⬆ Back to summary

Features

Allows the automatic addition of service lines as sub-lines (child lines) of a product line in proposals, orders, and invoices when adding or modifying a product line. The module can manage multiple services simultaneously, each calculated either as a percentage of the parent line amount or as a fixed amount. Particularly useful for automating calculations and adding lines such as carbon taxes, eco-taxes, specific discounts, etc.

Behavior in documents

• The service line is automatically inserted just below its parent product line.
• In the user interface, the service line is indented and visually grouped with its parent line.
• In PDFs generated by the UltimatePDF module, the service line is displayed with a "└" icon to indicate its attachment to the parent line.
• In the totals block of PDFs, an informational line including [service name] : [amount excl. tax] is automatically added under the Total excl. tax, using the same visual style as VAT lines.

Compatibility with the Milestone module

UltimateLine is compatible with the Milestone module, which allows organizing document lines into milestones (sections). When a product line belongs to a milestone, its UltimateLine service line is correctly rendered :

• In the interface, the service line is displayed inside the milestone block, just after its parent product line, before the milestone subtotal.
• The service line amount is included in the milestone subtotal calculation.
• In PDFs, the service line keeps the "└" icon (and not the milestone child icon).
• Conversion workflows proposal → order, proposal → invoice and order → invoice correctly maintain the link between the service line and its parent product line.

Prerequisites

Dolibarr : Supported versions :

• 20.x
• 21.x
• 22.x
• 23.x

⚙️ Installation procedure

⚙️ Manual installation

1. Download the module archive file (.zip).
2. Place the file in the Dolibarr root directory.
3. Extract the zip file using the command :

unzip module_ultimateline-X.0.0.zip

1. Check that the module is located in :

htdocs/custom/ultimateline

1. The module is now available and can be enabled from Dolibarr.

⬆ Back to summary

Configuration

To use this module, you must first enable it. After logging in with an administrator account, go to the page "Home - Setup - Modules". The module appears in "Main modules / Financial modules (Accounting/treasury)", click on "Enable". An icon appears at the end of the module line, click on it to access the specific configuration page. You will now need to create at least one service in the Products/Services module.

The module is now operational.

Final line service configuration

Module configuration page:

On the module configuration page :

- Select a service to use as a final line service by choosing one from the dropdown list of previously created services.

- Choose the associated action type (percentage applied to the price, or fixed amount added to the price).

- Fill in the "Value to apply" field with a numeric value... then click the assign button.

- Now select your final line service that appears in the dropdown list of the next block. Click on the "Display" button.

- You can now select from the list of assignable Products those for which this rule will apply.

- Move the selected products from one column to another using the small arrows, then click apply.

- To watch an online training on YouTube : [[1]]

Usage

- When a product line is added or modified, the corresponding service line is automatically created or recalculated.

- When a product line is deleted, its linked service line is automatically deleted as well.

- Workflows : When converting a proposal into an order, a proposal into an invoice, or an order into an invoice, service lines are automatically attached to their parent product line in the new document. No manual action is required.

- With the Milestone module : Service lines remain correctly positioned inside their milestone block after conversion, and their amount is included in the milestone subtotal.