ForHosting KIT · Ferramentas para dev

Dígito verificador GSTIN Índia

Para o corpo 27AAPFU0939F1Z o caractere verificador é V, e o GSTIN completo fica 27AAPFU0939F1ZV. Calcule esse último caractere para um formulário ou uma importação, ou confira o GSTIN enviado por um fornecedor antes de salvá-lo. 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
27AAPFU0939F1Z
Você obtém
Modo de cálculo
Compute
Entrada
27AAPFU0939F1Z
Caractere de verificação
V
Com dígito verificador
27AAPFU0939F1ZV

Um GSTIN indiano (Goods and Services Tax Identification Number) é um identificador fiscal alfanumérico de quinze caracteres usado em faturas, e-way bills e registros de cadastro. O último caractere é de verificação e deriva dos catorze primeiros com uma regra fixa de pesos em base trinta e seis, de modo que uma letra ou dígito digitado errado costuma falhar na validação antes de o número ser armazenado. Esta capacidade implementa esse algoritmo no estilo oficial: mapeia cada caractere para um ponto de código de zero a trinta e cinco, multiplica por fatores alternados um e dois da esquerda, dobra cada produto com divisão inteira por trinta e seis mais o resto, soma os hashes e mapeia o resíduo complementar de volta a zero–nove ou A–Z. Use o modo compute quando tiver apenas o corpo de catorze caracteres e precisar do caractere final para um formulário ou importação de dados mestres; use validate quando um parceiro, ERP ou usuário enviar um GSTIN completo de quinze caracteres e precisar de um indicador valid claro mais o caractere esperado para mensagens de erro.

Como o caractere de verificação do GSTIN da Índia é calculado

Um GSTIN tem sempre quinze caracteres quando escrito sem espaços nem pontuação. Os dois primeiros dígitos codificam o estado; os dez seguintes são o permanent account number (PAN) do contribuinte no padrão familiar de cinco letras, quatro dígitos e uma letra; o décimo terceiro caractere distingue entidades que compartilham o mesmo PAN; o décimo quarto costuma ser Z em um cadastro normal de contribuinte; e o décimo quinto é o caractere de verificação que você não deve inventar à mão.

Para calculá-lo, use apenas os catorze primeiros caracteres e converta cada um com o alfabeto de zero a nove e depois A a Z, de modo que zero mapeia ao código zero e Z ao código trinta e cinco. Da esquerda, multiplique os pontos de código sucessivos pelos fatores alternados um, dois, um, dois, e assim por diante. Para cada produto P, some o quociente inteiro de P por trinta e seis mais P módulo trinta e seis a um acumulado.

Após as catorze posições, tome a soma módulo trinta e seis, subtraia esse resto de trinta e seis, reduza de novo módulo trinta e seis para que resto zero vire código de verificação zero, e mapeie o código resultante no mesmo alfabeto. A cadeia completa de quinze caracteres deve carregar exatamente esse caractere final. O algoritmo é determinístico e local: sem chamada de rede ao portal GST, sem catálogo de contribuintes e sem relógio.

Esta ferramenta não consulta se o registro está ativo, não expande um GSTIN em razão social ou nome comercial e não afirma que um checksum válido significa autorização para um regime tributário específico—apenas prova que a sequência está bem formada sob a regra de pesos em base trinta e seis. Em relação a validadores multi-país, a intenção de busca é estreita: quem precisa de uma calculadora do dígito verificador GSTIN da Índia para corpos de catorze caracteres, não um verificador genérico de VAT ou EIN.

Onde os dígitos verificadores GSTIN entram em fluxos reais

Equipes de finanças e dados mestres recebem corpos internos de catorze caracteres e precisam acrescentar o caractere oficial de verificação do GSTIN antes de gravar o identificador em faturas fiscais, cargas de e-invoice ou perfis de vendedor em marketplaces que rejeitam números GST inválidos. Portais de contas a pagar validam GSTINs de quinze caracteres no onboarding de fornecedores para que uma única transposição não crie um fornecedor fantasma e um descompasso de pagamento em reverse charge.

Jobs de qualidade de dados percorrem cada coluna GSTIN em um export de CRM ou ERP, chamam o modo validate e colocam em quarentena linhas com valid false—capturando edições humanas e bugs de geradores. Não trate um controle GSTIN aprovado como prova de registro ativo junto à autoridade fiscal ou de um regime específico; ele só prova que o caractere base-36 é consistente com o corpo de catorze caracteres sob os pesos alternados padrão.

Auditar colunas GSTIN em exports de ERP e CRM

Valide em lote cada GSTIN de quinze caracteres em um arquivo de fornecedores ou clientes e isole as linhas cujo caractere de verificação não coincide mais com o valor esperado recalculado.

