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. Opcionalmente guarda la base sugerida con la que abre cada turno. 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
|
| suggestedBaseCents | int | No |
min_value:0
|
Ejemplo de request
curl -X POST https://restofy.pro/api/cash-registers/create-cash-register \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"name": "string",
"legalEntityId": 1,
"defaultInvoiceSequenceId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-10-09T02:12:12Z
HTTP 200
Request
{
"name": "Caja terraza 6ac84ccf2bd46",
"legalEntityId": 3,
"defaultInvoiceSequenceId": 1,
"location": "Terraza"
}Response
{
"success": true,
"message": "Caja creada",
"data": {
"cashRegister": {
"cashRegisterId": 2,
"cashRegisterUuid": "6fe56e44-c386-11f1-a755-a2f78ac020f7",
"legalEntityId": 3,
"name": "Caja terraza 6ac84ccf2bd46",
"location": "Terraza",
"namePc": null,
"seriePc": null,
"defaultInvoiceSequenceId": 1,
"printerId": null,
"isActive": 1
}
}
}