Integrador X

Para garantir que a sincronia com o Painel de Gestão funcione corretamente, verifique os pré-requisitos descritos no tópico Checklist de implantação com integração.

A ativação ou desativação da sincronia de dados com os Cadastros gerais pode ser feita por meio de APIs específicas. Esses endpoints permitem controlar a sincronia.

Veja abaixo a descrição de cada endpoint disponível:

Na Folha XT, o conceito de Master Data se aplica quando há integração com os Cadastros gerais. Nesse modelo, os dados são inseridos inicialmente na Folha XT e, posteriormente, enviados para os Cadastros gerais por meio do Integrador X.

Por padrão, essas informações são apenas consultáveis nos Cadastros gerais, ou seja, não podem ser inseridas ou editadas diretamente pelo usuário, exceto em casos específicos previstos pelas regras de negócio.

As especializações são informações complementares que não são gerenciadas pela Folha XT. Elas são criadas e mantidas diretamente nas telas dos Cadastros gerais.

Exemplo prático: no cadastro de horário:

• As informações básicas são enviadas pela XT por meio do Integrador X.
• As informações complementares do Gestão do Ponto X (as especializações) devem ser inseridas manualmente pelo usuário.

Nos Cadastros gerais, os dados provenientes da XT ficam com edição desabilitada, permitindo ao usuário apenas inserir, editar ou excluir os campos específicos de especializações.

O histórico de afastamento é sincronizado automaticamente entre a XT e o Gestão do Ponto X. Inserções, alterações ou exclusões feitas em qualquer um dos sistemas serão refletidas automaticamente no outro, garantindo a atualização das informações em ambos.

O crachá titular é cadastrado e mantido pela XT. A integração com os Cadastros gerais é unidirecional, mas poderá ser estendida futuramente para suportar contextos mais detalhados, como os do módulo de acesso e segurança.

Esse cadastro parte da XT, mas os campos de tolerância, que são do Gestão do Ponto X, não ficam visíveis lá. Após a integração, esses campos podem ser preenchidos diretamente nos Cadastros gerais.

Importante: Como os campos de tolerância não são tratados como especializações, eles ficam habilitados para edição manual.

Nos Cadastros gerais, o vínculo do colaborador passou a ser tratado de forma agrupada, combinando três informações que antes eram mantidas separadas na XT:

• Tipo de vínculo
• Tipo de contrato
• Categoria do eSocial

Essa mudança unifica o controle desses dados e melhora a rastreabilidade dos vínculos. O código gerado segue o padrão: vínculo.tipoContrato.categoria. Por exemplo: 10.1.101.

Na prática, quando é registrada uma nova categoria do eSocial para o colaborador, uma nova linha é criada automaticamente no histórico de vínculo. Se houver mudança no tipo de contrato, todos os registros do histórico são atualizados para manter a consistência.

Veja a seguir um comparativo entre a forma como esses dados eram apresentados na XT e como passaram a ser organizados nos Cadastros gerais:

XT:

Cadastros gerais:

Algumas categorias específicas da XT ainda não estão integradas aos Cadastros gerais. São elas: 9999, 9997, 9996 e 9995.

Usuários criados na XT (SGU) são integrados automaticamente. Já os usuários cadastrados exclusivamente no SeniorX devem ser vinculados manualmente ao colaborador.

Por essa razão, o passo Usuário na Ficha Cadastral permanece editável, enquanto os passos Pessoa e Contrato são protegidos contra alterações.

Para que o colaborador seja integrado aos Cadastros gerais, ele precisa estar habilitado com o módulo Painel de Gestão. Essa configuração ativa automaticamente os módulos HRIS, Gestão do Ponto X e Ponto Mobile.

Na XT, o código do posto de trabalho é um texto. Já nos Cadastros gerais, esse campo é numérico. Para garantir compatibilidade, o código da XT é concatenado à descrição da posição, e um código sequencial é gerado automaticamente.

Exemplo:

• XT: ADM01 - Administrativo
• Cadastros gerais: Código: 1 | Descrição: ADM01 - Administrativo

Somente posições vinculadas a uma estrutura serão sincronizadas com os Cadastros gerais.

Se a estrutura não estiver definida na XT, o sistema cria automaticamente uma estrutura padrão, com:

• Data de início: 01/01/1901
• Sem data de término
• Código: 0

A XT não possui o conceito de negociação coletiva. Por isso, ao cadastrar um sindicato, o sistema cria automaticamente um registro padrão de negociação com as seguintes características:

• Data de início: 01/01/1901
• Sem data de término
• Descrição baseada nas informações do sindicato

Ao gerar o cálculo do ponto no Gestão do Ponto X, os lançamentos de ponto são automaticamente integrados ao cálculo da folha na XT.

Se uma enumeração ainda não existir nos Cadastros gerais, qualquer dado que dependa dela será bloqueado na integração. Isso evita inconsistências e garante a integridade das informações recebidas.

O Dashboard de integração permite acompanhar de forma centralizada o fluxo de dados entre os sistemas Painel de Gestão e Cadastros gerais. Ele oferece uma visão abrangente, facilitando o monitoramento de resultados, a detecção de falhas e a visualização dos detalhes das execuções.

Para mais informações, consulte a documentação do Dashboard de integração.