Skip to main content
GET
/
api
/
dashboard
/
orden
/
:id
curl -X GET https://api.prod-sys.com/api/dashboard/orden/1023 \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "orden_produccion": {
    "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\",\"tipo_tejido\":\"circular\"}",
    "motivo_cierre": null
  },
  "lineas_ejecucion": [
    {
      "id": 45,
      "estado": "ACTIVA",
      "orden_produccion_id": 1023,
      "proceso_id": 1,
      "maquina_id": 3,
      "fecha_inicio": "2026-03-06T06:00:00.000Z",
      "fecha_fin": null,
      "registros_trabajo": [
        {
          "id": 892,
          "cantidad_producida": 450.5,
          "merma_kg": 12.3,
          "parametros": "{\"velocidad\":\"180rpm\",\"tension\":\"45N\",\"temperatura\":\"22C\"}",
          "observaciones": "Producción normal, sin incidencias",
          "fecha_hora": "2026-03-06T06:00:00.000Z",
          "linea_ejecucion_id": 45,
          "bitacora_id": 12,
          "maquina_id": 3,
          "estado": "completado",
          "usuario_modificacion": "jperez",
          "fecha_modificacion": "2026-03-06T14:05:00.000Z",
          "created_at": "2026-03-06T06:00:00.000Z"
        },
        {
          "id": 893,
          "cantidad_producida": 520.0,
          "merma_kg": 8.7,
          "parametros": "{\"velocidad\":\"180rpm\",\"tension\":\"45N\",\"temperatura\":\"23C\"}",
          "observaciones": "Rendimiento óptimo en turno matutino",
          "fecha_hora": "2026-03-06T14:00:00.000Z",
          "linea_ejecucion_id": 45,
          "bitacora_id": 13,
          "maquina_id": 3,
          "estado": "completado",
          "usuario_modificacion": "mrodriguez",
          "fecha_modificacion": "2026-03-06T22:10:00.000Z",
          "created_at": "2026-03-06T14:00:00.000Z"
        }
      ]
    },
    {
      "id": 52,
      "estado": "ACTIVA",
      "orden_produccion_id": 1023,
      "proceso_id": 4,
      "maquina_id": 18,
      "fecha_inicio": "2026-03-06T07:00:00.000Z",
      "fecha_fin": null,
      "registros_trabajo": [
        {
          "id": 901,
          "cantidad_producida": 3250,
          "merma_kg": 45.2,
          "parametros": "{\"velocidad_corte\":\"85/min\",\"temperatura_sellado\":\"180C\"}",
          "observaciones": "Conversión de rollos a sacos terminados",
          "fecha_hora": "2026-03-06T07:00:00.000Z",
          "linea_ejecucion_id": 52,
          "bitacora_id": 12,
          "maquina_id": 18,
          "estado": "completado",
          "usuario_modificacion": "agarcia",
          "fecha_modificacion": "2026-03-06T14:30:00.000Z",
          "created_at": "2026-03-06T07:00:00.000Z"
        }
      ]
    }
  ],
  "lotes_produccion": [
    {
      "id": 567,
      "codigo_lote": "LOTE-ORD2026-1023-001",
      "codigo_orden": "ORD-2026-1023",
      "orden_produccion_id": 1023,
      "bitacora_id": 12,
      "correlativo": 1,
      "fecha_produccion": "2026-03-06",
      "estado": "activo",
      "comentario_estado": null,
      "created_at": "2026-03-06T06:15:00.000Z",
      "created_by": "jperez",
      "updated_at": "2026-03-06T06:15:00.000Z",
      "updated_by": null,
      "motivo_cambio": null,
      "muestras_calidad": [
        {
          "id": 234,
          "codigo_muestra": "M-LOTE567-001",
          "fecha_analisis": "2026-03-06",
          "lote_id": 567,
          "bitacora_id": 12,
          "proceso_id": 1,
          "maquina_id": 3,
          "resultado": "Aprobado",
          "valor": 64.8,
          "parametro": "gramaje",
          "valor_nominal": 65.0,
          "usuario_modificacion": "lcalidad",
          "fecha_modificacion": "2026-03-06T10:30:00.000Z",
          "parametros": null,
          "created_at": "2026-03-06T10:30:00.000Z"
        },
        {
          "id": 235,
          "codigo_muestra": "M-LOTE567-002",
          "fecha_analisis": "2026-03-06",
          "lote_id": 567,
          "bitacora_id": 12,
          "proceso_id": 1,
          "maquina_id": 3,
          "resultado": "Aprobado",
          "valor": 28.5,
          "parametro": "resistencia_traccion",
          "valor_nominal": 28.0,
          "usuario_modificacion": "lcalidad",
          "fecha_modificacion": "2026-03-06T10:35:00.000Z",
          "parametros": "{\"metodo\":\"ASTM-D5034\",\"direccion\":\"longitudinal\"}",
          "created_at": "2026-03-06T10:35:00.000Z"
        }
      ]
    },
    {
      "id": 568,
      "codigo_lote": "LOTE-ORD2026-1023-002",
      "codigo_orden": "ORD-2026-1023",
      "orden_produccion_id": 1023,
      "bitacora_id": 13,
      "correlativo": 2,
      "fecha_produccion": "2026-03-06",
      "estado": "activo",
      "comentario_estado": null,
      "created_at": "2026-03-06T14:20:00.000Z",
      "created_by": "mrodriguez",
      "updated_at": "2026-03-06T14:20:00.000Z",
      "updated_by": null,
      "motivo_cambio": null,
      "muestras_calidad": [
        {
          "id": 236,
          "codigo_muestra": "M-LOTE568-001",
          "fecha_analisis": "2026-03-06",
          "lote_id": 568,
          "bitacora_id": 13,
          "proceso_id": 1,
          "maquina_id": 3,
          "resultado": "Aprobado",
          "valor": 65.2,
          "parametro": "gramaje",
          "valor_nominal": 65.0,
          "usuario_modificacion": "lcalidad",
          "fecha_modificacion": "2026-03-06T18:45:00.000Z",
          "parametros": null,
          "created_at": "2026-03-06T18:45:00.000Z"
        }
      ]
    }
  ]
}
Provides a complete operational view of a production order with all associated execution data, traceability information, and quality control metrics. This endpoint returns deeply nested data structures that map the entire production chain for a specific order.

