English
Español
Histórico de Matrículas
O Perfil Acadêmico foi desenvolvido para centralizar e gerenciar o histórico de formação e capacitações dos colaboradores, oferecendo uma visão completa da trajetória acadêmica dentro da plataforma Senior HCM. Pensando tanto no RH quanto no colaborador, o recurso permite rastrear cursos, treinamentos e certificações de forma organizada e integrada.
Integração Konviva x Perfil Acadêmico
É possível realizar a integração da Plataforma Konviva com o Perfil Acadêmico do Senior HCM, permitindo que o histórico de matrículas dos colaboradores seja sincronizado automaticamente, sem dependência de processos legados. A integração elimina a necessidade de alimentação manual ou de sistemas intermediários, criando um fluxo direto e confiável de dados acadêmicos.
A integração do módulo Perfil Acadêmico com a plataforma Konviva visa oferecer uma experiência integrada de gestão de capacitação, permitindo que o RH visualize o histórico completo de formações dos colaboradores diretamente no painel de gestão, com sincronização automática e controle de duplicidades.
Para fazer a integração, é necessário realizar algumas configurações dentro da plataforma Konviva e do Senior HCM. A parametrização é realizada através do módulo SeniorX no Konviva.
Importante
A parametrização da integração deve ser realizada seguindo as credenciais e configurações definidas no módulo SeniorX da plataforma Konviva. O administrador do Konviva é responsável por validar as credenciais de acesso e testar a comunicação antes de ativar a rotina de sincronização. Caso encontre dificuldades, recomenda-se contatar o suporte para validação da configuração.
Fluxo Macro da Integração
A integração segue um fluxo estruturado e sequencial para garantir o correto funcionamento:
- Configuração - Preenchimento de credenciais SeniorX no Konviva;
- Teste de Comunicação - Validação da conectividade com os serviços Senior;
- Habilitação - Ativação da rotina de sincronização;
- Primeira Carga - Seleção e salvamento do tipo da primeira carga: Carga Completa ou Somente Incremental. Essa definição é obrigatória para permitir o início do processamento;
- Integração HCM - Sincronização automática e contínua de dados;
- Logs e Monitoramento - Acompanhamento de execuções e tratamento de falhas.
1º passo: Configuração do papel de integração
O papel reúne as permissões que serão utilizadas pela aplicação para realizar a integração entre o Konviva e o HCM.
- Acesse a Plataforma Senior X com um usuário administrador do tenant.
- Acesse Tecnologia > Administração > Gerenciamento de Papéis > Novo Papel.
- Informe um nome descritivo para o papel, como Konviva Integration.
- Na aba de permissões, adicione o recurso
res://senior.com.br/hcm/management_panel/konviva/extraeducatione configure as ações aplicáveis à integração: Incluir, Visualizar e/ou Excluir. - Salve o papel.
Configuração da aplicação e obtenção das credenciais
A aplicação representa o Konviva LMS na Plataforma Senior X e gera as credenciais de acesso utilizadas na integração.
- Ainda com o usuário administrador, acesse Tecnologia > Administração > Gerenciamento de Aplicações > Nova Aplicação.
- Informe um nome descritivo, como Konviva LMS.
- Selecione o tipo Gerar um token diferente para cada sessão da aplicação.
- Salve a aplicação e copie imediatamente as credenciais access key e secret exibidas.
- Na aplicação criada, associe o papel configurado na etapa anterior.
Importante
Guarde as credenciais em um local seguro. O secret não poderá ser recuperado após fechar a tela em que ele é exibido.
2º passo: Configuração na plataforma Konviva
- Acesse Configurações > Integrações > SeniorX.
- Preencha as Credenciais de Integração com a chave de acesso e a chave secreta geradas anteriormente.
- Clique em Teste de Comunicação e aguarde a confirmação de sucesso.
- Acesse HCM > Painel de Gestão.
- Habilite a opção Ativar integração de histórico de matrículas no Perfil HCM.
- No campo Tipo da Primeira Carga, exibido abaixo dessa opção, selecione Carga Completa ou Somente Incremental.
- Salve a configuração para permitir a execução da rotina.
O preenchimento do campo Tipo da Primeira Carga é obrigatório. Enquanto essa informação não estiver definida, a rotina de integração não será executada.
Carga Completa
Na primeira execução, envia todas as matrículas elegíveis existentes no Konviva. Após a conclusão bem-sucedida dessa carga, as próximas execuções passam automaticamente para o processamento incremental.
Essa opção é recomendada para clientes que ainda não possuem histórico acadêmico no HCM.
Somente Incremental
Registra a data e a hora da configuração da integração como referência inicial e processa somente matrículas alteradas após esse momento, conforme os critérios de elegibilidade.
Essa opção permite evitar o reenvio do histórico anterior à ativação da integração e é recomendada para clientes migrados do TR ou que já possuem histórico acadêmico no HCM.
Alteração do tipo da primeira carga
O tipo da primeira carga pode ser alterado enquanto não houver execuções registradas da rotina.
Após a primeira execução registrada, o campo permanece visível, mas fica bloqueado para alterações. O sistema apresenta uma mensagem informativa sobre essa restrição.
Importante
Desativar e reativar a integração não libera a alteração do campo Tipo da Primeira Carga. Por isso, avalie o histórico existente no HCM antes da primeira execução.
3º passo: Definir elegibilidade de matrículas
A sincronização automática e manual considera apenas matrículas que atendem aos seguintes critérios de elegibilidade:
- Usuário ATIVO na plataforma Konviva;
- Status da Matrícula: MATRICULADO ou CONCLUÍDO apenas;
- Vínculo válido entre usuário Konviva e colaborador HCM;
- Sem duplicidade: Verificação via ID da matrícula (identificador técnico).
Matrículas com usuários inativos, status diferente de “Matriculado” ou “Concluído”, vínculos inválidos ou já sincronizadas não serão re-sincronizadas e aparecerão nos logs de execução com status e motivo identificado.
Tipos de Execução
A integração oferece duas formas de execução, permitindo flexibilidade entre automação e controle manual:
Execução Automática (CRON)
A sincronização ocorre automaticamente todos os dias às 00:01 (horário do servidor), processando apenas as alterações do dia anterior.
- Janela de Processamento: 00:00:00 a 23:59:59 do dia anterior;
- Frequência: Diária;
- Tipo de Carga Utilizado
- Carga Completa: processa todas as matrículas elegíveis na primeira execução. Após a conclusão bem-sucedida, as próximas execuções passam automaticamente para o modo incremental;
- Somente Incremental: utiliza a data e a hora da configuração como referência inicial para processar apenas matrículas alteradas após esse momento.
- Tipo de Carga Utilizado:
- Na primeira execução: O tipo configurado (Completa ou Incremental);
- Nas execuções subsequentes: Sempre Incremental, processando apenas matrículas novas ou alteradas;
- Nenhuma intervenção necessária: O processo executa automaticamente uma vez ativado.
Observação
A rotina só pode iniciar após a definição do tipo da primeira carga. Depois da primeira execução registrada, essa configuração fica bloqueada, mesmo que a integração seja desativada e reativada.
O bloqueio do campo e a transição para o processamento incremental são controles distintos: o bloqueio ocorre após a primeira execução registrada; na opção Carga Completa, a transição automática ocorre após a conclusão bem-sucedida da carga.
Execução Manual (Endpoint)
É possível disparar a sincronização manualmente através de um endpoint dedicado, permitindo controle sob demanda para:
- Homologação: Validar a integração antes de colocá-la em produção;
- Testes: Executar sincronizações pontuais para verificar funcionamento;
- Reprocessamento Controlado: Reprocessar registros que falharam em execuções anteriores;
- Troubleshooting Operacional: Sincronizar dados específicos para diagnóstico.
O disparo manual utiliza as mesmas regras e elegibilidade da rotina automática, garantindo consistência nos dados sincronizados.
Controle de Duplicidade
Um dos pilares da integração é o controle automático de duplicidades através do ID da matrícula:
- Identificador Técnico Único: O ID da matrícula Konviva é armazenado no campo dedicado do Perfil Acadêmico HCM;
- Verificação em Cada Sincronização: Antes de sincronizar, o sistema verifica se o ID da matrícula já existe no HCM;
- Sem Re-sincronizações: Se o registro já foi sincronizado anteriormente, não é re-processado, evitando duplicatas;
- Apenas Alterações: Matrículas marcadas como alteradas são re-sincronizadas apenas se houve mudança efetiva no registro na Konviva.
Importante
O campo de ID da matrícula não é opcional. Sem este campo criado no Perfil Acadêmico do HCM, a integração não consegue garantir que registros não sejam duplicados.
4º passo: Monitorar logs e execuções
Após ativar a integração, acompanhe as sincronizações através do painel de Logs e Monitoramento em Configurações > Integrações > SeniorX:
- Histórico de Execuções: Data, hora, tipo de carga (Full ou Incremental), horário de início, horário de fim e status final de cada sincronização;
- Quantidade de Elegíveis: Total de matrículas que atenderam aos critérios de elegibilidade;
- Registro de Sucessos: Quantidade e lista de matrículas sincronizadas com sucesso;
- Registro de Falhas: Matrículas que falharam na sincronização, com motivo específico do erro;
- Registros não Integrados: Matrículas que não atendem aos critérios de elegibilidade (usuário inativo, status inválido, vínculo inválido);
- Inconsistências de Dados: Problemas de vínculo entre usuário Konviva e colaborador HCM ou dados faltando.
- Estratégia de Processamento: Identificação da estratégia utilizada pela rotina e do tipo de carga executado.
Tratamento de Falhas e Reprocessamento
A integração inclui mecanismos robustos para identificar e tratar falhas:
Falhas Tratadas Automaticamente:
- Autenticação: Credenciais SeniorX inválidas ou expiradas;
- Indisponibilidade do Serviço: APIs SeniorX ou HCM temporariamente indisponíveis;
- Divergência de Vínculo: Usuário Konviva sem correspondência válida no HCM ou vínculo expirado;
- Inconsistências de Dados: Campos obrigatórios faltando ou valores inválidos.
Reprocessamento Controlado de Falhas
Matrículas que falharam em execuções anteriores podem ser reprocessadas manualmente, permitindo corrigir o problema de origem e sincronizar os dados novamente:
Passos para Reprocessamento:
- Acesse Configurações > Integrações > SeniorX > Logs e Monitoramento;
- Localize a execução que contém registros com falha;
- Selecione a opção Reprocessar associada àquela execução;
- O sistema disparará uma nova sincronização considerando apenas os registros que falharam;
- Verifique os logs da nova execução para confirmar sucesso.
Pré-requisito para Sucesso: Certifique-se de que o problema de origem foi corrigido antes do reprocessamento. Exemplos:
- Falha de Vínculo: Validar e reativar o vínculo entre usuário Konviva e colaborador HCM;
- Falha de Autenticação: Renovar ou validar as credenciais SeniorX;
- Falha de Dados Inconsistentes: Corrigir campos obrigatórios faltando na matrícula Konviva.
Observação
O reprocessamento reutiliza as mesmas regras e elegibilidade da integração, garantindo que apenas registros válidos sejam re-sincronizados.
Dados Sincronizados
A integração transfere as seguintes informações da matrícula Konviva para o Perfil Acadêmico do HCM:
- ID da Matrícula: Identificador único (chave técnica de integração para evitar duplicidades);
- Dados do Colaborador: Referência ao colaborador HCM vinculado via integração de usuários;
- Curso/Programa: Nome e descrição da formação ou trilha na Konviva;
- Data de Matrícula: Quando o colaborador se matriculou na Konviva;
- Status: Matriculado ou Concluído conforme registrado na Konviva;
- Dados Complementares: Conforme configuração de mapeamento definida pela implementação.
Escopo e Limitações
Escopo:
- Integração unidirecional: Konviva → HCM apenas;
- Sincronização automática diária (CRON às 00:01) e manual via endpoint de matrículas elegíveis;
- Controle de duplicidades via ID da matrícula;
- Logs completos de execuções, sucessos, falhas e status;
- Reprocessamento controlado de registros com erro;
- Processamento de alterações incrementais do dia anterior.
Itens Fora do Escopo:
- Integração bidirecional (HCM → Konviva);
- Webhooks para eventos em tempo real;
- Exclusão automática de registros;
- Dashboards avançados de monitoramento;
- Sincronização de dados além do histórico de matrículas.
English
Español
