Factuarea API
Productos

Listar todos los productos

Lista los productos de tu catálogo con paginación por cursor.

GET
/products

Authorization

AuthorizationBearer <token>

En: header

Parámetros de consulta

limit?integer

Número de objetos a devolver. Entero entre 1 y 100. Por defecto 25.

Predeterminado25
Rango1 <= value <= 100
starting_after?string

Cursor para paginación hacia delante. Usa el uuid del último objeto de la página anterior.

Formatouuid
ending_before?string

Cursor para paginación hacia atrás. Usa el uuid del primer objeto de la página actual.

Formatouuid
sku?string

SKU del producto. Coincidencia exacta en sku.

sku[in]?string

SKU del producto. Lista separada por comas. Coincide cualquiera de los valores.

name?string

Nombre del producto. Coincidencia exacta en name.

is_active?boolean

Filtra por productos activos / inactivos. Coincidencia exacta en is_active.

created[gte]?string

Fecha de creación (ISO 8601). Mayor o igual que el valor dado.

Formatodate-time
created[lte]?string

Fecha de creación (ISO 8601). Menor o igual que el valor dado.

Formatodate-time
created[gt]?string

Fecha de creación (ISO 8601). Estrictamente mayor que el valor dado.

Formatodate-time
created[lt]?string

Fecha de creación (ISO 8601). Estrictamente menor que el valor dado.

Formatodate-time
price[gte]?number

Precio unitario. Mayor o igual que el valor dado.

price[lte]?number

Precio unitario. Menor o igual que el valor dado.

price[gt]?number

Precio unitario. Estrictamente mayor que el valor dado.

price[lt]?number

Precio unitario. Estrictamente menor que el valor dado.

in_stock?boolean

Filtra por productos con stock disponible (true → stock > 0) o sin stock (false → stock = 0). Coincidencia exacta en in_stock.

low_stock?boolean

Filtra por productos con stock bajo (true → 0 < stock ≤ umbral configurado) o con stock amplio (false → stock > umbral). Coincidencia exacta en low_stock.

tag?string

Filtra por etiqueta de clasificación. Admite múltiples valores con tag[in]. Coincidencia exacta en tag.

tag[in]?string

Filtra por etiqueta de clasificación. Admite múltiples valores con tag[in]. Lista separada por comas. Coincide cualquiera de los valores.

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

{
  "data": [
    {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a09",
      "object": "product",
      "name": "Teclado mecánico RGB",
      "sku": "KEY-RGB-01",
      "price": "1234.56",
      "currency": "EUR",
      "tax_rate": {
        "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0f",
        "rate": 21
      },
      "stock": 120,
      "gallery": [
        {
          "index": 0,
          "url": "https://files.factuarea.com/products/key-rgb-01-front.jpg",
          "content_type": "image/jpeg"
        }
      ],
      "video": {
        "url": "https://files.factuarea.com/products/key-rgb-01-demo.mp4",
        "content_type": "video/mp4"
      },
      "is_active": true,
      "description": "Teclado mecánico retroiluminado RGB con switches Cherry MX Red y carcasa de aluminio.",
      "tags": [
        "periféricos",
        "gaming"
      ],
      "low_stock_threshold": 10,
      "is_low_stock": false,
      "is_in_stock": true,
      "specifications": {
        "switch": "Cherry MX Red",
        "layout": "ES",
        "conexion": "USB-C"
      },
      "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"
    }
  ],
  "has_more": true,
  "next_cursor": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0c"
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No se ha proporcionado una API key válida en el header Authorization.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido para esta operación.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid",
    "message": "El campo `name` es obligatorio y no puede estar vacío.",
    "param": "name",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid",
    "request_id": "req_01HKQS5NGS8Z3T6Q1D2E7FYVSI"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
  }
}

Sube una imagen de galería a un producto

Adjunta una imagen (jpeg, png, jpg, gif o webp; hasta 3 MB) a la galería del producto. Devuelve el producto actualizado. Falla con 422 si se supera el límite de la galería.

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.