Inkbeep

Ajuda & documentação

Tudo sobre como a Inkbeep funciona — as mesmas explicações dos ícones ⓘ, reunidas em um só lugar. Pesquise ou pule para um capítulo.

Primeiros passos

Escolha o código certo, digite os dados, confira se apita, baixe. Esse é todo o fluxo — aqui está o que acontece por trás.

Qual código para quê?

EAN-13/UPC-A são os códigos do varejo — precisam de um número licenciado pela GS1 e leem em qualquer caixa. Code 128 e Code 39 carregam texto livre para logística, ingressos e etiquetas internas. ITF-14 vai em caixas de transporte, GS1 DataBar/GS1-128 carregam peso, datas e lote. QR codes guardam links e textos mais longos e são lidos por qualquer câmera de celular; Data Matrix é a opção 2D compacta para peças pequenas e farmácia. Na dúvida: prateleira de loja → EAN-13, tudo que as pessoas escaneiam com o celular → QR.

Relacionado:Como funciona a verificação "It beeps"Por que a câmera do meu celular não reage a este código?

Como funciona a verificação "It beeps"

Todo código é decodificado de volta antes do download — QR codes com jsQR e códigos de barras com o leitor ZXing, ambos no seu navegador. Verde significa que um leitor independente recuperou exatamente o que você digitou; vermelho, que não conseguiu, e o arquivo não deve ser usado assim. A verificação roda nos mesmos pixels (ou, no modo impressão, na mesma geometria) do arquivo que você baixa — o que apita é o que você recebe. Ela não substitui uma prova física: sempre escaneie um teste impresso antes de uma tiragem grande.

Relacionado:Por que a câmera do meu celular não reage a este código?Correção de erros e logotipos

Por que a câmera do meu celular não reage a este código?

É intencional. O app de câmera integrado só age sobre códigos QR, porque um QR geralmente contém um link que o telefone pode abrir. Um código de barras comercial é apenas um número — a câmera o lê, mas não tem o que fazer com ele, então não mostra nada. O código escaneia perfeitamente em caixas e em apps que consultam produtos. A verificação aqui decodifica o código com um leitor independente (zxing) como prova de que é legível por máquina.

Relacionado:Como funciona a verificação "It beeps"Qual código para quê?

Tela ou gráfica

O mesmo código é exportado de forma diferente para uma tela e para uma impressora offset. Estas são as configurações que importam e o que fazem.

Tela ou gráfica?

Tela gera arquivos para uso digital e impressoras de escritório — PNG/JPG em alta resolução, SVG para a web e um PDF em RGB (vetor verdadeiro, nítido em qualquer tamanho). Gráfica gera um PDF vetorial pronto para impressão em DeviceCMYK com Bar Width Reduction — o que uma gráfica ou um designer de embalagens pede.

Relacionado:Resolução PNG/JPG Cores CMYK Bar Width Reduction (BWR)

Resolução PNG/JPG

100 % exporta a 6 pixels por módulo — a largura da barra (ou quadrado QR) mais fina. É mais que suficiente para tela e impressoras de escritório. Aumente quando o código for ampliado em um layout ou impresso em tamanho grande; diminua só para miniaturas web pequenas. O arquivo é sempre renderizado de novo no tamanho escolhido, nunca ampliado, então as bordas ficam nítidas.

Relacionado:Tela ou gráfica?

Dimensão X e escala

A dimensão X é a largura da barra mais estreita do código — todas as outras barras são múltiplos exatos dela. 100% equivale ao tamanho nominal GS1 de 0,33 mm. Aumente a escala para leitura a distância; nunca fique abaixo de 80% em códigos que serão escaneados no caixa do varejo.

Relacionado:Bar Width Reduction (BWR)Tela ou gráfica?

Bar Width Reduction (BWR)

Na impressão, a tinta se espalha um pouco e deixa as barras mais grossas do que no arquivo (ganho de ponto). O BWR compensa desenhando cada barra ligeiramente mais estreita de antemão, para que o resultado impresso saia correto. Pergunte à sua gráfica o valor recomendado — 10–40 μm é típico para offset; use 0 em impressoras térmicas de etiquetas.

Relacionado:Dimensão X e escala Cores CMYK

Cores CMYK

CMYK (ciano, magenta, amarelo, preto) é como as gráficas misturam tinta. Só quer um código preto? Deixe o padrão como está (K = 100). Valores personalizados só importam quando o código precisa ser impresso em uma cor de marca — apenas cores escuras e de alto contraste sobre fundo claro, e sempre confirme com a sua gráfica.

Relacionado:Tela ou gráfica?Bar Width Reduction (BWR)

O que é um PDF híbrido?

Os módulos do QR continuam sendo vetor puro em DeviceCMYK com BWR — escaláveis sem limite, exatamente o que uma gráfica quer. O logo/emoji central não tem forma vetorial exata, então é incorporado como imagem RGB de alta resolução com transparência no mesmo arquivo. A maioria das gráficas aceita isso em impressão digital; para offset ou cores especiais, consulte antes. A correção de erros está travada em H (30%) e a pré-visualização é verificada por decodificação COM o logo no lugar — o código continua escaneando.

Relacionado:Tela ou gráfica?Correção de erros e logotipos

Designer de QR

