Tiendanube - Crear Cliente

↩ Parte de la integración Tiendanube.

Descripción

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

Configuración

Credenciales Requeridas

• Store ID: ID de tu tienda
• Access Token: Token de acceso OAuth2

Parámetros

Parámetro	Tipo	Requerido	Descripción
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	Número
floor	string	No	Piso/Departamento
city	string	No	Ciudad
province	string	No	Provincia/Estado
zipcode	string	No	Código postal
country	string	No	Código 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 básico

{
  "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 dirección

{
  "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
• Documentación: Tiendanube Customers API

Notas

• El email debe ser único 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 recibirá emails promocionales

Nodos Relacionados

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