Quem pode seguir este guia?
Usuário com permissão para editar contratos e parcelas massivamente no módulo de contas a receber.
O que você vai precisar antes de começar
Acesso à plataforma Paggo.
Arquivo de importação no formato CSV (arquivos .xlsx e .xls não são aceitos).
Dados de empreendimento, unidade e cliente previamente cadastrados na plataforma — ou disponíveis para cadastro durante a etapa de validação.
Campos de séries de parcelas preenchidos, especialmente frequência da série e data de vencimento.
Passo a passo para importar contratos e parcelas
1. Baixe o template e preencha os campos
Caso necessário, consulte o artigo “Como criar Contratos na Paggo?” e siga as instruções do item “Criar contratos em Massa”
Baixe e preencha a aba “Preencha a tabela aqui” do “template massivo por série de parcelas”, depois baixe o arquivo no formato .CSV para inserir na plataforma.
2. Fazer o upload do arquivo CSV
Acesse o módulo de Contas a Receber > Carteira > Contratos
Clique na seta ao lado do botão de “Novo Contrato” e depois clique em “Criar em Massa”.
Procure ou arraste o arquivo no formato CSV. O sistema realiza a leitura e inicia a verificação dos dados.
2. Aguardar a validação automática
Após subir o arquivo, a plataforma faz a validação de todas as linhas e as inconsistências encontradas são agrupadas por tipo.
A barra de progresso no topo da tela exibe em tempo real quantos contratos estão válidos.
Os tipos de inconsistência que podem ser identificados são:
Empreendimento não identificado — o código ou nome informado no arquivo não corresponde a nenhum registro cadastrado.
Unidade inexistente — a unidade referenciada não existe no empreendimento indicado.
Unidade já vendida — a unidade está associada a um contrato ativo e não está disponível.
Cliente não encontrado — o CPF ou identificador do cliente não está cadastrado na plataforma.
Valores incorretos em etiquetas — divergências em campos de valores ou nomenclaturas.
Informações faltantes em séries de parcelas — ausência de dados como frequência de série ou data de vencimento.
3. Corrigir as inconsistências identificadas
Para cada inconsistência identificada, a plataforma oferece uma ação de resolução diretamente na tela, sem necessidade de reprocessar o arquivo. As pendências são sinalizadas e podem ser resolvidas na própria plataforma.
Veja abaixo como resolver cada tipo de pendência:
Empreendimento não identificado: Selecione o projeto correto na lista disponível. As pendências de empreendimento precisam ser resolvidas antes das de unidade, pois as unidades disponíveis dependem do empreendimento selecionado.
Unidade não cadastrada: Selecione uma unidade disponível na lista ou cadastre uma nova unidade diretamente na plataforma.
Unidade já vendida: É possível visualizar o contrato existente, tornar a unidade disponível alterando seu status, ou distratar o contrato e recarregar o status para que seja validado e atualizado nos contratos importados.
Cliente não encontrado: Selecione um cliente existente na base ou cadastre um novo cliente diretamente na plataforma.
Informações faltantes em parcelas: Preencha os campos obrigatórios como frequência da série ou primeiro vencimento da parcela diretamente na tela de validação.
4. Processar os contratos válidos
Após resolver todas as pendências, os contratos com status válido ficam disponíveis para processamento. A barra no topo da tela exibe o total atualizado de contratos prontos.
Verifique na barra superior quantos contratos estão válidos para processamento.
Clique no botão "Continuar".
Na próxima tela será mostrada a tabela com todos os contratos importados pelo arquivo, já com as alterações realizadas na tela de validação
Clique em “Processar - x válidas” para criar os contratos válidos
Os contratos serão criados na plataforma com todas as informações preenchidas corretamente e sem erros.
Importante: Contratos com pendências não resolvidas não estarão disponíveis para serem processados. Apenas as linhas marcadas como válidas terão o contrato criado na plataforma.
Boas práticas para importação sem erros
Verifique previamente se todos os empreendimentos e unidades estão cadastrados na plataforma.
Confirme que os clientes já possuem cadastro ativo antes de incluí-los no arquivo.
Certifique-se de que o campo de documento está formatado como texto para evitar a remoção de zeros à esquerda
Revise o status de cada unidade — unidades com contratos ativos precisam de tratamento antes da importação.
Preencha todos os campos de séries de parcelas, especialmente frequência e data de vencimento.
Valide o arquivo CSV em um editor de planilhas antes do upload, verificando formatação de colunas e ausência de linhas em branco.
Perguntas frequentes
1. O que acontece com os contratos que possuem pendências não resolvidas?
Resposta: Contratos com pendências não resolvidas não serão criados. Apenas as linhas marcadas como válidas são processadas.
2. Posso corrigir o arquivo e fazer um novo upload em vez de resolver na tela?
Resposta: Sim. É possível fechar o fluxo de validação, corrigir o arquivo CSV e inserir novamente o arquivo na plataforma. Porém, ela também permite resolver todas as pendências diretamente na tela, sem precisar reprocessar o arquivo.
3. Quais formatos de arquivo são aceitos para a importação?
Resposta: Apenas arquivos no formato CSV são aceitos.
4. A validação verifica todas as linhas do arquivo ao mesmo tempo?
Resposta: Sim. Após inserir o arquivo, a plataforma analisa todas as linhas automaticamente e agrupa as inconsistências por tipo, permitindo resolver múltiplas pendências do mesmo tipo de uma vez.