ForHosting KIT · Validar e conferir

Validar cédula da Costa Rica

Digite 1-0234-0567 e você fica sabendo que é uma cédula de pessoa física com formato válido, guardada como 102340567. A ferramenta também reconhece cédula jurídica, DIMEX e NITE. Ela confere o formato, não o cadastro: não prova que o número existe. 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 de identificação: 1-0234-0567

Você obtém

Tipo de identificação: Pessoa física
Somente dígitos: 102340567
Com hífens: 1-0234-0567

Na Costa Rica, cada pessoa e cada empresa é identificada por um número. Os costarriquenhos têm a cédula de identidad, o documento nacional de identidade, algo como o RG; empresas e associações têm a cédula jurídica, que faz o papel do CNPJ; estrangeiros residentes usam o DIMEX, o documento de identidade de quem mora legalmente no país; e pessoas ou entidades que precisam de um número fiscal sem ter nenhum desses recebem da Hacienda, a autoridade tributária costarriquenha, o NITE. Esta ferramenta confere se o número que você tem em mãos segue o formato de um deles, diz qual é e o devolve de duas formas: só com dígitos e do jeito que se costuma escrever. Ela ajuda na hora de contratar funcionários, cadastrar um fornecedor ou emitir uma nota fiscal eletrônica na Costa Rica, para que um número digitado errado não siga adiante. Ela verifica o formato, não o registro: um número bem formado não prova que exista nem que pertença a quem o informou.

Os quatro documentos e como reconhecê-los

Os formatos vêm da Dirección General de Tributación, a administração tributária costarriquenha, que os publica no Anexos y Estructuras versão 4.4, o documento técnico da nota fiscal eletrônica. A cédula de pessoa física tem 9 dígitos e nunca começa com zero; é escrita em três grupos, como 1-0234-0567. A cédula jurídica tem 10 caracteres: um dígito de tipo, três de classe e seis de número sequencial, como 3-101-123456.

O DIMEX tem 11 ou 12 dígitos, também não começa com zero e é escrito em um bloco só, sem hífens. O NITE também tem 10 dígitos, como a cédula jurídica; a ferramenta os diferencia pelos dígitos iniciais, que só o NITE usa. Você pode colar o número do jeito que estiver, com hífens, espaços ou pontos.

Se a cédula de pessoa física vier com um zero a mais na frente, como alguns sistemas a escrevem, a ferramenta tira esse zero e devolve os 9 dígitos de sempre. Se o número estiver abreviado, sem os zeros de preenchimento de cada grupo, ele fica curto e não passa: complete-o exatamente como aparece no documento.

Como ler o resultado: quatro exemplos

Com 1-0234-0567, a resposta é formato válido, cédula de pessoa física, forma só com dígitos 102340567 e forma com hífens 1-0234-0567. Com 3-101-123456, o formato é de cédula jurídica, que sem hífens fica 3101123456. Com 155812345678, de 12 dígitos, a ferramenta reconhece um DIMEX e o mantém como está, porque esse documento não leva hífens.

Com 12-345, a resposta é inválido: seus 5 caracteres não correspondem a nenhuma identificação costarriquenha. Se você já sabe o que espera receber, pode indicar. Quando você pede a cédula jurídica a um fornecedor e a pessoa digita a própria cédula de pessoa física, o formato está certo, mas não é o que você pediu, e a ferramenta avisa em vez de aceitar.

Guardar a forma só com dígitos faz o mesmo número ficar sempre igual na folha de pagamento, no sistema de faturamento ou na lista de clientes, sem que um hífen ou um espaço a mais faça dois números iguais parecerem diferentes.

O que um formato válido não diz

Nenhum desses números tem dígito verificador; as fontes oficiais não definem nenhum. Isso tem uma consequência prática. Se alguém erra um dígito ou troca dois de lugar, o número continua com o tamanho certo e o formato continua válido, e nenhuma checagem de formato consegue pegar o erro.

Um resultado válido diz que o número está bem formado, não que exista, que esteja ativo nem que pertença à pessoa ou à empresa que o informou. Para isso é preciso consultar quem o emite: o registro civil do Tribunal Supremo de Elecciones para pessoas físicas, o Registro Nacional para pessoas jurídicas, a Dirección General de Migración y Extranjería para o DIMEX e a Hacienda para as inscrições fiscais. Na contratação ou no cadastro de um cliente, confira o número com o documento original.

