🎯 Objetivo

Documentar as integrações existentes entre os sistemas:

• Folha: Webfopag
• Ponto: Pontofopag

Esclarecer que não existe integração direta entre os sistemas, ou seja existem gatilhos que disparam a comunicação realizada por meio de APIs.

⚙️ Configuração de Event Map

Para que a integração funcione corretamente, é necessário configurar um Event Map no Monitor Assíncronos.

Essa configuração é responsável por direcionar os eventos da Folha (Webfopag) para o Ponto (Pontofopag) através da fila correta.

👉 Para realizar a configuração, acesse a documentação completa:

Configurar novo Event Map – Folha x Ponto

🔎 Modelo de Integração

A integração ocorre:

• Por meio de contrato
• Utilizando endpoints de API
• De forma estruturada e controlada

Não há sincronização automática geral entre os sistemas.
Cada funcionalidade integrada depende de chamada específica via API.

🧩 Integrações Existentes

Abaixo estão os endpoints atualmente disponíveis para integração entre Folha e Ponto:

👤 Empregado

api/Funcionario: Responsável por integrar dados cadastrais do empregado.

📄 Contrato

api/Contrato: Responsável por integrar informações contratuais vinculadas ao empregado.

⚠️ A integração depende da existência de contrato válido.

🏢 Empresa

api/Empresa: Integra dados cadastrais da empresa.

🏖️ Férias

api/Ferias: Integra informações de férias do empregado.

🏥 Afastamento

api/Afastamento: Integra registros de afastamento.

📊 Relatório de Afastamento

api/RelatorioAfastamento: Permite consulta/integração de informações relacionadas a afastamentos.

⏱️ Batida de Coletor

api/IntegrarRegistrosColetor: Integra registros provenientes de coletor de ponto.

🔒 Fechamento de Ponto

api/FechamentoPonto: Responsável por integrar informações de fechamento de ponto.

🔄 Fluxo Conceitual

Fluxo simplificado da integração:

Webfopag → API (Contrato obrigatório) → Processamento → Pontofopag

⚠️ Observações Importantes

:::warning Atenção Não existe integração automática geral entre Folha e Ponto. Toda integração ocorre por endpoint específico e depende de contrato válido. :::

• O contrato deve existir previamente.
• O empregado deve estar vinculado ao contrato.
• As integrações seguem regras de validação de negócio.
• Inconsistências cadastrais podem impedir a integração.

🧪 Boas Práticas para Validação

• Validar existência de contrato antes da integração
• Conferir vínculo empregado x contrato
• Monitorar logs da API
• Testar cenários de Insert, Update e Delete quando aplicável
• Validar consistência de dados após processamento no Ponto

📌 Resumo

📌 Status: Documentado
👤 Responsável: Equipe de QA