Links rápidos
O que você pode fazer nesta página
Baixe um CSV de exemplo, confirme o formato da coluna e siga as quatro etapas para importar. Solução de problemas e perguntas frequentes estão na parte inferior.
Use-o como modelo ou para validar seu próprio arquivo.
Mapear colunas automaticamente e detectar duplicatas antes da importação.
Pré-requisitos
- Conta de equipe com permissão para criar Cartões de Presente no Shopify.
- CSV limpo codificado em UTF‑8. Datas no formato AAAA‑MM‑DD.
- Moedas como códigos ISO (USD, EUR, GBP...).
Formato CSV
Os campos obrigatórios são code, initial_balance. Campos opcionais ajudam com relatórios e validade.
| Coluna | Obrigatório | Exemplo | Notas |
|---|---|---|---|
| code | Sim | GC-9F3K-2L8A | Único por linha |
| initial_balance | Sim | 100 | Número (sem símbolo de moeda) |
| currency | Opcional | USD | Código ISO |
| expires_on | Opcional | 2026-12-31 | AAAA‑MM‑DD |
| note | Opcional | Migrated from POS | Texto livre |
| customer_email | Opcional | jane@doe.com | Enviado ao cliente se fornecido |
| status | Opcional | active | active (ativo) ou disabled (desativado) |
code,initial_balance,currency,expires_on,note,customer_email,status
GC-9F3K-2L8A,100,USD,2026-12-31,Migrated from POS,jane.doe@example.com,active
GC-7J2M-5Q1B,50.5,USD,,,active
GC-ABCD-1234,200,EUR,2025-06-30,VIP compensation,,activeImportação passo a passo
Traga dados de qualquer PDV ou plataforma.
Ajuste mapeamentos sem recarregar.
Duplicatas, formatos e verificações de saldo sinalizados em tempo real.
Visualização de progresso e logs exportáveis para auditoria.
Tutorial em vídeo de 3 minutos
Uma visão geral rápida do fluxo de importação, validação e logs.
Solução de problemas
“Falha no upload do CSV”
- Certifique-se de que o arquivo é CSV (UTF‑8). Evite XLS/XLSX.
- Remova linhas de cabeçalho vazias. Mantenha apenas uma linha de cabeçalho.
- Tente lotes menores (10-25k linhas) se maior que 20 MB.
“Códigos duplicados detectados”
O validador encontrou valores repetidos na coluna code. Remova duplicatas na sua planilha ou permita que a ferramenta pule duplicatas automaticamente durante a importação.
“Moeda/formato errado”
Use códigos ISO (USD, EUR, GBP). Saldos devem ser apenas números e datas devem ser AAAA‑MM‑DD.
Perguntas frequentes
Quais formatos CSV vocês suportam?
Qualquer CSV com as colunas mostradas acima. Você pode alterar mapeamentos durante o upload se seus nomes de cabeçalho forem diferentes.
Posso evitar duplicatas ou saldos errados?
Sim. A validação em tempo real sinaliza duplicatas, problemas de formatação e incompatibilidades antes da importação. Você também pode exportar um relatório de erros.
Os clientes serão notificados automaticamente?
Se você incluir customer_email, o Shopify pode enviar o cartão de presente por e-mail. Caso contrário, os cartões são criados sem enviar notificação.