Metodologia editorial

Esta pagina descreve como as ferramentas do CriarQR sao pesquisadas, implementadas, testadas e mantidas. O portal oferece 16 geradores client-side de QR Code, codigos de barras e QR Pix. Cada implementacao e rastreavel a uma norma tecnica publica (ISO/IEC), um padrao setorial (GS1) ou um manual oficial (Banco Central do Brasil).

1. Escopo e principios

Tres principios orientam o desenvolvimento das ferramentas:

  • Norma primaria. Toda codificacao (QR Code, EAN-13, Code 128, Code 39, vCard, iCalendar, EMV/BRCODE do Pix) segue rigorosamente a norma internacional ou o padrao setorial que a define. Sem improvisacoes.
  • Privacidade por design. Todos os geradores rodam 100% no navegador do usuario. Nenhum dado (chave Pix, CPF, senha de WiFi, contatos) e enviado para nossos servidores.
  • Transparencia. As paginas de ferramentas explicam o formato do payload gerado, os parametros aceitos e o algoritmo de validacao usado.

2. Metodologia dos geradores

Abaixo, as normas e algoritmos adotados por cada categoria de ferramenta:

QR Code (todos os tipos)

  • Norma: ISO/IEC 18004:2015 — Information technology — Automatic identification and data capture techniques — QR Code bar code symbology specification.
  • Biblioteca: qrcode (JavaScript puro).
  • Parametros ajustaveis: nivel de correcao de erros (L/M/Q/H), tamanho em pixels, margem (quiet zone), cores foreground/background.
  • Formatos de saida: PNG, SVG e PDF.

QR Pix (EMV/BRCODE)

  • Norma: Manual do Pix (Banco Central do Brasil) e padrao EMVCo para QR Merchant-Presented.
  • Codificacao TLV: Type-Length-Value conforme padrao EMV. Campo 00 (Payload Format Indicator), 26 (Merchant Account Information com GUI br.gov.bcb.pix), 52 (Merchant Category Code), 53 (Currency 986 — BRL), 54 (Transaction Amount), 58 (Country Code — BR), 59 (Merchant Name), 60 (Merchant City), 62 (Additional Data — TXID) e 63 (CRC16).
  • Validacao: checksum CRC16/CCITT-FALSE sobre os 4 ultimos caracteres, polinomio 0x1021, valor inicial 0xFFFF.
  • Tipos de chave suportados: CPF, CNPJ, email, telefone (E.164) e chave aleatoria (UUID).

Codigos de barras (EAN-13, Code 128, Code 39)

  • Normas: GS1 General Specifications para EAN-13 (prefixos BR 789/790) e ISO/IEC 15417 (Code 128) / ISO/IEC 16388 (Code 39).
  • Digito verificador: algoritmo modulo 10 conforme GS1 para EAN-13.
  • Biblioteca: jsbarcode.

Leitor de QR Code

  • Biblioteca: jsqr — decoder JavaScript puro.
  • Entradas suportadas: upload de imagem, drag-and-drop, colagem direta (clipboard API).
  • Processamento: 100% local; nenhuma imagem sai do navegador.

vCard, WiFi, iCalendar

  • vCard: RFC 6350 (vCard 4.0).
  • WiFi: formato WIFI:T:WPA;S:SSID;P:senha;; conforme padrao Wi-Fi Alliance.
  • Evento (iCalendar): RFC 5545 — VEVENT com DTSTART/DTEND em formato UTC.

3. Referencias normativas

4. Processo editorial

  • Pesquisa. Cada gerador nasce da leitura da norma original (ISO, GS1, RFC ou manual do Bacen). A implementacao segue a especificacao, nao interpretacoes de terceiros.
  • Implementacao. As ferramentas sao escritas em TypeScript puro, com separacao clara entre logica de encoding (em src/lib/) e interface (componentes Svelte).
  • Validacao cruzada. Payloads gerados sao conferidos em leitores independentes (banco real para Pix, apps de leitura para QR, validadores online GS1 para EAN-13) antes de a ferramenta ir ao ar.
  • Revisao editorial. Cada nova ferramenta e cada artigo do glossario passam por revisao da redacao antes da publicacao.

5. Ciclo de revisao

  • Manual do Pix (Bacen): monitorado mensalmente. Quando o Bacen publica nova versao (campos adicionais, alteracoes no TXID, mudancas nas regras de valor), o gerador de QR Pix e atualizado em ate 30 dias.
  • Normas ISO e GS1: revisadas a cada trimestre para confirmar que nao houve edicao nova das especificacoes.
  • Bibliotecas (qrcode, jsbarcode, jsqr): dependencias atualizadas regularmente para incorporar correcoes de seguranca.
  • Ultima revisao editorial desta pagina: 14 de abril de 2026.

6. Canal de correcoes

Encontrou um payload Pix com CRC incorreto, um digito verificador EAN-13 fora do padrao ou um campo faltando em vCard gerado? Entre em contato pela pagina de contato ou envie um e-mail para contato@criarqr.com. Correcoes confirmadas sao aplicadas em ate 5 dias uteis, com registro da data de atualizacao.

7. Bibliografia

8. Limites do conteudo

O CriarQR e um portal educacional e de ferramentas. Nao somos banco, instituicao de pagamento, credenciadora, registradora GS1 nem certificador. Nao emitimos prefixos EAN oficiais (o credenciamento GS1 Brasil e responsabilidade da GS1 Brasil). Para uso comercial em larga escala (etiquetagem em industria, impressao em embalagens homologadas), consulte os servicos de validacao oficiais.