Shopify - Obtener Clientes

Descripcion

Este modulo permite consultar clientes de tu tienda Shopify, ya sea un cliente especifico por ID o una lista con busqueda por email, nombre u otros criterios.

Configuracion

Campo	Tipo	Requerido	Descripcion
credentials_id	string	Si	ID de las credenciales de Shopify
customer_id	number	No	ID de cliente especifico
query	string	No	Busqueda por email, nombre, etc.
created_at_min	string	No	Creado desde (ISO 8601)
created_at_max	string	No	Creado hasta (ISO 8601)
updated_at_min	string	No	Actualizado desde (ISO 8601)
updated_at_max	string	No	Actualizado hasta (ISO 8601)
limit	number	No	Limite de resultados (max 250)
since_id	number	No	Clientes con ID mayor a este
fields	string	No	Campos a devolver

Credenciales

Este modulo requiere credenciales de tipo Shopify.

Campo	Descripcion
shop_domain	Dominio de la tienda (mi-tienda.myshopify.com)
access_token	Token de acceso de la Admin API

Sintaxis de Query

Busqueda	Ejemplo
Por email	email:cliente@ejemplo.com
Por nombre	first_name:Juan
Por apellido	last_name:Garcia
Por telefono	phone:+34600000000
Por pais	country:Spain
Texto libre	Juan Garcia (busca en todos los campos)

Salida

{
  "success": true,
  "customers": [
    {
      "id": 123456789,
      "email": "cliente@ejemplo.com",
      "first_name": "Juan",
      "last_name": "Garcia",
      "phone": "+34600000000",
      "orders_count": 5,
      "total_spent": "450.00",
      "created_at": "2024-01-15T10:30:00-05:00",
      "addresses": [],
      "tags": "vip, newsletter"
    }
  ],
  "total": 25,
  "filters_applied": {}
}

Ejemplo de Uso

Obtener cliente por ID

{
  "credentials_id": "shopify_tienda",
  "customer_id": 123456789
}

Buscar por email

{
  "credentials_id": "shopify_tienda",
  "query": "email:cliente@ejemplo.com"
}

Clientes nuevos este mes

{
  "credentials_id": "shopify_tienda",
  "created_at_min": "2024-01-01T00:00:00Z",
  "limit": 100
}

Notas

• La busqueda por query es case-insensitive
• El limite maximo por peticion es 250 clientes
• Para paginacion, usa since_id con el ID del ultimo cliente

Nodos relacionados

• ShopifyCreateCustomer - Crear nuevos clientes
• ShopifyUpdateCustomer - Actualizar datos de un cliente existente
• ShopifyGetOrders - Obtener pedidos (filtrable por cliente)