ForHosting KIT · Strumenti per sviluppatori

Convalidare SIRET francese

73282932000074 è valido: il controllo Luhn delle quattordici cifre torna e le prime nove, il SIREN 732829320, superano anche il proprio, lasciando 00074 come NIC dello stabilimento. Ogni controllo viene indicato a parte. Gratis nel suo browser.

  • Gratis
  • Funziona nel suo browser
  • Senza registrazione
  • I suoi dati restano sul dispositivo
Usalo da WebAPIEmailTelegramApp presto
Se inserisce
Numero
73282932000074
Ottiene
Input
73282932000074
SIREN
732829320
Nic
00074
Lunghezza
14

Un SIRET francese è l’identificativo a quattordici cifre che nomina uno stabilimento specifico di un’azienda registrata in Francia. Le prime nove cifre sono il SIREN dell’entità giuridica; le ultime cinque formano il NIC che distingue un sito, un magazzino o un ufficio da un altro sotto la stessa società. Entrambi i livelli incorporano cifre di controllo Luhn, così un errore di battitura o una coppia scambiata di solito fallisce prima che il numero sia salvato su una fattura, un anagrafica fornitori o un modulo di onboarding. Questa capacità implementa solo quell’aritmetica locale: richiede una stringa pura di quattordici cifre, applica l’algoritmo Luhn classico su tutte e quattordici, ricalcola la validità Luhn del prefisso SIREN a nove e restituisce un verdetto strutturato con SIREN, NIC e flag separati per ciascun controllo.

Come funzionano i controlli Luhn di SIRET e SIREN francesi

Secondo le regole del registro delle imprese francese per gli identificativi SIREN e SIRET, un SIREN ha sempre nove cifre decimali che identificano un’entità giuridica per tutta la sua vita, e un SIRET ha sempre quattordici cifre che identificano uno stabilimento: il SIREN a nove più un NIC a cinque.

Entrambi i numeri portano una cifra di controllo prodotta dall’algoritmo Luhn mod-10 classico, così gli errori di una sola cifra e la maggior parte degli scambi adiacenti vengono intercettati prima che il numero sia stampato su un estratto Kbis, un’intestazione di fattura o un mandato bancario.

Per convalidare un SIRET completo, prenda la stringa di quattordici cifre e applichi Luhn da destra: non raddoppi la cifra più a destra; raddoppi ogni seconda cifra andando a sinistra; quando il doppio di una cifra supera nove, sottragga nove; sommi ogni valore ponderato; il numero è valido Luhn quando quella somma è divisibile per dieci. Separatamente, prenda le prime nove cifre come prefisso SIREN e applichi la stessa regola Luhn solo su quelle nove.

Un numero di stabilimento ben formato deve superare entrambi i controlli: il Luhn del SIRET a quattordici cifre e il Luhn del SIREN incorporato. L’algoritmo è deterministico e locale: nessuna chiamata al registro INSEE, nessun orologio e nessuna casualità. Rispetto a strumenti generici di formato fiscale o verificatori Luhn di carte, l’intento di ricerca qui è stretto: chi ha bisogno di un validatore Luhn SIRET francese per numeri di stabilimento a quattordici cifre, non di un indovinatore multi-paese né di uno strumento per carte di pagamento.

Dove i controlli Luhn SIRET si inseriscono nei flussi reali

Le piattaforme di contabilità e fatturazione elettronica ricevono SIRET a quattordici cifre sulle fatture dei fornitori e devono rifiutare un numero di stabilimento digitato male prima di scrivere un ordine, un pagamento o un archivio fiscale. I flussi di onboarding di marketplace e logistica raccolgono un SIRET per magazzino o negozio e necessitano di un controllo locale immediato affinché una sola trasposizione non crei uno stabilimento fantasma e un fallimento bancario o fiscale successivo.

I job di import ERP e CRM scorrono ogni colonna SIRET in un CSV o feed partner, chiamano questo validatore e mettono in quarantena le righe dove valid è false, catturando sia le modifiche umane sia i bug di uno negli generatori che ricalcolano solo il SIREN senza rivalidare l’intera stringa di quattordici cifre.

Non tratti un SIRET superato come prova che lo stabilimento sia registrato e aperto presso l’INSEE, che la società sia solvibile o che l’identità sia stata verificata; dimostra solo che le cifre Luhn sono coerenti sotto i pesi usati per SIRET e SIREN francesi. Tratti i SIRET reali come identificativi commerciali: limiti l’accesso nei log, eviti di inviare numeri completi ad analytics di terze parti e preferisca mascherare le ultime quattro cifre in telemetria quando il numero completo non è necessario per la traccia di audit.

Auditare le colonne SIRET nei master ERP

Convalidi in batch ogni SIRET a quattordici cifre in un CSV di fornitori o clienti e metta in quarantena le righe il cui Luhn del SIRET completo o del prefisso SIREN non corrisponde più, prima delle esportazioni fiscali o bancarie.

Cos’è un numero SIRET francese?

