Actualizar Estado de Orden de Trabajo

ACTUALIZAR ESTADO DE ORDEN DE TRABAJO

CABECERA

Endpoint para recibir cambios de estado de órdenes de trabajo desde Synergy. Permite sincronizar el estado de las órdenes entre ambos sistemas.

Endpoint: /api/orden_trabajo/estado

• PUT - Para actualizar el estado de una orden

Nota: Este endpoint solo documenta el flujo de RECEPCIÓN (Synergy → TitanicSoft).

---

CUERPO

JSON de Ejemplo (Payload)

{
    "synergy_id": "OT-2025-001234",
    "estado": "EN PROCESO"
}

---

Validaciones Detalladas

Campo	Tipo	Longitud	Descripción
synergy_id	String	1-20	ID único de la orden en Synergy
estado	String	máx 30	Nuevo estado de la orden. Valores permitidos: PENDIENTE, APROBADA, EN PROCESO, COMPLETADA, CANCELADA

Nota importante: El campo synergy_id acepta valores alfanuméricos.

Estados válidos:

• PENDIENTE - Orden pendiente de aprobación
• APROBADA - Orden aprobada, lista para ejecución
• EN PROCESO - Orden en proceso de ejecución
• COMPLETADA - Orden completada exitosamente
• CANCELADA - Orden cancelada

---

RESPUESTA EXITOSA

Código HTTP 200

{
    "codigo_http": 200,
    "estado": "success",
    "mensaje": "Estado actualizado exitosamente",
    "synergy_id": "OT-2025-001234",
    "estado_anterior": "PENDIENTE",
    "estado_nuevo": "EN PROCESO"
}

Código HTTP 200 (Idempotente - Estado Ya Actualizado)

{
    "codigo_http": 200,
    "estado": "success",
    "mensaje": "El estado ya está actualizado",
    "synergy_id": "OT-2025-001234",
    "estado_actual": "EN PROCESO"
}

---

POSIBLES ERRORES

1. Método HTTP No Permitido - Código 405

{
    "codigo_http": 405,
    "estado": "error",
    "mensaje": "Método no permitido. Se requiere PUT",
    "codigo_error": "METHOD_NOT_ALLOWED"
}

2. Orden No Encontrada - Código 404

{
    "codigo_http": 404,
    "estado": "not_found",
    "mensaje": "Orden no encontrada para synergy_id: OT-2025-001234",
    "synergy_id": "OT-2025-001234"
}

3. Error de Validación - Código 400

Escenario: Campos requeridos faltantes o formato incorrecto

{
    "codigo_http": 400,
    "estado": "validation_error",
    "mensaje": "Error en la validación",
    "detalles": {
        "estado": "El campo estado es requerido"
    }
}

---

4. Estado Inválido - Código 400

Escenario: El estado enviado no está en la lista de estados válidos

{
    "codigo_http": 400,
    "estado": "validation_error",
    "mensaje": "Estado inválido, no existe en la lista de estados válidos"
}