Importe QR Codes em massa de um arquivo CSV

Você pode importar seus QR Codes existentes para o CodeQR pela importação de CSV. É útil quando você tem muitos QR Codes para criar ou quer migrar de outro provedor.

Passo 1: prepare seu arquivo CSV

Antes de enviar, confirme que seu arquivo CSV está formatado corretamente. Ele deve ter as seguintes colunas:

Colunas obrigatórias

FORMAT — Obrigatória: Sim · Descrição: Define se o QR Code é dinâmico ou estático. · Valores aceitos: dynamic, static
TYPE — Obrigatória: Sim · Descrição: O tipo de conteúdo do QR Code. · Valores aceitos: url, text, email, wifi, phone, vcard, crypto, sms, facetime, geo, pix
FLEXIBLE — Obrigatória: Sim · Descrição: Indica se o conteúdo do QR Code pode ser editado depois da criação. · Valores aceitos: true, false, yes, no, sim, não, 1, 0
VALUE — Obrigatória: Sim · Descrição: O conteúdo codificado no QR Code. · Valores aceitos: Depende de TYPE, conforme a tabela abaixo

Colunas opcionais

TRACK_CONVERSION — Obrigatória: Não · Descrição: Ativa o rastreamento de conversões para este QR Code. · Valores aceitos: true, false, yes, no, sim, não, 1, 0
PRE_REDIRECTION — Obrigatória: Não · Descrição: Mostra uma página antes do redirecionamento. · Valores aceitos: true, false, yes, no, sim, não, 1, 0
PAGE_URL — Obrigatória: Não · Descrição: URL da página personalizada, quando PRE_REDIRECTION é true. · Valores aceitos: URL válida
PAGE_ID — Obrigatória: Não · Descrição: ID de uma página que já existe no CodeQR. · Valores aceitos: Texto com o ID da página

Entendendo os tipos de QR Code

Cada tipo de QR Code espera um formato específico na coluna VALUE:

url — Descrição: URL de site · Exemplo de formato do VALUE: https://example.com
text — Descrição: Texto simples · Exemplo de formato do VALUE: Olá, este é o meu conteúdo de texto
email — Descrição: Endereço de e-mail · Exemplo de formato do VALUE: contato@example.com
phone — Descrição: Número de telefone · Exemplo de formato do VALUE: +5511999999999
sms — Descrição: Mensagem SMS · Exemplo de formato do VALUE: +5511999999999
wifi — Descrição: Credenciais de rede Wi-Fi · Exemplo de formato do VALUE: WIFI:T:WPA;S:NomeDaRede;P:senha;;
vcard — Descrição: Cartão de contato · Exemplo de formato do VALUE: Texto no formato vCard
geo — Descrição: Localização geográfica · Exemplo de formato do VALUE: geo:40.7128,-74.0060
crypto — Descrição: Endereço de criptomoeda · Exemplo de formato do VALUE: bitcoin:1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2
facetime — Descrição: Chamada de FaceTime · Exemplo de formato do VALUE: facetime:usuario@example.com
pix — Descrição: Pagamento Pix · Exemplo de formato do VALUE: Chave Pix ou código EMV

QR Codes dinâmicos e estáticos

Entender a diferença entre QR Codes dinâmicos e estáticos é importante:

QR Codes estáticos com FORMAT static

O conteúdo é codificado diretamente no QR Code
Não pode ser alterado depois da criação
FLEXIBLE precisa ser false
VALUE é obrigatório e contém o conteúdo em si

QR Codes dinâmicos com FORMAT dynamic

O QR Code aponta para uma URL curta que redireciona para o seu conteúdo
O conteúdo pode ser alterado a qualquer momento, sem reimprimir o QR Code
FLEXIBLE precisa ser true
VALUE pode ficar vazio (para definir depois) ou conter o destino inicial

Observações sobre o formato do CSV

Use ponto e vírgula (;) ou vírgula (,) como delimitador — os dois são aceitos e detectados automaticamente
Coloque os valores entre aspas se eles contiverem caracteres especiais ou vírgulas
Os valores booleanos aceitam: true, false, yes, no, sim, não, 1, 0
Os nomes das colunas não diferenciam maiúsculas de minúsculas no mapeamento

Arquivos CSV de exemplo

Exemplo 1: QR Codes estáticos

FORMAT,TYPE,FLEXIBLE,VALUE
static,url,false,https://example.com/page1
static,phone,false,+5511999999999
static,text,false,Olá, mundo
static,email,false,contato@empresa.com

Exemplo 2: QR Codes dinâmicos

FORMAT,TYPE,FLEXIBLE,VALUE,TRACK_CONVERSION
dynamic,url,true,https://example.com/promo,true
dynamic,vcard,true,,false
dynamic,url,true,https://loja.example.com,true

Exemplo 3: misto, com recursos opcionais

FORMAT,TYPE,FLEXIBLE,VALUE,TRACK_CONVERSION,PRE_REDIRECTION,PAGE_URL
static,url,false,https://example.com/docs,false,false,
dynamic,url,true,https://example.com/landing,true,true,https://minhapagina.com/bem-vindo
dynamic,vcard,true,,false,false,

Você também pode baixar um CSV de exemplo direto na janela de importação.

Passo 2: abra a janela de importação

