Tiendanube - Obtener Clientes

↩ Parte de la integración Tiendanube.

Descripción

Este modulo permite consultar la base de clientes de una tienda Tiendanube. Puede obtener un cliente especifico por ID o listar clientes con filtros de busqueda 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
customer_id	string	No	ID del cliente especifico
q	string	No	Buscar por nombre, email o telefono
created_at_min	string	No	Fecha creación minima
created_at_max	string	No	Fecha creación maxima
updated_at_min	string	No	Fecha actualización minima
updated_at_max	string	No	Fecha actualización maxima
per_page	number	No	Resultados por página (default: 50)
page	number	No	Número de página (default: 1)

Salida

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

Campos de Cliente

• id: ID del cliente
• name: Nombre completo
• email: Email
• phone: Telefono
• identification: Documento de identidad (DNI/CUIT/CPF)
• note: Nota interna
• default_address: Dirección principal
• billing_address: Dirección de facturación
• accepts_marketing: Acepta marketing
• total_spent: Total gastado
• orders_count: Número de pedidos
• created_at: Fecha de creación

Ejemplo de Uso

Obtener cliente por ID

{
  "customer_id": "12345"
}

Buscar por email

{
  "q": "cliente@email.com"
}

Clientes del último mes

{
  "created_at_min": "2024-01-01",
  "created_at_max": "2024-01-31"
}

API Utilizada

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

Notas

• El parámetro q busca en nombre, email y telefono
• Los clientes incluyen información de direcciones guardadas
• total_spent es el monto total de compras del cliente
• orders_count es el número de pedidos realizados

Nodos Relacionados

• TiendanubeCreateCustomer - Crear un nuevo cliente
• TiendanubeUpdateCustomer - Actualizar datos de un cliente
• TiendanubeGetOrders - Obtener pedidos de un cliente