Funcionários
Consulta listagens de colaboradores com paginação e filtros como empresa, seção e situação, além de busca individual por matrícula.
API WPontual
Integração para consultar dados do ponto com segurança e previsibilidade.
A API WPontual permite que sistemas externos consultem informações operacionais do ponto, como funcionários, competências, registros de ponto e cálculos apurados, usando endpoints HTTP documentados em Swagger.
O que integra
Dados de funcionários, competências, marcações e cálculos em uma interface padronizada.
Competências
Lista competências disponíveis para orientar as consultas de ponto e cálculo por período.
Ponto
Consulta registros de ponto por competência, com opção de filtrar por matrícula do colaborador.
Cálculo
Disponibiliza eventos calculados do ponto, incluindo dados como competência, empresa, matrícula, evento, descrição, horas e banco de horas.
Endpoints disponíveis
Rotas de consulta documentadas para integração com sistemas externos.
GET
/funcionarios
Lista colaboradores com parâmetros opcionais de paginação, tamanho de página, empresa, seção e situação.
GET
/funcionarios/{matricula}
Consulta os dados de um colaborador específico usando a matrícula como chave de busca.
GET
/competencias
Retorna as competências disponíveis para consulta de ponto e cálculo.
GET
/ponto/{competencia}
Lista registros de ponto da competência informada, com paginação para grandes volumes.
GET
/ponto/{competencia}/{matricula}
Consulta os registros de ponto de um colaborador em uma competência específica.
GET
/calculo/{competencia}
Lista os eventos calculados do ponto para a competência informada.
GET
/calculo/{competencia}/{matricula}
Consulta eventos calculados de um colaborador em uma competência específica.
GET
/
Endpoint raiz usado para validar disponibilidade básica do serviço.
Autenticação e uso
Consultas via HTTP com cabeçalho x-api-key e respostas em JSON.
- Base de serviço: https://www.wpontual.com.br/ponto-api/
- Documentação interativa: Swagger UI
- Especificação técnica: OpenAPI JSON
- Parâmetros comuns:
page,page_sizee filtros conforme o endpoint. - Para grandes volumes, use paginação e consulte por competência para manter a integração previsível.
- O acesso pode exigir uma chave de API fornecida pela Pontual, enviada no cabeçalho
x-api-key.
Quando usar
A API ajuda quando o dado do ponto precisa circular sem retrabalho manual.
Integração com folha
Permite consultar dados calculados e informações de colaboradores para apoiar rotinas que dependem do fechamento do ponto.
BI e relatórios internos
Facilita a leitura de dados por competência para dashboards e análises internas de RH.
Portais e automações
Atende cenários em que outro sistema precisa consultar informações do WPontual sem operação manual recorrente.
FAQ técnico
Dúvidas frequentes sobre a API WPontual.
A API permite alterar dados?
A documentação atual da Ponto API apresenta endpoints de consulta por método GET. Para necessidades de escrita ou alteração, fale com a equipe Pontual.
Como acesso a documentação completa?
A documentação interativa fica em wpontual.com.br/ponto-api/docs.
Existe paginação?
Sim. As listagens aceitam parâmetros como page e page_size, com limite documentado na especificação OpenAPI.
Preciso de chave de acesso?
Os endpoints documentam o cabeçalho x-api-key. A liberação e as credenciais devem ser solicitadas à Pontual.
Próximo passo
Solicite orientação para integrar com a API WPontual.
Conte qual sistema precisa consumir os dados, quais informações serão consultadas e o volume esperado. A equipe Pontual orienta o melhor caminho de liberação e uso.