Integração da Folha de Pagamento com a Pontua
6 min
Criado por FABIANO VIEIRA SOARES em 13/03/2026 16:17
Atualizado por FABIANO VIEIRA SOARES em 26/03/2026 15:30

Objetivo

Este artigo tem como objetivo orientar o usuário sobre como configurar e utilizar a integração entre a Folha de Pagamento e a Pontua, permitindo o envio e o retorno automático de eventos da folha.

Com essa integração ativa, o sistema possibilita:

  • Envio automático de eventos da folha para a Pontua

  • Consulta das exportações realizadas

  • Importação dos eventos processados

  • Atualização automática do status dos eventos

Esse processo reduz tarefas manuais e garante maior confiabilidade nas informações da folha.

Pré-requisitos

Antes de iniciar a configuração da integração, verifique se:

  • A empresa está cadastrada na Pontua

  • O token de integração foi fornecido pela Pontua

  • Os eventos da folha estão cadastrados no sistema

  • O usuário possui permissão para acessar o menu de Integrações

1. Habilitar eventos para integração

Para que um evento seja enviado para a Pontua, ele precisa estar habilitado no cadastro.

Cadastros → Eventos → Cadastro de Eventos

  • Acesse o Cadastro de Eventos.

  • Localize o evento que deseja integrar.

  • Abra a aba Integração.

  • No campo Integração com Pontua, selecione a opção SIM.

  • Salve as alterações.

Observação

Apenas eventos configurados com SIM estarão disponíveis para parametrização na integração.

2. Configurar a empresa na integração Pontua

Após habilitar os eventos, é necessário configurar a empresa que será integrada.

Integrações → Pontua → Configurações de Empresas

  1. Acesse Configurações de Empresas.

  2. Selecione a empresa desejada.

  3. No campo Token da Empresa, informe o token fornecido pela Pontua.

  4. Após inserir o token, o sistema realizará a validação automática.

Se o token for válido, o sistema preencherá automaticamente as informações da empresa.

Informações preenchidas automaticamente

  • Tipo de inscrição

  • CNPJ

  • Inscrição municipal

  • Inscrição estadual

  • GUID da unidade Pontua

Atenção

Caso o token esteja incorreto ou inválido, o sistema apresentará uma mensagem de erro informando a falha na validação.

3. Parametrizar os eventos da integração

Após configurar a empresa, é necessário definir quais eventos serão enviados para a Pontua.

Integrações → Pontua → Parametrização de Eventos

  • Acesse Parametrização de Eventos.

  • Clique na opção Inserir Evento.

  • Preencha os campos solicitados.

Campos da parametrização

Descrição
Informe o nome da configuração do evento.

Tipo de Folha

Selecione o tipo de folha correspondente:

  • Mensal

  • Adiantamento

  • PPR

Eventos

Selecione os eventos que deseja integrar.

Unidade do Evento

Defina a unidade utilizada no cálculo do evento:

  • Hora

  • Valor

  • Quantidade

  • Data

  1. Após preencher as informações, clique em Gravar.

Os eventos configurados serão enviados automaticamente para a Pontua.

4. Programação de eventos

A programação de eventos permite acompanhar os eventos enviados e recebidos pela integração.

Caminho no sistema

Integrações → Pontua → Movimentações

  1. Acesse a aba Programação de Eventos.

  2. Utilize os filtros disponíveis para localizar os eventos desejados.

  3. Visualize os eventos programados na Pontua.

Os eventos retornados pela Pontua poderão ser utilizados na programação da folha.

5. Validação das exportações

Após o envio dos eventos, o sistema realiza automaticamente uma consulta para identificar exportações disponíveis para importação.

Durante essa verificação, o sistema analisa:

  • Status da exportação

  • Origem da exportação

  • Eventos disponíveis para processamento

Somente exportações com origem Tron serão consideradas válidas para importação.

6. Importação dos eventos na folha

Quando uma exportação válida é encontrada, o sistema realiza a importação dos eventos para a folha de pagamento.

Durante o processo, o sistema identifica o colaborador utilizando:

  • CPF

  • Matrícula interna

Caso o colaborador ainda não possua identificador da Pontua, o sistema atualizará automaticamente o cadastro.

7. Tratamento de eventos duplicados

Se o sistema identificar que um evento já existe na programação da folha, será exibida uma opção de tratamento.

O usuário poderá escolher entre:

Somar
O valor importado será somado ao evento já existente.

Manter
O sistema manterá apenas o evento já existente.

Substituir
O evento existente será removido e substituído pelo evento importado.

8. Regras de validação da importação

Durante a importação, o sistema aplica algumas regras automáticas.

Eventos de horas extras

Eventos com valor menor ou igual a zero não serão importados.

Eventos de faltas

O sistema reconhece os seguintes tipos de ausência:

Tipo Descrição
ABSENCEFalta integral
HALF_ABSENCEMeia falta

9. Finalização da integração

Após a importação dos eventos:

  1. O sistema confirma que a importação foi realizada com sucesso.

  2. O status da exportação é atualizado automaticamente para Processado.

Essa atualização evita que o mesmo evento seja importado novamente.

10. Para garantir o funcionamento correto da integração, recomenda-se:

  • Conferir se o token da empresa está válido

  • Verificar se os eventos estão habilitados para integração

  • Confirmar a parametrização dos eventos antes do envio

  • Revisar possíveis eventos duplicados durante a importação

Este artigo foi útil para você?
Últimos artigos visitados