Tiendanube - Crear Cliente

Descripcion

Este modulo permite registrar nuevos clientes en una tienda Tiendanube con sus datos personales, preferencias de marketing y opcionalmente una direccion por defecto.

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
email	string	Si	Email del cliente
name	string	Si	Nombre completo
phone	string	No	Telefono
identification	string	No	DNI/CUIT/CPF
note	string	No	Nota interna
accepts_marketing	boolean	No	Acepta recibir marketing
address	string	No	Calle
number	string	No	Numero
floor	string	No	Piso/Departamento
city	string	No	Ciudad
province	string	No	Provincia/Estado
zipcode	string	No	Codigo postal
country	string	No	Codigo de pais (AR, BR, MX, etc.)

Salida

{
  "success": true,
  "customer": {...},
  "customer_id": 12345,
  "email": "cliente@email.com",
  "message": "Cliente 12345 creado correctamente"
}

Ejemplo de Uso

Crear cliente basico

{
  "email": "juan@email.com",
  "name": "Juan Perez"
}

Crear cliente con telefono y marketing

{
  "email": "maria@email.com",
  "name": "Maria Garcia",
  "phone": "+54 11 1234-5678",
  "identification": "12345678",
  "accepts_marketing": true
}

Crear cliente con direccion

{
  "email": "carlos@email.com",
  "name": "Carlos Lopez",
  "phone": "+54 11 9876-5432",
  "address": "Av. Corrientes",
  "number": "1234",
  "floor": "5to B",
  "city": "Buenos Aires",
  "province": "Buenos Aires",
  "zipcode": "1043",
  "country": "AR"
}

API Utilizada

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

Notas

• El email debe ser unico en la tienda
• Los codigos de pais son ISO 3166-1 alfa-2 (AR, BR, MX, CL, CO, etc.)
• El campo identification almacena el documento de identidad local
• Si accepts_marketing: true, el cliente recibira emails promocionales

Nodos Relacionados

• TiendanubeGetCustomers - Obtener clientes existentes
• TiendanubeUpdateCustomer - Actualizar datos de un cliente
• TiendanubeGetOrders - Obtener pedidos de un cliente