Dolibarr ERP CRM Wiki

Module PA Reception

Module PA Reception

PA Reception (Réception PA) est un module complémentaire pour Dolibarr ERP/CRM qui reçoit les factures fournisseurs électroniques depuis une Plateforme Agréée (PA, ex-PDP), les importe automatiquement en factures fournisseurs Dolibarr, et émet les statuts obligatoires du cycle de vie (reçue, refusée, encaissée).

La réception des factures électroniques est obligatoire pour toutes les entreprises assujetties à la TVA dès le 1er septembre 2026, y compris celles qui n'émettront qu'en 2027. Ce module couvre cette obligation côté Dolibarr.

É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, pas d'OCR)
Distribution Fiche sur le Dolistore

Fonctionnalités

  • Boîte de réception : relève les factures entrantes depuis la Plateforme Agréée.
  • Import automatique en facture fournisseur Dolibarr à l'état brouillon, avec rapprochement du fournisseur par SIRET (création de la fiche tiers si elle n'existe pas) et protection anti-doublon.
  • Émission des statuts obligatoires du cycle de vie vers la plateforme : reçue (accusé de réception), refusée (avec motif), encaissée.
  • Analyse Factur-X / CII (EN 16931) native : les données sont lues dans le XML structuré, il ne s'agit pas d'une reconnaissance de caractères sur le PDF — donc aucune erreur de lecture.
  • Encart « origine PA » sur la fiche facture fournisseur, rappelant la provenance et l'état.
  • Architecture ouverte à connecteurs : brancher une nouvelle plateforme revient à écrire une classe qui implémente PaInboundConnectorInterface.
  • Interface et documentation en français et en anglais.

Connecteurs fournis

Connecteur État Configuration
Sandbox Prêt à l'emploi Aucune — des factures d'exemple sont intégrées au module
PA REST générique Prêt à l'emploi Endpoint + clé de votre contrat

Conventions du connecteur REST

GET  {endpoint}/inbox                → [{ "id", "filename", "date" }]
GET  {endpoint}/messages/{id}/file   → contenu XML brut
POST {endpoint}/messages/{id}/status → { "status", "reason" }

Authentification : Authorization: Bearer <clé>.

Prérequis

  • Le module Fournisseurs de Dolibarr doit être actif.
  • Un accès à une Plateforme Agréée pour le connecteur « PA REST ». Le connecteur Sandbox permet de tester le module de bout en bout sans aucun compte.

Installation

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

Configuration

Menu Configuration → Modules → PA Reception :

  • Connecteur : Sandbox (test immédiat) ou PA REST, puis l'endpoint et la clé de votre plateforme.
  • Comportement d'import : création automatique du fournisseur inconnu, émission automatique de l'accusé de réception.

Utilisation

  1. Menu Facturation | Paiement → Réception PA.
  2. « Relever la boîte » : la liste des factures entrantes s'affiche.
  3. « Importer » : la facture fournisseur est créée en brouillon, rattachée au bon tiers, et l'accusé de réception est émis.
  4. Refuser une facture depuis la boîte de réception envoie le statut refusée à la plateforme avec le motif saisi.

Place dans la gamme

Réception : PA Reception. Émission : Factur-X France (génération) et PA Transmission (envoi). Émission + réception = conformité complète à la réforme.

Historique des versions

Version Apports principaux
1.0.0 Version initiale : boîte de réception, import Factur-X/CII en facture fournisseur, rapprochement par SIRET, statuts de cycle de vie, connecteurs Sandbox et PA REST, FR/EN

Support

Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_PA_Reception&oldid=67195"