Introduction

Objectif du module

PAGateway permet :

• L’envoi des factures clients vers une Plateforme Agréée (PA) telle que Billit

• L’import des factures fournisseurs reçues via la PA

• L’activation optionnelle de l’e-facturation à la validation

Le module facilite la conformité aux exigences belges en matière de facturation électronique, tout en restant totalement intégré à Dolibarr.

Prérequis

• Dolibarr installé et opérationnel

• Module Facture activé

• PHP compatible avec votre version Dolibarr

• Compte actif sur une Plateforme Agréée (ex. Billit)

• Numéro de TVA et SIRET/SIREN correctement renseignés

Installation et activation

1. Copier le dossier dans :

   custom/pagateway

2. Aller dans :

   Accueil → Configuration → Modules/Applications

3. Activer le module PAGateway

[CAPTURE: Activation du module dans Modules/Applications]

Attribution des droits

Dans Utilisateurs & Groupes :

• Envoyer des documents via PA Gateway

• Configurer PAGateway

[CAPTURE: Droits utilisateurs PAGateway]

Configuration (administrateur)

Accès :

Configuration → Modules → PAGateway

[CAPTURE: Écran Paramètres PAGateway]

Abonnement

Un abonnement actif est obligatoire pour autoriser l’envoi des factures vers la Plateforme Agréée.

Choix de la PA

Sélectionner la Plateforme Agréée active (ex. Billit).

Configuration Billit

• Environnement : Sandbox ou Production

• URL API

• Authentification : Clé API ou OAuth

• Code client

• SIRET

• Bouton de test de connexion

[CAPTURE: Configuration API Billit]

Options disponibles

• Envoi automatique à la validation

• E-facturation automatique à la validation

• Activation de l’import des factures fournisseurs via PA

Logs

Consultables via :

• Liste des factures

• Onglet logs PAGateway

• custom/pagateway/logs/

• documents/dolibarr.log

Utilisation – Envoi de factures

Envoi unitaire

Fiche facture → Onglet PA Gateway → Bouton

« Envoyer via PA Gateway »

Conditions :

• Facture validée

• Non déjà envoyée

• Client avec numéro de TVA

• Client avec SIRET/SIREN

[CAPTURE: Bouton Envoyer via PA Gateway]

Envoi multiple

Liste des factures → Sélection → Menu d’actions →

« Envoyer via PA Gateway »

Confirmer l’action.

Résultat affiché :

• Succès

• Erreurs détaillées

[CAPTURE: Envoi multiple depuis liste]

En cas d’erreur

Vérifier :

• Numéro de TVA du client

• SIRET/SIREN

• Statut validé

• Logs du module

Utilisation – Import des factures fournisseurs

Activer l’option dans la configuration.

Accéder à l’onglet :

« Import factures fournisseurs PA »

Cliquer sur le bouton d’import.

Le module :

• Ignore les factures déjà importées

• Fait correspondre les tiers par numéro de TVA

• Crée automatiquement les factures fournisseurs

Logs :

• pagateway_import.log

• dolibarr.log

[CAPTURE: Écran Import factures fournisseurs PA]

Droits et sécurité

Deux droits principaux :

• Envoi via PA Gateway

• Configuration PAGateway

Contrôles intégrés :

• Facture obligatoirement validée

• Numéro de TVA obligatoire

• SIRET/SIREN obligatoire

• Vérification des champs requis avant envoi

Dépannage & FAQ

Erreurs fréquentes :

• « Seules les factures validées… » → Valider la facture

• « Numéro de TVA du client doit être renseigné » → Compléter la fiche tiers

• « SIRET (ou SIREN) du client doit être renseigné » → Compléter la fiche tiers

• « Déjà envoyé » → Facture déjà transmise

• Page blanche à l’import → Vérifier pagateway_import.log

Logs disponibles :

• list.php

• Onglet logs PAGateway

• custom/pagateway/logs/

• documents/dolibarr.log

Références

• Documentation officielle Billit : https://www.billit.eu

• README du module

• Version : PAGateway 1.2.2