Peppol 1.4.0 (V18 - V24)

Electronic invoicing is becoming mandatory, country after country, and the Peppol network is the channel that carries it. This module connects your Dolibarr to that network: your customer invoices leave in the UBL format your administration and your customers expect, and your supplier invoices land straight in Dolibarr.

Customer invoices go out on their own

• The UBL XML file, compliant with Peppol BIS Billing 3.0, is built when the invoice is validated, next to the PDF
• One click sends it to your access point from the invoice, or a mass action sends a batch from the list
• A scheduled job can send validated invoices on its own, with nothing to do every day
• The PDF is embedded in the XML file: your customer receives the readable invoice and the structured one as a single document
• Automatic email to the customer once the invoice has been transmitted, should you want it

Supplier invoices come into Dolibarr

• Invoices waiting on your access point are fetched, with their PDF and their XML
• The supplier invoice is created and attached to the right thirdparty
• A wrong invoice is rejected from Dolibarr itself, with its reason
• Batch import to process in one go what arrived while you were away

Nothing goes out broken

• Compliance check before sending: VAT number, addresses, rounding, identifiers, mandatory mentions
• Complete dictionary of the VAT exemption codes (VATEX) of the European directive, filled automatically from the invoice context
• Document tracking in a dedicated tab on every invoice: what left, what was accepted, what was rejected
• Peppol directory lookup to find and assign your customers' identifier without leaving their record

Your access point, your choice

The module does not lock you into one operator: it talks to Acube, B2Brouter, Billit, Codabox, eInvoice.be, Falco, Iopole, Peppyrus, Scrada and SuperPDP. How far each integration goes varies by provider, and the current state of each one is kept up to date in the online documentation.

Requirements

• A contract with a Peppol access point provider: that subscription is separate from buying the module
• The Dolibarr modules Thirdparties, Customer invoices, Suppliers, Bank, Products and Services

Every feature is detailed in the online documentation: doc.cap-rel.fr/peppol

What the purchase covers

• The module, and access to its updates for the period stated on this sheet
• Bug fixes, including the ones you report
• An email on every new release

To be told automatically about new versions, of this module and of the Dolibarr ecosystem at large, subscribe on dolinews.com: that is where our release announcements are published.

Support

Support goes through our support form, not through the comments on this sheet.

Support is not free. You want competent people on the other side: it is fair that they are paid for that time. The price shown covers the module and its updates. It covers neither installing nor configuring your Dolibarr, nor training your teams, nor specific developments, nor investigating an environment we do not host.

A reproducible bug in the module is fixed at no charge, as part of the updates above.

Before buying

• Check the Dolibarr and PHP versions stated at the top of this sheet: beyond them, the module is not tested
• Modules are deployed from Home > Setup > Modules > Deploy an external module, which requires an active custom directory on your installation
• When a module relies on an online service, the subscription to that service is separate from buying the module, and is stated above

Publisher

Module developed by CAP-REL, under the GPL-3.0-or-later licence. Online documentation at doc.cap-rel.fr.

Version history

1.4.0 -- 2026-10-06

• Register a payment on a private individual invoice without it being silently dropped
• Require Dolibarr 18 and PHP 7.4: stay on 1.2.142 to keep running on Dolibarr 15 to 17
• Ship an archive free of development dependencies (568 KB instead of 284 MB)
• Show the module icon in the top menu
• Read the module description in French in the module list

1.2.142 -- 2025-09-02

• change handle pdf orientation pages in case of mix (landscape / portrait)

1.2.140 -- 2025-08-25

• add start / stop dates if exists in BG-26 BT-134/BT-135

1.2.138 -- 2025-06-16

• use thirdparty address in case of missing fields on invoice contact

1.2.136 -- 2025-05-30

• better batch import

1.2.134 -- 2025-05-18

• update fields thanks to Taha (ulusoft)
• update SuperPDP support (used by cap-rel to send and get invoices)

1.2.132 -- 2025-05-08

• fix superpdp send / get invoices in production

1.2.128 -- 2025-05-06

