ForHosting KIT · Ferramentas para dev

Conversor UPC-E

O UPC-E 425261 se expande para o UPC-A 042100005264: os zeros suprimidos para embalagens pequenas voltam, fabricante 42100 e produto 00526, e o dígito verificador comum, 4, é calculado. A compressão faz o caminho inverso. 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

Código: 425261
Modo de cálculo: Expand

Você obtém

Direção: expand
Código de entrada: 425261
Sistema numérico: 0
Upc e: 425261

O UPC-E é a forma de seis dígitos com zeros suprimidos de um código de barras varejista UPC-A, usada em embalagens pequenas onde o símbolo de doze dígitos não cabe. Sistemas de armazém, impressoras de etiquetas e bases de produtos quase sempre armazenam a forma expandida UPC-A, então operadores precisam converter entre as duas sem adivinhar quais zeros foram omitidos. Este conversor UPC-E expande um código UPC-E válido para o UPC-A equivalente, comprime um UPC-A elegível de volta para UPC-E e sempre calcula ou verifica o dígito verificador compartilhado para detectar na hora um dígito final digitado errado. O modo auto escolhe a direção pelo comprimento da sequência; expand e compress forçam um único sentido em scripts e formulários.

Como funcionam a expansão e a compressão UPC-E

Um código UPC-A padrão tem doze dígitos: um dígito de sistema numérico (0 ou 1 para UPC-E varejista), um código de fabricante de cinco dígitos, um código de produto de cinco dígitos e um dígito verificador mod-10 calculado com pesos de três e um da esquerda para a direita. O UPC-E guarda apenas seis dígitos de dados ao suprimir sequências de zeros em certos padrões de fabricante e produto definidos pela GS1.

A expansão reconstrói os zeros ausentes a partir do sexto dígito de dados: quando esse dígito é 0, 1 ou 2, o fabricante termina com esse dígito mais dois zeros e o produto é 00 mais os três dígitos centrais; quando é 3, o fabricante termina com dois zeros e o produto é 000 mais dois dígitos; quando é 4, o fabricante termina com um zero e o produto é 0000 mais um dígito; quando é 5 a 9, mantém-se o fabricante de cinco dígitos e o produto é 0000 mais esse dígito final.

O sistema numérico é prefixado, o corpo de onze dígitos recebe o dígito verificador e o resultado é um UPC-A canônico de doze dígitos. A compressão é o inverso: só códigos com sistema 0 ou 1 e um padrão de zeros compatível podem virar UPC-E; todo o resto é reportado como não comprimível. Não há ponto flutuante, amostragem aleatória nem tabelas externas—apenas ramos por dígito e uma soma ponderada.

Entradas, modos e campos da resposta

Envie o campo obrigatório code com os dígitos do código de barras. Espaços, hífens, sublinhados e pontos são removidos para que valores copiados da embalagem ainda sejam analisados. Sete dígitos são sistema mais seis dados quando o primeiro é 0 ou 1, ou seis dados mais dígito verificador caso contrário.

Oito dígitos são sistema, seis dados e dígito verificador; um dígito verificador errado falha na validação. Onze dígitos são UPC-A sem dígito verificador—a ferramenta calcula o dígito e depois comprime. Doze dígitos são UPC-A completo com verificação.

Treze dígitos só são aceitos quando a string é a forma EAN-13 de um UPC-A que começa com 0.

Onde um conversor UPC-E agrega valor

Equipes de operações no varejo colam códigos curtos de embalagens pequenas de cosméticos, doces e eletrônicos em ferramentas de inventário que só aceitam UPC-A de doze dígitos, e precisam de expansão que nunca invente zeros. Gráficas e fabricantes de marca própria desenham símbolos com zeros suprimidos para artes compactas e devem comprimir um UPC-A de catálogo em UPC-E somente quando o padrão GS1 permite, falhando de forma clara no contrário para não imprimir um SKU não elegível.

Scripts de garantia de qualidade fazem ida e volta em milhares de códigos: expandir, comprimir e afirmar igualdade, capturando dígitos verificadores errados antes de uma tiragem. Combine esta capacidade com validação geral de dígito verificador ou geração de imagem de código de barras quando também precisar de provas multi-simbologia ou símbolos imprimíveis, mas mantenha a expansão e compressão UPC-E em sua própria página de destino para que a intenção de busca continue de propósito único.

Prefira auto em interfaces de colagem, expand para lotes de códigos curtos e compress em exportações de catálogo que só devem virar UPC-E quando elegíveis.

Casos de uso

Recebimento varejista de embalagens pequenas

