Unidades de medida
POST
Crear unidad de medida
POST /api/units/create-unit
Descripción
Da de alta una unidad universal o un empaque individual atado a un insumo.
Detalles
* El símbolo debe ser único en todo el catálogo y contener solo letras minúsculas. * Si se indica un insumo, la unidad queda atada exclusivamente a él y debe referenciar la misma medida base del insumo. * Sin insumo, la unidad queda disponible para cualquier insumo de esa misma medida base. * Las unidades base no se crean desde este endpoint: son parte del catálogo del sistema. * La unidad nueva nace disponible.
Permisos requeridos
catalog.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| name | string | Sí |
min:1
max:100
|
| symbol | string | Sí |
min:1
max:5
|
| baseUnitId | int | Sí |
min_value:1
|
| factor | string | Sí |
decimal
|
| inventoryItemId | int | No |
min_value:1
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/units/create-unit \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"name": "string",
"symbol": "string",
"baseUnitId": 1,
"factor": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"name": "Unidad SetAvail",
"symbol": "usa",
"baseUnitId": 2,
"factor": 1
}Response
{
"success": true,
"message": "Unidad creada",
"data": {
"unitId": "105"
}
}