View source for Module PeppolConnect

== 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.

{| class="wikitable"
|-
! É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 [[Module Factur-X France|Factur-X France]] et [[Module PA Transmission|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 ==

# Décompresser l'archive pour obtenir le dossier <code>peppolconnect/</code> et le copier dans <code>htdocs/custom/</code> — ou installer le zip depuis ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# 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) ===

# Créer un compte sur <code>customer.test.peppyrus.be</code> (réseau de test) puis sur <code>customer.peppyrus.be</code> (production).
# Déclarer votre identifiant de participant et les types de documents « Peppol BIS Billing UBL Invoice V3 » et « Credit Note V3 ».
# 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 ==

# Valider une facture client : l'encart Peppol de la fiche indique le destinataire résolu et l'état du document.
# '''« Générer l'UBL »''' produit et valide le fichier ; en cas de donnée manquante, l'erreur nomme le champ Dolibarr à corriger.
# Depuis la page ''Documents Peppol'', envoyer le document au point d'accès et suivre son statut.
# 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 ==

{| class="wikitable"
|-
! 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 ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]