Importação e cadastro em lote de clientes via arquivo CSV, planilha online ou API

Visão geral

O cadastro em massa permite adicionar vários clientes de uma vez usando:

Arquivo CSV;
Preenchimento em uma grade no próprio sistema;
Integração via API.

Esse recurso facilita a migração de clientes e permite acompanhar o processo, além de identificar possíveis erros ou inconsistências durante o cadastro.

Quando usar este artigo

Utilize este guia para realizar a inclusão de múltiplos clientes de forma automatizada por API, enviar uma carga em lote via arquivo CSV padronizado ou preencher a planilha de cadastro em lote diretamente na interface.

Sintoma ou cenário

A empresa precisa realizar a inclusão massiva de uma nova carteira de assinantes ou automatizar a criação de cadastros oriundos de sistemas externos, evitando o preenchimento manual individual.

Benefício para o usuário ou operação

Carga e migração de grandes volumes de dados de assinantes em um único procedimento;
Validação de inconsistências com geração de relatório e exportação dedicada das linhas com erro;
Flexibilidade de escolha entre arquivo CSV local, planilha editável na tela e chamadas de API.

Onde acessar / contexto de uso

Acesse o menu Clientes > Clientes, clique no botão Novo cliente e selecione a opção Vários Clientes. Para acompanhar o status do processamento dos arquivos, clique no seu nome de usuário no canto superior direito e acesse o Histórico de processamentos em lote.

Pré-requisitos (Antes de começar)

Perfil Exato: Usuário com permissão de Clientes - Alteração (1071) e Clientes - Consulta (1070).
Recursos Sistêmicos: Módulo de clientes e funcionalidade de importação em lote ativos na licença.
Insumos e Dados Técnicos: Dados cadastrais dos clientes organizados, planilha modelo gerada pelo sistema ou credenciais de acesso e documentação da API.

Causas prováveis

Necessidade de realizar a implantação inicial de dados, efetuar a migração de carteira de clientes oriunda de outro software ou criar um fluxo contínuo de sincronização automatizada de novos assinantes.

Como fazer ou corrigir

O sistema não altera cadastros que já existem durante a importação.

Se a licença permitir contratar o mesmo plano mais de uma vez e o mesmo arquivo for importado novamente, novas assinaturas duplicadas serão criadas.

Importante: não altere os cabeçalhos do arquivo gerado pelo sistema.

Opção 1: Importação via API

Acesse a documentação da API do Superlógica para consultar os endpoints e parâmetros para automação do cadastro de clientes.
Em caso de dúvidas técnicas sobre a integração, envie um e-mail para api@superlogica.com.

Opção 2: Importação via planilha .csv

Acesse o menu Clientes > Clientes.
Clique no botão Novo cliente e selecione a opção Vários Clientes.
Na janela exibida, marque todas as colunas que deseja incluir no arquivo, clique em Visualizar planilha e, em seguida, clique em Fechar.
Clique na opção Exemplos para baixar a planilha com os campos selecionados e preencha as informações dos clientes no arquivo baixado.
De volta ao sistema, clique em Cadastrar via arquivo, selecione o arquivo .csv em seu computador e clique em Abrir.
A tela de Histórico de processamentos em lote será exibida para acompanhar o andamento da carga.
Para acessar essa tela novamente no futuro, clique no seu nome de usuário no canto superior direito e escolha a opção correspondente ao histórico de processamentos.

Opção 3: Cadastro pela planilha online (diretamente na tela)

Acesse Clientes > Clientes, clique em Novo cliente e selecione Vários Clientes.
Marque as colunas desejadas e clique em Visualizar planilha.
Preencha os dados dos clientes diretamente na grade exibida na tela.
Após concluir o preenchimento, clique no botão Cadastrar cliente para finalizar.

Tratamento de falhas e erros de importação

Caso ocorram erros no processamento, clique no número de erros exibido na tela.
Analise a linha e a descrição detalhada da inconsistência.
Clique em Exportar linhas com erro para baixar um arquivo contendo apenas os registros pendentes.
Realize os ajustes necessários na planilha exportada e faça o novo envio.

Resultado esperado

Os clientes são cadastrados na base do sistema, ficando disponíveis na listagem do menu Clientes, e o registro do lote processado é gravado no Histórico de processamentos em lote.

Quando escalar

Escale o atendimento para a equipe técnica caso o arquivo CSV trave durante o processamento em lote sem apresentar o relatório de erros, ou se ocorrerem falhas de comunicação e erros no retorno da API de clientes após validar as chamadas na documentação.

Informações que devem ser reunidas antes do escalonamento

Nome da licença;
Arquivo .csv utilizado no envio da importação;
Captura de tela do erro exibido ou da tela do Histórico de processamentos em lote;
Endpoint, payload enviado e código de erro retornado (para problemas na API).

Regras importantes / Observações

O sistema não sobrescreve cadastros existentes ao importar planilhas.
Importar a mesma planilha mais de uma vez com a opção de contratação múltipla ativada gera assinaturas duplicadas.
Os cabeçalhos das colunas do arquivo gerado pelo sistema jamais devem ser alterados ou excluídos.
Recomenda-se utilizar uma base de testes (ambiente trial: https://www.superlogica.com/dev/trial) para validar os arquivos antes de realizar a importação no ambiente de produção.

Problemas comuns e como resolver

Problema: A importação via arquivo .csv é recusada ou gera erros em várias linhas.
- Causa provável: Alteração ou exclusão dos cabeçalhos originais da planilha modelo, ou campos preenchidos com formato incompatível.
- Ação recomendada: Clique no número de erros, selecione "Exportar linhas com erro", ajuste os dados apontados na descrição mantendo os cabeçalhos originais e reimporte o arquivo.
Problema: Foram criados cadastros e assinaturas duplicados após a importação.
- Causa provável: O mesmo arquivo .csv foi importado mais de uma vez com a funcionalidade de contratação múltipla ativada na licença.
- Ação recomendada: Acesse a listagem de clientes e inative as assinaturas ou cadastros duplicados gerados indevidamente.

Dúvidas relacionadas

P: Onde posso consultar o histórico das importações realizadas anteriormente? R: Clique no seu nome de usuário no canto superior direito do sistema e selecione a opção de Histórico de processamentos em lote.

P: O sistema atualiza os dados do cliente se o mesmo registro for importado novamente? R: Não, o sistema não sobrescreve dados de clientes já cadastrados e pode gerar assinaturas duplicadas caso o arquivo seja reenviado.

P: Como corrigir apenas os registros que apresentaram falha na importação? R: Clique no número de erros exibido após o processamento e escolha a opção "Exportar linhas com erro" para baixar, corrigir e reimportar apenas as linhas afetadas.

Palavras-chave de busca

importar clientes csv, cadastro em lote de clientes, importação de dados, api de clientes, planilha online de clientes, histórico de processamento em lote, exportar linhas com erro