Esta es la documentación BOT Clientify – Hispatec para el plugin de integración entre ambas plataformas.
Entidades a conectar
La integración permite sincronizar las siguientes entidades desde Hispatec hacia Clientify:
- Contactos (#Contactos) → Contactos Clientify
- Empresas (#Empresas) → Empresas Clientify
Sincronización unidireccional
- Contactos: Hispatec → Clientify
- Empresas: Hispatec → Clientify
Nota: Esta integración es unidireccional, solo sincroniza datos desde Hispatec hacia Clientify.
Campos por entidad
Contactos Hispatec → Contactos Clientify
La integración mapea los campos de Hispatec a Clientify mediante un sistema de preparación de campos personalizados.
| Campo Hispatec | Campo Clientify | Observaciones |
|---|---|---|
Nombre | first_name | Nombre del contacto |
Apellidos | last_name | Apellidos del contacto |
IdentificacionFiscalCliente | taxpayer_identification_number | NIF/CIF del cliente |
Email | email | Email principal |
Telefono | phones[0].phone | Teléfono principal |
Direccion | addresses[0].address | Dirección |
Poblacion | addresses[0].city | Ciudad |
CodigoPostal | addresses[0].postal_code | Código postal |
| – | tags | Se añade automáticamente la etiqueta «hispatec» |
Empresas Hispatec → Empresas Clientify
| Campo Hispatec | Campo Clientify | Observaciones |
|---|---|---|
RazonSocial | name | Razón social |
CIF | taxpayer_identification_number | CIF de la empresa |
Email | email | Email principal |
Telefono | phones[0].phone | Teléfono principal |
Direccion | addresses[0].address | Dirección |
Poblacion | addresses[0].city | Ciudad |
CodigoPostal | addresses[0].postal_code | Código postal |
Mecanismo de sincronización
Proceso de sincronización
- Autenticación: Se genera un token de autenticación con Hispatec.
- Obtención de datos: Se obtienen contactos y empresas desde Hispatec.
- Preparación de campos: Los campos se preparan y normalizan.
- Validación: Se valida que los datos cumplan los requisitos mínimos.
- Búsqueda en Clientify: Se busca si existe un contacto/empresa con el mismo NIF/CIF.
- Creación o actualización: Si existe, se actualiza; si no, se crea uno nuevo.
Campos personalizados
La integración crea automáticamente campos personalizados en Clientify basándose en los campos de Hispatec que no tienen un mapeo directo.
Validación de datos
Antes de crear o actualizar un registro, se validan:
- Que tenga nombre o razón social
- Que tenga NIF/CIF válido
- Que cumpla con las reglas de creación/actualización
Proceso de conexión
Credenciales necesarias
Para configurar la integración se necesitan las siguientes credenciales:
- URL: URL del servidor de Hispatec
- Usuario: Usuario de Hispatec
- Password: Contraseña de Hispatec
Configuración en Clientify
- Acceder a la pestaña de Integraciones en Clientify
- Seleccionar la tarjeta de Hispatec
- Rellenar los campos:
- URL
- Usuario
- Password
- Guardar la configuración
Campos personalizados automáticos
Al configurar la integración, se crean automáticamente los campos personalizados necesarios en Clientify si no existen.
Compatibilidad
Versiones de Hispatec
La integración funciona con la API SOAP de Hispatec.
Requisitos
- Servidor de Hispatec accesible
- Usuario y contraseña válidos
- Acceso a los métodos SOAP:
CLI512_LeerCLientes: Para obtener empresas- Método por defecto: Para obtener contactos
Notas importantes
- Preparación de campos: Los campos se preparan automáticamente, normalizando valores vacíos y preparando campos personalizados.
- Cálculo de tipo de contacto: Se calcula automáticamente el tipo de contacto basándose en los datos disponibles.
- Etiquetas automáticas: Todos los contactos sincronizados reciben automáticamente la etiqueta «hispatec».
- Manejo de valores vacíos: Los valores vacíos se eliminan antes de sincronizar.
- Validación de CIF: Si el contacto no tiene CIF en el campo principal, se intenta obtener del campo personalizado
IdentificacionFiscalCliente.
