Skip to main content
Retorna o que uma empresa colombiana apresentou à Superintendencia de Sociedades: as demonstrações financeiras anuais (demonstração de resultados, demonstração da situação financeira e fluxo de caixa por ano fiscal), e as notas do mesmo relatório que declaram seus acionistas, investidores estrangeiros, subsidiárias, coligadas e administradores. Cerca de 30.000 empresas reportam a cada ano: as que a Superintendencia supervisiona e as que superam seus limites de ativos e receitas.

Acionistas e composição

POST /co/supersociedades/shareholders/v1 Quem é dono da empresa, do que ela é dona e quem a administra, tal como a própria empresa declarou nas notas de seu relatório mais recente.
A resposta descreve um relatório:
É o que a empresa declarou em suas próprias demonstrações financeiras, não um registro cartorial: serve para corroborar e pré-preencher, não como prova de propriedade. Os valores chegam tal como reportados. Uma empresa que reporta mas não declarou acionistas retorna found: true com um array shareholders vazio; uma empresa que não reporta à Superintendencia (a maioria das pequenas, e as fiscalizadas por outros supervisores como bancos e seguradoras) retorna found: false.

Demonstrações financeiras

POST /co/supersociedades/financial-statements/v1
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):
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.

Buscar empresas

POST /co/supersociedades/companies-search/v1 Dataset Todas as empresas que reportam à Superintendencia, filtradas por setor, lugar, situação e tamanho, da maior à menor.
Retorna as_of, fiscal_year (o ano buscado), total e total_is_exact, os campos de paginação e results[], um relatório cada:
Só estão as empresas que reportam à Superintendencia: as que ela supervisiona e as que superam seus limites de ativos e receitas. Bancos, seguradoras e outras entidades fiscalizadas por outros supervisores não. Os valores chegam como reportados, em milhares de pesos.

Uma empresa ao longo do tempo

POST /co/supersociedades/company/v1 Dataset Cada ano em que a empresa reportou, com os mesmos campos de um resultado de busca.
Retorna as_of, found, document_number, name (conforme o relatório mais recente), fiscal_years[] (do mais recente ao mais antigo) e filings[]: uma linha por relatório, do ano mais recente ao mais antigo, o relatório preferido de cada ano primeiro.
Um NIT sem relatórios retorna found: false com HTTP 200.

Demonstrações completas de um relatório

POST /co/supersociedades/filing-statements/v1 Dataset Todas as linhas que a empresa reportou, não só os valores principais.
Retorna as_of, found, document_number, fiscal_years[] e filing:
found: false quando o NIT não tem relatório para o ano e tipo pedidos. Os valores chegam como reportados, em milhares de pesos.

Buscar por parte

POST /co/supersociedades/ownership-search/v1 Dataset De uma cédula ou NIT a todos os relatórios que a declaram, em qualquer papel.
Retorna as_of, total, total_is_exact, os campos de paginação e results[], um relatório cada, com a identidade do relatório (id, document_number, name, fiscal_year, cutoff_date, statement_type, preferred) e:
É o que cada empresa declarou em suas próprias demonstrações financeiras, não um registro: serve para corroborar e pré-preencher, nunca como prova de propriedade. Uma busca sem party_document_number nem query lista os relatórios mais recentes.

Partes de um relatório

POST /co/supersociedades/filing-ownership/v1 Dataset Os mesmos campos de um resultado da busca por parte, para um relatório.
Retorna as_of, found, document_number, fiscal_years[] e filing, com os campos descritos na busca por parte.
found: false quando o NIT não tem um relatório com essas notas para o ano e tipo pedidos.

Notas explicativas de um relatório

POST /co/supersociedades/filing-disclosures/v1 Dataset O que a empresa divulgou além das demonstrações e das partes, nota por nota.
Retorna as_of, found, document_number, fiscal_years[] e filing:
Os conceitos são nomeados como a taxonomia de reporte os nomeia (PropertyPlantAndEquipment, CxCTotalCuentasComercialesPorCobrarCorrientes), com o rótulo que o formulário imprime. Os valores chegam como reportados, os números em milhares de pesos.

Processos de insolvência

POST /co/supersociedades/insolvency-processes-search/v1 Dataset Quais empresas estão, ou estiveram, em reorganização ou liquidação, como reportaram.
Retorna as_of, total, total_is_exact, os campos de paginação e results[]:
Um processo é o que a própria empresa reportou em suas demonstrações financeiras; os autos da Superintendencia são a autoridade sobre sua etapa.

As 10.000 maiores

POST /co/supersociedades/largest-companies-search/v1 Dataset As maiores empresas do país a cada ano, incluindo as fiscalizadas fora da Supersociedades.
Retorna as_of, fiscal_year, total, total_is_exact, os campos de paginação e results[]:
Aqui os valores estão em trilhões de pesos, como a Superintendencia publica esta tabela, diferente dos relatórios, que estão em milhares.

Entidades sob supervisão

POST /co/supersociedades/supervised-entities-search/v1 Dataset A lista de supervisão a cada fim de ano: situação e onde notificar.
Retorna as_of, fiscal_year, total, total_is_exact, os campos de paginação e results[]:
A lista inclui as entidades supervisionadas tenham ou não reportado demonstrações naquele ano, então encontra empresas que as outras buscas da Supersociedades não encontram.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.