Datos para agentes

Reportes contables

Los siete reportes de la contabilidad de Olympus, los mismos que se ven y se exportan en la web, en JSON. Solo para claves de agente (una clave de integración recibe 403 agent_required) y solo si el negocio lleva su contabilidad en Olympus.

GET /reports/{nombre}

Los reportes

`nombre`	Reporte	Módulo · nivel	Parámetros
`trial-balance`	Balance de comprobación	`contabilidad.estados` · Ver	`desde`, `hasta`, `nivel`
`income-statement`	Estado de resultados	`contabilidad.estados` · Ver	`desde`, `hasta`, `nivel`
`balance-sheet`	Balance general	`contabilidad.estados` · Ver	`a_fecha` (obligatorio), `nivel`
`cash-flow`	Flujo de efectivo	`contabilidad.estados` · Ver	`desde`, `hasta`
`equity-changes`	Cambios en el patrimonio	`contabilidad.estados` · Ver	`desde`, `hasta`
`general-ledger`	Libro mayor	`contabilidad.libros` · Ver	`desde`, `hasta`, `cuenta`
`journal-book`	Libro diario	`contabilidad.libros` · Ver	`desde`, `hasta`

Un agente nunca pasa de Ver en contabilidad: los asientos y los cierres los hace una persona. La plantilla Analista lee los estados; para los libros, usa Contable (lectura). Ver Crear un agente.

Un nombre que no está en la tabla responde 404 not_found, con la lista de los disponibles en details.disponibles.

Parámetros

Parámetro	Formato	Qué hace
`desde`, `hasta`	`AAAA-MM-DD`	Periodo del reporte. Sin fechas, el mes en curso; solo con `hasta`, desde el día 1 de ese mes; solo con `desde`, hasta hoy. Como mucho 366 días
`a_fecha`	`AAAA-MM-DD`	Fecha de corte del balance general. Sin ella, `400` `validation_error`
`nivel`	Entero desde 1	Nivel de detalle del plan de cuentas. En el balance de comprobación, además, pasa la respuesta de lista de cuentas a informe agrupado
`cuenta`	Id de la cuenta	Libro mayor de una cuenta. Sin ella, el mayor de todas las cuentas con movimiento o saldo

El periodo efectivo es el que se calcula y el que devuelve meta.periodo, como en los KPIs.

Los reportes son siempre de todo el negocio: no admiten sucursal.

Ejemplo: balance general

curl "https://olympus.atharix.com/api/v1/reports/balance-sheet?a_fecha=2026-09-30" \
  -H "X-API-Key: $OLYMPUS_AGENT_KEY"

Respuesta (recortada):

{
  "meta": {
    "moneda": "USD",
    "sucursal": null,
    "generado_en": "2026-10-12T15:52:40.117385+00:00",
    "definiciones": "/api/v1/kpis",
    "periodo": { "desde": "2026-10-01", "hasta": "2026-10-12" },
    "datos_personales": "enmascarados"
  },
  "datos": {
    "as_of_date": "2026-09-30",
    "assets": [
      { "code": "1.1.01", "name": "Caja y bancos", "amount": 18450.0 },
      { "code": "1.1.02", "name": "Cuentas por cobrar clientes", "amount": 23620.75 },
      { "code": "1.2.01", "name": "Propiedad, planta y equipo", "amount": 12000.0 }
    ],
    "liabilities": [
      { "code": "2.1.01", "name": "Proveedores", "amount": 9840.5 },
      { "code": "2.1.07", "name": "IVA por pagar", "amount": 2310.25 }
    ],
    "equity": [
      { "code": "3.1.01", "name": "Capital social", "amount": 30000.0 },
      { "code": "_RE", "name": "Resultados del ejercicio", "amount": 11920.0 }
    ],
    "total_assets": 54070.75,
    "total_liabilities": 12150.75,
    "total_equity": 41920.0,
    "balanced": true
  }
}

balanced es true cuando el activo es igual al pasivo más el patrimonio (54.070,75 = 12.150,75 + 41.920,00). El balance general es a una fecha, así que aquí meta.periodo no aplica: la fecha de corte es as_of_date.

En equity-changes, los importes llegan como cadenas decimales con punto ("30000.00"), no como números.

Consumo

Los reportes cuentan para el tope diario de registros leídos del agente como los KPIs: cada elemento de las listas de la respuesta es un registro. Un libro diario de un año puede ser grande: pídelo por meses. Las respuestas se guardan 60 segundos por agente, permisos y parámetros.

Lo siguiente

KPIs: las cifras de gestión.
Permisos: por qué un agente no pasa de Ver en contabilidad.