ForHosting KIT · Ferramentas para dev

Dígito verificador REGON Polônia

Digite a base 12345678 e receba o dígito verificador 5: o REGON completo é 123456785. Também valida números de 9 e 14 dígitos, incluindo a parte da entidade principal dentro de uma unidade local, e pega erros de digitação. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Número: 12345678

Você obtém

Modo de cálculo: Compute
Entrada: 12345678
Forma: 9
Dígito verificador: 5

REGON é o número de identificação estatística polonês atribuído pelo Główny Urząd Statystyczny (GUS) no Registro Oficial Nacional de Atividade Econômica (Rejestr Gospodarki Narodowej). A maioria das entidades recebe um REGON de nove dígitos; unidades locais de organizações multi-sede recebem um REGON de catorze dígitos cujos nove primeiros coincidem com a entidade-mãe. O dígito final de cada forma é um dígito verificador produzido com pesos oficiais fixos e uma regra módulo onze que mapeia o resto dez para zero. Esta capacidade implementa apenas essa regra: o modo compute aceita oito dígitos base para um REGON de nove ou treze dígitos base para um de catorze e devolve o dígito verificador mais o número completo; o modo validate aceita uma string completa de nove ou catorze dígitos e informa se o dígito final coincide com o valor esperado recalculado.

Como o dígito verificador REGON é calculado (formas de 9 e 14 dígitos)

Segundo a especificação do GUS, um REGON padrão tem sempre nove dígitos decimais. As posições um a oito formam a carga útil emitida para a entidade jurídica ou unidade; a posição nove é o dígito verificador. Para calculá-lo, multiplique esses oito dígitos pela sequência oficial de pesos oito, nove, dois, três, quatro, cinco, seis, sete, some os produtos e tome a soma módulo onze.

Se o resto for dez, o dígito verificador é zero; caso contrário o próprio resto é o dígito verificador. Um REGON de catorze dígitos estende a forma de nove com cinco dígitos extras que identificam uma unidade local de uma organização multi-sede. As posições um a nove são o REGON-mãe (incluindo seu próprio dígito verificador); as posições dez a treze são a carga da unidade local; a posição catorze é um segundo dígito verificador.

Esse dígito final usa uma sequência oficial de pesos diferente sobre os treze primeiros dígitos: dois, quatro, oito, cinco, zero, nove, sete, três, seis, um, dois, quatro, oito. Novamente a soma é tomada módulo onze, e o resto dez vira zero.

A validação recalcula o dígito esperado para o comprimento enviado e o compara com o último caractere; em números de catorze dígitos esta ferramenta também informa se o REGON-mãe de nove dígitos embutido ainda passa na própria verificação, para que um cabeçalho corrompido não fique oculto atrás de um dígito final afortunado. O algoritmo é determinístico e local: sem chamada ao registro REGON, sem relógio e sem aleatoriedade.

Esta ferramenta não resolve números REGON para nomes de empresa, não prova status fiscal ou atividade e não contata o GUS — apenas prova que a string de dígitos está bem formada sob a regra oficial ponderada módulo onze.

Em comparação com ferramentas Luhn ou PESEL genéricas, a intenção de busca aqui é estreita: quem precisa de uma calculadora de dígito verificador REGON da Polônia para bases de oito ou treze dígitos, ou de um validador REGON de nove e catorze dígitos, não de uma ferramenta de identidade pessoal ou pagamento.

Onde os dígitos verificadores REGON se encaixam em fluxos empresariais poloneses

Plataformas de contabilidade e fatura eletrônica recebem bases internas de oito dígitos durante o onboarding em sandbox e devem acrescentar o dígito verificador oficial do GUS antes que um REGON apareça em faturas, exportações JPK ou diretórios de contratados. Marketplaces e portais B2B validam números REGON de nove dígitos no cadastro de fornecedores para que uma única transposição não crie uma entidade fantasma e um documento KSeF ou EDI rejeitado.

Operadores de varejo e logística multi-sede recalculam o dígito verificador de catorze dígitos da unidade local quando um armazém ou filial é adicionado sob um REGON-mãe, e rechecam o cabeçalho embutido de nove dígitos para que arquivos de unidade local não divirjam do registro-mãe. Jobs ETL que carregam arquivos mestres de contratados percorrem cada coluna REGON em uma exportação CSV ou ERP, chamam o modo validate e colocam em quarentena as linhas onde valid é false — capturando tanto edições humanas quanto bugs de geradores em um.

Não trate um REGON que passa a verificação como prova de que a entidade está ativa no registro REGON, registrada para IVA ou licenciada para determinada atividade; apenas prova que o dígito verificador é consistente com a carga sob os pesos oficiais do GUS usados para números estatísticos poloneses.

Casos de uso

Auditar colunas REGON em dados mestres de contratados

Valide em lote cada REGON de nove e catorze dígitos em um CSV de ERP, CRM ou fatura eletrônica e coloque em quarentena as linhas cujo dígito verificador não coincida mais com o valor esperado recalculado.

Perguntas frequentes

O que é um dígito verificador REGON?

É o dígito final de um número estatístico REGON polonês, calculado com pesos oficiais do GUS e uma regra mod-11 (resto dez vira zero), para que erros de digitação e de leitura óptica sejam geralmente detectados antes de o número ser armazenado ou faturado.

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

Tarefas de validação que falham não são faturadas.

