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 | Sí |
min_value:1
|
| paidFromAccountId | int | Sí |
min_value:1
|
| amountCents | int | Sí |
min_value:1
|
| description | string | Sí |
min:1
max:500
|
| cashRegisterSessionId | int | Sí |
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
}
}