Enviar Balanço e DRE

curl --location 'https://gyra-core.gyramais.com.br/report/69a207bcdd0197828df9155a/financial-tab' \
--header 'Authorization: Bearer abc123' \
--form 'files=@"/caminho/balanco-2025.pdf"' \
--form 'files=@"/caminho/dre-2025.pdf"'

import { readFile } from "node:fs/promises";

const form = new FormData();
const balanco = await readFile("/caminho/balanco-2025.pdf");
form.append("files", new Blob([balanco], { type: "application/pdf" }), "balanco-2025.pdf");

fetch("https://gyra-core.gyramais.com.br/report/69a207bcdd0197828df9155a/financial-tab", {
  method: "POST",
  headers: {
    "Authorization": "Bearer abc123",
  },
  body: form,
})
  .then(res => res.json())
  .then(console.log)

import requests

url = "https://gyra-core.gyramais.com.br/report/69a207bcdd0197828df9155a/financial-tab"
headers = {"Authorization": "Bearer abc123"}
files = [
    ("files", ("balanco-2025.pdf", open("/caminho/balanco-2025.pdf", "rb"), "application/pdf")),
    ("files", ("dre-2025.pdf", open("/caminho/dre-2025.pdf", "rb"), "application/pdf")),
]
response = requests.post(url, headers=headers, files=files)
print(response.json())

{
  "id": "69a207bcdd0197828df9155a",
  "document": "43591367000130",
  "name": "EMPRESA EXEMPLO LTDA",
  "organizationId": "6612a7f3fa9e086b00000000",
  "policyId": "6612a7f3625ea4ab00000000",
  "integrationTypes": [
    "GYRA_BALANCE_SHEET"
  ],
  "status": {
    "id": "6612a7f3410dcd8100000000",
    "title": "Não iniciado",
    "value": "PENDING",
    "color": "#FBBB3B"
  },
  "sections": [
    {
      "id": "6612a7f3a19b467000000000",
      "type": {
        "id": "6612a7f3625ea4ab00000001",
        "title": "Balanço patrimonial",
        "value": "BALANCE_SHEET"
      },
      "selectedIntegrations": [
        "GYRA_BALANCE_SHEET"
      ],
      "errors": []
    }
  ],
  "createdAt": "2026-02-27T21:08:11.938Z",
  "updatedAt": "2026-02-27T21:12:04.221Z"
}

{
  "code": 400,
  "message": "No file uploaded."
}

{
  "code": 400,
  "message": "Only valid PDF files are allowed."
}

{
  "code": 413,
  "message": "File too large"
}

{
  "code": 401,
  "message": "Token de acesso inválido."
}

{
  "code": 404,
  "message": "Relatório não encontrado"
}

Quando usar

Use este endpoint quando você já tem o balanço e a DRE em PDF e quer que a GYRA+ transforme as demonstrações em dados estruturados: balanço e DRE padronizados, indicadores calculados e parecer de IA, tudo dentro de um relatório de CNPJ já existente. É o mesmo processamento que roda quando um analista envia o balanço pela tela do Toolbox. Se a GYRA+ já encontrou demonstrações públicas da empresa, o envio soma ao que existe, não substitui. Veja o funcionamento completo em Análise Financeira.

A chamada é assíncrona. O 200 significa “arquivos aceitos e enfileirados”, não “dados prontos”. Os dados estruturados saem depois, em GET /report/{id}/section/BALANCE_SHEET (e nas demais seções financeiras).

Pré-requisitos

Um relatório de CNPJ já criado (POST /v2/report), cujo id vai na URL.
Token JWT válido (POST /auth/authenticate).
Os PDFs, de preferência contendo apenas as páginas do Balanço Patrimonial e da DRE.

Autenticação

Bearer JWT no header Authorization.

Parâmetros

