ENDPOINTS

Registros de Ponto

Registre batidas de ponto e consulte o histórico completo de entradas e saídas dos colaboradores.

POST/v1/time-entriestime-entries:write

Registra uma batida de ponto (entrada ou saída) para um colaborador.

Parâmetros do body

Campo	Tipo	Obrig.	Descrição
`employeeId`	string (UUID)	sim	ID do colaborador que está batendo o ponto.
`type`	"ENTRY" \| "EXIT"	sim	Tipo da batida: ENTRY = entrada, EXIT = saída.
`timestamp`	string (ISO 8601)	não	Data/hora da batida. Se omitido, usa o momento atual.
`justification`	string	não	Justificativa opcional para a batida.

💡

A batida é criada com source: "API" e status APPROVED automaticamente.

curl -X POST https://api.meuponto360.com/v1/time-entries \
  -H "x-api-key: mp360_sk_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "employeeId": "a1b2c3d4-...",
    "type": "ENTRY",
    "timestamp": "2026-03-16T08:00:00-03:00"
  }'

Resposta (201)

201 Created

{
  "id": "f3a1b2c3-d4e5-...",
  "tenantId": "tenant-uuid",
  "employeeId": "a1b2c3d4-...",
  "type": "ENTRY",
  "source": "API",
  "status": "APPROVED",
  "timestamp": "2026-03-16T08:00:00.000Z",
  "justification": null,
  "createdAt": "2026-03-16T11:00:01.000Z"
}

GET/v1/time-entriestime-entries:read

Lista os registros de ponto do tenant com filtros opcionais por colaborador e período.

Query parameters

Campo	Tipo	Obrig.	Descrição
`from`	string (ISO 8601)	não	Data/hora inicial do filtro.
`to`	string (ISO 8601)	não	Data/hora final do filtro.
`employeeId`	string (UUID)	não	Filtrar por colaborador específico.
`page`	integer	não	Página (padrão: 1).
`limit`	integer	não	Itens por página, máximo 200 (padrão: 50).

# Todas as batidas de março de 2026
curl "https://api.meuponto360.com/v1/time-entries?from=2026-03-01&to=2026-03-31" \
  -H "x-api-key: mp360_sk_sua_chave"

# Batidas de um colaborador específico
curl "https://api.meuponto360.com/v1/time-entries?employeeId=a1b2c3d4-...&from=2026-03-01" \
  -H "x-api-key: mp360_sk_sua_chave"

Resposta (200)

200 OK

{
  "data": [
    {
      "id": "f3a1b2c3-...",
      "employeeId": "a1b2c3d4-...",
      "employee": {
        "id": "a1b2c3d4-...",
        "name": "João Silva",
        "registrationNumber": "001"
      },
      "type": "ENTRY",
      "source": "API",
      "status": "APPROVED",
      "timestamp": "2026-03-16T08:00:00.000Z"
    }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "lastPage": 3
  }
}