Anular gasto
POST /api/expenses/{expense_id}/void
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Anula el gasto (estado 11): sus pagos dejan de contar y el dinero vuelve a la caja o a la cuenta de donde salió. No se puede deshacer.
Quién puede usarlo: cualquier usuario autenticado. Un administrador accede a todos los registros; un vendedor solo a los que registró él (o en los que figura como vendedor). Si el registro existe pero es de otro vendedor responde 403.
Formato de respuesta: estándar {success, data, message?} (registro único). Responde 200 con el gasto anulado (ítems y pagos).
Parámetros de la ruta:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
expense_id |
integer | Sí | Id del gasto. |
Sin cuerpo.
Reglas:
- No se puede anular un gasto cuya fecha y hora caen dentro de una caja ya cerrada del usuario: su arqueo ya se contó (
409). Si hubo un error, registra un ingreso por la diferencia en la caja abierta. - Un gasto ya anulado no se anula otra vez (
409).
Errores:
409si ya está anulado o pertenece a una caja cerrada.403si el gasto es de otro vendedor.404si no existe.401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
expense_id |
ruta | sí | 1 |
Respuestas
200 — Anulado
{
"success": true,
"data": {
"id": 25,
"external_id": "4f1c2b8e-7a9d-4d1e-9a3b-2c6e8f0a1b2c",
"number": "F001-4587",
"number_full": "F001-4587",
"date_of_issue": "2026-11-07",
"time_of_issue": "10:15:00",
"state_type_id": "11",
"state_type_description": "Anulado",
"currency_type_id": "PEN",
"exchange_rate_sale": 1.0,
"total": 50.0,
"user_id": 5,
"establishment_id": 1,
"expense_type_id": 1,
"expense_type_description": "FACTURA",
"expense_reason_id": 2,
"expense_reason_description": "Servicios",
"supplier_id": 14,
"supplier": {
"name": "SERVICIOS GENERALES S.A.C.",
"number": "20456789123"
},
"items": [
{
"id": 40,
"description": "Servicio de limpieza noviembre",
"total": 50.0
}
],
"payments": [
{
"id": 31,
"date_of_payment": "2026-11-07",
"payment_method_type_id": "01",
"payment_method_type_description": "Efectivo",
"destination_description": "CAJA - JUAN PEREZ",
"reference": null,
"payment": 50.0
}
]
},
"message": "Gasto anulado exitosamente"
}
409 — Ya anulado
{
"success": false,
"message": "El gasto ya está anulado."
}
409 — Caja cerrada
{
"success": false,
"message": "No se puede anular un gasto que pertenece a una caja cerrada"
}
403 — Registro de otro vendedor
{
"success": false,
"message": "No tienes permiso para acceder a este registro."
}
404 — No existe
{
"success": false,
"message": "Registro no encontrado."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.