POST
/api/v1/afd

Gerar AFD

Gera um arquivo AFD (Arquivo Fonte de Dados) sob demanda para o período especificado. Requer scope arquivos:write.
Autenticação:
🔑 API Key

Corpo

periodostring
Obrigatório

Período no formato "dd/MM/yyyy - dd/MM/yyyy"

colaborador_idstring

ID do colaborador para filtrar (opcional)

Respostas

{
  "ok": true,
  "data": {
    "arquivo_id": 123,
    "empresa_id": 1,
    "nome_arquivo": "AFD_20260204120000.txt",
    "url": "https://youurep.supabase.co/.../AFD_....txt",
    "url_assinada": "https://youurep.supabase.co/.../AFD_....p7s",
    "gerado_em": "2026-02-04T12:00:00Z",
    "tipo_arquivo": "AFD",
    "periodo": "01/02/2026 - 28/02/2026"
  }
}
curl --request POST \
  'http://localhost:3000/api/v1/afd' \
  --header 'x-api-key: yk_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "periodo": "01/02/2026 - 28/02/2026",
  "colaborador_id": "10"
}'

Exemplos de Resposta

{
  "ok": true,
  "data": {
    "arquivo_id": 123,
    "empresa_id": 1,
    "nome_arquivo": "AFD_20260204120000.txt",
    "url": "https://youurep.supabase.co/.../AFD_....txt",
    "url_assinada": "https://youurep.supabase.co/.../AFD_....p7s",
    "gerado_em": "2026-02-04T12:00:00Z",
    "tipo_arquivo": "AFD",
    "periodo": "01/02/2026 - 28/02/2026"
  }
}