Saltar al contenido
Facturador

Stock de un producto en todos los almacenes

GET /api/items/{item_id}/stock

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Devuelve el stock de un producto en cada almacén de la empresa (los almacenes donde nunca tuvo movimientos salen con 0 y has_record: false) y el total.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor). Un vendedor solo recibe el almacén de su establecimiento.

Formato de respuesta: estándar {success, data, message?} (registro único). data = {item, total_stock, warehouses[]}; cada almacén trae warehouse_id, description, establishment_id, establishment_description, is_current (es el del establecimiento del usuario), has_record y stock.

Parámetros de la ruta:

Campo Tipo Obligatorio Descripción / valores permitidos
item_id integer Sí Producto.

Errores:

  • 404 si el registro no existe.
  • 401 sin token o con un token inválido.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
item_id ruta sí 1

Respuestas

200 — Stock del producto

{
  "success": true,
  "data": {
    "item": {
      "id": 15,
      "internal_id": "P0015",
      "description": "GASEOSA 500 ML",
      "unit_type_id": "NIU",
      "barcode": "7751234567890",
      "category": {
        "id": 2,
        "name": "BEBIDAS"
      },
      "brand": {
        "id": 4,
        "name": "COCA COLA"
      },
      "stock_min": 5.0,
      "sale_unit_price": 3.5,
      "currency_type_id": "PEN",
      "lots_enabled": false,
      "series_enabled": false,
      "active": true
    },
    "total_stock": 35.0,
    "warehouses": [
      {
        "warehouse_id": 3,
        "description": "Almacén - Tienda Centro",
        "establishment_id": 1,
        "establishment_description": "Tienda Centro",
        "is_current": true,
        "has_record": true,
        "stock": 27.0
      },
      {
        "warehouse_id": 5,
        "description": "Almacén - Sucursal Norte",
        "establishment_id": 4,
        "establishment_description": "Sucursal Norte",
        "is_current": false,
        "has_record": true,
        "stock": 8.0
      }
    ]
  }
}

404 — No existe

{
  "success": false,
  "message": "Registro no encontrado."
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.