Path Parameters

id
integer
required
The unique identifier of the production order

Response

Returns a 404 error if the order is not found.
orden_produccion
object
required
Complete production order details
lineas_ejecucion
array
required
Array of execution lines representing work performed for this order across different processes and machines
lotes_produccion
array
required
Array of production batches (lotes) created for this order, providing complete traceability
curl -X GET https://api.prod-sys.com/api/dashboard/orden/1023 \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "orden_produccion": {
    "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\",\"tipo_tejido\":\"circular\"}",
    "motivo_cierre": null
  },
  "lineas_ejecucion": [
    {
      "id": 45,
      "estado": "ACTIVA",
      "orden_produccion_id": 1023,
      "proceso_id": 1,
      "maquina_id": 3,
      "fecha_inicio": "2026-03-06T06:00:00.000Z",
      "fecha_fin": null,
      "registros_trabajo": [
        {
          "id": 892,
          "cantidad_producida": 450.5,
          "merma_kg": 12.3,
          "parametros": "{\"velocidad\":\"180rpm\",\"tension\":\"45N\",\"temperatura\":\"22C\"}",
          "observaciones": "Producción normal, sin incidencias",
          "fecha_hora": "2026-03-06T06:00:00.000Z",
          "linea_ejecucion_id": 45,
          "bitacora_id": 12,
          "maquina_id": 3,
          "estado": "completado",
          "usuario_modificacion": "jperez",
          "fecha_modificacion": "2026-03-06T14:05:00.000Z",
          "created_at": "2026-03-06T06:00:00.000Z"
        },
        {
          "id": 893,
          "cantidad_producida": 520.0,
          "merma_kg": 8.7,
          "parametros": "{\"velocidad\":\"180rpm\",\"tension\":\"45N\",\"temperatura\":\"23C\"}",
          "observaciones": "Rendimiento óptimo en turno matutino",
          "fecha_hora": "2026-03-06T14:00:00.000Z",
          "linea_ejecucion_id": 45,
          "bitacora_id": 13,
          "maquina_id": 3,
          "estado": "completado",
          "usuario_modificacion": "mrodriguez",
          "fecha_modificacion": "2026-03-06T22:10:00.000Z",
          "created_at": "2026-03-06T14:00:00.000Z"
        }
      ]
    },
    {
      "id": 52,
      "estado": "ACTIVA",
      "orden_produccion_id": 1023,
      "proceso_id": 4,
      "maquina_id": 18,
      "fecha_inicio": "2026-03-06T07:00:00.000Z",
      "fecha_fin": null,
      "registros_trabajo": [
        {
          "id": 901,
          "cantidad_producida": 3250,
          "merma_kg": 45.2,
          "parametros": "{\"velocidad_corte\":\"85/min\",\"temperatura_sellado\":\"180C\"}",
          "observaciones": "Conversión de rollos a sacos terminados",
          "fecha_hora": "2026-03-06T07:00:00.000Z",
          "linea_ejecucion_id": 52,
          "bitacora_id": 12,
          "maquina_id": 18,
          "estado": "completado",
          "usuario_modificacion": "agarcia",
          "fecha_modificacion": "2026-03-06T14:30:00.000Z",
          "created_at": "2026-03-06T07:00:00.000Z"
        }
      ]
    }
  ],
  "lotes_produccion": [
    {
      "id": 567,
      "codigo_lote": "LOTE-ORD2026-1023-001",
      "codigo_orden": "ORD-2026-1023",
      "orden_produccion_id": 1023,
      "bitacora_id": 12,
      "correlativo": 1,
      "fecha_produccion": "2026-03-06",
      "estado": "activo",
      "comentario_estado": null,
      "created_at": "2026-03-06T06:15:00.000Z",
      "created_by": "jperez",
      "updated_at": "2026-03-06T06:15:00.000Z",
      "updated_by": null,
      "motivo_cambio": null,
      "muestras_calidad": [
        {
          "id": 234,
          "codigo_muestra": "M-LOTE567-001",
          "fecha_analisis": "2026-03-06",
          "lote_id": 567,
          "bitacora_id": 12,
          "proceso_id": 1,
          "maquina_id": 3,
          "resultado": "Aprobado",
          "valor": 64.8,
          "parametro": "gramaje",
          "valor_nominal": 65.0,
          "usuario_modificacion": "lcalidad",
          "fecha_modificacion": "2026-03-06T10:30:00.000Z",
          "parametros": null,
          "created_at": "2026-03-06T10:30:00.000Z"
        },
        {
          "id": 235,
          "codigo_muestra": "M-LOTE567-002",
          "fecha_analisis": "2026-03-06",
          "lote_id": 567,
          "bitacora_id": 12,
          "proceso_id": 1,
          "maquina_id": 3,
          "resultado": "Aprobado",
          "valor": 28.5,
          "parametro": "resistencia_traccion",
          "valor_nominal": 28.0,
          "usuario_modificacion": "lcalidad",
          "fecha_modificacion": "2026-03-06T10:35:00.000Z",
          "parametros": "{\"metodo\":\"ASTM-D5034\",\"direccion\":\"longitudinal\"}",
          "created_at": "2026-03-06T10:35:00.000Z"
        }
      ]
    },
    {
      "id": 568,
      "codigo_lote": "LOTE-ORD2026-1023-002",
      "codigo_orden": "ORD-2026-1023",
      "orden_produccion_id": 1023,
      "bitacora_id": 13,
      "correlativo": 2,
      "fecha_produccion": "2026-03-06",
      "estado": "activo",
      "comentario_estado": null,
      "created_at": "2026-03-06T14:20:00.000Z",
      "created_by": "mrodriguez",
      "updated_at": "2026-03-06T14:20:00.000Z",
      "updated_by": null,
      "motivo_cambio": null,
      "muestras_calidad": [
        {
          "id": 236,
          "codigo_muestra": "M-LOTE568-001",
          "fecha_analisis": "2026-03-06",
          "lote_id": 568,
          "bitacora_id": 13,
          "proceso_id": 1,
          "maquina_id": 3,
          "resultado": "Aprobado",
          "valor": 65.2,
          "parametro": "gramaje",
          "valor_nominal": 65.0,
          "usuario_modificacion": "lcalidad",
          "fecha_modificacion": "2026-03-06T18:45:00.000Z",
          "parametros": null,
          "created_at": "2026-03-06T18:45:00.000Z"
        }
      ]
    }
  ]
}

