Hoe u producten, varianten, klanten en bestellingen via CSV in Shopware 6 overneemt en welke fouten u daarbij voorkomt.
De Shopware CSV-import is een ingebouwde module in Shopware 6 waarmee u producten, klanten, categorieën en andere gegevens vanuit een CSV-bestand overneemt. U vindt de module in de Administration onder Instellingen, Automatisering, Import/Export. Elk bestand loopt via een profiel dat bepaalt welke kolom in welk Shopware-veld terechtkomt. Het bestand moet UTF-8 gecodeerd zijn, puntkomma’s als scheidingsteken gebruiken en punten als decimaalteken.
Voor afzonderlijke gegevensgebieden is CSV de snelste weg, voor een volledige platformwissel meestal niet. Producten, prijzen, voorraden en klantenlijsten laten zich goed via CSV bijhouden. Bestelgeschiedenis, reviews, SEO-URL’s en documenten verhuizen netter met de Migration Assistant als u van Shopware 5 of een andere Shopware 6 komt. Doorlopende synchronisatie met een voorraad- of ERP-systeem hoort in een koppeling.
De meeste importfouten ontstaan vóór de upload. Excel verandert speciale tekens, scheidingstekens en voorloopnullen, varianten hebben een vaste volgorde nodig en klanten krijgen zonder voorbereiding registratiemails. Wilt u de import niet zelf doen? In het shopabonnement van solution25 maken wij afhankelijk van het pakket tot 200 of 500 producten aan, in het Enterprise-pakket is de datamigratie inbegrepen.
Dit artikel is bedoeld voor shopeigenaren, e-commercemanagers en developers die gegevens in een Shopware 6-shop willen overnemen: bij de start van een nieuwe shop, bij een relaunch of bij het regelmatige onderhoud van grote assortimenten. U leest welke methode bij welke situatie past, hoe u profielen en bestanden voorbereidt en hoe u producten, varianten, klanten en bestellingen zonder dataverlies overneemt.
De module Import/Export hoort bij de standaardfuncties van Shopware 6. U hebt er geen extensie voor nodig. Open in de Administration Instellingen, Automatisering, Import/Export. Daar vindt u drie tabbladen: Import, Export en Profielen.
Shopware levert standaardprofielen mee, onder meer voor producten, categorieën, eigenschappen, nieuwsbriefontvangers en de variantconfiguratie. De documentatie bevat daarnaast veldreferenties voor klanten, bestellingen, media, prijzen, cross-selling en actiecodes. Voor elk van deze objecttypen kunt u eigen profielen aanmaken.
Bij de start controleert Shopware elk record. Geldige regels worden overgenomen, foutieve komen in een apart CSV-bestand met de extra kolom _error. Dat bestand downloadt u, corrigeert u en importeert u opnieuw. Het logboek toont de imports van de afgelopen 30 dagen, met bronbestand, profiel en foutbestand.
Een belangrijke knop is de testrun (dry run). Die speelt de volledige import door zonder gegevens weg te schrijven. Zo ziet u vooraf of regels mislukken en voorkomt u een half geïmporteerde dataset.
Een import kan gegevens alleen toevoegen of overschrijven, niet verwijderen. Een voorbeeld uit de documentatie: een koppeling aan een verkoopkanaal die eenmaal is gezet, verwijdert u niet meer via een import. Wilt u koppelingen opschonen, dan doet u dat in de Administration of via de API. Ook afbreken maakt niets ongedaan: records die tot dat moment zijn geschreven, blijven in het systeem.
Voordat u het eerste bestand bouwt, bepaalt u of CSV wel het juiste gereedschap is. Shopware biedt drie manieren om gegevens in de shop te krijgen, en elke manier past bij een andere situatie.
| Methode | Geschikt voor | Grenzen |
|---|---|---|
| CSV Import/Export | Eerste inrichting van assortimenten, massale wijzigingen van prijzen en voorraden, klantenlijsten uit een oud systeem | Geen verwijderingen, varianten alleen in meerdere stappen, geen standaardhandleiding voor bestellingen |
| Migration Assistant | Verhuizing van Shopware 5 of een andere Shopware 6, volgens de Shopware-documentatie ook Magento | Betaalmethoden, flows, dynamische productgroepen en extensiegegevens moeten opnieuw worden aangemaakt |
| API of koppeling | Doorlopende synchronisatie met voorraadbeheer, ERP of PIM | Ontwikkelwerk, beheer en bewaking van de koppeling |
CSV is sterk als gegevens eenmalig of met grotere tussenpozen komen en de structuur overzichtelijk is. Typische situaties: een webwinkel start met 800 artikelen uit een leverancierslijst. Een shop wijzigt vóór Black Friday de prijzen van 2.000 producten. Een groothandel neemt zijn klantenlijst over uit een oud B2B-portaal. In al deze gevallen is een goed opgebouwd CSV-bestand binnen enkele minuten geïmporteerd.
Komt u van Shopware 5, gebruik dan de officiële Migration Assistant. Volgens Shopware neemt die media, categorieën, producten, eigenschappen, fabrikanten, reviews, cross-selling, klanten, bestellingen inclusief documenten, SEO-URL’s, nieuwsbriefontvangers, verlanglijstjes en acties over. Dat via CSV nabouwen kost een veelvoud aan tijd en verliest relaties tussen de gegevens. Hoe deze verhuizing verloopt, leest u in het artikel Shopware 5 naar Shopware 6 migreren.
Zodra gegevens dagelijks of elk uur moeten stromen, bijvoorbeeld voorraden uit het magazijn of bestellingen terug naar de boekhouding, is handmatige CSV de verkeerde weg. Dan hebt u een koppeling met uw voorraadbeheer nodig. Welke systemen er zijn en hoe de koppeling werkt, beschrijft het artikel Shopware voorraadbeheer. Een tussenoplossing zijn geautomatiseerde CSV-imports via de commandoregel, daarover verderop meer.
Shopware verwacht een echt CSV-bestand met vaste regels. De documentatie noemt er drie: UTF-8 als tekencodering, puntkomma als veldscheidingsteken, aanhalingstekens rond tekst. Daarbij komt bij getallen de punt als decimaalteken, dus 5.00 en niet 5,00. Juist in Nederland en België, waar de komma het gebruikelijke decimaalteken is, gaat dat vaak mis.
De meeste webwinkeliers bouwen hun lijsten in Excel. Bij het opslaan als CSV gebeuren dan drie typische dingen: speciale tekens worden verkeerd gecodeerd, puntkomma’s worden komma’s of andersom, en voorloopnullen verdwijnen. Artikelnummer 00451 wordt 451, een EAN van 13 cijfers verandert in een getal in wetenschappelijke notatie. Shopware raadt daarom een programma aan dat echte CSV-bestanden schrijft en noemt OpenOffice Calc als voorbeeld. LibreOffice Calc of een teksteditor met keuze voor de codering werken net zo goed.
De betrouwbaarste weg naar de juiste structuur: maak twee of drie testproducten met de hand aan, exporteer die met het profiel dat u later voor de import gebruikt en gebruik het geëxporteerde bestand als sjabloon. Kolomnamen, volgorde en formaat kloppen dan zeker. Op het Shopware-forum wordt precies deze aanpak aanbevolen bij de foutmelding over niet-ondersteunde bestandsformaten. Daar melden meerdere gebruikers dat dezelfde upload in Firefox mislukte en in Chrome werkte.
Een profiel is de vertaling tussen uw bestand en de Shopware-database. U kunt een standaardprofiel dupliceren of een nieuw profiel aanmaken. Belangrijk: kies daarbij de standaardtaal van het systeem, anders werkt het profiel volgens de documentatie niet.
Deze twee schakelaars zijn een eenvoudige beveiliging. Voor een pure prijsupdate zet u het aanmaken uit. Een tikfout in een artikelnummer maakt dan geen nieuw, leeg product aan, maar komt als fout in het foutbestand terecht.
In de mapping wijst u elk databaseveld een kolomnaam toe. Per regel legt u vast of het veld verplicht is, welke standaardwaarde het krijgt en op welke positie het staat. Uploadt u een bestaand CSV-bestand, dan stelt Shopware de velden voor op basis van de kopregel. De verplichte velden voegt het systeem zelf toe:
| Objecttype | Verplichte velden volgens de documentatie |
|---|---|
| Product | id, taxId, productNumber, stock, name |
| Klant | id, defaultBillingAddressId, defaultShippingAddressId, customerNumber, firstName, lastName, email |
| Categorie | id, type, name |
Intern werkt Shopware met lange UUID’s. Geen enkel oud systeem kent deze ID’s. In de geavanceerde profielinstellingen kunt u daarom een tweede unieke sleutel kiezen, bij producten meestal het artikelnummer (productNumber). Shopware vindt bij een update dan het juiste product via het nummer. Let erop dat deze sleutel echt uniek is. Dubbele waarden zorgen ervoor dat records worden overgeslagen.
De productimport is de meest voorkomende situatie en die met de meeste verborgen details. Met het standaardprofiel voor producten komt u ver als u op de volgende punten let.
Prijsvelden volgen het patroon price.DEFAULT.net en price.DEFAULT.gross. DEFAULT staat voor de standaardvaluta. Geef beide waarden op of spreek vooraf af welke waarde leidend is. Een veelgemaakte fout is een brutoprijs die met een verkeerd btw-tarief wordt teruggerekend, zodat er vreemde centbedragen in de shop staan.
Het productbestand kent de kolommen tax_id, tax_rate en tax_name. Vul bij tax_id de UUID van een bestaand btw-tarief in. Blijft het veld leeg, dan maakt Shopware volgens de documentatie een nieuw tarief aan. Dat klinkt onschuldig, maar leidt al snel tot meerdere dubbele tarieven met hetzelfde percentage die later niemand meer uit elkaar houdt. Haal de UUID’s vooraf op via een export of uit de Administration.
Het veld media bevat de URL’s van de productafbeeldingen, de hoofdafbeelding staat in een eigen veld. Shopware downloadt de afbeeldingen van deze adressen. Ze moeten dus openbaar bereikbaar zijn. Links uit cloud-shares met een vervaldatum of uit een leveranciersportaal met login mislukken. Bij grote assortimenten loont een eigen afbeeldingenmap op een server, die u na de import weer leegmaakt.
Producten koppelt u via de categorie-ID’s. Maak de categoriestructuur daarom vóór de producten aan, met de hand of met het standaardprofiel voor categorieën. Daar bepaalt parent_id de bovenliggende categorie. De ID van een categorie ziet u in de adresbalk van de Administration als u de categorie opent.
Teksten in andere talen lopen via velden volgens het patroon translations.DEFAULT, waarbij DEFAULT wordt vervangen door de taalcode, bijvoorbeeld nl-NL of de-DE. Voor een meertalige shop plant u per taal een kolom voor naam, beschrijving en metagegevens. Shopware raadt aan om vóór het importeren van vertalingen een databaseback-up te maken.
Varianten zijn het onderdeel waarop de meeste CSV-imports stranden. De reden: een variant hangt aan een hoofdproduct en aan eigenschappen die allebei eerst moeten bestaan. De Shopware-documentatie beschrijft daarom vier stappen.
Bij het importeren van varianten zijn parent_id, product_number, active, stock en optionIds verplicht. Meerdere optie-ID’s scheidt u met een verticale streep, dus id-rood|id-xl.
Genereren is sneller als elke combinatie moet bestaan en de varianten alleen in de opties verschillen. Importeren is beter als u eigen artikelnummers, EAN, voorraden of prijzen per variant moet overnemen. In de praktijk combineren wij vaak beide: varianten genereren en daarna nummers, voorraden en prijzen via een update-import aanvullen. Dat is een ervaring uit projecten, geen voorschrift van Shopware.
Een hypothetische modewinkel heeft 300 shirts in elk 5 maten en 4 kleuren. Dat zijn 300 hoofdproducten, 2 eigenschapsgroepen met 9 opties, 2.700 regels variantconfiguratie (300 keer 9) en 6.000 varianten (300 keer 20). Wie dat in één bestand wil stoppen, loopt vast. In vier netjes gescheiden bestanden is het een overzichtelijke import.
Bij een klantenimport gaat het om meer dan namen en adressen. Drie punten bepalen of de verhuizing voor uw klanten onopgemerkt blijft.
Shopware verstuurt bij het aanmaken van een klant een registratiemail. Bij 5.000 geïmporteerde klanten zijn dat 5.000 mails aan mensen die zich niet opnieuw hebben geregistreerd. De documentatie adviseert daarom om vóór de import de mailverzending onder Instellingen, Systeem, Mailer uit te schakelen en daarna weer aan te zetten.
Klanten moeten na de verhuizing met hun oude wachtwoord kunnen inloggen. Shopware heeft daarvoor de velden legacyPassword en legacyEncoder. Daarin staan de versleutelde hash uit het oude systeem en de methode waarmee die is gemaakt. Logt de klant in, dan controleert Shopware het oude wachtwoord en slaat het opnieuw op in het eigen formaat. Wachtwoorden in platte tekst horen niet in een importbestand. Ondersteunt Shopware de methode van het oude systeem niet, dan blijft alleen een mail om het wachtwoord opnieuw in te stellen na de livegang.
Elke klant heeft een standaard factuur- en een standaard verzendadres nodig. Bij B2B-klanten komen klantgroep, bedrijfsnaam en btw-nummer erbij. Maak de klantgroepen vooraf aan en controleer of landen en aanhefvormen in het oude systeem dezelfde waarden hebben als in Shopware.
In Nederland maakt u vóór de productimport de btw-tarieven van 21 % en 9 % aan en vult u hun ID’s in het productbestand in. Verkoopt u ook in België, dan komen daar de Belgische tarieven bij. iDEAL (sinds 2026 als „iDEAL | Wero“, zie EPI) en Bancontact koppelt u via een betaalprovider met Shopware-extensie, bijvoorbeeld de plugin van Mollie. Betaalmethoden worden niet geïmporteerd maar in de shop ingericht. Voor klantgegevens geldt de AVG. Shopware-partners met een vestiging in Nederland of België vindt u in de partnergids van Shopware via het landenfilter.
Ongeacht het land geldt: neem alleen klanten over die u nog nodig hebt. Een verhuizing is een goede gelegenheid om inactieve accounts volgens uw bewaartermijnen op te schonen. Importbestanden met klantgegevens horen niet in e-mailbijlagen of open cloudmappen en worden na de import verwijderd. Meer hierover in het artikel Privacy in de webwinkel.
Voor bestellingen bevat de Shopware-documentatie een veldreferentie, maar geen stappenplan zoals voor producten of varianten. Als minimale velden noemt zij id, salesChannelId, orderDateTime en stateId. Daarbij komen orderregels, adressen, betaal- en verzendstatus, die elk aan eigen tabellen hangen.
Ons advies uit projecten: neem bestelgeschiedenis niet via CSV over als er een andere weg is.
Plant u een verhuizing vanaf een ander platform, kijk dan ook naar het artikel Overstappen van Shopware naar Shopify. Het laat vanuit de andere richting zien welke gegevens bij een platformwissel meestal verloren gaan.
Als u een nieuwe shop vult, bepaalt de volgorde de hoeveelheid werk. Elke stap heeft ID’s uit de vorige nodig. Deze volgorde heeft zich bewezen:
De import zelf is zelden het tijdsprobleem. Het werk zit in het voorbereiden van de gegevens. Als ruwe richtlijn uit onze projecten, zonder garantie voor uw situatie:
| Uitgangssituatie | Werk aan gegevensvoorbereiding |
|---|---|
| Tot 500 eenvoudige producten, nette leverancierslijst | 1 tot 2 werkdagen |
| 2.000 producten met varianten en afbeeldingen uit meerdere bronnen | 1 tot 2 weken |
| Volledige verhuizing met klanten, varianten en vertalingen | Onderdeel van een migratieproject, planning in weken |
De grootste tijdvreter is bijna altijd de kwaliteit van de brongegevens: ontbrekende artikelnummers, dubbele EAN, maten soms als M en soms als Medium. Plan een opschoning in voordat u het eerste bestand bouwt. Een testomgeving waarop u imports veilig kunt herhalen, bespaart in elk project tijd. Meer over versies en updates van de testomgeving leest u in het artikel Shopware updates en versies.
Voor terugkerende imports hoeft u niet elke keer de Administration te openen. Shopware heeft een consolecommando import:entity, dat volgens de commandoreferentie entiteiten uit een CSV-bestand importeert. De precieze argumenten toont bin/console import:entity --help op uw geïnstalleerde versie. Zo kunt u bijvoorbeeld elke nacht een voorraadlijst van de leverancier inlezen, aangestuurd via een cronjob op de server.
Let daarbij op twee punten:
messenger:consume, dan blijft vervolgwerk zoals indexering liggen. Goed ingerichte hosting regelt dat, meer in het artikel Shopware hosting.import-export:delete-expired verwijdert verlopen import- en exportbestanden. Vooral bij klantgegevens horen die niet blijvend op de server te staan.Bedient een geautomatiseerde CSV-import meer dan één gegevensbron of moet hij in beide richtingen werken, dan is hij meestal de voorloper van een echte koppeling. Vanaf dat punt loont een koppeling met voorraadbeheer of ERP.
Deze fouten zien wij in projecten het vaakst. De meeste zijn met tien minuten voorbereiding te voorkomen.
Een import schrijft meteen. Een verkeerd gekoppeld prijsveld wijzigt duizenden prijzen tegelijk, en afbreken maakt niets ongedaan. Test elk nieuw bestand eerst met de testrun en op een testomgeving. Vóór grotere updates hoort een databaseback-up erbij.
Wie bij een update de ID-kolom leeg laat en geen tweede sleutel zoals het artikelnummer heeft ingesteld, krijgt nieuwe producten in plaats van bijgewerkte. Uiteindelijk staan er dubbele producten in de shop. Zet bij pure updates het aanmaken van nieuwe records in het profiel uit.
Shopware wijst er zelf op dat de melding na de import niet betekent dat alles gelukt is. Controleer in het logboek hoeveel records zijn mislukt en download het foutbestand.
Een import voegt toe en overschrijft, hij verwijdert niet. Moet een product uit een categorie verdwijnen, dan is het niet genoeg om de categorie in het bestand weg te laten.
Veel shops bewaren gegevens in extensies, bijvoorbeeld extra velden voor gevaarlijke stoffen of eenheidsprijzen. Controleer vooraf of een plugin eigen importprofielen of velden meebrengt. Welke extensies zich hebben bewezen, leest u in het artikel Shopware 6 plugins.
Bij een relaunch veranderen product-URL’s. Zonder redirects verliest u rankings en links. Een CSV-import maakt wel nieuwe URL’s aan, maar geen redirects vanaf de oude. Die hebben een eigen lijst nodig.
Nee. De module Import/Export zit standaard in Shopware 6. Extensies uit de Shopware Store bieden extra formaten zoals XML of Excel, planningen en handigere toewijzingen. Voor de meeste situaties volstaat de standaard.
UTF-8 als codering, puntkomma als scheidingsteken, aanhalingstekens rond tekst en een punt als decimaalteken. Het veiligst begint u met een bestand dat u vooraf uit Shopware hebt geëxporteerd.
De documentatie bevat een veldreferentie voor bestellingen, maar geen handleiding. Voor verhuizingen van Shopware 5 of 6 is de Migration Assistant de betere weg, voor andere systemen meestal een import via de API.
Ja, als u de wachtwoord-hash en de methode in de velden legacyPassword en legacyEncoder overneemt en Shopware die methode ondersteunt. Anders stellen klanten hun wachtwoord eenmalig opnieuw in.
Dat kan niet. De import voegt toe of overschrijft. Verwijderen doet u in de Administration of via de API.
Veel webwinkeliers doen hun imports zelf, en met deze handleiding is dat voor producten, prijzen en klantenlijsten goed te doen. Komen varianten, vertalingen, wachtwoorden en redirects samen, dan groeit het risico dat fouten pas na de livegang opvallen.
Wij helpen op drie manieren:
Schrijf ons via de contactpagina welke gegevens u wilt overnemen en uit welk systeem ze komen. Wij zeggen u eerlijk of u dat goed zelf kunt.

Besnik Bilalli is oprichter en CEO van solution25, het Shopware-bureau uit Bremen. Vóór de oprichting van het bureau in 2017 heeft hij zelf een webshop opgebouwd en uitgebreid tot meer dan 500 bestellingen per dag. Sindsdien begeleidt hij handelaren bij Shopware-projecten, van de eerste calculatie tot het lopende beheer. Vragen over het artikel beantwoordt hij graag persoonlijk: neem contact op.
Verantwoordelijk voor inhoud en actualisering: Besnik Bilalli. Stand: november 2026. Volgende inhoudelijke controle: februari 2027.