Magento - Obtener Clientes

Descripcion

Este modulo permite consultar clientes de tu tienda Magento 2 con filtros por email, nombre, grupo y fechas.

Configuracion

Campo	Tipo	Requerido	Descripcion
credentials_id	string	Si	ID de las credenciales
customer_id	string	No	ID del cliente especifico
email	string	No	Filtrar por email exacto
firstname	string	No	Buscar por nombre
lastname	string	No	Buscar por apellido
group_id	number	No	ID del grupo de clientes
website_id	number	No	ID del sitio web
created_at_from	string	No	Registrado desde
created_at_to	string	No	Registrado hasta
sort_field	string	No	Campo de ordenamiento
sort_direction	string	No	ASC o DESC
page_size	number	No	Clientes por pagina
current_page	number	No	Pagina actual

Credenciales

Campo	Descripcion
store_url	URL base de la tienda Magento (ej: https://mitienda.com)
access_token	Token de acceso de integracion con permisos de lectura de clientes

Grupos de Cliente por Defecto

ID	Nombre
0	NOT LOGGED IN
1	General
2	Wholesale
3	Retailer

Salida

{
  "success": true,
  "customers": [
    {
      "id": 123,
      "email": "cliente@ejemplo.com",
      "firstname": "Juan",
      "lastname": "Garcia",
      "group_id": 1,
      "website_id": 1,
      "created_at": "2024-01-15 10:30:00",
      "addresses": []
    }
  ],
  "total": 500,
  "page_size": 20,
  "current_page": 1,
  "message": "20 clientes obtenidos"
}

Ejemplo de Uso

Buscar por email

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

Clientes de un grupo

{
  "credentials_id": "magento_tienda",
  "group_id": 2,
  "page_size": 100
}

Clientes nuevos del mes

{
  "credentials_id": "magento_tienda",
  "created_at_from": "2024-01-01 00:00:00",
  "created_at_to": "2024-01-31 23:59:59"
}

Notas

• La busqueda por email es exacta
• Las direcciones estan incluidas en la respuesta
• Los grupos de cliente son personalizables en Magento

Nodos relacionados

• MagentoCreateCustomer - Crear nuevos clientes
• MagentoUpdateCustomer - Actualizar clientes existentes
• MagentoGetOrders - Obtener pedidos de clientes