Importar e exportar um CSV de contrato

Use um arquivo com valores separados por vírgula (CSV, na sigla em inglês) para importar ou exportar contratos entre apps de assinatura de terceiros e o Shopify Subscriptions.

Para saber mais sobre como usar arquivos CSV, consulte Abrir e editar um arquivo CSV.

Fazer download de um arquivo CSV de amostra

É possível fazer download e visualizar um exemplo de arquivo CSV de contratos e usá-lo como modelo.

Considerações sobre o arquivo CSV de contratos

Antes de usar o arquivo CSV de contrato para importar contratos, revise as seguintes considerações.

Formatação do arquivo CSV

Para que o arquivo CSV do contrato seja importado corretamente, verifique se ele atende aos seguintes critérios:

  • A primeira linha do arquivo CSV de contratos precisa conter os cabeçalhos das colunas, conforme especificado na tabela de descrição relacionada.
  • Cada coluna precisa ser separada por vírgula.
  • Um arquivo CSV pode ter no máximo 10 MB.

Entender a coluna de identificador

O identificador é usado para indicar cada contrato de maneira exclusiva e gerenciar dados das seguintes formas:

  • Agrupando contratos com vários itens de linha: um identificador compartilhado agrupa contratos com vários itens de linha.
  • Evitando contratos duplicados: contratos duplicados são ignorados na importação. Se uma linha com o mesmo identificador foi importada anteriormente, ela será ignorada no novo processo de importação. Esse mecanismo ajuda a evitar a duplicação de dados.

Contratos com vários itens de linha

Os contratos que incluem vários itens de linha exigem uma linha separada para cada item e são agrupados na coluna de identificador.

Por exemplo, se um contrato tiver três itens de linha, cada item precisa ser adicionado como uma linha separada. A primeira linha contém todas as informações do contrato, e as duas seguintes contêm apenas valores nas seguintes colunas:

  • handle
  • line_variant_id
  • line_quantity
  • line_current_price
  • Opcional: line_selling_plan_id
  • Opcional: line_selling_plan_name

O identificador precisa ser idêntico para as três colunas. Todas as outras colunas nas linhas dois e três precisam ficar em branco.

Descrição do arquivo CSV

As informações usadas no CSV de contrato são divididas nas seguintes categorias: * Nome do contrato * Informações de cliente e faturamento * Forma e informações de entrega * Itens incluídos na assinatura

Todas as colunas precisam ser adicionadas ao arquivo CSV para a importação correta, e todos os campos são obrigatórios, a menos que seja indicado de outra forma.

Descrição das colunas no arquivo CSV de contratos.
Coluna Descrição
Handle Os identificadores são as etiquetas exclusivas de cada contrato. Eles podem conter letras e números e, geralmente, são uma string combinada de letras, números ou ambos. Cada contrato precisa ter um identificador exclusivo.
upcoming_billing_date A próxima data de faturamento do contrato. O horário está em UTC (Hora Universal Coordenada) e precisa ser formatado como AAAA-MM-DDTHH:MM:SSZ. Por exemplo, 15h50 de 7 de setembro de 2019, no fuso horário UTC (Hora Universal Coordenada), é representado como 2019-09-07T15:50:00Z.
customer_id O ID do cliente. Precisa corresponder ao ID de um cliente existente no admin da Shopify.
currency_code O código de moeda do contrato. Precisa corresponder a uma moeda ativa na loja.
status O status do contrato, que pode ser:
  • Ativa
  • Pausado
cadence_interval A frequência de entrega da assinatura. O contrato pode ter um dos seguintes intervalos de cadência:
  • Semanal
  • Mês
  • Ano
cadence_interval_count A frequência de entrega da assinatura no período geral. Por exemplo, o intervalo de cadência de cada mês é 1, e o intervalo para cada duas semanas é 2.
customer_payment_method_id O ID da forma de pagamento usada pelo cliente no contrato.
delivery_price O preço da entrega no formato de moeda correto.
delivery_method_type A forma de entrega da assinatura, que precisa ser um dos seguintes tipos:
  • Shipping (Frete)
  • Entrega local
  • Retirada
  • Nenhum
