Tiendanube - Obtener Pedidos

↩ Parte de la integración Tiendanube.

Descripción

Este modulo permite consultar los pedidos de una tienda Tiendanube. Puede obtener un pedido especifico por ID o listar pedidos con diversos filtros como estado, cliente, pago, envío y fechas.

Configuración

Credenciales Requeridas

• Store ID: ID de tu tienda
• Access Token: Token de acceso OAuth2

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credential	Si	Credenciales de Tiendanube
order_id	string	No	ID del pedido especifico
status	select	No	Estado: open, closed, cancelled
payment_status	select	No	Estado de pago
shipping_status	select	No	Estado de envío
customer_id	string	No	ID del cliente
q	string	No	Buscar por número, email o nombre
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)

Estados de Pago

• pending: Pendiente
• authorized: Autorizado
• paid: Pagado
• abandoned: Abandonado
• refunded: Reembolsado
• voided: Anulado

Estados de Envío

• unpacked: Sin empacar
• unfulfilled: Sin enviar
• shipped: Enviado
• delivered: Entregado

Salida

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

Campos de Pedido

• id: ID del pedido
• number: Número del pedido
• status: Estado general
• payment_status: Estado de pago
• shipping_status: Estado de envío
• customer: Datos del cliente
• products: Productos del pedido
• total: Total del pedido
• subtotal: Subtotal
• shipping: Costo de envío
• discount: Descuento aplicado
• shipping_address: Dirección de envío
• billing_address: Dirección de facturación

Ejemplo de Uso

Obtener pedido por ID

{
  "order_id": "123456"
}

Pedidos pendientes de pago

{
  "payment_status": "pending",
  "sort_by": "created_at-desc"
}

Pedidos de un cliente

{
  "customer_id": "789",
  "per_page": 100
}

Pedidos sin enviar

{
  "shipping_status": "unfulfilled",
  "status": "open"
}

API Utilizada

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

Notas

• Los pedidos incluyen información completa de productos y direcciones
• El campo number es el número visible para el cliente
• Los precios estan en la moneda de la tienda
• Se pueden combinar múltiples filtros

Nodos Relacionados

• TiendanubeUpdateOrder - Actualizar estado o tracking de un pedido
• TiendanubeGetCustomers - Obtener datos del cliente del pedido
• TiendanubeGetProducts - Obtener datos de los productos del pedido