--- title: "Point d'accès PDP/PA (SuperPDP)" weight: 30 description: "Se connecter à SuperPDP pour envoyer et surtout recevoir vos factures électroniques." --- # Point d'accès PDP/PA (SuperPDP) Cette page explique, pas à pas, comment connecter votre Dolibarr au point d'accès **SuperPDP**, pour **envoyer** vos factures clients et surtout **recevoir** les factures de vos fournisseurs. Elle est volontairement détaillée : rien ne part et rien n'est traité sans que vous l'ayez décidé, et vous gardez le contrôle à chaque étape. > **L'essentiel pour recevoir des factures des septembre :** la réception repose sur une **tâche planifiée** (cron) qui va chercher vos factures fournisseurs toutes les heures. Cette tâche est **désactivée par défaut** : tant que vous ne l'activez pas, aucune facture n'est récupérée. La marche à suivre est dans la section [Recevoir les factures fournisseurs](#recevoir-les-factures-fournisseurs). > **PDP ou PA ? C'est la même chose.** La France a fait évoluer la dénomination officielle : les **"PDP"** (Plateformes de Dématérialisation Partenaires) sont désormais appelées **"PA"** (Plateformes Agréées). Dans cette documentation, on note **PDP/PA** pour que tout le monde s'y retrouve, quelle que soit la dénomination que vous connaissez. Selon les versions de Dolibarr, le libellé à l'écran peut encore afficher simplement "PDP". En revanche, l'opérateur **SuperPDP** garde son nom : c'est un nom de produit, pas la catégorie. ## Qu'est-ce qu'un PDP/PA et SuperPDP ? Un **PDP/PA** (Plateforme de Dématérialisation Partenaire, renommée officiellement Plateforme Agréée) est un opérateur agréé qui transporte les factures électroniques entre les entreprises. Vous ne vous connectez pas directement à chaque client ou fournisseur : vous vous connectez à votre PDP/PA, qui se charge d'acheminer et de recevoir les factures pour vous. **SuperPDP** est l'un de ces opérateurs. Ce module sait dialoguer avec lui via son API sécurisée pour : - envoyer une facture client validée vers le réseau, - récupérer les factures fournisseurs qui vous sont adressées, - suivre le statut de ce qui a été transmis. ## Choisir SuperPDP dans les réglages 1. Ouvrez la configuration du module Facturx, onglet **"Configuration du point d'accès"**. 2. Dans le champ **"Point d'accès (PDP/PA)"**, sélectionnez **SuperPDP**, puis enregistrez. 3. Une fois ce choix enregistré, les champs de configuration propres à SuperPDP apparaissent en dessous. Tant qu'aucun point d'accès n'est sélectionné, les champs de connexion et les boutons d'envoi/réception ne s'affichent pas. ## Champs de configuration Après avoir choisi SuperPDP, renseignez les champs suivants. Le **Client ID** et le **Client Secret** vous sont fournis par SuperPDP dans votre espace opérateur (rubrique application/API). | Champ | Rôle | Obligatoire | |-------|------|-------------| | **Identifiant émetteur** (`FACTURX_AP_SENDER_ID`) | Votre identifiant côté SuperPDP, utilisé comme adresse électronique du vendeur (BT-34) dans la Factur-X | Oui, pour envoyer | | **Client ID** (`FACTURX_AP_API_KEY`) | Identifiant OAuth de votre application SuperPDP | Oui | | **Client Secret** (`FACTURX_AP_API_PASSWORD`) | Secret OAuth de votre application SuperPDP | Oui | | **Type d'autorisation OAuth** (`FACTURX_AP_OAUTH_GRANT_TYPE`) | Mode de connexion : "Client Credentials" (technique) ou "Authorization Code" (utilisateur final) | Défaut : Client Credentials | | **Mode production** (`FACTURX_PROD`) | Bascule production / test | Voir la note ci-dessous | | **Forcer le renvoi des documents** (`FACTURX_FORCE_RE_SEND_DOCUMENT`) | Autorise le renvoi d'une facture déjà transmise | Non, à utiliser avec précaution | > **Note d'honnêteté sur le "Mode production" :** SuperPDP ne propose pour l'instant qu'une seule API (`v1.beta`, qui fait office de production). L'option "Mode production" est présente pour l'avenir mais ne change pas encore l'adresse réellement utilisée. Ne vous inquiétez pas si vous la voyez : vos échanges passent par l'API de SuperPDP dans tous les cas. ## Se connecter (OAuth) La connexion se fait par **OAuth**, un standard qui évite de manipuler des mots de passe : votre Dolibarr obtient un jeton d'accès temporaire auprès de SuperPDP. Deux modes existent selon votre configuration. ### Mode "Client Credentials" (technique, recommandé par défaut) C'est une connexion automatique de serveur à serveur. Vous n'avez **aucune manipulation** à faire : il suffit de renseigner le Client ID et le Client Secret. Le module obtient un jeton tout seul au moment d'envoyer ou de recevoir, et le renouvelle automatiquement (durée typique : 1 heure). Aucun bouton "Connecter" n'apparaît dans ce mode. ### Mode "Authorization Code" (au nom d'un utilisateur) À utiliser si SuperPDP vous demande une connexion au nom d'un utilisateur final. Dans ce mode, une section **"Connexion OAuth à SUPER PDP"** apparaît sur la page de réglages : 1. Copiez l'**URL de callback** affichée et collez-la dans votre application côté SuperPDP (c'est l'adresse à laquelle SuperPDP vous renverra après connexion). 2. Cliquez sur **"Connecter à SUPER PDP"**. Vous êtes redirigé vers SuperPDP pour vous authentifier. 3. Après validation, vous revenez sur Dolibarr avec le message **"Connexion à SUPER PDP réussie"**. Un badge **"État de la connexion"** vous indique en permanence la situation : - vert : **"Connecté à SUPER PDP (token expire le ...)"** ; - orange : **"Le token a expiré, veuillez vous reconnecter"** ; - gris : **"Non connecté à SUPER PDP"**. Le jeton est **renouvelé silencieusement** tant que la connexion reste valide : vous n'avez pas à vous reconnecter à chaque fois. Pour couper la connexion, utilisez le bouton **"Déconnecter de SUPER PDP"**, qui supprime les jetons stockés. La connexion utilise les protections modernes OAuth 2.1 (PKCE et jeton anti-CSRF `state`), et la page de connexion est réservée aux administrateurs. ## Sécurité et confidentialité Comme beaucoup d'utilisateurs s'en inquiètent, voici précisément ce qui se passe : - **Rien n'est envoyé sans votre action.** Une facture ne part vers SuperPDP que si vous cliquez sur le bouton d'envoi et confirmez la fenêtre. Aucun envoi automatique en arrière-plan. - **La réception ne démarre que si vous l'activez.** La tâche planifiée d'import est désactivée par défaut (voir plus bas). - **Vos identifiants restent chez vous.** Le Client ID, le Client Secret, l'identifiant émetteur et les jetons OAuth sont stockés dans votre base Dolibarr (table des constantes), par entité. - **Vous pouvez révoquer à tout moment.** En mode "Authorization Code", le bouton "Déconnecter" supprime les jetons. En mode "Client Credentials", il suffit de changer ou vider le Client Secret. - **Point de vigilance :** dans la page de réglages, le **Client Secret est affiché en clair** (il n'est pas masqué). Évitez de partager une capture d'écran de cette page et limitez l'accès à la configuration du module aux administrateurs de confiance. - **Pas de webhook exposé.** Le module n'ouvre aucune URL publique de réception : le suivi et la réception se font par interrogation régulière de SuperPDP (voir ci-dessous), pas par un service ouvert sur l'extérieur. ## Envoyer une facture Sur la fiche d'une facture, le bouton **"FacturX Envoyer"** apparaît quand toutes ces conditions sont réunies : - un point d'accès est configuré ; - vous avez le droit de créer des factures ; - le client n'est pas un particulier ; - la facture est **validée** (ou payée/classée) ; - le **PDF de la facture existe** (sinon le bouton indique "Aucun fichier PDF généré pour ce document, générez le PDF avant d'envoyer") ; - ce PDF **contient bien le XML Factur-X** (sinon le bouton indique "Aucun des fichiers PDF de ce document ne contient de XML Factur-X, régénérez le PDF avant d'envoyer") ; - la facture **n'a pas déjà été transmise** : une fois l'envoi effectué, le bouton est grisé et n'est plus cliquable, son infobulle rappelant l'identifiant de la transmission qui bloque un nouvel envoi. Quand plusieurs fichiers PDF sont joints à la facture (le PDF généré, sa copie suffixée quand l'option de suffixe est active, un document ajouté à la main depuis l'onglet Documents), le module ne se fie pas au nom des fichiers : il les inspecte et retient celui qui contient réellement le XML Factur-X. C'est ce fichier-là, et lui seul, qui part vers le point d'accès. Avant l'envoi, deux informations doivent être présentes : - l'**identifiant de routage du client** (champ "Identifiant Peppol/FacturX spécifique (BT-49)" sur la fiche tiers) ; - votre **identifiant émetteur** (`FACTURX_AP_SENDER_ID`). Le module vérifie aussi la présence du destinataire dans l'annuaire Peppol officiel ; s'il est introuvable, un avertissement s'affiche mais l'envoi n'est pas bloqué. Déroulé : 1. Cliquez sur **"FacturX Envoyer"**. 2. Confirmez la fenêtre **"Envoyer vers le point d'accès"** ("Confirmez-vous l'envoi de ce document vers le point d'accès ?"). 3. Le **PDF Factur-X** (qui contient le XML) est transmis à SuperPDP. 4. En cas de succès, le message **"Facture envoyée avec succès"** s'affiche et l'identifiant retourné par SuperPDP est enregistré automatiquement sur la facture (champ "Identifiant du document au point d'accès"). Un évènement de suivi est ajouté. Pour **renvoyer** une facture déjà transmise (échec, correction), activez l'option "Forcer le renvoi des documents" dans les réglages : le bouton redevient actif et cliquable. Tant que cette option est désactivée, un second envoi est refusé, y compris si l'adresse de l'action est appelée directement. À utiliser avec précaution pour éviter les doublons. ## Recevoir les factures fournisseurs C'est le point le plus important pour la rentrée. La réception fonctionne par **interrogation régulière** de SuperPDP : une tâche planifiée va chercher, toutes les heures, les factures fournisseurs qui vous sont adressées. ### Checklist pour recevoir des factures des septembre 1. **Choisir et connecter SuperPDP** (sections ci-dessus) : point d'accès sélectionné, Client ID / Client Secret renseignés, connexion OAuth valide. 2. **Activer la tâche planifiée d'import.** Rendez-vous dans **Accueil > Outils d'administration > Travaux planifiés (cron)**. Repérez la tâche **"Importer les factures fournisseur depuis le point d'accès"** et **activez-la**. Elle est fournie **désactivée par défaut** : tant qu'elle est désactivée, aucune facture n'est récupérée. 3. **Vérifier que le cron Dolibarr tourne.** Les tâches planifiées ne s'exécutent que si le cron de votre serveur est configuré (ligne cron system ou appel régulier de `cron_run_jobs.php`). Sans cela, la tâche reste en attente. Rapprochez-vous de votre hébergeur si besoin. 4. **Donner les droits nécessaires** aux utilisateurs concernés (voir plus bas). ### Ce que fait la tâche planifiée À chaque exécution (toutes les heures), le module : - récupère la liste des factures fournisseurs **entrantes** depuis SuperPDP ; - pour chaque nouvelle facture : télécharge le **XML** et le **PDF**, puis **confirme la réception** à SuperPDP ; - en option, vous envoie une **copie e-mail** à la réception (si l'option correspondante est activée) et un **rapport** d'exécution ; - en complément, **rafraîchit le statut** des factures clients que vous avez envoyées récemment (moins de 7 jours). Comme SuperPDP ne pousse pas les mises à jour, ce rafraîchissement régulier remplace un webhook. ### Consulter et importer manuellement Un menu **"Importer depuis l'AP"** est ajouté sous **Factures fournisseurs**. La page liste les factures fournisseurs récupérées depuis le point d'accès et permet de les importer dans Dolibarr. - La création de la facture fournisseur dans Dolibarr peut s'appuyer sur le module **ScanInvoices** (lecture et intégration du document). Si ce module n'est pas présent, la page vous l'indique. - **Droits requis :** le droit **"Import FacturX supplier invoices from Access Point"** (`facturx/import`), plus les droits de lecture/création sur les tiers, fournisseurs et factures fournisseurs. Sans tous ces droits, un message vous indique ce qui manque. ### En complément : télécharger manuellement depuis le portail SuperPDP Vous n'êtes pas obligé de tout passer par Dolibarr. Vous pouvez à tout moment vous connecter directement à votre compte sur le **portail SuperPDP** () pour consulter et **télécharger vos factures fournisseurs reçues** (PDF et/ou XML). C'est utile : - pour vérifier ponctuellement ce qui vous a été adressé, sans attendre l'exécution horaire de la tâche planifiée ; - comme **solution de secours** tant que le cron n'est pas encore configuré ; - pour récupérer une facture précise immédiatement. Le portail SuperPDP reste la référence de ce qui vous a été transmis : vous y retrouvez l'ensemble de vos flux, en émission comme en réception, indépendamment de Dolibarr. ## Vérifier le statut d'une facture envoyée Quand une facture a été transmise, le bouton **"FacturX État"** apparaît sur sa fiche. Il interroge SuperPDP et affiche le dernier statut connu (statut, sens du flux, date). Ce statut est aussi mémorisé côté Dolibarr, et rafraîchi automatiquement par la tâche planifiée pour les envois récents. ## Messages et cas fréquents | Situation | Message affiché | |-----------|-----------------| | Envoi réussi | "Facture envoyée avec succès" | | PDF absent | "Aucun fichier PDF généré pour ce document, générez le PDF avant d'envoyer" | | Identifiant client manquant | "L'identifiant personnalisé du tiers n'est pas correct" | | Identifiant émetteur non configuré | "Vérification du document impossible : identifiant de l'émetteur non configuré" | | Destinataire absent de l'annuaire Peppol | "Le destinataire ... est introuvable dans l'annuaire Peppol officiel" (avertissement, non bloquant) | | Jeton OAuth expiré (mode utilisateur) | "Le token a expiré, veuillez vous reconnecter" | | Erreur d'envoi | "Erreur lors de l'envoi de la facture : ..." (avec le code et le message renvoyés par SuperPDP) | | Récupération des factures | "Récupération des factures depuis le point d'accès" | | Aucune facture entrante | "Aucune nouvelle facture trouvée sur le point d'accès" | ## En résumé - Pour **envoyer** : configurer SuperPDP, renseigner l'identifiant PDP/PA du client sur sa fiche, valider la facture, générer le PDF, cliquer sur "FacturX Envoyer". - Pour **recevoir** (priorité de la rentrée) : configurer et connecter SuperPDP, puis **activer la tâche planifiée** d'import et s'assurer que le cron du serveur tourne. Les factures fournisseurs arrivent alors automatiquement toutes les heures.