Prérequis, installation dans custom/, configuration, premier test et mise à jour. Commencez sur une copie de votre base.
Dolibarr 18 à 24, PHP 7.4 à 8.3 avec les extensions cURL et JSON, le module Factures et Factur-X France installé, produisant un factur-x.xml à la validation. Pour la production : une application PISTE et un compte technique Chorus Pro, un jeton d’API Pennylane, ou l’adresse et la clé de votre contrat de plateforme. Testez sur une copie de votre base.
Téléchargez l’archive depuis Dolistore et décompressez-la dans custom/ (custom/pdptransmission). Dans Accueil → Configuration → Modules/Applications, activez PA Transmission. Ouvrez ensuite sa page de configuration : le bandeau d’état de préparation indique ce qui manque encore.
Laissez le connecteur sur Sandbox (simulateur intégré). Ouvrez une facture validée dont le fichier Factur-X existe et cliquez sur « Transmettre à la PA ». L’encart doit afficher « Transmise » et un identifiant commençant par SBX-. Cliquez sur « Rafraîchir le statut » jusqu’à « Acceptée », puis dépliez l’historique des événements.
Choisissez Chorus Pro et saisissez l’identifiant et le secret client PISTE ainsi que le login et le mot de passe du compte technique, en gardant d’abord l’interrupteur « Environnement sandbox » actif. Pour Pennylane, collez le jeton d’API généré dans Gestion → Paramètres → Connectivité → Développeurs (scopes e_invoices:all et customer_invoices:all). Pour Docaposte, Yooz ou PA REST, saisissez l’URL de l’API et la clé de votre contrat. Choisissez le fichier transmis : XML Factur-X ou PDF/A-3. Enregistrez.
Dans « Suivi automatique des statuts », activez la synchronisation, fixez la limite de factures par passe (50 par défaut) et l’ancienneté maximale en jours (30), puis cliquez sur « Exécuter maintenant » pour tester. Le module Travaux planifiés de Dolibarr doit être actif ; le lien « Gérer dans Tâches planifiées » ouvre la tâche.
Dans l’onglet À propos, chaque ligne du diagnostic doit être OK, sauf au plus un avertissement sur le connecteur Sandbox. Envoyez une vraie facture avec le connecteur choisi, vérifiez que le statut revient reçue puis acceptée, et lisez le motif en cas de refus. Activez seulement ensuite la « Transmission automatique ».
Remplacez le répertoire custom/pdptransmission par la nouvelle version, puis désactivez et réactivez le module pour enregistrer les nouvelles tables, constantes et la tâche planifiée. Les transmissions et leur historique sont conservés. En cas d’échec, le motif est dans documents/pdptransmission/ et dans l’onglet Journal.
