curl --request DELETE \
--url https://api.example.com/colaborador/{colaboradorId}const options = {method: 'DELETE'};
fetch('https://api.example.com/colaborador/{colaboradorId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/colaborador/{colaboradorId}"
response = requests.delete(url)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/colaborador/{colaboradorId}"
req, _ := http.NewRequest("DELETE", 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/{colaboradorId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
]);
$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/{colaboradorId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
response = http.request(request)
puts response.read_body{
"status": true,
"mensagem": "OK"
}{
"service": "<string>",
"method": "<string>",
"message": "message erro"
}Exclui colaborador (soft-delete reversível)
Remove um colaborador da unidade de negócio. Soft-delete — o registro continua no banco para preservar histórico de ponto, folha e fiscalização (Portaria 671 exige retenção de 5 anos).
Comportamento por estado:
- Cadastro incompleto (sem vínculos organizacionais): exclui imediatamente sem precisar de
temCerteza - Cadastro finalizado (com vínculos): exige
?temCerteza=truecomo confirmação explícita. Sem isso, retorna 400 com mensagem instrutiva. Esse “double opt-in” evita exclusões acidentais via integração mal calibrada.
Efeitos:
- Colaborador some de listas filtradas
status=ATIVO(GET /colaborador?status=ATIVO) - Permanece em
GET /colaboradorsem filtro (com statusDEMITIDO) - Frequências e registros de ponto históricos continuam acessíveis em
GET /frequencyeGET /registro-ponto - Folha do mês corrente é recalculada (rescisão proporcional)
Reverter: dentro de janela curta, use PATCH /:id/recuperar (acima) para restaurar o cadastro completo. Após muito tempo, prefira POST /colaborador para recadastrar.
Atenção LGPD: este endpoint não apaga dados pessoais do banco — para “direito ao esquecimento” definitivo, abra ticket em tecnologia@pontua.com.br (anonimização exige procedimento formal de compliance).
curl --request DELETE \
--url https://api.example.com/colaborador/{colaboradorId}const options = {method: 'DELETE'};
fetch('https://api.example.com/colaborador/{colaboradorId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/colaborador/{colaboradorId}"
response = requests.delete(url)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/colaborador/{colaboradorId}"
req, _ := http.NewRequest("DELETE", 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/{colaboradorId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
]);
$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/{colaboradorId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
response = http.request(request)
puts response.read_body{
"status": true,
"mensagem": "OK"
}{
"service": "<string>",
"method": "<string>",
"message": "message erro"
}Path Parameters
Id do colaborador
"a2f2cbed-e141-465c-a769-f1591be5f35c"
Query Parameters
Quando o colaborador já tem cadastro finalizado (vínculos organizacionais completos), exige true para confirmar. Para cadastros incompletos, é ignorado.
true