• add missing directories into zip
• fix race condition on payment without iban informations like credit cards
• fix race condition on payment for non peppol target customers
• fix column display on dolibarr 19+

1.2.124 -- 2025-04-27

• new setup option for companies with secondary vat number

1.2.123 -- 2025-04-27

• fix payment on some sort of invoices

1.2.122 -- 2025-04-13

• Other solution for pre-paid in case of you made a prepaid invoice without VAT and final invoice with VAT
• error was [BR-S-06]-In a Document level allowance (BG-20) where the Document level allowance VAT category
• code (BT-95) is "Standard rated" the Document level allowance VAT rate (BT-96) shall be greater than zero.
• Now your pre-paiement is used as a global deduction amount.
• Better support for Billit Thanks to Wim R. again !
• Fix onboarding on SuperPDP

1.2.120 -- 2025-03-27

• Fix BR-S-06: Document level allowance with category S must have rate > 0

1.2.118 -- 2025-03-16

• new VATEX list
• update superpdp access point api
• change credit note to positive values

1.2.116 -- 2025-03-06

• change line ref with a line number
• add memcached support for text translations

1.2.112 -- 2025-03-04

• display error details on peppol status page (ok for peppyrus AP)
• split send peppol files auto mail address for outgoing AND incoming files (with different mails)

1.2.110 -- 2025-03-04

• auto clean vat number (seller and buyer)
• add a new option in setup module to embed others files linked to invoice (xlsx, png, jpg, ods, csv)
• better fix for unavailable peppol directory (remote error 500)

1.2.106 -- 2025-03-03

• better batch import with scaninvoices
• better support for iopole AP
• new support for b2brouter AP
• do not display peppol messages on public pages (payment / one page basket e-shop...)
• add all pdf in one "big pdf" file embeded
• put main invoice pdf in first position into XML

1.2.104 -- 2025-02-11

• Add BT-30 even if this field is not mandatory, some customers seems to have a different point
• of view
• Start of FALCO support as Peppol Access Point

1.2.102 -- 2025-02-02

• Code cleanup
• Better finder search results

1.2.101 -- 2025-01-29

• Fix peppol finder url on button (do not use dol_buildpath in that case)

1.2.100 -- 2025-01-28

• Fix buyer name (i hope) in case of billing contact (more debugs dedicated to that point)
• Fix peppol finder url

1.2.99 -- 2025-01-27

• Better support for API requests (full classmap on autoloader)
• Add filter on thirdpart then people can view only documents for their suppliers
• Add annotations on peppol import then copy that annotation to private note or label on supplier invoice
• Exclude TE_PRIVATE from process
• New admin page to find and apply peppol id on missing companies
• Add new options on auto send invoices via cron tasks
• Code quality: add automatic tests on invoices made via api requests
• Add multi entity support for imported peppol files

1.2.98 -- 2025-01-15

• New page to list all outbound invoices with your peppol ap status (see in customer invoices menu)
• Fix unit prices with more than 2 decimal digits precision
• Fix vatex rules displayed on ODT files
• Fix lines with empty description
• Add more tests coverage for races conditions customers found
• Add new solution to make auto-links with scaninvoices imported invoices (no need double clic)
• Note : you must desactivate then reactivate your peppol module after upgrade

1.2.95 -- 2026-01-14

• Empty description for a line

1.2.94 -- 2026-01-09

• Fix email empty or " " for contacts linked to an invoice
• Better ICD filter in action, doc updated
• Better solution for invoices VATEX type O with no VAT

1.2.90 -- 2026-01-08

• Fix display text on PDF for peppol_vat_exemption extrafield
• Fix display text on ODT for peppol_vat_exemption extrafield
• Fix race condition on sending file

1.2.88 -- 2026-01-08

• Fix for more than 100 supplier invoices on peppyrus
• Add a column on customer invoices to add peppol status
• Better filter for file to send popup (formconfirm) only peppol file will be displayed
• Fix translations (all languages)
• New option to send notification by email to customer
• Add BR-O-02 rules (vatex)
• Mass action to transfert supplier invoices PIM to real dolibarr supplier invoices

