Como importar assinaturas e contratos no sistema

Visão geral

A importação em lote de assinaturas e contratos permite cadastrar massivamente novos contratos e planos na base de dados por meio de arquivos em formato CSV ou via integração de API. Esse processo automatiza o cadastro inicial de clientes e a migração de carteiras, alimentando diretamente a rotina de faturamento recorrente.

Quando usar este artigo

Utilize este artigo ao realizar a migração de contratos de outro sistema, ao cadastrar grandes volumes de assinaturas de uma só vez ou ao integrar sistemas externos via API para criação automática de contratos.

Sintoma ou cenário

Necessidade de cadastrar múltiplos contratos e assinaturas no sistema sem a realização do cadastro individual manual.

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

• Carga massiva de contratos e assinaturas via planilha CSV ou integração por API;

• Identificação e correção pontual de inconsistências por meio da exportação exclusiva das linhas com erro;

• Validação prévia dos dados e do layout em ambiente de testes antes da aplicação definitiva em produção.

Onde acessar / contexto de uso

Menu Assinaturas > Assinaturas ou através da documentação da API ([https://apiassinaturas.superlogica.com/](https://apiassinaturas.superlogica.com/)).

Pré-requisitos (Antes de começar)

• Perfil Exato: Permissão de acesso Recorrentes - Alteração (1091) ou Acesso Administrativo (1000).

• Recursos Sistêmicos: Módulo de Recorrentes e Assinaturas ativo e permissão para importação em lote.

• Insumos e Dados Técnicos: Planilha oficial de importação preenchida e salva no formato CSV (Separado por vírgulas, ISO 8859-1) ou credenciais de acesso à API (dúvidas via api@superlogica.com).

Causas prováveis

Migração de sistema, carga inicial de dados ou contratação massiva de planos que torna inviável a digitação manual individual de contratos.

Como fazer ou corrigir

A importação de assinaturas pode ser realizada por arquivo CSV ou via API. O sistema valida os dados do arquivo gerado em codificação ISO 8859-1 e processa a inclusão sem sobrescrever cadastros existentes; caso a mesma planilha seja reimportada e o plano permita múltiplas contratações, as assinaturas serão duplicadas. Recomenda-se realizar testes prévios em ambiente de homologação.

Preenchimento e preparação da planilha:

1. Acesse sua licença e faça o download do modelo oficial de planilha na opção de exemplos da tela de importação.

2. Assinaturas > assinaturas > importar assinaturas > Exemplos

3. Abra a planilha e consulte a aba 1 - Exemplo de preenchimento e a aba 2 - MODELO como referência para a estrutura dos campos.

4. Preencha os dados e salve o arquivo no formato CSV (Separado por vírgulas, ISO 8859-1).

5.  

Execução da importação no sistema:

1. No menu lateral, acesse Assinaturas > Assinaturas.

2. Clique no botão Importar Assinaturas.

3. Selecione a opção Cadastrar via arquivo.

4. Escolha o arquivo CSV salvo e clique em Abrir.

5. Acompanhe o processamento na tela de Histórico de processamentos em lote (acessível no canto superior direito da interface).

Tratamento de falhas na importação:

1. Caso ocorram falhas no processamento, clique no número de erros informado na tela de importação.

2. Identifique a linha correspondente e ajuste os dados conforme a mensagem exibida.

3. Clique no botão Exportar linhas com erro para gerar uma planilha contendo apenas os registros que falharam.

4. Faça as correções necessárias na planilha exportada e reimporte exclusivamente as linhas corrigidas.

Resultado esperado

As assinaturas contidas no arquivo CSV ou enviadas via API são cadastradas na base de dados e passam a figurar na listagem principal do módulo.

Quando escalar

Escale o atendimento caso o processamento do lote permaneça travado no histórico, se ocorram erros não descritos na tela de falhas ou se houver dificuldades técnicas na integração via API após validação da documentação.

Informações que devem ser reunidas antes do escalonamento

• Nome da licença;

• Planilha no formato CSV utilizada na importação;

• Print da tela de Histórico de processamentos em lote com o status da execução;

• Print do detalhamento e mensagem das falhas geradas no relatório;

• Payload de requisição e resposta (em caso de problemas na integração via API).

Regras importantes / Observações

• O sistema não sobrescreve cadastros existentes. Reimportar uma planilha inteira duplicará as assinaturas se o plano permitir contratações simultâneas.

• O arquivo CSV deve ser salvo obrigatoriamente na codificação ISO 8859-1 para evitar corrupção de acentuação e caracteres especiais.

• Suporte técnico referente à documentação de API deve ser direcionado ao e-mail api@superlogica.com.

Problemas comuns e como resolver

• Problema: Assinaturas foram cadastradas em duplicidade na base. Causa provável: A planilha completa foi reimportada e a opção de permitir contratar o plano mais de uma vez estava habilitada. Ação recomendada: Ao corrigir falhas de importação, utilize sempre o botão "Exportar linhas com erro" para reimportar apenas os registros corrigidos, e não o arquivo original inteiro.

• Problema: Os dados da planilha apresentam caracteres desconfigurados após a importação. Causa provável: O arquivo CSV foi salvo em uma codificação diferente de ISO 8859-1 (como UTF-8). Ação recomendada: Abra a planilha de origem, selecione "Salvar como" e escolha o formato CSV com codificação ISO 8859-1 antes de realizar o envio no sistema.

Dúvidas relacionadas

P: O sistema sobrescreve as assinaturas existentes ao reimportar uma planilha? R: Não, o sistema não substitui dados cadastrados e criará assinaturas duplicadas se o plano permitir múltiplas contratações.

P: Onde localizar a tela de histórico dos arquivos importados? R: O sistema redireciona automaticamente para a tela após o envio, podendo também ser acessada pelo ícone de processamentos em lote no canto superior direito do sistema.

Palavras-chave de busca

importar assinaturas, importar contratos, planilha de importação csv, api assinaturas, histórico de processamentos em lote, erro na importação assinaturas