Skip to main content
GET
/
api
/
dashboard
/
summary
curl -X GET https://api.prod-sys.com/api/dashboard/summary \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "ordenesActivas": 12,
  "lineasEjecucion": 8,
  "registrosAbiertos": 47,
  "incidentesActivos": 3,
  "produccionDia": 15650.5,
  "recentOrders": [
    {
      "id": 1023,
      "codigo_orden": "ORD-2026-1023",
      "producto": "Saco de polipropileno 50kg",
      "cantidad_objetivo": 10000,
      "unidad": "Unidades",
      "fecha_planificada": "2026-03-06",
      "prioridad": "Alta",
      "observaciones": "Pedido urgente - cliente prioritario",
      "estado": "En producción",
      "fecha_creacion": "2026-03-05",
      "especificaciones": "{\"color\":\"blanco\",\"gramaje\":65,\"dimensiones\":\"60x90cm\"}",
      "motivo_cierre": null
    },
    {
      "id": 1022,
      "codigo_orden": "ORD-2026-1022",
      "producto": "Bobina laminada 1500m",
      "cantidad_objetivo": 2500,
      "unidad": "metros",
      "fecha_planificada": "2026-03-06",
      "prioridad": "Media",
      "observaciones": "",
      "estado": "Liberada",
      "fecha_creacion": "2026-03-04",
      "especificaciones": null,
      "motivo_cierre": null
    }
  ],
  "criticalIncidents": [
    {
      "id": 87,
      "titulo": "Telar T-03 produce tejido con defectos",
      "descripcion": "Se detectan irregularidades en el tejido cada 2 metros aproximadamente",
      "severidad": "alta",
      "estado": "abierto",
      "linea_ejecucion_id": 45,
      "maquina_id": 3,
      "bitacora_id": 12,
      "fecha_creacion": "2026-03-06T08:30:00.000Z",
      "fecha_cierre": null,
      "accion_correctiva": null
    },
    {
      "id": 85,
      "titulo": "Rotura de hilo en máquina de conversión",
      "descripcion": "Hilo de costura se rompe frecuentemente durante producción",
      "severidad": "alta",
      "estado": "abierto",
      "linea_ejecucion_id": 52,
      "maquina_id": 18,
      "bitacora_id": 12,
      "fecha_creacion": "2026-03-06T07:15:00.000Z",
      "fecha_cierre": null,
      "accion_correctiva": null
    }
  ]
}
Provides a high-level overview of the production system status with key performance indicators and recent activity. This endpoint aggregates data from multiple domains to give operators and managers a comprehensive view of current operations.

​
Response

​
ordenesActivas
integer
required
Number of production orders currently in active states (Liberada, En producción, or Pausada)
​
lineasEjecucion
integer
required
Count of active execution lines currently running
​
registrosAbiertos
integer
required
Number of completed work records in the system
​
incidentesActivos
integer
required
Count of incidents currently in open state
​
produccionDia
number
required
Total production quantity for the current day (sum of cantidad_producida from today’s work records)
​
recentOrders
array
required
Array of the 5 most recent active production orders
​
criticalIncidents
array
required
Array of the 5 most recent high-severity open incidents
curl -X GET https://api.prod-sys.com/api/dashboard/summary \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "ordenesActivas": 12,
  "lineasEjecucion": 8,
  "registrosAbiertos": 47,
  "incidentesActivos": 3,
  "produccionDia": 15650.5,
  "recentOrders": [
    {
      "id": 1023,
      "codigo_orden": "ORD-2026-1023",
      "producto": "Saco de polipropileno 50kg",
      "cantidad_objetivo": 10000,
      "unidad": "Unidades",
      "fecha_planificada": "2026-03-06",
      "prioridad": "Alta",
      "observaciones": "Pedido urgente - cliente prioritario",
      "estado": "En producción",
      "fecha_creacion": "2026-03-05",
      "especificaciones": "{\"color\":\"blanco\",\"gramaje\":65,\"dimensiones\":\"60x90cm\"}",
      "motivo_cierre": null
    },
    {
      "id": 1022,
      "codigo_orden": "ORD-2026-1022",
      "producto": "Bobina laminada 1500m",
      "cantidad_objetivo": 2500,
      "unidad": "metros",
      "fecha_planificada": "2026-03-06",
      "prioridad": "Media",
      "observaciones": "",
      "estado": "Liberada",
      "fecha_creacion": "2026-03-04",
      "especificaciones": null,
      "motivo_cierre": null
    }
  ],
  "criticalIncidents": [
    {
      "id": 87,
      "titulo": "Telar T-03 produce tejido con defectos",
      "descripcion": "Se detectan irregularidades en el tejido cada 2 metros aproximadamente",
      "severidad": "alta",
      "estado": "abierto",
      "linea_ejecucion_id": 45,
      "maquina_id": 3,
      "bitacora_id": 12,
      "fecha_creacion": "2026-03-06T08:30:00.000Z",
      "fecha_cierre": null,
      "accion_correctiva": null
    },
    {
      "id": 85,
      "titulo": "Rotura de hilo en máquina de conversión",
      "descripcion": "Hilo de costura se rompe frecuentemente durante producción",
      "severidad": "alta",
      "estado": "abierto",
      "linea_ejecucion_id": 52,
      "maquina_id": 18,
      "bitacora_id": 12,
      "fecha_creacion": "2026-03-06T07:15:00.000Z",
      "fecha_cierre": null,
      "accion_correctiva": null
    }
  ]
}

​
Use Cases

​
Real-time Monitoring

This endpoint is ideal for dashboard displays that need to show current production status at a glance. It provides the essential KPIs that operations managers need to assess system health.

​
Shift Handover

During shift transitions, supervisors can use this endpoint to quickly brief incoming staff on:
  • Current active production load
  • Any critical issues requiring immediate attention
  • Production progress for the day

​
Mobile Applications

The compact response structure makes this endpoint perfect for mobile apps where network bandwidth is limited but comprehensive status is needed.

​
Data Sources

This endpoint aggregates information from multiple database tables:
  • orden_produccion: Active orders count and recent order details
  • lineas_ejecucion: Active execution lines count
  • registros_trabajo: Completed work records count and daily production totals
  • incidentes: Active incidents count and critical incident details
  • bitacora_turno: Associated shift logs for context

​
Performance Considerations

The summary endpoint is optimized for frequent polling:
  • All queries use indexed fields (estado, fecha_creacion)
  • Result sets are limited (5 recent orders, 5 critical incidents)
  • Aggregations use efficient COUNT and SUM operations
  • Response typically returns in under 100ms

Build docs developers (and LLMs) love

Get started for freeTalk to us