Restofy Docs
Gastos POST

Registrar un gasto

POST /api/expenses/create-expense

Descripción

Crea un gasto pagado desde una caja o cuenta bancaria y descuenta el monto del origen elegido.

Detalles

Registra un gasto bajo una categoría y descuenta el monto del origen del pago. Requiere una sesión de caja abierta: el gasto queda atribuido a ella y, si se paga en efectivo, afecta el cuadre del turno. La descripción es obligatoria. Puede pedir PIN según la configuración del negocio.

Permisos requeridos

auth-tenant

Request

Nombre Tipo Requerido Reglas
expenseAccountId int
min_value:1
paidFromAccountId int
min_value:1
amountCents int
min_value:1
description string
min:1 max:500
cashRegisterSessionId int
min_value:1
pin string No
max:60

Ejemplo de request

curl -X POST https://app.restofy.co/api/expenses/create-expense \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "expenseAccountId": 1,
    "paidFromAccountId": 1,
    "amountCents": 1,
    "description": "string",
    "cashRegisterSessionId": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z
HTTP 200

Request

{
    "expenseAccountId": 80,
    "paidFromAccountId": 16,
    "cashRegisterSessionId": 2,
    "amountCents": 3300,
    "description": "gasto para reversar"
}

Response

{
    "success": true,
    "message": "Gasto registrado",
    "data": {
        "expenseId": "1",
        "amountCents": 3300
    }
}