MBI Monetico

🎯 Panoramica del modulo

MBI Monetico incassa le vostre fatture e i vostri ordini con carta di pagamento, online, tramite Monetico, la soluzione di pagamento di CIC e Crédit Mutuel. Il modulo propone un link di pagamento al vostro cliente dalla scheda della fattura o dell'ordine, lo accompagna sulla piattaforma sicura della sua banca, poi registra l'incasso in Dolibarr non appena il pagamento è autorizzato. La fattura passa allo stato pagata, l'incasso viene riconciliato sul conto bancario scelto e il cliente riceve la sua conferma di pagamento per email, con la fattura in allegato.

Funziona esclusivamente con un contratto Monetico Paiement attivo presso CIC o Crédit Mutuel: le tre credenziali di negozio — numero di TPE, codice società e chiave MAC — sono rilasciate con tale contratto. Le pagine di notifica e di ritorno del modulo devono inoltre essere raggiungibili da Internet, in HTTPS e senza autenticazione preliminare, poiché la banca contatta la prima per confermare le transazioni e il browser del vostro cliente apre la seconda.

🌐 Demo: https://demo.mbicloud.fr 🛒 Scoprite i nostri altri moduli su Dolistore.

💡 Vantaggi

• I vostri clienti pagano online, immediatamente, con carta di pagamento.
• L'incasso, la riconciliazione bancaria e il passaggio della fattura allo stato pagata sono automatici.
• Il pagamento può partire da un ordine: la fattura viene creata da sola alla ricezione dell'incasso.
• Il vostro cliente riceve la conferma di pagamento per email, con la fattura in allegato, senza alcun intervento da parte vostra.
• Una modalità test permette di validare l'intera catena prima di incassare il primo euro.

⚙️ Funzionalità chiave

💳 Incasso con carta tramite Monetico

• Pagamento Monetico proposto al cliente: sulla pagina di pagamento online pubblica di Dolibarr, con un pulsante dedicato e l'indicazione del tipo di carta accettata.
• Pulsante di pagamento sulla scheda della fattura: disponibile non appena la fattura non è più in bozza e resta un importo da saldare.
• Pulsante di pagamento sulla scheda dell'ordine: disponibile finché nessuna fattura è collegata all'ordine.
• Reindirizzamento sicuro verso la banca: il modulo di pagamento viene sigillato con la chiave del vostro contratto prima di essere presentato al cliente.

🧾 Incassi, fatture e ordini

• Registrazione automatica dell'incasso: alla ricezione della conferma bancaria, creazione di un pagamento con carta, riconciliazione sul conto bancario selezionato e passaggio della fattura allo stato pagata quando il saldo è azzerato.
• Catena completa a partire da un ordine: l'ordine ancora in bozza viene convalidato, la fattura corrispondente viene creata, l'incasso vi viene registrato e l'ordine viene classificato come fatturato.
• Convalida automatica di una fattura in bozza: effettuata prima della registrazione dell'incasso.
• Fatturazione possibile anche in caso di articolo rimosso dal catalogo: la riga interessata viene ripresa come riga libera anziché bloccare la creazione della fattura.

✉️ Conferma e tracciabilità

• Email di conferma al cliente: inviata dopo l'incasso, costruita su un modello di messaggio scelto da voi, con il PDF della fattura in allegato quando è disponibile.
• Tracciabilità in agenda: ogni invio di conferma viene registrato come evento, collegato alla fattura e al cliente.
• Pagina di ritorno personalizzata: conferma al cliente l'accettazione o il rifiuto del pagamento, con i colori e i recapiti della vostra azienda.

🛡️ Sicurezza e architettura

