ENDPOINTS

Ajustes de Ponto

Liste e crie solicitações de ajuste de ponto — ausências, horas extras, correções de batida e outros tipos. Sujeito ao fluxo de aprovação configurado no tenant.

GET/v1/adjustmentsadjustments:read

Lista solicitações de ajuste do tenant com filtros opcionais.

Query parameters

Campo	Tipo	Obrig.	Descrição
`employeeId`	string (UUID)	não	Filtrar por colaborador.
`status`	PENDING \| APPROVED \| REJECTED	não	Filtrar por status da solicitação.
`type`	string	não	Tipo do ajuste (ver tabela abaixo).
`limit`	integer	não	Itens retornados (padrão: 20, máx: 100).
`cursor`	string	não	ID do último item para paginação baseada em cursor.

Tipos de ajuste disponíveis

Tipo	Descrição
`ABSENCE`	Registrar falta justificada
`OVERTIME`	Solicitação de horas extras
`PUNCH_CORRECTION`	Corrigir ou adicionar batida de ponto
`EARLY_LEAVE`	Saída antecipada justificada
`LATE_ARRIVAL`	Chegada tardia justificada
`DAY_OFF`	Folga compensatória
`VACATION`	Férias
`MEDICAL_LEAVE`	Licença médica
`OTHER`	Outros ajustes

# Listar ajustes pendentes
curl "https://api.meuponto360.com/v1/adjustments?status=PENDING&limit=20" \
  -H "x-api-key: mp360_sk_sua_chave"

200 OK

{
  "data": [
    {
      "id": "adj-uuid-...",
      "employeeId": "a1b2c3d4-...",
      "type": "ABSENCE",
      "status": "PENDING",
      "date": "2026-04-10",
      "justification": "Consulta médica",
      "createdAt": "2026-04-10T09:00:00.000Z",
      "updatedAt": "2026-04-10T09:00:00.000Z"
    }
  ],
  "nextCursor": null
}

POST/v1/adjustmentsadjustments:write

Cria uma nova solicitação de ajuste de ponto para um colaborador.

Parâmetros do body

Campo	Tipo	Obrig.	Descrição
`employeeId`	string (UUID)	sim	ID do colaborador.
`type`	string	sim	Tipo do ajuste (ver tabela acima).
`date`	string (ISO 8601)	sim	Data do ajuste.
`justification`	string	sim	Motivo do ajuste.
`data`	object	não	Dados adicionais dependentes do tipo (ex: horários para PUNCH_CORRECTION).

ℹ️

Se o tenant tiver requireHRApproval = false, o ajuste é aprovado automaticamente na criação. Caso contrário, ficará com status PENDING.

curl -X POST https://api.meuponto360.com/v1/adjustments \
  -H "x-api-key: mp360_sk_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "employeeId": "a1b2c3d4-...",
    "type": "ABSENCE",
    "date": "2026-04-10",
    "justification": "Consulta médica com atestado"
  }'