Buscar para vender

Variantes activas listas para un ítem de venta ("Polo básico - S / Azul"), con precio y stock. Ideal para un buscador o un lector de código de barras: busca por nombre, SKU, código de barras exacto o **serie en stock**.

GEThttps://api.facturalo.pe/api/v3/productos/variantes

stock es el del entorno del token (todos los almacenes); null si no controla stock. serie solo viene cuando q es una serie en stock: envíala en series del ítem.

Query

Campo

Descripción

q

stringopcional

Texto, SKU, código de barras o serie / IMEI.Ej: 5CD1234ABC

ids

stringopcional

Ids de variantes separados por coma (para saber datos de ítems ya elegidos).

limite

integeropcional

1 a 30. Default 10.

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/productos/variantes", {
  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": [
    {
      "id": "a32f4541-75eb-4b59-ad28-3c571652fe39",
      "productoId": "a32f4541-75e1-4f0c-9d0a-6a2b7c1e9f10",
      "descripcion": "LAPTOP HP INTEL I20",
      "tipo": "producto",
      "sku": "LAPT-HP-INT-I20",
      "codigoBarras": null,
      "precio": "4500.00",
      "precioUsd": null,
      "unidadMedida": "NIU",
      "tipoIgv": "10",
      "codigoSunat": "43211503",
      "stock": 2,
      "controlaSeries": true,
      "serie": "5CD1234ABC"
    }
  ]
}