Aller au contenu principal

EMPayment — Import CODA et QR Code SEPA pour Dolibarr

EMPayment est un module Dolibarr qui couvre deux besoins complémentaires : automatiser le rapprochement bancaire via l'import CODA (fichiers .cod standards belges et API Codabox), et faciliter le paiement de vos factures grâce aux QR codes SEPA EPC.

Configuration générale EMPayment

Pourquoi EMPayment ?

  • QR codes EPC sur toutes vos factures PDF — Le client scanne et le virement est pré-rempli (IBAN, BIC, montant, communication structurée)
  • OGM/VCS belge — Communications structurées belges générées automatiquement
  • ISO 11649 (RF) — Références créditeurs pour les factures internationales
  • Import CODA — Manuel ou via API Codabox, avec historique complet et tableau de bord
  • Rapprochement intelligent — Matching multi-critères (référence, montant, contrepartie)
  • Factures clients ET fournisseurs — La plupart des outils CODA ignorent les fournisseurs, EMPayment ne le fait pas
  • Compatible Dolibarr 16 à 23 — PHP 8.1+

Prérequis

Élément Version minimum
Dolibarr 16.0 ou supérieur
PHP 8.1 ou supérieur
Modules Dolibarr requis Factures, Tiers, Banques

Pour l'intégration Codabox : des identifiants API Codabox valides sont nécessaires.

Installation

Depuis le DoliStore

  1. Rendez-vous sur le DoliStore et recherchez EMPayment
  2. Achetez le module et téléchargez l'archive ZIP
  3. Décompressez l'archive dans le dossier htdocs/custom/ de votre Dolibarr
  4. Le dossier final doit être htdocs/custom/empayment/

Activation

  1. Connectez-vous à Dolibarr en tant qu'administrateur
  2. Allez dans Accueil → Configuration → Modules/Applications
  3. Recherchez "EMPayment" et cliquez sur Activer

Configuration

Paramètres généraux

Accédez à Administration → Modules → EMPayment → Configuration.

Configuration générale — IBAN, BIC, bénéficiaire

Renseignez les informations bancaires de votre société :

Paramètre Description
IBAN IBAN du compte bénéficiaire (ex : BE68 5390 0754 7034)
BIC Code SWIFT/BIC de la banque (ex : TRIOBEBB)
Bénéficiaire Nom affiché dans le QR Code
Type de communication OGM/VCS (Belgique), RF/ISO 11649 (international), ou automatique

Configuration QR Code EPC

Configuration QR Code EPC

  • Position dans le PDF : en-tête ou pied de page
  • Taille du QR code : configurable selon le modèle de PDF
  • Variables email : utilisez __EMPAYMENT_QRCODE_IMG__ dans vos modèles d'email
Variable email Description
__EMPAYMENT_QRCODE_IMG__ Image QR Code (base64)
__EMPAYMENT_QRCODE_URL__ URL vers le QR Code
__EMPAYMENT_COMM__ Communication structurée
__EMPAYMENT_IBAN__ IBAN du bénéficiaire
__EMPAYMENT_AMOUNT__ Montant formaté

Configuration CODA / Codabox

Configuration CODA et Codabox

Option Description
Import Codabox Active la récupération automatique via l'API Codabox
Identifiants API Codabox ClientId et ClientSecret fournis par Codabox
Fréquence de synchronisation Intervalle de récupération automatique
Factures fournisseur Activer/désactiver le rapprochement des paiements sortants
Archivage Mode d'archivage des fichiers CODA (aucun, déplacer, copier)
Événements Agenda Créer des événements Dolibarr lors du rapprochement

QR Code EPC

Qu'est-ce qu'un QR Code EPC ?

Un QR Code EPC (standard EPC069-12 v3.1) est un code QR que les applications bancaires reconnaissent pour pré-remplir un virement SEPA. Le client scanne le code depuis sa facture PDF et son application bancaire affiche directement :

  • L'IBAN du bénéficiaire
  • Le BIC de la banque
  • Le montant exact de la facture
  • La communication structurée (OGM/VCS ou RF)

Aucune frappe manuelle, aucune erreur.

Depuis la fiche facture