• Multi-entità: l'entità interessata viene trasmessa dall'inizio alla fine e nelle impostazioni vengono proposti solo i conti bancari dell'entità corrente.
• Controllo di autenticità delle conferme bancarie: tramite un sigillo calcolato con la chiave del vostro contratto; una notifica non conforme non viene mai registrata.
• Protezione contro i doppi incassi: una conferma inviata due volte dalla banca non crea mai un secondo incasso.
• Elaborazione affidabile dall'inizio alla fine: la risposta attesa dalla banca viene emessa in ogni caso, anche quando un altro modulo provoca un errore durante l'elaborazione.
• Integrazione senza sovrascrittura del core: il modulo si inserisce nell'interfaccia standard di Dolibarr.

🔧 Configurazione e amministrazione

• Amministrazione in quattro schede: impostazioni, informazioni, cronologia delle modifiche e attivazione, con l'indirizzo di notifica da copiare nel vostro back office Monetico visualizzato pronto all'uso.
• Opzioni 3-D Secure: indicate alla banca la vostra preferenza in materia di autenticazione del titolare della carta — disattivazione, challenge desiderato, challenge richiesto, assenza di challenge o richiesta di esenzione.
• Controllo preliminare dell'indirizzo del cliente: il pagamento non viene proposto quando la via, il codice postale o la città sono incompleti, e un messaggio lo segnala a schermo.
• Modalità test: indirizza l'insieme delle transazioni verso la piattaforma di prova di Monetico.

🆕 Novità recenti (1.9.3 / 1.9.2 / 1.9.1)

• Impostazioni multi-azienda affidabili: la schermata di configurazione elenca ora soltanto i conti bancari dell'entità corrente, e l'entità viene conservata dall'inizio alla fine durante il pagamento e sulla pagina di ritorno.
• Nessun avviso generato dalle versioni recenti di PHP.
• L'invio della conferma di pagamento al cliente viene registrato in agenda, collegato alla fattura e al cliente interessati.
• L'email di conferma riporta un identificativo di tracciamento, che permette di ritrovarla tra gli scambi.
• Un ordine ancora in bozza viene convalidato automaticamente prima della creazione della sua fattura, alla ricezione del pagamento.

✅ Compatibilità

• Dolibarr: 12.0+ (testato fino a Dolibarr 23) — nessuna versione massima dichiarata.
• PHP: 7.2+, con le estensioni json, hash, curl e openssl.
• Contratto Monetico Paiement (CIC / Crédit Mutuel): obbligatorio, con le tre credenziali di negozio rilasciate dalla banca (numero di TPE, codice società e chiave MAC). Il modulo non funziona con nessun altro acquirer.
• Accessibilità da Internet: le pagine di notifica e di ritorno devono essere raggiungibili in HTTPS e senza autenticazione preliminare, e l'indirizzo pubblico dell'istanza deve essere correttamente indicato nella configurazione di Dolibarr.
• Attivazione della licenza: è necessario un accesso in uscita in HTTPS verso il server di attivazione di MB Informatique.
• Conto bancario e modello di email: facoltativi; senza conto selezionato l'incasso viene comunque registrato sulla fattura ma non riconciliato, e lasciando vuoto il modello di email l'invio della conferma è disattivato.
• Altri moduli: nessun altro modulo Dolibarr è richiesto e non è dichiarata alcuna incompatibilità. Il metodo di pagamento con codice CB deve essere presente nel dizionario dell'entità interessata.

Module version: auto
Editore/Licenza: MB Informatique / GPL-v3
Lingua dell'interfaccia: Inglese, Francese
Assistenza: MB Informatique
Prerequisiti:

• Dolibarr min version: auto
• Dolibarr max version: auto

🔧 Installazione

1. Scaricare l'archivio ZIP del modulo senza decomprimerlo.
2. In Dolibarr, andare in Home > Configurazione > Moduli/Applicazioni.
3. Aprire la scheda Distribuisci/Installa un modulo esterno.
4. Caricare l'archivio ZIP del modulo.
5. Cercare e attivare MBI Monetico.
6. Aprire la scheda Attivazione della pagina di amministrazione, inserire il riferimento del vostro ordine e attivare la licenza: finché il modulo non è attivato, la pagina delle impostazioni resta bloccata.
7. Nella scheda Impostazioni, inserire le tre credenziali di negozio fornite dalla vostra banca, scegliere il conto bancario di riconciliazione, il modello di email di conferma e le opzioni 3-D Secure desiderate.
8. Copiare l'indirizzo di notifica visualizzato in fondo alla pagina delle impostazioni e dichiararlo nel vostro back office Monetico.
9. (In alternativa) Per un'installazione manuale, copiare la cartella mbimonetico in /htdocs/custom/.

