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
Esegui gratis nel browser
Esempio risolto
- Numero
- 73282932000074
- 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.
Casi d'uso
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.
Domande frequenti
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.
Strumenti correlati
Per sviluppatori — accesso via API
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.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/enc/siret-france \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":"73282932000074"}'const res = await fetch("https://api.kit.forhosting.com/enc/siret-france", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": "73282932000074"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/siret-france",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": "73282932000074"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/siret-france", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":"73282932000074"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":"73282932000074"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/siret-france", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"number": "73282932000074"
}Esempio di risposta
{
"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.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
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.
Casi di integrazione
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.
Domande tecniche
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.