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.
É 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
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.