BigCommerce - Obtener Clientes

Descripcion

Este modulo permite consultar la base de clientes de una tienda BigCommerce. Puede obtener un cliente especifico por ID o listar clientes con diversos filtros como email, nombre, empresa y grupo de clientes.

Configuracion

Credenciales Requeridas

• Store Hash: Hash unico de tu tienda BigCommerce
• Access Token: Token de acceso de la API V3

Parametros

Parametro	Tipo	Requerido	Descripcion
credentials_id	credential	Si	Credenciales de BigCommerce
customer_id	string	No	ID del cliente especifico
email	string	No	Filtrar por email
name	string	No	Buscar por nombre (parcial)
company	string	No	Buscar por empresa
customer_group_id	number	No	ID del grupo de clientes
date_created_min	string	No	Fecha de creacion minima (ISO 8601)
date_created_max	string	No	Fecha de creacion maxima (ISO 8601)
include_addresses	boolean	No	Incluir direcciones en respuesta
sort	select	No	Ordenamiento
limit	number	No	Limite de resultados (default: 50)
page	number	No	Pagina de resultados (default: 1)

Salida

{
  "success": true,
  "customers": [...],
  "total": 250,
  "total_pages": 5,
  "current_page": 1,
  "message": "50 clientes obtenidos"
}

Campos de Cliente

• id: ID del cliente
• email: Email
• first_name: Nombre
• last_name: Apellido
• company: Empresa
• phone: Telefono
• customer_group_id: ID del grupo
• date_created: Fecha de creacion
• date_modified: Fecha de modificacion
• addresses: Array de direcciones (si include_addresses=true)

Ejemplo de Uso

Obtener cliente por ID

{
  "customer_id": "123"
}

Buscar cliente por email

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

Listar clientes de un grupo

{
  "customer_group_id": 5,
  "include_addresses": true,
  "limit": 100
}

Clientes creados este mes

{
  "date_created_min": "2024-01-01T00:00:00Z",
  "date_created_max": "2024-01-31T23:59:59Z",
  "sort": "date_created:desc"
}

API Utilizada

• Endpoint: GET /stores/{store_hash}/v3/customers
• Documentacion: BigCommerce Customers API

Notas

• Utiliza la API V3 de BigCommerce para clientes
• El limite maximo por pagina es 250 clientes
• Las direcciones se incluyen solo si se solicita explicitamente
• La busqueda por nombre usa coincidencia parcial (LIKE)
• El email debe ser exacto para filtrar

Nodos Relacionados

• BigcommerceCreateCustomer - Crear cliente
• BigcommerceUpdateCustomer - Actualizar cliente
• BigcommerceGetOrders - Obtener pedidos del cliente