ForHosting KIT · Finanças e dinheiro

Dígito verificador GTIN

Digite os dígitos iniciais 629104150021 e receba o dígito verificador 3 e o código completo 6291041500213, um GTIN-13. Pegue um código de produto digitado errado antes que ele chegue a uma etiqueta, a um varejista ou a um marketplace. 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
Dígitos
629104150021
Você obtém
Dígito verificador
3
GTIN
6291041500213
Comprimento dos dados
12
Comprimento do GTIN
13

Um Global Trade Item Number (GTIN) é o identificador GS1 impresso como código de barras EAN, UPC ou ITF em packs de consumo, packs internos e unidades logísticas. O último caractere é um dígito verificador calculado a partir dos dígitos iniciais, para que um erro de digitação ou uma substituição do scanner costuma ser rejeitado antes de o código ser armazenado, impresso ou enviado a um marketplace. Esta calculadora de dígito verificador GTIN aplica a regra oficial GS1 módulo 10: uma soma ponderada alternada contada da direita da carga, com o dígito inicial mais à direita multiplicado por três e os pesos um e três em direção à esquerda. O dígito verificador é o valor que torna essa soma um múltiplo de dez. Envie os dígitos iniciais de um GTIN-8, GTIN-12, GTIN-13 ou GTIN-14 —sem o dígito verificador— e a resposta devolve o dígito verificador, o GTIN completo, a soma ponderada e a família quando o comprimento da carga é padrão.

Como o dígito verificador GS1 de um GTIN é calculado

Um GTIN termina sempre com um único dígito verificador que a marca não escolhe: é uma função pura dos dígitos iniciais que o precedem. A GS1 usa uma mesma regra módulo 10 para GTIN-8, GTIN-12 (UPC-A), GTIN-13 (EAN-13) e GTIN-14, por isso esta calculadora pode completar qualquer uma dessas famílias só com a carga. Comece pela direita dos dígitos iniciais.

Multiplique o dígito mais à direita da carga por três, o seguinte à esquerda por um, o seguinte por três, e continue alternando até que cada dígito inicial tenha um peso. Some os produtos ponderados para obter a soma ponderada. O dígito verificador é dez menos essa soma módulo dez, com um segundo módulo dez para que resto zero produza o dígito zero e não dez.

Depois de acrescentar o dígito verificador, o mesmo padrão três-um da direita para a esquerda aplicado ao código completo resulta em um múltiplo de dez: esse é o teste de aceitação que um scanner ou um sistema de armazém deve aplicar. Não é o algoritmo de Luhn dos cartões de pagamento: o Luhn dobra cada segundo dígito a partir da direita e parte produtos maiores que nove, enquanto a GS1 usa um peso estrito de três ou um e nunca parte.

O cálculo é local e determinístico: sem chamada ao registro GS1, sem rede e sem relógio. Esta ferramenta não atribui prefixos de empresa, não desenha simbologia de barras e não prova registro GS1; só devolve o dígito verificador que a especificação exige a partir dos dígitos iniciais que você já tem. Os comprimentos típicos de carga são sete dígitos para GTIN-8, onze para GTIN-12, doze para GTIN-13 e treze para GTIN-14, e esses comprimentos são rotulados no campo family quando coincidem.

Onde uma calculadora de dígito verificador GTIN se paga

Equipes de catálogo e PIM recebem strings de prefixo de empresa mais referência de artigo de sistemas internos de SKU e precisam acrescentar o dígito verificador GS1 oficial antes de publicar o código a um varejista, um marketplace ou uma etiqueta de envio. Aplicativos de recebimento no varejo recalculam o dígito verificador a partir dos dígitos iniciais de um GTIN escaneado para que uma única transposição não crie um SKU fantasma nem um descompasso de estoque em relação ao aviso antecipado de expedição.

Formulários de onboarding de e-commerce podem mostrar o dígito verificador esperado ao lado de um campo de colagem e bloquear o envio quando o caractere final que o vendedor digitou não coincide, o que sai mais barato do que uma rejeição posterior do anúncio. Jobs de qualidade de dados percorrem cada coluna GTIN de uma exportação de catálogo, removem o último caractere, recalculam e colocam em quarentena as linhas cujo dígito armazenado já não coincide, capturando edições humanas e bugs de geradores que preencheram a família com o comprimento errado.

Em comparação com um validador só de GTIN-14 ou um verificador de barras de várias simbologias, a intenção de busca aqui é a frase genérica que as pessoas digitam: um dígito verificador GTIN a partir dos dígitos iniciais, não um modo logístico de catorze dígitos nem um caminho específico de ISBN. Não trate um dígito verificador correto como prova de titularidade de marca nem de registro GS1; só prova que o dígito mod-10 é consistente com a carga sob os pesos GS1 padrão.