O que é o dígito verificador do GSTIN da Índia?

É o décimo quinto caractere de um GSTIN, calculado com pontos de código base-36 e fatores alternados sobre os catorze primeiros caracteres, para que erros de digitação e importação costumem ser detectados antes de o identificador ser armazenado ou impresso em uma fatura fiscal.

O que acontece com comprimento errado, símbolos ou forma inválida?

Um GSTIN completo cujo caractere de verificação não coincide devolve valid false. Tarefas de validação com falha não são cobradas.

A ferramenta de dígito verificador GSTIN da Índia é gratuita?

A ferramenta do navegador é gratuita e roda localmente.

O que significa cada parte de um GSTIN?

Os dois primeiros dígitos são o código do estado; os dez seguintes, o PAN do contribuinte; o décimo terceiro distingue entidades com o mesmo PAN; o décimo quarto costuma ser Z, e o último é o caractere verificador.

Quando devo calcular e quando devo conferir um GSTIN?

Calcule quando você tem só os 14 primeiros caracteres e precisa do último para completar o número. Confira quando recebe um GSTIN completo de 15 caracteres e quer saber se o caractere final bate.

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/gstin-india

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/gstin-india \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"27AAPFU0939F1Z"}'
{
  "number": "27AAPFU0939F1Z"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.gstin_india",
  "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.

Entrada não alfanumérica, comprimentos incorretos e corpos que não seguem a forma padrão estado mais PAN falham com invalid_input em vez de remoção silenciosa, para que você nunca armazene um ID fiscal pela metade. A mesma aritmética pura roda grátis no navegador e no preço de API publicado.

Contrato de entrada, modos e comportamento de erro

Envie um campo number contendo apenas caracteres de A a Z e de zero a nove; letras minúsculas são convertidas automaticamente para maiúsculas. Comprimento errado é um erro explícito que nomeia o modo e o comprimento enviado—catorze em compute, quinze em validate—para que formulários mostrem uma mensagem precisa sem adivinhar. Strings vazias, number ausente, valores de mode inválidos e corpos que falham na forma estado mais PAN falham antes de confiar na soma ponderada e não são cobrados. Prefira compute ao emitir ou completar identificadores; prefira validate ao condicionar uma consulta ou importação a um GSTIN completo de um usuário ou arquivo de parceiro. Espaços, pontos, hífens, barras e outros símbolos são rejeitados como entrada não alfanumérica com invalid_input para que um valor removido em silêncio nunca chegue ao armazenamento. O modo compute é o padrão: o motor exige exatamente catorze caracteres no formato padrão do corpo GSTIN (estado de dois dígitos, segmento PAN de cinco letras, quatro dígitos e uma letra, e dois caracteres finais de entidade e padrão), devolve check_character como um único caractere e with_check como o GSTIN de quinze caracteres que você pode imprimir ou persistir. O modo validate exige exatamente quinze caracteres; a resposta reporta valid true quando o caractere final coincide com o expected_check_character recalculado e inclui payload (os catorze primeiros), os caracteres dados e esperados, e length quinze. Alias como gstin, code e text são aceitos para o mesmo campo de payload, de modo que integrações que já falam «gstin» não precisam renomear. Como o caminho é pure parse sem relógio, aleatoriedade ou rede, o mesmo corpo JSON sempre produz o mesmo resultado na ferramenta gratuita do navegador e na API a US$ 0,002 por solicitação bem-sucedida.

Onde os dígitos verificadores GSTIN entram em fluxos reais

Formulários de cadastro de e-commerce e B2B podem recalcular expected_check_character e mostrar uma correção amigável quando uma empresa indiana cola um número com o último caractere digitado errado.

Completar um corpo GSTIN de 14 caracteres para faturas

Chame o modo compute com o corpo de catorze caracteres, armazene with_check e use o GSTIN de quinze caracteres na sua e-invoice, e-way bill ou perfil de vendedor do marketplace.

Validar GSTINs completos digitados ou importados na entrada

Quando um formulário ou CSV enviar quinze caracteres, chame o modo validate e bloqueie o salvamento se valid for false, exibindo expected_check_character para corrigir um único erro de digitação.

Como calcular um caractere de verificação GSTIN com esta API?

Faça POST com number com exatamente catorze caracteres alfanuméricos e mode compute (ou omita mode). A resposta inclui check_character e with_check (o GSTIN completo de quinze caracteres).

Como validar um GSTIN completo de quinze caracteres?

Faça POST com a string de quinze caracteres e mode validate. A resposta inclui valid, check_character, expected_check_character e payload (caracteres sem o último verificador).

Ver a documentação completa do KIT →