POST
/api/v1/aej

Solicitar geração de AEJ

Recebe o snapshot fechado do Programa de Tratamento de Registro de Ponto e inicia, de forma assíncrona, a geração do AEJ. O YouuREP reconcilia o snapshot com as marcações originais imutáveis, grava o documento em Storage privado com MIME text/plain e gera uma assinatura CAdES destacada (.p7s). Requer arquivos:write. Use Idempotency-Key para repetir a mesma solicitação sem criar outra geração. Se a geração idempotente anterior tiver falhado, uma nova chamada recoloca a mesma geração na fila e retorna criado=false e status=pending.
Autenticação:
🔑 API Key

Corpo

empresa_idnumber
Obrigatório

ID da empresa no YouuREP.

snapshotobject
Obrigatório

Snapshot completo e validado do período, com empresa, PTRP, empregados, horários, marcações e tratamentos.

Respostas

{
  "ok": true,
  "data": {
    "geracao_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "pending",
    "criado": true,
    "correlacao_id": "36c9f170-8120-4d70-a36a-830e08d37071"
  }
}
curl --request POST \
  'https://rep-gestor.youuponto.com/api/v1/aej' \
  --header 'x-api-key: yk_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "empresa_id": 1,
  "snapshot": {
    "schema_version": "1.0",
    "snapshot_id": "550e8400-e29b-41d4-a716-446655440000",
    "source_system": "YOUPONTO",
    "periodo": {
      "inicio": "2026-02-01",
      "fim": "2026-02-28"
    },
    "colaboradores": []
  }
}'

Exemplos de Resposta

{
  "ok": true,
  "data": {
    "geracao_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "pending",
    "criado": true,
    "correlacao_id": "36c9f170-8120-4d70-a36a-830e08d37071"
  }
}