Tiendanube - Obtener Clientes

Descripcion

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.

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
customer_id	string	No	ID del cliente especifico
q	string	No	Buscar por nombre, email o telefono
created_at_min	string	No	Fecha creacion minima
created_at_max	string	No	Fecha creacion maxima
updated_at_min	string	No	Fecha actualizacion minima
updated_at_max	string	No	Fecha actualizacion maxima
per_page	number	No	Resultados por pagina (default: 50)
page	number	No	Numero de pagina (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: Direccion principal
• billing_address: Direccion de facturacion
• accepts_marketing: Acepta marketing
• total_spent: Total gastado
• orders_count: Numero de pedidos
• created_at: Fecha de creacion

Ejemplo de Uso

Obtener cliente por ID

{
  "customer_id": "12345"
}

Buscar por email

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

Clientes del ultimo mes

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

API Utilizada

• Endpoint: GET /v1/{store_id}/customers
• Documentacion: Tiendanube Customers API

Notas

• El parametro q busca en nombre, email y telefono
• Los clientes incluyen informacion de direcciones guardadas
• total_spent es el monto total de compras del cliente
• orders_count es el numero de pedidos realizados

Nodos Relacionados

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