Nome	Local	Tipo	Obrigatório	Descrição
`id`	`path`	`string`	`sim`	ID do relatório que vai receber as demonstrações. Precisa ser um relatório da sua organização.
`files`	`form-data`	`file[]`	`sim`	PDFs do balanço e/ou da DRE. Repita o campo `files` para enviar mais de um arquivo.

O corpo é multipart/form-data. Não envie JSON.

Limites e validações

Regra	Valor	O que acontece se violar
Formato	Somente PDF	`400 Only valid PDF files are allowed.` O arquivo é lido nos primeiros bytes (`%PDF-`), renomear a extensão não passa.
Tamanho por arquivo	50 MB	`413 File too large`
Arquivos por chamada	10	`400 Unexpected field` (o lote inteiro é recusado, nada é processado).
Nenhum arquivo	n/a	`400 No file uploaded.`
Relatório de outra organização	n/a	`404` (não distinguimos de relatório inexistente, para não vazar a existência).

Enviar o PDF inteiro (capa, notas explicativas, parecer do auditor) funciona, mas custa mais e piora a precisão. Recorte o PDF nas páginas com números antes de enviar: Balanço Patrimonial (Ativo e Passivo) e DRE. Se cada exercício veio em um arquivo, mande todos na mesma chamada: eles são consolidados na mesma análise.

O que acontece depois

A chamada já cria as seções financeiras do relatório, vazias. É por isso que consultá-las logo depois do upload responde 200 com conteúdo vazio, e não 404.
Cada arquivo vira um job de extração paralelo: leitura das tabelas (inclusive em documentos escaneados), padronização das linhas para o plano de contas único da GYRA+, validação da consistência contábil e cálculo dos indicadores.
Ao final, as seções são preenchidas e a organização recebe um e-mail com a planilha consolidada.

Para consumir o resultado:

O que você quer	Chamada
Balanço patrimonial estruturado	`GET /report/{id}/section/BALANCE_SHEET`
DRE estruturada	`GET /report/{id}/section/DRE`
Indicadores calculados	`GET /report/{id}/section/FINANCIAL_INDICATORS`
Parecer de IA do balanço	`GET /report/{id}/insights?section=BALANCE_SHEET`
Relatório completo	`GET /v2/report/{id}`

O envio cria mais seis seções, derivadas das mesmas demonstrações:

`sectionType`	O que traz
`FINANCIAL_INSIGHTS`	Resumo executivo, pontos de atenção, score e nível de risco da leitura financeira
`FINANCIAL_RECOMMENDATIONS`	Recomendação de crédito por modalidade (com e sem garantia, recebíveis, compra parcelada), com status e limite sugerido
`DETAILED_COSTS`	Agregados de caixa, receitas e despesas financeiras
`BALANCE_SHEET_CHART` e `COST_PROFIT_FORECAST`	Séries já formatadas para gráfico (ativo x passivo, custo x lucro). São derivadas: os mesmos números estão em `BALANCE_SHEET` e `DRE`
`SUPPLIERS_CLIENTS`	Fornecedores e clientes citados nas demonstrações. Costuma vir vazia: só é preenchida quando o documento traz essa informação

Todas as seções são organizadas por período ({"202401_202412": {...}}), o que permite comparar exercícios. A lista completa de tipos está em Consultar Seção por Tipo.

Para a maioria das integrações, BALANCE_SHEET, DRE e FINANCIAL_INDICATORS bastam. As seções de gráfico existem para a tela do Toolbox e não acrescentam informação.

Como saber que terminou

Não existe endpoint de status do lote. Duas formas de acompanhar:

Polling da seção (mais simples)

Consulte GET /report/{id}/section/BALANCE_SHEET a cada alguns minutos. Como as seções passam a existir já no 200 do upload, a leitura é sempre 200: conteúdo vazio significa que a extração ainda está rodando, conteúdo preenchido significa que terminou.Um 404 aqui não quer dizer “ainda processando”, e sim que aquele relatório nunca recebeu balanço, nem por envio nem por descoberta automática.

Webhook (evita o polling)

