Integración de portales de propiedades en Tesoro CRM

Configurar credenciales de API

Configura la integración de Idealista en 5 pasos:

1. Ve a Configuración → Integraciones → Idealista
2. Ingresa tu API key de Idealista (disponible vía cuenta Idealista Pro)
3. Ingresa tu nombre de usuario y contraseña de Idealista
4. Haz clic en 'Probar Conexión' para verificar credenciales
5. Activa 'Auto-sincronización' para activar actualizaciones automáticas

Mapeo de campos

Tesoro mapea automáticamente campos de Tesoro a campos de Idealista:

• Tipo de propiedad: Apartment → Piso, House → Casa, etc.
• Características: Pool → Piscina, Garage → Garaje
• Precio: Conversión automática de moneda
• Descripción: Soporte multi-idioma (ES/EN)
• Imágenes: Todas las imágenes sincronizadas con orden preservado

Mapeo de campos personalizado disponible en Configuración → Idealista → Mapeo de Campos.

Frecuencia de sincronización

• Sincronización en tiempo real: Cambios en Tesoro → inmediatamente a Idealista (vía API)
• Sincronización bidireccional: Actualizaciones de Idealista → Tesoro (cada 1 hora)
• Sincronización manual: Forzar sincronización vía botón 'Sincronizar Ahora'

Configuración de Fotocasa

Configuración similar a Idealista:

1. Configuración → Integraciones → Fotocasa
2. Ingresa credenciales de cuenta Fotocasa
3. Configura mapeo de campos (automático para campos estándar)
4. Activa auto-sincronización
5. Prueba con una propiedad para validación

Características específicas de Fotocasa

• Destacar propiedad: Opción para destacar propiedades en Fotocasa (característica premium)
• Posición superior: Impulsar propiedades a la parte superior de resultados de búsqueda
• Importación de estadísticas: Conteos de vistas y solicitudes de contacto de Fotocasa → Tesoro

Tiempo de sincronización

Las actualizaciones de Fotocasa no son en tiempo real pero son frecuentes:

• Propiedades nuevas: En 5-10 minutos
• Cambios de precio: En 10 minutos
• Cambios de estado (vendido/alquilado): En 15 minutos
• Actualizaciones de imágenes: En 30 minutos

Verifica estado de sincronización en Configuración → Fotocasa → Registro de Sync.

Generar feeds XML

Para portales sin integración directa de API usa feeds XML:

1. Configuración → Integraciones → Feeds XML
2. Haz clic en 'Crear Nuevo Feed'
3. Selecciona propiedades a incluir (todas, solo activas, filtros específicos)
4. Elige formato XML:
   • Formato XML de Idealista
   • Formato XML de Fotocasa
   • XML personalizado (define tu propio esquema)
5. Genera URL de feed
6. Proporciona URL al portal (obtienen actualizaciones automáticamente)

Personalización de feed

Configura ajustes de feed:

• Frecuencia de actualización: Tiempo real, cada hora, diario
• Filtros de propiedad: Solo tipos específicos, ubicaciones, rangos de precio
• Selección de campos: Elige qué campos incluir
• Límites de imágenes: Máx. imágenes por propiedad
• Longitud de descripción: Límites de caracteres

Gestión de feed

• Ve URL de feed en Configuración → Feeds XML
• Descarga feed XML para revisión manual
• Verifica validación de feed (errores destacados)
• Ve registro de acceso a feed (cuándo el portal obtuvo actualizaciones)
• Regenera URL de feed (actualización de token de seguridad)

Seguimiento de estado de sincronización

Monitorea el estado de sincronización de portales en tiempo real:

• Widget de dashboard: Muestra salud de sincronización (verde/amarillo/rojo)
• Detalle de propiedad: Marca de tiempo de última sincronización por portal
• Registro de sincronización: Historial completo de todos los eventos de sincronización
• Alertas de errores: nietificación en fallas de sincronización

Errores comunes de sincronización

Campos requeridos faltantes:

• Error: "Propiedad sin certificado energético"
• Solución: Sube certificado energético en pestaña Documentos

Coordenadas inválidas:

• Error: "Datos de ubicación inválidos"
• Solución: Re-geocodifica dirección vía búsqueda de Mapbox

Fallas de subida de imágenes:

• Error: "Imagen demasiado grande para portal"
• Solución: Tesoro redimensiona imágenes automáticamente - verifica formato de imagen (solo JPG/PNG)

Límites de tasa de API:

• Error: "Demasiadas solicitudes"
• Solución: Reintento automático después de 1 hora, no se necesita acción

Lista de verificación de solución de problemas de sincronización

1. Verifica Configuración → Integración de Portales → Estado de Conexión
2. Verifica que las credenciales de API son correctas
3. Revisa Registro de Sincronización para mensajes de error específicos
4. Prueba conexión vía botón 'Probar API'
5. Verifica que la propiedad tiene todos los campos requeridos
6. Contacta soporte si los errores persisten