Shopify - Crear Cliente

Descripcion

Este modulo permite crear clientes en tu tienda Shopify con informacion de contacto, direccion y configuracion de cuenta.

Configuracion

Campo	Tipo	Requerido	Descripcion
credentials_id	string	Si	ID de las credenciales de Shopify
email	string	Si	Email del cliente
first_name	string	No	Nombre
last_name	string	No	Apellido
phone	string	No	Telefono (formato E.164)
tags	string	No	Tags separados por coma
note	string	No	Notas internas
verified_email	boolean	No	Marcar email como verificado (default: true)
send_email_welcome	boolean	No	Enviar email de bienvenida (default: false)
tax_exempt	boolean	No	Exento de impuestos (default: false)
address1	string	No	Direccion linea 1
address2	string	No	Direccion linea 2
city	string	No	Ciudad
province	string	No	Provincia/Estado
country	string	No	Pais
country_code	string	No	Codigo de pais (ES, US, etc.)
zip	string	No	Codigo postal
company	string	No	Empresa

Credenciales

Este modulo requiere credenciales de tipo Shopify. Los campos necesarios son:

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

Permisos Requeridos

• write_customers - Escritura de clientes

Salida

{
  "success": true,
  "customer": {
    "id": 123456789,
    "email": "cliente@ejemplo.com",
    "first_name": "Juan",
    "last_name": "Garcia",
    "...": "otros campos"
  },
  "customer_id": 123456789,
  "message": "Cliente \"cliente@ejemplo.com\" creado correctamente"
}

Ejemplo de Uso

Cliente basico

{
  "credentials_id": "shopify_tienda",
  "email": "nuevo@cliente.com",
  "first_name": "Juan",
  "last_name": "Garcia"
}

Cliente con direccion

{
  "credentials_id": "shopify_tienda",
  "email": "cliente@ejemplo.com",
  "first_name": "Maria",
  "last_name": "Lopez",
  "phone": "+34600000000",
  "address1": "Calle Mayor 123",
  "address2": "Piso 4B",
  "city": "Madrid",
  "province": "Madrid",
  "country": "Spain",
  "country_code": "ES",
  "zip": "28001"
}

Cliente empresa (B2B)

{
  "credentials_id": "shopify_tienda",
  "email": "compras@empresa.com",
  "first_name": "Departamento",
  "last_name": "Compras",
  "company": "Empresa S.L.",
  "phone": "+34910000000",
  "tax_exempt": true,
  "tags": "b2b, mayorista",
  "note": "Cliente mayorista - descuento 20%"
}

Cliente con email de bienvenida

{
  "credentials_id": "shopify_tienda",
  "email": "nuevo@cliente.com",
  "first_name": "Pedro",
  "last_name": "Sanchez",
  "send_email_welcome": true,
  "verified_email": true,
  "tags": "newsletter, nuevo"
}

Workflows de Ejemplo

Registro desde formulario web

[Webhook Form] -> [Validar datos] -> [ShopifyCreateCustomer] -> [Email confirmacion]

Importacion masiva

[Leer CSV] -> [Loop] -> [ShopifyCreateCustomer] -> [Log resultados]

Sincronizacion con CRM

[Webhook CRM] -> [Verificar existe] -> [ShopifyCreateCustomer] -> [Actualizar CRM]

Uso con ExecuteScript

// Preparar datos del cliente desde formulario
const form = ctx.data.formulario;

ctx.data = {
  email: form.email.toLowerCase().trim(),
  first_name: form.nombre,
  last_name: form.apellido,
  phone: form.telefono ? `+34${form.telefono}` : undefined,
  address1: form.direccion,
  city: form.ciudad,
  province: form.provincia,
  country: "Spain",
  country_code: "ES",
  zip: form.cp,
  tags: form.newsletter ? "newsletter" : "",
  send_email_welcome: true
};

Formato de Telefono

Shopify requiere el formato E.164 para telefonos:

Pais	Formato	Ejemplo
Espana	+34XXXXXXXXX	+34600123456
Mexico	+52XXXXXXXXXX	+525512345678
Argentina	+54XXXXXXXXXXX	+5491112345678
Colombia	+57XXXXXXXXXX	+573001234567
USA	+1XXXXXXXXXX	+12025551234

Errores Comunes

Error	Causa	Solucion
”Email has already been taken”	Email ya existe	Usar ShopifyUpdateCustomer
”Phone is invalid”	Formato incorrecto	Usar formato E.164
”Country code is invalid”	Codigo de pais	Usar codigos ISO (ES, US, MX)

Notas

• El email debe ser unico en la tienda
• Si el email ya existe, usa ShopifyUpdateCustomer en su lugar
• El campo verified_email evita que Shopify envie email de verificacion
• Los tags son utiles para segmentar clientes en campanas de marketing

Nodos relacionados

• ShopifyGetCustomers - Obtener y buscar clientes existentes
• ShopifyUpdateCustomer - Actualizar datos de un cliente existente
• ShopifyGetOrders - Obtener pedidos (filtrable por cliente)