BigCommerce - Obtener Productos

Descripcion

Este modulo permite consultar productos de una tienda BigCommerce. Puede obtener un producto especifico por ID o SKU, o listar productos con diversos filtros como categoria, marca, visibilidad, rango de precios y stock.

Configuracion

Credenciales Requeridas

• Store Hash: Hash unico de tu tienda BigCommerce (visible en la URL del panel de control)
• Access Token: Token de acceso de la API V3

Parametros

Parametro	Tipo	Requerido	Descripcion
credentials_id	credential	Si	Credenciales de BigCommerce
product_id	number	No	ID del producto especifico
sku	string	No	SKU del producto
name	string	No	Buscar por nombre (parcial)
categories	string	No	IDs de categorias separados por coma
brand_id	number	No	ID de la marca
is_visible	boolean	No	Filtrar por visibilidad
availability	select	No	Disponibilidad: available, disabled, preorder
price_min	number	No	Precio minimo
price_max	number	No	Precio maximo
inventory_level_min	number	No	Stock minimo
inventory_level_max	number	No	Stock maximo
sort	select	No	Ordenamiento
limit	number	No	Limite de resultados (default: 50)
page	number	No	Pagina de resultados (default: 1)

Salida

{
  "success": true,
  "products": [...],
  "total": 150,
  "total_pages": 3,
  "current_page": 1,
  "message": "25 productos obtenidos"
}

Campos de Producto

• id: ID del producto
• name: Nombre del producto
• sku: SKU
• price: Precio
• sale_price: Precio de oferta
• retail_price: Precio de venta
• weight: Peso
• inventory_level: Stock disponible
• is_visible: Visibilidad
• categories: Array de IDs de categorias
• brand_id: ID de la marca
• custom_url: URL personalizada
• images: Array de imagenes

Ejemplo de Uso

Obtener producto por ID

{
  "product_id": 123
}

Buscar productos por categoria

{
  "categories": "18,19",
  "is_visible": true,
  "limit": 100
}

Filtrar por rango de precios

{
  "price_min": 10,
  "price_max": 100,
  "sort": "price:asc"
}

API Utilizada

• Endpoint: GET /stores/{store_hash}/v3/catalog/products
• Documentacion: BigCommerce Catalog API

Notas

• Utiliza la API V3 de BigCommerce para productos
• Los productos se ordenan por fecha de modificacion por defecto
• El limite maximo por pagina es 250 productos
• Para busquedas por SKU, el valor debe ser exacto

Nodos Relacionados

• BigcommerceCreateProduct - Crear producto
• BigcommerceUpdateProduct - Actualizar producto
• BigcommerceGetOrders - Obtener pedidos