ForHosting KIT · Ferramentas para dev

Validar SIRET francês

73282932000074 é válido: a verificação Luhn dos catorze dígitos fecha e os nove primeiros, o SIREN 732829320, também passam na própria, deixando 00074 como NIC do estabelecimento. Cada verificação aparece separada. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Número
73282932000074
Você obtém
Entrada
73282932000074
SIREN
732829320
Nic
00074
Comprimento
14

Um SIRET francês é o identificador de quatorze dígitos que nomeia um estabelecimento específico de uma empresa registrada na França. Os nove primeiros dígitos são o SIREN da entidade jurídica; os cinco últimos formam o NIC que distingue um local, armazém ou escritório de outro sob a mesma empresa. Ambas as camadas incorporam dígitos de verificação Luhn, de modo que um erro de digitação ou um par trocado costuma falhar antes de o número ser gravado em uma fatura, um cadastro de fornecedores ou um formulário de onboarding. Esta capacidade implementa apenas essa aritmética local: exige uma string pura de quatorze dígitos, aplica o algoritmo Luhn clássico sobre os quatorze, recalcula a validade Luhn do prefixo SIREN de nove e devolve um veredito estruturado com SIREN, NIC e flags separados para cada verificação.

Como funcionam as verificações Luhn de SIRET e SIREN franceses

Segundo as regras do registro mercantil francês para identificadores SIREN e SIRET, um SIREN tem sempre nove dígitos decimais que identificam uma entidade jurídica por toda a vida, e um SIRET tem sempre quatorze dígitos que identificam um estabelecimento: o SIREN de nove mais um NIC de cinco.

Ambos os números carregam um dígito de verificação produzido pelo algoritmo Luhn mod-10 clássico, de modo que erros de um único dígito e a maioria das trocas adjacentes são capturados antes de o número ser impresso em um extrato Kbis, um cabeçalho de fatura ou um mandato bancário.

Para validar um SIRET completo, pegue a string de quatorze dígitos e aplique Luhn da direita: não dobre o dígito mais à direita; dobre cada segundo dígito caminhando à esquerda; quando o dobro de um dígito ultrapassar nove, subtraia nove; some cada valor ponderado; o número é válido Luhn quando essa soma é divisível por dez. Em separado, pegue os nove primeiros dígitos como prefixo SIREN e aplique a mesma regra Luhn só sobre esses nove.

Um número de estabelecimento bem formado deve passar nas duas verificações: o Luhn do SIRET de quatorze dígitos e o Luhn do SIREN embutido. O algoritmo é determinístico e local: sem chamada ao registro INSEE, sem relógio e sem aleatoriedade. Esta ferramenta não resolve SIRETs para nomes de empresa, não prova que um estabelecimento está aberto e não contata o registro mercantil francês: apenas prova que a string de dígitos está bem formada sob as regras Luhn usadas para SIRET e SIREN franceses.

Em comparação com ferramentas genéricas de formato fiscal ou verificadores Luhn de cartão, a intenção de busca aqui é estreita: quem precisa de um validador Luhn de SIRET francês para números de estabelecimento de quatorze dígitos, não um adivinhador multi-país nem uma ferramenta de cartão de pagamento.

Onde as verificações Luhn de SIRET cabem em fluxos reais

Plataformas de contabilidade e fatura eletrônica recebem SIRETs de quatorze dígitos em faturas de fornecedores e devem rejeitar um número de estabelecimento digitado errado antes de gravar um pedido, pagamento ou arquivo fiscal. Fluxos de onboarding de marketplace e logística coletam um SIRET por armazém ou loja e precisam de verificação local imediata para que uma única transposição não crie um estabelecimento fantasma e uma falha bancária ou fiscal depois.

Jobs de importação ERP e CRM percorrem cada coluna SIRET em um CSV ou feed de parceiro, chamam este validador e colocam em quarentena as linhas em que valid é false, capturando edições humanas e bugs de um dígito em geradores que só recalculam o SIREN sem revalidar a string completa de quatorze dígitos.

Não trate um SIRET aprovado como prova de que o estabelecimento está registrado e aberto no INSEE, de que a empresa é solvente ou de que a identidade foi verificada; só prova que os dígitos Luhn são consistentes sob os pesos usados para SIRET e SIREN franceses. Trate SIRETs reais como identificadores comerciais: limite acesso em logs, evite enviar números completos a analytics de terceiros e prefira mascarar os últimos quatro na telemetria quando o número completo não for necessário para a trilha de auditoria.

Auditar colunas SIRET em mestres ERP

Valide em lote cada SIRET de quatorze dígitos em um CSV de fornecedores ou clientes e coloque em quarentena as linhas cujo Luhn do SIRET completo ou do prefixo SIREN não corresponda mais, antes de exportações fiscais ou bancárias.

O que é um número SIRET francês?