Use Cases

Production Monitoring

Track real-time progress of a specific order across all manufacturing processes. The nested structure provides visibility into:
  • Which machines are working on the order
  • Production output per shift and machine
  • Waste/scrap levels
  • Quality control results

Traceability

Complete batch-level traceability linking:
  • Production order → Execution lines → Work records → Batches → Quality samples
  • All records include timestamps, operators, and shift information
  • Parametros fields contain process conditions for each production run

Quality Analysis

Analyze quality metrics for an order:
  • Compare measured values against nominal specifications
  • Identify which batches passed or failed quality checks
  • Track quality inspector activities and test results
  • Correlate quality issues with specific machines or shifts

Progress Calculation

Calculate order completion percentage by:
  1. Sum all cantidad_producida from work records across execution lines
  2. Compare against orden_produccion.cantidad_objetivo
  3. Account for waste using merma_kg values

KPI Reporting

Extract metrics such as:
  • Production efficiency (actual vs target)
  • Waste percentage
  • Quality pass rate
  • Cycle time per process
  • Machine utilization

Data Completeness

This endpoint performs eager loading of related data:
  • All execution lines for the order
  • All work records for each execution line
  • All batches created for the order
  • All quality samples for each batch
The response can be large for orders with extensive production history. Consider:
  • Caching responses for completed orders
  • Paginating work records if implementation changes in the future
  • Using filters if only specific process data is needed

Error Responses

404 Not Found
Returned when the specified order ID does not exist in the system
{
  "error": "Orden no encontrada"
}

Build docs developers (and LLMs) love