Data importeren: CSV-wizard voor leads, contacten, relaties

Tesoro heeft een ingebouwde importwizard. Drie soorten records: leads, contacten en relaties. Auto-mapping van kolommen, testimport vóór definitief uitvoeren, batchverwerking voor grote bestanden. Alleen Admin.

Wanneer gebruikt u dit?

500 contacten uit een vorig CRM in CSV-vorm
Een lijst leads uit een marketing-campagne
Verzameling zakelijke relaties (bedrijven) handmatig samengesteld

Vier importtypen

Type	Wat	Navigatie
Lead	Buyer-leads met tracking	Leads → Import
Lead (Owner)	Verkopers met woningdetails	Leads → Import (kies Owner)
Contact	Gekwalificeerde contacten	Contacts → Import
Relation	Bedrijven, zakenpartners	Relations → Import

CSV-vereisten

Eigenschap	Eis
Type	`.csv`
Max grootte	50 MB
Scheidingsteken	Komma of puntkomma (auto-detectie)
Kopregel	Eerste rij = kolomkoppen
Codering	UTF-8 aanbevolen

CSV voorbereiden: richtlijnen

Download voorbeeldbestand + gebruik als sjabloon
Behoud kopregel met juiste Tesoro-veldnamen
UTF-8 voor speciale tekens
Verplichte velden gevuld: anders rij overgeslagen

Telefoonnummers

Internationaal formaat met landcode: +31612345678
Spaties auto-verwijderd
Haakjes/streepjes kunnen fouten geven

Meerdere waarden in één cel

Scheid met komma binnen dezelfde cel:

property_details.type: apartment, villa, townhouse
property_details.location: Marbella, Estepona, Benahavis

Geneste velden: puntsyntax

Prefix	Genest onder	Voorbeeld
`address.`	Adres	`address.city`, `address.street`
`lead.`	Lead-tracking	`lead.source`, `lead.status`
`property_details.`	Woningwensen	`property_details.type`, `property_details.price_min`
`property_address.`	Woningadres (verkopers)	`property_address.street`
`timing.`	Timing	`timing.looking_to`, `timing.timeline_max`
`social.`	Social (relaties)	`social.facebook`, `social.linkedIn`

Velden per importtype

Lead-import

Kolom	Verplicht
`type` (altijd `lead`)	Ja
`status`	Ja
`owner_email`	Ja
`salutation`	Nee
`language`	Nee
`first_name`, `last_name`	Ja
`email`, `phone`	Ja
`additional_information`	Nee

Kolom
`address.city`, `address.country`, `address.state`, `address.street`, `address.zip_code`

Kolom	Waarden
`lead.source`	Website, Referral, Portals, Cold Calling, …
`lead.status`	New, Contacted, Qualified, Unqualified, Lost, Converted
`lead.stage`	Hot, Neutral, Cold

Kolom
`property_details.type` (multi, komma-gescheiden)
`property_details.location` (multi)
`property_details.number_of_bedrooms`, `_bathrooms`
`property_details.price_min`, `_max`
`property_details.size_min`, `_max`, `size`
`property_details.market_price`

Kolom
`commision` (commissie%)
`way_of_selling`
`property_address.street`, `_city`, `_state`, `_zip_code`, `_country`, `_address_line_2`

Kolom
`timing.looking_to`, `timing.timeline_max`

Contact-import

Kolom	Verplicht
`type` (altijd `contact`)	Ja
`status`, `owner_email`	Ja
`salutation`, `role`, `language`	Nee
`first_name`, `last_name`, `email`, `phone`	Ja
`additional_information`	Nee
`address.*`	Nee
`do_not_contact`, `portal_user` (true/false)	Nee

Relation-import

Kolom	Verplicht
`name`, `type`, `email`, `phone_number`, `status`	Ja
`website_url`, `preferred_communication`, `note`, `credit_terms`	Nee
`address.*`	Nee
`social.facebook`, `social.linkedIn`, `social.instagram`	Nee

De importwizard: vier stappen

Bestand selecteren: ga naar het juiste type (Leads/Contacts/Relations → Import).

De importwizard.