1.2.86 -- 2026-01-06

• Contribution for Billit AP thanks To Wim R. (reception is now ok)
• Better log message (debug)
• Try to fix import more than 100 invoiecs from scrada AP
• Fix cron task
• Add mandate payement support "Mandate reference MUST be provided for direct debit"
• Fix generate xml file on invoies build via rest requests

1.2.82 -- 2026-01-04

• Fix odt >> pdf with "remove odt file as soon as pdf is created"

1.2.81 -- 2026-01-02

• Better search on peppol directory index
• Add checkbox to update thirdpart name if differs

1.2.79 -- 2025-12-31

• Check on empty fields (XML)
• Add full list of VATEX
• Don't forget to reload your module after update !
• Change unit price to use dolibarr settings MAIN_MAX_DECIMALS_UNIT
• Add unit tests and real tests with real customer feedback
• Fix html entities into xml
• Fix cron job
• Fix 100+ doc on peppyrus (and maybe scrada)
• Fix a php_self warning on check.php

1.2.72 -- 2025-12-29

• Better logs on find xml file to use
• Fix supplier ref on import
• Add tests (phpunit)
• Fix codabox definition public function checkThirdparty(\Societe $thirdpart)

1.2.70 -- 2025-12-26

• Update default ref to "NA" as required by peppol thanks to Arnaud V.
• https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-OrderReference/

1.2.69 -- 2025-12-22

• Better search algo dedicated to NL people :)

1.2.68 -- 2025-12-21

• Fix typo on search engine (peppol directory index)

1.2.67 -- 2025-12-19

• Fix use of custom peppol_order_ref field value thanks to Bart "oeil de lynx" :)
• New option into module setup to embed all other pdf files linked to invoice
• Add idprof1 in search for peppol id for - i hope - a solution for NL people and KVK entry
• (re) Fix cron job please disable / enable the module to get that fix
• Exclude non ICD code from peppol directory search
• Fix use sellerIdentifyer as priority (from module setup)

1.2.63 -- 2025-12-19

• Fix use of custom peppol_order_ref field value thanks to Bart "oeil de lynx" :)
• New option into module setup to embed all other pdf files linked to invoice

1.2.61 -- 2025-12-18

• New option on setup to apply a default reference in case of you don't have
• order reference neither customer order reference (we MUST provide one of them)

1.2.60 -- 2025-12-18

• Fix race condition with empty fk_user_creat on file import from AP
• Fix errors on XML for order Ref fields
• Fix empty user on import invoices
• Fix buyer or internal references
• Add warning message on top of invoices for thirdparty with no peppol id
• New cron system, please desactivate and reactivate the module to get it
• New option to make peppol send button enable even if the invoice was already sent
• Send mails in html (fix accents i hope)
• Fix date mic-mac (delivery date and invoice date)

1.2.58 -- 2025-12-15

• Add SuperPDP for fun (french people)
• Better fix for buyerReference (i hope)

1.2.57 -- 2025-12-15

• Add a new extrafield for delivery date needed on peppol invoices for some
• customers, please desactivate/reactivate your module to get that new extrafield
• Add a new extrafield for customer order reference -> encoded as PurchaseOrderReference
• New option for auto send peppol files to your AP thanks to cron tasks
• New mass action for sending more than one-by-one files on your peool AP
• Better code for peppol file linked to dolibarr objects (force index into ECM database)
• Better link with ScanInvoices
• Better multicompany support
• Fix auto detect file to send
• Fix odt was embedded into xml instead of pdf in case of odt template was used

1.2.53 -- 2025-12-12

• Peppyrus missing field on setup
• Fix remises nulles
• Add file into ECM database for "non ref" files names (from odt / custom names)

1.2.49 -- 2025-12-09

• Better search on peppol directory
• Fix unitprice on credit notes
• Better use of name/desc for free lines

1.2.47 -- 2025-12-08

