Modelo de importação CSV
As dez colunas do CSV de assinaturas da Chargezen, como preencher cada uma e o que significa cada mensagem de erro da importação e como corrigi-la.
Última atualização: 2026-10-18
Use um CSV para trazer assinaturas de qualquer app que consiga exportá-las. Abra Subscriptions → Import → CSV import e selecione Download a CSV template para baixar um arquivo com a linha de cabeçalho já preenchida.
Importe um CSV
Prepare seu CSV
Um contrato por linha, com a linha de cabeçalho primeiro (ela é ignorada). Mantenha as colunas na ordem abaixo. Salve a planilha como .csv.
Envie o arquivo
Selecione Choose a CSV ou arraste o arquivo. A página conta as linhas que vai conferir e quantas linhas sem e-mail vai ignorar.
Comece a importação
Selecione Start import. Cada linha é conferida antes de qualquer coisa ser criada.
Acompanhe a chegada dos contratos
Quando o arquivo passa na conferência, a importação entra na fila e os novos contratos aparecem em Contracts à medida que são criados.
Colunas, na ordem
| # | Coluna | O que colocar nela |
|---|---|---|
| 1 | Customer email | O e-mail de um cliente que já existe na Shopify. |
| 2 | Payment method (shopify_payment or stripe) | shopify_payment cobra a forma de pagamento salva na Shopify. stripe primeiro traz para a Shopify a forma de pagamento padrão do cliente no Stripe. |
| 3 | Next billing date (YYYY-MM-DD) | A primeira data em que a Chargezen cobra. Não pode estar no passado. |
| 4 | Recurring delivery anchor date (YYYY-MM-DD; prepaid weekly/monthly/yearly only) | Define o dia da semana, o dia do mês ou o mês e o dia da entrega nos planos pré-pagos. Deixe em branco para manter o calendário do plano. |
| 5 | Shipping fee | Cobrado em todos os pedidos recorrentes. 0 ou mais. |
| 6 | Variant ID | O ID da variante do produto na Shopify. |
| 7 | Quantity | Um número inteiro maior que zero. |
| 8 | Current price | O preço por item que o cliente paga hoje. 0 ou mais. |
| 9 | Selling plan ID | O ID numérico de um plano da Chargezen com o canal Contract import ativado. |
| 10 | Moeda | Um código de moeda como USD ou CAD. |
A coluna 4 muda o calendário de entregas recorrentes dos planos pré-pagos semanais, mensais e anuais. Se você reaproveitar um CSV antigo, confira a coluna 4 antes de importar. A primeira entrega continua dependendo dos prazos de cobrança e de corte da Shopify.
Mensagens de erro
Se alguma linha falhar, nada é importado. A página diz “Nothing was imported. Fix these rows and upload the file again.” e lista cada problema como “Row N: …”.
| Mensagem | Como corrigir |
|---|---|
| Enter a valid customer email. | A coluna 1 está vazia ou não é um endereço de e-mail. |
| Choose Shopify Payments or Stripe. | A coluna 2 precisa ser shopify_payment ou stripe. |
| Enter a valid first billing date (YYYY-MM-DD) that is not in the past. | Corrija o formato da data na coluna 3, ou mude-a para amanhã ou depois. |
| Enter a valid recurring fulfillment anchor date (YYYY-MM-DD) on or after the first billing date. | A coluna 4 é anterior à coluna 3 ou está no formato errado. |
| Enter a non-negative shipping fee. | A coluna 5 é menor que zero ou não é um número. |
| Enter a Shopify variant ID. | A coluna 6 está vazia. |
| Enter a whole-number quantity greater than zero. | A coluna 7 é zero, negativa ou tem casas decimais. |
| Enter a non-negative current price. | A coluna 8 é menor que zero ou não é um número. |
| Enter a Shopify selling plan ID. | A coluna 9 está vazia. |
| This selling plan isn't available for contract import. | Ative o canal Contract import nesse plano, ou use o ID de outro plano. |
| Choose a supported currency. | A coluna 10 não é um código de moeda reconhecido. |
Solução de problemas
"File type must be .csv"
Salve a planilha como CSV (separado por vírgulas) e envie de novo.
"No rows with a customer email found"
Cada linha precisa de um e-mail de cliente na coluna 1, e a primeira linha é tratada como cabeçalho. Confira se seus dados começam na linha 2.
O arquivo passou, mas um contrato nunca apareceu
Os contratos são criados em segundo plano. Uma linha é recusada depois se o e-mail não for de um cliente da Shopify, ou se esse cliente já tiver um contrato. As linhas com Stripe esperam até a forma de pagamento do cliente no Stripe ser confirmada na Shopify.
Onde encontro o ID de um plano de venda?
Use o ID numérico de um plano de venda dentro de um plano da Chargezen com Contract import ativado. A Chargezen adiciona o prefixo da Shopify para você.
Relacionados
- Migrações: guias para Skio, Loop, Stay AI, Appstle, Seal, Smartrr, Bold, Ordergroove, PayWhirl e Upscribe.
- Glossário: data âncora, assinatura pré-paga.
Artigos relacionados
Precisa de mais ajuda? Fale com o suporte