Upload CSV (max 50 MB). Op deze pagina ook:
- Voorbeeldbestand downloaden voor type (leads: kies tussen leads-variant en owners-variant)
- Open import history voor eerdere imports
Next →
Velden toewijzen (mapping): Tesoro parseert en toont per kolom:
- Kolomnaam uit bestand
- Voorbeeldwaarde uit rij 2
- Dropdown met Tesoro-velden
Auto-matching:
- Exacte naam (bv. first_name)
- Exacte label (bv. First Name)
- Gedeeltelijke match (niet hoofdlettergevoelig)
- Vorige mapping bij dezelfde kolomnamen
Verplichte velden moeten allemaal toegewezen, anders kan niet door.

Preview → testimport.
Valideren (preview): GEEN records aangemaakt. Per rij:
- Rijnummer
- Status: geslaagd / mislukt
- Foutmelding bij mislukt
Fouten? Terug naar stap 1, CSV corrigeren, opnieuw uploaden.

Tevreden? Import klikken → definitief.
Klaar: importlogboek met succes/overgeslagen rijen. Bij succes: verwijzing naar aangemaakt record.

Hoe auto-mapping werkt

Drie strategieën:

Exacte waarde-match: first_name matcht first_name
Label-match: First Name (label) matcht
Gedeeltelijke match: niet hoofdletter-gevoelig
Vorige mapping: dezelfde kolomnamen als eerdere import → mappings hersteld

Verplichte velden per type

Type	Verplicht
Lead	first_name, last_name, email, phone, owner_email
Contact	first_name, last_name, email, phone, owner_email
Relation	name, type, email, phone_number, status

Eigenaar bepalen

owner_email-kolom → gebruiker opgezocht per rij
Fallback → eerste gebruiker van uw bedrijf

Duplicaten: geen auto-detectie

Tesoro doet geen duplicaatdetectie tijdens CSV-import. Alle rijen worden aangemaakt, ook bij bestaande emails.

Voorkom duplicaten:

Check uw CSV vooraf
Verwijder duplicaten in bron
Test-import om aantallen te zien
Handmatig samenvoegen ná import

Veelvoorkomende fouten

Fout	Oorzaak	Oplossing
Verplicht veld leeg	first_name, last_name, email leeg	Vul in CSV
Ongeldig email	Geen @ of typo	Controleer
Ongeldige owner_email	Gebruiker bestaat niet	Gebruik bestaande gebruiker
Ongeldig type/status	Niet in toegestane opties	Vergelijk met voorbeeldbestand
Ongeldig telefoonnummer	Geen internationaal formaat	Gebruik `+31612345678`
Locatie als string	Multi-waarden niet correct gescheiden	Komma binnen cel
Naam met cijfers	first_name/last_name bevat numerieke tekens	Verwijder

Importlogboek (test + definitief)

Per rij:

Rijnummer (vanaf 2, omdat 1 = kopregel)
Status (error: 0 of 1)
Foutmelding bij mislukt
Aangemaakt record bij succes (resource + ID)

Batchverwerking

Imports verwerkt in batches van 100:

Grote bestanden auto-opgedeeld
Elke batch via achtergrondtaak
Live voortgang in UI (“150/500 processed”)
Polling elke 5 seconden

Importgeschiedenis

Open import history op importpagina. Tabel:

Kolom	Wat
Bestandsnaam	Naam CSV
Totaal rijen	In bestand
Verwerkte rijen	Aantal verwerkt
Datum	Wanneer

Gepagineerd (10 default, 10/20/30/40/50 mogelijk), gesorteerd nieuwste eerst.

Woningen importeren: andere route

Niet via CSV-wizard, maar via XML-feed:

Kyero XML-feeds voor woningfeed-sync
Handmatige XML-uploads voor eenmalige import

Geconfigureerd via Settings → XML Import. U stelt ook in wat te doen met woningen niet meer in feed (bv. status “Removed by Feed”).

Acht tips voor succesvolle import

Begin met testimport: wizard doet dit auto in preview-stap
Voorbeeldbestand als sjabloon: voorkomt mapping-problemen
Internationale telefoonnummers met landcode
Geldige e-mailadressen: anders overgeslagen
owner_email matcht bestaande gebruiker: anders fallback
Splits grote bestanden: makkelijker te controleren in logboek
UTF-8 voor special characters
Multi-waarden met komma: niet puntkomma binnen cellen

Volgende stappen

Migratie-overzichtVolledige migratie naar Tesoro, door het Tesoro-team.

Contacten beherenWerk met geïmporteerde contacten.

Leads beherenBeheer geïmporteerde leads door uw pipeline.