Gerar AFD

Gera um arquivo AFD (Arquivo Fonte de Dados) sob demanda para o período especificado. Requer scope arquivos:write. Para API Keys de empresa, empresa_id é opcional e a empresa vinculada à chave é usada por padrão. Para API Keys de cliente, empresa_id é obrigatório. Em ambos os casos, a empresa alvo deve pertencer ao escopo da chave e ao modo de sandbox informado.

Autenticação:

🔑 API Key

Corpo

empresa_idnumber

Empresa para a qual o AFD será gerado. Obrigatório para API Keys de cliente; opcional para chaves de empresa.

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": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "empresa_id": 1,
    "colaborador_id": null,
    "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",
    "created_at": "2026-02-04T12:00:00Z"
  }
}

Sandbox Mode

curl --request POST \
  'https://rep-gestor.youuponto.com/api/v1/afd' \
  --header 'x-api-key: yk_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "empresa_id": 1,
  "periodo": "01/02/2026 - 28/02/2026",
  "colaborador_id": "10"
}'

Exemplos de Resposta

{
  "ok": true,
  "data": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "empresa_id": 1,
    "colaborador_id": null,
    "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",
    "created_at": "2026-02-04T12:00:00Z"
  }
}