Module PeppolConnect

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Module PeppolConnect

PeppolConnect est un module complémentaire pour Dolibarr ERP/CRM qui génère des factures et avoirs au format UBL Peppol BIS Billing 3.0, les valide localement avant envoi, puis les transmet via l'API du point d'accès Peppol de votre choix. Il reçoit également les factures fournisseurs arrivées par le réseau.

Cible principale : les entreprises belges (facturation électronique B2B obligatoire par Peppol depuis le 1er janvier 2026) et les échanges intra-UE sur le réseau Peppol.

Éditeur arcchester
Licence GPL v3
Compatibilité Dolibarr 18.0 à 24.x (activation vérifiée sur 18.0.5, 20.0.1 et 24.0.0)
PHP 7.4 minimum (extensions cURL et XML)
Dépendances Aucune (pas de Java, pas de Composer, pas de SDK)
Langues Français, anglais, néerlandais

Ce que le module n'est pas

PeppolConnect n'est pas un point d'accès Peppol : il ne parle ni AS4 ni SMP. Il prépare, contrôle, dépose et suit vos documents chez un prestataire certifié (Peppyrus, e-invoice.be, Scrada, B2Brouter, Storecove…), chez qui un abonnement peut être nécessaire.

En France, la conformité à la réforme de la facturation électronique passe par une Plateforme Agréée : ce module ne la remplace pas — voir Factur-X France et PA Transmission.

Fonctionnalités

  • Identifiants Peppol résolus automatiquement depuis la fiche société et les fiches tiers : numéro d'entreprise belge (schéma 0208, contrôle modulo 97), SIRET (0009), SIREN (0002), numéro de TVA par pays. Une surcharge reste possible par un champ « Identifiant Peppol » sur le tiers.
  • Génération UBL : facture (380), acompte (386) et avoir (381) avec référence à la facture d'origine ; remises de ligne et remises globales ; déduction d'acomptes ; ventilation de TVA par catégorie EN 16931 avec motifs d'exonération et codes VATEX ; moyens de paiement UNTDID 4461, IBAN et BIC.
  • Validation locale avant envoi : contrôle XSD, puis une quarantaine de règles EN 16931. La conformité est prouvée contre le Schematron officiel Peppol BIS Billing 3.0.
  • Comportement fail-closed : une donnée obligatoire manquante bloque la génération et affiche une erreur lisible (adresse client incomplète, identifiant non résolu, taux nul sans catégorie de TVA…). Aucun fichier partiel n'est produit.
  • Encart sur la fiche facture : destinataire Peppol résolu, statut du dernier document, boutons « Générer l'UBL » et « Télécharger ».
  • Suivi : page Documents Peppol avec bandeau de KPI, filtre par statut, téléchargement et envoi dès qu'un connecteur est configuré.
  • Réception des factures fournisseurs arrivées par le réseau, importées en brouillon.
  • Diagnostic dans l'onglet À propos : extensions PHP, table, identifiant émetteur, TVA de la société, prestataire, correspondance des taux de TVA.

Installation

  1. Décompresser l'archive pour obtenir le dossier peppolconnect/ et le copier dans htdocs/custom/ — ou installer le zip depuis Accueil → Configuration → Modules/Applications → Déployer/installer un module externe.
  2. Activer PeppolConnect (famille « Finance / Facturation »).

Configuration

Menu Configuration → Modules → PeppolConnect :

  • Prestataire (point d'accès), clé API, case « Environnement de test », identifiant émetteur.
  • Correspondance des taux de TVA avec les catégories EN 16931 — importable en un clic depuis le module Factur-X France s'il est installé.
  • Bouton « Tester la connexion » : le module affiche l'identifiant Peppol de votre participant tel que le prestataire le connaît.

Se connecter à Peppyrus (point d'accès, Belgique)

  1. Créer un compte sur customer.test.peppyrus.be (réseau de test) puis sur customer.peppyrus.be (production).
  2. Déclarer votre identifiant de participant et les types de documents « Peppol BIS Billing UBL Invoice V3 » et « Credit Note V3 ».
  3. Créer une clé API et la coller dans la configuration du module, en cochant « Environnement de test » tant que vous êtes sur le réseau de test.

Utilisation

  1. Valider une facture client : l'encart Peppol de la fiche indique le destinataire résolu et l'état du document.
  2. « Générer l'UBL » produit et valide le fichier ; en cas de donnée manquante, l'erreur nomme le champ Dolibarr à corriger.
  3. Depuis la page Documents Peppol, envoyer le document au point d'accès et suivre son statut.
  4. Les factures fournisseurs reçues par le réseau sont importées en brouillon, à contrôler puis valider.

État de la version 1.0.0

Génération et validation locales prouvées contre le Schematron officiel, connecteur Peppyrus (envoi, statuts, annuaire) et réception des factures fournisseurs. L'ensemble est couvert par 377 assertions exécutées hors ligne, et l'activation est vérifiée sur Dolibarr 18, 20 et 24. La validation sur le bac à sable Peppyrus en conditions réelles demande une clé d'API du prestataire.

Historique des versions

Version Apports principaux
1.0.0 Version initiale : génération UBL Peppol BIS Billing 3.0 (factures, acomptes, avoirs), validation XSD et EN 16931, connecteur Peppyrus, réception des factures fournisseurs, résolution des identifiants Peppol, FR/EN/NL

Support

Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_PeppolConnect&oldid=67200"