Códigos estilizados, logotipos e fotos — e o que os mantém escaneáveis.

Correção de erros e logotipos

Um QR carrega dados redundantes para continuar legível mesmo com uma parte coberta ou danificada. O nível H (o mais alto, ~30 %) fica travado no designer para que um logotipo ou emoji centralizado nunca consuma a margem de segurança real. A verificação então prova que aquele código específico ainda decodifica com o logotipo no lugar. Mantenha o logotipo no centro e nunca toque nos três quadrados de posicionamento.

Relacionado:Como funciona a verificação "It beeps"O que é um PDF híbrido?QR com foto (meio-tom)Designer de QR →

QR com foto (meio-tom)

Cada módulo é dividido em 3×3 subpixels. O pixel central sempre carrega o valor real do código; os oito externos reticulam sua foto. Os padrões de posicionamento e sincronização nunca são tocados. O resultado é um código real com sua imagem entrelaçada — imprima com pelo menos 3×3 cm e teste com o celular antes de usar.

Relacionado:Correção de erros e logotipos Como funciona a verificação "It beeps"Designer de QR →

QR codes dinâmicos

Códigos que você pode redirecionar depois de imprimir, com estatísticas de escaneamento que não podem ser infladas.

O que é um QR code dinâmico?

Um QR comum codifica o próprio link — impresso, nunca mais muda. Um código dinâmico codifica um link curto inkbeep.com/r/… que redirecionamos para o seu destino. Você pode trocar o destino a qualquer momento (o código impresso continua funcionando) e ver quantas vezes, onde e em quais dispositivos foi escaneado. Quem escaneia é enviado direto adiante; nunca mostramos uma página intermediária.

Relacionado:Contas sem senha Quais destinos são permitidos?Como os "únicos" são contados Beta gratuito — o que isso significa Conta →

Contas sem senha

Só os QR dinâmicos precisam de conta. Você informa seu e-mail, enviamos um link de uso único (válido por 15 minutos) e, ao clicar, você fica conectado naquele dispositivo por 30 dias. Não existe senha, então nada pode vazar. A sessão é um cookie httpOnly estritamente necessário.

Relacionado:O que é um QR code dinâmico?Privacidade em resumo Conta →

Quais destinos são permitidos?

Qualquer página pública http:// ou https://. Não permitido: endereços locais/privados, encurtadores de URL (bit.ly, tinyurl …) e outros links curtos da Inkbeep — encadear redirecionamentos esconde o destino real de quem escaneia, exatamente o que o phishing faz. Você pode trocar o destino a qualquer momento; o código impresso continua funcionando. Limite do beta: 10 códigos dinâmicos por conta.

Relacionado:O que é um QR code dinâmico?Como os "únicos" são contados

Como os "únicos" são contados

Brutos = cada escaneamento real que chegou ao link. Únicos = um por dispositivo e dia: fazemos um hash do IP + assinatura do navegador + data com um sal secreto e contamos esse hash uma vez por dia — o IP em si nunca é armazenado. Pré-visualizações de links (Slack, WhatsApp, iMessage, Teams …), rastreadores e scripts são filtrados e mostrados à parte, e um dispositivo que escaneia mais de 10 vezes por minuto deixa de ser contado. "Únicos" pode SUBcontar (várias pessoas no mesmo Wi-Fi com o mesmo modelo de celular parecem iguais) — preferimos isso a um número que possa ser inflado.

Relacionado:O que é um QR code dinâmico?Privacidade em resumo

Beta gratuito — o que isso significa

QR codes dinâmicos são gratuitos durante o beta, com limite de 10 códigos por conta. Os códigos que você criar agora continuam gratuitos — se houver preços depois, eles valem para códigos novos ou limites maiores, nunca para códigos já impressos. Um código impresso é uma promessa, e é assim que o tratamos.

Relacionado:O que é um QR code dinâmico?Conta →

Lote, etiquetas, validação e API

As ferramentas em volta do gerador.

Lote e folhas de etiquetas

O modo lote gera até 500 códigos por execução a partir de uma lista, um CSV ou uma sequência numérica e devolve um ZIP; linhas que não podem ser codificadas são listadas em _errors.txt. As folhas de etiquetas colocam códigos em modelos A4 comuns (Avery e compatíveis) como PDF pronto para impressão — imprima em 100 %, nunca "ajustar à página", e sempre teste uma folha em papel comum antes.

Relacionado:Bar Width Reduction (BWR)API Lote →

API

Todo gerador está disponível como uma API HTTP simples que retorna PNG, SVG ou PDF. O uso anônimo tem limite por IP; uma chave gratuita registrada o amplia. A documentação da API traz os endpoints e parâmetros exatos.

Relacionado:Lote e folhas de etiquetas API →

Privacidade

O que armazenamos, o que nunca armazenamos.

Privacidade em resumo

A Inkbeep não define cookies a menos que você entre para usar códigos dinâmicos. A geração de códigos de barras e QR funciona sem conta e o designer de QR roda inteiramente no seu navegador. A análise (Google Analytics) só carrega depois que você aceita no banner. As estatísticas de escaneamento de códigos dinâmicos nunca armazenam o IP de quem escaneia — veja a página de privacidade.

Relacionado:Contas sem senha Como os "únicos" são contados /privacy →