ℹ️ Note di utilizzo

• Il modulo richiede obbligatoriamente un contratto Monetico Paiement attivo presso CIC o Crédit Mutuel; non funziona con nessun altro acquirer.
• Prima della messa in produzione, attivare la modalità test e pagare una fattura dall'inizio alla fine per verificare che la conferma della banca venga elaborata correttamente, quindi disattivare la modalità test.
• Il pagamento non viene proposto quando l'indirizzo del cliente è incompleto: via, codice postale e città devono essere compilati.
• Senza conto bancario selezionato, l'incasso viene registrato sulla fattura ma non viene riconciliato con una scrittura bancaria. Lasciare vuoto il modello di email disattiva l'invio della conferma al cliente.
• Una banca dati MySQL o MariaDB offre la protezione più rigorosa contro un doppio incasso quando due conferme arrivano esattamente nello stesso istante.
• Alcune opzioni 3-D Secure, in particolare la richiesta di esenzione per analisi del rischio, richiedono un'opzione specifica del vostro contratto commerciante.
• L'interfaccia del modulo è disponibile in inglese e in francese; le traduzioni tedesca, spagnola e italiana sono parziali.
• Effettuare un backup della banca dati e dei file di Dolibarr prima di ogni aggiornamento, quindi installare il nuovo archivio sopra la versione esistente. Alcune versioni richiedono di disattivare e riattivare il modulo affinché le modifiche abbiano effetto; il ChangeLog lo indica esplicitamente all'inizio della versione interessata.
• La disattivazione del modulo rilascia l'attivazione della licenza, cancella il riferimento dell'ordine e la chiave di licenza conservati localmente e rimuove i diritti e le dichiarazioni del modulo. Le impostazioni funzionali vengono conservate: credenziali di negozio, conto bancario, modello di email e opzioni 3-D Secure si ritrovano invariati alla riattivazione. I dati prodotti — pagamenti, scritture bancarie, fatture create a partire da ordini ed eventi di agenda — vengono conservati, perché hanno rilevanza contabile.

🎓 Servizi

• Formazione sul modulo disponibile a 80 € IVA esclusa.
• Assistenza e aggiornamenti inclusi per tutta la durata della licenza.

📄 Licenza e condizioni di utilizzo

Il modulo è distribuito con licenza GNU General Public License v3 o successiva (GPL v3+); il testo completo si trova nel file COPYING fornito con il modulo.

Le Condizioni di Utilizzo complete sono fornite con il modulo e consultabili dalla sua scheda « Informazioni » in Dolibarr. Le nostre Condizioni Generali di Vendita sono disponibili all'indirizzo https://www.mb-informatique.fr/cgv.html.

👨 💻 Editore

MBI Monetico è un modulo custom Dolibarr sviluppato da MB Informatique.

Si rivolge alle aziende titolari di un contratto Monetico Paiement presso CIC o Crédit Mutuel che desiderano incassare le proprie fatture e i propri ordini con carta di pagamento direttamente da Dolibarr, senza reinserimenti e senza strumenti intermedi.

Editore: MB Informatique
Contatto: info@mb-informatique.fr
Sito web: https://www.mb-informatique.fr

🛠 CHANGELOG

UPDATE 1.9.3 (2026-06-24)

• Miglioramento: gli avvisi generati dalle versioni recenti di PHP non compaiono più.
• Correzione: la schermata delle impostazioni elenca ora soltanto i conti bancari dell'entità corrente.
• Compatibilità: il pagamento e la pagina di ritorno funzionano in un'installazione multi-azienda, poiché l'entità viene conservata dall'inizio alla fine.

