Jak przenieść produkty, warianty, klientów i zamówienia do Shopware 6 przez CSV i jakich błędów uniknąć, także przy polskich znakach i stawkach VAT.
Import CSV w Shopware to wbudowany moduł Shopware 6, za pomocą którego przenoszą Państwo produkty, klientów, kategorie i inne dane z pliku CSV. Znajdą go Państwo w panelu administracyjnym w sekcji Ustawienia, Automatyzacja, Import/Eksport. Każdy plik przechodzi przez profil, który określa, która kolumna trafia do którego pola Shopware. Plik musi być zakodowany w UTF-8, używać średników jako separatorów i kropek jako separatora dziesiętnego.
Dla pojedynczych obszarów danych CSV to najszybsza droga, przy całkowitej zmianie systemu zwykle nie. Produkty, ceny, stany magazynowe i listy klientów dobrze obsługuje się przez CSV. Historię zamówień, opinie, adresy SEO i dokumenty przy przenosinach z Shopware 5 lub innej instancji Shopware 6 lepiej przenieść asystentem migracji. Bieżąca synchronizacja z systemem magazynowo-sprzedażowym wymaga integracji.
Większość błędów importu powstaje przed wgraniem pliku. Excel zmienia polskie znaki, separatory i zera wiodące, warianty wymagają stałej kolejności, a klienci bez przygotowania dostają e-maile rejestracyjne. Kto nie chce przeprowadzać importu samodzielnie: w abonamencie na sklep od solution25 zakładamy, zależnie od pakietu, do 200 lub 500 produktów, a w pakiecie Enterprise migracja danych jest wliczona.
Ten artykuł jest przeznaczony dla właścicieli sklepów w Polsce, osób odpowiedzialnych za e-commerce i deweloperów, którzy chcą przenieść dane do sklepu na Shopware 6: przy starcie nowego sklepu, przy relaunchu lub przy regularnej obsłudze dużych asortymentów. Dowiedzą się Państwo, która metoda pasuje do jakiego przypadku, jak przygotować profile i pliki oraz jak przenieść produkty, warianty, klientów i zamówienia bez utraty danych.
Moduł Import/Eksport należy do standardowego zakresu Shopware 6. Nie potrzeba do niego rozszerzenia. W panelu administracyjnym otwierają Państwo Ustawienia, Automatyzacja, Import/Eksport. Są tam trzy zakładki: Import, Eksport i Profile.
Shopware dostarcza profile standardowe, m.in. dla produktów, kategorii, właściwości, odbiorców newslettera i konfiguracji wariantów. Dokumentacja zawiera ponadto opisy pól dla klientów, zamówień, mediów, cen, cross-sellingu i kodów promocyjnych. Dla każdego z tych typów obiektów można zakładać własne profile.
Na starcie Shopware sprawdza każdy rekord. Poprawne wiersze zostają przejęte, błędne trafiają do osobnego pliku CSV z dodatkową kolumną _error. Ten plik pobierają Państwo, poprawiają i importują ponownie. Dziennik pokazuje importy z ostatnich 30 dni wraz z plikiem źródłowym, profilem i plikiem błędów.
Ważnym przyciskiem jest przebieg testowy (Dry Run). Wykonuje on cały import bez zapisywania danych. Dzięki temu widzą Państwo wcześniej, czy któreś wiersze się nie powiodą, i unikają częściowo zaimportowanego zbioru danych.
Import może dane tylko dodawać lub nadpisywać, nie może ich usuwać. Przykład z dokumentacji: przypisania do kanału sprzedaży, które raz zostało ustawione, nie usuną Państwo importem. Kto chce uporządkować przypisania, musi to zrobić w panelu administracyjnym lub przez API. Również przerwanie importu niczego nie cofa: rekordy zapisane do tego momentu pozostają w systemie.
Zanim przygotują Państwo pierwszy plik, warto ustalić, czy CSV jest w ogóle właściwym narzędziem. Shopware oferuje trzy sposoby wprowadzania danych do sklepu i każdy pasuje do innego przypadku.
| Metoda | Odpowiednia do | Ograniczenia |
|---|---|---|
| Import/Eksport CSV | Pierwsze wprowadzenie asortymentu, masowe zmiany cen i stanów magazynowych, listy klientów ze starego systemu | Brak usuwania, warianty tylko w kilku krokach, zamówienia bez standardowej instrukcji |
| Asystent migracji | Przenosiny z Shopware 5 lub innej instancji Shopware 6, według dokumentacji Shopware także z Magento | Metody płatności, Flow, dynamiczne grupy produktów i dane rozszerzeń trzeba założyć na nowo |
| API lub integracja | Bieżąca synchronizacja z systemem magazynowo-sprzedażowym, ERP lub PIM | Nakład pracy programistycznej, utrzymanie i monitorowanie integracji |
CSV sprawdza się, gdy dane przychodzą jednorazowo lub w dłuższych odstępach, a struktura jest przejrzysta. Typowe przypadki: sprzedawca startuje z 800 artykułami z listy dostawcy. Sklep przed Black Week zmienia ceny 2000 produktów. Hurtownia przenosi listę klientów ze starego portalu B2B. We wszystkich tych przypadkach dobrze przygotowany plik CSV importuje się w kilka minut.
Jeśli przechodzą Państwo z Shopware 5, proszę skorzystać z oficjalnego asystenta migracji. Według Shopware przenosi on media, kategorie, produkty, właściwości, producentów, opinie, cross-selling, klientów, zamówienia wraz z dokumentami, adresy SEO, odbiorców newslettera, listy życzeń i promocje. Odtworzenie tego przez CSV zajmuje wielokrotnie więcej czasu i gubi powiązania między danymi. Jak przebiegają takie przenosiny, opisujemy w artykule Migracja z Shopware 5 do Shopware 6.
Gdy dane muszą płynąć codziennie lub co godzinę, np. stany z magazynu albo zamówienia z powrotem do księgowości, ręczny import CSV to zła droga. Wtedy potrzebują Państwo integracji z systemem magazynowo-sprzedażowym. Jakie są systemy i jak działa integracja, opisuje artykuł Systemy ERP i magazynowe dla Shopware. W Polsce przy przekazywaniu zamówień do księgowości dochodzi jeszcze kwestia faktur w KSeF, której CSV nie rozwiązuje. Rozwiązaniem pośrednim są zautomatyzowane importy CSV z wiersza poleceń, o czym więcej poniżej.
Shopware oczekuje prawdziwego pliku CSV o stałych regułach. Dokumentacja wymienia trzy: UTF-8 jako kodowanie znaków, średnik jako separator pól, cudzysłowy wokół tekstów. Do tego przy liczbach dochodzi kropka jako separator dziesiętny, czyli 5.00, a nie 5,00, jak przyzwyczaja polski zapis.
Większość sprzedawców przygotowuje listy w Excelu. Przy zapisie jako CSV dzieją się wtedy trzy typowe rzeczy: polskie znaki (ą, ę, ł, ż) są źle kodowane, średniki zamieniają się w przecinki lub odwrotnie, a zera wiodące znikają. Z numeru artykułu 00451 robi się 451, a z 13-cyfrowego kodu EAN liczba w notacji naukowej. W polskiej wersji Excela dochodzi przecinek jako separator dziesiętny. Shopware zaleca więc w dokumentacji program zapisujący natywne pliki CSV i podaje jako przykład OpenOffice Calc. LibreOffice Calc lub edytor tekstu z wyborem kodowania działają równie dobrze.
Najpewniejsza droga do właściwej struktury: proszę ręcznie założyć dwa lub trzy produkty testowe, wyeksportować je profilem, którego później użyją Państwo do importu, i wykorzystać wyeksportowany plik jako szablon. Nazwy kolumn, kolejność i format będą wtedy na pewno prawidłowe. Na forum Shopware dokładnie tę drogę poleca się też przy komunikacie o nieobsługiwanym formacie pliku. Kilku użytkowników relacjonuje tam, że ten sam upload nie działał w Firefoksie, a działał w Chrome.
Profil to tłumacz między Państwa plikiem a bazą danych Shopware. Można zduplikować profil standardowy lub założyć nowy. Ważne: należy przy tym wybrać język domyślny systemu, w przeciwnym razie profil według dokumentacji nie zadziała.
Te dwa przełączniki to prosta funkcja ochronna. Przy samej aktualizacji cen proszę wyłączyć tworzenie rekordów. Wtedy literówka w numerze artykułu nie utworzy nowego, pustego produktu, tylko trafi jako błąd do pliku błędów.
W mapowaniu przypisują Państwo każdemu polu bazy danych nazwę kolumny. Dla każdego wiersza określają Państwo, czy pole jest obowiązkowe, jaką ma wartość domyślną i na której pozycji się znajduje. Po wgraniu istniejącego pliku CSV Shopware proponuje pola na podstawie wiersza nagłówka. Pola obowiązkowe system dodaje sam:
| Typ obiektu | Pola obowiązkowe według dokumentacji |
|---|---|
| Produkt | id, taxId, productNumber, stock, name |
| Klient | id, defaultBillingAddressId, defaultShippingAddressId, customerNumber, firstName, lastName, email |
| Kategoria | id, type, name |
Shopware pracuje wewnętrznie z długimi identyfikatorami UUID. Żaden stary system ich nie zna. W ustawieniach zaawansowanych profilu można więc określić drugą unikalną cechę, przy produktach zwykle numer artykułu (productNumber). Wtedy Shopware przy aktualizacji znajduje właściwy produkt po numerze. Proszę zadbać, aby ta cecha była naprawdę unikalna. Zduplikowane wartości powodują pomijanie rekordów.
Import produktów to najczęstszy przypadek i ten, w którym kryje się najwięcej szczegółów. Ze standardowym profilem produktów zajdą Państwo daleko, jeśli uwzględnią poniższe punkty.
Pola cen mają postać price.DEFAULT.net i price.DEFAULT.gross. DEFAULT oznacza walutę domyślną, w sklepie nastawionym na Polskę zwykle PLN. Proszę podać obie wartości lub wcześniej ustalić, która jest wiodąca. Częsty błąd to cena brutto przeliczana wstecz z niewłaściwą stawką podatku, przez co w sklepie pojawiają się nieokrągłe kwoty w groszach.
Plik produktów zna kolumny tax_id, tax_rate i tax_name. W tax_id należy wpisać UUID istniejącej stawki podatku. Jeśli pole pozostanie puste, Shopware według dokumentacji założy nową stawkę. Brzmi to niewinnie, ale szybko prowadzi do kilku zduplikowanych stawek o tym samym procencie, których później nikt nie potrafi rozróżnić. Identyfikatory UUID proszę wcześniej pobrać przez eksport lub z panelu administracyjnego.
Pole media przyjmuje adresy URL zdjęć produktów, zdjęcie główne ma osobne pole. Shopware pobiera zdjęcia z tych adresów. Zdjęcia muszą więc być publicznie dostępne. Linki z udostępnień w chmurze z datą wygaśnięcia lub z portalu dostawcy wymagającego logowania nie zadziałają. Przy dużych asortymentach opłaca się osobny folder na zdjęcia na serwerze, który po imporcie się opróżnia.
Produkty przypisuje się przez identyfikatory kategorii. Strukturę kategorii należy więc założyć przed produktami, ręcznie lub standardowym profilem kategorii. Tam parent_id określa kategorię nadrzędną. Identyfikator kategorii widać w pasku adresu panelu administracyjnego po otwarciu kategorii.
Teksty w kolejnych językach przechodzą przez pola według wzoru translations.DEFAULT, gdzie DEFAULT zastępuje się kodem języka, np. pl-PL lub en-GB. W sklepie wielojęzycznym proszę zaplanować dla każdego języka kolumnę na nazwę, opis i metadane. Shopware zaleca wykonanie kopii zapasowej bazy danych przed importem tłumaczeń.
Warianty to część, na której upada większość importów CSV. Powód: wariant jest powiązany z produktem głównym i z właściwościami, które muszą wcześniej istnieć. Dokumentacja Shopware opisuje więc cztery kroki.
Przy imporcie wariantów obowiązkowe są parent_id, product_number, active, stock i optionIds. Kilka identyfikatorów opcji rozdziela się pionową kreską, czyli id-czerwony|id-xl.
Generowanie jest szybsze, gdy ma istnieć każda kombinacja, a warianty różnią się tylko opcjami. Import jest lepszy, gdy trzeba przenieść własne numery artykułów, EAN, stany lub ceny dla każdego wariantu. W praktyce często łączymy oba sposoby: generujemy warianty, a potem uzupełniamy numery, stany i ceny importem aktualizującym. To wartość z doświadczenia projektowego, a nie wymóg Shopware.
Hipotetyczny sprzedawca odzieży ma 300 koszulek, każdą w 5 rozmiarach i 4 kolorach. To 300 produktów głównych, 2 grupy właściwości z 9 opcjami, 2 700 wierszy konfiguracji wariantów (300 razy 9) i 6 000 wariantów (300 razy 20). Kto chce zmieścić to w jednym pliku, poniesie porażkę. W czterech starannie rozdzielonych plikach to przejrzysty import.
Przy imporcie klientów chodzi o więcej niż imiona i adresy. Trzy punkty decydują o tym, czy przenosiny pozostaną dla Państwa klientów niezauważone.
Shopware przy zakładaniu klienta wysyła e-mail rejestracyjny. Przy 5 000 zaimportowanych klientów oznaczałoby to 5 000 wiadomości do osób, które wcale nie rejestrowały się ponownie. Dokumentacja zaleca więc, aby przed importem wyłączyć wysyłkę e-maili w sekcji Ustawienia, System, Mailer, a po imporcie włączyć ją ponownie.
Klienci powinni po przenosinach logować się starym hasłem. Shopware przewiduje do tego pola legacyPassword i legacyEncoder. Zawierają one zaszyfrowany hash ze starego systemu i metodę, którą go wygenerowano. Gdy klient się loguje, Shopware sprawdza stare hasło i zapisuje je ponownie we własnym formacie. Hasła w postaci jawnego tekstu nie mają czego szukać w pliku importu. Jeśli Shopware nie obsługuje metody starego systemu, pozostaje e-mail z resetem hasła po starcie sklepu.
Każdy klient potrzebuje domyślnego adresu rozliczeniowego i domyślnego adresu dostawy. U klientów B2B dochodzą grupa klientów, nazwa firmy i NIP (numer VAT UE). Grupy klientów należy założyć wcześniej i sprawdzić, czy kraje i formy grzecznościowe w starym systemie mają te same wartości co w Shopware.
W Polsce przed importem produktów zakłada się podstawową stawkę VAT 23% oraz potrzebne stawki obniżone i wpisuje ich identyfikatory do pliku produktów. Dane klientów podlegają RODO. Jeśli Państwa pliki importu przetwarza agencja lub usługodawca, należy wcześniej zawrzeć umowę powierzenia przetwarzania danych osobowych zgodnie z art. 28 RODO.
Niezależnie od kraju obowiązuje zasada: proszę przenosić tylko tych klientów, których Państwo jeszcze potrzebują. Przenosiny to dobra okazja, aby usunąć nieaktywne konta zgodnie z przyjętymi okresami przechowywania. Pliki importu z danymi klientów nie powinny trafiać do załączników e-mail ani otwartych folderów w chmurze i po imporcie należy je usunąć. Więcej na ten temat w artykule Ochrona danych w sklepie internetowym.
Dla zamówień dokumentacja Shopware zawiera opis pól, ale nie instrukcję krok po kroku jak dla produktów czy wariantów. Jako pola minimalne wymienia id, salesChannelId, orderDateTime i stateId. Do tego dochodzą pozycje, adresy, status płatności i wysyłki, z których każdy jest powiązany z osobnymi tabelami.
Nasza rekomendacja z projektów: proszę nie przenosić historii zamówień przez CSV, jeśli istnieje inna droga.
Jeśli planują Państwo przenosiny z innego systemu, warto zajrzeć do artykułu Przejście z Shopware na Shopify. Pokazuje on z odwrotnej perspektywy, które dane zwykle giną przy zmianie platformy.
Przy zasilaniu nowego sklepu kolejność decyduje o nakładzie pracy. Każdy krok potrzebuje identyfikatorów z poprzedniego. Sprawdził się następujący przebieg:
Sam import rzadko jest problemem czasowym. Praca tkwi w przygotowaniu danych. Jako zgrubna orientacja z naszych projektów, bez gwarancji dla Państwa przypadku:
| Sytuacja wyjściowa | Nakład pracy na przygotowanie danych |
|---|---|
| Do 500 prostych produktów, uporządkowana lista dostawcy | 1 do 2 dni roboczych |
| 2000 produktów z wariantami i zdjęciami z kilku źródeł | 1 do 2 tygodni |
| Pełne przenosiny z klientami, wariantami i tłumaczeniami | Część projektu migracji, planowanie w tygodniach |
Największym pożeraczem czasu jest niemal zawsze jakość danych źródłowych: brakujące numery artykułów, zduplikowane EAN, rozmiary raz jako M, raz jako Medium. Proszę zaplanować porządkowanie danych, zanim przygotują Państwo pierwszy plik. Instancja testowa, na której można bezpiecznie powtarzać importy, oszczędza czas w każdym projekcie. O wersjach i aktualizacjach środowiska testowego przeczytają Państwo więcej w artykule Aktualizacje i wersje Shopware.
Przy powtarzalnych importach nie trzeba za każdym razem otwierać panelu administracyjnego. Shopware ma polecenie konsoli import:entity, które według dokumentacji poleceń importuje encje z pliku CSV. Dokładne argumenty pokazuje bin/console import:entity --help w Państwa zainstalowanej wersji. Można w ten sposób np. co noc wczytywać listę stanów magazynowych od dostawcy, sterowaną zadaniem cron na serwerze.
Należy przy tym pamiętać o dwóch kwestiach:
messenger:consume, prace następcze, takie jak indeksowanie, pozostają niewykonane. Prawidłowo skonfigurowany hosting to zapewnia, więcej w artykule Hosting Shopware.import-export:delete-expired usuwa wygasłe pliki importu i eksportu. Zwłaszcza pliki z danymi klientów nie powinny pozostawać na serwerze na stałe.Jeśli automatyczny import CSV obsługuje więcej niż jedno źródło danych lub ma działać w obu kierunkach, jest zwykle zapowiedzią prawdziwej integracji. Od tego momentu opłaca się połączenie z systemem magazynowo-sprzedażowym lub ERP.
Te błędy widzimy w projektach najczęściej. Większości można uniknąć dzięki dziesięciu minutom przygotowań.
Import zapisuje dane natychmiast. Źle zmapowane pole ceny zmienia naraz tysiące cen, a przerwanie niczego nie cofa. Każdy nowy plik proszę najpierw przetestować przebiegiem testowym i w środowisku testowym. Przed większymi aktualizacjami należy wykonać kopię zapasową bazy danych.
Kto przy aktualizacji zostawi pustą kolumnę ID i nie ustawi drugiej cechy, takiej jak numer artykułu, otrzyma nowe produkty zamiast zaktualizowanych. W efekcie w sklepie pojawiają się duplikaty. Przy samych aktualizacjach proszę wyłączyć w profilu tworzenie nowych rekordów.
Shopware sam zaznacza, że komunikat po imporcie nie oznacza, że wszystko się udało. Proszę sprawdzić w dzienniku, ile rekordów się nie powiodło, i pobrać plik błędów.
Import dodaje i nadpisuje, ale nie usuwa. Jeśli produkt ma zniknąć z kategorii, nie wystarczy pominąć kategorii w pliku.
Wiele sklepów przechowuje dane w rozszerzeniach, np. dodatkowe pola dla towarów niebezpiecznych lub cen jednostkowych. Czy wtyczka ma własne profile importu lub pola, należy sprawdzić wcześniej. Które rozszerzenia się sprawdziły, opisujemy w artykule Wtyczki do Shopware 6.
Przy relaunchu zmieniają się adresy URL produktów. Bez przekierowań tracą Państwo pozycje i linki. Import CSV tworzy wprawdzie nowe adresy URL, ale nie przekierowania ze starych. Do tego potrzebna jest osobna lista.
Nie. Moduł Import/Eksport jest częścią Shopware 6. Rozszerzenia z Shopware Store oferują dodatkowe formaty, takie jak XML lub Excel, harmonogramy i wygodniejsze przypisywanie pól. W większości przypadków wystarcza standard.
Kodowanie UTF-8, średnik jako separator, cudzysłowy wokół tekstów i kropka jako separator dziesiętny. Najbezpieczniej zacząć od pliku wcześniej wyeksportowanego z Shopware.
Dokumentacja zawiera opis pól dla zamówień, ale nie instrukcję. Przy przenosinach z Shopware 5 lub 6 lepszą drogą jest asystent migracji, przy innych systemach zwykle import przez API.
Tak, jeśli przeniosą Państwo hash hasła i metodę do pól legacyPassword i legacyEncoder, a Shopware obsługuje tę metodę. W przeciwnym razie klienci jednorazowo ustawiają nowe hasło.
Nie da się. Import dodaje lub nadpisuje. Usuwanie wykonuje się w panelu administracyjnym lub przez API.
Proszę zapisywać plik w UTF-8 programem, który pozwala wybrać kodowanie, np. LibreOffice Calc, i sprawdzić po imporcie kilka produktów z literami ą, ę, ł czy ż. Jeśli w sklepie pojawiają się krzaczki, plik został zapisany w innym kodowaniu, np. Windows-1250.
Wielu sprzedawców przeprowadza importy samodzielnie i dzięki tej instrukcji jest to dobrze wykonalne dla produktów, cen i list klientów. Gdy dochodzą warianty, tłumaczenia, hasła i przekierowania, rośnie ryzyko, że błędy wyjdą na jaw dopiero po starcie sklepu.
Wspieramy na trzy sposoby, także sklepy działające w Polsce:
Proszę napisać do nas przez stronę kontaktową, jakie dane chcą Państwo przenieść i z jakiego systemu pochodzą. Uczciwie powiemy, czy dadzą Państwo radę zrobić to samodzielnie.

Besnik Bilalli jest założycielem i CEO solution25, agencji Shopware z Bremy. Przed założeniem agencji w 2017 r. sam zbudował sklep internetowy, który osiągnął ponad 500 zamówień dziennie. Od tego czasu wspiera sprzedawców w projektach Shopware, od pierwszej kalkulacji po bieżącą eksploatację. Na pytania dotyczące artykułu chętnie odpowie osobiście: formularz kontaktowy.
Odpowiedzialny za treść i aktualizację: Besnik Bilalli. Stan: listopad 2026 r. Następny przegląd merytoryczny: luty 2027 r.