Supersociedades

Retorna as demonstrações financeiras anuais que uma empresa colombiana apresentou à Superintendencia de Sociedades: demonstração de resultados, demonstração da situação financeira e fluxo de caixa por ano fiscal, junto com a identidade da empresa conforme a capa do relatório. POST /co/supersociedades/financial-statements/v1

Campo	Tipo	Notas
`document_number`	string	Obrigatório. NIT colombiano, numérico, sem dígito verificador. 4-15 dígitos.

curl https://api.croma.run/co/supersociedades/financial-statements/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "900249127" }'

A resposta retorna uma entrada por ano fiscal (o relatório mais recente de cada ano, do mais novo ao mais antigo, até 10 anos):

Campo	Notas
`found`	`false` quando o NIT não tem relatórios registrados.
`document_number`	Retorna o NIT consultado.
`company`	Identidade conforme o relatório mais recente: `name`, `status`, `society_type`, `primary_activity` (CIIU com `code` + `description`), `incorporation_date`, `city`, `department`, `registration_number`.
`count`	Anos fiscais retornados.
`capped`	`true` quando o limite de resultados foi atingido; a resposta fica incompleta.
`statements[].year`	Ano fiscal; `cutoff_date` é sempre 31 de dezembro.
`statements[].filing_id`	Número de radicado; uma nova apresentação substitui a anterior.
`statements[].statement_type`	Escopo do relatório: `individual`, `separado`, `consolidado` ou `combinado`. Quando um ano tem vários, o `individual` é preferido.
`statements[].niif_group`	Marco de reporte: `plenas` (grupo 1) ou `pymes` (grupo 2).
`statements[].reporting_unit`	Unidade declarada para todos os valores. Os relatórios do ano fiscal 2025 em diante declaram `MILES DE PESOS`; os anteriores não declaram unidade e retornam `null`.
`statements[].income_statement`	`revenue`, `cost_of_sales`, `gross_profit`, `operating_profit`, `profit_before_tax`, `income_tax`, `net_income`, e linhas de despesas e financeiras.
`statements[].balance_sheet`	`total_assets`, `total_liabilities`, `total_equity`, desdobramentos circulante/não circulante, caixa, estoques, contas a receber e a pagar, capital.
`statements[].cash_flow`	`net_cash_from_operating`, `net_cash_from_investing`, `net_cash_from_financing`, mais `cash_at_start` e `cash_at_end`.

Os valores chegam tal como foram reportados, na reporting_unit do relatório. Um conceito não reportado chega como null, e cash_flow pode ser null em relatórios que não o incluem. Nem toda empresa colombiana reporta à Supersociedades: as entidades fiscalizadas por outros supervisores (bancos e seguradoras, por exemplo) normalmente retornarão found: false.

Referência completa

Esquemas e um playground interativo.

Primeiros passos

Países

Referência completa