Relatórios criados por POST /v2/report notificam por webhook. Com um webhook do tipo REPORT registrado, sua URL recebe um POST a cada atualização de seção do relatório, incluindo as financeiras.O payload traz o conteúdo da seção em data.content e o relatório em data.content.report.id, mas não identifica qual seção foi atualizada. Ou seja: use o webhook como gatilho para reconsultar a seção que te interessa, não como um evento “balanço pronto”.

Se a extração falhar ou ficar abaixo do nível de confiança exigido, as seções não são preenchidas com número errado: o erro fica registrado no campo errors da seção e o documento original continua disponível para conferência manual.

curl --location 'https://gyra-core.gyramais.com.br/report/69a207bcdd0197828df9155a/financial-tab' \
--header 'Authorization: Bearer abc123' \
--form 'files=@"/caminho/balanco-2025.pdf"' \
--form 'files=@"/caminho/dre-2025.pdf"'

import { readFile } from "node:fs/promises";

const form = new FormData();
const balanco = await readFile("/caminho/balanco-2025.pdf");
form.append("files", new Blob([balanco], { type: "application/pdf" }), "balanco-2025.pdf");

fetch("https://gyra-core.gyramais.com.br/report/69a207bcdd0197828df9155a/financial-tab", {
  method: "POST",
  headers: {
    "Authorization": "Bearer abc123",
  },
  body: form,
})
  .then(res => res.json())
  .then(console.log)

import requests

url = "https://gyra-core.gyramais.com.br/report/69a207bcdd0197828df9155a/financial-tab"
headers = {"Authorization": "Bearer abc123"}
files = [
    ("files", ("balanco-2025.pdf", open("/caminho/balanco-2025.pdf", "rb"), "application/pdf")),
    ("files", ("dre-2025.pdf", open("/caminho/dre-2025.pdf", "rb"), "application/pdf")),
]
response = requests.post(url, headers=headers, files=files)
print(response.json())

{
  "id": "69a207bcdd0197828df9155a",
  "document": "43591367000130",
  "name": "EMPRESA EXEMPLO LTDA",
  "organizationId": "6612a7f3fa9e086b00000000",
  "policyId": "6612a7f3625ea4ab00000000",
  "integrationTypes": [
    "GYRA_BALANCE_SHEET"
  ],
  "status": {
    "id": "6612a7f3410dcd8100000000",
    "title": "Não iniciado",
    "value": "PENDING",
    "color": "#FBBB3B"
  },
  "sections": [
    {
      "id": "6612a7f3a19b467000000000",
      "type": {
        "id": "6612a7f3625ea4ab00000001",
        "title": "Balanço patrimonial",
        "value": "BALANCE_SHEET"
      },
      "selectedIntegrations": [
        "GYRA_BALANCE_SHEET"
      ],
      "errors": []
    }
  ],
  "createdAt": "2026-02-27T21:08:11.938Z",
  "updatedAt": "2026-02-27T21:12:04.221Z"
}

{
  "code": 400,
  "message": "No file uploaded."
}

{
  "code": 400,
  "message": "Only valid PDF files are allowed."
}

{
  "code": 413,
  "message": "File too large"
}

{
  "code": 401,
  "message": "Token de acesso inválido."
}

{
  "code": 404,
  "message": "Relatório não encontrado"
}

Primeiros Passos

Conceitos Fundamentais

Guia do Toolbox

Fontes de Dados

Guias

Casos de Uso

MCP Server

Referência da API

Dicionário de Dados

Integrações

Referência

Enviar Balanço e DRE

Quando usar

Pré-requisitos

Autenticação

Parâmetros

Limites e validações

O que acontece depois

Como saber que terminou

​Quando usar

​Pré-requisitos

​Autenticação

​Parâmetros

​Limites e validações

​O que acontece depois

​Como saber que terminou

Quando usar

Pré-requisitos

Autenticação

Parâmetros

Limites e validações

O que acontece depois

Como saber que terminou