Module Ultimatepdf EN: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
No edit summary
Tag: 2017 source edit
No edit summary
Tag: 2017 source edit
 
Line 18: Line 18:
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimatepdf}}
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimatepdf}}
|status=stable
|status=stable
|prerequisites=
|prerequisites=PHP 8.2 minimum for UltimatePDF 25
|minversion=18.0.0 - 23.0.0
|minversion=20.0.0 - 25.0.0
|note=
|note=
''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''
Line 27: Line 27:
The true Swiss Army knife with '''over 100 blades!''' that lets you customize your PDF documents to match your company's visual identity. You can choose:
The true Swiss Army knife with '''over 100 blades!''' that lets you customize your PDF documents to match your company's visual identity. You can choose:


* Font color, border color, and frame background color.
*The colour of the font, borders and frame backgrounds.
* The style of border lines (solid or dashed).
*The style of the outlines (solid or dashed).


Adds many features to documents:
Adds many features to documents:


* '''PDF document concatenation''' on all document types (T&Cs, technical datasheets...).
* '''Concatenation of PDF documents''' on every document type (terms and conditions, data sheets...).
* '''Independent reference column'''.
* '''Independent reference column'''.
* '''Line numbering column'''.
* '''Line numbering column'''.
* '''Independent image column'''.
* '''Independent picture column'''.
* '''Signature and "Approved" stamp block'''.
* '''"Agreement" signature and stamp block'''.
* '''Currency symbols displayed after amounts'''.
* '''Currency symbols displayed after amounts'''.
* '''Bill of Exchange (LCR) for invoices'''.
* '''Bill of exchange (LCR) for invoices'''.
* '''Factur-X / PDF/A-3 electronic invoice''' compliant with the French e-invoicing reform <span style="background:#c05a1a;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0+</span>
* '''Swiss QR-bill''' <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>
* '''And much more...'''.
* '''And much more...'''.
''[[#Table of Contents|⬆ Back to top]]''
==Reading the version badges==
Every feature added after UltimatePDF 14.0 carries a badge showing '''the first version of the module that offers it'''. It remains available in all later versions.
{| class="wikitable"
! Badge !! Meaning
|-
| ''(no badge)'' || Feature available since UltimatePDF 14.0 or earlier: present in every maintained version.
|-
| <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span> || Available from UltimatePDF 18.0 (hence for Dolibarr 18 and later).
|-
| <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span> || Available from maintenance release 24.0.5: update the module if you run 24.0.0 to 24.0.4.
|-
| <span style="background:#c05a1a;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0+</span> || New in the 25 branch (Dolibarr 25).
|-
| <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span> || Developed, released with the upcoming version 25.0.3.
|}
A feature added during a branch may exist on two branches maintained in parallel; the badge then shows both versions, for example "24.0.11+ / 25.0.1+".


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Prerequisites==
==Prerequisites==
'''Dolibarr:''' Supported versions:
'''Dolibarr:''' supported versions:


* '''20.x'''
{| class="wikitable"
* '''21.x'''
! UltimatePDF !! Dolibarr !! Minimum PHP !! Latest version
* '''22.x'''
|-
* '''23.x'''
| '''25.x''' || '''25.x''' || 8.2 || 25.0.2
|-
| '''24.x''' || '''24.x''' || 7.1 || 24.0.11
|-
| '''23.x''' || '''23.x''' || 7.2 || 23.0.7
|-
| '''22.x''' || '''22.x''' || 7.1 || 22.0.13
|-
| '''21.x''' || '''21.x''' || 7.1 || 21.0.5
|-
| '''20.x''' || '''20.x''' || 7.1 || 20.0.5
|}


Each version of UltimatePDF corresponds to the equivalent version of Dolibarr:
Each UltimatePDF version matches the same Dolibarr version: '''UltimatePDF 25''' → '''Dolibarr 25''', '''UltimatePDF 24''' → '''Dolibarr 24''', and so on. Always install the module branch carrying the same number as your Dolibarr.


* '''UltimatePDF 20''' → '''Dolibarr 20'''
<i class="fas fa-exclamation-triangle"></i> '''UltimatePDF 25 requires PHP 8.2''': the bundled libraries (QR codes) do not load under PHP 8.1. It is tested under PHP 8.4 and 8.5.
* '''UltimatePDF 21''' → '''Dolibarr 21'''
* '''UltimatePDF 22''' → '''Dolibarr 22'''
* '''UltimatePDF 23''' → '''Dolibarr 23'''


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


=⚙️ Installation Procedure=
=⚙️ Installation procedure=
 
Three methods are available, from the simplest to the most technical. The UltimatePDF zip weighs about '''3.5 MB''': before using the Dolibarr interface, check that your installation accepts a file of that size (see below).
 
===⚙️ Method 1: installation from the Dolibarr interface===


===⚙️ Manual Installation===
# Go to '''Home''' > '''Setup''' > '''Modules/Applications'''.
# Open the '''Deploy/install external app/module''' tab.
# Click '''Choose file''' and select the module .zip file.
# Click '''Upload''' to start the installation.
# Enable the module once the installation is complete.


# '''Download''' the module archive file (.zip).
====Checking the maximum upload size====
# '''Place''' the file in the Dolibarr root directory.
Three limits apply to the zip upload, and '''the smallest one wins''':
# '''Unzip''' the file using the command:


<code>unzip module_ultimatepdf-X.0.0.zip</code>
{| class="wikitable"
! Limit !! Where to see / change it !! Common value
|-
| Dolibarr limit (<code>MAIN_UPLOAD_DOC</code>) || '''Home > Setup > Security''', '''Files''' tab, "Maximum size for uploaded files" (in KB) || '''2048 KB''' (Dolibarr installation value)
|-
| <code>upload_max_filesize</code> (PHP) || server <code>php.ini</code> file || '''2M''' (PHP default)
|-
| <code>post_max_size</code> (PHP) || server <code>php.ini</code> file || 8M
|}


# '''Verify''' that the correct module location is:
'''How to find the current values:'''
* On the '''Deploy/install external app/module''' page, hover the information icon to the right of the '''Upload''' button: Dolibarr displays "Dolibarr limit: X Kb, PHP limit: Y Kb".
* The PHP settings are detailed in '''Admin Tools > About PHP''' (page <code>admin/system/phpinfo.php</code>): look for <code>upload_max_filesize</code> and <code>post_max_size</code>.


<code>htdocs/custom/ultimatepdf</code>
If one of the limits is below the zip size, Dolibarr rejects the file with the message "File size is too large or file not provided".


# '''The module is now available''' and can be enabled from Dolibarr.
'''How to raise them:'''
# '''Dolibarr limit''': in '''Home > Setup > Security''', '''Files''' tab, enter for example <code>10240</code> (10 MB) and save.
# '''PHP limits''': in <code>php.ini</code> (or your hosting control panel: Plesk, cPanel, "PHP settings"…), set for example:
<pre>
upload_max_filesize = 10M
post_max_size = 12M
</pre>
: <code>post_max_size</code> must stay greater than or equal to <code>upload_max_filesize</code>. Then restart the web server or PHP-FPM (not needed with most hosting providers, which apply the change immediately) and check the new values in '''About PHP'''.


---
<i class="fas fa-exclamation-triangle"></i> On shared hosting, PHP limits cannot always be changed. In that case, use method 2 or 3.
 
===⚙️ Method 2: manual installation on the server (SSH)===
 
The zip contains an <code>htdocs/ultimatepdf/</code> folder; it is the <code>ultimatepdf</code> folder that must end up in the Dolibarr <code>custom</code> directory.
 
# '''Copy''' the zip to the server, for example into <code>/tmp</code>.
# '''Unzip''': <code>unzip module_ultimatepdf-X.Y.Z.zip -d /tmp/ultimatepdf_zip</code>
# '''Copy''' the module folder: <code>cp -r /tmp/ultimatepdf_zip/htdocs/ultimatepdf /path/to/dolibarr/htdocs/custom/</code>
# '''Give ownership''' to the web server if needed, for example: <code>chown -R www-data:www-data /path/to/dolibarr/htdocs/custom/ultimatepdf</code>
# '''Check''' that the module location is: <code>htdocs/custom/ultimatepdf</code> (and not <code>htdocs/custom/htdocs/ultimatepdf</code>).
# '''Enable''' the module from Dolibarr.
 
===⚙️ Method 3: FTP / SFTP upload (last resort)===


===⚙️ Installation via the Dolibarr Interface===
If you can neither upload files in Dolibarr nor access the server through SSH:
You can also '''deploy and install''' the module directly from the Dolibarr interface:


# Go to the '''Configuration''' > '''Modules/Applications''' menu.
# '''Unzip''' the archive on your computer (right click > "Extract All…" on Windows).
# Go to the '''Deploy/Install an external module''' tab.
# Open the extracted folder: it contains <code>htdocs</code>, which itself contains the <code>ultimatepdf</code> folder.
# Click '''Choose a file''' and select the module .zip file.
# '''Connect''' to the server with an FTP/SFTP client (for example FileZilla), using the credentials supplied by your hosting provider.
# Click '''Send File''' to start the installation.
# '''Find''' the Dolibarr directory: it is the one containing the <code>admin</code>, <code>core</code>, <code>conf</code>… and '''<code>custom</code>''' folders. Depending on the provider, it is named <code>htdocs</code>, <code>httpdocs</code>, <code>www</code> or <code>public_html</code>. If <code>custom</code> does not exist, create it.
# Enable the module once installation is complete.
# '''Upload''' the <code>ultimatepdf</code> folder (not the zip, nor the surrounding <code>htdocs</code> folder) into <code>custom</code>.
# '''Wait for the transfer to finish''' and check in the FTP client log that no file failed: the module has more than 1,000 files, and an interrupted transfer leaves an incomplete module.
# '''Check''' that the final path is <code>…/custom/ultimatepdf/core/modules/modUltimatepdf.class.php</code>.
# '''Enable''' the module from '''Home > Setup > Modules/Applications'''.


'''✅ The module is now operational and ready to use!'''
<i class="fas fa-exclamation-triangle"></i> To '''update''' through FTP, replace the existing <code>ultimatepdf</code> folder (after backing it up), then disable and re-enable the module to apply any database changes. Your templates and settings, stored in the database, are kept.


'''✅ The module is now up and running!'''
''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


Line 96: Line 166:
After logging in with an administrator account:
After logging in with an administrator account:


# Go to '''Home > Configuration > Modules'''.
#Go to '''Home > Setup > Modules/Applications'''.
# In the '''Main Modules / Multi-module Tools''' tab, find '''UltimatePDF'''.
#In the '''Base modules / Multi-modules tools''' section, find '''UltimatePDF'''.
# Click the activation button.
#Click the activation button.
# A settings icon appears at the end of the module row. Click it to access the settings.
#A pictogram appears at the end of the module line. Click it to open the settings.


Once enabled, the module supports several document templates in Dolibarr:
Once enabled, the module provides several document templates in Dolibarr:


===Supported Document Templates===
=== Supported document templates ===


* '''ultimate_propal''': Commercial proposal templates.
* '''ultimate_propal''': commercial proposals.
* '''ultimate_order''': Order document templates.
* '''ultimate_order''': customer orders.
* '''ultimate_invoice''': Invoice templates.
* '''ultimate_proforma''': pro forma invoices, from a customer order <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span>
* '''ultimate_shipment''': Shipping slip templates.
* '''PV_reception''': works acceptance report, from a customer order, with signature frames and reservation boxes <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span> (fully reworked in <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>)
* '''ultimate_receipt''': Customer delivery receipt templates.
* '''ultimate_invoice''': invoices.
* '''ultimate_supplierinvoice''': Supplier invoice templates.
* '''ultimate_shipment''': shipping slips.
* '''ultimate_supplierorder''': Supplier order templates.
* '''ultimate_delivery''': delivery notes.
* '''ultimate_supplierproposal''': Supplier price request templates.
* '''ultimate_receipt''': receptions (goods received from suppliers).
* '''ultimate_project''': Project report templates.
* '''ultimate_supplierproposal''': supplier price requests.
* '''ultimate_contract''': Contract and subscription templates.
* '''ultimate_supplierorder''': supplier orders.
* '''ultimate_expensereport''': Expense report templates.
* '''ultimate_supplierinvoice''': supplier invoices.
* '''ultimate_product''': Product document templates.
* '''ultimate_contract''': contracts and subscriptions.
* '''ultimate_bom''': Templates for the BOM module.
* '''ultimate_inter''': intervention sheets.
* '''ultimate_project''': project reports.
* '''ultimate_expensereport''': expense reports.
* '''ultimate_product''': product sheets.
* '''ultimate_bom''': bills of materials (BOM module) <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">15.0+</span>


✅ ''Once enabled, the module is immediately operational and ready to use in Dolibarr.''
✅ ''Once enabled, the module is immediately operational in Dolibarr.''


==='''Quick Access'''===
=== '''Quick access''' ===
<i class="fas fa-bolt"></i> You can access the module configuration from its dedicated menu in Dolibarr. If you need help, click the '''"?"''' button in the top right corner of the interface.
<i class="fas fa-bolt"></i> You can reach the module configuration from its dedicated menu in Dolibarr. If you need help, click the '''"?"''' button at the top right of the interface.
 
* A complete '''user guide''' is built into the module, in the '''Guide''' tab of its setup, in French, English, German, Spanish and Italian <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0+</span>
* Every option on the setup pages has a tooltip describing its actual effect on the PDF, its dependencies and its limits <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>
* The setup pages are organised in collapsible sections (accordion) <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>


---
---
Line 129: Line 207:
[[File:Ultimatepdf_docu_001.png|959x358px|link=Special:FilePath/Ultimatepdf_docu_001.png]]
[[File:Ultimatepdf_docu_001.png|959x358px|link=Special:FilePath/Ultimatepdf_docu_001.png]]


* Template example: [[https://wiki.dolibarr.org/images/d/d8/PR2007-0087.pdf]]
*Sample template: [https://wiki.dolibarr.org/images/d/d8/PR2007-0087.pdf PR2007-0087.pdf]


==Template Configuration==
==Template configuration==


'''Module-specific configuration page:'''
'''The module's own setup page:'''


[[File:model_01.png|960px|link=Special:FilePath/model_01.png]]
[[File:model_01.png|960px|link=Special:FilePath/model_01.png]]


On the module's dedicated configuration page, several tabs are available:
The module's setup page has several tabs:


* Templates Tab
*Templates tab


Here you can create and edit your templates:
Here you can create and edit your templates (also called "designs"):


# Fill in the label field to give your template a name.
#Fill in the label field to name your template.
# Give a description of your template so you can find it easily (e.g. "My blue template with VAT and References").
#Give your template a description so you can find it easily (My blue template with VAT and references).
# Option to use a different font than the one configured in the language file, for example "DejaVuSans". Personally I like Raleway and Roboto.
#You can use another font than the one set in the language file, for example "DejaVuSans". Personally, I like Raleway and Roboto.


( <i class="fas fa-exclamation-triangle"></i> '''Warning: some exotic fonts cause display issues with currencies, and don't forget to select one or the system will crash''')
( <i class="fas fa-exclamation-triangle"></i> ''' Warning: some exotic fonts cause problems displaying currencies; also, do not forget to select one, otherwise the system crashes''')


# Display a background image on your templates.
#Display a background image on your templates.
# Remember to adjust the background image transparency, as it may hide certain areas of the document.
#Remember to set the transparency of the background image, as it may hide some areas of the document. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">19.0+</span>
# Configure the image position using X and Y coordinates.
#Position the image with its X and Y coordinates.
# Option to use a PDF as the document background. ( !''' Warning: This feature can behave unpredictably, for example it may only apply on every other page, etc...''')
#You can use a PDF as document background. ( !''' Warning: the behaviour is sometimes erratic, for example it applies to every other page...''')
 
'''Several templates, one per employee or per use''' <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span>: each template keeps its own colours, fonts, logos, margins and column widths, and you switch from one to another without re-entering anything.
 
'''Export and import a template''' <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>: a template can be downloaded as a JSON file and imported into another Dolibarr installation. An import always creates a new, inactive template and never overwrites or replaces the template in use. A sample template, "Ardoise & Cuivre" (Slate & Copper), ships with the module.
 
'''Real PDF preview''' <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>: the template edit page shows an actual PDF generated with the settings being entered, even before saving them.


[[File:model_02.png|960px|link=Special:FilePath/model_02.png]]
[[File:model_02.png|960px|link=Special:FilePath/model_02.png]]


( <i class="fas fa-exclamation-triangle"></i>''' Info: a new full-width banner layout is now available''')
( <i class="fas fa-exclamation-triangle"></i>''' Info: a new layout with a full-width banner is now available''') <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">21.0+</span>


[[File:model_03.png|960px|link=Special:FilePath/model_03.png]]
[[File:model_03.png|960px|link=Special:FilePath/model_03.png]]
Line 162: Line 246:
[[File:model_04.png|960px|link=Special:FilePath/model_04.png]]
[[File:model_04.png|960px|link=Special:FilePath/model_04.png]]


<i class="fas fa-exclamation-triangle"></i> Option to use a different logo than your company logo (for themed subsidiaries, for example).
<i class="fas fa-exclamation-triangle"></i> You can use another logo than your company's (for themed subsidiaries, for example).


# Allows you to hide the alternate logo without deleting it, and display your company logo instead.
#Hide the other logo without deleting it, and so display your company logo.
# You can hide your company logo and only display the company name, or use the alternate logo in full page width.
#Hide your company logo and show only the company name, or use the other logo across the full page width.
# Allows displaying the Qualibat logo in the footer of PDF documents.
#Set the width and height of the company logo and of the other logo <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span>
#Display the Qualibat logo in the footer of PDF documents <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">21.0+</span>
#Display a logo band in the footer <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>


[[File:model_05.png|960px|link=Special:FilePath/model_05.png]]
[[File:model_05.png|960px|link=Special:FilePath/model_05.png]]


<i class="fas fa-exclamation-triangle"></i> Option to change the contact details of the issuing company.
<i class="fas fa-exclamation-triangle"></i> You can change the sender company details.
 
* Sender name, address, zip code, town, country, phone, fax, e-mail and website.
* Sender capital, legal form, intra-community VAT number and SIRET <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">17.0+</span>


[[File:model_06.png|960px|link=Special:FilePath/model_06.png]]
[[File:model_06.png|960px|link=Special:FilePath/model_06.png]]
Line 178: Line 267:
[[File:model_08.png|960px|link=Special:FilePath/model_08.png]]
[[File:model_08.png|960px|link=Special:FilePath/model_08.png]]


# Upload an image (A4 page size) to display on the first page of a commercial proposal; it will be added to the list of preconfigured pages available for selection.
#Upload an image (A4 page size) to display as the first page of a commercial proposal; it is added to the list of preset pages offered to you, and you then need to select it. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">20.0+</span>
# Use the color picker to set a background color for address blocks.
#Use the colour picker for the background colour of the address blocks.
# Use the color picker to set a background color for column headers.
#Use the colour picker for the background colour of the column titles. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span>
# Use the color picker to set a border color.
#The text colour of the column titles is computed automatically (black or white) from the contrast with the chosen background colour, as in the Eldy theme: titles stay readable on a dark background. <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>
# Use the color picker to set a text color.
#Use the colour picker for the border colour.
# Use the color picker to set a QR code color.
#Use the colour picker for the text colour.
# Show or hide the background color of address blocks independently.
#Use the colour picker for the QR code colour.
# Configure the border line style (dashed or solid).
#Show or hide the background colour of each address block independently.
# Configure the background color transparency.
#"Frameless" style for the address blocks: no background and no border <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>
# Configure the corner radius (rounded or right-angled).
#Set the border line style (dashed or solid).
# Show or hide the VAT column and amounts.
#Set the transparency of the background colour.
# Swap the sender/receiver address block positions.
#Set the corner radius (rounded or square corners).
# Show or hide column borders.
#Show or hide the VAT column and amounts.
# Adjust your document margins.
#Swap the sender/recipient address blocks. As long as the option has never been saved, the native Dolibarr constant <code>MAIN_INVERT_SENDER_RECIPIENT</code> is honoured <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.11+</span> / <span style="background:#c05a1a;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.1+</span>
#Free positioning of the address blocks, in millimetres, for foreign window envelopes, with a "Swiss window envelope" button (invoice template) <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>
#Compact sender line above the recipient, German/Austrian DIN 5008 standard (invoice template) <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.11+</span> / <span style="background:#c05a1a;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.1+</span>
#Address frames grow automatically when the address, contact, VAT and professional IDs do not fit in the usual height <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.8+</span>
#Show or hide the column borders.
#Set the margins of your documents.


[[File:model_09.png|960px|link=Special:FilePath/model_09.png]]
[[File:model_09.png|960px|link=Special:FilePath/model_09.png]]
The column settings are grouped in tabs <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>


[[File:Ultimatepdf_help-04.png|800px|link=Special:FilePath/Ultimatepdf_help-04.png]]
[[File:Ultimatepdf_help-04.png|800px|link=Special:FilePath/Ultimatepdf_help-04.png]]


# Adjust the width of the line numbering column.
#Set the width of the line numbering column.
# Show or hide the reference column.
#Show or hide the reference column.
# Adjust the width of the reference column.
#Set the width of the reference column. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span>


[[File:Ultimatepdf_help-05.png|850px|link=Special:FilePath/Ultimatepdf_help-05.png]]
[[File:Ultimatepdf_help-05.png|850px|link=Special:FilePath/Ultimatepdf_help-05.png]]


# Adjust the width of the description column.
#Set the width of the description column.
# Adjust the width of the image column.
#Set the width of the picture column.


[[File:Ultimatepdf_help-06.png|800px|link=Special:FilePath/Ultimatepdf_help-06.png]]
[[File:Ultimatepdf_help-06.png|800px|link=Special:FilePath/Ultimatepdf_help-06.png]]


# Adjust the width of the VAT column.
#Set the width of the VAT column. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span>
# Adjust the width of the unit price column.
#Set the width of the unit price column. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span>


[[File:Ultimatepdf_help-07.png|800px|link=Special:FilePath/Ultimatepdf_help-07.png]]
[[File:Ultimatepdf_help-07.png|800px|link=Special:FilePath/Ultimatepdf_help-07.png]]


# Adjust the width of the quantity column.
#Set the width of the quantity column. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span>
# Adjust the width of the unit column.
#Set the width of the unit column.
# Adjust the width of the discount column.
#Set the width of the discount column. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span>
#Set the width of the weight and weight/volume columns, and of the line barcode. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>


[[File:Ultimatepdf_help-08.png|800px|link=Special:FilePath/Ultimatepdf_help-08.png]]
[[File:Ultimatepdf_help-08.png|800px|link=Special:FilePath/Ultimatepdf_help-08.png]]


# Change the height of the free-text block area (at the bottom of the page).
#Change the height of the space reserved for the free text block (at the bottom of the page).
# Change the font size of the free text.
#Change the font size of the free text.
# Display the signature of the assigned representative in the public note block.
#Display the signature of the representative in charge in the public note block.


[[File:Ultimatepdf_help-09.png|800px|link=Special:FilePath/Ultimatepdf_help-09.png]]
[[File:Ultimatepdf_help-09.png|800px|link=Special:FilePath/Ultimatepdf_help-09.png]]


# Configure the footer text color.
#Set the footer text colour.
#Set the footer background colour <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">22.0+</span>
 


Now don't forget to select your template by clicking the icon in the top right menu.
Now do not forget to select your template by clicking the icon in the top right menu.


[[File:Ultimatepdf_docu_002.png|800px|link=Special:FilePath/Ultimatepdf_docu_002.png]]
[[File:Ultimatepdf_docu_002.png|800px|link=Special:FilePath/Ultimatepdf_docu_002.png]]


Select the template from the dropdown list.
Select the template in the drop-down list.


Online training: [[http://www.youtube.com/watch?v=bw3a08poCmU]] (based on an older template, but the principles remain the same)
Online training: [http://www.youtube.com/watch?v=bw3a08poCmU YouTube video] (based on an old template, but the principles remain the same)


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Options Tab==
==Options tab==
See the [[Options Tab]] page.


[[File:Ultimatepdf_docu_003.png|800px|link=Special:FilePath/Ultimatepdf_docu_003.png]]
[[File:Ultimatepdf_docu_003.png|800px|link=Special:FilePath/Ultimatepdf_docu_003.png]]


You can manage the following features here:
Here you can manage the following features:


'''Address block construction rules''':
'''Rules for building the address areas''':


- Hide the alternate logo.
* Hide the other logo.
- Hide your company logo.
* Hide your company logo.
- Use the contact's company name in the delivery address.
* Use the contact's company name in the delivery address.
- Add the public note to the source address block.
* Add the public note in the sender address area.
- Display phone, fax and email when a contact address is used.
* Display your company note (Setup > Company/Organization) under the sender address <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>
- Use a contact's company name in the document.
* Hide the label printed before the sales representative's name in the sender block <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.8+</span>
- Hide the intra-community VAT number in address blocks.
* Display phone, fax and e-mail details when a contact address is used.
- Display professional ID in addresses - Prof. ID 1 (SIREN) - Source address
* Use a contact's company name in the document.
- Display professional ID in addresses - Prof. ID 2 (SIRET) - Source address
* Hide the intra-community VAT number in the address blocks.
- Display professional ID in addresses - Prof. ID 3 (NAF-APE) - Source address
* Display the professional IDs in the addresses - Prof. ID 1 to 5 (SIREN, SIRET, NAF-APE, RCS/RM, EORI number) - Sender address
- Display professional ID in addresses - Prof. ID 4 (RCS/RM) - Source address
* Display the professional IDs in the addresses - Prof. ID 1 to 5 (SIREN, SIRET, NAF-APE, RCS/RM, EORI number) - Third-party address
- Display professional ID in addresses - Prof. ID 5 (EORI number) - Source address
- Display professional ID in addresses - Prof. ID 1 (SIREN) - Third-party address
- Display professional ID in addresses - Prof. ID 2 (SIRET) - Third-party address
- Display professional ID in addresses - Prof. ID 3 (NAF-APE) - Third-party address
- Display professional ID in addresses - Prof. ID 4 (RCS/RM) - Third-party address
- Display professional ID in addresses - Prof. ID 5 (EORI number) - Third-party address


[[File:Ultimatepdf_help-6-02.png|800px|link=Special:FilePath/Ultimatepdf_help-6-02.png]]
[[File:Ultimatepdf_help-6-02.png|800px|link=Special:FilePath/Ultimatepdf_help-6-02.png]]


You can manage the following features here:
Here you can manage the following features:


'''Column construction rules''':
'''Rules for building the columns''':


- Hide the long description in the description column.
* Hide the long description in the description column.
- Hide references in the description column.
* Hide the references in the description column.
- Hide all data in columns after the description (VAT, list price, Qty, Discount, Total).
* Hide all data in the columns after the description (VAT, public price, qty, discount, total).
- Display lines with amounts including tax by default.
* Display lines with an amount including tax by default.
- Hide only the VAT column, but display amounts in the total.
* Hide only the VAT column, but show the amounts in the total. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">23.0+</span>
- Hide pre-tax amounts.
* Hide the amounts excluding tax.
- Hide quantities.
* Hide the quantities.
- Hide VAT amounts.
* Hide the VAT amounts. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span>
- Enable the units column for products.
* Enable the unit column for products.
* Print the customs code and country of origin under the product description.


'''Miscellaneous settings'''
'''Miscellaneous settings'''
- Hide the bank account RIB section.
* Hide the bank details (RIB) part of the bank account.
- Use automatic line wrapping for the free-text footer.
* Automatic line wrapping of the footer free text.
[[File:Ultimatepdf_help-15.0.040bis.png|link=Special:FilePath/Ultimatepdf_help-15.0.040bis.png]]
[[File:Ultimatepdf_help-15.0.040bis.png|link=Special:FilePath/Ultimatepdf_help-15.0.040bis.png]]
- Add the ability to automatically attach your Terms & Conditions to PDF documents (invoices, quotes, orders).
* Automatically attach your terms and conditions to PDF documents (invoices, proposals, orders). <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span>
** "Show terms and conditions by default" option to preselect the terms and conditions file <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span>
** Terms and conditions are included automatically in generations that do not go through the "Generate" button (validation, mass actions, electronic invoice) <span style="background:#c05a1a;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0+</span>
[[File:Ultimatepdf_help-6-03.png|link=Special:FilePath/Ultimatepdf_help-6-03.png]]
[[File:Ultimatepdf_help-6-03.png|link=Special:FilePath/Ultimatepdf_help-6-03.png]]
* Renumber the pages of merged PDFs according to the final document pagination (enabled by default) <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>


'''Other options'''
'''Other options'''
- Display the third-party barcode at the bottom of your documents.
* Display the third-party barcode at the bottom of your documents.
- Default barcode type used for third parties.
* Default barcode type used for third parties.


'''Paper format'''
'''Paper format'''
- Paper format.
* Paper format.
 


'''Settings can now be configured independently for all document types'''
'''Settings can now be made independently for each document type'''


- Add a dashed line between product/service lines.
* Add a dotted line between product/service lines.
- Display a folding mark at one-third of the page.
* Display a fold mark at one third of the page.
- Display product photo thumbnails in your Proposals.
* Display product picture thumbnails in your proposals.
- Display product photo thumbnails in your Orders.
* Display product picture thumbnails in your orders.
- Display product photo thumbnails in your Invoices.
* Display product picture thumbnails in your invoices.
- Do not repeat the header on multi-page documents.
* Do not repeat the header when there are several pages.
- Display an alternate logo instead of the company logo.
* Display another logo than the company logo.
- Display a background image on your documents.
* Display a background image on your documents.
- Display the "Approved" signature block.
* Display the "Agreement" block.
- Display the signature of the assigned representative in the public note block.
* Display the signature of the representative in charge in the public note block.
- Hide the bank account RIB section.
* Hide the bank details (RIB) part of the bank account.
- Display the third-party barcode in Proposals, Orders, Shipments and Invoices.
* Display the third-party barcode in proposals, orders, shipments and invoices.
- Display the third-party QR code in Proposals, Orders, Invoices and Shipments.
* Display the third-party QR code in proposals, orders, invoices and shipments.
- Display the mention: "Reverse charge – subcontracting scheme".
** Only one QR code at a time at the top of the document: enabling a second one is refused with a warning <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.2+</span>
- Show or hide the LS and LR columns on shipping slips.
* Display the mention "Reverse charge - subcontracting scheme" (French auto-liquidation).
- Add and merge one or more PDFs into your Proposals, Invoices or Orders.
* Show or hide the LS and LR columns on shipping slips.
- Add a custom line using dictionaries and extra fields in your Proposals, Invoices or Orders.
* Add and merge one or more PDFs into your proposals, invoices or orders.
- Choose which bank account to display on invoices.
* Add a custom line using dictionaries and extrafields in your proposals, invoices or orders.
** Substitution variables (<code>__EXTRAFIELD_*__</code>, object properties) are resolved in this line <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>
* Choose the bank account displayed on invoices.
* Display the document date as text <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span> (proposals, invoices, supplier orders; other documents <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">20.0+</span> / <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">21.0+</span>)
* Support for the native Subtotals module (title and subtotal lines) in proposals and orders <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Commercial Proposals Tab==
==Commercial proposals tab==


[[File:model_10.png|960px|link=Special:FilePath/model_10.png]]
[[File:model_10.png|960px|link=Special:FilePath/model_10.png]]


==Rules for Address Section Content==
===Rules for the content of the address sections===
 
- Display phone, fax and email when a contact address is used.


- Display the sales representative following the proposal.
* Display phone, fax and e-mail details when a contact address is used.
 
* Display the sales representative following the proposal <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">17.0+</span>
- Display customer phone, fax and email.
* Display the customer's phone, fax and e-mail.
 
* Hide the sender details in the address block.
- Hide source details in the address block.
* Hide the intra-community VAT number in the address blocks.
 
- Hide intra-community VAT display in address blocks.


[[File:model_11.png|960px|link=Special:FilePath/model_11.png]]
[[File:model_11.png|960px|link=Special:FilePath/model_11.png]]


==Miscellaneous Settings==
===Miscellaneous settings===
 
- Enter the target bank account for the commercial proposal.
 
- Display product barcodes in commercial proposals.


- Display the third-party barcode at the top of your proposals.
* Enter the target bank account on the commercial proposal.
 
* Display product barcodes in commercial proposals.
- Display the third-party QR code at the top of your proposals.
* Display the third-party barcode at the top of your commercial proposals.
 
* Display the third-party QR code at the top of your commercial proposals.
- Display your company QR code at the top of your proposals.
* Display your company QR code at the top of your commercial proposals.
 
* Display the project title in your commercial proposal.
- Display the project title in your commercial proposal.
* Display the project reference in the commercial proposal.
 
* Display linked objects in your proposal <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">15.0+</span>
- Display the project reference in the commercial proposal.
* Do not repeat the header when there are several pages.
 
* Manage versions of your commercial proposals: [https://www.doliweb.com/comm/propal/card.php?id=506&action=confirm_validate&confirm=yes&token=3953f896e38e82e3e1ed291aaf3c40bb example]
- Display linked objects in your proposal.
* Display a barcode for each product line: [https://www.doliweb.com/comm/propal/card.php?id=506&action=confirm_validate&confirm=yes&token=3953f896e38e82e3e1ed291aaf3c40bb example]
 
* Display an "electronic signature": [https://www.doliweb.com/public/onlinesign/newonlinesign.php?ref=PR2210-0171&source=proposal&message=signed&securekey=7b30ad6f3d9c994063423777c96e66b5 example]
- Do not repeat the header on multi-page documents.
 
- Manage versions of your commercial proposals.
 
- Settings can now be configured independently for commercial proposals.
 
- Display barcode for each product line: [https://www.doliweb.com/comm/propal/card.php?id=506&action=confirm_validate&confirm=yes&token=3953f896e38e82e3e1ed291aaf3c40bb example]
 
- Display an "electronic signature": [https://www.doliweb.com/public/onlinesign/newonlinesign.php?ref=PR2210-0171&source=proposal&message=signed&securekey=7b30ad6f3d9c994063423777c96e66b5 example]
 
- Manage versions of your commercial proposals: [https://www.doliweb.com/comm/propal/card.php?id=506&action=confirm_validate&confirm=yes&token=3953f896e38e82e3e1ed291aaf3c40bb example]


[[File:model_12.png|960px|link=Special:FilePath/model_12.png]]
[[File:model_12.png|960px|link=Special:FilePath/model_12.png]]


==Sub-menu Configuration==
===Sub-menu settings===
- Display the date in text format.
* Display the date as text <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span>
 
* Hide the customer code sub-menu <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span>
- Hide the customer code sub-menu.
* Hide the customer reference sub-menu <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span>
* Hide the availability sub-menu <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span>
* Hide the delivery date sub-menu <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span>
* Hide the sales representative sub-menu <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">21.0+</span>


- Hide the customer reference sub-menu.
<i class="fas fa-exclamation-triangle"></i> The position of the sub-menus is recalculated automatically according to how many are shown or hidden.
 
- Hide the availability sub-menu.
 
- Hide the delivery date sub-menu.
 
- Hide the sales representative sub-menu.
 
<i class="fas fa-exclamation-triangle"></i> Sub-menu positions are automatically recalculated based on how many are shown or hidden.


[[File:model_13.png|960px|link=Special:FilePath/model_13.png]]
[[File:model_13.png|960px|link=Special:FilePath/model_13.png]]


==Document Body Configuration==
===Document body settings===
 
- Add a dashed line between product/service lines.
 
- Display a folding mark at one-third of the page to facilitate mailing.
 
- Hide the long description in the description column.


- Allow data to flow onto the previous page if the description is long enough.
* Add a dotted line between product/service lines.
 
* Display a fold mark at one third of the page to ease mailing.
- Display the signature of the assigned representative in the public note block.
* Hide the long description in the description column <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">20.0+</span> (effective from <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>)
 
* Allow data to be displayed on the previous page if the description is long enough.
- Add "Case handled by" in the public note block.
* Display the signature of the representative in charge in the public note block.
 
* Add "Case followed by" in the public note block.
- Display the line numbering column.
* Display the line numbering column.
 
* Display product picture thumbnails in your proposals.
- Display product photo thumbnails in your Proposals.
* Display the unit price excluding tax column in commercial proposals.
 
* Display the discount column in commercial proposals.
- Display the unit price excluding tax column in commercial proposals.
* Display the unit price after discount column in commercial proposals.
 
* Display the quantity column in commercial proposals.
- Display the discount column in commercial proposals.
* Display the weight column in commercial proposals.
 
- Display the unit price after discount column in commercial proposals.
 
- Display the quantity column in commercial proposals.
 
- Display the weight column in commercial proposals.


[[File:model_14.png|960px|link=Special:FilePath/model_14.png]]
[[File:model_14.png|960px|link=Special:FilePath/model_14.png]]


==Footer Configuration==
===Footer settings===


- Display the total weight in the Total block.
* Display the total weight in the Total block.
* Display the "Agreement" block.
* Use Dolibarr's online electronic signature in the "Agreement" block <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">20.0+</span>
* Add the signature of the person in charge at the bottom of commercial proposals.
* Display the reverse charge (subcontracting) mention on proposals.
* Add one or more introduction pages <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">15.0+</span>
* Merge PDFs attached directly to products into the commercial proposal.
* Attach PDF files to the commercial proposal by merging.


- Display the "Approved" signature block.
- Add the manager's signature at the bottom of commercial proposals.
- Display "Reverse charge – subcontracting scheme" on proposals.
- Add one or more introduction pages.
- Merge PDFs directly linked to products in the commercial proposal.
- Attach PDF files by merging them into the commercial proposal.


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Orders Tab==
==Orders tab==


- Settings can now be configured independently for orders.
* Settings can now be made independently for orders.


[[File:model_15.png|960px|link=Special:FilePath/model_15.png]]
[[File:model_15.png|960px|link=Special:FilePath/model_15.png]]


==Rules for Address Section Content==
===Rules for the content of the address sections===


- Display phone, fax and email when a contact address is used.
* Display phone, fax and e-mail details when a contact address is used.
 
* Display the customer's phone, fax and e-mail.
- Display customer phone, fax and email.
* Display the sales representative following the order <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>
 
* Hide the sender details in the address block.
- Hide source details in the address block.
* Hide the intra-community VAT number in the address blocks.
 
- Hide intra-community VAT display in address blocks.


[[File:model_16.png|960px|link=Special:FilePath/model_16.png]]
[[File:model_16.png|960px|link=Special:FilePath/model_16.png]]


==Miscellaneous Settings==
===Miscellaneous settings===
 
- Display product barcodes in orders.
 
- Display the third-party barcode at the top of your orders.
 
- Display the third-party QR code at the top of your orders.
 
- Display the order QR code at the top of your orders.
 
- Display your company QR code at the top of your orders.
 
- Display project references in orders.


- Display project titles in orders.
* Display product barcodes in orders.
 
* Display the third-party barcode at the top of your orders.
- Do not repeat the header on multi-page documents.
* Display the third-party QR code at the top of your orders.
* Display the order QR code at the top of your orders.
* Display your company QR code at the top of your orders.
* Display the project reference in orders <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">15.0+</span>
* Display the project title in orders.
* Do not repeat the header when there are several pages.
* Hide all prices (picking slip: quantities and weights kept) <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span>
* Hide the long description in the description column <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">19.0+</span>
* Add the signature of the person in charge at the bottom of orders <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Invoices Tab==
==Invoices tab==


[[File:Ultimatepdf_help-6-06.png|link=Special:FilePath/Ultimatepdf_help-6-06.png]]
[[File:Ultimatepdf_help-6-06.png|link=Special:FilePath/Ultimatepdf_help-6-06.png]]


- Settings can now be configured independently for invoices.
* Settings can now be made independently for invoices.
* Display the "Reverse charge - subcontracting scheme" line on your invoices.
* Enable the situation invoices feature.
* Hide amounts already paid on invoices.
* Add the signature of the person in charge at the bottom of invoices. <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>
* Display the outstanding amount in the document.
* Display the remainder to pay excluding tax <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">23.0+</span>
* Convert amounts and figures into words.
* Attach PDF files to the invoice by merging.
* Display the project reference and title <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span> (the title is actually printed from <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.4+</span>)
* Summarise the objects linked to the invoiced order, and list the shipments of that order <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.4+</span>
* Add the Swiss QR-bill (standardised payment part on a dedicated page; requires PHP 8.1 and the bcmath extension) <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>
* Display deposits in the invoice footer, before the remainder to pay, whatever the deposit management mode <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.8+</span> / <span style="background:#c05a1a;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0+</span>
* Free positioning of the address blocks and DIN 5008 sender line: see [[#Template configuration|Template configuration]] <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>


- Display the "Reverse charge – subcontracting scheme" line on your invoices.
'''Electronic invoicing (Factur-X / PDF/A-3)''' <span style="background:#c05a1a;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0+</span>
* The ultimate_invoice template produces an invoice from which an electronic invoicing module (einvoicing, facturx) builds a Factur-X compliant with PDF/A-3b, terms and conditions included.
* Prerequisite: in '''Home > Setup > PDF''', set "PDF documents format" to '''PDF/A-3b'''. A warning is shown on the invoice setup page until this is done.
* French reform mentions: the customer SIREN is added to the recipient block when both sender and customer are French companies; the operation category is printed under the lines.
* Designs using transparency remain compliant with PDF/A-2 and PDF/A-3.


- Enable the progress billing feature.
''[[#Table of Contents|⬆ Back to top]]''


- Hide already paid amounts on invoices.
==Shipments tab==


- Add the manager's signature at the bottom of invoices.
[[File:Ultimatepdf_help-6-07.png|link=Special:FilePath/Ultimatepdf_help-6-07.png]]


- Display the outstanding balance amount in the document.
* Settings can now be made independently for shipments.
 
* Display the project reference <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">21.0+</span>
- Add the ability to convert amounts and numbers to text.
* Display the total weight <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span>
 
* Shipping warehouse column (Stock module enabled) <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>
- Attach PDF files by merging them into the invoice.
* Signature of the person in charge, merging of attached PDFs <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Shipments Tab==
==Delivery notes tab==
 
[[File:Ultimatepdf_help-6-07.png|link=Special:FilePath/Ultimatepdf_help-6-07.png]]


- Settings can now be configured independently for shipments.
* Settings can now be made independently for delivery notes <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">15.0+</span>
* Ordered quantity, shipped quantity, remainder, unit price, weight and picture thumbnail columns <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">15.0+</span>
* "Agreement" block <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">15.0+</span>
* Project reference and title, signature of the person in charge, merging of attached PDFs <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Receipts Tab==
==Receptions tab==


[[File:Ultimatepdf_help-6-08.png|link=Special:FilePath/Ultimatepdf_help-6-08.png]]
[[File:Ultimatepdf_help-6-08.png|link=Special:FilePath/Ultimatepdf_help-6-08.png]]


- Settings can now be configured independently for Delivery Receipts.
* Settings can now be made independently for receptions.
* Display product barcodes <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">19.0+</span>
* Display the received quantity column <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">22.0+</span>
* Project reference and title, signature of the person in charge, merging of attached PDFs <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Supplier Orders Tab==
==Supplier orders tab==


[[File:Ultimatepdf_help-6-09.png|link=Special:FilePath/Ultimatepdf_help-6-09.png]]
[[File:Ultimatepdf_help-6-09.png|link=Special:FilePath/Ultimatepdf_help-6-09.png]]


- Settings can now be configured independently for Supplier Orders.
* Settings can now be made independently for supplier orders.
* Hide your company logo <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">22.0+</span>
* Signature of the person in charge <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>
* Weight column and total weight <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Supplier Invoices Tab==
==Supplier invoices tab==


[[File:Ultimatepdf_help-6-10.png|link=Special:FilePath/Ultimatepdf_help-6-10.png]]
[[File:Ultimatepdf_help-6-10.png|link=Special:FilePath/Ultimatepdf_help-6-10.png]]


- Settings can now be configured independently for supplier invoices.
* Settings can now be made independently for supplier invoices.
* Project reference and title <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">17.0+</span>
* Merging of attached PDFs <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">17.0+</span>
* Reverse charge mention, signature of the person in charge <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Price Requests Tab==
==Price requests tab==


[[File:Ultimatepdf_help-6-11.png|link=Special:FilePath/Ultimatepdf_help-6-11.png]]
[[File:Ultimatepdf_help-6-11.png|link=Special:FilePath/Ultimatepdf_help-6-11.png]]


- Settings can now be configured independently for Price Requests.
* Settings can now be made independently for price requests.
* Project reference and title <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">17.0+</span>
* Unit price, discount, price after discount, quantity, weight and picture thumbnail columns <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">18.0+</span>
* "Agreement" block <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>
* QR codes and barcode at the top of the document, reverse charge mention, signature of the person in charge <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Contracts Tab==
==Contracts tab==


[[File:Ultimatepdf_help-6-12.png|link=Special:FilePath/Ultimatepdf_help-6-12.png]]
[[File:Ultimatepdf_help-6-12.png|link=Special:FilePath/Ultimatepdf_help-6-12.png]]


- Settings can now be configured independently for contracts.
* Settings can now be made independently for contracts.
* Planned and actual start and end dates, picture thumbnails, hide all prices <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">17.0+</span>
* Weight column and total weight, sales representative following the contract <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">21.0+</span>
* Reverse charge mention <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Expense Reports Tab==
==Expense reports tab==


[[File:Ultimatepdf_help-6-13.png|link=Special:FilePath/Ultimatepdf_help-6-13.png]]
[[File:Ultimatepdf_help-6-13.png|link=Special:FilePath/Ultimatepdf_help-6-13.png]]


- Settings can now be configured independently for Expense Reports.
* Settings can now be made independently for expense reports.
* QR codes and barcode at the top of the document <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">21.0+</span>
* Date, expense type and project columns; merging of attached PDFs; approval frame with the approver's signature <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>
* Free entry of amounts excluding and including tax, display of the effective VAT rate and of the real unit price excluding tax <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Interventions Tab==
==Interventions tab==


[[File:Ultimatepdf_help-6-14.png|link=Special:FilePath/Ultimatepdf_help-6-14.png]]
[[File:Ultimatepdf_help-6-14.png|link=Special:FilePath/Ultimatepdf_help-6-14.png]]


- Settings can now be configured independently for Interventions.
* Settings can now be made independently for interventions.
* Date without time <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span> (effective from <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>)
* Signature of the person in charge <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>
* "Agreement" block <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>
* '''Assigned resources (Resources module)''' <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>: printing of the assigned vehicles, equipment or rooms (with picture), display on the card, assignment button, mileage carried over to the vehicle, availability check.
* Sales representative following the intervention <span style="background:#6b6b6b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0.3</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Projects Tab==
==Projects tab==


[[File:Ultimatepdf_help-13-15.png|link=Special:FilePath/Ultimatepdf_help-13-15.png]]
[[File:Ultimatepdf_help-13-15.png|link=Special:FilePath/Ultimatepdf_help-13-15.png]]


- Settings can now be configured independently for Projects.
* Settings can now be made independently for projects.


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==Products Tab==
==Products tab==


[[File:Ultimatepdf_help-15-16.png|link=Special:FilePath/Ultimatepdf_help-15-16.png]]
[[File:Ultimatepdf_help-15-16.png|link=Special:FilePath/Ultimatepdf_help-15-16.png]]


- Settings can now be configured independently for Products.
* Settings can now be made independently for products.
* Background image or PDF specific to product sheets <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">19.0+</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


==BOMs Tab==
==BOMs tab==


[[File:Ultimatepdf help-15 17.png|link=link=Special:FilePath/Ultimatepdf_help-15-17.png|alt=]]
[[File:Ultimatepdf_help-15-17.png|link=Special:FilePath/Ultimatepdf_help-15-17.png]]


- Settings can now be configured independently for BOMs.
* Settings can now be made independently for BOMs <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">15.0+</span>
* Cost column <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">16.0+</span>


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''


=Usage=
=Usage=
Easy to use — in just a few clicks your documents reflect your brand colors, and each of your team members can have their own personalized documents.
Easy to use: in a few clicks your documents take on your colours, and each of your employees can have personalised documents.


Despite all its features, if UltimatePDF does not allow you to create a highly specialized document template, you can contact us to have it built with custom development: [mailto:contact@atoo-net.com email me]
If, despite all its features, UltimatePDF does not let you build a very specialised document template, you can ask us to develop it: [mailto:contact@atoo-net.com email me]


=Compatibility and Synergies=
=Compatibility and synergies=


UltimatePDF is compatible with:
UltimatePDF is compatible with:
- The Milestone module
* The Milestone module
- The MBI Signature module
* The MBI Signature module
- The Sales and Purchase Unit Management module (displays results in a units column across all templates)
* The sales and purchase units management module (results shown in a unit column on all templates)
- The Incoterm module
* The Incoterm module
- Progress billing management.
* Situation invoices.
* The native Subtotals module <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.1+</span>
* The native Resources module (interventions) <span style="background:#1f6f8b;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">24.0.5+</span>
* The einvoicing and facturx electronic invoicing modules (Factur-X PDF/A-3b) <span style="background:#c05a1a;color:#fff;border-radius:3px;padding:0 5px;font-size:85%;white-space:nowrap">25.0+</span>
 
=What's new by version=
Summary of the main new features. The full details are in the ChangeLog shipped with the module.


=Development=
{| class="wikitable"
UltimatePDF is a module maintained on the Framasoft Git:
! Version !! Main new features
https://git.framasoft.org/grandoc/ultimatepdf
|-
| '''25.0.3''' ''(upcoming)'' || Template export/import as JSON and "Ardoise & Cuivre" sample template; real PDF preview in template setup; column title text colour computed automatically; accordion setup pages; signature of the person in charge, PDF merging, project, reverse charge and follow-up sales representative extended to shipments, deliveries, receptions and supplier documents; weight column on supplier orders.
|-
| '''25.0.2''' || Fix of the total including tax rounding.
|-
| '''25.0.1''' || DIN 5008 sender line; <code>MAIN_INVERT_SENDER_RECIPIENT</code> honoured.
|-
| '''25.0.0''' || Dolibarr 25 and PHP 8.4/8.5 compatibility (PHP 8.2 minimum); Factur-X / PDF/A-3 electronic invoice; customer SIREN and operation category (French reform); terms and conditions included automatically; deposits in the invoice footer.
|-
| '''24.0.11''' || DIN 5008 sender line.
|-
| '''24.0.9''' || Template switch working under Dolibarr 23.
|-
| '''24.0.8''' || Expanding address frames; maskable sales representative label; deposits in the invoice footer.
|-
| '''24.0.6''' || Fix of the VAT on situation invoices.
|-
| '''24.0.5''' || Swiss QR-bill; free positioning of address blocks and "Frameless" style; assigned resources on interventions; free entry excluding/including tax on expense reports; tooltips on every option; company note under the sender.
|-
| '''24.0.4''' || Linked objects and shipments of the order on invoices.
|-
| '''24.0.2''' || Only one QR code at the top of the document, with a warning.
|-
| '''24.0.1''' || Reworked acceptance report; native Subtotals module; footer logo band; signature of the person in charge on invoices, interventions and supplier orders; column settings in tabs; richer expense reports; renumbering of merged PDFs; warehouse column on shipments.
|-
| '''24.0.0''' || Built-in user guide in 5 languages.
|-
| '''23.0''' || Documents without VAT column; remainder to pay excluding tax; minimum table height.
|-
| '''22.0''' || Footer background colour; received quantity column; logo can be hidden on supplier orders.
|-
| '''21.0''' || Full-width banner; Qualibat logo; QR codes on expense reports; weight on contracts; date as text everywhere.
|-
| '''20.0''' || Online electronic signature of proposals; custom first page; long description can be hidden.
|-
| '''19.0''' || Background specific to product sheets; product barcode on receptions; background image transparency.
|-
| '''18.0''' || Attached terms and conditions; date as text; pro forma and acceptance report templates; price request columns; maskable sub-menus.
|-
| '''17.0''' || Richer contracts; PDF merging on supplier invoices; capital / legal form / intra-community VAT aliases.
|-
| '''16.0''' || Settings specific to each template; title background colour; logo size; column widths.
|-
| '''15.0''' || Bill of materials (BOM) template; delivery note options; presentation pages.
|}


''[[#Table of Contents|⬆ Back to top]]''
''[[#Table of Contents|⬆ Back to top]]''

Latest revision as of 10:56, 25 September 2026

Table of Contents

Information


Module name UltimatePDF
Editor / Editeur Logo atoonet.jpg
Download or buy page / Page achat ou téléchargement External module - www.dolistore.com
Status / Statut / Estado Stable
Prerequisites / Prérequis PHP 8.2 minimum for UltimatePDF 25

Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore

Last update date / Date mise à jour fiche / Fecha última actualización 2026-09-25
Note / Nota ⬆ Back to top

Features

The true Swiss Army knife with over 100 blades! that lets you customize your PDF documents to match your company's visual identity. You can choose:

  • The colour of the font, borders and frame backgrounds.
  • The style of the outlines (solid or dashed).

Adds many features to documents:

  • Concatenation of PDF documents on every document type (terms and conditions, data sheets...).
  • Independent reference column.
  • Line numbering column.
  • Independent picture column.
  • "Agreement" signature and stamp block.
  • Currency symbols displayed after amounts.
  • Bill of exchange (LCR) for invoices.
  • Factur-X / PDF/A-3 electronic invoice compliant with the French e-invoicing reform 25.0+
  • Swiss QR-bill 24.0.5+
  • And much more....

⬆ Back to top

Reading the version badges

Every feature added after UltimatePDF 14.0 carries a badge showing the first version of the module that offers it. It remains available in all later versions.

Badge Meaning
(no badge) Feature available since UltimatePDF 14.0 or earlier: present in every maintained version.
18.0+ Available from UltimatePDF 18.0 (hence for Dolibarr 18 and later).
24.0.5+ Available from maintenance release 24.0.5: update the module if you run 24.0.0 to 24.0.4.
25.0+ New in the 25 branch (Dolibarr 25).
25.0.3 Developed, released with the upcoming version 25.0.3.

A feature added during a branch may exist on two branches maintained in parallel; the badge then shows both versions, for example "24.0.11+ / 25.0.1+".

⬆ Back to top

Prerequisites

Dolibarr: supported versions:

UltimatePDF Dolibarr Minimum PHP Latest version
25.x 25.x 8.2 25.0.2
24.x 24.x 7.1 24.0.11
23.x 23.x 7.2 23.0.7
22.x 22.x 7.1 22.0.13
21.x 21.x 7.1 21.0.5
20.x 20.x 7.1 20.0.5

Each UltimatePDF version matches the same Dolibarr version: UltimatePDF 25 → Dolibarr 25, UltimatePDF 24 → Dolibarr 24, and so on. Always install the module branch carrying the same number as your Dolibarr.

UltimatePDF 25 requires PHP 8.2: the bundled libraries (QR codes) do not load under PHP 8.1. It is tested under PHP 8.4 and 8.5.

⬆ Back to top

⚙️ Installation procedure

Three methods are available, from the simplest to the most technical. The UltimatePDF zip weighs about 3.5 MB: before using the Dolibarr interface, check that your installation accepts a file of that size (see below).

⚙️ Method 1: installation from the Dolibarr interface

  1. Go to Home > Setup > Modules/Applications.
  2. Open the Deploy/install external app/module tab.
  3. Click Choose file and select the module .zip file.
  4. Click Upload to start the installation.
  5. Enable the module once the installation is complete.

Checking the maximum upload size

Three limits apply to the zip upload, and the smallest one wins:

Limit Where to see / change it Common value
Dolibarr limit (MAIN_UPLOAD_DOC) Home > Setup > Security, Files tab, "Maximum size for uploaded files" (in KB) 2048 KB (Dolibarr installation value)
upload_max_filesize (PHP) server php.ini file 2M (PHP default)
post_max_size (PHP) server php.ini file 8M

How to find the current values:

  • On the Deploy/install external app/module page, hover the information icon to the right of the Upload button: Dolibarr displays "Dolibarr limit: X Kb, PHP limit: Y Kb".
  • The PHP settings are detailed in Admin Tools > About PHP (page admin/system/phpinfo.php): look for upload_max_filesize and post_max_size.

If one of the limits is below the zip size, Dolibarr rejects the file with the message "File size is too large or file not provided".

How to raise them:

  1. Dolibarr limit: in Home > Setup > Security, Files tab, enter for example 10240 (10 MB) and save.
  2. PHP limits: in php.ini (or your hosting control panel: Plesk, cPanel, "PHP settings"…), set for example:
upload_max_filesize = 10M
post_max_size = 12M
post_max_size must stay greater than or equal to upload_max_filesize. Then restart the web server or PHP-FPM (not needed with most hosting providers, which apply the change immediately) and check the new values in About PHP.

On shared hosting, PHP limits cannot always be changed. In that case, use method 2 or 3.

⚙️ Method 2: manual installation on the server (SSH)

The zip contains an htdocs/ultimatepdf/ folder; it is the ultimatepdf folder that must end up in the Dolibarr custom directory.

  1. Copy the zip to the server, for example into /tmp.
  2. Unzip: unzip module_ultimatepdf-X.Y.Z.zip -d /tmp/ultimatepdf_zip
  3. Copy the module folder: cp -r /tmp/ultimatepdf_zip/htdocs/ultimatepdf /path/to/dolibarr/htdocs/custom/
  4. Give ownership to the web server if needed, for example: chown -R www-data:www-data /path/to/dolibarr/htdocs/custom/ultimatepdf
  5. Check that the module location is: htdocs/custom/ultimatepdf (and not htdocs/custom/htdocs/ultimatepdf).
  6. Enable the module from Dolibarr.

⚙️ Method 3: FTP / SFTP upload (last resort)

If you can neither upload files in Dolibarr nor access the server through SSH:

  1. Unzip the archive on your computer (right click > "Extract All…" on Windows).
  2. Open the extracted folder: it contains htdocs, which itself contains the ultimatepdf folder.
  3. Connect to the server with an FTP/SFTP client (for example FileZilla), using the credentials supplied by your hosting provider.
  4. Find the Dolibarr directory: it is the one containing the admin, core, conf… and custom folders. Depending on the provider, it is named htdocs, httpdocs, www or public_html. If custom does not exist, create it.
  5. Upload the ultimatepdf folder (not the zip, nor the surrounding htdocs folder) into custom.
  6. Wait for the transfer to finish and check in the FTP client log that no file failed: the module has more than 1,000 files, and an interrupted transfer leaves an incomplete module.
  7. Check that the final path is …/custom/ultimatepdf/core/modules/modUltimatepdf.class.php.
  8. Enable the module from Home > Setup > Modules/Applications.

To update through FTP, replace the existing ultimatepdf folder (after backing it up), then disable and re-enable the module to apply any database changes. Your templates and settings, stored in the database, are kept.

✅ The module is now up and running! ⬆ Back to top

⚙️ Configuration

To use this module, you must first enable it. After logging in with an administrator account:

  1. Go to Home > Setup > Modules/Applications.
  2. In the Base modules / Multi-modules tools section, find UltimatePDF.
  3. Click the activation button.
  4. A pictogram appears at the end of the module line. Click it to open the settings.

Once enabled, the module provides several document templates in Dolibarr:

Supported document templates

  • ultimate_propal: commercial proposals.
  • ultimate_order: customer orders.
  • ultimate_proforma: pro forma invoices, from a customer order 18.0+
  • PV_reception: works acceptance report, from a customer order, with signature frames and reservation boxes 18.0+ (fully reworked in 24.0.1+)
  • ultimate_invoice: invoices.
  • ultimate_shipment: shipping slips.
  • ultimate_delivery: delivery notes.
  • ultimate_receipt: receptions (goods received from suppliers).
  • ultimate_supplierproposal: supplier price requests.
  • ultimate_supplierorder: supplier orders.
  • ultimate_supplierinvoice: supplier invoices.
  • ultimate_contract: contracts and subscriptions.
  • ultimate_inter: intervention sheets.
  • ultimate_project: project reports.
  • ultimate_expensereport: expense reports.
  • ultimate_product: product sheets.
  • ultimate_bom: bills of materials (BOM module) 15.0+

✅ Once enabled, the module is immediately operational in Dolibarr.

Quick access

You can reach the module configuration from its dedicated menu in Dolibarr. If you need help, click the "?" button at the top right of the interface.

  • A complete user guide is built into the module, in the Guide tab of its setup, in French, English, German, Spanish and Italian 24.0+
  • Every option on the setup pages has a tooltip describing its actual effect on the PDF, its dependencies and its limits 24.0.5+
  • The setup pages are organised in collapsible sections (accordion) 25.0.3

--- ⬆ Back to top

Ultimatepdf docu 001.png

Template configuration

The module's own setup page:

Model 01.png

The module's setup page has several tabs:

  • Templates tab

Here you can create and edit your templates (also called "designs"):

  1. Fill in the label field to name your template.
  2. Give your template a description so you can find it easily (My blue template with VAT and references).
  3. You can use another font than the one set in the language file, for example "DejaVuSans". Personally, I like Raleway and Roboto.

( Warning: some exotic fonts cause problems displaying currencies; also, do not forget to select one, otherwise the system crashes)

  1. Display a background image on your templates.
  2. Remember to set the transparency of the background image, as it may hide some areas of the document. 19.0+
  3. Position the image with its X and Y coordinates.
  4. You can use a PDF as document background. ( ! Warning: the behaviour is sometimes erratic, for example it applies to every other page...)

Several templates, one per employee or per use 16.0+: each template keeps its own colours, fonts, logos, margins and column widths, and you switch from one to another without re-entering anything.

Export and import a template 25.0.3: a template can be downloaded as a JSON file and imported into another Dolibarr installation. An import always creates a new, inactive template and never overwrites or replaces the template in use. A sample template, "Ardoise & Cuivre" (Slate & Copper), ships with the module.

Real PDF preview 25.0.3: the template edit page shows an actual PDF generated with the settings being entered, even before saving them.

Model 02.png

( Info: a new layout with a full-width banner is now available) 21.0+

Model 03.png

Model 04.png

You can use another logo than your company's (for themed subsidiaries, for example).

  1. Hide the other logo without deleting it, and so display your company logo.
  2. Hide your company logo and show only the company name, or use the other logo across the full page width.
  3. Set the width and height of the company logo and of the other logo 16.0+
  4. Display the Qualibat logo in the footer of PDF documents 21.0+
  5. Display a logo band in the footer 24.0.1+

Model 05.png

You can change the sender company details.

  • Sender name, address, zip code, town, country, phone, fax, e-mail and website.
  • Sender capital, legal form, intra-community VAT number and SIRET 17.0+

Model 06.png

Model 07.png

Model 08.png

  1. Upload an image (A4 page size) to display as the first page of a commercial proposal; it is added to the list of preset pages offered to you, and you then need to select it. 20.0+
  2. Use the colour picker for the background colour of the address blocks.
  3. Use the colour picker for the background colour of the column titles. 16.0+
  4. The text colour of the column titles is computed automatically (black or white) from the contrast with the chosen background colour, as in the Eldy theme: titles stay readable on a dark background. 25.0.3
  5. Use the colour picker for the border colour.
  6. Use the colour picker for the text colour.
  7. Use the colour picker for the QR code colour.
  8. Show or hide the background colour of each address block independently.
  9. "Frameless" style for the address blocks: no background and no border 24.0.5+
  10. Set the border line style (dashed or solid).
  11. Set the transparency of the background colour.
  12. Set the corner radius (rounded or square corners).
  13. Show or hide the VAT column and amounts.
  14. Swap the sender/recipient address blocks. As long as the option has never been saved, the native Dolibarr constant MAIN_INVERT_SENDER_RECIPIENT is honoured 24.0.11+ / 25.0.1+
  15. Free positioning of the address blocks, in millimetres, for foreign window envelopes, with a "Swiss window envelope" button (invoice template) 24.0.5+
  16. Compact sender line above the recipient, German/Austrian DIN 5008 standard (invoice template) 24.0.11+ / 25.0.1+
  17. Address frames grow automatically when the address, contact, VAT and professional IDs do not fit in the usual height 24.0.8+
  18. Show or hide the column borders.
  19. Set the margins of your documents.

Model 09.png

The column settings are grouped in tabs 24.0.1+

Ultimatepdf help-04.png

  1. Set the width of the line numbering column.
  2. Show or hide the reference column.
  3. Set the width of the reference column. 16.0+

Ultimatepdf help-05.png

  1. Set the width of the description column.
  2. Set the width of the picture column.

Ultimatepdf help-06.png

  1. Set the width of the VAT column. 16.0+
  2. Set the width of the unit price column. 16.0+

Ultimatepdf help-07.png

  1. Set the width of the quantity column. 16.0+
  2. Set the width of the unit column.
  3. Set the width of the discount column. 16.0+
  4. Set the width of the weight and weight/volume columns, and of the line barcode. 24.0.1+

Ultimatepdf help-08.png

  1. Change the height of the space reserved for the free text block (at the bottom of the page).
  2. Change the font size of the free text.
  3. Display the signature of the representative in charge in the public note block.

Ultimatepdf help-09.png

  1. Set the footer text colour.
  2. Set the footer background colour 22.0+


Now do not forget to select your template by clicking the icon in the top right menu.

Ultimatepdf docu 002.png

Select the template in the drop-down list.

Online training: YouTube video (based on an old template, but the principles remain the same)

⬆ Back to top

Options tab

Ultimatepdf docu 003.png

Here you can manage the following features:

Rules for building the address areas:

  • Hide the other logo.
  • Hide your company logo.
  • Use the contact's company name in the delivery address.
  • Add the public note in the sender address area.
  • Display your company note (Setup > Company/Organization) under the sender address 24.0.5+
  • Hide the label printed before the sales representative's name in the sender block 24.0.8+
  • Display phone, fax and e-mail details when a contact address is used.
  • Use a contact's company name in the document.
  • Hide the intra-community VAT number in the address blocks.
  • Display the professional IDs in the addresses - Prof. ID 1 to 5 (SIREN, SIRET, NAF-APE, RCS/RM, EORI number) - Sender address
  • Display the professional IDs in the addresses - Prof. ID 1 to 5 (SIREN, SIRET, NAF-APE, RCS/RM, EORI number) - Third-party address

Ultimatepdf help-6-02.png

Here you can manage the following features:

Rules for building the columns:

  • Hide the long description in the description column.
  • Hide the references in the description column.
  • Hide all data in the columns after the description (VAT, public price, qty, discount, total).
  • Display lines with an amount including tax by default.
  • Hide only the VAT column, but show the amounts in the total. 23.0+
  • Hide the amounts excluding tax.
  • Hide the quantities.
  • Hide the VAT amounts. 16.0+
  • Enable the unit column for products.
  • Print the customs code and country of origin under the product description.

Miscellaneous settings

  • Hide the bank details (RIB) part of the bank account.
  • Automatic line wrapping of the footer free text.

Ultimatepdf help-15.0.040bis.png

  • Automatically attach your terms and conditions to PDF documents (invoices, proposals, orders). 18.0+
    • "Show terms and conditions by default" option to preselect the terms and conditions file 18.0+
    • Terms and conditions are included automatically in generations that do not go through the "Generate" button (validation, mass actions, electronic invoice) 25.0+

Ultimatepdf help-6-03.png

  • Renumber the pages of merged PDFs according to the final document pagination (enabled by default) 24.0.1+

Other options

  • Display the third-party barcode at the bottom of your documents.
  • Default barcode type used for third parties.

Paper format

  • Paper format.


Settings can now be made independently for each document type

  • Add a dotted line between product/service lines.
  • Display a fold mark at one third of the page.
  • Display product picture thumbnails in your proposals.
  • Display product picture thumbnails in your orders.
  • Display product picture thumbnails in your invoices.
  • Do not repeat the header when there are several pages.
  • Display another logo than the company logo.
  • Display a background image on your documents.
  • Display the "Agreement" block.
  • Display the signature of the representative in charge in the public note block.
  • Hide the bank details (RIB) part of the bank account.
  • Display the third-party barcode in proposals, orders, shipments and invoices.
  • Display the third-party QR code in proposals, orders, invoices and shipments.
    • Only one QR code at a time at the top of the document: enabling a second one is refused with a warning 24.0.2+
  • Display the mention "Reverse charge - subcontracting scheme" (French auto-liquidation).
  • Show or hide the LS and LR columns on shipping slips.
  • Add and merge one or more PDFs into your proposals, invoices or orders.
  • Add a custom line using dictionaries and extrafields in your proposals, invoices or orders.
    • Substitution variables (__EXTRAFIELD_*__, object properties) are resolved in this line 24.0.1+
  • Choose the bank account displayed on invoices.
  • Display the document date as text 18.0+ (proposals, invoices, supplier orders; other documents 20.0+ / 21.0+)
  • Support for the native Subtotals module (title and subtotal lines) in proposals and orders 24.0.1+

⬆ Back to top

Commercial proposals tab

Model 10.png

Rules for the content of the address sections

  • Display phone, fax and e-mail details when a contact address is used.
  • Display the sales representative following the proposal 17.0+
  • Display the customer's phone, fax and e-mail.
  • Hide the sender details in the address block.
  • Hide the intra-community VAT number in the address blocks.

Model 11.png

Miscellaneous settings

  • Enter the target bank account on the commercial proposal.
  • Display product barcodes in commercial proposals.
  • Display the third-party barcode at the top of your commercial proposals.
  • Display the third-party QR code at the top of your commercial proposals.
  • Display your company QR code at the top of your commercial proposals.
  • Display the project title in your commercial proposal.
  • Display the project reference in the commercial proposal.
  • Display linked objects in your proposal 15.0+
  • Do not repeat the header when there are several pages.
  • Manage versions of your commercial proposals: example
  • Display a barcode for each product line: example
  • Display an "electronic signature": example

Model 12.png

Sub-menu settings

  • Display the date as text 18.0+
  • Hide the customer code sub-menu 18.0+
  • Hide the customer reference sub-menu 18.0+
  • Hide the availability sub-menu 18.0+
  • Hide the delivery date sub-menu 18.0+
  • Hide the sales representative sub-menu 21.0+

The position of the sub-menus is recalculated automatically according to how many are shown or hidden.

Model 13.png

Document body settings

  • Add a dotted line between product/service lines.
  • Display a fold mark at one third of the page to ease mailing.
  • Hide the long description in the description column 20.0+ (effective from 24.0.5+)
  • Allow data to be displayed on the previous page if the description is long enough.
  • Display the signature of the representative in charge in the public note block.
  • Add "Case followed by" in the public note block.
  • Display the line numbering column.
  • Display product picture thumbnails in your proposals.
  • Display the unit price excluding tax column in commercial proposals.
  • Display the discount column in commercial proposals.
  • Display the unit price after discount column in commercial proposals.
  • Display the quantity column in commercial proposals.
  • Display the weight column in commercial proposals.

Model 14.png

Footer settings

  • Display the total weight in the Total block.
  • Display the "Agreement" block.
  • Use Dolibarr's online electronic signature in the "Agreement" block 20.0+
  • Add the signature of the person in charge at the bottom of commercial proposals.
  • Display the reverse charge (subcontracting) mention on proposals.
  • Add one or more introduction pages 15.0+
  • Merge PDFs attached directly to products into the commercial proposal.
  • Attach PDF files to the commercial proposal by merging.


⬆ Back to top

Orders tab

  • Settings can now be made independently for orders.

Model 15.png

Rules for the content of the address sections

  • Display phone, fax and e-mail details when a contact address is used.
  • Display the customer's phone, fax and e-mail.
  • Display the sales representative following the order 25.0.3
  • Hide the sender details in the address block.
  • Hide the intra-community VAT number in the address blocks.

Model 16.png

Miscellaneous settings

  • Display product barcodes in orders.
  • Display the third-party barcode at the top of your orders.
  • Display the third-party QR code at the top of your orders.
  • Display the order QR code at the top of your orders.
  • Display your company QR code at the top of your orders.
  • Display the project reference in orders 15.0+
  • Display the project title in orders.
  • Do not repeat the header when there are several pages.
  • Hide all prices (picking slip: quantities and weights kept) 16.0+
  • Hide the long description in the description column 19.0+
  • Add the signature of the person in charge at the bottom of orders 25.0.3

⬆ Back to top

Invoices tab

Ultimatepdf help-6-06.png

  • Settings can now be made independently for invoices.
  • Display the "Reverse charge - subcontracting scheme" line on your invoices.
  • Enable the situation invoices feature.
  • Hide amounts already paid on invoices.
  • Add the signature of the person in charge at the bottom of invoices. 24.0.1+
  • Display the outstanding amount in the document.
  • Display the remainder to pay excluding tax 23.0+
  • Convert amounts and figures into words.
  • Attach PDF files to the invoice by merging.
  • Display the project reference and title 18.0+ (the title is actually printed from 24.0.4+)
  • Summarise the objects linked to the invoiced order, and list the shipments of that order 24.0.4+
  • Add the Swiss QR-bill (standardised payment part on a dedicated page; requires PHP 8.1 and the bcmath extension) 24.0.5+
  • Display deposits in the invoice footer, before the remainder to pay, whatever the deposit management mode 24.0.8+ / 25.0+
  • Free positioning of the address blocks and DIN 5008 sender line: see Template configuration 24.0.5+

Electronic invoicing (Factur-X / PDF/A-3) 25.0+

  • The ultimate_invoice template produces an invoice from which an electronic invoicing module (einvoicing, facturx) builds a Factur-X compliant with PDF/A-3b, terms and conditions included.
  • Prerequisite: in Home > Setup > PDF, set "PDF documents format" to PDF/A-3b. A warning is shown on the invoice setup page until this is done.
  • French reform mentions: the customer SIREN is added to the recipient block when both sender and customer are French companies; the operation category is printed under the lines.
  • Designs using transparency remain compliant with PDF/A-2 and PDF/A-3.

⬆ Back to top

Shipments tab

Ultimatepdf help-6-07.png

  • Settings can now be made independently for shipments.
  • Display the project reference 21.0+
  • Display the total weight 18.0+
  • Shipping warehouse column (Stock module enabled) 24.0.1+
  • Signature of the person in charge, merging of attached PDFs 25.0.3

⬆ Back to top

Delivery notes tab

  • Settings can now be made independently for delivery notes 15.0+
  • Ordered quantity, shipped quantity, remainder, unit price, weight and picture thumbnail columns 15.0+
  • "Agreement" block 15.0+
  • Project reference and title, signature of the person in charge, merging of attached PDFs 25.0.3

⬆ Back to top

Receptions tab

Ultimatepdf help-6-08.png

  • Settings can now be made independently for receptions.
  • Display product barcodes 19.0+
  • Display the received quantity column 22.0+
  • Project reference and title, signature of the person in charge, merging of attached PDFs 25.0.3

⬆ Back to top

Supplier orders tab

Ultimatepdf help-6-09.png

  • Settings can now be made independently for supplier orders.
  • Hide your company logo 22.0+
  • Signature of the person in charge 24.0.1+
  • Weight column and total weight 25.0.3

⬆ Back to top

Supplier invoices tab

Ultimatepdf help-6-10.png

  • Settings can now be made independently for supplier invoices.
  • Project reference and title 17.0+
  • Merging of attached PDFs 17.0+
  • Reverse charge mention, signature of the person in charge 25.0.3

⬆ Back to top

Price requests tab

Ultimatepdf help-6-11.png

  • Settings can now be made independently for price requests.
  • Project reference and title 17.0+
  • Unit price, discount, price after discount, quantity, weight and picture thumbnail columns 18.0+
  • "Agreement" block 24.0.1+
  • QR codes and barcode at the top of the document, reverse charge mention, signature of the person in charge 25.0.3

⬆ Back to top

Contracts tab

Ultimatepdf help-6-12.png

  • Settings can now be made independently for contracts.
  • Planned and actual start and end dates, picture thumbnails, hide all prices 17.0+
  • Weight column and total weight, sales representative following the contract 21.0+
  • Reverse charge mention 25.0.3

⬆ Back to top

Expense reports tab

Ultimatepdf help-6-13.png

  • Settings can now be made independently for expense reports.
  • QR codes and barcode at the top of the document 21.0+
  • Date, expense type and project columns; merging of attached PDFs; approval frame with the approver's signature 24.0.1+
  • Free entry of amounts excluding and including tax, display of the effective VAT rate and of the real unit price excluding tax 24.0.5+

⬆ Back to top

Interventions tab

Ultimatepdf help-6-14.png

  • Settings can now be made independently for interventions.
  • Date without time 16.0+ (effective from 24.0.5+)
  • Signature of the person in charge 24.0.1+
  • "Agreement" block 24.0.1+
  • Assigned resources (Resources module) 24.0.5+: printing of the assigned vehicles, equipment or rooms (with picture), display on the card, assignment button, mileage carried over to the vehicle, availability check.
  • Sales representative following the intervention 25.0.3

⬆ Back to top

Projects tab

Ultimatepdf help-13-15.png

  • Settings can now be made independently for projects.

⬆ Back to top

Products tab

Ultimatepdf help-15-16.png

  • Settings can now be made independently for products.
  • Background image or PDF specific to product sheets 19.0+

⬆ Back to top

BOMs tab

File:Ultimatepdf help-15-17.png

  • Settings can now be made independently for BOMs 15.0+
  • Cost column 16.0+

⬆ Back to top

Usage

Easy to use: in a few clicks your documents take on your colours, and each of your employees can have personalised documents.

If, despite all its features, UltimatePDF does not let you build a very specialised document template, you can ask us to develop it: email me

Compatibility and synergies

UltimatePDF is compatible with:

  • The Milestone module
  • The MBI Signature module
  • The sales and purchase units management module (results shown in a unit column on all templates)
  • The Incoterm module
  • Situation invoices.
  • The native Subtotals module 24.0.1+
  • The native Resources module (interventions) 24.0.5+
  • The einvoicing and facturx electronic invoicing modules (Factur-X PDF/A-3b) 25.0+

What's new by version

Summary of the main new features. The full details are in the ChangeLog shipped with the module.

Version Main new features
25.0.3 (upcoming) Template export/import as JSON and "Ardoise & Cuivre" sample template; real PDF preview in template setup; column title text colour computed automatically; accordion setup pages; signature of the person in charge, PDF merging, project, reverse charge and follow-up sales representative extended to shipments, deliveries, receptions and supplier documents; weight column on supplier orders.
25.0.2 Fix of the total including tax rounding.
25.0.1 DIN 5008 sender line; MAIN_INVERT_SENDER_RECIPIENT honoured.
25.0.0 Dolibarr 25 and PHP 8.4/8.5 compatibility (PHP 8.2 minimum); Factur-X / PDF/A-3 electronic invoice; customer SIREN and operation category (French reform); terms and conditions included automatically; deposits in the invoice footer.
24.0.11 DIN 5008 sender line.
24.0.9 Template switch working under Dolibarr 23.
24.0.8 Expanding address frames; maskable sales representative label; deposits in the invoice footer.
24.0.6 Fix of the VAT on situation invoices.
24.0.5 Swiss QR-bill; free positioning of address blocks and "Frameless" style; assigned resources on interventions; free entry excluding/including tax on expense reports; tooltips on every option; company note under the sender.
24.0.4 Linked objects and shipments of the order on invoices.
24.0.2 Only one QR code at the top of the document, with a warning.
24.0.1 Reworked acceptance report; native Subtotals module; footer logo band; signature of the person in charge on invoices, interventions and supplier orders; column settings in tabs; richer expense reports; renumbering of merged PDFs; warehouse column on shipments.
24.0.0 Built-in user guide in 5 languages.
23.0 Documents without VAT column; remainder to pay excluding tax; minimum table height.
22.0 Footer background colour; received quantity column; logo can be hidden on supplier orders.
21.0 Full-width banner; Qualibat logo; QR codes on expense reports; weight on contracts; date as text everywhere.
20.0 Online electronic signature of proposals; custom first page; long description can be hidden.
19.0 Background specific to product sheets; product barcode on receptions; background image transparency.
18.0 Attached terms and conditions; date as text; pro forma and acceptance report templates; price request columns; maskable sub-menus.
17.0 Richer contracts; PDF merging on supplier invoices; capital / legal form / intra-community VAT aliases.
16.0 Settings specific to each template; title background colour; logo size; column widths.
15.0 Bill of materials (BOM) template; delivery note options; presentation pages.

⬆ Back to top