Feed produktowy dla eMAG - jak przygotować plik produktów przy dużym asortymencie

Miłosz Brzegowy
Miłosz Brzegowy
Head of Growth and Demand Generation
Feed produktowy dla eMAG - jak przygotować plik produktów przy dużym asortymencie

Feed produktowy dla eMAG to uporządkowany plik z danymi produktów i ofert, z którego eMAG tworzy karty produktów oraz aktualizuje ceny i stany. eMAG Academy opisuje trzy drogi przekazania takich danych: import plików XLS w panelu, feedy do publikacji produktów i aktualizacji ofert oraz API. Przy dużym asortymencie najważniejsze jest rozdzielenie danych na dwie warstwy: dokumentację produktu, która zmienia się rzadko, i dane oferty - cenę, stan, czas realizacji - które aktualizujesz często.
Przy kilkudziesięciu produktach plik przygotujesz ręcznie w arkuszu. Przy kilku tysiącach pozycji, trzech rynkach i codziennych zmianach cen ręczna praca przestaje wystarczać, a każdy błąd w kolumnie powiela się w setkach ofert. W tym wpisie pokazujemy, jak zaplanować feed produktowy dla eMAG: którą drogę importu wybrać, jakie pola przygotować, jak podzielić katalog i jak obsłużyć błędy importu. Techniczne szczegóły połączenia przez API zostawiamy na osobny wpis.
[#wazne] W skrócie: feed produktowy dla eMAG to plik z dokumentacją produktów i danymi ofert, przekazywany przez import XLS w panelu, feed albo API. eMAG Academy ma osobne pliki do publikacji produktów, łączenia ofert z istniejącymi kartami, aktualizacji produktów i rodzin oraz do zmian ofert, cen i stanów. Przy dużym katalogu rozdziel dokumentację od danych oferty, utrzymuj stały identyfikator produktu, importuj partiami według kategorii i po każdym imporcie sprawdzaj plik błędów. W Vinson przygotowujemy dane produktowe i prowadzimy sprzedaż na eMAG w Rumunii, Bułgarii i na Węgrzech.
Feed produktowy dla eMAG - czym jest i jakie masz możliwości
Feed produktowy to plik lub adres z danymi, który system sprzedawcy udostępnia platformie, a platforma odczytuje go i na tej podstawie tworzy lub aktualizuje produkty. W eMAG Academy temat ten mieści się w sekcji o imporcie produktów przez API lub feedy, z artykułem „Feeds: Product publishing and Offer Update”, oraz w rozbudowanej sekcji Import Excel. Do tego dochodzą prostsze ścieżki dla małej liczby produktów: ręczne dodawanie, dodanie produktu przez własny link (Add product with URL) i przesłanie własnego pliku (Bring your file). Przy dużym asortymencie liczą się trzy drogi:
| Droga importu | Jak działa | Kiedy się sprawdza |
|---|---|---|
| Import XLS w panelu | Generujesz szablon w panelu, wypełniasz go i wgrywasz z powrotem | Partie produktów, jednorazowe zmiany, start sprzedaży |
| Feed | eMAG pobiera dane z Twojego pliku według ustawionego modelu | Stały katalog ze sklepu, regularne aktualizacje ofert |
| API lub integrator | System wysyła dane do eMAG automatycznie, w obie strony | Duży katalog, częste zmiany, zamówienia z trzech rynków |
Aktualna wersja dokumentacji API eMAG Marketplace to według eMAG Academy v4.5.1, obowiązująca od 2 marca 2026 roku, dla platform w Rumunii, Bułgarii i na Węgrzech (stan na sierpień 2026 - sprawdź aktualną wersję). Co przygotować dla programisty, opisaliśmy we wpisie eMAG Marketplace API. Niezależnie od drogi dane muszą przejść tę samą ścieżkę:
[#chart:emg41a]
Pliki XLS w panelu eMAG
Sekcja Import Excel w eMAG Academy wymienia osobne szablony do generowania: plik publikacji produktów, plik łączenia ofert z istniejącymi produktami, plik aktualizacji produktów i plik dodawania produktów do rodzin. Zmiany ofert obsługują trzy kolejne pliki: „Update offers” do wszystkich zmian w ofertach produktów, które mają już kod PNK, w tym aktywacji i dezaktywacji ofert, cen i stanów, oraz osobne pliki „Prices” i „Stock”, gdy zmieniasz tylko ceny albo tylko stany. Każdy szablon generujesz w panelu dla swoich danych - nie zmieniaj w nim kolumn ani formatu.
Pliki XLS dobrze sprawdzają się także wtedy, gdy masz już feed lub integrację. Służą do jednorazowych operacji na wielu produktach naraz: dodania produktów do rodzin, masowej korekty charakterystyk po zmianie wymagań kategorii czy przygotowania pierwszej partii ofert w nowej kategorii. Dlatego nawet przy pełnej automatyzacji ktoś w zespole powinien umieć wygenerować i wypełnić szablon.
Feed pod adresem URL
Feed działa inaczej niż plik XLS: nie wgrywasz go ręcznie, tylko wskazujesz źródło, z którego eMAG pobiera dane. Według przewodnika integratora Mergado feed dodaje się jako adres URL w formacie XML lub CSV, a do wyboru są dwa modele - publikacja nowych produktów i aktualizacja ofert, czyli cen i stanów istniejących produktów. Ten sam przewodnik podaje, że raz dodanego feedu nie usuwa się, tylko wstrzymuje lub dezaktywuje. Aktualne pola, formaty i częstotliwość pobierania sprawdź w artykule eMAG Academy o feedach, bo przewodniki zewnętrzne mogą nie nadążać za zmianami.
Którą drogę importu wybrać na start
W praktyce duże katalogi rzadko korzystają z jednej drogi. Typowe połączenie wygląda tak: dokumentację publikujesz partiami przez pliki XLS albo feed w modelu publikacji produktów, a ceny i stany aktualizujesz automatycznie przez feed ofert, integrator lub API. Zanim utworzysz nową dokumentację, sprawdź, które produkty już są na eMAG. Dla nich wystarczy plik łączenia ofert z istniejącymi kartami, a stworzenie drugiej karty dla tego samego produktu skończy się odrzuceniem jako duplikat. Przy katalogu z markami popularnymi w Rumunii ta kontrola potrafi skrócić pracę o znaczną część asortymentu.
Druga decyzja to źródło prawdy, czyli system, z którego pochodzą dane. Może to być sklep, ERP, system PIM albo magazyn integratora - ważne, żeby był jeden. Jeśli ktoś poprawi opis bezpośrednio w panelu eMAG, a feed przy kolejnej aktualizacji nadpisze go starą wersją, poprawka zniknie. Ustal więc zasadę: wszystkie zmiany dokumentacji i ofert wprowadzasz w systemie źródłowym, a panel eMAG służy do kontroli, nie do edycji. Wyjątkiem są pilne korekty, które od razu przenosisz także do źródła.
Feed produktowy dla eMAG to uporządkowany plik z danymi produktów i ofert, z którego eMAG tworzy karty produktów oraz aktualizuje ceny i stany. eMAG Academy opisuje trzy drogi przekazania takich danych: import plików XLS w panelu, feedy do publikacji produktów i aktualizacji ofert oraz API. Przy dużym asortymencie najważniejsze jest rozdzielenie danych na dwie warstwy: dokumentację produktu, która zmienia się rzadko, i dane oferty - cenę, stan, czas realizacji - które aktualizujesz często.
Przy kilkudziesięciu produktach plik przygotujesz ręcznie w arkuszu. Przy kilku tysiącach pozycji, trzech rynkach i codziennych zmianach cen ręczna praca przestaje wystarczać, a każdy błąd w kolumnie powiela się w setkach ofert. W tym wpisie pokazujemy, jak zaplanować feed produktowy dla eMAG: którą drogę importu wybrać, jakie pola przygotować, jak podzielić katalog i jak obsłużyć błędy importu. Techniczne szczegóły połączenia przez API zostawiamy na osobny wpis.
[#wazne] W skrócie: feed produktowy dla eMAG to plik z dokumentacją produktów i danymi ofert, przekazywany przez import XLS w panelu, feed albo API. eMAG Academy ma osobne pliki do publikacji produktów, łączenia ofert z istniejącymi kartami, aktualizacji produktów i rodzin oraz do zmian ofert, cen i stanów. Przy dużym katalogu rozdziel dokumentację od danych oferty, utrzymuj stały identyfikator produktu, importuj partiami według kategorii i po każdym imporcie sprawdzaj plik błędów. W Vinson przygotowujemy dane produktowe i prowadzimy sprzedaż na eMAG w Rumunii, Bułgarii i na Węgrzech.
Feed produktowy dla eMAG - czym jest i jakie masz możliwości
Feed produktowy to plik lub adres z danymi, który system sprzedawcy udostępnia platformie, a platforma odczytuje go i na tej podstawie tworzy lub aktualizuje produkty. W eMAG Academy temat ten mieści się w sekcji o imporcie produktów przez API lub feedy, z artykułem „Feeds: Product publishing and Offer Update”, oraz w rozbudowanej sekcji Import Excel. Do tego dochodzą prostsze ścieżki dla małej liczby produktów: ręczne dodawanie, dodanie produktu przez własny link (Add product with URL) i przesłanie własnego pliku (Bring your file). Przy dużym asortymencie liczą się trzy drogi:
| Droga importu | Jak działa | Kiedy się sprawdza |
|---|---|---|
| Import XLS w panelu | Generujesz szablon w panelu, wypełniasz go i wgrywasz z powrotem | Partie produktów, jednorazowe zmiany, start sprzedaży |
| Feed | eMAG pobiera dane z Twojego pliku według ustawionego modelu | Stały katalog ze sklepu, regularne aktualizacje ofert |
| API lub integrator | System wysyła dane do eMAG automatycznie, w obie strony | Duży katalog, częste zmiany, zamówienia z trzech rynków |
Aktualna wersja dokumentacji API eMAG Marketplace to według eMAG Academy v4.5.1, obowiązująca od 2 marca 2026 roku, dla platform w Rumunii, Bułgarii i na Węgrzech (stan na sierpień 2026 - sprawdź aktualną wersję). Co przygotować dla programisty, opisaliśmy we wpisie eMAG Marketplace API. Niezależnie od drogi dane muszą przejść tę samą ścieżkę:
[#chart:emg41a]
Pliki XLS w panelu eMAG
Sekcja Import Excel w eMAG Academy wymienia osobne szablony do generowania: plik publikacji produktów, plik łączenia ofert z istniejącymi produktami, plik aktualizacji produktów i plik dodawania produktów do rodzin. Zmiany ofert obsługują trzy kolejne pliki: „Update offers” do wszystkich zmian w ofertach produktów, które mają już kod PNK, w tym aktywacji i dezaktywacji ofert, cen i stanów, oraz osobne pliki „Prices” i „Stock”, gdy zmieniasz tylko ceny albo tylko stany. Każdy szablon generujesz w panelu dla swoich danych - nie zmieniaj w nim kolumn ani formatu.
Pliki XLS dobrze sprawdzają się także wtedy, gdy masz już feed lub integrację. Służą do jednorazowych operacji na wielu produktach naraz: dodania produktów do rodzin, masowej korekty charakterystyk po zmianie wymagań kategorii czy przygotowania pierwszej partii ofert w nowej kategorii. Dlatego nawet przy pełnej automatyzacji ktoś w zespole powinien umieć wygenerować i wypełnić szablon.
Feed pod adresem URL
Feed działa inaczej niż plik XLS: nie wgrywasz go ręcznie, tylko wskazujesz źródło, z którego eMAG pobiera dane. Według przewodnika integratora Mergado feed dodaje się jako adres URL w formacie XML lub CSV, a do wyboru są dwa modele - publikacja nowych produktów i aktualizacja ofert, czyli cen i stanów istniejących produktów. Ten sam przewodnik podaje, że raz dodanego feedu nie usuwa się, tylko wstrzymuje lub dezaktywuje. Aktualne pola, formaty i częstotliwość pobierania sprawdź w artykule eMAG Academy o feedach, bo przewodniki zewnętrzne mogą nie nadążać za zmianami.
Którą drogę importu wybrać na start
W praktyce duże katalogi rzadko korzystają z jednej drogi. Typowe połączenie wygląda tak: dokumentację publikujesz partiami przez pliki XLS albo feed w modelu publikacji produktów, a ceny i stany aktualizujesz automatycznie przez feed ofert, integrator lub API. Zanim utworzysz nową dokumentację, sprawdź, które produkty już są na eMAG. Dla nich wystarczy plik łączenia ofert z istniejącymi kartami, a stworzenie drugiej karty dla tego samego produktu skończy się odrzuceniem jako duplikat. Przy katalogu z markami popularnymi w Rumunii ta kontrola potrafi skrócić pracę o znaczną część asortymentu.
Druga decyzja to źródło prawdy, czyli system, z którego pochodzą dane. Może to być sklep, ERP, system PIM albo magazyn integratora - ważne, żeby był jeden. Jeśli ktoś poprawi opis bezpośrednio w panelu eMAG, a feed przy kolejnej aktualizacji nadpisze go starą wersją, poprawka zniknie. Ustal więc zasadę: wszystkie zmiany dokumentacji i ofert wprowadzasz w systemie źródłowym, a panel eMAG służy do kontroli, nie do edycji. Wyjątkiem są pilne korekty, które od razu przenosisz także do źródła.
- Ocena, czy Twój asortyment pasuje do platformy
- Wymagania, integracja i wystawienie ofert
- Plan startu krok po kroku
Konsultację poprowadzi Miłosz Brzegowy, Head of Growth and Demand GenerationDwie warstwy danych w pliku produktów dla eMAG
eMAG rozróżnia dokumentację produktu, wspólną dla wszystkich sprzedawców na karcie, i ofertę, którą kontroluje tylko sprzedawca. Ten podział warto odwzorować w feedzie. Dokumentację przygotowujesz starannie raz, przy publikacji, i zmieniasz rzadko. Dane oferty zmieniasz codziennie, więc powinny płynąć osobnym, lekkim plikiem albo przez integrację. Jak wygląda karta produktu i ścieżki wystawiania, opisaliśmy we wpisie oferty na eMAG - dokumentacja produktu. Pola, które warto przygotować w każdej z warstw:
Identyfikatory - Twój stały identyfikator produktu (np. SKU), EAN, kod producenta, a po publikacji także PNK, czyli unikalny kod produktu eMAG.
Dokumentacja - nazwa, marka, kategoria eMAG, charakterystyki kategorii, adresy zdjęć, opis i dane wymagane przepisami, np. GPSR.
Rodzina produktów - identyfikator rodziny i parametry wariantujące, np. kolor i rozmiar.
Oferta - cena netto, stawka VAT, stan magazynowy, czas realizacji, gwarancja i status aktywności.
Kilka pól wymaga szczególnej uwagi. Według pomocy Base, opisującej integrację z eMAG, do platformy przesyła się cenę netto razem ze stawką VAT, a cenę brutto wylicza eMAG. Ta sama pomoc wymienia SKU, EAN, stawkę VAT i producenta jako minimum danych produktu w magazynie oraz podaje, że eMAG obsługuje najwyżej dwa parametry wariantujące w jednej rodzinie. Czas realizacji przyjmuje tylko określone wartości dni, więc mapuj go z pola magazynowego, a nie wpisuj ręcznie (stan na sierpień 2026 - sprawdź aktualną dokumentację).
Identyfikator produktu - ustal go raz na zawsze
Najdroższy błąd w feedzie to zmiana identyfikatora produktu po publikacji. Według przewodnika Mergado identyfikator produktu w feedzie eMAG musi być unikalny i nie można go edytować po wgraniu. Jeśli w Twoim sklepie SKU zmienia się przy zmianie dostawcy albo wersji opakowania, eMAG potraktuje produkt jako nowy, a stara oferta zostanie bez aktualizacji. Dlatego jako identyfikator wybierz pole, które w Twoim systemie nigdy się nie zmienia, i zapisz tę decyzję w dokumentacji integracji.
Zdjęcia i opisy w feedzie
Zdjęcia przekazujesz w feedzie jako adresy plików, więc muszą być publicznie dostępne, stałe i prowadzić bezpośrednio do obrazu, a nie do strony z galerią. Jeśli serwer sklepu blokuje pobieranie zdjęć przez zewnętrzne systemy albo zmienia adresy po każdej aktualizacji, eMAG nie pobierze obrazu i produkt może zostać odrzucony. Zdjęcie główne w feedzie musi spełniać standard eMAG, a polskie napisy na grafikach dodatkowych lepiej usunąć jeszcze w źródle. Opis przekazuj jako czysty tekst lub z prostym formatowaniem dopuszczonym przez eMAG, bez linków do sklepu i danych kontaktowych.
Duży asortyment - jak podzielić feed i ustalić częstotliwość aktualizacji
Przy kilku tysiącach produktów nie publikuj całego katalogu jednym importem. Podziel go na partie według kategorii eMAG, bo każda kategoria ma własne charakterystyki i własne typowe błędy. Zacznij od kategorii z kompletnymi danymi i od bestsellerów, a kategorie z brakami uzupełniaj równolegle. Jak przygotować kategorie i słownik wartości charakterystyk, pokazaliśmy we wpisie mapowanie kategorii i atrybutów eMAG. Drugą decyzją jest wybór narzędzia do aktualizacji:
[#chart:emg41b]
Częstotliwość aktualizacji dopasuj do warstwy danych. Stan magazynowy zmienia się z każdym zamówieniem w każdym kanale, więc powinien trafiać do eMAG jak najczęściej. Base na stronie integracji z eMAG podaje synchronizację stanów nawet co 5 minut i cen do godziny (stan na sierpień 2026 - sprawdź aktualne zasady). Ceny zmieniasz rzadziej, ale przed kampaniami eMAG trzeba je kontrolować szczególnie uważnie. Dokumentację aktualizuj tylko wtedy, gdy naprawdę się zmienia, bo każda zmiana opisu czy charakterystyk przechodzi ponowną weryfikację.
Trzy rynki eMAG - jeden plik czy trzy
Rumunia, Węgry i Bułgaria to osobne platformy z własnymi walutami: lejami, forintami i euro, które w Bułgarii obowiązuje od 1 stycznia 2026 roku. W programie Cross-Border eMAG przelicza ceny automatycznie i tłumaczy opisy na węgierski i bułgarski. Jeśli korzystasz z eksportu ofert z Rumunii, jeden feed dokumentacji dla eMAG.ro wystarczy, a o cenach decyduje mechanizm eMAG. Jeśli chcesz ustalać ceny osobno dla każdego kraju, potrzebujesz osobnych danych ofert - integratory, np. Base, dodają wtedy osobne połączenie dla każdego rynku. Ważne, żeby dwa mechanizmy nie aktualizowały tej samej oferty, bo będą nadpisywać sobie ceny i stany.
Walidacja feedu i błędy importu na eMAG
Każdy import warto zakończyć kontrolą. W eMAG Academy opisano statusy plików XLS: plik w trakcie przetwarzania (In Processing), nieprawidłowy plik (Invalid upload file), import częściowy (Partial import) i import nieudany (Import failed). Historia importów pokazuje typ, status i liczbę przetworzonych pozycji, a plik do pobrania wskazuje wiersze z błędami. Produkty odrzucone na etapie weryfikacji dokumentacji znajdziesz w menu Produkty - Moje produkty. Najczęstsze sytuacje i poprawki:
[#chart:emg41c]
Zanim wgrasz poprawioną partię, sprawdź, czy ten sam błąd nie powtarza się w innych produktach. Jeśli kilkadziesiąt pozycji wraca z identycznym komunikatem, przyczyna leży w regule budowania feedu, a nie w pojedynczym produkcie, i poprawka w jednym miejscu rozwiązuje cały problem. Przed pierwszym pełnym importem przejdź krótki test:
Wybierz kilkadziesiąt produktów z różnych kategorii, w tym warianty i produkty już obecne na eMAG.
Opublikuj je i sprawdź status importu oraz plik z błędami.
Porównaj kartę na eMAG z danymi źródłowymi: kategorię, charakterystyki, zdjęcia i rodziny.
Zmień cenę i stan kilku produktów w źródle i zmierz, kiedy zmiana pojawi się na eMAG.
Popraw reguły feedu i dopiero wtedy importuj kolejne partie.
Wycofywanie produktów - plik EOL
Duży katalog to także produkty, które przestajesz sprzedawać. eMAG Academy opisuje do tego plik End of Life (EOL), który pozwala czasowo lub na stałe dezaktywować produkty, a później je reaktywować. Produkty ze statusem EOL stają się nieaktywne i znikają z list ofert, a ich lista jest przechowywana osobno. To czystsze rozwiązanie niż zostawianie ofert ze stanem zero, które zaśmiecają panel i utrudniają kontrolę.
[#checklista] Przed pierwszym importem dużego katalogu na eMAG sprawdź: stały identyfikator produktu, EAN, markę i producenta w każdym produkcie, kategorię eMAG i komplet charakterystyk, publiczne adresy zdjęć, cenę netto ze stawką VAT, czas realizacji z dozwolonych wartości, plan partii według kategorii, osobny plik lub integrację dla cen i stanów oraz osobę, która po każdym imporcie przegląda plik błędów.
Jak Vinson pomaga przygotować feed produktowy dla eMAG
Jesteśmy agencją e-commerce z Bochni, działającą od 2021 roku. Pracowaliśmy z ponad 500 firmami, mamy status Allegro Ads Partner+, Google Partner i Meta Business Partner, jesteśmy certyfikowanym partnerem Base, partnerem Empik Place i autoryzowanym partnerem Shoper, a klienci oceniają nas na 4,9/5 ze 171 opinii. W ramach usługi sprzedaż na eMAG z Vinson porządkujemy dane produktowe dużych katalogów przed wejściem na eMAG.
Wybór drogi importu: XLS, feed, API lub integrator.
Struktura pliku produktów z podziałem na dokumentację i ofertę.
Plan partii, import i poprawa błędów walidacji.
Konfiguracja aktualizacji cen i stanów na trzech rynkach.
Najczęściej zadawane pytania
Czym jest feed produktowy dla eMAG?
To plik lub źródło danych z dokumentacją produktów i danymi ofert, na podstawie którego eMAG publikuje produkty i aktualizuje ceny oraz stany. eMAG Academy opisuje import przez pliki XLS w panelu, feedy i API.
Jak zaimportować produkty na eMAG?
Możesz dodać produkty ręcznie, wgrać plik XLS wygenerowany w sekcji Import Excel, podłączyć feed albo użyć API lub integratora. Przy dużym asortymencie najlepiej sprawdzają się pliki XLS na start i integracja do bieżących aktualizacji.
Jak zaktualizować ceny i stany na eMAG plikiem?
W sekcji Import Excel eMAG udostępnia plik „Update offers” do wszystkich zmian w ofertach oraz osobne pliki „Prices” i „Stock”. Dotyczą produktów, które mają już kod PNK na platformie.
Dlaczego import produktów na eMAG się nie udał?
Najczęściej plik ma zmienione kolumny lub format, brakuje wymaganych charakterystyk albo produkt ma błędną kategorię. Sprawdź status importu i pobierz plik z błędami, a odrzuconą dokumentację popraw w menu Produkty - Moje produkty.
Jak często aktualizować feed na eMAG?
Stany jak najczęściej, bo zmieniają się z każdym zamówieniem, ceny zwykle kilka razy dziennie lub rzadziej, a dokumentację tylko przy realnych zmianach. Integratory, np. Base, podają synchronizację stanów nawet co 5 minut (stan na sierpień 2026 - sprawdź aktualne zasady).
Masz duży katalog i chcesz wejść na eMAG bez tygodni poprawiania importów? Zobacz, jak prowadzimy sprzedaż na eMAG z Vinson - od struktury danych po codzienne aktualizacje ofert w Rumunii, Bułgarii i na Węgrzech.
Dwie warstwy danych w pliku produktów dla eMAG
eMAG rozróżnia dokumentację produktu, wspólną dla wszystkich sprzedawców na karcie, i ofertę, którą kontroluje tylko sprzedawca. Ten podział warto odwzorować w feedzie. Dokumentację przygotowujesz starannie raz, przy publikacji, i zmieniasz rzadko. Dane oferty zmieniasz codziennie, więc powinny płynąć osobnym, lekkim plikiem albo przez integrację. Jak wygląda karta produktu i ścieżki wystawiania, opisaliśmy we wpisie oferty na eMAG - dokumentacja produktu. Pola, które warto przygotować w każdej z warstw:
Identyfikatory - Twój stały identyfikator produktu (np. SKU), EAN, kod producenta, a po publikacji także PNK, czyli unikalny kod produktu eMAG.
Dokumentacja - nazwa, marka, kategoria eMAG, charakterystyki kategorii, adresy zdjęć, opis i dane wymagane przepisami, np. GPSR.
Rodzina produktów - identyfikator rodziny i parametry wariantujące, np. kolor i rozmiar.
Oferta - cena netto, stawka VAT, stan magazynowy, czas realizacji, gwarancja i status aktywności.
Kilka pól wymaga szczególnej uwagi. Według pomocy Base, opisującej integrację z eMAG, do platformy przesyła się cenę netto razem ze stawką VAT, a cenę brutto wylicza eMAG. Ta sama pomoc wymienia SKU, EAN, stawkę VAT i producenta jako minimum danych produktu w magazynie oraz podaje, że eMAG obsługuje najwyżej dwa parametry wariantujące w jednej rodzinie. Czas realizacji przyjmuje tylko określone wartości dni, więc mapuj go z pola magazynowego, a nie wpisuj ręcznie (stan na sierpień 2026 - sprawdź aktualną dokumentację).
Identyfikator produktu - ustal go raz na zawsze
Najdroższy błąd w feedzie to zmiana identyfikatora produktu po publikacji. Według przewodnika Mergado identyfikator produktu w feedzie eMAG musi być unikalny i nie można go edytować po wgraniu. Jeśli w Twoim sklepie SKU zmienia się przy zmianie dostawcy albo wersji opakowania, eMAG potraktuje produkt jako nowy, a stara oferta zostanie bez aktualizacji. Dlatego jako identyfikator wybierz pole, które w Twoim systemie nigdy się nie zmienia, i zapisz tę decyzję w dokumentacji integracji.
Zdjęcia i opisy w feedzie
Zdjęcia przekazujesz w feedzie jako adresy plików, więc muszą być publicznie dostępne, stałe i prowadzić bezpośrednio do obrazu, a nie do strony z galerią. Jeśli serwer sklepu blokuje pobieranie zdjęć przez zewnętrzne systemy albo zmienia adresy po każdej aktualizacji, eMAG nie pobierze obrazu i produkt może zostać odrzucony. Zdjęcie główne w feedzie musi spełniać standard eMAG, a polskie napisy na grafikach dodatkowych lepiej usunąć jeszcze w źródle. Opis przekazuj jako czysty tekst lub z prostym formatowaniem dopuszczonym przez eMAG, bez linków do sklepu i danych kontaktowych.
Duży asortyment - jak podzielić feed i ustalić częstotliwość aktualizacji
Przy kilku tysiącach produktów nie publikuj całego katalogu jednym importem. Podziel go na partie według kategorii eMAG, bo każda kategoria ma własne charakterystyki i własne typowe błędy. Zacznij od kategorii z kompletnymi danymi i od bestsellerów, a kategorie z brakami uzupełniaj równolegle. Jak przygotować kategorie i słownik wartości charakterystyk, pokazaliśmy we wpisie mapowanie kategorii i atrybutów eMAG. Drugą decyzją jest wybór narzędzia do aktualizacji:
[#chart:emg41b]
Częstotliwość aktualizacji dopasuj do warstwy danych. Stan magazynowy zmienia się z każdym zamówieniem w każdym kanale, więc powinien trafiać do eMAG jak najczęściej. Base na stronie integracji z eMAG podaje synchronizację stanów nawet co 5 minut i cen do godziny (stan na sierpień 2026 - sprawdź aktualne zasady). Ceny zmieniasz rzadziej, ale przed kampaniami eMAG trzeba je kontrolować szczególnie uważnie. Dokumentację aktualizuj tylko wtedy, gdy naprawdę się zmienia, bo każda zmiana opisu czy charakterystyk przechodzi ponowną weryfikację.
Trzy rynki eMAG - jeden plik czy trzy
Rumunia, Węgry i Bułgaria to osobne platformy z własnymi walutami: lejami, forintami i euro, które w Bułgarii obowiązuje od 1 stycznia 2026 roku. W programie Cross-Border eMAG przelicza ceny automatycznie i tłumaczy opisy na węgierski i bułgarski. Jeśli korzystasz z eksportu ofert z Rumunii, jeden feed dokumentacji dla eMAG.ro wystarczy, a o cenach decyduje mechanizm eMAG. Jeśli chcesz ustalać ceny osobno dla każdego kraju, potrzebujesz osobnych danych ofert - integratory, np. Base, dodają wtedy osobne połączenie dla każdego rynku. Ważne, żeby dwa mechanizmy nie aktualizowały tej samej oferty, bo będą nadpisywać sobie ceny i stany.
Walidacja feedu i błędy importu na eMAG
Każdy import warto zakończyć kontrolą. W eMAG Academy opisano statusy plików XLS: plik w trakcie przetwarzania (In Processing), nieprawidłowy plik (Invalid upload file), import częściowy (Partial import) i import nieudany (Import failed). Historia importów pokazuje typ, status i liczbę przetworzonych pozycji, a plik do pobrania wskazuje wiersze z błędami. Produkty odrzucone na etapie weryfikacji dokumentacji znajdziesz w menu Produkty - Moje produkty. Najczęstsze sytuacje i poprawki:
[#chart:emg41c]
Zanim wgrasz poprawioną partię, sprawdź, czy ten sam błąd nie powtarza się w innych produktach. Jeśli kilkadziesiąt pozycji wraca z identycznym komunikatem, przyczyna leży w regule budowania feedu, a nie w pojedynczym produkcie, i poprawka w jednym miejscu rozwiązuje cały problem. Przed pierwszym pełnym importem przejdź krótki test:
Wybierz kilkadziesiąt produktów z różnych kategorii, w tym warianty i produkty już obecne na eMAG.
Opublikuj je i sprawdź status importu oraz plik z błędami.
Porównaj kartę na eMAG z danymi źródłowymi: kategorię, charakterystyki, zdjęcia i rodziny.
Zmień cenę i stan kilku produktów w źródle i zmierz, kiedy zmiana pojawi się na eMAG.
Popraw reguły feedu i dopiero wtedy importuj kolejne partie.
Wycofywanie produktów - plik EOL
Duży katalog to także produkty, które przestajesz sprzedawać. eMAG Academy opisuje do tego plik End of Life (EOL), który pozwala czasowo lub na stałe dezaktywować produkty, a później je reaktywować. Produkty ze statusem EOL stają się nieaktywne i znikają z list ofert, a ich lista jest przechowywana osobno. To czystsze rozwiązanie niż zostawianie ofert ze stanem zero, które zaśmiecają panel i utrudniają kontrolę.
[#checklista] Przed pierwszym importem dużego katalogu na eMAG sprawdź: stały identyfikator produktu, EAN, markę i producenta w każdym produkcie, kategorię eMAG i komplet charakterystyk, publiczne adresy zdjęć, cenę netto ze stawką VAT, czas realizacji z dozwolonych wartości, plan partii według kategorii, osobny plik lub integrację dla cen i stanów oraz osobę, która po każdym imporcie przegląda plik błędów.
Jak Vinson pomaga przygotować feed produktowy dla eMAG
Jesteśmy agencją e-commerce z Bochni, działającą od 2021 roku. Pracowaliśmy z ponad 500 firmami, mamy status Allegro Ads Partner+, Google Partner i Meta Business Partner, jesteśmy certyfikowanym partnerem Base, partnerem Empik Place i autoryzowanym partnerem Shoper, a klienci oceniają nas na 4,9/5 ze 171 opinii. W ramach usługi sprzedaż na eMAG z Vinson porządkujemy dane produktowe dużych katalogów przed wejściem na eMAG.
Wybór drogi importu: XLS, feed, API lub integrator.
Struktura pliku produktów z podziałem na dokumentację i ofertę.
Plan partii, import i poprawa błędów walidacji.
Konfiguracja aktualizacji cen i stanów na trzech rynkach.
Najczęściej zadawane pytania
Czym jest feed produktowy dla eMAG?
To plik lub źródło danych z dokumentacją produktów i danymi ofert, na podstawie którego eMAG publikuje produkty i aktualizuje ceny oraz stany. eMAG Academy opisuje import przez pliki XLS w panelu, feedy i API.
Jak zaimportować produkty na eMAG?
Możesz dodać produkty ręcznie, wgrać plik XLS wygenerowany w sekcji Import Excel, podłączyć feed albo użyć API lub integratora. Przy dużym asortymencie najlepiej sprawdzają się pliki XLS na start i integracja do bieżących aktualizacji.
Jak zaktualizować ceny i stany na eMAG plikiem?
W sekcji Import Excel eMAG udostępnia plik „Update offers” do wszystkich zmian w ofertach oraz osobne pliki „Prices” i „Stock”. Dotyczą produktów, które mają już kod PNK na platformie.
Dlaczego import produktów na eMAG się nie udał?
Najczęściej plik ma zmienione kolumny lub format, brakuje wymaganych charakterystyk albo produkt ma błędną kategorię. Sprawdź status importu i pobierz plik z błędami, a odrzuconą dokumentację popraw w menu Produkty - Moje produkty.
Jak często aktualizować feed na eMAG?
Stany jak najczęściej, bo zmieniają się z każdym zamówieniem, ceny zwykle kilka razy dziennie lub rzadziej, a dokumentację tylko przy realnych zmianach. Integratory, np. Base, podają synchronizację stanów nawet co 5 minut (stan na sierpień 2026 - sprawdź aktualne zasady).
Masz duży katalog i chcesz wejść na eMAG bez tygodni poprawiania importów? Zobacz, jak prowadzimy sprzedaż na eMAG z Vinson - od struktury danych po codzienne aktualizacje ofert w Rumunii, Bułgarii i na Węgrzech.


Miłosz Brzegowy
Head of Growth and Demand Generation
Buduje strategie wzrostu i wejścia na nowe kanały sprzedaży. Łączy dane, kanały i treści w przewidywalny system.
Buduje strategie wzrostu i wejścia na nowe kanały sprzedaży. Łączy dane, kanały i treści w przewidywalny system.
Sprzedaż na eMAG z Vinson
Miłosz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie - bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań

Przeczytaj także
Więcej porad z naszej bazy wiedzy - przesuń, aby zobaczyć kolejne artykuły.
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!
Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.
Masz pytania? Chętnie porozmawiamy!
Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."
Wybierz dogodny termin w kalendarzu - bez wymiany maili w tę i z powrotem.
Napisz do nas
Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.
Na zapytanie odpowie Miłosz Brzegowy, Head of Growth and Demand GenerationNapisz do nas
Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.
Na zapytanie odpowie Miłosz Brzegowy, Head of Growth and Demand Generation