Dealer Locator

Versie v1.0.0
Platform Magento 2
Module uitgebracht 18 November 2026

Dealers importeren via CSV | Magento 2 Dealer Locator

Op zoek naar Dealer Locator? Bekijk de volledige Dealer Locator pagina voor functies, configuratieopties en prijzen.

Met de CSV-import van de Dealer Locator voeg je in één keer honderden dealers toe of werk je ze bij, rechtstreeks vanuit een spreadsheet. Deze handleiding laat zien hoe je het bestand voorbereidt in Excel of Google Sheets, welke kolommen de import begrijpt, welke opties de importpagina heeft en hoe je het rapport daarna leest. We leggen ook uit hoe opnieuw importeren werkt, zodat je je dealerlijst in een spreadsheet kunt bijhouden en na wijzigingen gewoon opnieuw uploadt, en wat je kunt verwachten als de module voor veel adressen tegelijk coördinaten opzoekt. In de admin staat een voorbeeldbestand klaar om mee te beginnen.

Waar vind je het

Ga naar: Inhoud → Dealer Locator → Dealers → CSV importeren

Met de knop Voorbeeld-CSV downloaden (op de dealer-grid en de importpagina) krijg je een kant-en-klaar voorbeeld om mee te beginnen.

Hoe de import werkt

  • Elke rij is één dealer. Dealers worden herkend aan de code: een bestaande code wordt bijgewerkt, een nieuwe code maakt een dealer aan.
  • Rijen worden één voor één verwerkt. Een rij met een probleem wordt gemeld en overgeslagen; de andere rijen worden gewoon geïmporteerd.
  • Kolommen die niet in het bestand staan, blijven bij bestaande dealers ongewijzigd. Een bestand met alleen code,name,country,phone werkt alleen de telefoonnummers bij.
  • Een lege cel maakt de waarde leeg, een lege telefooncel verwijdert bijvoorbeeld het telefoonnummer.
  • Rijen die niets veranderen, tellen als "Ongewijzigd" en worden niet opnieuw opgeslagen.

