Saltar al contenido
Facturador

Registrar o editar caja

POST /api/cash

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Mismo comportamiento que Aperturar caja: abre una caja (sin id) o edita una caja abierta (con id). Si no envías user_id se usa el usuario autenticado.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success. Devuelve data.cash_id.

Cuerpo (JSON):

Campo Tipo Obligatorio Descripción / valores permitidos
beginning_balance numeric Sí Saldo inicial en soles (efectivo en el cajón al abrir), ≥ 0.
beginning_balance_usd numeric No Saldo inicial en dólares, ≥ 0. Si no se envía se conserva el actual (o 0 en una caja nueva).
user_id integer No Usuario dueño de la caja. Vacío o 0 = el usuario autenticado.
reference_number string No Referencia libre de la caja (p. ej. CAJA-0004, número de turno).
id integer No Solo para editar una caja abierta (saldo inicial, referencia o usuario). Omitido o null = apertura.

Reglas:

  • Apertura: si el usuario ya tiene una caja abierta no se crea otra ni se modifica: responde success: true con el id de la caja abierta y el mensaje La caja ya se encontraba aperturada.
  • La fecha y hora de apertura las fija el servidor; el saldo inicial se registra como el primer movimiento de efectivo de la caja.
  • Edición (id): solo cajas abiertas; no se puede asignar la caja a un usuario que ya tiene otra abierta.

Errores:

  • 422 {success: false, message: {campo: [errores]}} si falla la validación de campos. (p. ej. beginning_balance negativo).
  • 200 con success: false y message si la caja a editar no existe, está cerrada o el usuario destino ya tiene una caja abierta.

Cuerpo

Content-Type: application/json

{
  "beginning_balance": 150.0,
  "beginning_balance_usd": 0,
  "user_id": null,
  "reference_number": "CAJA-0004",
  "id": "1"
}

Respuestas

200 — Caja actualizada

{
  "success": true,
  "message": "Caja actualizada con éxito",
  "data": {
    "cash_id": 4
  }
}

200 — Usuario con otra caja

{
  "success": false,
  "message": "Ese usuario ya tiene una caja aperturada. Ciérrala antes de asignarle otra."
}

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.