KSI: Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

2026-10-19T16:07:41Z

Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

← Older revision		Revision as of 16:07, 19 October 2026
Line 91:		Line 91:
	\|}		\|}

	== ~~Collegamenti~~ ufficiali ==		== Link ufficiali ==
			* Video dimostrativo : [https://youtu.be/zm1yBnvbWJg Bank Import — demo (YouTube)]
	* Video dimostrativo: [https://youtu.be/zm1yBnvbWJg Bank Import — demo (YouTube)]		* Scheda del modulo : [https://www.ksidol.io/it/modules/detail?module=main_module_bankimport Bank Import su KSIDol]
	* ~~Negozio~~: [https://www.ksidol.io KSIDol~~.io~~]		* Demo online : [https://www.ksidol.io/t/demo-erp/custom/bankimport/index.php?mainmenu=bank&leftmenu=bankimport Bank Import — aprire la demo]
	* ~~Scheda del modulo~~: [https://www.ksidol.io/it/~~modules~~/~~detail~~?~~module~~=~~main_module_bankimport~~ ksidol.io/it]		* Manuale del modulo : [https://www.ksidol.io/notices/ksidol_notice_it/bankimport.html Bank Import — consultare il manuale]
	* Pagina editore K.S.I su DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= Moduli K.S.I su DoliStore]		* Pagina editore K.S.I su DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= Moduli K.S.I su DoliStore]

KSI: Création page module Bank Import (import bancaire & rapprochement, KSIDol)

2026-07-26T08:56:58Z

Création page module Bank Import (import bancaire & rapprochement, KSIDol)

New page

[[Category:Complementary modules]]
[[Category:K.S.I]]
[[Category:Financial]]
[[Category:Interface]]

{{TemplateDocDev}}
{{TemplateDocUtil}}

<div style="border:1px solid #d7e3f4; border-radius:14px; padding:22px; margin:12px 0 22px 0; background:linear-gradient(135deg,#f6faff,#ffffff); box-shadow:0 2px 10px rgba(20,60,110,0.08);">
<div style="font-size:28px; font-weight:700; color:#17365d; margin-bottom:8px;">Bank Import per Dolibarr</div>
<div style="font-size:18px; color:#345; margin-bottom:14px;">Importa i tuoi estratti conto, ottieni abbinamenti con punteggio con le tue fatture e crea i pagamenti nativi di Dolibarr — dopo validazione umana</div>
<div style="display:flex; flex-wrap:wrap; gap:8px; margin-top:10px;">
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Importazione multiformato</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Riconciliazione bancaria</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Abbinamenti con punteggio</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Pagamenti nativi</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Validazione umana</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Anti-duplicati</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">CSV · OFX · QIF · CAMT.053 · MT940</span>
</div>
</div>

== Presentazione ==

'''Bank Import''' è un modulo esterno per '''Dolibarr ERP/CRM''' (editore KSIDol) che automatizza la riconciliazione bancaria, dall'estratto conto al pagamento.

Importa i movimenti di un estratto conto bancario (CSV, OFX, QIF, CAMT.053, MT940), propone abbinamenti '''con punteggio''' con le tue fatture, acconti, stipendi e oneri aperti, poi crea i '''pagamenti nativi di Dolibarr''' — solo dopo la tua validazione. Il modulo propone, l'utente decide: nessun pagamento è creato automaticamente, nessun movimento esistente è modificato o eliminato.

Il modulo non modifica alcun file del core di Dolibarr.

== Editore e supporto ==

{| class="wikitable" style="width:100%; border-collapse:collapse;"
! style="width:24%; background:#f0f6ff;" | Elemento
! style="background:#f0f6ff;" | Informazione
|-
| '''Editore'''
| '''KSIDol'''
|-
| '''Specialità'''
| Integratore Dolibarr
|-
| '''Servizi'''
| Sviluppo su misura, hosting SaaS, affiancamento Dolibarr
|-
| '''Sito web'''
| https://www.ksidol.io
|-
| '''Supporto'''
| support@ksidol.io
|-
| '''Moduli Dolistore'''
| https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=
|}

== Informazioni sul modulo ==

{| class="wikitable" style="width:100%;"
! style="width:24%; background:#f7f7f7;" | Informazione
! style="background:#f7f7f7;" | Dettaglio
|-
| '''Nome del modulo'''
| Bank Import
|-
| '''Uso principale'''
| Importare gli estratti conto bancari e creare i pagamenti Dolibarr dopo riconciliazione con punteggio
|-
| '''Tipo'''
| Modulo esterno di Dolibarr
|-
| '''Famiglia'''
| Finanza / Contabilità
|-
| '''Versione documentata'''
| 24.0.0
|-
| '''Compatibilità Dolibarr'''
| Dolibarr 18.0 a 24.x
|-
| '''Compatibilità PHP'''
| PHP 8.0 o superiore
|-
| '''Modifica del core di Dolibarr'''
| No
|-
| '''Licenza'''
| GNU GPLv3
|-
| '''Lingue disponibili'''
| Francese, Inglese, Tedesco, Spagnolo, Italiano
|}

== Collegamenti ufficiali ==

* Video dimostrativo: [https://youtu.be/zm1yBnvbWJg Bank Import — demo (YouTube)]
* Negozio: [https://www.ksidol.io KSIDol.io]
* Scheda del modulo: [https://www.ksidol.io/it/modules/detail?module=main_module_bankimport ksidol.io/it]
* Pagina editore K.S.I su DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= Moduli K.S.I su DoliStore]

== Obiettivi del modulo ==

Ridurre il tempo dedicato alla riconciliazione bancaria mantenendo un '''controllo umano su ogni pagamento''':

* importare un estratto conto di qualsiasi banca grazie al riconoscimento multiformato;
* riconciliare automaticamente ogni movimento con i documenti aperti di Dolibarr, con un punteggio e delle motivazioni;
* validare l'abbinamento corretto, scegliere la modalità e la data, poi creare il pagamento nativo di Dolibarr;
* non toccare mai un movimento esistente: il modulo propone, l'essere umano approva.

== Per chi? ==

* '''Microimprese, PMI e associazioni''' che registrano ancora i loro incassi a mano.
* '''Contabili e gestori''' che vogliono spuntare un estratto conto in pochi minuti, senza doppia registrazione.
* '''Integratori Dolibarr''' che cercano una riconciliazione bancaria affidabile, rispettosa dell'inalterabilità.

== Funzionalità principali ==

* '''Importazione multiformato''': CSV (delimitatore e colonne dare/avere rilevati, codifica tollerante), OFX (blocchi STMTTRN), QIF, CAMT.053 XML (voci Ntry), MT940 (:61:/:86:). Formato riconosciuto automaticamente o scelto manualmente.
* '''Anti-duplicati''': impronta calcolata su conto, sorgente, riferimento, date, importo, causale normalizzata e controparte; le righe già importate non vengono mai reinserite.
* '''Riconciliazione con punteggio''': confronto dell'importo (esatto, prossimo, scarto per commissioni/arrotondamento, pagamento parziale), del riferimento fattura (e delle sue varianti), del terzo (nome, parole, codice), del verso bancario e della data. Ogni candidato mostra il suo '''punteggio''' e le sue '''motivazioni'''.
* '''Sorgenti di abbinamento''': fatture e acconti clienti/fornitori, note di credito (solo spunta), stipendi non pagati e oneri sociali/fiscali non pagati (attivabili), e movimenti bancari nativi esistenti (solo spunta, senza doppio pagamento).
* '''Validazione e pagamento''': approvazione di una riga (o allocazione parziale), scelta della modalità e della data, poi creazione del '''pagamento nativo di Dolibarr''' (pagamento di fattura, di stipendio o di onere) e del movimento bancario; blocco della riconciliazione.
* '''Rilevamento del tipo di pagamento''': assegno, carta, bonifico, addebito diretto, effetto domiciliato, contanti.
* '''Gestione dei lotti di importazione''': eliminazione di un lotto o di una riga, ripristino dei set di prova; le righe spuntate/pagate/bloccate sono protette; mai eliminato un pagamento Dolibarr già creato.
* '''Cruscotto''': KPI (transazioni, candidati, approvati, pagamenti eseguiti) e filtro di flusso (da elaborare, approvati da pagare, rifiutati, completati).

== Menu ==

Sotto il menu principale '''Banca''', il modulo aggiunge:

* '''Cruscotto''' — indicatori di riconciliazione
* '''Importazione bancaria''' — invio di un file di estratto conto
* '''Abbinamenti bancari''' — movimenti, candidati con punteggio e validazione
* '''Lotti di importazione''' — dettaglio, eliminazione, ripristino
* '''Connettori bancari''' — profili di connettore (amministratore)
* '''Configurazione''' — parametri del modulo

== Configurazione ==

Da Home → Configurazione → Moduli → Bank Import:

* conto bancario predefinito (<code>BANKIMPORT_DEFAULT_BANK_ACCOUNT_ID</code>);
* modalità di pagamento predefinita (<code>BANKIMPORT_DEFAULT_PAYMENT_MODE_ID</code>);
* tolleranza d'importo (<code>BANKIMPORT_AMOUNT_TOLERANCE</code>, predefinito 0,02);
* punteggio «candidato forte» (<code>BANKIMPORT_AUTO_APPROVE_SCORE</code>, predefinito 90);
* punteggio minimo di abbinamento (<code>BANKIMPORT_MATCH_MIN_SCORE</code>, predefinito 40);
* numero max. di fatture analizzate per transazione (<code>BANKIMPORT_MATCH_SCAN_LIMIT</code>, predefinito 1000);
* candidati max. per transazione (<code>BANKIMPORT_MATCH_TOP_PER_TRANSACTION</code>, predefinito 10);
* dimensione massima di un file importato (<code>BANKIMPORT_IMPORT_MAX_FILESIZE_MB</code>, predefinito 20 MB);
* cercare anche negli stipendi / negli oneri sociali e fiscali (attivati per impostazione predefinita).

== Permessi utente ==

Il modulo definisce cinque permessi:

* '''Leggere''' Bank Import — cruscotto ed elenchi (read)
* '''Importare''' estratti conto bancari — invio e lettura dei file (import)
* '''Generare e validare''' gli abbinamenti — calcolo, approvazione/rifiuto, spunta (match)
* '''Creare''' i pagamenti Dolibarr — pagamenti nativi dopo validazione (pay)
* '''Amministrare''' Bank Import — configurazione, connettori, lotti (admin)

== Flusso tipo ==

# Importa un file di estratto conto (Importazione bancaria).
# Genera gli abbinamenti (Abbinamenti bancari).
# Verifica il punteggio e le motivazioni di ogni candidato.
# Approva l'abbinamento corretto, scegli la modalità e la data di incasso.
# Il '''pagamento nativo di Dolibarr''' è creato, il movimento bancario alimentato e la riconciliazione bloccata.

== Nota tecnica ==

* Tabelle: <code>llx_bankimport_transaction</code>, <code>llx_bankimport_import</code>, <code>llx_bankimport_match</code>, <code>llx_bankimport_connector</code>.
* Standard Dolibarr rispettati: diritti, token CSRF, <code>GETPOST</code>, escaping.
* I segreti di connettore sono '''referenziati''' (nome di un segreto gestito fuori dal webroot), mai memorizzati in chiaro.
* '''Inalterabilità''': il modulo crea pagamenti nativi dopo validazione umana; non modifica né elimina alcuna scrittura contabile esistente, e non elimina mai un pagamento già creato.
* '''Nessuna modifica del core di Dolibarr.'''

== Installazione ==

# Decomprimi l'archivio per ottenere una cartella <code>bankimport/</code>.
# Copiala in <code>htdocs/custom/</code> del tuo Dolibarr.
# Attiva il modulo da Home → Configurazione → Moduli/Applicazioni (famiglia Finanza).
# Apri la configurazione e scegli un conto bancario e una modalità di pagamento predefiniti.

== Aggiornamento ==

# Sostituisci la cartella <code>htdocs/custom/bankimport/</code> con la nuova versione.
# Ricarica una pagina di amministrazione: le tabelle e le costanti mancanti vengono create automaticamente, in modo idempotente.
# L'aggiornamento non elimina alcun dato esistente.

== Risoluzione dei problemi ==

* '''Nessuna riga rilevata all'importazione CSV''': verifica il separatore e la presenza di un'intestazione (colonne data, causale, importo, valuta, terzo).
* '''File rifiutato''': superamento della dimensione massima configurata (<code>BANKIMPORT_IMPORT_MAX_FILESIZE_MB</code>).
* '''Nessun candidato''': abbassa il punteggio minimo, aumenta il limite di analisi, o verifica che le fatture siano realmente aperte.
* '''Nessuna modalità di pagamento''': attiva almeno una modalità di pagamento in Dolibarr.

== Vedi anche ==

* '''Terminale di firma KSIDol''': firma di tutte le schede native di Dolibarr, compatibile con tutti i moduli KSIDol.
* Compatibilità: Dolibarr 18.0 a 24.x — PHP 8.0+ — Licenza GPLv3 — Editore: KSIDol.

== Riepilogo ==

Bank Import importa i tuoi estratti conto bancari (CSV, OFX, QIF, CAMT.053, MT940), riconcilia ogni movimento con le tue fatture e i documenti aperti con un punteggio e delle motivazioni, poi crea i pagamenti nativi di Dolibarr dopo validazione — senza mai modificare un movimento esistente né rompere l'inalterabilità.

Importazione bancaria e riconciliazione per Dolibarr - Revision history

KSI: Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

KSI: Création page module Bank Import (import bancaire & rapprochement, KSIDol)