Detectar GTINs digitados errado no recebimento ou no onboarding

Recalcule o dígito verificador a partir dos dígitos iniciais de um GTIN escaneado ou colado e bloqueie a armazenagem ou o anúncio quando o caractere final não coincidir.

Auditar colunas GTIN em catálogos e exportações EDI

Remova o último caractere de cada GTIN armazenado, recalcule com esta calculadora e coloque em quarentena as linhas cujo dígito verificador já não coincida com a soma ponderada GS1.

O que é um dígito verificador GTIN?

É o último dígito de um Global Trade Item Number, calculado com uma soma ponderada alternada GS1 módulo 10 para que erros de um único dígito ao digitar ou escanear sejam em geral detectados antes de armazenar ou imprimir o código.

Quais comprimentos de GTIN são aceitos?

A mesma regra GS1 cobre GTIN-8, GTIN-12, GTIN-13 e GTIN-14. Quando o comprimento da carga é 7, 11, 12 ou 13, o campo family nomeia esse tipo de GTIN.

O que acontece se a entrada contiver letras, espaços ou hífens?

O motor nunca recorta pontuação em silêncio, de modo que uma colagem com hífens não pode virar um código de produto errado. A validação falha não é faturada.

A calculadora de dígito verificador GTIN é gratuita?

A ferramenta do navegador é gratuita e roda localmente.

Como confiro um GTIN que eu já tenho?

Tire o último dígito, digite o restante e compare o dígito verificador obtido com o impresso. Se forem diferentes, o código foi digitado ou lido errado. Um código correto também passa no teste completo: com pesos três e um a partir da direita, a soma é múltipla de dez.

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/fin/gtin-check-digit

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/fin/gtin-check-digit \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"digits":"629104150021"}'
{
  "digits": "629104150021"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.gtin_check_digit",
  "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.

max_digits32
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.

Qualquer caractere que não seja dígito falha com invalid_input em vez de um recorte silencioso, de modo que uma colagem com hífens nunca vira um código de produto errado. A mesma aritmética pura alimenta a ferramenta gratuita do navegador e o caminho da API pré-paga.

Contrato de entrada, formato da resposta e erros

Uma string vazia ou um campo ausente também falha antes de qualquer soma ponderada. Quando o comprimento da carga é sete, onze, doze ou treze, family é GTIN-8, GTIN-12, GTIN-13 ou GTIN-14 respectivamente; outros comprimentos omitem family em vez de inventar um nome. O exemplo padrão 629104150021 é um corpo GTIN-13 de doze dígitos cujo dígito verificador é três, de modo que gtin passa a 6291041500213. A validação falha não é faturada. Faça POST de um corpo JSON com digits igual apenas aos caracteres iniciais do GTIN: não inclua o dígito verificador que você deseja calcular. O campo deve ser uma string de caracteres de zero a nove; aliases como number, text, gtin, code e payload são aceitos para que integrações que já usam esses nomes não precisem renomear. Zeros à esquerda importam (um corpo UPC-A costuma começar com zero), então envie uma string JSON e não um número JSON se a carga puder começar com zero. Espaços, hífens, letras e pontuação são caracteres não dígito e falham com invalid_input nomeando o campo digits, em vez de serem recortados em silêncio. Em caso de sucesso, o corpo ecoa digits, devolve check_digit como string de um caractere de zero a nove, devolve gtin como o identificador completo (carga mais dígito verificador), informa payload_length e gtin_length, inclui weighted_sum para auditorias e define algorithm como gs1-mod-10. Como o caminho é parse puro sem relógio, aleatoriedade nem rede, o mesmo corpo JSON produz sempre o mesmo resultado JSON na ferramenta gratuita do navegador e na API a US$ 0,002 por solicitação bem-sucedida. Mantenha as solicitações em uma string curta de dígitos; este endpoint calcula um dígito verificador, não consulta produtos nem desenha barras.

Onde uma calculadora de dígito verificador GTIN se paga

Gráficas que emitem símbolos EAN-13, UPC-A ou ITF-14 fixam gtin nos testes para que a biblioteca de código de barras e esta API nunca divirjam. Em todo fluxo o contrato é o mesmo: só dígitos, 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 contém um caractere que não é dígito.

Completar um GTIN para etiquetas e anúncios

Envie os dígitos iniciais da carga, armazene check_digit e gtin e leve o identificador completo a uma impressora de etiquetas EAN-13, UPC-A ou ITF-14 ou a um formulário de anúncio em marketplace.

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

Faça POST com digits igual à carga inicial somente (sem dígito verificador). Os comprimentos típicos são 7, 11, 12 ou 13. A resposta inclui check_digit e gtin (o identificador completo).

Ver a documentação completa do KIT →