Egresos

Egresos

Prefijo: /api/egresos
Requiere Auth: Sí
Permiso requerido: egresos, *

Módulo de egresos (gastos) para registrar y consultar salidas de dinero del negocio.

GET /api/egresos/

Descripción: Lista los egresos con paginación y filtro por fechas
Requiere Auth: Sí
Permiso requerido: egresos, leer

Respuesta exitosa: 200 OK

Response:

[
  {
    "id": 1,
    "categoria": "Servicios",
    "descripcionPago": "Pago de luz",
    "fechaPago": "2025-01-15",
    "metodoPago": "Efectivo",
    "montoPagado": 150000,
    "recibePago": "Empresa Eléctrica",
    "responsablePago": "Juan Pérez",
    "jornada_id": 1,
    "tenant_id": "uuid-tenant"
  }
]

cURL:

curl "http://localhost/api/egresos/?skip=0&limit=10" -H "Authorization: Bearer <token>"

Python:

import httpx
resp = httpx.get("http://localhost/api/egresos/", headers={"Authorization": f"Bearer {token}"})
egresos = resp.json()

JavaScript:

const resp = await fetch('http://localhost/api/egresos/', {
  headers: {'Authorization': `Bearer ${token}`}
});
const egresos = await resp.json();

---

GET /api/egresos/total-dia

Descripción: Obtiene el total de egresos del día
Requiere Auth: Sí
Permiso requerido: egresos, leer

Parámetros query:

Parámetro	Tipo	Obligatorio	Descripción
fecha	date	✅	Fecha a consultar

Respuesta exitosa: 200 OK

cURL:

curl "http://localhost/api/egresos/total-dia?fecha=2025-01-15" -H "Authorization: Bearer <token>"

---

GET /api/egresos/total-mensual

Descripción: Obtiene el total de egresos del mes
Requiere Auth: Sí
Permiso requerido: egresos, leer

Parámetros query:

Parámetro	Tipo	Obligatorio	Descripción
anio	int	✅	Año
mes	int	✅	Mes (1-12)

Respuesta exitosa: 200 OK

cURL:

curl "http://localhost/api/egresos/total-mensual?anio=2025&mes=1" -H "Authorization: Bearer <token>"

---

GET /api/egresos/total-rango

Descripción: Obtiene el total de egresos en un rango
Requiere Auth: Sí
Permiso requerido: egresos, leer

Parámetros query:

Parámetro	Tipo	Obligatorio	Descripción
fecha_inicio	date	✅	Fecha inicial
fecha_fin	date	✅	Fecha final

Respuesta exitosa: 200 OK

cURL:

curl "http://localhost/api/egresos/total-rango?fecha_inicio=2025-01-01&fecha_fin=2025-01-31" -H "Authorization: Bearer <token>"

---

POST /api/egresos/

Descripción: Crea un nuevo egreso
Requiere Auth: Sí
Permiso requerido: egresos, crear

Request:

{
  "categoria": "Servicios",
  "descripcionPago": "Pago de agua",
  "fechaPago": "2025-01-15",
  "metodoPago": "Transferencia",
  "montoPagado": 80000,
  "recibePago": "Empresa de Acueducto",
  "responsablePago": "Juan Pérez"
}

Respuesta exitosa: 201 Created

cURL:

curl -X POST http://localhost/api/egresos/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{"categoria":"Servicios","descripcionPago":"Pago de agua","fechaPago":"2025-01-15","metodoPago":"Transferencia","montoPagado":80000,"recibePago":"Empresa de Acueducto","responsablePago":"Juan Pérez"}'

Python:

import httpx
resp = httpx.post("http://localhost/api/egresos/",
    json={"categoria": "Servicios", "descripcionPago": "Pago de agua", "fechaPago": "2025-01-15", "metodoPago": "Transferencia", "montoPagado": 80000, "recibePago": "Empresa de Acueducto", "responsablePago": "Juan Pérez"},
    headers={"Authorization": f"Bearer {token}"})
egreso = resp.json()

JavaScript:

const resp = await fetch('http://localhost/api/egresos/', {
  method: 'POST',
  headers: {'Content-Type': 'application/json', 'Authorization': `Bearer ${token}`},
  body: JSON.stringify({categoria: 'Servicios', descripcionPago: 'Pago de agua', fechaPago: '2025-01-15', metodoPago: 'Transferencia', montoPagado: 80000, recibePago: 'Empresa de Acueducto', responsablePago: 'Juan Pérez'})
});

---

GET /api/egresos/{egreso_id}

Descripción: Obtiene un egreso por ID
Requiere Auth: Sí
Permiso requerido: egresos, leer

Respuesta exitosa: 200 OK
Errores: 404 (no encontrado)

cURL:

curl http://localhost/api/egresos/1 -H "Authorization: Bearer <token>"

---

PUT /api/egresos/{egreso_id}

Descripción: Actualiza un egreso
Requiere Auth: Sí
Permiso requerido: egresos, actualizar

Respuesta exitosa: 200 OK
Errores: 404 (no encontrado)

cURL:

curl -X PUT http://localhost/api/egresos/1 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{"montoPagado":90000,"descripcionPago":"Pago de luz actualizado"}'

---

DELETE /api/egresos/{egreso_id}

Descripción: Elimina un egreso
Requiere Auth: Sí
Permiso requerido: egresos, eliminar

Respuesta exitosa: 204 No Content
Errores: 404 (no encontrado)

cURL:

curl -X DELETE http://localhost/api/egresos/1 -H "Authorization: Bearer <token>"