Uma mudança anunciada na cédula jurídica

O número sequencial da cédula jurídica, seus seis últimos caracteres, vai passar a ser alfanumérico; um exemplo da nova forma é 3-101-A00001. Fala-se no quarto trimestre de 2026 como data prevista, mas não conseguimos confirmá-la em uma fonte oficial, então não a considere definitiva. A ferramenta já aceita uma letra nessa posição, e uma cédula jurídica nova não será recusada por engano.

Se o seu sistema de faturamento ou de folha de pagamento só aceita dígitos nessa parte do número, vale revisar antes que as primeiras apareçam. Em casos fora do comum, como um documento estrangeiro ou uma entidade que não se encaixa nesses formatos, quem dá a palavra final é a instituição que emite o documento ou o seu contador na Costa Rica.

Casos de uso

Contratar um funcionário na Costa Rica

Antes de incluir alguém na folha de pagamento que você declara à CCSS, a previdência social costarriquenha, confira se a cédula ou o DIMEX anotado tem o formato certo. Um dígito a menos aparece na hora, não meses depois.

Emitir uma nota fiscal eletrônica

A nota fiscal eletrônica costarriquenha pede o tipo e o número de identificação do cliente. A ferramenta diz se é cédula física, jurídica, DIMEX ou NITE e entrega o número sem hífens, pronto para copiar.

Cadastrar fornecedores

Ao cadastrar uma empresa fornecedora, indique que você espera uma cédula jurídica. Se alguém digitar por engano a cédula de pessoa física, a ferramenta avisa, mesmo com o formato correto.

Organizar uma lista de clientes ou funcionários

O mesmo número escrito com hífens, espaços ou pontos parece outro registro na planilha. Passar tudo para a forma só com dígitos ajuda a achar duplicados e a cruzar dados sem confusão.

Perguntas frequentes

Quantos dígitos tem a cédula da Costa Rica?

Nove, e ela nunca começa com zero. Costuma ser escrita em três grupos separados por hífens, como 1-0234-0567; a forma só com dígitos é 102340567. Se um sistema a mostra com um zero a mais na frente, é a mesma cédula: a ferramenta tira esse zero.

Quantos dígitos tem o DIMEX?

O DIMEX, documento de identidade dos estrangeiros residentes na Costa Rica, tem 11 ou 12 dígitos e não começa com zero. É escrito em um bloco só, sem hífens, como 155812345678.

Como é o número da cédula jurídica?

Tem 10 caracteres: um dígito de tipo, três de classe e seis de número sequencial, escritos com hífens, como 3-101-123456. Está previsto que a parte sequencial aceite letras, como em 3-101-A00001, e a ferramenta já aceita isso.

O que é o NITE na Costa Rica?

É um número de identificação tributária especial que a Hacienda, a autoridade tributária costarriquenha, atribui a pessoas ou entidades que precisam dele para fins fiscais e não têm cédula nem DIMEX. Tem 10 dígitos, e a ferramenta o diferencia da cédula jurídica pelos dígitos iniciais.

A cédula da Costa Rica tem dígito verificador?

Não. As fontes oficiais não definem dígito verificador para nenhum desses números. Por isso um dígito errado que não muda o tamanho do número não é detectado por uma checagem de formato: confira sempre com o documento.

Se o formato é válido, a cédula existe?

Não necessariamente. O formato válido só mostra que o número está bem formado. Para saber se ele existe e a quem pertence, consulte o Tribunal Supremo de Elecciones, o Registro Nacional, a Migración ou a Hacienda, conforme o documento.

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/verify/cedula-costa-rica

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/verify/cedula-costa-rica \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"1-0234-0567"}'

const res = await fetch("https://api.kit.forhosting.com/verify/cedula-costa-rica", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "id": "1-0234-0567"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/verify/cedula-costa-rica",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "id": "1-0234-0567"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/verify/cedula-costa-rica", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"id":"1-0234-0567"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"id":"1-0234-0567"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/cedula-costa-rica", 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

{
  "id": "1-0234-0567"
}

Exemplo de resposta

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

Ver a documentação completa do KIT →

Executar grátis