A ferramenta de dígito verificador REGON é grátis?

A ferramenta do navegador é grátis e roda localmente.

Como se calcula o dígito verificador do REGON?

Multiplique os oito primeiros dígitos pelos pesos 8, 9, 2, 3, 4, 5, 6, 7, some os produtos e divida por 11. O resto é o dígito verificador, mas um resto 10 vira 0. Para 12345678 o resultado é 5.

Um REGON válido significa que a empresa está ativa?

Não. Um dígito verificador correto só mostra que o número está bem formado. A ferramenta não consulta o cadastro oficial, então não diz se a entidade está ativa, licenciada ou ainda registrada.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

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.

Endpoint

POSThttps://api.kit.forhosting.com/enc/regon-poland

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

Chame do seu código

curl -X POST https://api.kit.forhosting.com/enc/regon-poland \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"12345678"}'

const res = await fetch("https://api.kit.forhosting.com/enc/regon-poland", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "number": "12345678"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/regon-poland",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "number": "12345678"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/regon-poland", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"number":"12345678"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"number":"12345678"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/regon-poland", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "number": "12345678"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.regon_poland",
  "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.

Preço

por chamadaUS$ 0,002

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

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

Entrada não numérica 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 ao preço publicado da API, sem consulta de rede ao registro REGON e sem afirmar que um checksum válido significa que a entidade está ativa, licenciada ou ainda inscrita.

Contrato de entrada, modos e comportamento de erro

Envie um campo number que contenha apenas caracteres de zero a nove. Comprimento incorreto é um erro explícito que nomeia o modo e o comprimento enviado — oito ou treze para compute, nove ou catorze para validate — para que formulários cliente mostrem uma mensagem clara sem adivinhar. Strings vazias, number ausente e valores de mode inválidos falham antes de qualquer soma ponderada e não são faturados. Tarefas de validação que rejeitam forma incorreta não são cobradas; uma string bem formada de nove ou catorze dígitos que simplesmente tem o dígito verificador errado devolve valid false sem lançar erro. Espaços, hífens, letras e pontos decimais são rejeitados como entrada não numérica com invalid_input para que um valor recortado em silêncio nunca chegue ao armazenamento. O modo compute é o padrão: o motor exige exatamente oito dígitos para um REGON de nove ou exatamente treze dígitos para um de catorze, devolve check_digit como string de um caractere, devolve with_check como o número completo que você pode imprimir ou persistir, e também devolve form (nove ou catorze), length e o vetor de pesos usado para trilhas de auditoria. Ao calcular um REGON de catorze dígitos a partir de treze, a resposta também inclui base9 e base9_valid para que você veja se o cabeçalho embutido de nove dígitos ainda coincide com os pesos oficiais de oito dígitos. O modo validate aceita exatamente nove ou catorze dígitos; a resposta informa valid true quando o dígito final coincide com expected_check_digit recalculado, e sempre inclui payload (dígitos sem o último), check_digit, expected_check_digit, form e length. Na validação de catorze dígitos, base9_valid e trailing_valid precisam ser ambos true para valid true, de modo que um REGON-mãe danificado nunca seja aceito só porque o décimo quarto dígito coincidiu por acaso. Alias como digits, regon e code são aceitos para o mesmo campo de carga, para que integrações que já falam «regon» não precisem renomear. Como o caminho é parse puro 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.

Onde os dígitos verificadores REGON se encaixam em fluxos empresariais poloneses

Em todo fluxo o contrato é o mesmo: só dígitos, comprimento fixo por modo e forma, JSON estruturado que você pode testar com goldens, comportamento idêntico no navegador gratuito e na API pré-paga, e invalid_input honesto quando a string não é uma sequência pura de dígitos do comprimento certo.

Casos de integração

Completar uma base REGON de 8 dígitos para fixtures de fatura

Chame o modo compute com oito dígitos, armazene with_check e use o REGON de nove dígitos em faturas de teste, amostras JPK ou registros de contratados em sandbox.

Validar REGON digitados ou importados na entrada

Quando um formulário, feed de parceiro ou scanner enviar nove ou catorze dígitos, chame o modo validate e bloqueie o cadastro se valid for false, mostrando expected_check_digit para ajudar a corrigir um erro de um único dígito.

Perguntas técnicas

Como calculo um dígito verificador REGON com esta API?

Faça POST com number definido para exatamente oito dígitos (REGON de nove) ou treze dígitos (REGON de catorze) e mode compute (ou omita mode). A resposta inclui check_digit, with_check, form e o vetor de pesos usado.

Como valido um REGON completo de nove ou catorze dígitos?

Faça POST com a string de nove ou catorze dígitos e mode validate. A resposta inclui valid, check_digit, expected_check_digit e payload (dígitos sem o último). A validação de catorze dígitos também informa base9_valid para o REGON-mãe embutido.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Como o dígito verificador REGON é calculado (formas de 9 e 14 dígitos)

Onde os dígitos verificadores REGON se encaixam em fluxos empresariais poloneses

Casos de uso

Auditar colunas REGON em dados mestres de contratados

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Erros

Notas técnicas

Contrato de entrada, modos e comportamento de erro

Onde os dígitos verificadores REGON se encaixam em fluxos empresariais poloneses

Casos de integração

Completar uma base REGON de 8 dígitos para fixtures de fatura

Validar REGON digitados ou importados na entrada

Perguntas técnicas

obrigado