Documentazione KSIDol > Moduli KSIDol > Terzi da SIREN

Guida del modulo: Terzi da SIREN

Guida d'uso non tecnica: a cosa serve il modulo, come usarlo e come si integra con Dolibarr.

Un inserimento, una schedaBasta il SIREN: ragione sociale, indirizzo, SIRET, APE, forma giuridica, IVA

Fattura elettronicaVerdetto dell'elenco a ogni ricerca (Peppol e piattaforma accreditata)

Schede sorvegliateDifferenze con il registro Sirene segnalate all'apertura della scheda

Quota risparmiataRisposte INSEE in cache locale per 30 giorni

1. Panoramica del modulo

SirenCreatTiers elimina l'inserimento manuale dei terzi francesi: digitate il numero SIREN nel campo «Id prof. 1» del modulo di creazione o modifica di un terzo, e il modulo interroga l'API Sirene ufficiale dell'INSEE per compilare il modulo al posto vostro. Nel frattempo verifica se l'azienda può ricevere fatture elettroniche (elenco centrale Peppol, più l'elenco della piattaforma accreditata quando il modulo EInvoicing è collegato), poi continua a sorvegliare le schede nel tempo: all'apertura di una scheda, le differenze con il registro Sirene sono elencate in un banner, con aggiornamento in un clic.

Compilazione automatica dal SIREN: ragione sociale (e sigla come alias), indirizzo della sede, CAP, città, SIRET della sede, codice APE, forma giuridica, partita IVA intracomunitaria calcolata.
Pulsante lente accanto al campo SIREN e ricerca automatica appena viene digitato un SIREN valido (disattivabile).
Verdetto dell'elenco di fatturazione elettronica: azienda raggiungibile o no, piattaforma di ricezione, accettazione del Factur-X.
Controllo periodico delle schede: un banner elenca le differenze, con i pulsanti «Aggiorna la scheda» e «Convalida così com'è».
Avvisi utili: azienda cessata, diffusione riservata, cifra di controllo SIREN insolita.
Cache locale di 30 giorni e accesso riservato agli utenti autenticati con diritto di lettura dei terzi.

2. Messa in servizio: la chiave API INSEE

Il modulo si appoggia all'API Sirene ufficiale dell'INSEE, gratuita ma protetta da chiave.

Create una chiave gratuita sul portale API dell'INSEE (portail-api.insee.fr): la pagina di configurazione del modulo contiene la guida completa passo passo (account, applicazione, sottoscrizione all'API Sirene, recupero della chiave).
Incollate la chiave nella configurazione del modulo e convalidate con «Prova la connessione».
L'offerta pubblica dell'INSEE (30 richieste/minuto, 2 000 richieste/ora) è più che sufficiente: il modulo mette le risposte in cache locale per 30 giorni.
Attivate il modulo, aprite un modulo di creazione terzo, digitate un SIREN: è operativo.

3. Creare una scheda terzo dal SIREN

Nel modulo di creazione tutto parte dal campo «Id prof. 1 (SIREN)».

Digitate il SIREN — spazi e formattazione sono tollerati: «938 582 186» viene accettato e ripulito automaticamente.
La ricerca parte da sola appena ci sono 9 cifre valide (regolabile), o manualmente con il pulsante lente.
Il modulo compila: ragione sociale, sigla come alias, indirizzo della sede, CAP, città, SIRET della sede (Id prof. 2), codice APE (Id prof. 3), forma giuridica e partita IVA intracomunitaria calcolata.
Per una ditta individuale la cui denominazione è il nome civile, il nome commerciale INSEE alimenta il nome alternativo della scheda.
Un messaggio sotto il campo conferma il recupero e mostra il verdetto dell'elenco di fatturazione elettronica.

4. Completare una scheda esistente

Il modulo funziona anche nel modulo di modifica, senza sovrascrivere il vostro lavoro.

In modifica vengono completati solo i campi vuoti: quanto già inserito è conservato.
Un'impostazione («Sovrascrivi i campi in modifica») consente invece ai dati INSEE di sostituire i valori esistenti.
Il pulsante lente resta disponibile in ogni momento per rilanciare la ricerca.

5. Il verdetto dell'elenco di fatturazione elettronica

A ogni ricerca il modulo verifica se l'azienda è raggiungibile per la fatturazione elettronica — la domanda che tutti si porranno con la riforma francese.