É um identificador de estabelecimento de quatorze dígitos: os nove primeiros são o SIREN da empresa e os cinco últimos o NIC daquele local. Ambas as camadas usam dígitos de verificação Luhn para capturar erros de digitação e leitura antes do armazenamento.

Qual a diferença entre SIREN e SIRET?

SIREN tem nove dígitos que identificam a entidade jurídica. SIRET tem quatorze que identificam um estabelecimento: SIREN mais um NIC de cinco. Esta capacidade valida o SIRET completo e verifica em separado o prefixo SIREN embutido.

O que acontece com comprimento errado, letras ou hífens?

Tarefas de validação de forma que falham não são cobradas. Uma string de quatorze dígitos com dígito de verificação errado devolve valid false sem lançar erro.

A verificação Luhn do SIRET francês é gratuita?

A ferramenta do navegador é gratuita e roda localmente.

Por que a ferramenta faz duas verificações separadas?

Porque um SIRET tem duas camadas: o SIREN da empresa e o NIC do estabelecimento. Conferir separadamente os catorze dígitos e o prefixo de nove mostra se o erro está na parte da empresa ou no restante; o SIRET só é válido quando as duas passam.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

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

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

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"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Caracteres não numéricos e comprimentos incorretos falham com invalid_input em vez de um recorte silencioso, para que você nunca persista um identificador pela metade. A mesma aritmética pura roda grátis no navegador e no preço de API publicado, sem consulta de rede ao INSEE nem a registros mercantis, e sem alegar que um checksum válido significa que o estabelecimento está ativo, aberto ou livre de fraude.

Como funcionam as verificações Luhn de SIRET e SIREN franceses

Esta ferramenta reporta siret_luhn e siren_valid de forma independente e define valid como true somente quando ambas passam, para que você veja se a falha está na string do estabelecimento como um todo ou no prefixo da empresa.

Contrato de entrada, campos de resposta e erros

Envie um campo number que contenha apenas caracteres de zero a nove. O motor exige exatamente quatorze dígitos: nove para o prefixo SIREN e cinco para o NIC, incluindo o dígito de verificação final do SIRET completo. Comprimento errado é um erro explícito que indica a necessidade de quatorze dígitos e informa o comprimento enviado, para que formulários mostrem uma mensagem clara sem adivinhar. Strings vazias, number ausente, floats, negativos e objetos não string falham antes de qualquer soma Luhn e não são cobrados. Tarefas de validação que rejeitam forma incorreta não são cobradas. Espaços, hífens, letras e pontos decimais são rejeitados como entrada não numérica com invalid_input, para que um valor silencioso recortado nunca chegue ao armazenamento. A resposta sempre inclui input (a string normalizada de quatorze dígitos), valid (true só quando ambas as verificações Luhn passam), siret_luhn (Luhn sobre os quatorze dígitos), siren (os nove primeiros), siren_valid (Luhn só sobre esses nove), nic (os cinco últimos), length quatorze e algorithm siret-france-luhn. Aliases como digits, siret, text, value, n e code são aceitos para o mesmo campo de payload, para que integrações que já falam «siret» não precisem renomear. Como o caminho é pure parse sem relógio, fonte aleatória ou rede, o mesmo corpo JSON sempre produz o mesmo resultado JSON na ferramenta gratuita do navegador e na API a US$ 0,002 por solicitação bem-sucedida. Prefira este endpoint quando você bloquear um formulário de fornecedor, um pipeline de captura de faturas ou uma carga ERP com base em um identificador de estabelecimento completo de um usuário, arquivo de parceiro ou etapa OCR. Uma string bem formada de quatorze dígitos com dígito de verificação errado devolve valid false com siret_luhn false sem lançar, para que lotes possam colocar linhas em quarentena em vez de abortar.

Onde as verificações Luhn de SIRET cabem em fluxos reais

Agentes de suporte recalculam siret_luhn e siren_valid quando um cliente dita um número ao telefone ou cola de um extrato Kbis em PDF, capturando erros antes de emitir um contrato ou mandato.

Validar SIRETs de fornecedores na captura de faturas

Quando OCR ou um formulário envia quatorze dígitos do cabeçalho de uma fatura, chame este validador e bloqueie o lançamento se valid for false, usando siret_luhn e siren_valid para explicar se falhou a string do estabelecimento ou o prefixo da empresa.

Controlar onboarding de marketplace ou logística

Exija um SIRET puro de quatorze dígitos no cadastro de vendedor ou armazém, rejeite entrada não numérica ou de comprimento errado com invalid_input, e só crie o registro do estabelecimento quando ambas as verificações Luhn passarem.

Como esta ferramenta valida um SIRET?

Faça POST de uma string pura de quatorze dígitos em number. A resposta informa siret_luhn sobre os quatorze dígitos, siren_valid sobre os nove primeiros e valid true só quando ambas passam, além de siren, nic e length.

Ver a documentação completa do KIT →