Kárdex valorizado

Kárdex de una variante en un almacén y periodo: saldo anterior, movimientos con entradas, salidas y saldo (cantidad, costo unitario y total), totales y saldo final. Con `formato=csv` descarga el CSV con la estructura del formato 13.1 (abre en Excel).

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

Query

Campo

Descripción

varianteId

stringrequerido

UUID de la variante.

establecimientoId

stringopcional

UUID del almacén. Default: principal.

desde

stringopcional

YYYY-MM-DD. Default: inicio de mes.

hasta

stringopcional

YYYY-MM-DD. Default: hoy.

formato

stringopcional

json (default), xlsx (Excel con el formato 13.1), pdf (A4 horizontal) o csv. Los tres últimos descargan el archivo.

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/kardex", {
  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": {
    "periodo": {
      "desde": "2026-11-01",
      "hasta": "2026-11-30"
    },
    "ruc": "20161515648",
    "razonSocial": "TEST S.A.C",
    "establecimiento": {
      "id": "11111111-2222-3333-4444-555555555555",
      "nombre": "Principal",
      "codigoSunat": "0000"
    },
    "producto": {
      "varianteId": "a32f4541-75eb-4b59-ad28-3c571652fe39",
      "descripcion": "LAPTOP HP INTEL I20",
      "codigo": "LAPT-HP-INT-I20",
      "tipoExistencia": "01",
      "unidadMedida": "NIU"
    },
    "metodoValuacion": {
      "codigo": "1",
      "nombre": "Promedio ponderado"
    },
    "saldoInicial": {
      "cantidad": 0,
      "costoUnitario": 0,
      "total": 0
    },
    "movimientos": [
      {
        "id": "a3301a1c-6b0e-4f7e-8a51-2f1d7c9b0e11",
        "fecha": "2026-11-01",
        "documento": null,
        "tipoOperacion": "16",
        "operacion": "Saldo inicial",
        "origen": "manual",
        "entrada": {
          "cantidad": 10,
          "costoUnitario": 2000,
          "total": 20000
        },
        "salida": null,
        "saldo": {
          "cantidad": 10,
          "costoUnitario": 2000,
          "total": 20000
        },
        "nota": null
      },
      {
        "id": "a3301a1c-7c1f-4f7e-8a51-2f1d7c9b0e12",
        "fecha": "2026-11-03",
        "documento": {
          "tipo": "01",
          "serie": "F005",
          "numero": "887"
        },
        "tipoOperacion": "02",
        "operacion": "Compra",
        "origen": "manual",
        "entrada": {
          "cantidad": 5,
          "costoUnitario": 2300,
          "total": 11500
        },
        "salida": null,
        "saldo": {
          "cantidad": 15,
          "costoUnitario": 2100,
          "total": 31500
        },
        "nota": null
      },
      {
        "id": "a3301a1c-8d2a-4f7e-8a51-2f1d7c9b0e13",
        "fecha": "2026-11-09",
        "documento": {
          "tipo": "01",
          "serie": "F001",
          "numero": "1"
        },
        "tipoOperacion": "01",
        "operacion": "Venta",
        "origen": "comprobante",
        "entrada": null,
        "salida": {
          "cantidad": 2,
          "costoUnitario": 2100,
          "total": 4200
        },
        "saldo": {
          "cantidad": 13,
          "costoUnitario": 2100,
          "total": 27300
        },
        "nota": null
      }
    ],
    "totales": {
      "entradas": {
        "cantidad": 15,
        "total": 31500
      },
      "salidas": {
        "cantidad": 2,
        "total": 4200
      }
    },
    "saldoFinal": {
      "cantidad": 13,
      "costoUnitario": 2100,
      "total": 27300
    }
  }
}