Tiendanube - Obtener Productos

↩ Parte de la integración Tiendanube.

Descripción

Este modulo permite consultar los productos de una tienda Tiendanube. Puede obtener un producto especifico por ID o listar productos con diversos filtros como categoría, estado de publicación, fechas y mas.

Configuración

Credenciales Requeridas

• Store ID: ID de tu tienda (visible en la URL del panel)
• Access Token: Token de acceso OAuth2

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credential	Si	Credenciales de Tiendanube
product_id	string	No	ID del producto especifico
category_id	string	No	Filtrar por categoría
published	select	No	Estado de publicación
free_shipping	select	No	Con/sin envío gratis
created_at_min	string	No	Fecha creación minima
created_at_max	string	No	Fecha creación maxima
sort_by	select	No	Ordenamiento
per_page	number	No	Resultados por página (default: 50)
page	number	No	Número de página (default: 1)

Salida

{
  "success": true,
  "products": [...],
  "count": 50,
  "page": 1,
  "per_page": 50,
  "message": "50 productos obtenidos"
}

Campos de Producto

• id: ID del producto
• name: Objeto con nombre por idioma (es, pt)
• description: Objeto con descripción por idioma
• handle: URL amigable por idioma
• variants: Array de variantes
• images: Array de imagenes
• categories: Array de categorías
• brand: Marca
• published: Estado de publicación
• free_shipping: Envío gratis
• created_at: Fecha de creación
• updated_at: Fecha de actualización

Ejemplo de Uso

Obtener producto por ID

{
  "product_id": "12345678"
}

Productos publicados de una categoría

{
  "category_id": "123",
  "published": "true",
  "sort_by": "created_at-desc"
}

Productos con envío gratis

{
  "free_shipping": "true",
  "per_page": 100
}

API Utilizada

• Endpoint: GET /v1/{store_id}/products
• Documentación: Tiendanube API

Notas

• Los campos de texto (name, description) son objetos multilingues
• El idioma principal depende del pais de la tienda (es para Latinoamerica, pt para Brasil)
• Cada producto puede tener múltiples variantes con precios y stock independientes
• El limite máximo por página es 200 productos

Nodos Relacionados

• TiendanubeCreateProduct - Crear un nuevo producto
• TiendanubeUpdateProduct - Actualizar datos de un producto
• TiendanubeGetOrders - Obtener pedidos que incluyen productos