delivery_address_first_name O nome do destinatário no endereço de entrega. Campo obrigatório quando a forma de entrega é Frete e Entrega local.
delivery_address_last_name Sobrenome do destinatário no endereço de entrega. Campo obrigatório apenas quando a forma de entrega é Frete e Entrega local.
delivery_address_address1 A primeira linha do endereço de entrega. Campo obrigatório apenas quando a forma de entrega é Frete e Entrega local.
delivery_address_address2 A segunda linha do endereço de entrega. Campo obrigatório apenas quando o endereço tiver um segundo campo e a forma de entrega for Frete ou Entrega local.
delivery_address_city A cidade do endereço de entrega. Campo obrigatório apenas quando a forma de entrega é Frete e Entrega local.
delivery_address_province_code A província ou o estado do endereço de entrega. Campo obrigatório apenas quando a forma de entrega é Frete e Entrega local.
delivery_address_country_code O código de país do endereço de entrega. Campo obrigatório apenas quando a forma de entrega é Frete e Entrega local.
delivery_address_company O nome da empresa do endereço de entrega. Campo obrigatório apenas quando o pedido for para uma empresa e a forma de entrega for Frete ou Entrega local.
delivery_address_zip O CEP do endereço de entrega. Campo obrigatório apenas quando a forma de entrega é Frete e Entrega local.
delivery_address_phone O número de telefone do endereço de entrega. Campo obrigatório apenas quando a forma de entrega é Frete e Entrega local.
delivery_local_delivery_phone O número de telefone do endereço de entrega. Campo obrigatório para assinaturas com Entrega local.
delivery_local_delivery_instructions Instruções de entrega local. O campo só precisa ser incluído quando são fornecidas instruções para assinaturas com Entrega local.
delivery_pickup_method_location_id O ID de local da retirada. Campo obrigatório apenas para assinaturas com a forma Retirada no local.
line_variant_id O ID de cada item de linha incluído na assinatura. Caso vários itens de linha estejam incluídos na assinatura, cada item deverá ser adicionado como uma nova linha com o ID de variante exclusivo.
line_quantity A quantidade de cada item de linha incluído na assinatura. Caso vários itens de linha estejam incluídos na assinatura, a quantidade adicionada deverá ser para o item específico, e não o total de todos os itens incluídos.
line_current_price O preço do item de linha da assinatura no formato de moeda correto.
line_selling_plan_id O ID do plano de assinatura. Campo opcional.
line_selling_plan_name O nome do plano de assinatura. Campo opcional.

Importar contratos com um arquivo CSV

Use um arquivo CSV para importar contratos existentes de um app de assinatura de terceiros da Shopify App Store ou de outra loja na Shopify para o app Shopify Subscriptions. Não é possível usar o arquivo CSV para editar ou substituir contratos existentes. Cópias de contratos existentes são ignoradas na importação.

Etapas:

  1. No admin da Shopify, acesse Assinaturas > Contratos.
  2. Clique em Importar.
  3. Clique em Adicionar arquivo e selecione aquele que você quer importar.
  4. Clique em Fazer upload de arquivo.

Após o upload do arquivo CSV, você receberá uma mensagem de confirmação na conta de e-mail usada para configurar a loja na Shopify. Leia as soluções para erros comuns de importação para ajudar em problemas de importação.

Exportar contratos com um arquivo CSV

Você pode exportar seus contratos para os registros ou importar para outra loja na Shopify em que o app Shopify Subscriptions esteja instalado.

Etapas:

  1. No admin da Shopify, acesse Assinaturas > Contratos.
  2. Clique em Exportar.

Tudo pronto para começar a vender com a Shopify?

Experimente de graça