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

2026-10-19T16:06:37Z

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

KSI: Created page with "Category:Complementary modules Category:K.S.I Category:Accounting Category:Interface {{TemplateDocDev}} {{TemplateDocUtil}}

2026-07-26T06:15:05Z

Created page with "Category:Complementary modules Category:K.S.I Category:Accounting Category:Interface {{TemplateDocDev}} {{TemplateDocUtil}} <div style="border:1px solid #d7e..."

New page
[[Category:Complementary modules]]
[[Category:K.S.I]]
[[Category:Accounting]]
[[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;">ComptaPortal per Dolibarr</div>
<div style="font-size:18px; color:#345; margin-bottom:14px;">Portale contabile sicuro: accesso autenticato e controllato alle fatture di vendita e di acquisto, senza aprire l'interfaccia interna di Dolibarr</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;">Portale contabile</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Vendite e acquisti</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Factur-X</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Inviti nominativi</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Esportazione ZIP</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">API sicura</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Accesso autenticato</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Tracciabilità</span>
</div>
</div>

== 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 ==

{| 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'''
| 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: [https://youtu.be/DYhy0qoTO6M ComptaPortal — demo (YouTube)]
* Negozio: [https://www.ksidol.io KSIDol.io]
* Scheda del modulo: [https://www.ksidol.io/it/modules/detail?module=main_module_comptaportal 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 ==

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, <code>GETPOST</code>, 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 <code>comptaportal/</code>.
# Copiala in <code>htdocs/custom/</code> del tuo Dolibarr.
# Verifica i permessi di scrittura su <code>documents/comptaportal/temp</code> (esportazioni temporanee).
# Attiva il modulo da Home → Configurazione → Moduli/Applicazioni.
# Apri Contabilità → ComptaPortal → Configurazione per impostare il portale.

== Aggiornamento ==

Sostituisci la cartella <code>comptaportal/</code> 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.

Portale contabile sicuro per dolibarr - Revision history

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