Pré-requisitos
- Conta Pontua com plano que inclui acesso à API (se não tiver certeza, fale com sua gerência)
- Permissão de administrador na unidade de negócio (gestão de tokens é restrita)
- Cliente HTTP da sua escolha —
curl, Postman, ou um SDK (Node, Python, Go, etc.)
1. Gere um token de API
1
Acesse o dashboard
Entre em oi.pontua.com.br com sua conta administrativa.
2
Vá para Configurações → API
No menu lateral: Gestão de Pessoas → Configurações → API.
3
Crie um novo token
Clique em Criar novo token. Defina:
- Nome identificador — descritivo por integração (ex.:
[PROD] erp-domínio,[HML] script-relatorio-mensal) - Validade — entre 7 dias e 5 anos (ver Autenticação para detalhes)
4
Copie o token IMEDIATAMENTE
O valor aparece uma única vez após gerar. Cole em um cofre de senhas
(1Password, Doppler, AWS Secrets Manager) — você não conseguirá vê-lo
de novo no dashboard.
2. Faça sua primeira chamada
Liste os primeiros 10 colaboradores:3. Resposta esperada
4. Próximos passos
Cadastrar primeiro colaborador via API
Walkthrough completo do POST
/colaborador com payload mínimoPuxar folha do mês
Use
/payment-sheet/export para gerar o TXT no layout da sua folhaEntender erros
Códigos HTTP, mensagens comuns, estratégias de retry com backoff
Configurar multi-tenant
Como funciona se você atende múltiplas unidades de negócio
Troubleshooting do primeiro request
Mais detalhes em Erros.