Operadores de recebimento expandem símbolos UPC-E de seis dígitos de packs compactos para UPC-A de doze dígitos em arquivos de leitura WMS que só armazenam a forma completa.

Design de etiquetas e marca própria

Designers comprimem valores UPC-A de catálogo em UPC-E quando o padrão de zeros permite, e recebem erro claro quando um SKU não pode usar supressão de zeros de forma válida.

Perguntas frequentes

O que este conversor UPC-E faz?

Ele expande UPC-E (6–8 dígitos) para UPC-A completo de 12 dígitos e comprime UPC-A elegível (ou EAN-13 com 0 inicial) de volta para UPC-E, sempre calculando ou verificando o dígito verificador compartilhado.

Quais sistemas numéricos são suportados?

A supressão de zeros UPC-E aplica-se apenas aos sistemas numéricos 0 e 1.

Como o modo auto escolhe entre expandir e comprimir?

Auto expande códigos de 6–8 dígitos e comprime códigos de 11–13 dígitos. Force expand ou compress quando precisar de uma única direção independentemente do comprimento.

Por que meu UPC-A não pode ser comprimido para UPC-E?

Só têm forma de seis dígitos os códigos com sistema numérico 0 ou 1 cujo fabricante e produto contêm um dos padrões de zeros definidos pela GS1. Qualquer outro é indicado como não compressível, em vez de virar uma etiqueta errada.

Como os zeros que faltam são recolocados?

Quem decide é o sexto dígito de dados. Com 0, 1 ou 2, o código do fabricante termina nesse dígito mais dois zeros; com 3, em dois zeros; com 4, em um zero; com 5 a 9 o fabricante fica inteiro e o produto vira quatro zeros mais esse dígito.

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/upce

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/upce \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"425261"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/upce",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "code": "425261"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"code":"425261"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/upce", 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

{
  "code": "425261"
}

Exemplo de resposta

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

Códigos não comprimíveis, com dígito verificador errado ou com sistema numérico não suportado são rejeitados com invalid_input em vez de um rótulo silenciosamente incorreto. Chamadas API bem-sucedidas custam o preço base publicado US$ 0,002 por item.

Entradas, modos e campos da resposta

Seis dígitos são tratados como dados UPC-E sob sistema numérico 0 por padrão, ou 0 ou 1 quando você define number_system. O modo auto (padrão) expande comprimentos até oito e comprime de onze a treze; expand e compress forçam uma direção e lançam invalid_input quando o comprimento não combina. Aceitam-se os aliases text, value, input, barcode e upc para code; op, action e direction podem substituir mode; ns, numberSystem e system podem substituir number_system. Uma resposta bem-sucedida sempre inclui mode, direction, code_in, number_system, upc_e (seis dígitos de dados), upc_e_full (oito com sistema e verificador), upc_a (doze), manufacturer_code, product_code, check_digit e valid igual a true. Entradas ausentes, vazias, não numéricas, longas demais, não comprimíveis ou com dígito verificador incorreto falham com invalid_input e não são cobradas no caminho pré-pago. O preço de chamadas bem-sucedidas é a base publicada de US$ 0,002 por item.

Onde um conversor UPC-E agrega valor

Listagens de e-commerce muitas vezes mostram um código de seis dígitos de uma planilha do fornecedor enquanto o marketplace exige GTIN-12; converter por este endpoint mantém a automação determinística. Cada chamada bem-sucedida custa o preço base US$ 0,002 sem tokens de modelo e sem rede de saída; validação falha não consome saldo.

Casos de integração

Fixtures de QA e feeds de marketplace

Pipelines fazem ida e volta expand/compress em testes golden e convertem códigos curtos do fornecedor em GTIN-12 para listagens sem adivinhar zeros manualmente.

Perguntas técnicas

E se o meu UPC-A não for comprimível?

Se os dígitos de fabricante e produto não coincidirem com um padrão GS1 de supressão de zeros, a solicitação falha com invalid_input explicando que o código não é comprimível para UPC-E.

Quanto custa o conversor UPC-E?

A ferramenta no navegador é gratuita. Solicitações API usam o saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Como funcionam a expansão e a compressão UPC-E

Entradas, modos e campos da resposta

Onde um conversor UPC-E agrega valor

Casos de uso

Recebimento varejista de embalagens pequenas

Design de etiquetas e marca própria

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

Entradas, modos e campos da resposta

Onde um conversor UPC-E agrega valor

Casos de integração

Fixtures de QA e feeds de marketplace

Perguntas técnicas

obrigado