Tiendanube - Get Orders

Description

This module allows querying orders from a Tiendanube store. It can get a specific order by ID or list orders with various filters such as status, customer, payment, shipping, and dates.

Configuration

Required Credentials

• Store ID: Your store ID
• Access Token: OAuth2 access token

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	Tiendanube credentials
order_id	string	No	Specific order ID
status	select	No	Status: open, closed, cancelled
payment_status	select	No	Payment status
shipping_status	select	No	Shipping status
customer_id	string	No	Customer ID
q	string	No	Search by number, email, or name
created_at_min	string	No	Minimum creation date
created_at_max	string	No	Maximum creation date
sort_by	select	No	Sorting
per_page	number	No	Results per page (default: 50)
page	number	No	Page number (default: 1)

Payment Statuses

• pending: Pending
• authorized: Authorized
• paid: Paid
• abandoned: Abandoned
• refunded: Refunded
• voided: Voided

Shipping Statuses

• unpacked: Unpacked
• unfulfilled: Unfulfilled
• shipped: Shipped
• delivered: Delivered

Output

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

Order Fields

• id: Order ID
• number: Order number
• status: General status
• payment_status: Payment status
• shipping_status: Shipping status
• customer: Customer data
• products: Order products
• total: Order total
• subtotal: Subtotal
• shipping: Shipping cost
• discount: Applied discount
• shipping_address: Shipping address
• billing_address: Billing address

Usage Example

Get order by ID

{
  "order_id": "123456"
}

Pending payment orders

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

Customer orders

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

Unshipped orders

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

API Used

• Endpoint: GET /v1/{store_id}/orders
• Documentation: Tiendanube Orders API

Notes

• Orders include full product and address information
• The number field is the number visible to the customer
• Prices are in the store’s currency
• Multiple filters can be combined

Related Nodes

• TiendanubeUpdateOrder - Update order status or tracking
• TiendanubeGetCustomers - Get order customer data
• TiendanubeGetProducts - Get order product data