Brak stabilnego klucza
Bez jasno ustalonego SKU lub innego identyfikatora sklep nie wie, czy produkt utworzyć, zaktualizować, pominąć czy zgłosić jako konflikt.
Shoper · import CSV/XML · dane produktowe
Import produktów CSV/XML do Shoper z kontrolą SKU, EAN, wariantów i stanów
Przygotowujemy import produktów do Shopera jako proces, nie jednorazowe wgranie pliku. Porządkujemy mapowanie kolumn, SKU, EAN, warianty, kategorie, atrybuty, zdjęcia, ceny, stany, opisy i logi błędów, żeby po imporcie katalog nadawał się do sprzedaży, SEO i kolejnych aktualizacji.
CSV / XML / XLSX
mapowanie i walidacja
Shoper katalog
SKUklucz aktualizacjiOK
EANkod produktuOK
VARrozmiar / kolormapa
IMGgaleria zdjęćsync
Dobry import ma próbkę testową, walidację, raport błędów i jasną logikę: co tworzymy, co aktualizujemy, a czego nie publikujemy bez kontroli.
Problem
Dlaczego import produktów do Shoper często kończy się bałaganem w katalogu?
To, że plik CSV lub XML przechodzi przez importer, nie znaczy jeszcze, że sklep będzie działał poprawnie. Najdroższe błędy wychodzą później: w filtrach, wariantach, opisach, kategoriach, stanach i ręcznym poprawianiu produktów po publikacji.
Ta strona dotyczy katalogu w konkretnym sklepie na Shoperze. Jeżeli szukasz procesu, który cyklicznie przenosi dane między hurtownią, ERP-em, BaseLinkerem i sklepem, właściwym miejscem jest automatyzacja importu i eksportu CSV/XML/API.
Warianty rozbijają produkty
Rozmiary, kolory i modele przychodzą jako osobne wiersze. Trzeba je zgrupować, żeby karta produktu nie stała się listą duplikatów.
Kategorie dostawcy nie pasują
Struktura z hurtowni rzadko odpowiada strukturze sklepu. Bez mapowania import tworzy przypadkowe ścieżki i słabe SEO.
Atrybuty nie działają w filtrach
Jeżeli ten sam parametr ma kilka nazw lub formatów, klient nie przefiltruje oferty, a listing traci wartość sprzedażową.
Zdjęcia nie trafiają do produktów
Linki wygasają, nazwy plików się nie zgadzają, kolejność galerii jest przypadkowa albo zdjęcia wariantów mieszają się między produktami.
Brak walidacji przed publikacją
Produkty bez ceny, stanu, EAN-u, zdjęcia, kategorii albo opisu trafiają do sklepu i dopiero wtedy zaczyna się ręczne gaszenie pożarów.
Zakres importu
Co przygotowujemy przed wgraniem produktów do Shopera?
Import traktujemy jak proces danych produktowych, który później pozwala aktualizować ceny, stany, opisy, zdjęcia i kategorie bez przepisywania całego sklepu ręcznie.
Na etapie próbki pokazujemy mapowanie kolumn: SKU, EAN, model, kolor, rozmiar, stock, cena, kategoria i zdjęcia. Rekordy kompletne idą do importu, a braki w wariantach, cenach albo relacjach parent-child trafiają do review zamiast psuć katalog.
Jeżeli import ma działać regularnie z hurtownią, warto wcześniej porównać API, XML i CSV jako źródła danych, bo każdy format inaczej wpływa na aktualność stanów, błędy i utrzymanie procesu.
Analiza pliku
Sprawdzamy kolumny, kodowanie, separatory, duplikaty, puste pola, formaty liczb, walut i identyfikatorów.
Mapowanie pól Shoper
Łączymy dane z polami sklepu: nazwa, SKU, EAN, cena, stan, producent, kategoria, opis, zdjęcia i cechy.
Warianty i rodziny
Ustalamy reguły grupowania po modelu, kolorze, rozmiarze, kolekcji lub innym kluczu biznesowym.
Kategorie i ścieżki
Mapujemy kategorie dostawcy na strukturę sklepu, żeby katalog wspierał UX, SEO i dalszą rozbudowę oferty.
Atrybuty i filtry
Normalizujemy rozmiary, kolory, materiał, sezon, markę, przeznaczenie i parametry techniczne produktów.
Zdjęcia i galerie
Sprawdzamy źródła zdjęć, kolejność, dostępność plików, miniatury i przypisanie zdjęć do wariantów.
Walidacja i logi
Tworzymy raport pozycji błędnych, podejrzanych i gotowych do publikacji, zanim pełny wsad trafi do sklepu.
Aktualizacje cykliczne
Projektujemy proces tak, żeby późniejsze aktualizacje stanów, cen i opisów nie wymagały ręcznej pracy zespołu.
Walidacja
Przed importem trzeba wiedzieć, czego nie publikować
Najważniejszy etap to nie kliknięcie importu, tylko wychwycenie błędów. Dobrze przygotowany proces jasno rozróżnia produkty gotowe, wymagające poprawy i takie, których nie wolno aktualizować automatycznie.
- wykrywanie pustych SKU, EAN, cen, nazw, stanów i kategorii,
- kontrola duplikatów, błędnych wariantów i konfliktów kluczy,
- sprawdzenie linków do zdjęć oraz przypisania galerii,
- normalizacja atrybutów, rozmiarów, kolorów i parametrów,
- testowy import na próbce przed publikacją pełnego katalogu.
EtapRyzykoKontrola
SKUduplikatyklucz aktualizacji
EANbraki i błędywalidacja długości
Wariantyrozbite produktygrupowanie rodzin
Zdjęciapuste galeriesprawdzenie URL
Kategoriechaos SEOmapa docelowa
Proces
Jak wygląda bezpieczny import CSV/XML do Shoper?
01
Analiza źródła
Sprawdzamy plik od dostawcy, ERP, hurtowni lub eksport z obecnego sklepu i opisujemy strukturę danych.
02
Mapa pól
Ustalamy, które kolumny trafiają do konkretnych pól Shopera i które dane wymagają normalizacji przed importem.
03
Próbka testowa
Importujemy mały zakres produktów, żeby sprawdzić kategorie, warianty, zdjęcia, filtry, SEO i kartę produktu.
04
Raport błędów
Zamiast ręcznie szukać problemów w panelu, dostajesz listę produktów do poprawy i decyzji do podjęcia.
05
Publikacja i aktualizacje
Po akceptacji wdrażamy pełny wsad lub przygotowujemy cykliczny proces aktualizacji cen, stanów i danych.
Efekt
Katalog produktów jest gotowy do sprzedaży, a nie tylko wgrany do panelu
Po dobrze przygotowanym imporcie zespół ma mniej ręcznych poprawek, klient ma lepszy listing i kartę produktu, a sklep łatwiej rozwija się o SEO, automatyzacje i integracje.
Mniej ręcznego sprzątania
Błędy trafiają do raportu przed publikacją, a nie do sklepu jako problemy widoczne dla klientów.
Lepsze filtry i warianty
Atrybuty, rozmiary, kolory i rodziny produktów są uporządkowane pod UX listingu i kartę produktu.
Proces gotowy do automatyzacji
Ten sam model danych można później wykorzystać do Shoper API, ERP, BaseLinkera, opisów AI lub aktualizacji stanów.
Źródła danych
Skąd realnie przychodzą produkty do sklepu na Shoperze
Format źródła zmienia nie tyle sam import, co sposób jego utrzymania: co zrobić, gdy plik nie przyjdzie, gdy zmieni się kolumna albo gdy dostawca usunie produkt bez uprzedzenia.
| Źródło | Typowe zastosowanie | Na co uważać | Nadaje się do cyklu |
|---|---|---|---|
| CSV od dostawcy | pierwsze zasilenie katalogu | kodowanie, separator, cudzysłowy w opisach | tak, przy stałej strukturze |
| XML / feed hurtowni | warianty i zagnieżdżone atrybuty | zmiany schematu bez zapowiedzi | tak |
| Excel (XLSX) | dane przygotowane ręcznie | formaty liczb, daty, scalone komórki | raczej nie |
| API hurtowni | stany i ceny w ciągu dnia | limity zapytań, paginacja, autoryzacja | tak |
| Eksport z innego sklepu | migracja katalogu | ID i URL-e nie przenoszą się wprost | jednorazowo |
Mapowanie i walidacja
Co sprawdzamy przy każdym polu, zanim cokolwiek trafi do sklepu
To jest dokument roboczy importu. Każdy wiersz opisuje jedno pole: skąd przychodzi, jak jest sprawdzane, gdzie ląduje i co się dzieje, gdy nie przejdzie kontroli.
| Dane wejściowe | Walidacja | Dane docelowe | Możliwy błąd |
|---|---|---|---|
| kod dostawcy | niepusty, unikalny w pliku | SKU produktu | duplikat nadpisze inny produkt |
| kod kreskowy | 8–14 cyfr, suma kontrolna | EAN | błędny EAN psuje feedy i marketplace |
| nazwa | długość, brak kodów w nazwie | nazwa produktu | nazwa techniczna zamiast handlowej |
| cena netto | liczba, separator, waluta | cena brutto wg stawki VAT | przecinek jako separator tysięcy |
| stan | liczba całkowita, nieujemna | stan magazynowy | tekst „dostępny” zamiast liczby |
| ścieżka kategorii | istnieje w mapie kategorii | kategoria sklepu | nowa gałąź tworzona przypadkiem |
| rozmiar / kolor | wartość ze słownika | wariant produktu | „XL” i „xl” jako dwa warianty |
| URL zdjęcia | odpowiedź 200, typ pliku | galeria produktu | pusta galeria po imporcie |
| opis | dozwolony HTML, brak skryptów | opis produktu | rozjechany layout karty |
Przykład jednego rekordu (dane anonimowe)
Kolumna źródłaWartośćPo mapowaniu
idx_towaruAB-1042-BLK-MSKU
kod_kreskowy590123412345EAN
cena_n129,90159,78 brutto (23%)
ilosc7stan: 7
grupaODZIEZ/KURTKI/SOFTSHELLKurtki → Softshell
wariantMrozmiar: M (rodzina AB-1042-BLK)
Rekordy o tym samym kluczu rodziny łączymy w jeden produkt z wariantami, zamiast tworzyć osobne karty dla każdego rozmiaru.
Import jednorazowy a utrzymywana synchronizacja
| Aspekt | Import jednorazowy | Synchronizacja |
|---|---|---|
| Cel | zbudować katalog | utrzymać go aktualnym |
| Klucz | ważny | krytyczny — bez niego nadpiszesz nie ten produkt |
| Pola nadpisywane | wszystkie | tylko uzgodnione (zwykle cena i stan) |
| Opisy i SEO | tworzone | chronione przed nadpisaniem |
| Produkty usunięte u dostawcy | nie dotyczy | wymagają reguły: ukryj czy wyzeruj stan |
| Utrzymanie | brak | harmonogram, alerty, archiwum plików |
Wycena
Co realnie przesuwa koszt importu
Nie liczba produktów jest głównym czynnikiem. Dwadzieścia tysięcy czystych rekordów bywa prostsze niż dwa tysiące z chaotycznymi wariantami.
- jakość źródła: jeden spójny plik czy kilka niekompatybilnych eksportów,
- warianty: czy da się wskazać regułę grupowania, czy trzeba ją zbudować,
- kategorie: gotowa mapa czy mapowanie od zera,
- zdjęcia: dostępne pod URL-em czy do pobrania i przetworzenia,
- tryb pracy: jednorazowy import czy utrzymywany proces z harmonogramem,
- stan katalogu: pusty sklep czy aktualizacja działającej oferty.
Bezpieczeństwo wdrożenia
Każdy import musi być odwracalny
- kopia katalogu przed pierwszym zapisem masowym,
- dry run na próbce z raportem, bez zapisu do sklepu,
- publikacja partiami, z kontrolą po pierwszej paczce,
- lista produktów zmienionych w danym przebiegu,
- możliwość wycofania partii bez ruszania reszty katalogu,
- raport końcowy: zapisane, pominięte, odrzucone i dlaczego.
Materiały
Zacznij od gotowego wzoru pliku, nie od pustego arkusza
Dwa pliki, których używamy na starcie każdego importu. Pierwszy pokazuje strukturę wiersza i poprawnie zapisany EAN, drugi jest listą kontrolną wariantów przed zapisem do sklepu. Możesz je wypełnić własnymi danymi i przysłać zamiast opisu.
Wzór importu produktów (UTF-8)
Nagłówki kolumn, jedna rodzina wariantowa, EAN zapisany jako tekst z zerem wiodącym i separator, który nie rozjeżdża się po otwarciu w arkuszu.
Pobierz wzór CSVMacierz kontroli wariantów
Sprawdzenia dla rozmiarów, kolorów i rodzin: klucz grupowania, kompletność kombinacji, duplikaty SKU, braki EAN.
Pobierz macierz wariantówInstrukcja przygotowania pliku
Co reprezentuje jeden wiersz, jakie kodowanie i separator ustawić oraz jak nie zgubić zera wiodącego w EAN-ie.
Otwórz poradnik
Po co to jest. Jeżeli przyślesz wypełniony wzór, pierwszą odpowiedź dostaniesz z konkretami: co da się zaimportować bez zmian, które kolumny wymagają normalizacji i które wiersze odrzuci walidacja. Dalej w temacie: walidacja wariantów przed importem i checklista importu produktów.
FAQ
Import do Shopera — pytania
Tak, ale plik zwykle trzeba najpierw dopasować do struktury sklepu: SKU, EAN, wariantów, kategorii, atrybutów, zdjęć, cen i stanów. Bez tego import może technicznie przejść, ale zostawić bałagan w katalogu.
Jednorazowy import tworzy katalog, a proces aktualizacji cyklicznie zmienia ceny, stany, opisy lub zdjęcia. Przy aktualizacjach najważniejszy jest stabilny klucz, żeby nie nadpisywać złych produktów.
Tak, jeżeli w danych da się wskazać regułę grupowania, na przykład model, kolor, rozmiar, kod rodziny lub inny wspólny identyfikator. Takie mapowanie trzeba przetestować przed pełnym importem.
Tak, ale trzeba sprawdzić dostępność URL-i lub plików, kolejność galerii, zdjęcia wariantów i sytuacje, w których dostawca nie udostępnia kompletu grafik.
Tak. Raport jest kluczowy, bo pokazuje produkty bez wymaganych danych, konflikty SKU, błędne warianty, braki zdjęć i rekordy, których nie powinno się publikować automatycznie.
Tak. Dobrze przygotowane mapowanie danych ułatwia późniejsze integracje API, aktualizacje stanów i cen, eksport zamówień, automatyzacje opisów oraz synchronizację z ERP lub BaseLinkerem.
Masz plik CSV/XML i nie chcesz ręcznie sprzątać produktów po imporcie?
Wyślij przykładowy plik albo opisz źródło danych. Sprawdzimy strukturę, ryzyka i najlepszą ścieżkę importu do Shoper.