> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/rh/hcm-da-senior.md).

# HCM da Senior

### Visão geral

A integração entre o HCM da Senior (Gestão de Pessoas) e o Consistem ERP (módulo CCRHH – sistema ISN) tem como objetivo principal unificar e automatizar o fluxo de informações de recursos humanos e departamento pessoal com o ambiente do ERP.

Essa sinergia permite a atualização automatizada no Consistem ERP das tabelas de cadastros de colaboradores, eventos (rubricas), escalas de horários, programações de férias, afastamentos, transferências entre empresas, compromissos a pagar e o movimento analítico da folha de pagamento. Com isso, garante-se a assertividade dos lançamentos contábeis e fiscais, além de fornecer dados cruciais de disponibilidade dos colaboradores (escalas de trabalho) diretamente para o Planejamento e Controle de Produção (PCP), otimizando a gestão industrial no chão de fábrica.

### Requisitos

<table><thead><tr><th width="466">Consistem ERP</th><th>HCM da Senior</th></tr></thead><tbody><tr><td><p><strong>Compatibilidade:</strong> 7.5 ou superiores do Consistem ERP.</p><p><strong>Módulo:</strong> RH - Folha de Pagamento<br><strong>Licença:</strong> <a href="https://movidesk.consistem.com.br/form/5801/">Aquisição de licença</a> <strong>ISN</strong> ativa junto à Consistem.<br><br>Orientamos o acompanhamento da nossa equipe de consultores.</p></td><td>Aquisição de licença e implantação deve ser verificada com a empresa fornecedora.<br>A documentação de apoio do RH pode ser consultada no <a href="https://documentacao.senior.com.br/gestao-de-pessoas-hcm/">link oficial do HCM da Senior</a>.</td></tr><tr><td><strong>Configuração de Diretório:</strong> Parametrização de uma pasta dedicada no servidor do Consistem ERP com as devidas permissões de leitura e escrita para o recebimento dos arquivos planos de integração via Upload.</td><td><strong>Módulo de Exportação Ativo:</strong> Disponibilidade de rotinas ou relatórios formatados conforme as regras do leiaute da Consistem.</td></tr><tr><td><strong>Exclusões de Escopo:</strong> Estar ciente de que esta integração específica não atende às rotinas de envio de e-Social diretamente pelo ERP e também não realiza rotinas de fechamento/cálculo de folha de pagamento dentro do Consistem ERP.</td><td><strong>Equivalência de Cadastros Base:</strong> É obrigatório manter os cadastros de Horários, Escalas e Sindicatos rigorosamente idênticos e sincronizados manualmente (mesma codificação) em ambos os sistemas para evitar erros de validação relacional durante a leitura dos dados.</td></tr></tbody></table>

### Configuração da integração

#### No Consistem ERP:

O processo envolve três programas essenciais da rotina de Integração com o Senior:

1. **Configuração de Diretórios:** Acesse a tela [Configuração de Referência do Diretório para Importação Folha Senior (CCRHH015)](/rh/manuais-de-telas/rh-integracao-com-senior/integracao-com-hcm-senior/configuracao-de-referencia-do-diretorio-para-importacao-folha-senior.md), informe obrigatoriamente no campo **Referência Diretório** o caminho local ou de rede onde os arquivos texto serão disponibilizados. Preencha o campo **Mês Ano Movimentação** e defina as nomenclaturas exatas de cada arquivo que o sistema irá ler (Funcionários, Eventos, Férias, etc.). Clique em **Salvar**.<br>

   <figure><img src="/files/AOpWcpoyvlacYwvcjdw4" alt=""><figcaption></figcaption></figure>
2. **Configuração de Alertas por E-mail:** Acesse a tela [Configuração de Email para Importação da Folha (CCRHH030)](/rh/manuais-de-telas/rh-integracao-com-senior/integracao-com-hcm-senior/configuracao-de-email-para-importacao-da-folha.md) para configurar os e-mails que receberão as mensagens com os logs de erro do processamento. Preencha o **Destinatário** responsável pelo monitoramento e clique em **Salvar**.<br>

   <figure><img src="/files/LW8H9rnnfpPIElDE4EX5" alt=""><figcaption></figcaption></figure>
3. **Agendamento da Rotina Automatizada:** Para que o ERP realize a leitura dos dados de forma automática, acesse o [Cadastro de Agendamento de Tarefas (CSTASK010)](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/cadastro-de-agendamento-de-tarefas.md). Defina os **Parâmetros Padrões** selecionando o **Módulo** *RH - Integração com Senior* e a **Tarefa** *Integração com RH Senior*. Configure a periodicidade da rotina (diária ou mensal) conforme as necessidades da empresa.<br>

   <figure><img src="/files/zintzvH77Oi6vUxpwPNA" alt=""><figcaption></figcaption></figure>

#### No HCM da Senior:

1. Configure a rotina de exportação do HCM da Senior para consolidar os dados e gerar os arquivos planos de acordo com as periodicidades operacionais: **Geração Diária (D)** para ponto/escalas e **Geração Mensal (M)** para fechamentos de folha e provisões.
2. Programe a rotina automatizada para efetuar o upload e transporte dos arquivos gerados para a pasta configurada como padrão no ERP.

#### Padrão dos Leiautes

Toda a comunicação desta integração é governada e validada através de especificações lógicas estritas:

* **O Documento de Referência (.pdf):** O manual técnico abaixo (`IntegraçãoSenior-HCM - Página1.pdf`) funciona como o dicionário de dados da integração, ditando a ordem das colunas, as tabelas alvo do ERP e o tamanho máximo de cada campo.