Het bestand voorbereiden

  • De eerste rij bevat de kolomnamen. De volgorde maakt niet uit.
  • Gescheiden door komma's, puntkomma's of tabs: de import herkent het zelf.
  • Opgeslagen vanuit Excel? Zowel "CSV UTF-8" als het gewone "CSV" van Excel werken, dus letters met accenten zoals "é" of "ü" komen goed door.
  • Waarden met het scheidingsteken erin, zoals meerdere categorieën, staan tussen dubbele aanhalingstekens: "Tenten, Rugzakken". Excel en Google Sheets doen dit voor je.
  • Maximaal 10 MB per bestand in de admin. Voor grotere bestanden gebruik je de command line (zie de handleiding voor CLI-commando's).

Kolommen

Kolom Verplicht Wat vul je in
code Ja Unieke referentie voor de dealer. Alleen letters, cijfers, "-", "_" en ".", max. 64 tekens.
name Ja Naam van de dealer zoals bezoekers die zien.
country Ja Landcode van twee letters: NL, BE, DE, FR, GB...
street Straat en huisnummer, bijv. Domplein 9.
postcode Postcode.
city Plaats. Een postcode of plaats is nodig om de dealer op de kaart te zetten.
phone Telefoonnummer zoals je het wilt tonen.
website Volledig adres inclusief https://.
categories Namen van productcategorieën, gescheiden door komma's (of een verticale streep): "Tenten, Rugzakken".
stores Codes van store views, gescheiden door komma's: "nl, be_nl". Leeg of all betekent alle store views.
active 1 of 0. yes/no, true/false en ja/nee werken ook. Leeg betekent actief.
latitude, longitude Coördinaten, als je ze hebt. Gebruik ze allebei of geen van beide.

Kolomnamen zijn niet hoofdlettergevoelig, en een paar gangbare alternatieven worden herkend: zip of postal_code voor postcode, country_code voor country, lat en lng voor de coördinaten, is_active voor active, telephone voor phone. Andere kolommen worden genegeerd en in het rapport als melding genoemd.

Productcategorieën

Categorieën worden herkend aan hun standaardlabel, ongeacht hoofd- of kleine letters. Met Productcategorieën aanmaken die nog niet bestaan aan worden onbekende namen automatisch aangemaakt, elk maar één keer. Zet het uit als je wilt dat tikfouten worden gemeld in plaats van nieuwe categorieën te worden.

Coördinaten

  • Coördinaten in het bestand worden gebruikt zoals ze zijn.
  • Als ze leeg zijn, houden bestaande dealers hun coördinaten, zodat opnieuw importeren niet elk adres opnieuw opzoekt.
  • Dealers zonder coördinaten, en dealers waarvan het adres is gewijzigd, krijgen hun coördinaten opgezocht (als die optie aan staat).

Opties op de importpagina

  • Ontbrekende coördinaten opzoeken op basis van het adres - standaard aan. Zet het uit om snel te importeren en de dealers daarna op de kaart te zetten.
  • Productcategorieën aanmaken die nog niet bestaan - zie hierboven.
  • Alleen controleren, niets opslaan - controleert het hele bestand en laat zien wat er zou gebeuren, zonder iets op te slaan. Aanbevolen voor de eerste import van een nieuw bestand.

Grote bestanden en coördinaten opzoeken

Met OpenStreetMap kan de module ongeveer één adres per seconde opzoeken (hun gebruiksvoorwaarden). Een adminpagina kan niet wachten op honderden opzoekingen, dus in de admin stopt het opzoeken na 60 seconden: de overige dealers worden zonder coördinaten geïmporteerd, en het rapport meldt dat. Daarna kun je:

  • de dealer-grid filteren op Op kaart: Nee, de dealers selecteren en Locatie zoeken gebruiken (opnieuw 60 seconden per keer), of
  • op de server bin/magento dealerlocator:geocode uitvoeren, zonder tijdslimiet.

Met Google Maps gaat het opzoeken veel sneller, dus daar wordt de limiet zelden bereikt.

Het rapport

Na de import toont de pagina:

  • Aangemaakt, Bijgewerkt, Ongewijzigd, Mislukt - het aantal rijen per resultaat
  • Aangemaakte productcategorieën
  • Opgezochte coördinaten en Dealers zonder coördinaten
  • Een lijst met meldingen per rij, met het rijnummer en de dealercode:
    • Fout - de rij is niet geïmporteerd, bijvoorbeeld "Land "XX" is geen bekende landcode van twee letters" of "Code "D-12" staat ook in rij 4"
    • Waarschuwing - de dealer is geïmporteerd, maar het adres is niet gevonden op de kaart
    • Melding - ter informatie, zoals een kolom die niet gebruikt wordt

Rijnummers komen overeen met de rijen in je spreadsheet: rij 1 is de kopregel.

Voorbeeld

code,name,street,postcode,city,country,phone,website,categories,stores,active,latitude,longitude
D-1001,Outdoor Centre Utrecht,Domplein 9,3512 JE,Utrecht,NL,+31 30 000 0001,https://www.example.com,"Tents, Backpacks",all,1,,
D-1003,Adventure Store Brussels,Grote Markt 1,1000,Brussel,BE,,,"Backpacks, Sleeping bags",all,1,50.8467,4.3525

Voor de eerste dealer worden de coördinaten opgezocht; de tweede gebruikt die uit het bestand.

Alleen de actieve status van twee dealers bijwerken:

code,name,country,active
D-1001,Outdoor Centre Utrecht,NL,0
D-1003,Adventure Store Brussels,BE,1

name en country zijn in elk bestand verplicht, dus neem ze ook op als ze niet veranderen.

Meer Hulp Nodig?

Documentatie:

Support:

Voor een compleet overzicht van functies en configuratieopties, bekijk Dealer Locator.

Artikel bijgewerkt:
Download PDF
star star star star star
star star star star star
Gaaf - digital agency
We have tried the integration with SnelStart through several different providers, and this is the only solution that simply works. We needed support on two occasions, and it was provided quickly and professionally. We do recommend this company!
Google 12 May 2026
star star star star star
star star star star star
Andrew Velikiy
Great vendor with handy modules and quick support!
Google 13 Apr 2026
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025