Ga naar hoofdinhoud

Locaties importeren

FlowForth ondersteunt het in bulk importeren van locaties vanuit een CSV-bestand. Dit is handig bij het migreren vanuit een ander systeem of het onboarden van een klant met veel vestigingen.

info

Locatie-import is alleen beschikbaar voor Master-gebruikers. Als je de importoptie niet ziet, neem dan 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:

KolomVerplichtBeschrijving
ExternalLocationIdJaEen unieke identificatie voor de locatie in je systeem
ExternalClientIdJaHet externe klant-ID van de klant waartoe deze locatie behoort
NameJaEen beschrijvende naam voor de locatie
AddressJaStraatnaam en huisnummer
CityNeePlaatsnaam
PostalCodeNeePostcode
CountryNeeLandnaam (bijv. Belgium, Netherlands)
PhoneNumberNeeTelefoonnummer van de contactpersoon op deze locatie
EmailAddressNeeE-mailadres van de contactpersoon (gereserveerd voor toekomstig gebruik)
ContactNameNeeNaam van de contactpersoon ter plaatse

Voorbeeld CSV​

ExternalLocationId,ExternalClientId,Name,Address,City,PostalCode,Country,PhoneNumber,EmailAddress,ContactName
LOC-001,EXT-001,Main Office,Keizersgracht 123,Amsterdam,1015 CJ,Netherlands,+31201234567,info@acme.nl,Jan de Vries
LOC-002,EXT-001,Warehouse,Industrieweg 45,Amsterdam,1099 AB,Netherlands,+31207654321,,Piet Jansen
LOC-003,EXT-002,Headquarters,Vlasmarkt 6,Gent,9000,Belgium,+3292242457,gerald@example.be,Gerald Peeters
tip

De eerste rij van je CSV-bestand wordt behandeld als een koprij en wordt automatisch overgeslagen tijdens de import.

Hoe te importeren​

  1. Ga naar de pagina Locaties importeren.
  2. Selecteer de organisatie waarin je locaties wilt importeren uit de vervolgkeuzelijst.
  3. Klik op Bestand kiezen en selecteer je CSV-bestand.
  4. Klik op Locaties importeren om het proces te starten.

Pagina locaties importeren met geselecteerd bestand

Pagina locaties importeren met geselecteerd bestand

De import kan even duren, afhankelijk van het aantal rijen. Adressen worden automatisch op de achtergrond in de wachtrij geplaatst voor geocodering.

Importresultaten​

Na afloop van de import zie je een samenvatting met:

  • Totaal aantal rijen — Aantal verwerkte gegevensrijen.
  • Aangemaakt — Aantal nieuw toegevoegde locaties.
  • Bijgewerkt — Aantal bestaande locaties die zijn bijgewerkt.
  • Fouten — Aantal rijen die mislukt zijn.

Samenvatting importresultaten

Samenvatting importresultaten

Aanmaken vs. bijwerken​

De import gebruikt de velden ExternalLocationId en ExternalClientId samen om te bepalen of er een nieuwe locatie moet worden aangemaakt of een bestaande moet worden bijgewerkt:

  • Als er geen locatie met dat ExternalLocationId bestaat voor de overeenkomende klant, wordt er een nieuwe locatie aangemaakt.
  • Als er al een locatie met dat ExternalLocationId bestaat voor de klant, wordt de bestaande locatie bijgewerkt met de waarden uit de CSV-rij.

Dit betekent dat je veilig een bijgewerkt CSV-bestand opnieuw kunt importeren zonder duplicaten aan te maken.

Automatische geocodering​

Wanneer locaties worden aangemaakt of bijgewerkt via import, plaatst FlowForth ze automatisch in de wachtrij voor adresgeocodering op de achtergrond. Als het adres gevonden kan worden, worden de breedte- en lengtegraadcoördinaten van de locatie automatisch ingevuld.

Als je het adres van een locatie bijwerkt via import, worden de coördinaten vernieuwd om overeen te komen met het nieuwe adres.

Fouten afhandelen​

Als er rijen niet geïmporteerd kunnen worden, wordt de foutenlijst onder de samenvatting van de resultaten weergegeven. Veelvoorkomende fouten zijn:

  • Ontbrekende verplichte velden — ExternalLocationId, ExternalClientId, Name en Address zijn verplicht voor elke rij.
  • Klant niet gevonden — Het ExternalClientId moet overeenkomen met een bestaande klant in de organisatie.
  • Dubbel ExternalLocationId — Elk ExternalLocationId moet uniek zijn binnen het CSV-bestand.
  • Verkeerd aantal kolommen — Elke rij moet precies 10 velden bevatten (gebruik lege waarden voor optionele velden).
waarschuwing

Rijen met ontbrekende verplichte velden of een niet-overeenkomend ExternalClientId worden volledig overgeslagen. Zorg ervoor dat elke rij deze velden correct heeft ingevuld.

CSV-tips​

  • Komma's in waarden — Zet velden met komma's tussen dubbele aanhalingstekens: "Keizersgracht 123, 2e verdieping"
  • Aanhalingstekens in waarden — Gebruik dubbele aanhalingstekens als escape: "Gebouw ""A"" Ingang"
  • Lege optionele velden — Laat ze leeg maar behoud de komma's: LOC-001,EXT-001,Name,Address,,,,,,
  • Tekencodering — Sla je bestand op in UTF-8-codering om ervoor te zorgen dat speciale tekens behouden blijven.

Zie ook​

Was this page helpful?