Restofy Docs
Insumos POST

Crear insumo

POST /api/inventory-items/create-inventory-item

Descripción

Registra un nuevo insumo en el maestro del restaurante con código autogenerado.

Detalles

* El código se asigna de forma automática con el patrón INS-NNN y no es editable. * Las tres unidades (control, conteo y compra) deben ser de la misma dimensión. * El nombre debe ser único entre los insumos disponibles; falla si ya existe. * Falla si la categoría o alguna de las unidades no está disponible.

Permisos requeridos

catalog.module

Request

Nombre Tipo Requerido Reglas
name string Sí
min:2 max:150
internalName string No
max:150
description string No
max:1000
categoryUuid string Sí
min:36 max:36
unitId int Sí
min_value:1
countingDefaultUnitId int Sí
min_value:1
purchaseDefaultUnitId int Sí
min_value:1
costCents int Sí
min_value:0
reorderPoint string No
decimal min_value:0 default:0
isActive int No
enum:0,1 default:1

Ejemplo de request

curl -X POST https://app.restofy.co/api/inventory-items/create-inventory-item \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "name": "string",
    "categoryUuid": "string",
    "unitId": 1,
    "countingDefaultUnitId": 1,
    "purchaseDefaultUnitId": 1,
    "costCents": 1
}'

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

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z
HTTP 200

Request

{
    "name": "Insumo Test 6a5788c4d8f77",
    "categoryUuid": "64eaa972-b2ee-4cd5-a2ce-b755017f333f",
    "unitId": 9,
    "countingDefaultUnitId": 9,
    "purchaseDefaultUnitId": 9,
    "costCents": 150000,
    "reorderPoint": 10
}

Response

{
    "success": true,
    "message": "Insumo creado",
    "data": {
        "inventoryItem": {
            "inventoryItemId": 27,
            "name": "Insumo Test 6a5788c4d8f77",
            "internalName": null,
            "description": null,
            "inventoryItemCategoryId": 12,
            "categoryUuid": "64eaa972-b2ee-4cd5-a2ce-b755017f333f",
            "categoryName": "Cat Insumo 6a5788c499b4a",
            "unitId": 9,
            "countingDefaultUnitId": 9,
            "purchaseDefaultUnitId": 9,
            "baseUnitId": 1,
            "baseUnitSymbol": "und",
            "sku": "INS-081",
            "costCents": 150000,
            "reorderPoint": "10.0000",
            "isActive": 1,
            "isAvailable": 1
        }
    }
}
Volver a Insumos