Anular Orden de Trabajo

ANULAR ORDEN DE TRABAJO

CABECERA

Endpoint para recibir anulaciones de órdenes de trabajo desde Synergy. Permite anular órdenes previamente registradas. El endpoint es idempotente: si la orden ya está anulada, retorna éxito.

Endpoint: /api/orden_trabajo/anular/{synergy_id}

• DELETE - Para anular una orden existente

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

---

URL DEL ENDPOINT

Parámetros de URL

Parámetro	Tipo	Longitud	Descripción
synergy_id	String	1-20	ID único de la orden en Synergy

Ejemplo de URL completa:

DELETE /api/orden_trabajo/anular/OT-2025-001234

---

RESPUESTA EXITOSA

Código HTTP 200

{
    "codigo_http": 200,
    "estado": "success",
    "mensaje": "Orden anulada exitosamente",
    "synergy_id": "OT-2025-001234",
    "numero_orden": "ORD-00001234"
}

Código HTTP 200 (Idempotente - Ya Anulada)

{
    "codigo_http": 200,
    "estado": "success",
    "mensaje": "La orden ya está anulada",
    "synergy_id": "OT-2025-001234",
    "estado_actual": "ANULADA"
}

---

POSIBLES ERRORES

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

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

2. Orden No Encontrada - Código 404

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

3. Error Interno - Código 500

{
    "codigo_http": 500,
    "estado": "error",
    "mensaje": "Error al anular la orden",
    "codigo_error": "ERROR_INTERNO"
}