03. Clientes
En esta sección puedes configurar cómo se crean y sincronizan los clientes entre Shopify y Siigo.
Comportamiento de sincronización de clientes
Actualizar información del cliente
Cuando esta activo, la información del cliente en Siigo se actualiza cada vez que se crea una factura. Útil para mantener los datos del cliente al día si el comprador ha actualizado su información en Shopify.
Nota: En Siigo, una vez que una factura ha sido creada no es posible modificar el tercero asociado. La actualización del cliente aplica únicamente al momento de crear la factura, no de manera retroactiva.
Usar cliente genérico
Cuando esta activo, se usa un cliente genérico en Siigo cuando los datos del cliente no están disponibles en el pedido (por ejemplo, pedidos sin identificación tributaria). El cliente genérico usa el NIT 222222222222.
Importante: El cliente genérico (222222222222) debe existir previamente en tu cuenta de Siigo. Si no existe, la factura fallara. Debes crearlo manualmente en Siigo antes de activar esta opción.
Sucursal predeterminada del cliente
Define en que sucursal de Siigo se crearan los clientes nuevos.
Campos requeridos
Requerir dirección del cliente
Cuando esta activo, la dirección del cliente es obligatoria para crear el cliente en Siigo. Si el pedido no tiene dirección, la factura fallara.
Nota: La dirección solo se envía a Siigo para clientes colombianos. Para clientes de otros países, el cliente se crea sin dirección. La dirección se convierte a mayúsculas, tiene un limite de 256 caracteres y se resuelve automáticamente con códigos DANE para ciudad y departamento.
Requerir teléfono del cliente
Cuando esta activo, el número de teléfono del cliente es obligatorio para crear el cliente en Siigo. Si el pedido no tiene teléfono, la factura fallara.
Nota: El número de teléfono se limpia automáticamente a solo dígitos y se toman los últimos 10. Si el numero incluye código de país (por ejemplo, +57), este se remueve automáticamente.
Importante: El correo electrónico del cliente es obligatorio para crear un cliente en Siigo. Si el pedido no tiene correo del cliente, la factura fallara.
Configuración de identificación tributaria
Usar campo de empresa del checkout
Cuando esta activo, la integración obtiene el número de identificación tributaria del campo "empresa" en la dirección de facturación del checkout de Shopify. Para ventas POS, también consulta el campo de empresa de la dirección por defecto del cliente.
El sistema limpia automáticamente el valor ingresado: extrae solo los dígitos y remueve caracteres no numéricos como guiones y puntos (por ejemplo, "900.123.456-7" se convierte en "9001234567").
Importante: El numero de documento se debe ingresar sin digito de verificación. Si el NIT es 900123456-7, el cliente debe ingresar solo 900123456. Si ingresa "900123456-7", la aplicación quitara el guion pero dejara el 7, resultando en "9001234567", lo cual es un numero de documento incorrecto.
Metafield de identificación tributaria
Clave del metafield del cliente en Shopify donde se almacena el numero de identificación tributaria. El formato debe ser namespace.key (por defecto: custom.tax_id).
Metafield de tipo de identificación
Clave del metafield del cliente en Shopify donde se almacena el tipo de identificación tributaria. El formato es el mismo: namespace.key (por defecto: custom.tax_id_type).
Los tipos de documento soportados son:
| Código | Tipo de documento |
|---|---|
| CC | Cedula de Ciudadanía |
| NIT | Numero de Identificación Tributaria |
| CE | Cedula de Extranjería |
| TI | Tarjeta de Identidad |
| RC | Registro Civil |
| PASSPORT | Pasaporte |
| DIE | Documento de Identificación Extranjero |
| TE | Tarjeta de Extranjería |
| FOREIGN_NIT | Sin identificación del exterior |
| NUIP | Numero Único de Identificación Personal |
Prioridad de resolución
El sistema sigue este orden para obtener el documento de identificación:
- Metafield de documento (si esta configurado y tiene valor)
- Campo de empresa del checkout (como respaldo, si esta activado)
Si no se encuentra un documento de identificación, el comportamiento depende de la configuración de cliente genérico.
Nota: Si no se especifica tipo de documento, se asume CC (Cedula de Ciudadanía) por defecto.
Mapeos de tipos de identificación tributaria
Permite mapear los valores del tipo de identificación que llegan desde Shopify a los tipos de identificación validos en Siigo.
Por ejemplo, si en Shopify el cliente registra su tipo de documento como "Cédula", "cedula" o "CC", puedes mapear todos esos valores al tipo Cedula de Ciudadanía en Siigo.
El mapeo es insensible a mayúsculas y minúsculas. También puedes definir un mapeo por defecto que se usara cuando el valor no coincida con ningún mapeo configurado.
Para agregar un mapeo:
- Escribe el valor externo en el campo de texto (ej.
Cedula,CC) - Haz clic en Agregar
- Selecciona el tipo de identificación correspondiente en Siigo
- El estado cambiara a Configurado
Para eliminar un mapeo, haz clic en Eliminar en la fila correspondiente.
Nota: Cuando llega un valor nuevo desde el metafield que no tiene mapeo configurado, la integración crea automáticamente el mapeo sin valor asignado. Debes entrar a la configuración de clientes y asignar el tipo de documento correcto para ese mapeo.