Informe

Una tabla en PDF con las columnas, filas y totales que usted declare, vertical u horizontal, que pagina sola.

informe, con el diseño premium: una tabla con las columnas que usted declare. Sirve para sacar en PDF lo que su aplicación ya enseña en pantalla —un consolidado por sucursal, la lista de operaciones de un periodo— sin que aquí haya que saber nada de su negocio.

"informe": {
  "titulo": "Consolidado por sucursal",
  "subtitulo": "Operaciones completadas",
  "alcance": "Todas las sucursales",
  "periodo": { "desde": "2026-09-01", "hasta": "2026-09-15" },
  "generadoEn": "2026-09-15T14:30:00-05:00",
  "generadoPor": "Andrés Montoya",
  "orientacion": "vertical"
},
"columnas": [
  { "clave": "grupo", "titulo": "Sucursal", "alineacion": "izquierda", "formato": "texto" },
  { "clave": "operaciones", "titulo": "Operaciones", "alineacion": "derecha", "formato": "numero" },
  { "clave": "totalCop", "titulo": "Total", "alineacion": "derecha", "formato": "moneda" }
],
"filas": [ { "grupo": "Aeropuerto", "operaciones": 12, "totalCop": 45000000 } ],
"totales": { "grupo": "Total", "operaciones": 20, "totalCop": 71000000 },
"moneda": "COP",
"notas": ""

• Obligatorios: informe.titulo, columnas (una lista con al menos una columna) y filas (una lista, que puede ir vacía: entonces la tabla dice «Sin registros»). Si falta alguno, la respuesta es un 400 con faltan, y no se compone nada.
• Cada columna toma de cada fila el valor de su clave. alineacion es izquierda —la de defecto—, derecha o centro. ancho, opcional, es un peso relativo: una columna con "ancho": 2 mide el doble que una con 1. Sin él, el texto pesa más que las cifras.
• formato solo da forma, nunca calcula:
  • texto —el de defecto—: tal como llega.
  • numero: miles con punto y hasta dos decimales (1.200,75).
  • moneda: con el símbolo de moneda ($ 45.000.000, US$ 1.500,25); los decimales solo si la cifra los tiene.
  • fecha: una fecha ISO sale como 15/09/2026, y con hora si la trae (15/09/2026 14:30, la hora escrita, sin cambiarla de zona). Lo que no sea ISO sale como llega.
  • porcentaje: el número ya hecho, con % (12,5 sale 12,5 %; no se multiplica por cien).
  • Un valor que ya viene como texto sale igual en cualquier formato, y uno que no llega deja la celda vacía.
• totales se pinta como llega, en una fila al final, columna por columna según las mismas claves. No es la suma de las filas, y sin totales no hay fila.
• orientacion: vertical —la de defecto— o horizontal, la A4 apaisada, para listas de muchas columnas. Con siete columnas o más, la letra y el aire de las filas bajan un poco.
• Pagina. Una lista de miles de filas sigue en las hojas que haga falta, y en cada una se repiten la cabecera de la tabla, una línea con el título, el alcance y el periodo, y «Página x de y».
• Lo opcional que no llega —subtítulo, alcance, periodo, quién y cuándo, notas— no ocupa renglón.
• El archivo se llama Informe_<titulo>_<periodo.desde>.pdf, sin tildes ni espacios (Informe_Consolidado-por-sucursal_2026-09-01.pdf), con sin-fecha si no llega el periodo.

Ejemplos: informe.json (vertical) y informe-horizontal.json.