Lista los productos por debajo del umbral de stock

Devuelve los productos cuyo stock actual está por debajo de su umbral de stock bajo configurado.

Útil para alertas de inventario.

Authorization

AuthorizationBearer <token>

Tu API key como token Bearer: fact_live_… en producción, fact_test_… en sandbox. Consulta la guía de autenticación.

En: header

Parámetros de ruta

company*string

Identificador público (UUID v7) de la empresa. Obtenlo de GET /v1/me (data.scope[].id).

Formatouuid

Fija la versión de la API (YYYY-MM-DD, versionado por fecha estilo Stripe) para esta petición; omítelo para usar la versión fijada de la clave, o la última si no hay ninguna. Versión no soportada → 400 unsupported_api_version; malformada → 400 parameter_invalid_format. La versión efectiva se refleja en la cabecera de respuesta Factuarea-Version. Consulta la guía de Versioning.

Formatodate

Cuerpo de la respuesta

`application/json`

Ejemplo de petición

const apiKey = process.env.FACTUAREA_API_KEY;if (!apiKey) throw new Error("Set FACTUAREA_API_KEY");const response = await fetch("https://api.factuarea.com/v1/companies/01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01/products/low-stock-report", {  method: "GET",  headers: { Authorization: `Bearer ${apiKey}`, ...{"Accept":"application/json"} },});if (!response.ok) throw new Error(await response.text());if (response.status !== 204) console.log(await response.json());

Ejemplo de respuesta

{
  "data": [
    {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a09",
      "object": "product",
      "name": "Vino tinto D.O. Rioja",
      "sku": "VINO-RIOJA",
      "price": "3.70",
      "sale_price": {
        "net": "3.70",
        "tax": "0.78",
        "gross": "4.48"
      },
      "promotion": null,
      "currency": "EUR",
      "channels": {
        "web": false
      },
      "slug": "vino-tinto-d-o-rioja",
      "previous_slugs": [],
      "summary": null,
      "seo": {
        "title": "Vino tinto D.O. Rioja",
        "description": null
      },
      "availability": {
        "status": "low",
        "quantity": "5.0000"
      },
      "tax_rate": {
        "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0f",
        "rate": 21
      },
      "stock": "5.0000",
      "item_kind": "product",
      "base_unit": "LTR",
      "gross_weight_kg": "0.9200",
      "manage_stock": true,
      "gallery": [
        {
          "index": 0,
          "url": "https://files.factuarea.com/products/vino-rioja-garrafa.jpg",
          "content_type": "image/jpeg",
          "alt": "Vino tinto D.O. Rioja",
          "width": 1200,
          "height": 800
        }
      ],
      "video": {
        "url": "https://files.factuarea.com/products/vino-rioja-bodega.mp4",
        "content_type": "video/mp4"
      },
      "is_active": true,
      "description": "Vino tinto con Denominación de Origen Rioja, servido a granel en garrafa de 5 o 15 litros.",
      "tags": [
        "bodega",
        "granel"
      ],
      "low_stock_threshold": "10.0000",
      "presentation_count": 1,
      "variant_count": 1,
      "supplier_offer_count": 1,
      "option_group_count": 1,
      "configuration_count": 1,
      "catalog_availability_mode": "open",
      "preferred_supplier_offer_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b20",
      "presentations": [
        {
          "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b21",
          "object": "product_presentation",
          "sale_price": {
            "net": "18.5000",
            "tax": "3.89",
            "gross": "22.39"
          },
          "promotion": null,
          "availability": {
            "status": "low",
            "quantity": "5.0000"
          },
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a09",
          "name": "Garrafa de 5 L",
          "mode": "fixed",
          "unit": "LTR",
          "conversion_factor": "5.000000",
          "nominal_base_quantity": "5.0000",
          "barcode": "8437012345678",
          "commercial_price_override": "18.5000",
          "gross_weight_kg": "4.8500",
          "specifications": {
            "envase": "PET alimentario",
            "tapon": "Con grifo dosificador"
          },
          "active": true
        }
      ],
      "variants": [
        {
          "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b22",
          "object": "product_variant",
          "sale_price": {
            "net": "3.90",
            "tax": "0.82",
            "gross": "4.72"
          },
          "promotion": null,
          "availability": {
            "status": "in_stock",
            "quantity": "25.0000"
          },
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a09",
          "name": "Superior",
          "sku": "VINO-RIOJA-SUP",
          "barcode": "8437012345685",
          "base_price_override": "3.90",
          "unit_cost_override": "2.40",
          "manage_stock": true,
          "stock": "25.0000",
          "low_stock_threshold": "5.0000",
          "gross_weight_kg": null,
          "specifications": {
            "crianza": "12 meses en barrica"
          },
          "active": true
        }
      ],
      "supplier_offers": [
        {
          "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b20",
          "object": "supplier_product_offer",
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a09",
          "supplier_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a02",
          "variant_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b22",
          "supplier_sku": "BOD-RIOJA-SUP",
          "purchase_unit": "LTR",
          "conversion_factor": "1.000000",
          "unit_cost": "2.40",
          "currency": "EUR",
          "availability": "in_stock",
          "minimum_quantity": "50.0000",
          "lead_time_days": 3,
          "preferred": true,
          "active": true
        }
      ],
      "option_groups": [
        {
          "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c30",
          "object": "product_option_group",
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a09",
          "name": "Calidad",
          "required": true,
          "position": 0,
          "scope_id": null,
          "active": true,
          "values": [
            {
              "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c31",
              "object": "product_option_value",
              "name": "Superior",
              "position": 1,
              "price_adjustment": "2.0000",
              "active": true
            }
          ]
        }
      ],
      "configurations": [
        {
          "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c40",
          "object": "product_configuration",
          "sale_price": {
            "net": "21.5000",
            "tax": "4.52",
            "gross": "26.02"
          },
          "promotion": null,
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a09",
          "name": "Superior · Garrafa de 5 L · Calidad: Superior",
          "variant_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b22",
          "variant_name": "Superior",
          "presentation_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b21",
          "presentation_name": "Garrafa de 5 L",
          "signature": "b1f0c3d2e4a5968778695a4b3c2d1e0fb1f0c3d2e4a5968778695a4b3c2d1e0f",
          "commercial_price": "21.5000",
          "active": true,
          "restricts_availability": true,
          "options": [
            {
              "object": "product_configuration_option",
              "group_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c30",
              "group_name": "Calidad",
              "value_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c31",
              "value_name": "Superior",
              "price_adjustment": "2.0000"
            }
          ]
        }
      ],
      "is_low_stock": true,
      "is_in_stock": true,
      "specifications": {
        "origen": "España",
        "denominacion": "D.O. Rioja",
        "graduacion": "13,5 %"
      },
      "metadata": {
        "erp_code": "IVA-GEN",
        "ledger_account": "477000"
      },
      "external_id": "SHOP-42",
      "created_at": "2026-01-02T08:30:00Z",
      "updated_at": "2026-01-02T08:30:00Z"
    }
  ],
  "total_count": 1
}

