Restofy Docs
Caja POST

Registrar un ingreso de efectivo a la caja

POST /api/cashier/create-cash-in

Descripción

Suma dinero a la caja durante la sesión, dejando registrado el motivo del ingreso.

Detalles

Registra una entrada de efectivo a la caja por fuera de las ventas (aporte del dueño, reintegro, corrección, etc.). El monto se suma al efectivo de la sesión y queda reflejado como movimiento dentro del cuadre del turno. La nota del motivo es obligatoria. Solo se permite mientras la sesión sigue abierta.

Permisos requeridos

cash.module

Request

Nombre Tipo Requerido Reglas
cashRegisterSessionId int
min_value:1
amountCents int
min_value:1
notes string
min:1 max:500

Ejemplo de request

curl -X POST https://app.restofy.co/api/cashier/create-cash-in \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "cashRegisterSessionId": 1,
    "amountCents": 1,
    "notes": "string"
}'

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

Ejemplo de respuesta

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

Request

{
    "cashRegisterSessionId": 2,
    "amountCents": 1500,
    "notes": "a cancelar"
}

Response

{
    "success": true,
    "message": "Ingreso registrado",
    "data": {
        "cashRegisterSessionId": 2,
        "type": "cash_in",
        "amountCents": 1500
    }
}