Como importar clientes de um arquivo CSV

A importação por CSV adiciona os seus clientes atuais e as assinaturas deles à sua loja a partir de uma planilha. Ela nunca cria, altera nem estende uma linha no seu painel. Ela só registra os clientes que você já tem.

A aba CSV Import aparece quando a sua loja tem o módulo CSV Import.

1Step 1 of 7Prepare o arquivo

Acesse Customers → Import customers e abra a aba CSV Import. Em CSV Template & Column Reference, clique em Download Template (.csv) e preencha uma linha da planilha por assinatura.

• name e status (ACTIVE, EXPIRED ou SUSPENDED) são obrigatórios em todas as linhas. email é opcional: um cliente sem e-mail é adicionado como cliente manual.
• Uma assinatura ativa também precisa de product_name e expiry_date (YYYY-MM-DD).
• username (o login da linha no seu painel) é o que nos permite encontrar a linha no seu painel. Preencha sempre que tiver.
• panel_user_id é opcional: o ID da linha no seu painel. Deixe em branco se os números vêm do seu sistema antigo (1, 2, 3 …) e não são os IDs de linha que o seu painel mostra.

Uma linha da planilha que não está ativa, não tem produto ou já expirou importa apenas o perfil do cliente: sem assinatura e sem fatura.

2Step 2 of 7Envie o arquivo

Solte o arquivo na caixa de upload ou clique em Choose File. A pré-visualização mostra quantas linhas foram lidas e os erros a corrigir.

Os clientes com endereço de e-mail são adicionados à sua lista de clientes assim que o arquivo é lido. Eles não são adicionados duas vezes quando você importa.

3Step 3 of 7Leia os avisos

Leia Before you import, acima dos erros. Ali aparece, por exemplo, quantas linhas da planilha têm um ID de linha do painel, mas nenhum username, e quantas serão apenas um perfil. Se os seus IDs de linha do painel seguem 1, 2, 3 … quase sem lacunas, a pré-visualização avisa que eles parecem números de linha do seu sistema antigo. Se for o caso, corrija a coluna, ou esvazie e preencha os usernames no lugar, e envie de novo.

4Step 4 of 7Mapeie os produtos e escolha o painel

Clique em Continue to Mapping. Escolha a loja e, em Panel Integration (Optional), escolha o painel em que as suas linhas estão, ou No panel. Em Map Products, escolha um dos seus produtos para cada nome de produto do arquivo, ou Skip para deixar essas linhas de fora.

Deixe Import as manual subscriptions marcado se você recebe os pagamentos por conta própria. Nesse caso, a renovação automática fica desativada para as assinaturas importadas.

5Step 5 of 7Execute a importação

Clique em Review & Import, confira o resumo e depois clique em Start Import.

6Step 6 of 7Confira os resultados

Quando uma linha da planilha tem um ID de linha do painel e você escolheu um painel, a linha é verificada nesse painel antes de ser vinculada. Ela só é vinculada quando o seu painel mostra exatamente uma linha com o username daquela linha da planilha e nenhuma outra assinatura está vinculada a essa linha. Nesse caso, é usado o ID de linha do próprio painel, mesmo que o seu arquivo indique outro número. Panel line check mostra o que aconteceu com essas linhas:

• linked (vinculada): as renovações vão estender essa linha.
• not found on panel (não encontrada no painel): não há nenhuma linha com esse username no seu painel.
• ambiguous (ambígua): mais de uma linha tem esse username, ou duas linhas do seu arquivo apontam para a mesma linha.
• no username – not linked (sem username, não vinculada): a linha da planilha tinha um ID de linha, mas nenhum username, então não pôde ser verificada.
• not checked (não verificada): não foi possível consultar o painel a tempo, ou ele não consegue buscar linhas.

As linhas que não foram vinculadas são importadas mesmo assim, sem vínculo com o painel.

A forma de verificação depende do painel. Um painel com uma API que lista as suas linhas (XUI com chave de API) verifica todas as linhas em uma única leitura. Os painéis NXT e V12 / MaxOTT são consultados uma linha por vez, pelo tempo que a importação permitir. Um painel em que entramos pelo navegador é verificado para até 20 linhas por importação. Os outros tipos de painel não são verificados.

7Step 7 of 7Vincule as linhas que não foram vinculadas

Toda assinatura que não foi vinculada aparece em Subscriptions → Needs manual set-up. Para vincular uma, encontre o cliente em Customers → All customers e clique na assinatura. Abra a aba Panel Sync, informe o Panel line ID da linha como o seu painel mostra na lista de linhas e clique em Save. A partir daí, as renovações estendem essa linha.

Dica: essas assinaturas nunca são tentadas de novo como pedidos novos no seu painel, então nenhuma segunda linha é criada e nenhum crédito é gasto enquanto você as vincula.