Ir directamente al contenido
Español
Más asistencia técnica
Ponte en contacto
  • No hay sugerencias porque el campo de búsqueda está vacío.

📉 Eliminar valores KPI con Postman (Ejemplo: Fallos de máquina el 19/10/2025)

Este artículo proporciona una guía paso a paso sobre cómo eliminar valores específicos de KPIs en ValueStreamer utilizando Postman. El ejemplo muestra cómo eliminar un valor de KPI registrado por error en un domingo no laborable.

🔍 Contenido

  • Requisitos
  • Consultar todos los KPIs mediante API
  • Ver detalles del KPI
  • Identificar el ID del equipo
  • Eliminar un valor específico
  • Eliminar valores de sub-KPIs
  • Consejos y buenas prácticas
  • Preguntas frecuentes (FAQ)

Requisitos

ℹ️ Nota: Si no tiene credenciales de API, póngase en contacto con el soporte a través del Help Desk.

1. Consultar todos los KPIs mediante API

GET https://api-Tenant.valuestreamer.de/api/exchange/kpi/

📸 Captura: Solicitud GET para listar todos los KPIs con autenticación básica

Ejemplo de respuesta JSON:

[
    {
        "id": "87fa7b38-44e8-4465-b5b7-e6b17489205c",
        "name": "OEE ZACN"
    },
    {
        "id": "888fa6ec-4f58-4518-8568-a0b33aa1d84c",
        "name": "Machine failure > 2 h"
    },
    {
        "id": "90b1ba3e-4877-4e14-a87a-63362e3664f9",
        "name": "Rework [h]"
    }
 }
]

2. Ver detalles del KPI

GET https://api-Tenant.valuestreamer.de/api/exchange/kpi/888fa6ec-4f58-4518-8568-a0b33aa1d84c

La respuesta muestra todos los equipos asociados y más detalles del KPI.

📸 Captura: Vista detallada del KPI en Postman

3. Identificar el ID del equipo

Fragmento de ejemplo:

 
        {
            "id": "fa9089f3-2bef-4750-8226-40a8ca12b7cd",
            "name": "S_Endmontage",
            "subTileRecording": false
        }

Este ID se necesita para la solicitud DELETE.

4. Eliminar un valor específico

Para eliminar un valor de KPI, use la siguiente URL:

 
https://api-tenant.valuestreamer.de/api/exchange/kpi-data/{fecha}/{id-equipo}/{id-kpi}

Donde:

  • {fecha}: Formato YYYY-MM-DD (por ejemplo, 2025-10-19 para un KPI diario)

  • {id-equipo}: ID del equipo (por ejemplo, fa9089f3-2bef-4750-8226-40a8ca12b7cd)

  • {id-kpi}: ID del KPI (por ejemplo, 888fa6ec-4f58-4518-8568-a0b33aa1d84c)

Ejemplo:

 
https://api-tenant.valuestreamer.de/api/exchange/kpi-data/2025-10-19/fa9089f3-2bef-4750-8226-40a8ca12b7cd/888fa6ec-4f58-4518-8568-a0b33aa1d84c

📸 Captura: Solicitud DELETE enviada desde Postman

✅ Si la operación es exitosa, se devuelve un 200 OK y el valor queda eliminado.

⚠️ Atención: Esta acción no se puede deshacer. Verifique cuidadosamente los IDs y la fecha.

5. Eliminar valores de sub-KPIs

Si el KPI tiene subtiles activadas (por ejemplo, turnos: mañana/tarde/noche), se requiere un ID de subtile adicional. La URL para eliminar se extiende:

 
https://api-tenant.valuestreamer.de/api/exchange/kpi-data/{fecha}/{id-equipo}/{id-kpi}/{id-subtile}

El {id-subtile} también se obtiene en la respuesta detallada del KPI:

        {
            "id": "ace4b82a-d233-4610-8781-7df6bc9dc072",
            "name": "D_Pre-Assembly",
            "subTileRecording": true,
            "subTiles": [
                {
                    "id": "77d03d83-3519-43dc-b995-9a68e297d88e",
                    "name": "Early",
                    "team": "ace4b82a-d233-4610-8781-7df6bc9dc072",
                    "orderId": 1
                },
                {
                    "id": "e896db9d-fdd0-4fb4-b07d-f97668caa811",
                    "name": "Late",
                    "team": "ace4b82a-d233-4610-8781-7df6bc9dc072",
                    "orderId": 2
                },
                {
                    "id": "ee5dbd67-e368-4ab5-bd1e-b109e94b53f9",
                    "name": "Night",
                    "team": "ace4b82a-d233-4610-8781-7df6bc9dc072",
                    "orderId": 3
                }
            ]
        },

✨ Consejo: Solo utilice Sub-Tile-IDs cuando subTileRecording sea true.

✨ Consejos & Buenas Prácticas

  • Siempre use GET primero para comprobar si existen datos

  • Las solicitudes DELETE deben tener fecha, ID de equipo y KPI bien definidos

  • Documente los cambios para trazabilidad

❓ FAQ

¿Cómo encuentro el ID del KPI correcto? Utilice GET /api/exchange/kpi/ para obtener todos los KPIs con sus nombres e IDs.

¿Puedo usar otras herramientas para eliminar valores KPI? Sí, por ejemplo Power Automate o scripts propios vía REST API. Postman es ideal para pruebas rápidas y tareas manuales.

¿Cuál es el formato de fecha correcto para la eliminación?

  • KPIs diarios: YYYY-MM-DD

  • KPIs semanales: Lunes de la semana correspondiente (YYYY-MM-DD)

  • KPIs mensuales: Primer día del mes (YYYY-MM-01)

¿Puedo eliminar por error todos los valores de un KPI? Solo si envía múltiples solicitudes DELETE para diferentes fechas. Use siempre fechas específicas en la URL.