Un bouton QR Code apparaît sur chaque facture validée. Il ouvre une popup avec le QR code EPC et les informations de paiement.

Bouton QR Code sur la fiche facture

Popup de prévisualisation du QR Code EPC

Dans les factures PDF

Le QR code est automatiquement intégré dans vos modèles PDF Dolibarr, à la position configurée (en-tête ou pied de page).

QR Code EPC intégré dans le PDF de facture

Communications structurées

Type Format Usage
OGM/VCS +++XXX/XXXX/XXXXX+++ Factures belges
ISO 11649 (RF) RF12 1234 5678 9012 Factures internationales SEPA
Automatique Détection selon le contexte Recommandé

Astuce : La communication structurée OGM/VCS est automatiquement reconnue lors de l'import CODA — le rapprochement se fait seul.

Import CODA / Codabox

Tableau de bord

Le tableau de bord CODA donne une vue d'ensemble de vos relevés bancaires importés et de l'état du rapprochement.

Tableau de bord CODA

Transactions importées

La liste des transactions affiche toutes les opérations importées depuis vos relevés CODA, avec leurs détails : date, montant, contrepartie, communication.

Liste des transactions CODA

Import manuel de fichiers CODA

Si vous n'utilisez pas Codabox, importez vos fichiers CODA manuellement depuis l'interface dédiée.

Import manuel de fichier CODA

Logs d'import

Chaque import est tracé dans les logs avec le détail des opérations traitées.

Logs d'import CODA

Rapprochement bancaire

Rapprochements en attente

Les transactions non encore rapprochées sont présentées avec les candidats identifiés. EMPayment utilise plusieurs stratégies de matching en parallèle :

  • Référence structurée : OGM/VCS ou ISO 11649 RF détectée dans la communication bancaire
  • Montant : correspondance exacte avec une facture ouverte
  • Contrepartie : IBAN ou nom du donneur d'ordre identifié dans les tiers Dolibarr
  • Date : cohérence temporelle avec les factures en cours

Rapprochements en attente

Les correspondances à haute confiance sont appliquées automatiquement. Les cas ambigus sont présentés dans la liste des rapprochements en attente pour une validation en un clic.

Rapprochements confirmés

Une fois validés, les rapprochements apparaissent dans l'historique des confirmés avec la piste d'audit complète.

Rapprochements confirmés

Factures fournisseurs

Le rapprochement fonctionne dans les deux sens : EMPayment réconcilie aussi bien les encaissements (factures clients) que les décaissements (factures fournisseurs).

Problèmes courants

Le QR Code n'apparaît pas dans le PDF → Vérifiez que l'IBAN et le BIC sont correctement renseignés dans la configuration. Le QR Code nécessite un IBAN valide.

L'import Codabox échoue → Vérifiez vos identifiants API Codabox (ClientId et ClientSecret). Testez depuis la page de configuration.

Le rapprochement automatique ne fonctionne pas → Vérifiez que la communication structurée de la facture correspond au format attendu (OGM/VCS pour BE, RF pour international). Consultez les logs d'import.

Les factures fournisseurs ne sont pas rapprochées → L'option "Factures fournisseur" doit être activée dans la configuration CODA.

FAQ

Le QR Code EPC est-il compatible avec toutes les applications bancaires ?

Oui, le standard EPC069-12 v3.1 est reconnu par toutes les applications bancaires SEPA : BNP, ING, KBC, Belfius, Beobank, et leurs équivalents dans toute la zone SEPA.

EMPayment fonctionne-t-il sans Codabox ?

Oui. L'import CODA peut se faire manuellement en téléversant vos fichiers CODA. Codabox est optionnel et simplifie l'automatisation.

La communication structurée OGM/VCS est-elle générée automatiquement ?

Oui. EMPayment génère la communication structurée belge (OGM/VCS) à partir du numéro de facture, conformément à l'algorithme officiel belge.

Peut-on utiliser EMPayment avec EMPeppol ?

Oui. EMPeppol génère déjà un QR code EPC pour les factures reçues. Sur l'émission, EMPayment ajoute le QR code EPC à vos propres factures PDF. Les deux modules sont complémentaires.

Où trouver de l'aide ?