Prérequis, installation dans custom/, configuration, premier test et mise à jour. Commencez sur une copie de votre base.
Dolibarr 18 à 24 avec PHP 7.4 à 8.3 et les extensions DOM, libxml, mbstring, cURL et OpenSSL. Le module Factures actif, plus le module Fournisseurs pour la réception. Complétez la fiche Société : raison sociale, adresse complète, numéro de TVA et numéro d’entreprise ou SIRET. Ouvrez un compte chez Peppyrus ou Scrada, ou commencez en mode local.
Décompressez l’archive Dolistore dans le répertoire custom/ (custom/peppolconnect). Dans Accueil → Configuration → Modules/Applications, activez PeppolConnect. L’activation crée la table des documents, la table de la file d’envoi, quatre droits, le menu et trois tâches planifiées. Donnez aux utilisateurs les droits consulter, envoyer, relever et configurer selon leur rôle.
Depuis la configuration du module, ouvrez « Première connexion Peppol ». L’étape 1 contrôle la fiche Société ; l’étape 2 enregistre les identifiants du prestataire et teste la connexion ; l’étape 3 choisit une facture validée, contrôle son UBL et interroge l’annuaire sur le destinataire ; l’étape 4 transmet explicitement, dans l’environnement de test si la case est cochée.
Dans la configuration, complétez la correspondance des taux de TVA pour que les lignes à 0 % portent une catégorie d’exonération (K, E, AE, G, O…) et un motif, puis la correspondance des unités vers les codes UN/CEFACT. Le diagnostic les signale « À vérifier » tant qu’elles sont vides.
Sur une facture validée, cliquez « Générer l’UBL Peppol » puis « Transmettre ». L’encart doit afficher Transmis, puis Délivré après le passage de la tâche « PeppolConnect : rafraîchir les statuts » (toutes les 15 minutes) ou un rafraîchissement manuel. Un document rejeté affiche le rapport du prestataire dans l’encart.
Dans la section Réception, cochez la relève automatique, choisissez si un fournisseur inconnu est créé depuis l’UBL et indiquez l’e-mail de notification. Activez la tâche « PeppolConnectFetchInbox » (toutes les 30 minutes) ou cliquez « Relever la boîte de réception ». Les factures reçues doivent apparaître en factures fournisseurs brouillon avec l’UBL joint.
Facultatif : activez « Envoi automatique à la validation des factures » et la tâche « PeppolConnect : envoyer la file » avec un utilisateur autorisé à envoyer. Décochez ensuite l’environnement de test et collez la clé de production. Gardez le diagnostic au vert.
Sauvegardez la base, le répertoire des documents et la clé locale de chiffrement. Remplacez custom/peppolconnect par la nouvelle version, puis désactivez et réactivez le module pour créer les nouvelles tables, colonnes et tâches planifiées.
