Anular Gasto Conductor

ANULAR GASTO CONDUCTOR

CABECERA

Endpoint para recibir anulaciones de gastos de conductor desde Synergy. Permite eliminar gastos operativos previamente registrados. El endpoint elimina físicamente el registro de la base de datos.

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

• DELETE - Para anular un gasto de conductor existente

---

URL DEL ENDPOINT

DELETE /api/gasto_conductor/anular/{synergy_id}

Parámetros de URL

Parámetro	Tipo	Descripción
synergy_id	String	ID único del gasto en Synergy

Ejemplo:

DELETE /api/gasto_conductor/anular/GC-2025-001234

---

RESPUESTA EXITOSA

Código HTTP 200

{
    "codigo_http": 200,
    "estado": "success",
    "mensaje": "Gasto de conductor anulado exitosamente",
    "synergy_id": "GC-2025-001234",
    "titanic_id": 1234
}

---

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. Gasto No Encontrado - Código 404

{
    "codigo_http": 404,
    "estado": "error",
    "mensaje": "Gasto de conductor no encontrado para synergy_id: GC-2025-001234",
    "codigo_error": "GASTO_CONDUCTOR_NO_ENCONTRADO",
    "synergy_id": "GC-2025-001234"
}

3. Error Interno - Código 500

Escenario: Error al procesar la anulación en la base de datos

{
    "codigo_http": 500,
    "estado": "error",
    "mensaje": "Error interno al anular gasto de conductor",
    "codigo_error": "ERROR_INTERNO",
    "error": "Detalle del error"
}

4. Error del Servidor - Código 500

{
    "codigo_http": 500,
    "estado": "error",
    "mensaje": "Error interno del servidor",
    "codigo_error": "SERVER_ERROR",
    "error": "Detalle del error"
}

---

REGLAS DE NEGOCIO

1. Eliminación Física

• El endpoint elimina físicamente el registro de la tabla gasto_operativo
• No se mantiene un registro histórico del gasto anulado
• El archivo asociado (si existe) NO se elimina del sistema de archivos

2. Validación de Existencia

• Se valida que el gasto exista por id_registro_api y id_empresa
• Si no existe, se retorna error 404

3. Auditoría

• Se registra la anulación en Centinela con:
  • Módulo: OPERACIONES
  • Menú: GASTO CONDUCTOR
  • Acción: ANULACIÓN - ORIGEN: SYNERGY -> TITANICSOFT
  • Descripción: Incluye detalle, importe y número de viaje

---

EJEMPLO DE USO

Request

DELETE /api/gasto_conductor/anular/GC-2025-001234
Authorization: Bearer {token}

Response (200 OK)

{
    "codigo_http": 200,
    "estado": "success",
    "mensaje": "Gasto de conductor anulado exitosamente",
    "synergy_id": "GC-2025-001234",
    "titanic_id": 1234
}

---

NOTAS TÉCNICAS

• El endpoint utiliza transacciones de base de datos para garantizar integridad
• Se registra en Centinela para auditoría
• Rate limiting: máximo 10 requests por minuto por usuario
• Autenticación requerida mediante JWT token
• El archivo físico asociado al gasto NO se elimina automáticamente