È un identificativo di stabilimento a quattordici cifre: le prime nove sono il SIREN della società e le ultime cinque il NIC di quel sito. Entrambi i livelli usano cifre di controllo Luhn per intercettare errori di battitura e scansione prima dell’archiviazione.

Qual è la differenza tra SIREN e SIRET?

Il SIREN ha nove cifre che identificano l’entità giuridica. Il SIRET ne ha quattordici che identificano uno stabilimento: SIREN più un NIC a cinque. Questa capacità convalida il SIRET completo e controlla separatamente il prefisso SIREN incorporato.

Cosa succede con lunghezza errata, lettere o trattini?

Le attività di validazione della forma fallite non sono addebitate. Una stringa di quattordici cifre con cifra di controllo errata restituisce valid false senza sollevare eccezioni.

Il controllo Luhn del SIRET francese è gratuito?

Lo strumento del browser è gratuito e gira in locale.

Perché lo strumento fa due controlli separati?

Perché un SIRET ha due livelli: il SIREN dell'impresa e il NIC dello stabilimento. Controllare a parte le quattordici cifre e il prefisso di nove mostra se l'errore sta nella parte dell'impresa o nel resto; il SIRET è valido solo se passano entrambi.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/enc/siret-france

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/enc/siret-france \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"73282932000074"}'
{
  "number": "73282932000074"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.siret_france",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Caratteri non numerici e lunghezze errate falliscono con invalid_input invece di un troncamento silenzioso, così Lei non persiste mai un identificativo semi-pulito. La stessa aritmetica pura gira gratis nel browser e al prezzo API pubblicato, senza consultazione di rete a INSEE o ai registri imprese e senza pretendere che un checksum valido significhi che lo stabilimento è attivo, aperto o privo di frode.

Come funzionano i controlli Luhn di SIRET e SIREN francesi

Questo strumento riporta siret_luhn e siren_valid in modo indipendente e imposta valid a true solo quando entrambi passano, così Lei vede se il fallimento è nell’intera stringa dello stabilimento o nel prefisso della società.

Contratto di input, campi di risposta ed errori

Invii un campo number che contenga solo i caratteri da zero a nove. Il motore richiede esattamente quattordici cifre: nove per il prefisso SIREN e cinque per il NIC, inclusa la cifra di controllo finale del SIRET completo. Una lunghezza errata è un errore esplicito che indica la necessità di quattordici cifre e riporta la lunghezza inviata, così i form possono mostrare un messaggio chiaro senza indovinare. Stringhe vuote, number mancante, float, negativi e oggetti non stringa falliscono prima di qualsiasi somma Luhn e non vengono addebitati. Le attività di validazione che rifiutano una forma errata non sono addebitate. Spazi, trattini, lettere e punti decimali sono rifiutati come input non numerico con invalid_input, così un valore troncato in silenzio non raggiunge mai lo storage. La risposta include sempre input (la stringa normalizzata di quattordici cifre), valid (true solo quando entrambi i controlli Luhn passano), siret_luhn (Luhn su tutte e quattordici le cifre), siren (le prime nove), siren_valid (Luhn solo su quelle nove), nic (le ultime cinque), length quattordici e algorithm siret-france-luhn. Alias come digits, siret, text, value, n e code sono accettati per lo stesso campo di payload, così le integrazioni che già parlano di «siret» non devono rinominare. Poiché il percorso è pure parse senza orologio, sorgente casuale o rete, lo stesso corpo JSON produce sempre lo stesso risultato JSON sullo strumento gratuito del browser e sull’API a $0.002 per richiesta riuscita. Preferisca questo endpoint quando sottopone a gate un form fornitore, una pipeline di cattura fatture o un caricamento ERP su un identificativo di stabilimento completo da un utente, un file partner o un passo OCR. Una stringa ben formata di quattordici cifre con cifra di controllo errata restituisce valid false con siret_luhn false senza sollevare eccezioni, così i job batch possono mettere le righe in quarantena invece di interrompersi.

Dove i controlli Luhn SIRET si inseriscono nei flussi reali

Gli agenti di supporto ricalcolano siret_luhn e siren_valid quando un cliente detta un numero al telefono o lo incolla da un estratto Kbis in PDF, intercettando errori prima di emettere un contratto o un mandato.

Convalidare i SIRET fornitori alla cattura fatture

Quando OCR o un form inviano quattordici cifre dall’intestazione di una fattura, chiami questo validatore e blocchi la registrazione se valid è false, usando siret_luhn e siren_valid per spiegare se è fallita la stringa dello stabilimento o il prefisso della società.

Controllare l’onboarding marketplace o logistica

Esiga un SIRET puro a quattordici cifre alla registrazione di un venditore o magazzino, rifiuti input non numerico o di lunghezza errata con invalid_input e crei il record dello stabilimento solo quando entrambi i controlli Luhn passano.

Come convalida questo strumento un SIRET?

Invii in POST una stringa pura di quattordici cifre in number. La risposta riporta siret_luhn su tutte e quattordici le cifre, siren_valid sulle prime nove e valid true solo se entrambi passano, più siren, nic e length.

Leggi la documentazione completa del KIT →