Restofy Docs
Control de inventario POST

Guardar un insumo contado

POST /api/inventory/set-inventory-count-line

Descripción

Registra cuánto hay de un insumo en el conteo en curso de una bodega.

Detalles

Guarda la cantidad contada de un insumo en la unidad que elijas. Si la bodega no tiene conteo en curso, lo abre. Si el insumo ya estaba contado, puedes reemplazar la cantidad o sumarla a la anterior cuando el insumo está en dos sitios de la bodega. El stock no cambia hasta terminar el conteo.

Permisos requeridos

inventory.count.declare inventory.count.close

El usuario solo necesita uno de los permisos listados.

Request

Nombre Tipo Requerido Reglas
storageLocationId int Sí
min_value:1
inventoryItemId int Sí
min_value:1
quantity string Sí
decimal min_value:0
unitId int Sí
min_value:1
mode string Sí
enum:replace,add

Ejemplo de request

curl -X POST https://restofy.pro/api/inventory/set-inventory-count-line \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "storageLocationId": 1,
    "inventoryItemId": 1,
    "quantity": "string",
    "unitId": 1,
    "mode": "string"
}'

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

Ejemplo de respuesta

Actualizado: 2026-11-02T19:00:57Z
HTTP 200

Request

{
    "storageLocationId": 8,
    "inventoryItemId": 28,
    "quantity": 90,
    "unitId": 2,
    "mode": "replace"
}

Response

{
    "success": true,
    "message": "Insumo contado",
    "data": {
        "inventoryCountUuid": "950974d3-9766-4412-9252-1152116915ea",
        "inventoryCountLineUuid": "9b05c2b9-6fd5-45f2-9167-cda0e8cd41cc"
    }
}