darvis/ubl-peppol
Un paquet PHP qui crée des factures et des notes de crédit UBL 2.1 selon PEPPOL BIS Billing 3.0 et EN 16931. Avec les règles néerlandaises et belges, un contrôle du numéro de TVA via VIES et une connexion Laravel optionnelle.
<Invoice xmlns="urn:oasis:...:Invoice-2"> <cbc:CustomizationID>urn:cen.eu:en16931:2017 #compliant#urn:fdc:peppol.eu:2017:poacc :billing:3.0</cbc:CustomizationID> <cbc:ID>INV-2026-001</cbc:ID> <cbc:IssueDate>2026-01-15</cbc:IssueDate> <cac:TaxTotal> <cbc:TaxAmount currencyID="EUR">89.25</cbc:TaxAmount> </cac:TaxTotal> ... </Invoice>
Vous avez déjà vos données de facturation, dans une base de données, un ERP ou une boutique en ligne. Ce paquet les transforme en un document XML accepté par un destinataire PEPPOL. Vous transmettez vos données au builder, le paquet écrit le XML.
Vous découvrez Peppol ? Lisez d'abord ce qu'est Peppol et comment fonctionne le réseau, ou contactez-nous si vous souhaitez de l'aide pour votre intégration.
Un enum avec les neuf catégories de TVA autorisées par PEPPOL, qui explique quand utiliser chacune et quel motif d'exonération s'y rattache. validate() contrôle désormais aussi ce que chaque catégorie exige.
Importez ou collez une facture ou une note de crédit UBL, puis lancez le contrôle selon les règles officielles EN 16931 et PEPPOL BIS Billing 3.0. Tout s'exécute dans votre navigateur, rien n'est envoyé.
Depuis la version 1.10, le builder néerlandais crée aussi des notes de crédit, avec une référence à la facture que vous corrigez.
Créez un builder, ajoutez l'entête, les parties, le paiement, la TVA, les totaux et les lignes, et le builder écrit le XML pour vous.
Avec validateFirst: true, vous savez avant l'envoi s'il manque quelque chose.
use Darvis\UblPeppol\UblNlBis3Service;
$ubl = new UblNlBis3Service();
$ubl->createDocument();
$ubl->addInvoiceHeader('INV-2026-001', '2026-01-15', '2026-02-14');
$ubl->addBuyerReference('CLIENT-001');
$ubl->addAccountingSupplierParty(/* votre entreprise */);
$ubl->addAccountingCustomerParty(/* votre client */);
$ubl->addPaymentMeans('30', 'Credit transfer', 'INV-2026-001', 'NL91ABNA0417164300');
$ubl->addTaxTotal([/* TVA par catégorie */]);
$ubl->addLegalMonetaryTotal([/* totaux */], 'EUR');
$ubl->addInvoiceLine([/* ligne de facture */]);
// Throws an InvalidArgumentException when validate() finds an error.
$xml = $ubl->generateXml(validateFirst: true);Depuis le 1er janvier 2026, les entreprises belges doivent se facturer électroniquement. Peppol en est le canal par défaut.
Le gouvernement néerlandais veut rendre la facturation électronique entre entreprises obligatoire à partir du 1er juillet 2030. En vous connectant maintenant, vous serez prêt à temps.
Avec ViDA arrivent la déclaration numérique de la TVA et la facture électronique pour le commerce transfrontalier entre entreprises.
Non. Le paquet n'est pas un point d'accès. PEPPOL est un réseau fermé que vous atteignez via un prestataire de point d'accès avec lequel vous avez un contrat. Dans Laravel, PeppolService envoie le XML à l'API de ce prestataire, avec PEPPOL_URL, PEPPOL_USERNAME et PEPPOL_PASSWORD de votre .env.
Choisissez le builder selon le pays du destinataire. UblNlBis3Service place automatiquement les éléments dans le bon ordre et contrôle les règles néerlandaises. UblBeBis3Service additionne les lignes pour vous avec calculateTotals() et vérifie que les montants sont corrects. Les deux créent des notes de crédit.
Non. validate() ne modifie rien à votre document et contrôle les règles que le paquet connaît. Un destinataire en contrôle davantage. Passez donc un document dans un validateur officiel avant la mise en production, par exemple le validateur en ligne de la documentation.
PHP 8.2 ou plus récent avec les extensions dom et libxml. Pour contrôler un IBAN, il faut bcmath, et pour VIES l'extension soap. Laravel 11, 12 ou 13 n'est nécessaire que pour la couche Laravel optionnelle.
Rien. Le paquet est gratuit et publié sous licence MIT. Vous pouvez l'utiliser dans des projets commerciaux.