> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base39.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral

> Envie documentos e receba dados estruturados automaticamente

## Como funciona

Ao enviar um documento, a Base39 lê o conteúdo, identifica o tipo e extrai os dados em formato JSON.

```mermaid theme={null}
flowchart LR
    A[Upload] --> B[Leitura]
    B --> C[Classificação]
    C --> D[Extração]
    D --> E[JSON]
```

## Etapas do processamento

<Steps>
  <Step title="Upload">
    O arquivo é enviado usando uma URL temporária fornecida pela API
  </Step>

  <Step title="Leitura">O conteúdo do documento é lido e interpretado</Step>

  <Step title="Classificação">
    O sistema reconhece o tipo de documento (balanço, DRE, nota fiscal, etc.)
  </Step>

  <Step title="Extração">Os dados são extraídos e organizados em JSON</Step>
</Steps>

## Formatos aceitos

| Extensão                         | Processamento     |
| -------------------------------- | ----------------- |
| `.pdf`                           | Leitura completa  |
| `.png`, `.jpg`, `.jpeg`, `.tiff` | Leitura de imagem |
| `.txt`, `.csv`, `.tsv`           | Leitura direta    |

## Templates disponíveis

Cada tipo de documento possui extração especializada:

<CardGroup cols={2}>
  <Card title="Balanço patrimonial" icon="scale-balanced" href="/api-reference/files/templates/balance-sheet">
    Ativos, passivos e patrimônio líquido
  </Card>

  <Card title="DRE" icon="chart-line" href="/api-reference/files/templates/income-statement">
    Demonstração de resultados (em breve)
  </Card>
</CardGroup>

## Status do processamento

| Status        | Significado                    |
| ------------- | ------------------------------ |
| `not_started` | Tipo de arquivo não processado |
| `pending`     | Aguardando na fila             |
| `processing`  | Leitura em andamento           |
| `completed`   | Concluído com sucesso          |
| `failed`      | Falha no processamento         |

## Exemplo de resposta

```json theme={null}
{
  "object": "file_upload",
  "id": "fu_abc123",
  "status": "uploaded",
  "filename": "balanco_2024.pdf",
  "parsing": {
    "status": "completed",
    "template": "balance_sheet",
    "confidence": 0.95
  },
  "parsed_data": {}
}
```

## Próximos passos

<CardGroup cols={2}>
  <Card title="Enviar arquivos" icon="upload" href="/api-reference/files/upload">
    Como fazer upload
  </Card>

  <Card title="Acompanhar leitura" icon="magnifying-glass" href="/api-reference/files/parsing">
    Consultar status do processamento
  </Card>
</CardGroup>