Busca colaboradores por CPF
curl --request GET \
--url https://api.example.com/colaborador/{cpf}/cpfconst options = {method: 'GET'};
fetch('https://api.example.com/colaborador/{cpf}/cpf', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/colaborador/{cpf}/cpf"
response = requests.get(url)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/colaborador/{cpf}/cpf"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/colaborador/{cpf}/cpf",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.example.com/colaborador/{cpf}/cpf")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"total": 100,
"colaboradores": [
{
"colaboradorId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nivelAcesso": "USER",
"nome": "Douglas Coelho",
"tipoColaborador": "CLT",
"tipoIdentificacao": "CPF",
"numeroDocumento": "71055398712",
"unidadeNegocio": {
"unidadeNegocioId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nome": "Tron",
"foto": "https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg",
"tax": "71055398712"
},
"cargo": {
"cargoId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nome": "Analista de Marketing"
},
"departamento": {
"departamentoId": "c9f447fe-f97f-4f24-974d-9f92eb3049dc",
"nome": "Desenvolvimento"
},
"situacao": "ATIVO",
"numeroPrevidenciario": "N586692225",
"equipe": {
"equipeId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nome": "Squad Plataforma"
},
"email": "douglas@empresa.com.br",
"celular": "+5562999999999",
"dataAdmissao": "2024-01-15T00:00:00.000Z",
"dataDemissao": "2026-05-07T00:00:00.000Z",
"createdAt": "2024-01-10T12:34:56.000Z",
"updatedAt": "2024-02-20T08:22:11.000Z",
"localTrabalho": {
"localTrabalhoId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nome": "Sede Goiânia"
},
"centroCusto": {
"centroCustoId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nome": "Tecnologia / R&D"
},
"dataInicio": "2024-01-15T00:00:00.000Z",
"statusFacial": "COMPLETO",
"foto": "https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg",
"facialId": {
"id": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"codigoFacial": "FULANO.10",
"situacao": "Ativo",
"dataExpiracao": "2025-07-23T00:00:00.000Z"
}
}
],
"pagina": 0,
"limite": 25
}{
"service": "<string>",
"method": "<string>",
"message": "message erro"
}Colaborador
Busca colaboradores por CPF
Localiza colaboradores a partir do CPF (passado sem máscara — só os 11 dígitos). Útil quando a integração tem o CPF (vindo da folha/RH) mas não o colaboradorId.
Pode retornar mais de um: a Pontua suporta o mesmo CPF em UNs diferentes (CNPJ é a chave de unicidade do tenant). Mas dentro da mesma UN, CPF é único — então a lista terá no máximo 1 elemento dentro do escopo do token autenticado.
Casos de uso:
- Resolver “quem é o CPF X aqui?” antes de criar registro de ponto
- Sincronização inicial quando você só tem o CSV da folha externa
- Consulta cruzada entre tenant matriz e filiais
Formato: /colaborador/:cpf/cpf aceita 11 dígitos numéricos. Pontuação (. e -) é tolerada mas recomenda-se enviar limpo. CPFs inválidos (dígito verificador errado) retornam 400.
GET
/
colaborador
/
{cpf}
/
cpf
Busca colaboradores por CPF
curl --request GET \
--url https://api.example.com/colaborador/{cpf}/cpfconst options = {method: 'GET'};
fetch('https://api.example.com/colaborador/{cpf}/cpf', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/colaborador/{cpf}/cpf"
response = requests.get(url)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/colaborador/{cpf}/cpf"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/colaborador/{cpf}/cpf",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.example.com/colaborador/{cpf}/cpf")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"total": 100,
"colaboradores": [
{
"colaboradorId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nivelAcesso": "USER",
"nome": "Douglas Coelho",
"tipoColaborador": "CLT",
"tipoIdentificacao": "CPF",
"numeroDocumento": "71055398712",
"unidadeNegocio": {
"unidadeNegocioId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nome": "Tron",
"foto": "https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg",
"tax": "71055398712"
},
"cargo": {
"cargoId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nome": "Analista de Marketing"
},
"departamento": {
"departamentoId": "c9f447fe-f97f-4f24-974d-9f92eb3049dc",
"nome": "Desenvolvimento"
},
"situacao": "ATIVO",
"numeroPrevidenciario": "N586692225",
"equipe": {
"equipeId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nome": "Squad Plataforma"
},
"email": "douglas@empresa.com.br",
"celular": "+5562999999999",
"dataAdmissao": "2024-01-15T00:00:00.000Z",
"dataDemissao": "2026-05-07T00:00:00.000Z",
"createdAt": "2024-01-10T12:34:56.000Z",
"updatedAt": "2024-02-20T08:22:11.000Z",
"localTrabalho": {
"localTrabalhoId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nome": "Sede Goiânia"
},
"centroCusto": {
"centroCustoId": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"nome": "Tecnologia / R&D"
},
"dataInicio": "2024-01-15T00:00:00.000Z",
"statusFacial": "COMPLETO",
"foto": "https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg",
"facialId": {
"id": "b5887a64-6aa1-43e8-b233-ffadc7f92ca6",
"codigoFacial": "FULANO.10",
"situacao": "Ativo",
"dataExpiracao": "2025-07-23T00:00:00.000Z"
}
}
],
"pagina": 0,
"limite": 25
}{
"service": "<string>",
"method": "<string>",
"message": "message erro"
}Path Parameters
CPf
Response
Lista (geralmente unitária) de colaboradores com aquele CPF na UN do token