Anular Movimiento de Caja

ANULAR CAJA (MOVIMIENTO DE TESORERÍA)

CABECERA

Endpoint para recibir anulaciones de movimientos de caja desde Synergy. Permite anular operaciones de tesorería previamente registradas. El endpoint es idempotente: si la caja ya está anulada, retorna éxito.

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

• DELETE - Para anular un movimiento de caja existente

---

URL DEL ENDPOINT

DELETE /api/caja/anular/{synergy_id}

Parámetros de URL

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

Ejemplo:

DELETE /api/caja/anular/CAJ-2025-001234

---

RESPUESTA EXITOSA

Código HTTP 200

{
    "codigo_http": 200,
    "estado": "success",
    "mensaje": "Caja anulada exitosamente",
    "synergy_id": "CAJ-2025-001234",
    "serie": "CAJ",
    "numero": "00001234"
}

Código HTTP 200 (Idempotente - Ya Anulada)

{
    "codigo_http": 200,
    "estado": "success",
    "mensaje": "La caja ya está anulada",
    "synergy_id": "CAJ-2025-001234",
    "numero_caja": "CAJ-00001234",
    "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. Caja No Encontrada - Código 404

{
    "codigo_http": 404,
    "estado": "error",
    "mensaje": "Caja no encontrada para synergy_id: CAJ-2025-001234",
    "codigo_error": "CAJA_NO_ENCONTRADA",
    "synergy_id": "CAJ-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 caja",
    "codigo_error": "ERROR_INTERNO",
    "error": "Detalle del error"
}