Import produktów na Media Expert – plik, mapowanie i raport błędów

Import i aktualizacja ofert plikiem

Gdy produkty są już w katalogu, codzienna praca dotyczy głównie ofert: cen, stanów i czasu wysyłki. Najprostszą metodą masowej zmiany jest plik inwentarzowy. W zakładce Cena i zapas → Oferty wybierasz Eksportuj → Gotowe do importu (CSV lub XLSX), edytujesz potrzebne kolumny i wgrywasz plik z powrotem w Importach plików jako zawartość „Oferty”.

Przy zmianie jednego pola zostaw w pliku tylko kolumnę sku i kolumnę, którą aktualizujesz – tak zaleca Centrum Pomocy przy zmianie cen i stanów. Mniej kolumn oznacza mniej okazji do przypadkowej zmiany innych danych. Przed wgraniem pliku zachowaj też kopię eksportu w niezmienionej postaci – jeśli coś pójdzie nie tak, łatwo przywrócisz poprzednie ceny i stany. Przy dużych zmianach, np. przed akcją promocyjną, przetestuj plik na kilku ofertach, a dopiero potem zaimportuj resztę. To kilka minut pracy, które oszczędzają godziny wyjaśniania, skąd w panelu wzięły się błędne ceny.

[#wazne] Tryb importu „Usuń i zastąp” traktuje plik jako pełną listę ofert. Wszystko, czego w nim nie ma, zostanie usunięte. Źle przygotowany plik w tym trybie może skasować wszystkie dotychczas wgrane oferty, dlatego do codziennych aktualizacji używaj trybu zwykłego.

Raport błędów importu – jak go czytać i poprawiać

Po każdym imporcie warto sprawdzić wynik, zanim wgrasz kolejny plik. Panel pokazuje status importu, a przy problemach – szczegóły błędów dla poszczególnych wierszy. W API Mirakl odpowiadają temu osobne metody do statusu importu i raportu błędów zarówno dla ofert, jak i produktów, co wykorzystują integratory.

Wykres – najczęstsze przyczyny błędów w raporcie importu i sposób ich naprawy. [#chart:me12b]

1. Pobierz raport i posortuj błędy według typu, a nie według wierszy – zwykle kilka przyczyn odpowiada za większość problemów.

2. Popraw dane w pliku źródłowym, a nie tylko w raporcie – inaczej błąd wróci przy następnym imporcie.

3. Wgraj ponownie tylko poprawione wiersze, żeby nie dublować pracy i szybciej zweryfikować efekt.

4. Sprawdź statusy kart w Zarządzaniu katalogiem – import może się udać technicznie, a karta i tak trafi do statusu „Wymagane zmiany” po weryfikacji.

5. Zgłoś brakujące wartości słownikowe opiekunowi lub supportowi zamiast wpisywać wartości „zastępcze”.

Osobny przypadek to błąd „The discount date range is incorrect”. Pojawia się, gdy nowe daty promocji kolidują z wcześniej zapisanymi. Rozwiązanie z Centrum Pomocy: wyfiltruj oferty z wypełnionymi datami promocji, w pliku zostaw tylko te wiersze, wyczyść daty i cenę promocyjną, ustaw w kolumnie update-delete wartość update i zaimportuj plik. Potem możesz ustawić nowe ramy czasowe.

Import ręczny czy integracja

Import z pliku dobrze sprawdza się przy starcie i przy katalogu, który rzadko się zmienia. Jeśli jednak sprzedajesz w kilku kanałach, a ceny i stany zmieniają się codziennie, ręczne pliki szybko staną się źródłem rozbieżności. Wtedy lepszym rozwiązaniem jest integracja – Media Expert wskazuje w Centrum Pomocy integracje z Base, Apilo i Sellasist oraz klucz API dla własnych systemów.

• Import z pliku – pełna kontrola, brak dodatkowych kosztów, ale ręczna praca przy każdej zmianie.

• Integrator – automatyczna synchronizacja stanów i cen, wystawianie z jednego miejsca na wiele kanałów; ręczne zmiany w panelu zostaną nadpisane.

• API – dla firm z własnym ERP lub sklepem, wymaga pracy programisty.

Jak wygląda podłączenie integratorów, omawiamy w tekście o integracji sklepu z marketplace Media Expert, a o automatyzacji przez interfejs programistyczny – w artykule o API Media Expert. Jeśli Twoje produkty pochodzą z plików hurtowni, przyda się też poradnik o imporcie produktów z plików XML i CSV.

Przykład: import 300 akcesoriów z eksportu sklepu

[#przyklad] Sklep z akcesoriami komputerowymi ma 300 produktów w swoim sklepie internetowym: kable, huby USB, podkładki, torby na laptopy. Zaczyna od eksportu katalogu do pliku CSV w UTF-8 z kolumnami: EAN, SKU, nazwa, marka, model, kategoria sklepu, kolor, długość kabla, typ złącza, adresy zdjęć i opis. Najpierw sprawdza w panelu kilka losowych kodów EAN i okazuje się, że około jednej trzeciej produktów ma już karty w katalogu Media Expert.

Dla tej grupy przygotowuje szablon ofert i importuje tylko ceny, stany, czas wysyłki i klasy logistyczne. Pozostałe produkty wgrywa kreatorem mapowania: łączy 12 kategorii sklepu z najniższymi kategoriami platformy, mapuje kolumny na atrybuty i ujednolica wartości, np. „1m”, „1 m” i „100 cm” do jednej wartości ze słownika. Regułą odrzuca produkty bez EAN, żeby nie zaśmiecać raportu. Po imporcie raport wskazuje kilkanaście kart z brakującym atrybutem – sprzedawca dodaje kolumnę w pliku bazowym i wgrywa tylko te wiersze ponownie. Na koniec dodaje oferty do nowych kart szablonem ofert. Jeśli dane pochodzą z systemu do sprzedaży wielokanałowej, podobny eksport przygotujesz według wskazówek z tekstu o eksporcie produktów do plików XML i CSV.

Najczęstsze błędy przy imporcie produktów

Raporty błędów różnią się szczegółami, ale przyczyny powtarzają się u większości sprzedawców. Poniższa lista pozwala wyłapać je jeszcze przed wgraniem pliku.

• Import ofert przed produktami – oferta nie podepnie się do karty, której jeszcze nie ma w katalogu.

• Kategorie z wyższego poziomu drzewa – brakuje wtedy atrybutów wymaganych w podkategorii, a stawka prowizji może być nieprawidłowa.

• Jedna kolumna na kilka parametrów – np. „czarny, 2 m, USB-C” w jednej komórce zamiast trzech osobnych atrybutów.

• Zmiana formatu przez arkusz – kody EAN zapisane jako liczby tracą zera wiodące albo zamieniają się w notację naukową.

• Zdjęcia niedostępne publicznie – adresy wymagające logowania lub tymczasowe linki z dysku w chmurze.

• Kopiowanie opisów od konkurencji – regulamin wymaga opisów bez plagiatu, a takie karty mogą zostać odrzucone.

• Kilka importów naraz – kolejny plik wgrany przed zakończeniem poprzedniego utrudnia ustalenie, który import spowodował błąd.

[#checklista] Przed każdym importem: EAN zapisane jako tekst; SKU unikalne i ostateczne; kategorie na najniższym poziomie; parametry w osobnych kolumnach; wartości zgodne ze słownikiem; ceny z kropką; plik w UTF-8; tryb importu zwykły.

Najczęściej zadawane pytania

Czy kreatorem mapowania mogę dodać od razu oferty?

Nie. Według Centrum Pomocy kreator mapowania pozwala dodać tylko produkty. Oferty – cenę, stan i warunki wysyłki – uzupełniasz osobno, np. szablonem ofert lub ręcznie w panelu.

W jakim formacie zapisać plik do kreatora?

Kreator przyjmuje pliki XLSX lub CSV zakodowane w UTF-8. Inne kodowanie zwykle psuje polskie znaki w nazwach i opisach, więc przy eksporcie z arkusza wybierz wprost opcję CSV UTF-8.

Jak zaktualizować ceny wielu ofert naraz?

Wyeksportuj oferty jako plik gotowy do importu, zostaw kolumny sku i price, wpisz nowe ceny w formacie z kropką i zaimportuj plik jako oferty w trybie zwykłym.

Dlaczego po imporcie produkt ma status „Wymagane zmiany”?

Import się udał, ale weryfikator znalazł problem w karcie – najczęściej w nazwie, zdjęciach lub opisie. Otwórz kartę w Zarządzaniu katalogiem, sprawdź uwagi i popraw dane.

Czy mogę zmienić SKU oferty przez import?

Nie. SKU oferty jest stałe. Jeśli musisz je zmienić, usuń ofertę i dodaj ją ponownie z nowym SKU.

Czy import z pliku koliduje z integratorem?

Tak, jeśli oba źródła aktualizują te same oferty. Przy aktywnej synchronizacji zmiany z integratora nadpiszą dane z pliku, dlatego wybierz jedno źródło prawdy dla cen i stanów.

Ile produktów mogę zaimportować jednym plikiem?

Centrum Pomocy nie podaje sztywnego limitu dla sprzedawców. W praktyce bezpieczniej importować katalog partiami, np. według grup kategorii – łatwiej wtedy czytać raporty błędów i szybciej poprawiać problemy.

Podsumowanie

Skuteczny import produktów na Media Expert zaczyna się od decyzji, co importujesz – karty czy oferty – i od uporządkowanych danych: EAN, SKU, kategorii i parametrów zgodnych ze słownikami. Szablon XLSX sprawdzi się przy nowym asortymencie, kreator mapowania przy własnym katalogu, a plik inwentarzowy przy codziennych zmianach cen i stanów. Po każdym imporcie czytaj raport błędów i poprawiaj dane u źródła. Aktualne instrukcje znajdziesz w Centrum Pomocy dla Sprzedawców.

Wdrażamy i obsługujemy sprzedaż na marketplace’ach, w tym na Media Expert – przygotujemy katalog do importu, zmapujemy kategorie i atrybuty albo podłączymy ofertę do integratora w ramach wdrożenia Base. Umów bezpłatną konsultację, a ocenimy, która ścieżka importu najlepiej pasuje do Twojego katalogu.