BigCommerce - Obtener Productos

↩ Parte de la integración BigCommerce.

Descripción

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 categoría, marca, visibilidad, rango de precios y stock.

Configuración

Credenciales Requeridas

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

Parámetros

Parámetro	Tipo	Requerido	Descripción
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 categorías 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 mínimo
price_max	number	No	Precio máximo
inventory_level_min	number	No	Stock mínimo
inventory_level_max	number	No	Stock máximo
sort	select	No	Ordenamiento
limit	number	No	Limite de resultados (default: 50)
page	number	No	Página 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 categorías
• 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 categoría

{
  "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
• Documentación: BigCommerce Catalog API

Notas

• Utiliza la API V3 de BigCommerce para productos
• Los productos se ordenan por fecha de modificación por defecto
• El limite máximo por página es 250 productos
• Para busquedas por SKU, el valor debe ser exacto

Nodos Relacionados

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