Dígito verificador NPI
A base 123456789 recebe o dígito verificador 3, então o NPI completo é 1234567893. Digite nove dígitos para completar o identificador de um prestador de saúde dos Estados Unidos ou dez para confirmar o último dígito antes de uma cobrança ou de um cadastro. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Número
- 123456789
- Modo de cálculo
- Compute
- Entrada
- 123456789
- Prefixo
- 80840
- Com prefixo
- 80840123456789
O National Provider Identifier dos Estados Unidos é um número de dez dígitos que identifica clínicos individuais e provedores organizacionais em sinistros, cadastros e diretórios sob a HIPAA. Os nove primeiros dígitos são o identificador base emitido pelo NPPES; o décimo é um dígito verificador produzido pelo algoritmo de Luhn após aplicar o prefixo constante 80840 à base. Essa regra faz o NPI se comportar como um identificador no estilo ISO para fins de checksum, sem pretender que seja um cartão de pagamento. Esta capacidade implementa apenas essa regra da CMS: o modo compute aceita exatamente nove dígitos base e devolve o dígito verificador mais o NPI completo de dez; o modo validate aceita um NPI completo de dez dígitos e informa se o dígito final coincide com o valor esperado recalculado.
Como o dígito verificador NPI é calculado com o prefixo 80840
Segundo a especificação dos Centers for Medicare & Medicaid Services, um NPI tem sempre dez dígitos decimais. As posições um a nove formam o identificador base (indivíduos costumam começar com um e organizações com dois, embora esta ferramenta não imponha o tipo de emissor). A posição dez é o dígito verificador.
Para calculá-lo, concatene a constante fixa de cinco dígitos 80840 na frente da base de nove, produzindo uma string de catorze dígitos que imita a carga de um cálculo Luhn no estilo de número de cartão. Aplique o algoritmo clássico double-add-double de Luhn da direita dessa string de catorze: dobre cada segundo dígito começando pelo dígito base mais à direita, porque depois de anexar o verificador esse dígito base fica na posição dois a partir da direita da sequência completa de quinze no estilo ISO.
Quando o dobro de um dígito for maior que nove, subtraia nove (de forma equivalente, some as dezenas e as unidades do produto). Some cada valor ponderado; o dígito verificador é dez menos essa soma módulo dez, módulo dez de novo, para que a sequência completa incluindo o verificador tenha total Luhn divisível por dez. A validação recalcula o dígito esperado a partir dos nove primeiros caracteres após o mesmo prefixo 80840 e o compara com o décimo dígito do NPI enviado.
O algoritmo é determinístico e local: sem chamada ao registro NPPES, sem relógio e sem aleatoriedade. Esta ferramenta não resolve NPI em nomes, não prova taxonomia nem status de inscrição e não contata a CMS: apenas prova que a string de dígitos está bem formada sob a regra oficial Luhn com 80840.
Em comparação com ferramentas Luhn genéricas de cartão ou de IMEI, a intenção de busca aqui é estreita: quem precisa de uma calculadora de dígito verificador NPI para bases de nove dígitos ou um verificador de National Provider Identifier de dez, não uma ferramenta de pagamento ou de dispositivo.
Onde os dígitos verificadores NPI se encaixam em fluxos reais de saúde
Fornecedores de gestão de consultórios e EHR recebem bases internas de nove dígitos em sandboxes de onboarding e devem anexar o dígito verificador Luhn oficial antes que um NPI apareça em sinistros, faturas ou diretórios de provedores. Clearinghouses e pagadores validam NPIs de dez dígitos na admissão de sinistros para que uma única transposição não crie um provedor fantasma e uma transação 837 rejeitada.
Jobs ETL que carregam arquivos mestres de provedores percorrem cada coluna NPI em um CSV ou feed HL7, chamam o modo validate e colocam em quarentena as linhas em que valid é false, capturando tanto edições humanas quanto bugs de geradores em um.
Não trate um NPI que passa a verificação como prova de que o provedor está ativo no NPPES, licenciado em um estado ou inscrito com um pagador; apenas prova que o dígito Luhn é consistente com a base sob os pesos CMS 80840 usados para National Provider Identifiers.
Casos de uso
Auditar colunas NPI em dados mestres de provedores
Valide em lote cada NPI de dez dígitos em um CSV de EHR, credenciamento ou clearinghouse e coloque em quarentena as linhas cujo dígito verificador já não coincida com o valor esperado recalculado.
Perguntas frequentes
O que é um dígito verificador NPI?
É o décimo dígito de um National Provider Identifier dos EUA, calculado com o algoritmo de Luhn após prefixar a constante 80840 aos nove primeiros dígitos, para que erros de digitação e de leitura costumem ser detectados antes de armazenar ou faturar o número.
O que acontece com comprimento errado, letras ou hífens?
Tarefas de validação que falham não são cobradas.
A ferramenta de dígito verificador NPI é gratuita?
A ferramenta do navegador é gratuita e roda localmente.
Como se calcula o dígito verificador do NPI?
Coloca-se 80840 na frente da base de nove dígitos e aplica-se o método de Luhn aos catorze dígitos: dobra-se um a cada dois a partir da direita, subtrai-se nove do que passar de nove e soma-se tudo. O dígito verificador leva o total a um múltiplo de dez.
Um NPI válido significa que o prestador está ativo?
Não. Um resultado válido indica apenas que o último dígito bate com o cálculo. A ferramenta não consulta o registro NPPES e não informa se o prestador está ativo, credenciado ou licenciado.
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
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/npi \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":"123456789"}'const res = await fetch("https://api.kit.forhosting.com/enc/npi", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": "123456789"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/npi",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": "123456789"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/npi", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":"123456789"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":"123456789"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/npi", 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": "123456789"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.npi",
"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
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 voce nunca persista um identificador pela metade. A mesma aritmética pura roda grátis no navegador e no preço publicado da API, sem consulta de rede a registros NPPES e sem afirmar que um checksum válido signifique que o provedor esteja ativo, inscrito ou licenciado.
Contrato de entrada, modos e comportamento de erro
Envie um campo number que contenha apenas caracteres de zero a nove. Comprimento errado é um erro explícito que nomeia o modo e o comprimento enviado —nove para compute, dez para validate— para que formulários cliente possam mostrar «são necessários nove dígitos» sem adivinhar. Strings vazias, number ausente e valores de mode inválidos falham antes de qualquer soma Luhn e não são faturados. Tarefas de validação que rejeitam formato incorreto não são cobradas; uma string bem formada de dez 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 nove dígitos, devolve check_digit como string de um caractere, devolve with_check como o NPI de dez dígitos que voce pode imprimir ou persistir, e também devolve prefix (sempre 80840) e prefixed (80840 mais a base de nove) para trilhas de auditoria e depuração da regra CMS. O modo validate exige exatamente dez dígitos; a resposta informa valid true quando o dígito final coincide com o expected_check_digit recalculado, e sempre inclui payload (os nove primeiros dígitos), check_digit, expected_check_digit, prefix, prefixed e length dez. Aliases como digits, npi e code são aceitos para o mesmo campo de carga, para que integrações que já falam «npi» 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 NPI se encaixam em fluxos reais de saúde
Equipes de credenciamento e de escalas recalculam expected_check_digit quando uma clínica lê um número ao telefone ou cola de um PDF, capturando erros de digitação antes de enviar um contrato ou arquivo de inscrição. Em todo fluxo o contrato é o mesmo: apenas dígitos, comprimento fixo por modo, JSON estruturado que voce 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 NPI de 9 dígitos para fixtures de sinistros
Chame o modo compute com a base de nove dígitos, armazene with_check e use o NPI de dez em sinistros de teste, faturas ou registros sandbox de provedores.
Validar NPIs digitados ou importados na entrada
Quando um formulário, arquivo de escala ou feed de parceiro enviar dez dígitos, chame o modo validate e bloqueie a inscrição se valid for false, mostrando expected_check_digit para corrigir um erro de um só dígito.
Perguntas técnicas
Como calcular um dígito verificador NPI com esta API?
Faça POST com number igual a exatamente nove dígitos e mode compute (ou omita mode). A resposta inclui check_digit, with_check (o NPI completo de dez dígitos) e prefix 80840 para auditoria da regra CMS.
Como validar um NPI completo de dez dígitos?
Faça POST com a string de dez dígitos e mode validate. A resposta inclui valid, check_digit, expected_check_digit e payload (dígitos sem o último).