> ## Documentation Index
> Fetch the complete documentation index at: https://help.comunicain.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Senior HCM

> Como funciona a integração entre Senior HCM e Loop

A integração com **Senior HCM** permite usar o cadastro corporativo de RH como fonte para atualizar a base de colaboradores do Loop.

Na Developer Platform, a Senior é configurada como uma conexão cloud-to-cloud. O Loop consulta a API disponibilizada pelo cliente e usa o resultado para gerar preview, logs e sincronizações controladas.

<Warning>
  O endpoint final, o método de autenticação e os campos disponíveis dependem do ambiente Senior do cliente. A configuração deve ser validada com a TI antes da homologação.
</Warning>

## Dados mínimos

Para a primeira carga, recomendamos os seguintes campos:

| Campo na Senior | Campo no Loop               | Uso                                                        |
| --------------- | --------------------------- | ---------------------------------------------------------- |
| Matrícula       | `employee_id`               | Chave principal por tenant e base para login por matrícula |
| Nome            | `name`                      | Identificação do colaborador                               |
| Status          | `status`                    | Ativo, inativo ou desligado                                |
| Área            | `department`                | Segmentação e filtros                                      |
| Cargo           | `position`                  | Perfil e segmentação                                       |
| Centro de custo | `custom_fields.cost_center` | Segmentação avançada                                       |

Campos adicionais podem ser mapeados depois, como líder, diretoria, benefícios ou perfil familiar.

## Conexão

A configuração começa pela escolha do modelo de API usado pelo cliente:

<CardGroup cols={2}>
  <Card title="REST / JSON" icon="braces">
    A Senior retorna uma resposta em JSON. O Loop identifica a lista de colaboradores pelo path configurado e trata os campos diretamente.
  </Card>

  <Card title="SOAP / XML / WSDL" icon="code-xml">
    A Senior retorna XML. O Loop converte o XML para uma estrutura JSON interna antes de aplicar o mapeamento de campos.
  </Card>
</CardGroup>

A tela de conexão permite configurar:

* ambiente: homologação ou produção;
* endpoint base;
* modelo de API: REST/JSON ou SOAP/XML/WSDL;
* tipo de autenticação;
* `client_id`;
* token ou segredo, quando aplicável;
* path de colaboradores;
* path de teste de conexão;
* path da lista dentro do JSON ou XML convertido;
* parâmetros fixos, quando o serviço exigir.

As credenciais são enviadas para uma função segura e armazenadas criptografadas.

## REST / JSON

No modelo REST, a TI normalmente informa:

* endpoint de login, quando houver geração de `access_token`;
* endpoint de refresh, quando houver `refresh_token`;
* endpoint de colaboradores;
* formato do body de login;
* campo onde o `access_token` aparece na resposta;
* path da lista de colaboradores no JSON.

Exemplos comuns de path da lista:

* `data`
* `items`
* `colaboradores`
* `data.colaboradores`

## SOAP / XML / WSDL

No modelo SOAP, a TI normalmente informa:

* URL do WSDL ou endpoint SOAP;
* `SOAPAction` ou método do serviço;
* usuário, senha e identificadores exigidos pelo serviço;
* parâmetros como empresa, filial, cliente ou código de consulta;
* envelope SOAP de teste;
* path da lista de colaboradores dentro do XML convertido.

Exemplo de path após conversão:

```txt theme={null}
Envelope.Body.consultarColaboradoresResponse.return.colaborador
```

<Note>
  Em SOAP, o preview pode receber uma amostra XML real de homologação para validar a conversão antes de qualquer gravação.
</Note>

## Preview

O preview simula o que aconteceria na base do Loop sem gravar alterações.

Ele mostra:

* colaboradores que seriam criados;
* colaboradores que seriam atualizados;
* colaboradores que seriam inativados;
* registros ignorados por regra;
* erros de mapeamento ou dados obrigatórios ausentes.

Para REST, a amostra do preview pode ser JSON. Para SOAP, a amostra pode ser XML. Em ambos os casos, o resultado final é normalizado para o mesmo formato interno antes da comparação com a base do Loop.

<Note>
  O preview é a etapa principal de homologação com TI. Ele deve ser revisado antes de liberar qualquer sincronização definitiva.
</Note>

## Produção

Depois da homologação:

1. as credenciais de produção são cadastradas;
2. o preview é executado novamente;
3. TI aprova a política de sincronização;
4. a rotina de sincronização é habilitada conforme o escopo contratado.

## Veja também

<CardGroup cols={2}>
  <Card title="Política de sincronização" icon="sliders" href="/pt-br/developers/politica-de-sincronizacao">
    Entenda as regras que controlam risco de impacto na base.
  </Card>

  <Card title="Segurança e rede" icon="shield" href="/pt-br/developers/seguranca-e-rede">
    Requisitos de comunicação, credenciais e hospedagem.
  </Card>
</CardGroup>