# Demonstrativo de Resultado do Exercício (DRE)

Retorna o Demonstrativo de Resultado do Exercício (DRE) com informações sobre receitas e despesas organizadas por conta contábil.

O DRE agrupa as movimentações financeiras por conta contábil (plano de contas) e calcula os totais de receitas e despesas para o período especificado.

Endpoint: GET /api/v3/dre
Version: 3.0.0
Security: OAuth2

## Header parameters:

  - `CPlug-Company-Id` (number, required)
    Id da Empresa (Company).

Você pode localizar os IDs das empresas no _endpoint_ de listagem de empresas.
    Example: 12

## Query parameters:

  - `date_start` (string)
    Data de início do período para geração do DRE.
Se não informada, utiliza o primeiro dia do mês atual.
    Example: "2024-01-01"

  - `date_end` (string)
    Data de fim do período para geração do DRE.
Se não informada, utiliza o último dia do mês atual.
O período máximo permitido é de 60 dias.
    Example: "2024-01-31"

  - `company_id` (integer)
    ID da empresa para filtrar os resultados.
Se não informado, utiliza a empresa selecionada na sessão.
    Example: 123

## Response 200 fields (application/json):

  - `data` (object)

  - `data.results` (array)
    Lista de contas contábeis com suas respectivas movimentações

  - `data.results.id` (integer)
    ID único da conta contábil
    Example: 123

  - `data.results.name` (string, required)
    Nome da conta contábil
    Example: "Receita de Vendas"

  - `data.results.type` (string, required)
    Tipo da conta contábil:
- income: Receita
- expense: Despesa
    Enum: "income", "expense"

  - `data.results.total` (object, required)
    Valor total das movimentações da conta no período

  - `data.results.total.amount` (number, required)
    Valor expresso como um número decimal das principais unidades monetárias
    Example: 99.95

  - `data.results.total.currency` (string, required)
    Código de moeda de 3 letras conforme definido pela ISO-4217
    Example: "BRL"

  - `data.results.account_plans` (array, required)
    Lista de planos de conta relacionados a esta conta contábil

  - `data.results.account_plans.id` (integer)
    ID único do plano de conta.
Pode ser null para planos de conta especiais como "Descontos" ou "Juros".
    Example: 10

  - `data.results.account_plans.name` (string, required)
    Nome do plano de conta
    Example: "Vendas de Produtos"

  - `data.results.account_plans.total` (object, required)
    Valor total das movimentações deste plano de conta no período

## Response 400 fields (application/json):

  - `code` (string, required)
    Código de erro.
    Example: "missing_headers"

  - `message` (string)
    Descrição do erro.
    Example: "error message"

  - `meta` (array)
    Dados adicionais sobre o erro.

## Response 422 fields (application/json):

  - `code` (string, required)
    Código de erro.
    Example: "uneditable_entity"

  - `message` (string)
    Descrição do erro.
    Example: "description error"

  - `meta` (array)
    Dados adicionais sobre o erro.

  - `meta.field` (string, required)
    Nome do campo no qual existe um erro de validação.
    Example: "name"

  - `meta.validations` (array)

  - `meta.validations.type` (string, required)
    Tipo da validação aplicada.
    Example: "Required"

  - `meta.validations.value` (array)
    Tipo de valor aplicável (esse campo pode ser vazio).


## Response 401 fields

## Response 403 fields