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

Voorbeeldbestand downloaden

Per type kunt u op de importpagina een voorbeeldbestand downloaden, juiste kolomkoppen + voorbeeldrij. Gebruik als sjabloon, voorkomt handmatig mappen.

---

CSV-vereisten

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

Excel-codering

Microsoft Excel slaat default in ANSI op, kan problemen geven met accenten/umlauten. Sla op als CSV UTF-8.

Opmerking

Naast CSV: XML voor woningfeeds (Settings → XML Import) en JSON voor API-integraties.

---

CSV voorbereiden: richtlijnen

1. Download voorbeeldbestand + gebruik als sjabloon
2. Behoud kopregel met juiste Tesoro-veldnamen
3. UTF-8 voor speciale tekens
4. 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

Persoonsgegevens

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

Adres

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

Lead-tracking

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

Buyer-velden

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

Seller-velden

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

Timing

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

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

   Klik om te vergroten

   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 →

2. 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.

3. 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.

4. Klaar: importlogboek met succes/overgeslagen rijen. Bij succes: verwijzing naar aangemaakt record.

---

Hoe auto-mapping werkt

Drie strategieën:

1. Exacte waarde-match: first_name matcht first_name
2. Label-match: First Name (label) matcht
3. Gedeeltelijke match: niet hoofdletter-gevoelig
4. 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

owner_email

Verwijst naar Tesoro-gebruiker (makelaar), moet bestaan in uw account. Anders: bij mismatch wordt de fallback gebruikt.

---

Eigenaar bepalen

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

Relations

Geen owner_email. Relaties worden direct aan uw bedrijf gekoppeld.

---

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

Twee keer importeren = dubbel

Alle records dubbel. Wees voorzichtig, gebruik testimport.

---

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

Tip

Bij duizenden records: enkele minuten. Pagina open houden voor voortgang.

---

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.

Opmerking

Alleen imports van ingelogde gebruiker + huidige importtype.

---

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

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

---

Volgende stappen

Migratie-overzicht Volledige migratie naar Tesoro, door het Tesoro-team.

Contacten beheren Werk met geïmporteerde contacten.

Leads beheren Beheer geïmporteerde leads door uw pipeline.