Arcchester: Documentation du module externe PA Reception (editeur arcchester)

2026-09-06T12:01:51Z

Documentation du module externe PA Reception (editeur arcchester)

New page

== 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.

{| 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, pas d'OCR)
|-
! Distribution || [https://www.dolistore.com/product.php?id=3322 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 <code>PaInboundConnectorInterface</code>.
* Interface et documentation en français et en anglais.

== Connecteurs fournis ==

{| class="wikitable"
|-
! 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 : <code>Authorization: Bearer <clé></code>.

== 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 ==

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

# Menu ''Facturation | Paiement → Réception PA''.
# '''« Relever la boîte »''' : la liste des factures entrantes s'affiche.
# '''« Importer »''' : la facture fournisseur est créée en brouillon, rattachée au bon tiers, et l'accusé de réception est émis.
# 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 : [[Module Factur-X France|Factur-X France]] (génération) et [[Module PA Transmission|PA Transmission]] (envoi). Émission + réception = conformité complète à la réforme.

== Historique des versions ==

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

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

Module PA Reception - Revision history

Arcchester: Documentation du module externe PA Reception (editeur arcchester)