View source for Module PA Transmission

== 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 [[Module Factur-X France|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.

{| class="wikitable"
|-
! É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 || [https://www.dolistore.com/product.php?id=3211 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 <code>PdpConnectorInterface</code>.
* 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 ==

{| class="wikitable"
|-
! 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 [[Module Factur-X France|Factur-X France]] à la validation de la facture.
* Un compte auprès d'une Plateforme Agréée pour les connecteurs autres que Sandbox.

== Installation ==

# Télécharger le zip <code>module_pdptransmission-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# 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 <code>PdpGenericRestConnector::mapStatus()</code>.

== Utilisation ==

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

== Place dans la gamme ==

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

== Historique des versions ==

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

* 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]]