{% file src="/files/xHVfy4oDltxiMTcIglZr" %}

* **Os Arquivos de Dados (.txt):** Com base no documento de referência, os arquivos de texto plano exportados utilizam obrigatoriamente o caractere circunflexo (`^`) como separador de campos, formato de data `DDMMAAAA` (sem barras) e dispensam o uso de zeros à esquerda ou espaços vazios à direita em strings de tamanho variável.

{% file src="/files/QyREyr0QvlpqWCOZSV0e" %}

As nomenclaturas obrigatórias que devem ser geradas pela Senior e parametrizadas no programa [Configuração de Referência do Diretório para Importação Folha Senior (CCRHH015)](/rh/manuais-de-telas/rh-integracao-com-senior/integracao-com-hcm-senior/configuracao-de-referencia-do-diretorio-para-importacao-folha-senior.md) são:

* Funcionários (Tag FUN): `expo_colaboradores.txt`
* Eventos (Tag RUB): `expo_eventos.txt` (O ERP soma automaticamente +10000 ao código do evento internamente)
* Férias (Tag FER): `expo_ferias.txt`
* Movimento Folha (Tag MOV): `expo_movimento.txt` (O ERP soma automaticamente +10000 ao código do evento internamente)
* Escalas Fixas (Tag ESF): `expo_escalas.txt`
* Escalas Variáveis (Tag ESV): `expo_escalasvar.txt`
* Afastamentos (Tag AFA): `expo_afastamentos.txt`
* Transferências (Tag TRF): `transferencias.txt`

### Como a integração funciona

Diferente de barramentos síncronos baseados em Web Services tradicionais (APIs REST/SOAP), esta integração adota um modelo de comunicação assíncrona por meio de arquivos planos de texto (.txt) com delimitador fixo por campo.

O fluxo funciona de forma unilateral (origem no HCM da Senior e destino no Consistem ERP) através do programa de [Importação Folha Sênior (CCRHH020)](/rh/manuais-de-telas/rh-integracao-com-senior/integracao-com-hcm-senior/importacao-folha-senior.md). A transmissão pode ser executada manualmente via botões **Upload** e **Importar Arquivos**, ou processada de forma automática e em lote (*batch*) pelo [Cadastro de Agendamento de Tarefas (CSTASK010)](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/cadastro-de-agendamento-de-tarefas.md).

Durante a leitura lógica, o sistema aplica regras internas de "de-para" para garantir a integridade dos dados no banco. Um exemplo dessa tratativa técnica ocorre com arquivos de Eventos e Movimentos da Folha: o mecanismo do Consistem ERP adiciona automaticamente o fator fixo +10000 aos códigos de rubricas recebidos do HCM da Senior antes de salvá-los ou verificá-los nas tabelas internas do ERP.

### Fluxo do processo

O fluxo operacional de trabalho obedece a uma trilha linear padronizada estritamente sob as especificações do leiaute da Consistem:

1. **Geração na Origem:** O HCM da Senior extrai os dados corporativos e gera os arquivos planos inserindo a tag identificadora correta no início de cada linha (como `FUN^` para o cadastro de colaboradores ou `MOV^` para o movimento da folha). Os arquivos obrigatoriamente devem seguir a nomenclatura exata parametrizada no leiaute da Consistem (ex: `expo_colaboradores.txt`, `expo_eventos.txt`).
2. **Recebimento:** Os arquivos formatados são depositados na pasta configurada no programa [Configuração de Referência do Diretório para Importação Folha Senior (CCRHH015)](/rh/manuais-de-telas/rh-integracao-com-senior/integracao-com-hcm-senior/configuracao-de-referencia-do-diretorio-para-importacao-folha-senior.md).
3. **Processamento do Leiaute:** O programa [Importação Folha Sênior (CCRHH020)](/rh/manuais-de-telas/rh-integracao-com-senior/integracao-com-hcm-senior/importacao-folha-senior.md) (ou a tarefa automatizada no [Cadastro de Agendamento de Tarefas (CSTASK010)](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/cadastro-de-agendamento-de-tarefas.md)) faz a leitura sequencial das linhas dos arquivos e valida a quebra de campos usando o separador `^`. O sistema traduz as posições lógicas mapeadas no leiaute da Consistem (identificando se o campo corresponde ao CPF, código da empresa, descrição do cargo ou valores salariais) e popula as tabelas alvo no banco de dados corporativo.
4. **Consulta e Monitoramento:** Para consultar o sucesso da integração, o usuário pode verificar se a mensagem *"Arquivo(s) importado(s) com sucesso!"* é exibida ao lado do campo **Mês Referência** na tela de [Importação Folha Sênior (CCRHH020)](/rh/manuais-de-telas/rh-integracao-com-senior/integracao-com-hcm-senior/importacao-folha-senior.md). Caso ocorra qualquer falha de validação relacional ou de estrutura do leiaute (ex: um funcionário associado a um código de horário inexistente no ERP), a linha do arquivo é rejeitada e um relatório contendo o log de erros é enviado para o e-mail cadastrado no programa [Configuração de Email para Importação da Folha (CCRHH030)](/rh/manuais-de-telas/rh-integracao-com-senior/integracao-com-hcm-senior/configuracao-de-email-para-importacao-da-folha.md).
5. **Resultado Final:** As tabelas do ERP são completamente atualizadas, disponibilizando os dados em tempo real para a geração correta de relatórios contábeis e para o planejamento da produção fabril no PCP.

<p align="center">Esse conteúdo foi útil?</p>

<p align="center"><a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-up">Sim</a> <a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-down">Não</a></p>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/rh/hcm-da-senior.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