Se envió la cabecera X-Active-Profile retirada

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_unknown",
    "subcode": "retired_active_profile_header",
    "message": "La cabecera 'X-Active-Profile' fue retirada de la API v1: la empresa efectiva se indica en el segmento de empresa de la ruta.",
    "param": "X-Active-Profile",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_unknown",
    "request_id": "req_01J8Y3M2Q40000000000000001"
  }
}

Cabecera Factuarea-Version malformada

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid_format",
    "message": "El header 'Factuarea-Version' debe tener formato YYYY-MM-DD.",
    "param": "Factuarea-Version",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid_format",
    "request_id": "req_01J8Y3M2Q40000000000000002"
  }
}

Factuarea-Version no admitida

{
  "error": {
    "type": "invalid_request_error",
    "code": "unsupported_api_version",
    "message": "La versión de API '2020-01-01' no está soportada.",
    "param": "Factuarea-Version",
    "doc_url": "https://docs.factuarea.com/guides/errors#unsupported_api_version",
    "request_id": "req_01J8Y3M2Q40000000000000003"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "Falta header Authorization o X-API-Key.",
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_81bd9a19c36d87e1182e257138"
  }
}

GET /v1/companies/{company}/products/low-stock-report · 403 insufficient_scope

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta operación requiere el scope 'products:read'. Tu API key solo tiene los scopes: ninguno.",
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_f34e275792f0a808fac93d17e3"
  }
}

Empresa desactivada

{
  "error": {
    "type": "authorization_error",
    "code": "company_inactive",
    "message": "Esta empresa está desactivada. Actívala para operar.",
    "param": "company",
    "doc_url": "https://docs.factuarea.com/guides/errors#company_inactive",
    "request_id": "req_01J8Y3M2Q40000000000000005"
  }
}

Recurso no encontrado

{
  "error": {
    "type": "not_found_error",
    "code": "resource_not_found",
    "message": "El recurso solicitado no existe o pertenece a otra empresa.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#resource_not_found",
    "request_id": "req_01HKQS5NEQ6X1R4N9B0C5DWTPG"
  }
}

Empresa no encontrada o fuera del alcance de la API key

{
  "error": {
    "type": "not_found_error",
    "code": "profile_not_found",
    "message": "La empresa indicada no existe o no está en el ámbito de tu credencial.",
    "param": "company",
    "doc_url": "https://docs.factuarea.com/guides/errors#profile_not_found",
    "request_id": "req_01J8Y3M2Q40000000000000004"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el límite de requests permitido. Reintenta más tarde.",
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_85226da827a753ca12fe4dac82"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Algo se rompió en nuestro lado al procesar la petición. La condición no la provoca tu payload.",
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_36bf1018c29da5cd09eb71a6dc"
  }
}

Lista los productos por debajo del umbral de stock

Authorization

Parámetros de ruta

Headers

Cuerpo de la respuesta

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`