Saltar al contenido
Facturador

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:

  • 409 si ya está anulado o pertenece a una caja cerrada.
  • 403 si el gasto es de otro vendedor.
  • 404 si no existe.
  • 401 sin 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.