Property portal integration in Tesoro CRM

API credentials instellen

Configureer Idealista integration in 5 stappen:

1. Ga naar Settings → Integrations → Idealista
2. Enter je Idealista API key (verkrijgbaar via Idealista Pro account)
3. Enter je Idealista username en password
4. Click 'Test Connection' om credentials te verifiëren
5. Enable 'Auto-sync' om automatische updates te activeren

Field mapping

Tesoro mapt automatisch Tesoro fields naar Idealista fields:

• Property type: Apartment → Piso, House → Casa, etc.
• Features: Pool → Piscina, Garage → Garaje
• Prijs: Automatic currency conversion
• Description: Multi-language support (ES/EN)
• Images: All images sync'd with order preserved

Custom field mapping beschikbaar in Settings → Idealista → Field Mapping.

Sync frequency

• Real-time sync: Changes in Tesoro → immediately to Idealista (via API)
• Bi-directional sync: Updates vanuit Idealista → Tesoro (every 1 hour)
• Manual sync: Force sync via 'Sync Now' button

Fotocasa configuratie

Setup vergelijkbaar met Idealista:

1. Settings → Integrations → Fotocasa
2. Enter Fotocasa account credentials
3. Configure field mapping (automatisch voor standaard fields)
4. Enable auto-sync
5. Test met één property voor validation

Fotocasa specifieke features

• Property highlighting: Option om properties te highlighten op Fotocasa (premium feature)
• Top position: Boost properties naar top van search results
• Statistics import: View counts en contact requests vanuit Fotocasa → Tesoro

Sync timing

Fotocasa updates zijn niet real-time maar wel frequent:

• New properties: Within 5-10 minutes
• Price changes: Within 10 minutes
• Status changes (sold/rented): Within 15 minutes
• Image updates: Within 30 minutes

Check sync status in Settings → Fotocasa → Sync Log.

Generating XML feeds

Voor portals zonder directe API integration gebruik je XML feeds:

1. Settings → Integrations → XML Feeds
2. Click 'Create New Feed'
3. Select properties to include (all, active only, specific filters)
4. Choose XML format:
   • Idealista XML format
   • Fotocasa XML format
   • Custom XML (define your own schema)
5. Generate feed URL
6. Provide URL to portal (they fetch updates automatically)

Feed customization

Configure feed settings:

• Update frequency: Real-time, hourly, daily
• Property filters: Only specific types, locations, price ranges
• Field selection: Choose which fields to include
• Image limits: Max images per property
• Description length: Character limits

Feed management

• View feed URL in Settings → XML Feeds
• Download feed XML voor manual review
• Check feed validation (errors highlighted)
• View feed access log (when portal fetched updates)
• Regenerate feed URL (security token refresh)

Sync status tracking

Monitor portal sync status in real-time:

• Dashboard widget: Shows sync health (green/yellow/red)
• Property detail: Last synced timestamp per portal
• Sync log: Complete history van alle sync events
• Error alerts: nietification bij sync failures

Common sync errors

Missing required fields:

• Error: "Property missing energy certificate"
• Fix: Upload energy certificate in Documents tab

Invalid coordinates:

• Error: "Invalid location data"
• Fix: Re-geocode address via Mapbox lookup

Image upload failures:

• Error: "Image too large for portal"
• Fix: Tesoro auto-resizes images - check image format (JPG/PNG only)

API rate limits:

• Error: "Too many requests"
• Fix: Automatic retry after 1 hour, no action needed

Sync troubleshooting checklist

1. Check Settings → Portal Integration → Connection Status
2. Verify API credentials zijn correct
3. Review Sync Log voor specific error messages
4. Test connection via 'Test API' button
5. Check property has all required fields
6. Contact support als errors persistent zijn