Module PA Transmission

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Module PA Transmission

PA Transmission (anciennement « PDP Transmission ») est un module complémentaire pour Dolibarr ERP/CRM qui transmet vos factures Factur-X à une Plateforme Agréée (PA) du réseau français de facturation électronique, et suit leur cycle de vie (déposée → reçue → acceptée / refusée) directement dans Dolibarr.

Depuis juillet 2025, les PDP (Plateformes de Dématérialisation Partenaires) sont officiellement devenues des Plateformes Agréées (PA) dans la terminologie de la DGFiP.

C'est le complément du module Factur-X France : celui-ci génère le fichier Factur-X, celui-là le transmet sur le réseau — l'étape qu'impose la réforme.

Éditeur arcchester
Licence GPL v3
Compatibilité Dolibarr 18.0 à 24.x
PHP 7.4 minimum (extension cURL)
Dépendances Aucune (cURL pur : pas de Composer, pas de SDK)
Distribution Fiche sur le Dolistore

Fonctionnalités

  • Bouton « Transmettre » sur la fiche facture, avec badge de cycle de vie coloré : à transmettre / transmise / reçue / acceptée / refusée / erreur.
  • Bouton « Rafraîchir le statut » : interrogation de la plateforme pour mettre à jour l'état.
  • Transmission automatique optionnelle dès la validation de la facture.
  • Choix du contenu transmis : le XML Factur-X seul ou le PDF/A-3 complet.
  • Architecture ouverte à connecteurs — brancher une nouvelle plateforme revient à écrire une classe qui implémente PdpConnectorInterface.
  • Journalisation de chaque dépôt et de chaque réponse, pour l'audit.
  • Interface et documentation en français et en anglais.

Connecteurs fournis

Connecteur Type État Configuration
Sandbox Simulateur intégré Prêt à l'emploi Aucune
Chorus Pro B2G secteur public, API PISTE Codé sur l'API documentée Identifiants PISTE + compte technique
Docaposte PA privée B2B (REST) Preset nommé Endpoint + clé de votre contrat
Yooz PA privée B2B (REST) Preset nommé Endpoint + clé de votre contrat
PA REST générique API REST Prêt à l'emploi Endpoint + clé

À savoir : Docaposte et Yooz sont des plateformes privées dont les API ne sont pas publiques et nécessitent un contrat commercial. Le module fournit un preset nommé qui s'appuie sur le connecteur REST générique — vous renseignez l'endpoint et la clé fournis par votre prestataire. Le connecteur Chorus Pro est écrit d'après la documentation de l'API PISTE : validez-le sur la sandbox PISTE avec vos identifiants avant tout usage en production.

Prérequis

  • Le fichier Factur-X doit exister — il est produit par le module Factur-X France à la validation de la facture.
  • Un compte auprès d'une Plateforme Agréée pour les connecteurs autres que Sandbox.

Installation

  1. Télécharger le zip module_pdptransmission-x.y.z.zip depuis le Dolistore.
  2. Dans Dolibarr : Accueil → Configuration → Modules/Applications → Déployer/installer un module externe.
  3. Activer PA Transmission dans la liste des modules (famille « Finance / Facturation »).

Configuration

Menu Configuration → Modules → PA Transmission :

  • Connecteur : Sandbox pour tester immédiatement (aucun paramètre), ou l'un des connecteurs REST puis l'URL de l'API et la clé de votre contrat.
  • Contenu transmis : XML Factur-X ou PDF/A-3.
  • Transmission automatique à la validation de la facture (oui/non).

Conventions du connecteur REST générique

Le connecteur attend, de façon adaptable selon la plateforme :

POST {endpoint}/transmissions        multipart : file + reference + metadata
     → { "id": "...", "status": "..." }
GET  {endpoint}/transmissions/{id}   Authorization: Bearer <clé>
     → { "status": "..." }

La correspondance entre les statuts de la plateforme et les statuts internes est centralisée dans PdpGenericRestConnector::mapStatus().

Utilisation

  1. Ouvrir une facture validée dont le Factur-X a été généré.
  2. Cliquer sur « Transmettre » — ou laisser la transmission automatique agir à la validation.
  3. Suivre le badge de cycle de vie ; « Rafraîchir le statut » interroge la plateforme à la demande.

Place dans la gamme

Émission : Factur-X France (génération) + PA Transmission (envoi). Réception : PA Reception. Les deux volets réunis couvrent la réforme française de la facturation électronique.

Historique des versions

Version Apports principaux
1.0.1 Terminologie PA (ex-PDP) alignée sur la DGFiP, corrections de robustesse
1.0.0 Version initiale : transmission, cycle de vie, connecteurs Sandbox / Chorus Pro / REST générique / presets Docaposte et Yooz

Support