Tiendanube - Obtener Pedidos

Descripcion

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, envio y fechas.

Configuracion

Credenciales Requeridas

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

Parametros

Parametro	Tipo	Requerido	Descripcion
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 envio
customer_id	string	No	ID del cliente
q	string	No	Buscar por numero, email o nombre
created_at_min	string	No	Fecha creacion minima
created_at_max	string	No	Fecha creacion maxima
sort_by	select	No	Ordenamiento
per_page	number	No	Resultados por pagina (default: 50)
page	number	No	Numero de pagina (default: 1)

Estados de Pago

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

Estados de Envio

• 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: Numero del pedido
• status: Estado general
• payment_status: Estado de pago
• shipping_status: Estado de envio
• customer: Datos del cliente
• products: Productos del pedido
• total: Total del pedido
• subtotal: Subtotal
• shipping: Costo de envio
• discount: Descuento aplicado
• shipping_address: Direccion de envio
• billing_address: Direccion de facturacion

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
• Documentacion: Tiendanube Orders API

Notas

• Los pedidos incluyen informacion completa de productos y direcciones
• El campo number es el numero visible para el cliente
• Los precios estan en la moneda de la tienda
• Se pueden combinar multiples 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