Use este checklist para preparar uma integração entre o Loop e um sistema corporativo, como a Senior HCM.
- Nome do sistema de origem.
- Modelo de API usado: REST/JSON ou SOAP/XML/WSDL.
- Ambiente de homologação disponível.
- Ambiente de produção disponível.
- URL base do endpoint.
- Path de colaboradores.
- Path ou endpoint para teste de conexão.
REST / JSON
Se a integração for REST, informe:
- endpoint de login;
- endpoint de refresh, se existir;
- endpoint de colaboradores;
- formato do body de login;
- campo da resposta que contém o
access_token;
- campo da resposta que contém o
refresh_token;
- path da lista de colaboradores no JSON.
SOAP / XML / WSDL
Se a integração for SOAP, informe:
- URL do WSDL ou endpoint SOAP;
SOAPAction ou método a ser chamado;
- envelope SOAP de teste;
- parâmetros obrigatórios, como empresa, cliente, filial ou serviço;
- path da lista de colaboradores dentro do XML convertido;
- exemplo de resposta XML de homologação.
Autenticação
- Tipo de autenticação: Bearer token, client credentials, basic auth ou outro.
client_id, quando aplicável.
- Token, secret ou credencial equivalente.
- Prazo de expiração das credenciais.
- Processo de rotação de credenciais.
Rede
- Endpoint acessível por HTTPS.
- Porta 443 liberada.
- Regras de firewall ou allowlist.
- Necessidade de VPN, IP fixo ou restrição por origem.
- Contato técnico para troubleshooting.
Campos de colaboradores
Campos mínimos recomendados:
- matrícula;
- nome;
- status ativo/inativo;
- área;
- cargo;
- centro de custo.
Campos opcionais:
- líder;
- diretoria;
- unidade;
- benefícios;
- perfil familiar;
- outros campos de segmentação.
Política de sincronização
Antes da produção, TI deve validar:
- se demitidos devem ser inativados automaticamente;
- se ausentes na Senior devem ser inativados;
- se PJs e cadastros manuais devem ser preservados;
- frequência desejada da rotina;
- quem aprova o preview inicial.
Homologação
Fluxo recomendado:
- Cadastrar credenciais de homologação.
- Salvar conexão.
- Testar conexão.
- Ajustar mapeamento de campos.
- Rodar preview.
- Validar contagens e amostra de registros.
- Ajustar política de sincronização.
- Repetir preview até aprovação.
- Promover para produção.
Contatos
Informe pelo menos:
- responsável de TI;
- responsável de RH ou Comunicação Interna;
- responsável por credenciais;
- responsável por firewall/rede;
- canal para incidentes durante homologação.
Quanto mais cedo TI confirma endpoint, autenticação e campos disponíveis, menor o tempo de implantação.