Restofy Docs
Cuentas de caja fuerte POST

Crear cuenta de caja fuerte

POST /api/safe-accounts/create-safe-account

Descripción

Registra una caja fuerte o bóveda nueva del restaurante.

Detalles

Crea la caja fuerte con su nombre y, opcionalmente, su ubicación, tipo y notas. Solo el nombre es obligatorio. La caja fuerte nace activa y con saldo en cero.

Permisos requeridos

finance.module

Request

Nombre Tipo Requerido Reglas
name string
min:2 max:150
location string No
max:200
safeType string No
enum:vault,drop,lockbox,other default:other
notes string No
max:500

Ejemplo de request

curl -X POST https://restofy.pro/api/safe-accounts/create-safe-account \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "name": "string"
}'

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

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "name": "Boveda sucursal 6aa03928a246f",
    "location": "Bodega",
    "safeType": "vault"
}

Response

{
    "success": true,
    "message": "Caja fuerte creada",
    "data": {
        "safeAccount": {
            "safeAccountId": 9113,
            "name": "Boveda sucursal 6aa03928a246f",
            "location": "Bodega",
            "safeType": "vault",
            "notes": null,
            "isSystem": 0,
            "isActive": 1,
            "currentBalanceCents": 0
        }
    }
}