Na sua lista de QR Codes, clique na seta ao lado do botão Criar QR Code e escolha Importar do CSV.

Passo 3: envie seu arquivo CSV

A janela Importar arquivo CSV abre com uma área de envio de arquivo. Você pode:

Clicar na área de envio e escolher seu arquivo CSV, ou
Arrastar e soltar seu arquivo CSV na área de envio

Atenção: o tamanho máximo do arquivo é 2 MB. Somente arquivos .csv são aceitos.

Você também pode clicar em Baixar CSV de exemplo para obter um arquivo modelo no formato correto.

Passo 4: mapeie suas colunas

Depois do envio, o CodeQR detecta as colunas do seu arquivo CSV e tenta mapeá-las para os campos correspondentes. Cada linha do mapeamento tem uma lista com as colunas do seu arquivo à esquerda e o campo de destino à direita; os campos obrigatórios aparecem marcados com um asterisco. Revise e ajuste o que for preciso.

Mapeamentos obrigatórios

Mapeie as quatro colunas obrigatórias:

Format → sua coluna FORMAT
Type → sua coluna TYPE
Flexible → sua coluna FLEXIBLE
Value → sua coluna VALUE

Os nomes dos campos de destino e das seções opcionais aparecem em inglês na janela de importação, mesmo com o app em português.

Recursos opcionais

Você pode ativar recursos adicionais nas chaves das seções:

Conversion Tracking: mapeie uma coluna para ligar ou desligar o rastreamento de conversões por QR Code
Pre-Redirection Page: mapeie as colunas da página de pré-redirecionamento (PRE_REDIRECTION, PAGE_URL, PAGE_ID)

Selecionar domínio

Escolha o domínio dos QR Codes importados na lista Selecionar domínio. Todos os QR Codes serão criados nesse domínio.

Depois de revisar os mapeamentos, clique em Confirm import.

Passo 5: revise o resumo da importação

Na sequência, a janela mostra um resumo com o domínio escolhido e quantos QR Codes estão prontos para importar. Ali você pode:

Clicar em Iniciar importação para começar a importação
Clicar em Excluir para cancelar e começar de novo

Passo 6: veja seus QR Codes importados

Ao iniciar a importação, você volta para a sua lista de QR Codes. Os itens entram em uma fila de importação e são processados em segundo plano — você pode sair da página com segurança, e o CodeQR envia um e-mail quando os QR Codes terminarem de ser importados.

Resolução de problemas

Erros de validação comuns

Se o seu CSV tiver dados inválidos, você verá os erros de validação antes de a importação seguir. Os problemas mais comuns são:

Valor de FORMAT inválido — Causa: FORMAT não é dynamic nem static · Solução: Use apenas dynamic ou static
Valor de TYPE inválido — Causa: TYPE não é um dos tipos de conteúdo permitidos · Solução: Confira a lista de tipos permitidos acima
Valor de FLEXIBLE inválido — Causa: O valor booleano não foi reconhecido · Solução: Use true, false, yes, no, sim, não, 1 ou 0
Campo obrigatório vazio — Causa: Uma coluna obrigatória está vazia: FORMAT, TYPE, FLEXIBLE ou VALUE · Solução: Preencha todos os campos obrigatórios
URL inválida — Causa: O formato da URL está incorreto · Solução: Confirme que as URLs começam com http:// ou https://
FLEXIBLE incompatível com FORMAT — Causa: QR estático com FLEXIBLE=true, ou dinâmico com FLEXIBLE=false · Solução: Estático precisa de FLEXIBLE=false; dinâmico precisa de FLEXIBLE=true

Regras para lembrar

QR Codes estáticos: FORMAT=static exige FLEXIBLE=false e um VALUE preenchido
QR Codes dinâmicos: FORMAT=dynamic exige FLEXIBLE=true, e o VALUE pode ficar vazio
Tipos de URL: quando TYPE=url, o VALUE precisa ser uma URL válida

Dicas para importar sem erro

Teste primeiro com um arquivo pequeno: comece com alguns QR Codes para conferir se o seu formato está correto
Use uma formatação consistente: mantenha o mesmo padrão de valores booleanos em todo o arquivo (todos true/false ou todos 1/0)
Valide as URLs: garanta que todas as URLs estão completas e válidas
Confira os caracteres especiais: coloque entre aspas duplas os valores que contêm vírgulas ou aspas
Combine FORMAT e FLEXIBLE: lembre que QR Codes estáticos precisam de FLEXIBLE=false e os dinâmicos, de FLEXIBLE=true

Perguntas frequentes

Posso atualizar os QR Codes depois de importar?

Sim. QR Codes dinâmicos podem ser atualizados a qualquer momento no painel. QR Codes estáticos não podem ser alterados depois da criação.

O que acontece se algumas linhas falharem na validação?

O CodeQR mostra quais linhas têm erros e quais são os problemas. Você pode corrigir o arquivo CSV e enviar de novo. Apenas as linhas válidas são importadas.

Posso importar QR Codes com design personalizado?

A importação por CSV cria QR Codes com o estilo padrão. Depois de importar, você pode editar cada QR Code individualmente para personalizar cores, adicionar logo e aplicar molduras.

Existe um limite de quantos QR Codes eu posso importar?

O limite de tamanho do arquivo é 2 MB. A quantidade de QR Codes que você pode importar depende dos limites do seu plano.