UPDATE 1.9.2 (2026-05-27)

• Novità: l'invio dell'email di conferma al cliente viene registrato in agenda, collegato alla fattura e al cliente interessati.
• Miglioramento: l'email di conferma riporta un identificativo di tracciamento, che permette di ritrovarla tra gli scambi.

UPDATE 1.9.1 (2026-05-19)

• Miglioramento: un ordine ancora in bozza viene convalidato automaticamente prima della creazione della sua fattura, alla ricezione del pagamento.

UPDATE 1.9.0 (2026-04-20)

• Novità: due impostazioni permettono di indicare alla banca il livello di autenticazione 3-D Secure del titolare della carta che desiderate.
• Novità: la scelta effettuata — disattivazione, challenge desiderato, challenge richiesto o richiesta di esenzione — viene trasmessa alla banca per ogni transazione.

UPDATE 1.8.0 (2026-04-08)

• ⚠️ Azione richiesta: disattivare e riattivare il modulo dopo l'aggiornamento, per applicare le modifiche introdotte da questa versione.
• Novità: il pagamento può essere avviato da un ordine; la fattura viene creata automaticamente al momento del pagamento e l'ordine viene classificato come fatturato.
• Novità: un pulsante di pagamento Monetico compare sulla scheda dell'ordine, finché nessuna fattura è collegata ad esso.
• Novità: una nuova scheda mostra la cronologia degli aggiornamenti del modulo.
• Miglioramento: l'interfaccia è disponibile in ulteriori varianti regionali dell'inglese e del francese; le traduzioni tedesca, spagnola e italiana sono parziali.
• Correzione: una riga d'ordine il cui prodotto è stato rimosso dal catalogo non impedisce più la fatturazione.

UPDATE 1.6.0 (2025-08-07)

• Novità: il pagamento può essere avviato da un ordine, con creazione automatica della fattura corrispondente.
• Novità: un'opzione aggiunge un pulsante di pagamento Monetico sulla scheda dell'ordine.

UPDATE 1.5.3 (2024-10-31)

• Novità: il pagamento in 2, 3 o 4 rate, segnalato a schermo come in fase di sviluppo, viene proposto con il suo scadenzario e le sue eventuali spese aggiuntive.
• Miglioramento: la schermata delle impostazioni accetta campi di inserimento di importi.

UPDATE 1.5.2 (2024-05-29)

• Correzione: pagamento dei documenti emessi in un contesto multi-valuta.

UPDATE 1.5.1 (2024-05-28)

• Correzione: il conto bancario sul quale viene registrato il pagamento.
• Correzione: la fattura allegata all'email di conferma non veniva sempre trovata.

UPDATE 1.5 (2024-05-17)

• Miglioramento: i pagamenti effettuati in modalità test vengono registrati come quelli reali, il che permette di validare la connessione dall'inizio alla fine.
• Correzione: al momento del pagamento la fattura veniva identificata dal suo riferimento, il che poteva designare il documento sbagliato.

UPDATE 1.4.0 (2024-05-16)

• Miglioramento: la presentazione dell'interfaccia è stata rivista.

UPDATE 1.3.0 (2024-05-15)

• Miglioramento: i metodi di pagamento proposti al cliente sono stati corretti e ottimizzati.

UPDATE 1.2.0 (2024-04-05)

• Sicurezza: la sicurezza del modulo è stata rafforzata.

UPDATE 1.1.0 (2024-03-07)

• Novità: un'opzione aggiunge un pulsante di pagamento Monetico sulla scheda della fattura.
• Compatibilità: risolto un problema di compatibilità con Dolibarr durante il pagamento.

UPDATE 1.0.2 (2023-09-04)

• Correzione: il pagamento poteva fallire quando il documento non riportava alcuna valuta; ora viene utilizzato l'euro come impostazione predefinita.

UPDATE 1.0

• Novità: versione iniziale del modulo.