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
Acesse Configurações de Empresas.
Selecione a empresa desejada.
No campo Token da Empresa, informe o token fornecido pela Pontua.
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
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
Acesse a aba Programação de Eventos.
Utilize os filtros disponíveis para localizar os eventos desejados.
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 |
|---|---|
| ABSENCE | Falta integral |
| HALF_ABSENCE | Meia falta |
9. Finalização da integração
Após a importação dos eventos:
O sistema confirma que a importação foi realizada com sucesso.
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