Cadastramento em Lote
O que é Cadastramento em Lote?
O Cadastramento em Lote é uma funcionalidade que permite criar múltiplos registros na plataforma por meio da importação de arquivos CSV.
Essa funcionalidade foi desenvolvida para acelerar processos de implantação, migração de dados e manutenção de grandes volumes de informações, reduzindo atividades manuais e aumentando a produtividade operacional.
Para que serve o Cadastramento em Lote?
O Cadastramento em Lote permite criar diversos registros simultaneamente a partir de uma única importação.
Essa abordagem é especialmente útil para:
-
Implantação inicial da plataforma;
-
Migração de dados de sistemas legados;
-
Cadastro de grandes volumes de informações;
-
Atualizações recorrentes realizadas por integração manual.
Quem pode utilizar o Cadastramento em Lote?
A funcionalidade está disponível apenas para usuários que possuam as permissões adequadas.
Além da permissão para utilizar o Cadastramento em Lote, o usuário também deve possuir permissão de criação nos módulos que serão impactados pela importação.
Quais módulos suportam Cadastramento em Lote?
O recurso está disponível nos principais módulos de cadastramento da plataforma, como Contratos, Fornecedores, Prestadores e outras entidades compatíveis.
A disponibilidade da funcionalidade depende das permissões atribuídas ao usuário.
Cada módulo disponibiliza seu próprio modelo de importação e suas respectivas validações.
Qual formato de arquivo é suportado?
Atualmente, o Cadastramento em Lote suporta arquivos CSV.
Os arquivos devem utilizar o separador: ( , )
Para facilitar a importação, a plataforma disponibiliza um modelo de arquivo compatível para cada tipo de cadastro.
⚠️ Atenção: Alterações na estrutura do arquivo ou no separador podem impedir o processamento da importação.
Existe um modelo de arquivo para importação?
Sim. A plataforma disponibiliza modelos de CSV específicos para cada tipo de cadastro suportado.
Os modelos contêm as colunas esperadas pela importação e servem como referência para preenchimento dos dados.
Recomenda-se sempre utilizar o modelo disponibilizado pela plataforma para evitar inconsistências.
Posso validar o arquivo antes de realizar a importação?
Sim. Antes da submissão do processamento, a plataforma permite validar o arquivo a ser enviado.
Essa validação identifica possíveis inconsistências estruturais e problemas nos dados informados, permitindo correções antes da execução da importação.
Essa etapa reduz falhas e aumenta a qualidade dos dados importados.
Quais tipos de erros podem ser identificados durante a validação?
Dependendo do módulo e das regras aplicáveis, podem ser identificados erros como:
-
Campos obrigatórios não preenchidos;
-
Formatos inválidos;
-
Valores inconsistentes;
-
Referências inexistentes;
-
Estrutura incorreta do arquivo;
-
Duplicidade de registros.
As validações podem variar conforme o tipo de cadastro realizado.
Como realizar um Cadastramento em Lote?
O processo normalmente consiste em:
-
Baixar o modelo de importação;
-
Preencher os dados necessários;
-
Realizar a validação do arquivo;
-
Enviar o arquivo para processamento;
-
Acompanhar a execução da importação.
Após a submissão, a plataforma iniciará o processamento dos registros.
O processamento ocorre imediatamente?
Não. As importações são processadas de forma assíncrona pelos mecanismos internos da plataforma.
Essa abordagem permite processar grandes volumes de dados sem impactar a utilização normal do sistema.
O que acontece após o envio do arquivo?
Após a submissão, uma tarefa de processamento é criada automaticamente.
O processamento é executado pelos mecanismos internos da plataforma e pode ser acompanhado em tempo real.
Usuários com acesso ao Gerenciador de Tarefas também poderão acompanhar informações detalhadas da execução por meio desse módulo.
Como acompanhar uma importação em andamento?
O acompanhamento pode ser realizado diretamente pela tela de importação.
Usuários com acesso ao Gerenciador de Tarefas também podem consultar informações detalhadas da execução.
Entre as informações disponíveis estão:
-
Status da execução;
-
Data e horário de processamento;
-
Quantidade de registros processados;
-
Possíveis falhas identificadas;
-
Logs de execução.
As informações são atualizadas em tempo real durante o processamento.
O que acontece se eu fechar a tela durante a importação?
O fechamento da tela não interrompe o processamento.
Após o envio do arquivo, a execução continuará normalmente pelos serviços internos da plataforma até sua conclusão ou eventual cancelamento.
Posso cancelar uma importação em andamento?
Depende.
Caso a tarefa ainda esteja em execução e a funcionalidade esteja disponível para o processamento correspondente, o cancelamento poderá ser realizado através do Gerenciador de Tarefas (requer permissão administrativa).
⚠️ Atenção: Dependendo do estágio da execução, parte dos registros poderá já ter sido processada.
O que acontece se alguns registros apresentarem erro?
Os registros válidos poderão ser processados normalmente, enquanto os registros com inconsistências poderão ser rejeitados.
Isso significa que uma importação pode ser concluída parcialmente, com parte dos registros processados com sucesso e parte rejeitada por validações.
As informações detalhadas sobre falhas poderão ser consultadas nos resultados da importação e nos logs disponibilizados pela plataforma.
Um cadastro pode impactar outros módulos?
Sim. Dependendo do tipo de importação realizada, o processamento poderá criar ou atualizar informações relacionadas em outros módulos da plataforma.
Por exemplo, durante o cadastro de um Prestador, a plataforma poderá criar ou relacionar registros de Pessoa, Membro, Funções e outras entidades necessárias para manter a consistência dos dados.
⚠️ Atenção: Recomenda-se compreender os relacionamentos envolvidos antes de executar importações em larga escala.
Como identificar se a importação foi concluída com sucesso?
Após a conclusão do processamento, o resultado poderá ser consultado diretamente na tela de importação.
Usuários com acesso ao Gerenciador de Tarefas também poderão acompanhar detalhes adicionais da execução.
Serão disponibilizadas informações como:
-
Quantidade de registros processados;
-
Quantidade de registros com falha;
-
Resultado geral da execução;
-
Logs e mensagens de validação.
O Cadastramento em Lote respeita as permissões do usuário?
Sim. A plataforma valida as permissões do usuário antes de permitir a execução da importação.
Além da permissão para utilizar o Cadastramento em Lote, o usuário deve possuir permissão de criação nas entidades que serão processadas.
Somente usuários autorizados poderão realizar importações nos módulos correspondentes.
Posso reutilizar um arquivo de importação já utilizado anteriormente?
Sim. Um arquivo pode ser reutilizado desde que seus dados continuem válidos e compatíveis com a estrutura atual do modelo de importação.
Entretanto, recomenda-se revisar os dados antes de cada envio para evitar a criação de registros duplicados ou inconsistências decorrentes de informações desatualizadas.
⚠️ Atenção: Dependendo do módulo e das regras de negócio aplicáveis, registros já existentes poderão ser rejeitados durante o processamento.
As importações são auditadas?
Sim. As operações executadas por meio do Cadastramento em Lote são registradas pelos mecanismos de auditoria da plataforma.
Esses registros auxiliam atividades de governança, rastreabilidade, conformidade e investigação de incidentes.
Quais cuidados devem ser adotados antes de executar uma importação?
Recomenda-se:
-
Utilizar o modelo oficial disponibilizado pela plataforma;
-
Validar o arquivo antes da submissão;
-
Revisar os dados preenchidos;
-
Confirmar os relacionamentos entre os registros;
-
Realizar testes com pequenos volumes quando possível;
-
Acompanhar o processamento até sua conclusão.
⚠️ Atenção: Importações em lote podem criar ou atualizar grandes volumes de dados simultaneamente. Recomenda-se revisar cuidadosamente o conteúdo do arquivo antes de iniciar o processamento.