• Remove peppol id from extrafields on cloned invoices
• Do not hide peppol buttons on payed bill (and other cases)
• Better check access point for Scrada (setup module)
• Update Peppol ID on sending files (scrada & peppyrus)
• Add peppol check process: track and check your peppol documents from dolibarr
• Full display history on invoice tab "peppol" dedicated page
• Fix search on tva intra with lowercases chars

1.2.45 -- 2025-12-03

• Update check on admin / setup page to avoid error

1.2.43 -- 2025-11-20

• Enhance codabox support (waiting for early users to try it)
• Try to fix a race condition on line unit price & quantities

1.2.42 -- 2025-11-17

• Avoid duplicates entries on files to import into dolibarr from peppol AP
• Add a check on XML files without PDF embedded part

1.2.41 -- 2025-11-05

• Handle PDF invoices files mades from ODT templates
• Add/Update Peppol tracking id into invoices extrafield after sent
• Import invoices thanks to ScanInvoices (need scaninvoices version >= 1.4.76)
• Update peppol id on customer invoice when sending invoice (peppyrus)
• Disable Send button in case of peppol id set

1.2.40 -- 2025-10-31

• Peppyrus send and get ok >> import to become
• Fix PeppolFinder target (module must be installed into /custom)
• Download xml & pdf from peppyrus ok, display pdf into dolibarr ok

1.2.37 -- 2025-10-24

• New peppyrus AP implementation started

1.2.36 -- 2025-10-23

• Add a PeppolFinder button on thirdparty
• Do not build xml on non validated invoice
• Use dol_sanitizeFileName on invoice ref to build xml file name & path
• Fix Tax Category O MUST be used when exemption reason code is VATEX-EU-O
• Fix do not add payment data if one key is empty
• New translation in nl (be) thanks to Patrick De Lange
• More debug to find some race conditions (vat cases)
• Fix error in case of no address of customer

1.2.30 -- 2025-10-17

• Put logs into database (next step will be to display that list)
• New entry in tools / peppol_list.php to get all history / list
• Better log collect
• Add a new button on thirdpart card to search peppol id on directory (only on vat number for the moment)

1.2.27 -- 2025-10-11

• Fix error on peppol_tab
• Better support for non-vat situation

1.2.25 -- 2025-10-10

• Big step with e-invoice.be ready for tests !
• Update fix for invoices of private people (without vat) and force peppol file option is checked
• Better test against validy : check bank account informations only if payment is VIR
• Better non vat support : private people and non_vat specific thirdpart

1.2.23 -- 2025-10-02

• Massive code cleanup and factorizing
• Add new AP Peppol in the list: acube, billit, e-invoice.be et iopole
• Start of webhook implementation (debug mode required to help developper to do the job)
• Fix dolibarr 20+ icons (font awesome 5) - refresh supplier invoices

1.2.18 -- 2025-09-29

• Fix EndpointID of AccountingSupplierParty (inverted)
• Fix Content type on checkThirdparty
• Change setup to make dynamic list of Peppol AP then people have only to implement an ap-xxx.class.php file
• Better PEPPOL_FORCE_XML_WITH_VATNULL solution for private people customers

1.2.14 -- 2025-09-09

• Add download invoices from Scrada Peppol AP

1.2.12 -- 2025-07-29

• Add support of dolibarr 20/21 on auto build tests
• Fix peppol seller id priority if set
• Fix sql init on non llx_prefix tables
• Add a new card for dedicated tracking data from peppol AP

1.2.6 -- 2025-06-02

• Better messages on billing and delivery addresses
• Better hook handle for dolibarr 19+

1.2.4 -- 2025-05-23

• Add Buyer electronic address even if buyerIdent is set

1.2.3 -- 2025-05-22

• Fix peppol id displayed on invoices (read only and message)
• Remove check link on invoices peppol id
• Try to fix for buyer peppol id

1.2.2 -- 2025-05-16

• Peppol / Scrada send XML file in progress (tests)

1.2.0 -- 2025-01-28

• NEW: connect to Peppol AP (experimental)

For older releases, back to the first publication on 2021-12-27, see the full changelog on the "About" page of the module once it is installed.