Portale contabile sicuro per dolibarr
Portale contabile Vendite e acquisti Factur-X Inviti nominativi Esportazione ZIP API sicura Accesso autenticato Tracciabilità
Presentazione
ComptaPortal è un modulo esterno per Dolibarr ERP/CRM (editore KSIDol) che aggiunge un extranet contabile sicuro.
Consente a un'azienda di dare al proprio studio commercialista un accesso strettamente limitato alle proprie fatture di clienti e fornitori, senza aprire l'interfaccia interna di Dolibarr. L'accesso è sempre autenticato: il commercialista dispone di un account nominativo e di permessi espliciti (consultazione, download, invio per e-mail, API).
Il commercialista consulta, filtra, scarica, riceve per e-mail o recupera tramite l'API le fatture convalidate, senza utilizzare l'interfaccia interna di Dolibarr e senza accedere a dati diversi da quelli autorizzati.
Editore e supporto
| Elemento | 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
| Informazione | Dettaglio |
|---|---|
| Nome del modulo | ComptaPortal |
| Uso principale | Extranet contabile sicuro: accesso controllato alle fatture di vendita e di acquisto |
| Tipo | Modulo esterno di Dolibarr |
| Famiglia | Interfaccia / Contabilità |
| Versione documentata | 1.0.2 |
| Compatibilità Dolibarr | Dolibarr 18.0 a 24.x |
| Compatibilità PHP | PHP 7.4 o superiore |
| Modifica del core di Dolibarr | No |
| Licenza | GNU GPLv3 |
| Lingue disponibili | Francese, Inglese, Tedesco, Spagnolo, Italiano |
Collegamenti ufficiali
- Video dimostrativo: ComptaPortal — demo (YouTube)
- Negozio: KSIDol.io
- Scheda del modulo: ksidol.io/it
- Pagina editore K.S.I su DoliStore: Moduli K.S.I su DoliStore
Obiettivi del modulo
Semplificare gli scambi tra l'azienda e il suo studio commercialista, mantenendo il controllo dei dati:
- dare al commercialista un accesso nominativo e limitato alle sole fatture autorizzate;
- evitare di condividere un account interno di Dolibarr o di esportare i documenti manualmente;
- tracciare ogni trasmissione (download, e-mail, API);
- consentire l'automazione tramite un'API in sola lettura per il software di contabilità.
Per quali settori?
- Aziende che lavorano con uno studio commercialista esterno e desiderano trasmettere le fatture senza aprire tutto Dolibarr.
- Aziende con più sedi che desiderano centralizzare la messa a disposizione dei documenti contabili.
- Qualsiasi organizzazione che voglia industrializzare la trasmissione periodica delle fatture al proprio commercialista.
Funzionalità principali
- Invito nominativo: e-mail, studio, lingua e permessi per account (fatture dei clienti, fatture dei fornitori, download, invio per e-mail, API). Invio per e-mail o copia del link temporaneo.
- Creazione dell'account da parte del commercialista: definisce lui stesso la propria password (almeno 12 caratteri, con maiuscola, minuscola e cifra) dal link ricevuto.
- Banner aziendale: identifica l'azienda emittente sul portale.
- Ricerca dei documenti: filtri per periodo, origine (vendite/acquisti), tipo (fattura, nota di credito, acconto, fattura di avanzamento), terzo e stato di trasmissione.
- Download: PDF singoli, variante Factur-X quando esiste.
- Esportazione ZIP: archivio con un manifesto CSV.
- Invio per e-mail: archivio inviato a uno o più destinatari (separati da «,» o «;»), con firma KSIDol.io automatica.
- API in sola lettura: endpoint di elenco e di download per l'integrazione nel software di contabilità.
- Tracciabilità: registro delle trasmissioni e registro di sicurezza.
Sicurezza e accesso
L'accesso ai dati è sempre autenticato; nessun documento è raggiungibile tramite un semplice link anonimo.
- Account nominativo per commercialista, con permessi espliciti.
- Password definita dal commercialista (minimo 12 caratteri, maiuscola + minuscola + cifra).
- Blocco dopo ripetuti tentativi di accesso falliti.
- Scadenza della sessione per inattività (durata configurabile).
- Token CSRF nei moduli.
- Registro di sicurezza senza conservare l'indirizzo IP in chiaro.
API in sola lettura
Destinata all'integrazione nel software di contabilità:
- endpoint di elenco e di download;
- autenticazione Bearer;
- token con hash e revocabili;
- ambiti limitati e quota oraria di chiamate;
- ogni chiamata viene registrata.
Menu principali
Il modulo si integra nel menu Contabilità di Dolibarr. Un gruppo «ComptaPortal» aggiunge:
- Cruscotto (account attivi, inviti in sospeso, trasmissioni degli ultimi 30 giorni)
- Inviti
- Account del portale
- Trasmissioni (registro)
- Configurazione
Ogni voce è visibile solo a un utente che dispone del permesso associato.
Configurazione
La configurazione (Contabilità → ComptaPortal → Configurazione) espone in particolare:
- attivazione del portale pubblico autenticato;
- URL pubblico e titolo del portale;
- lingua predefinita;
- durata di validità degli inviti (ore) e durata di inattività prima della disconnessione (minuti);
- limiti di esportazione (numero di documenti, dimensione in MB);
- quota oraria di chiamate all'API;
- indirizzo e-mail del mittente e corpo del messaggio inviato al commercialista.
Uso quotidiano
- L'azienda crea un invito nominativo e seleziona i permessi.
- Il commercialista riceve il link, crea il proprio account e accede.
- Cerca e scarica le fatture, le esporta in ZIP o le riceve per e-mail.
- Per automatizzare, crea un token API e configura il proprio software di contabilità.
- Ogni trasmissione viene registrata.
Permessi utente
Il modulo dichiara quattro permessi, ciascuno a protezione delle voci di menu corrispondenti:
- Leggere il cruscotto di ComptaPortal (portal/read)
- Gestire gli inviti e gli account del commercialista (portal/write)
- Leggere i registri di trasmissione e di sicurezza (audit/read)
- Configurare ComptaPortal (setup/write)
Nota tecnica
- Standard Dolibarr rispettati: permessi, CSRF,
GETPOST, escaping. Nessuna modifica del core. - Hook sulle schede fattura cliente e fattura fornitore.
- Tabelle create: account del portale, inviti, token API, trasmissioni, registro eventi.
- Il modulo espone i file già prodotti da Dolibarr; non genera né le fatture né il Factur-X.
Installazione
- Decomprimi l'archivio per ottenere una cartella
comptaportal/. - Copiala in
htdocs/custom/del tuo Dolibarr. - Verifica i permessi di scrittura su
documents/comptaportal/temp(esportazioni temporanee). - Attiva il modulo da Home → Configurazione → Moduli/Applicazioni.
- Apri Contabilità → ComptaPortal → Configurazione per impostare il portale.
Aggiornamento
Sostituisci la cartella comptaportal/ con la nuova versione, quindi ricarica la pagina dei moduli. Le tabelle e le costanti esistenti vengono conservate.
Risoluzione dei problemi
- Il portale non è disponibile: verifica che il modulo sia attivato e che il portale pubblico sia attivato nella configurazione.
- L'invito non è valido o è scaduto: genera un nuovo invito (durata di validità configurabile).
- Le e-mail non vengono inviate: verifica l'invio di e-mail di Dolibarr e l'indirizzo del mittente nella configurazione.
- Un PDF non è disponibile: il documento deve essere stato generato e archiviato da Dolibarr.
Posizionamento normativo
ComptaPortal facilita la collaborazione con lo studio commercialista. Non sostituisce una piattaforma accreditata di fatturazione elettronica. La generazione del Factur-X resta a carico di Dolibarr o del modulo di generazione installato.
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 7.4+ — Licenza GPLv3 — Editore: KSIDol.
Riepilogo
ComptaPortal offre al tuo commercialista un accesso sicuro, autenticato e tracciato alle tue fatture di vendita e di acquisto — ricerca, download, esportazione ZIP, invio per e-mail e API — senza mai aprire l'interfaccia interna di Dolibarr né esporre dati diversi da quelli autorizzati.