Verifica nativa dell'elenco centrale Peppol (SML/SMP), il canale ufficiale machine-to-machine della riforma, che copre tutte le piattaforme accreditate: registrata o no, piattaforma di ricezione dichiarata, accettazione del Factur-X.
Se il modulo EInvoicing è attivo e collegato a una piattaforma accreditata, viene interrogato anche il suo servizio di elenco normalizzato (AFNOR XP Z12-013), e l'indirizzo di instradamento del terzo viene precompilato nel modulo di creazione.
Viene mostrato un solo verdetto: se le due fonti non concordano, prevale la risposta positiva (una piattaforma può ignorare un'azienda in realtà registrata).
Se l'azienda non è raggiungibile, il salvataggio della scheda chiede una conferma — una semplice protezione, disattivabile nella configurazione.

6. Il controllo periodico delle schede

Una scheda corretta il giorno della creazione può invecchiare in silenzio: trasferimento, cambio di forma giuridica, cessazione. Il modulo sorveglia senza imporre nulla.

All'apertura di una scheda terzo, i suoi dati vengono confrontati con il registro Sirene e con l'elenco di fatturazione elettronica.
In caso di differenze, un banner le elenca con precisione, campo per campo (valore della scheda contro valore INSEE).
«Aggiorna la scheda con i dati INSEE» applica le correzioni in un clic; «Convalida la scheda così com'è» conserva i vostri valori.
Una scheda conforme o convalidata non viene più controllata per 90 giorni (regolabile); il controllo può essere disattivato del tutto.

7. Avvisi e casi particolari

Il modulo segnala senza bloccare: decidete sempre voi.

Azienda amministrativamente cessata: compare un avviso, la scheda resta creabile (utile per storico o contenzioso).
Azienda in diffusione riservata nel registro Sirene: il modulo ve lo indica; alcuni dati possono mancare.
Cifra di controllo SIREN insolita: semplice avviso, l'inserimento non è mai bloccato (numeri perfettamente legittimi violano la regola — La Poste, per esempio).
SIREN sconosciuto al registro: messaggio chiaro, nulla viene compilato.

8. Le impostazioni del modulo

Tutto si gestisce dalla pagina di configurazione, senza toccare il codice.

Chiave API INSEE, con pulsante «Prova la connessione» e guida di creazione integrata.
Ricerca automatica alla digitazione: attiva per impostazione predefinita, disattivabile (il pulsante lente resta).
Sovrascrivi i campi in modifica: disattivato per impostazione predefinita.
Controllo dell'elenco di fatturazione elettronica: attivo per impostazione predefinita.
Conferma al salvataggio quando l'azienda non è raggiungibile: attiva per impostazione predefinita.
Controllo periodico delle schede e durata di validità (90 giorni per impostazione predefinita).
Limitare i controlli ai terzi francesi: attivo per impostazione predefinita — per le aziende estere, il controllo IVA VIES nativo di Dolibarr resta lo strumento giusto.

9. Collegamenti con Dolibarr

Il modulo non funziona in modo isolato: si integra con i blocchi nativi di Dolibarr.

Terzi : Il modulo lavora direttamente nel modulo nativo di creazione e modifica dei terzi: nessuna schermata parallela, i dati compilati sono quelli della scheda standard di Dolibarr.
Identificativi professionali : I campi nativi Id prof. 1 (SIREN), Id prof. 2 (SIRET) e Id prof. 3 (APE) sono usati così come sono, insieme alla forma giuridica e alla partita IVA intracomunitaria della scheda.
Modulo EInvoicing (fatturazione elettronica) : Quando EInvoicing è attivo e collegato a una piattaforma accreditata, il suo elenco normalizzato viene interrogato oltre all'elenco centrale Peppol, e l'indirizzo di instradamento e-invoicing del terzo viene precompilato. Senza EInvoicing, il modulo funziona interamente tramite il canale Peppol nativo.
Controllo IVA VIES nativo : Per le aziende non francesi, il pulsante di verifica VIES nativo di Dolibarr, accanto al campo della partita IVA intracomunitaria, resta lo strumento di riferimento — il modulo non lo sostituisce.
Diritti utente : La ricerca è riservata agli utenti autenticati con diritto di lettura dei terzi; nessun dato è accessibile senza connessione.