Series / IMEI

Series de los productos con `controlaSeries`. Estados: `disponible` (en stock), `vendida` o `baja` (merma, destrucción…). El estado sale del último movimiento: si se anula la venta o llega una nota de crédito, la serie vuelve a `disponible`.

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

Al vender un producto con controlaSeries, cada ítem de POST /documentos/enviar lleva series (una por unidad). La serie se agrega a la descripción del comprobante (… - S/N: 5CD1234ABD). Una serie ya vendida o dada de baja devuelve 422; una serie que no está en el inventario se acepta y queda registrada como vendida.

Query

Campo

Descripción

buscar

stringopcional

Parte de la serie.Ej: 5CD1234

estado

stringopcional

disponible, vendida o baja.

varianteId

stringopcional

UUID de la variante (p. ej. series disponibles para vender).

establecimientoId

stringopcional

UUID del almacén.

limite

integeropcional

1 a 200. Default 25.

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/series", {
  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": 3,
      "limite": 25,
      "pagina": 1,
      "paginas": 1
    },
    "series": [
      {
        "serie": "5CD1234ABD",
        "estado": "vendida",
        "varianteId": "a32f4541-75eb-4b59-ad28-3c571652fe39",
        "descripcion": "LAPTOP HP INTEL I20",
        "establecimiento": {
          "id": "11111111-2222-3333-4444-555555555555",
          "nombre": "Principal"
        },
        "actualizado": "2026-11-09T11:02:10-05:00"
      },
      {
        "serie": "5CD1234ABC",
        "estado": "disponible",
        "varianteId": "a32f4541-75eb-4b59-ad28-3c571652fe39",
        "descripcion": "LAPTOP HP INTEL I20",
        "establecimiento": {
          "id": "11111111-2222-3333-4444-555555555555",
          "nombre": "Principal"
        },
        "actualizado": "2026-11-09T10:20:00-05:00"
      }
    ]
  }
}