# Analítica Empresarial — Colombia

> Plataforma de análisis financiero empresarial con datos de Supersociedades (SIIS)
> y Superintendencia Financiera de Colombia (SFC/XBRL).

## ¿Qué datos encontrarás aquí?

- **Estados financieros** (NIIF Plenas y PYMES): Balance general, Estado de Resultados,
  Flujo de Efectivo — histórico 2014–2023 para +80.000 empresas colombianas.
- **Indicadores financieros** calculados: 30+ ratios de liquidez, solvencia, rentabilidad
  y eficiencia por empresa y año.
- **Benchmark sectorial**: estadísticos P25/P50/P75 por clase, división y sección CIIU.
- **Entidades SFC**: 5 estados financieros XBRL/IFRS + 15 ratios para entidades vigiladas
  por la Superintendencia Financiera.

## Endpoints para agentes IA

Todos los endpoints devuelven datos listos para análisis. No requieren API key.

### Exportación por empresa (SIIS)
`GET https://www.analiticaempresarial.info/api/export/empresa/{nit}?format=md|json|xlsx`

Ejemplo:
`GET https://www.analiticaempresarial.info/api/export/empresa/890900943?format=md`

Devuelve: perfil corporativo, estados financieros 5 años, 30 indicadores,
benchmark sectorial en Markdown (ideal para pegar en Claude / ChatGPT).

### Exportación entidad SFC
`GET https://www.analiticaempresarial.info/api/export/sfc/{nit}?format=md|json|xlsx`

Ejemplo:
`GET https://www.analiticaempresarial.info/api/export/sfc/860007538?format=md`

Devuelve: estados XBRL/IFRS + 15 ratios SFC.

### Exportación benchmark sectorial
`GET https://www.analiticaempresarial.info/api/export/benchmark/{nit}?format=md|json|xlsx`

Devuelve: KPIs de la empresa + peer stats P25/P50/P75 + ranking top 30 de su clase CIIU.

## API pública versionada (v1)

Para integraciones programáticas (pandas, n8n, scripts, MCP servers) usa la
API REST versionada. Devuelve JSON estructurado con shape `{ data, meta }` y
errores RFC 7807. Rate limit: 60 req/min por IP (30 req/min en endpoints
costosos: `/sfc`, `/screener`).

- **Documentación interactiva (Scalar UI)**: https://www.analiticaempresarial.info/api/docs
- **Spec OpenAPI 3.1**: https://www.analiticaempresarial.info/api/v1/openapi.json
- **Root info**: https://www.analiticaempresarial.info/api/v1

### Endpoints v1

| Endpoint | Descripción |
| :--- | :--- |
| `GET /api/v1/empresa/{nit}` | Bundle SIIS (perfil + estados + indicadores + benchmark opcional) |
| `GET /api/v1/empresa/{nit}/financials` | Estados financieros NIIF (ER, ESF, EFE) |
| `GET /api/v1/empresa/{nit}/indicators` | 20 indicadores (liquidez/eficiencia/endeudamiento/rentabilidad) |
| `GET /api/v1/empresa/{nit}/benchmark` | Peer stats CIIU + ranking top-N |
| `GET /api/v1/sfc/{nit}` | Bundle SFC XBRL IFRS (profile, filings, statements, ratios, notes) |
| `GET /api/v1/screener` | Listado paginado y filtrable de empresas |
| `GET /api/v1/search?q=...` | Búsqueda unificada SIIS + SFC |

Ejemplos:
- `GET https://www.analiticaempresarial.info/api/v1/empresa/890900943?include=profile,financials,indicators,benchmark`
- `GET https://www.analiticaempresarial.info/api/v1/screener?seccion=F&sort=ingresos_operacionales&order=desc&page_size=20`
- `GET https://www.analiticaempresarial.info/api/v1/search?q=bancolombia&source=sfc`

## Formatos disponibles

| Formato | Content-Type | Uso recomendado |
| :--- | :--- | :--- |
| `md` | text/markdown | Pegar en Claude, ChatGPT, Gemini |
| `json` | application/json | pandas, scripts, integraciones |
| `xlsx` | application/vnd.openxmlformats... | Excel / LibreOffice |

## Páginas principales

- https://www.analiticaempresarial.info/analisis/screener — Screener de empresas con filtros CIIU, tamaño, indicadores
- https://www.analiticaempresarial.info/empresa/{nit} — Perfil financiero de empresa SIIS
- https://www.analiticaempresarial.info/superfinanciera/{nit} — Perfil entidad SFC
- https://www.analiticaempresarial.info/analisis/benchmark — Benchmark sectorial CIIU

## Cobertura de datos

- **SIIS (Supersociedades)**: +80.000 empresas · años 2014–2023 · NIIF Plenas y PYMES
- **SFC (Superfinanciera)**: entidades financieras vigiladas · XBRL/IFRS · 2015–2023
- **Sectores CIIU**: clasificación de 4 dígitos con estadísticos sectoriales

## Notas para modelos de lenguaje

1. Los valores monetarios en JSON están en **pesos colombianos (COP) en unidades**.
2. En Markdown se presentan en **millones de COP** para legibilidad.
3. Los porcentajes de indicadores ya están en escala ×100 (p. ej. ROA = 5.2 significa 5.2%).
4. El campo `$schema` en los JSON apunta a la especificación de cada tipo de export.
5. Los datos provienen de reportes oficiales; pueden existir empresas con periodos parciales.

## Contacto y fuente oficial

- Datos SIIS: https://siis.supersociedades.gov.co
- Datos SFC: https://www.superfinanciera.gov.co/inicio/informes-y-cifras/cifras/60950
- Plataforma: https://www.analiticaempresarial.info