Datas e formatos

Datas na resposta

Datas com hora saem no horário de Brasília (America/Sao_Paulo), no formato:

yyyy-MM-dd HH:mm:ss        →  "2026-10-03 14:30:00"

Algumas rotas de domínio usam ISO 8601 com fuso, e isso aparece no esquema da operação — por exemplo, a hora do servidor no quiosque de ponto.

Datas na requisição

A API aceita qualquer um destes formatos:

Formato	Exemplo
ISO 8601 com fuso	2026-10-03T17:30:00Z, 2026-10-03T14:30:00-03:00
ISO 8601 com milissegundos	2026-10-03T17:30:00.000Z
Data e hora	2026-10-03 14:30:00, 2026-10-03 14:30
Só data	2026-10-03
Formato brasileiro	03/10/2026 14:30:00, 03/10/2026
Epoch	1791048600000 (milissegundos) ou 1791048600 (segundos)

Datas civis — nascimento, admissão, competência, vencimento — são dias do calendário, não instantes. Envie-as como yyyy-MM-dd. Mandar um instante em UTC perto da meia-noite pode virar o dia anterior no horário de Brasília.

Números e dinheiro

Valores monetários são números decimais em reais, com ponto: 4850.75. Não há campo de moeda.

Enumerações

Campos de lista fechada (tipo de contrato, status, regime) aceitam só os valores que a referência lista para aquele campo, em maiúsculas: "tipoContrato": "CLT". Um valor fora da lista é recusado com 400.

Textos e codificação

Requisições e respostas em UTF-8.

Arquivos

Rotas de upload recebem multipart/form-data, com até 150 MB por arquivo e por requisição. Rotas que devolvem arquivo (PDF, XLSX, AFD) respondem com o Content-Type do arquivo e Content-Disposition com o nome sugerido.