Stock

Stock y valorizado por variante (solo las que controlan stock). Sin `establecimientoId`: suma de todos los almacenes. Para la alerta de reposición: `PUT /inventario/stock/{varianteId}/minimo` con `{"stockMinimo": 5, "establecimientoId": null}`.

GEThttps://api.facturalo.pe/api/v3/inventario/stock

Query

Campo

Descripción

buscar

stringopcional

Nombre, SKU o código de barras.

estado

stringopcional

bajo (≤ stock mínimo), sin (≤ 0) o negativo.

establecimientoId

stringopcional

UUID del almacén.

limite

integeropcional

1 a 100. Default 25.

page

integeropcional

Página.

Language

Credentials

Header

Authorization

Token de la empresa · HTTP directo

Fetch Request

$ # Node 18+ fetch

const response = await fetch("https://api.facturalo.pe/api/v3/inventario/stock", {
  method: "GET",
  headers: {
    "Authorization": "sk_test_…"
  }
});

const data = await response.json();
console.log(data);

HTTP directo · funciona con cualquier cliente HTTP

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": {
    "paginacion": {
      "total": 1,
      "limite": 25,
      "pagina": 1,
      "paginas": 1
    },
    "resumen": {
      "valorTotal": 30100,
      "negativos": 0
    },
    "stock": [
      {
        "varianteId": "a32f4541-75eb-4b59-ad28-3c571652fe39",
        "productoId": "a32f4541-75e1-4f0c-9d0a-6a2b7c1e9f10",
        "descripcion": "LAPTOP HP INTEL I20",
        "sku": "LAPT-HP-INT-I20",
        "unidadMedida": "NIU",
        "activo": true,
        "cantidad": 15,
        "costoPromedio": 2006.666667,
        "valor": 30100,
        "stockMinimo": 5,
        "bajo": false
      }
    ]
  }
}