Cajas registradoras
POST
Crear caja
POST /api/cash-registers/create-cash-register
Descripción
Registra una caja nueva bajo una entidad legal con su secuencia de facturación por defecto.
Detalles
Crea una caja de cobro asociada a una entidad legal y le asigna la secuencia de facturación con la que numerará sus documentos. La caja queda activa y lista para abrir turno.
Permisos requeridos
admin.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| name | string | Sí |
min:2
max:100
|
| legalEntityId | int | Sí |
min_value:1
|
| defaultInvoiceSequenceId | int | Sí |
min_value:1
|
| location | string | No |
max:150
|
| namePc | string | No |
max:200
|
| seriePc | string | No |
max:200
|
| printerId | int | No |
min_value:1
|
Ejemplo de request
curl -X POST https://restofy.pro/api/cash-registers/create-cash-register \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"name": "string",
"legalEntityId": 1,
"defaultInvoiceSequenceId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"name": "Caja a borrar 6aa03856f24f1",
"legalEntityId": 3,
"defaultInvoiceSequenceId": 1
}Response
{
"success": true,
"message": "Caja creada",
"data": {
"cashRegister": {
"cashRegisterId": 2,
"cashRegisterUuid": "3078b96f-ab4a-11f1-b72d-f2569efa6eee",
"legalEntityId": 3,
"name": "Caja a borrar 6aa03856f24f1",
"location": null,
"namePc": null,
"seriePc": null,
"defaultInvoiceSequenceId": 1,
"printerId": null,
"isActive": 1
}
}
}