ENDPOINTS

Relatórios

Gere relatórios de ponto e arquivos de compliance conforme a Portaria 671 do MTE, incluindo AFDT e ACJEF.

GET/v1/reports/periodreports:read

Retorna o relatório consolidado de um período: horas trabalhadas, saldo, horas extras e faltas por colaborador.

Query parameters

Campo	Tipo	Obrig.	Descrição
`start`	string (ISO 8601)	sim	Data de início do período. Ex: 2026-03-01
`end`	string (ISO 8601)	sim	Data de fim do período. Ex: 2026-03-31

curl "https://api.meuponto360.com/v1/reports/period?start=2026-03-01&end=2026-03-31" \
  -H "x-api-key: mp360_sk_sua_chave"

200 OK

[
  {
    "id": "a1b2c3d4-...",
    "name": "João Silva",
    "registrationNumber": "001",
    "department": "Tecnologia",
    "totalExpected": "176h 00m",
    "totalWorked": "178h 30m",
    "totalBalance": "+2h 30m",
    "totalExtras": "4h 00m",
    "daysWorked": 22,
    "absences": 0
  }
]

GET/v1/reports/afdtreports:read

Gera o arquivo AFDT (Arquivo de Fonte de Dados Tratados) no formato exigido pela Portaria 671 do MTE.

ℹ️

O AFDT é o arquivo oficial de exportação de ponto eletrônico para fiscalização do Ministério do Trabalho. O endpoint retorna o conteúdo textual do arquivo.

Query parameters

Campo	Tipo	Obrig.	Descrição
`start`	string (ISO 8601)	sim	Data de início do período.
`end`	string (ISO 8601)	sim	Data de fim do período.

# Baixar AFDT como arquivo
curl "https://api.meuponto360.com/v1/reports/afdt?start=2026-03-01&end=2026-03-31" \
  -H "x-api-key: mp360_sk_sua_chave" \
  -o afdt_marco_2026.txt