EM Payment

EMPayment — EPC QR Code & CODA Bank Reconciliation for Dolibarr

The EMPayment module transforms how you handle incoming payments in Dolibarr with two complementary and independent features: the generation of SEPA EPC QR Codes on your invoices to make paying easier for your customers, and the automatic import of CODA statements (via file or Codabox API) for intelligent bank reconciliation of your customer and supplier invoices.

One module, two use cases: speed up your collections with European QR codes, and save hours every week thanks to automatic payment reconciliation.

📱 EPC QR Code — Get paid faster

Generate SEPA payment QR Codes compliant with the EPC069-12 v3.1 standard on your invoices. Your customers scan the QR code with their banking app and pay in seconds, with no typing errors.

• EPC069-12 v3.1 compliant — official European standard, recognised by all SEPA banks
• Belgian structured communication (OGM/VCS) — automatic generation in the +++XXX/XXXX/XXXXX+++ format for flawless reconciliation
• ISO 11649 creditor reference (RF) — international reference support for non-Belgian payments
• Button on every invoice — QR code display popup with payment details, secure public link, and download options
• Automatic PDF integration — QR code insertion in your invoice PDFs (configurable position: header, footer, or native)
• Email variables — include the QR code directly in your email templates via substitution variables
• Secure public URL — HMAC-signed link with configurable validity period and anti-abuse rate limiting

🏦 CODA / Codabox Import — Automatic bank reconciliation

No more tedious manual matching! EMPayment imports and analyses CODA files (standard Belgian bank format) to automatically reconcile incoming and outgoing payments with your Dolibarr invoices.

🔌 Two operating modes to choose from

• Manual mode — import CODA files downloaded from your bank in a few clicks
• Codabox mode (API) — automatic daily retrieval of all your statements via the Codabox API, with automatic IBAN-based routing to the correct Dolibarr bank account

🧠 Intelligent multi-strategy matching

The EMPayment matching engine combines several strategies to maximise the automatic reconciliation rate, with a confidence score for each match found:

• Structured communication (OGM/VCS) — 99% confidence reconciliation when the customer pays with the correct reference
• Invoice reference — search by Dolibarr reference in free communications
• Supplier reference — specific matching for purchase invoices via ref_supplier (supports Proximus OGMs, etc.)
• Amount + date — correlation by exact amount and time window
• Fuzzy matching — detection of approximate matches on third-party name and amount
• Automatic validation above a configurable confidence threshold (default 95%)

💰 Customer AND supplier invoices

• Reconciliation of customer payments (credits on the statement)
• Reconciliation of supplier payments (debits on the statement) — a rare feature among CODA modules
• Visual debit/credit distinction with directional icons and signed amounts

✅ Automatic recording and native integration

• Automatic Dolibarr payment creation from reconciled transactions
• Native bank reconciliation — corresponding llx_bank lines are automatically marked as reconciled with the CODA statement number
• Agenda events — ActionComm event creation on the invoice with payment details, strategy used and confidence score
• Controllable pipeline — ability to stop the pipeline after a specific step (download / parse / match / record) to validate step by step during go-live

📊 Complete CODA dashboard

A unified dashboard to monitor your reconciliations at a glance:

• Real-time KPIs: reconciled, pending, confirmed and ignored transactions
• Reconciliation progress bar with status breakdown
• Alert banner for transactions requiring your attention
• Clickable badges to instantly filter transactions by status
• Manual pipeline buttons: trigger each step (Parse / Reconcile / Record) on demand
• Batch validation: confirm all matches with >90% confidence in one click, record all confirmed payments at once

🔎 Advanced reconciliation interface

• Smart manual reconciliation: search for an invoice by ID, reference (FA2025-0042) or supplier reference
• Customer/supplier selector auto-selected according to transaction direction (debit → supplier, credit → customer)
• Batch re-matching: re-run the matching engine on all unmatched transactions after an update
• Enriched context on each suggestion: remaining amount, third party, full communication
• Mass actions on transactions: confirm, ignore, batch marking
• Powerful filters: by bank account, debit/credit type, status, date, amount

📦 File management & logs

• Configurable archiving of processed CODA files: gzip compression, deletion, or database-only retention
• Configurable retention period to meet your legal obligations
• Database logs with admin interface: level/source/date filtering, pagination and purge
• Complete history of imports, reconciliations and recordings

⚙️ Automation & scheduling

• Native Dolibarr scheduled task: the full CODA pipeline (Codabox download → parse → match → record) runs automatically once a day
• One-click activation from the Dolibarr scheduled tasks page
• Detailed logs for each automatic execution

🛡️ Security & compliance

• Automatic generation of an HMAC secret key at installation to secure QR code public URLs
• Configurable rate limiting on public URLs to prevent abuse
• Time-limited tokens (configurable validity in days)
• Compliant with the EPC069-12 v3.1 standard (European Payments Council)
• Compliant with ISO 11649 (international creditor references)

🔧 Compatibility

• Dolibarr: 16.x to 23.x
• PHP: 7.4 to 8.3+
• Non-intrusive: hooks and substitutions only, no Dolibarr core modifications
• Required modules: Invoices, Third Parties, Banks (Dolibarr standards)
• Compatible with customer and supplier invoices

💡 Who is it for?

• Belgian companies that receive CODA files from their bank and want to automate reconciliation
• Codabox users who want direct Dolibarr integration (zero manual export/import)
• Any SEPA company that wants to offer QR code payment on its invoices to speed up collections
• Accountants and managers who want to save time on bank matching while keeping control via manual validation

📚 Learn more

👉 EMPayment Product Page

👉 Full Documentation — installation guide, configuration, FAQ and use cases

🤝 Support & Updates

Actively maintained and regularly updated module. Responsive email support.

• 📧 Support: support@e-dem.com
• 🌐 Website: www.e-dem.com