VeriHub
Documentación TeamLeader
Integración TeamLeader × VeriHub
Guía completa para conectar tu CRM TeamLeader con VeriHub y automatizar tu facturación según la normativa VeriFacTu española
📋 Índice
🚀 1. Instalación y Conexión
Paso 1: Acceder a la Integración
Ve a nuestra página de integración TeamLeader:
Paso 2: Iniciar Conexión
- Haz clic en el botón "🏢 Conectar TeamLeader"
- Serás redirigido a la página de autorización de TeamLeader
- Inicia sesión con tu cuenta de TeamLeader si no lo has hecho
- Revisa y acepta los permisos solicitados
- Confirma la autorización
Paso 3: Verificar Conexión
Una vez completada la autorización, serás redirigido de vuelta a VeriHub donde verás:
- ✅ Estado "TeamLeader Conectado"
- 📊 Información de tu cuenta TeamLeader
- 🔄 Opciones de sincronización disponibles
🔐 2. Permisos y Autorización
Permisos Solicitados
📖 Permisos de Lectura
- • contacts.read: Leer contactos y empresas
- • deals.read: Leer deals y oportunidades
- • invoices.read: Leer facturas existentes
✏️ Permisos de Escritura
- • contacts.write: Crear/actualizar contactos
- • deals.write: Actualizar deals
- • invoices.write: Crear facturas
- • webhooks.write: Gestionar webhooks
⚠️ ¿Por qué necesitamos estos permisos?
Los permisos de lectura nos permiten sincronizar tus datos existentes. Los permisos de escritura son necesarios para crear facturas VeriFacTu automáticamente cuando ganas deals y para actualizar el estado de las mismas en TeamLeader.
⚙️ 3. Configuración Inicial
Mapeo de Campos Personalizados
Para que la integración funcione correctamente, es importante configurar estos campos personalizados en TeamLeader:
| Campo TeamLeader | Propósito | Requerido |
|---|---|---|
| NIF/CIF | Identificación fiscal del contacto | Obligatorio |
| VeriFacTu CSV | Código de verificación AEAT | Automático |
| Estado Factura | Estado de la factura en AEAT | Automático |
Configuración de Fases de Deal
Configure qué fases de Deal deben generar facturas automáticamente:
- "Won" (Ganado): Se genera factura automáticamente
- "Ready to Invoice": Si existe, también genera factura
- Fases personalizadas: Configurable desde el dashboard
🔄 4. Sincronización de Datos
Sincronización Automática
Una vez conectado, VeriHub sincroniza automáticamente:
TeamLeader → VeriHub
- ✓ Contactos y empresas
- ✓ Direcciones y datos fiscales
- ✓ Deals ganados
- ✓ Cambios en tiempo real (webhooks)
VeriHub → TeamLeader
- ✓ Facturas creadas
- ✓ CSV y códigos VeriFacTu
- ✓ Estados de facturación
- ✓ Errores y notificaciones
Sincronización Manual
También puedes forzar sincronizaciones manuales:
Acciones Disponibles:
- 🔄 Sincronizar Ahora: Sincroniza todos los datos pendientes
- 👥 Importar Contactos: Importa contactos específicos
- 💼 Importar Deals: Convierte deals seleccionados en facturas
📄 5. Facturación Automática
Flujo Automático
Mapeo de Datos
| Dato TeamLeader | Campo VeriHub |
|---|---|
| Deal Title | Descripción del concepto |
| Deal Value | Precio unitario |
| Contact/Company | Cliente de la factura |
| Deal ID | Referencia interna |
🪝 6. Webhooks y Notificaciones
Webhooks Configurados
VeriHub registra automáticamente estos webhooks en tu cuenta TeamLeader:
📞 Contactos
- • contact.added
- • contact.updated
💼 Deals
- • deal.updated
- • deal.won
- • deal.lost
🏢 Empresas
- • company.added
- • company.updated
📄 Facturas
- • invoice.sent
- • invoice.paid
🔧 7. Solución de Problemas
Problemas Comunes
❌ "Error 401 - No autorizado"
Causa: Token de acceso expirado o inválido
Solución: Desconecta y vuelve a conectar TeamLeader desde el dashboard
⚠️ "Contacto sin NIF/CIF"
Causa: El contacto no tiene campo NIF/CIF configurado
Solución: Añade el NIF/CIF en TeamLeader y vuelve a sincronizar
ℹ️ "Sincronización lenta"
Causa: Gran volumen de datos o límites de API
Solución: La sincronización se realiza por lotes, ten paciencia
¿Necesitas más ayuda?
Si no encuentras la solución a tu problema, nuestro equipo de soporte está disponible para ayudarte.