Klanten importeren
FlowForth ondersteunt het in bulk importeren van klanten vanuit een CSV-bestand. Dit is handig bij het migreren vanuit een ander systeem of het in één keer onboarden van veel klanten.
Klantimport is alleen beschikbaar voor Master-gebruikers. Als je de importoptie niet ziet, neem contact op met je FlowForth-beheerder.
CSV-bestandsformaat
Je CSV-bestand moet een komma als scheidingsteken gebruiken en de volgende kolommen bevatten in exact deze volgorde:
| Kolom | Verplicht | Beschrijving |
|---|---|---|
| ExternalClientId | Ja | Een unieke identificatie voor de klant in jouw systeem |
| ClientName | Ja | De bedrijfsnaam of volledige naam van de klant |
| ClientAddress | Ja | Straatnaam en huisnummer |
| City | Ja | Plaatsnaam |
| PostalCode | Ja | Postcode |
| Country | Ja | Landnaam (bijv. Belgium, Netherlands) |
| VAT | Nee | VAT-nummer (gevalideerd per landformaat) |
| PeppolId | Nee | PEPPOL-netwerkadres |
| EmailAddress | Nee | E-mailadres van de contactpersoon |
| TelephoneNumber | Nee | Telefoonnummer van de contactpersoon |
Voorbeeld CSV
ExternalClientId,ClientName,ClientAddress,City,PostalCode,Country,VAT,PeppolId,EmailAddress,TelephoneNumber
EXT-001,Acme Services BV,Keizersgracht 123,Amsterdam,1015 CJ,Netherlands,NL123456789B01,,info@acme.nl,+31201234567
EXT-002,Half vier BV,Vlasmarkt 6,Gent,9000,Belgium,BE 0885.990.575,0208:0885990575,gerald@example.be,+3292242457
De eerste rij van je CSV-bestand wordt behandeld als koprij en wordt automatisch overgeslagen tijdens de import.
Hoe te importeren
- Ga naar de pagina Klanten importeren.
- Selecteer de organisatie waarin je klanten wilt importeren via het vervolgkeuzemenu.
- Klik op Bestand kiezen en selecteer je CSV-bestand.
- Klik op Klanten importeren om het proces te starten.
Pagina klanten importeren met geselecteerd bestand
De import kan even duren, afhankelijk van het aantal rijen.
Importresultaten
Na het voltooien van de import zie je een samenvatting met:
- Totaal aantal rijen — Aantal verwerkte gegevensrijen.
- Aangemaakt — Aantal nieuwe klanten dat is toegevoegd.
- Bijgewerkt — Aantal bestaande klanten dat is bijgewerkt.
- Fouten — Aantal rijen dat is mislukt.
Samenvatting importresultaten
Gedrag bij aanmaken vs. bijwerken
De import gebruikt het veld ExternalClientId om te bepalen of een nieuwe klant moet worden aangemaakt of een bestaande moet worden bijgewerkt:
- Als er geen klant met dat ExternalClientId bestaat in de organisatie, wordt een nieuwe klant aangemaakt.
- Als er al een klant met dat ExternalClientId bestaat, wordt de bestaande klant bijgewerkt met de waarden uit de CSV-rij.
Dit betekent dat je veilig een bijgewerkt CSV-bestand opnieuw kunt importeren zonder duplicaten te creëren.
Omgaan met fouten
Als rijen niet geïmporteerd kunnen worden, wordt de foutenlijst onder de resultatensamenvatting weergegeven. Veelvoorkomende fouten zijn:
- Ontbrekende verplichte velden — ExternalClientId en ClientName zijn verplicht voor elke rij.
- Verkeerd aantal kolommen — Elke rij moet precies 10 velden bevatten (gebruik lege waarden voor optionele velden).
- Ongeldig VAT-formaat — VAT-nummers die niet overeenkomen met het verwachte landformaat worden gelogd als waarschuwingen, maar de rij wordt wel verwerkt.
Rijen met ontbrekende verplichte velden (ExternalClientId of ClientName) worden volledig overgeslagen. Zorg ervoor dat elke rij minstens deze twee velden ingevuld heeft.
CSV-tips
- Komma's in waarden — Zet velden met komma's tussen dubbele aanhalingstekens:
"Hoofdstraat 123, Suite 4" - Aanhalingstekens in waarden — Gebruik dubbele aanhalingstekens om te escapen:
"Bedrijf ""Bijnaam"" BV" - Lege optionele velden — Laat ze leeg maar behoud de komma's:
EXT-001,Naam,Adres,Stad,1234,Land,,,, - Tekencodering — Sla je bestand op in UTF-8-codering om ervoor te zorgen dat speciale tekens behouden blijven.
Zie ook
- Locaties importeren — Importeer locaties in bulk vanuit een CSV-bestand na het importeren van klanten
- Activiteiten importeren — Importeer activiteiten in bulk om werk in te plannen op geïmporteerde locaties
- Veelgestelde vragen over gegevensimport — Veelgestelde vragen en tips voor het oplossen van problemen bij CSV-imports
Was this page helpful?