# Envia um documento para a captura e extração de dados

Recebe um arquivo (PDF, JPEG, PNG ou BMP; máximo de 10 MB) via multipart/form-data e o encaminha para a extração automática de dados. Retorna o identificador do documento a ser processado, utilizado para consultar o status do processamento posteriormente.

Endpoint: POST /v1/captura/documentos
Version: v1
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    apiKey in header Authorization

## Request fields (multipart/form-data):

  - `arquivo` (string, required)
    Arquivo a ser enviado (PDF, JPEG, PNG ou BMP; máximo de 10 MB)

  - `descricao` (string)
    Descrição opcional do documento (máximo de 255 caracteres)

## Response 201:

  - `201` (unknown)
    Documento aceito para captura

## Response 201 fields (application/json):

  - `id` (string)
    ID do documento criado; chave para consultar o status
    Example: b9eac698-6eba-4901-b355-2f2748e386e0

  - `nome` (string)
    Nome do arquivo enviado
    Example: recibo-01-06.pdf

## Response 400:

  - `400` (unknown)
    Arquivo ausente/vazio, acima do tamanho máximo ou descrição inválida

## Response 400 fields (application/json):

  - `error` (string)

## Response 401:

  - `401` (unknown)
    Não autenticado

## Response 401 fields (application/json):

  - `error` (string)

## Response 415:

  - `415` (unknown)
    Formato não suportado ou divergente do conteúdo do arquivo

## Response 415 fields (application/json):

  - `error` (string)

## Response 429:

  - `429` (unknown)
    Excesso de requisições

## Response 429 fields (application/json):

  - `error` (string)

## Response 500:

  - `500` (unknown)
    Erro interno

## Response 500 fields (application/json):

  - `error` (string)

## Response 502:

  - `502` (unknown)
    Falha ao processar o documento

## Response 502 fields (application/json):

  - `error` (string)

## Response 503:

  - `503` (unknown)
    Serviço temporariamente indisponível

## Response 503 fields (application/json):

  - `error` (string)

## Response 504:

  - `504` (unknown)
    Tempo de processamento excedido

## Response 504 fields (application/json):

  - `error` (string)