--- title: "Modelo de importação CSV: documentação do Subscriptions" description: "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." url: "https://chargezen.com/pt-br/docs/subscriptions/migration-csv-template" lang: "pt-BR" updated: "2026-10-18" --- Canonical URL: https://chargezen.com/pt-br/docs/subscriptions/migration-csv-template # 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 1 #### 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. 2 #### 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. 3 #### Comece a importação Selecione **Start import**. Cada linha é conferida antes de qualquer coisa ser criada. 4 #### 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. | Datas âncora dos planos pré-pagos 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](https://chargezen.com/pt-br/subscriptions/migrations): guias para Skio, Loop, Stay AI, Appstle, Seal, Smartrr, Bold, Ordergroove, PayWhirl e Upscribe. * Glossário: [data âncora](https://chargezen.com/glossary/anchor-date), [assinatura pré-paga](https://chargezen.com/glossary/prepaid-subscription). ### Artigos relacionados [ #### Migrar assinaturas As três formas de importar ](https://chargezen.com/pt-br/docs/subscriptions/migration)[ #### Mover formas de pagamento do Stripe Linhas com stripe na coluna 2 ](https://chargezen.com/pt-br/docs/subscriptions/stripe-token-migration)[ #### Como funcionam os planos de venda De onde vêm os IDs dos planos de venda ](https://chargezen.com/pt-br/docs/subscriptions/selling-plans-explained) Esta página foi útil? Precisa de mais ajuda? [Fale com o suporte](https://chargezen.com/docs/checkoutos/troubleshooting/support)