eMAG Marketplace API - co można zautomatyzować i co przygotować dla programisty

Miłosz Brzegowy
Miłosz Brzegowy
Head of Growth and Demand Generation
eMAG Marketplace API - co można zautomatyzować i co przygotować dla programisty

eMAG Marketplace API to techniczne połączenie, przez które Twój sklep, ERP albo integrator wymienia dane z eMAG: publikuje produkty i oferty, aktualizuje ceny, stany i dokumentację, pobiera zamówienia i obsługuje ich realizację. Według eMAG Academy API działa dla platform w Rumunii, Bułgarii i na Węgrzech, a aktualna wersja dokumentacji to v4.5.1, obowiązująca od 2 marca 2026 roku (stan na sierpień 2026 - sprawdź aktualną wersję). Zanim programista zacznie pracę, potrzebuje dostępu do API, listy dozwolonych adresów IP, mapowania kategorii i jasnej decyzji, który system jest źródłem danych.
Ręczna praca w panelu eMAG wystarcza przy kilkudziesięciu produktach. Gdy katalog rośnie do setek pozycji, a zamówienia przychodzą z trzech krajów, każda ręczna zmiana ceny czy stanu to ryzyko pomyłki i anulowanego zamówienia. Wtedy pojawia się pytanie: gotowy integrator czy własne połączenie z API. W tym wpisie opisujemy, co można zautomatyzować przez eMAG Marketplace API, jak wygląda dostęp i co przygotować, zanim zlecisz programiście integrację.
[#wazne] W skrócie: eMAG Marketplace API pozwala zautomatyzować publikację produktów i ofert, aktualizację cen, stanów i dokumentacji oraz obsługę zamówień w Rumunii, Bułgarii i na Węgrzech. Dokumentacja jest dostępna dla sprzedawców w eMAG Academy, a dostęp wymaga danych użytkownika z uprawnieniami do API i zgłoszenia adresu IP serwera w panelu. Przed startem przygotuj mapowanie kategorii, dane produktów i proces zamówień. W Vinson pomagamy polskim firmom zaplanować integrację i sprzedaż na eMAG.
eMAG Marketplace API - czym jest i do czego służy
API, czyli interfejs programistyczny, to zestaw zasad, według których dwa systemy wymieniają dane bez udziału człowieka. eMAG Academy opisuje API eMAG Marketplace jako rozwiązanie, które pozwala zsynchronizować Twoją platformę sprzedażową z eMAG w zakresie wystawiania ofert, zarządzania nimi i przetwarzania zamówień. Jako korzyści eMAG wymienia szybką publikację produktów i szybką aktualizację danych, takich jak stany, dokumentacja i ceny. Przez API synchronizujesz też dane słownikowe platformy, np. kategorie i stawki VAT.
Obok API eMAG Academy opisuje feedy do publikacji produktów i aktualizacji ofert, import plików XLS oraz ręczne dodawanie produktów. Różne ścieżki wystawiania ofert opisaliśmy we wpisie oferty na eMAG - dokumentacja produktu. API ma sens wtedy, gdy dane mają płynąć automatycznie i często: ceny zmieniają się codziennie, stany kilka razy dziennie, a zamówienia trzeba przyjmować bez opóźnień. Obszary, które obejmuje połączenie, wyglądają tak:
[#chart:emg35a]
Co mówi dokumentacja i regulamin API
Dokumentację techniczną znajdziesz w eMAG Academy, w sekcji o imporcie produktów przez API lub feedy. eMAG publikuje też osobny dokument z warunkami korzystania z API, dostępny po zalogowaniu na konto sprzedawcy. Z zapowiedzi widać, że dotyczy on m.in. limitów API, uwierzytelniania i bezpieczeństwa, poufności i ochrony danych oraz konsekwencji naruszenia zasad. Przekaż go programiście razem z dokumentacją - limity zapytań i zasady bezpieczeństwa wpływają na architekturę integracji, a nie tylko na pojedyncze wywołania.
Co można zautomatyzować przez API eMAG
Zakres automatyzacji warto rozpisać na procesy, a nie na techniczne zasoby. Programista przełoży je potem na konkretne wywołania z dokumentacji. Najczęściej automatyzuje się pięć obszarów:
Produkty i dokumentacja - publikacja nowych produktów z nazwą, opisem, charakterystykami, zdjęciami i rodzinami wariantów albo dołączenie oferty do istniejącej karty.
Oferty - ceny, stany magazynowe, czas realizacji i status aktywności oferty, aktualizowane z Twojego systemu.
Zamówienia - pobieranie nowych zamówień, przyjmowanie ich, zmiana statusów i dołączanie faktur.
Wysyłka - tworzenie listów przewozowych AWB w platformie i przekazywanie numerów przesyłek.
Zwroty - pobieranie zgłoszeń zwrotów i aktualizacja ich statusów.
Przy każdym obszarze ustal, w którą stronę płyną dane. Ceny i stany zwykle idą z Twojego magazynu do eMAG, zamówienia i zwroty z eMAG do Ciebie, a statusy w obie strony. Według pomocy Base, opisującej integrację z eMAG, zamówienia na eMAG przechodzą przez statusy: nowe, przyjęte, przygotowane, zrealizowane, a także anulowane i zwrócone. Integracja musi pilnować tej kolejności, bo od szybkiego przyjęcia i realizacji zamówienia zależą wskaźniki konta w Account Health.
API dla trzech platform eMAG
Rumunia, Bułgaria i Węgry to osobne platformy z osobnymi adresami API. Integratory, np. Base, dodają osobne połączenie dla każdego rynku, a zamówienia z każdego kraju pobierane są oddzielnie. Dla programisty oznacza to trzy zestawy konfiguracji i trzy waluty: leje, forinty i euro w Bułgarii. Jeśli w programie Cross-Border oferty na eMAG.hu i eMAG.bg synchronizują się z Rumunią, ustal, czy Twoja integracja ma aktualizować tylko kraj źródłowy, czy każdą platformę osobno - inaczej dwa mechanizmy będą nadpisywać sobie ceny i stany.
Osobnym przypadkiem jest Fulfilment by eMAG. Gdy towar leży w magazynie eMAG, stanem i wysyłką zarządza platforma, więc integracja nie powinna ich nadpisywać. Według pomocy Base zamówienia zwykłe i realizowane z magazynu eMAG obsługuje się w osobnych integracjach na tym samym rynku, a przy fulfilmencie część aktualizacji, np. stanu i czasu obsługi, jest pomijana, a przekazanie faktury może zostać odrzucone. Jeśli łączysz oba modele, opisz programiście, które produkty są wysyłane z Polski, a które z magazynu eMAG.
eMAG Marketplace API to techniczne połączenie, przez które Twój sklep, ERP albo integrator wymienia dane z eMAG: publikuje produkty i oferty, aktualizuje ceny, stany i dokumentację, pobiera zamówienia i obsługuje ich realizację. Według eMAG Academy API działa dla platform w Rumunii, Bułgarii i na Węgrzech, a aktualna wersja dokumentacji to v4.5.1, obowiązująca od 2 marca 2026 roku (stan na sierpień 2026 - sprawdź aktualną wersję). Zanim programista zacznie pracę, potrzebuje dostępu do API, listy dozwolonych adresów IP, mapowania kategorii i jasnej decyzji, który system jest źródłem danych.
Ręczna praca w panelu eMAG wystarcza przy kilkudziesięciu produktach. Gdy katalog rośnie do setek pozycji, a zamówienia przychodzą z trzech krajów, każda ręczna zmiana ceny czy stanu to ryzyko pomyłki i anulowanego zamówienia. Wtedy pojawia się pytanie: gotowy integrator czy własne połączenie z API. W tym wpisie opisujemy, co można zautomatyzować przez eMAG Marketplace API, jak wygląda dostęp i co przygotować, zanim zlecisz programiście integrację.
[#wazne] W skrócie: eMAG Marketplace API pozwala zautomatyzować publikację produktów i ofert, aktualizację cen, stanów i dokumentacji oraz obsługę zamówień w Rumunii, Bułgarii i na Węgrzech. Dokumentacja jest dostępna dla sprzedawców w eMAG Academy, a dostęp wymaga danych użytkownika z uprawnieniami do API i zgłoszenia adresu IP serwera w panelu. Przed startem przygotuj mapowanie kategorii, dane produktów i proces zamówień. W Vinson pomagamy polskim firmom zaplanować integrację i sprzedaż na eMAG.
eMAG Marketplace API - czym jest i do czego służy
API, czyli interfejs programistyczny, to zestaw zasad, według których dwa systemy wymieniają dane bez udziału człowieka. eMAG Academy opisuje API eMAG Marketplace jako rozwiązanie, które pozwala zsynchronizować Twoją platformę sprzedażową z eMAG w zakresie wystawiania ofert, zarządzania nimi i przetwarzania zamówień. Jako korzyści eMAG wymienia szybką publikację produktów i szybką aktualizację danych, takich jak stany, dokumentacja i ceny. Przez API synchronizujesz też dane słownikowe platformy, np. kategorie i stawki VAT.
Obok API eMAG Academy opisuje feedy do publikacji produktów i aktualizacji ofert, import plików XLS oraz ręczne dodawanie produktów. Różne ścieżki wystawiania ofert opisaliśmy we wpisie oferty na eMAG - dokumentacja produktu. API ma sens wtedy, gdy dane mają płynąć automatycznie i często: ceny zmieniają się codziennie, stany kilka razy dziennie, a zamówienia trzeba przyjmować bez opóźnień. Obszary, które obejmuje połączenie, wyglądają tak:
[#chart:emg35a]
Co mówi dokumentacja i regulamin API
Dokumentację techniczną znajdziesz w eMAG Academy, w sekcji o imporcie produktów przez API lub feedy. eMAG publikuje też osobny dokument z warunkami korzystania z API, dostępny po zalogowaniu na konto sprzedawcy. Z zapowiedzi widać, że dotyczy on m.in. limitów API, uwierzytelniania i bezpieczeństwa, poufności i ochrony danych oraz konsekwencji naruszenia zasad. Przekaż go programiście razem z dokumentacją - limity zapytań i zasady bezpieczeństwa wpływają na architekturę integracji, a nie tylko na pojedyncze wywołania.
Co można zautomatyzować przez API eMAG
Zakres automatyzacji warto rozpisać na procesy, a nie na techniczne zasoby. Programista przełoży je potem na konkretne wywołania z dokumentacji. Najczęściej automatyzuje się pięć obszarów:
Produkty i dokumentacja - publikacja nowych produktów z nazwą, opisem, charakterystykami, zdjęciami i rodzinami wariantów albo dołączenie oferty do istniejącej karty.
Oferty - ceny, stany magazynowe, czas realizacji i status aktywności oferty, aktualizowane z Twojego systemu.
Zamówienia - pobieranie nowych zamówień, przyjmowanie ich, zmiana statusów i dołączanie faktur.
Wysyłka - tworzenie listów przewozowych AWB w platformie i przekazywanie numerów przesyłek.
Zwroty - pobieranie zgłoszeń zwrotów i aktualizacja ich statusów.
Przy każdym obszarze ustal, w którą stronę płyną dane. Ceny i stany zwykle idą z Twojego magazynu do eMAG, zamówienia i zwroty z eMAG do Ciebie, a statusy w obie strony. Według pomocy Base, opisującej integrację z eMAG, zamówienia na eMAG przechodzą przez statusy: nowe, przyjęte, przygotowane, zrealizowane, a także anulowane i zwrócone. Integracja musi pilnować tej kolejności, bo od szybkiego przyjęcia i realizacji zamówienia zależą wskaźniki konta w Account Health.
API dla trzech platform eMAG
Rumunia, Bułgaria i Węgry to osobne platformy z osobnymi adresami API. Integratory, np. Base, dodają osobne połączenie dla każdego rynku, a zamówienia z każdego kraju pobierane są oddzielnie. Dla programisty oznacza to trzy zestawy konfiguracji i trzy waluty: leje, forinty i euro w Bułgarii. Jeśli w programie Cross-Border oferty na eMAG.hu i eMAG.bg synchronizują się z Rumunią, ustal, czy Twoja integracja ma aktualizować tylko kraj źródłowy, czy każdą platformę osobno - inaczej dwa mechanizmy będą nadpisywać sobie ceny i stany.
Osobnym przypadkiem jest Fulfilment by eMAG. Gdy towar leży w magazynie eMAG, stanem i wysyłką zarządza platforma, więc integracja nie powinna ich nadpisywać. Według pomocy Base zamówienia zwykłe i realizowane z magazynu eMAG obsługuje się w osobnych integracjach na tym samym rynku, a przy fulfilmencie część aktualizacji, np. stanu i czasu obsługi, jest pomijana, a przekazanie faktury może zostać odrzucone. Jeśli łączysz oba modele, opisz programiście, które produkty są wysyłane z Polski, a które z magazynu eMAG.
- 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 GenerationJak uzyskać dostęp do eMAG Marketplace API
Dostęp do API mają sprzedawcy z aktywnym kontem na eMAG Marketplace. Połączenie opiera się na danych logowania użytkownika panelu z uprawnieniami do API oraz na liście adresów IP, z których eMAG przyjmuje zapytania. Według pomocy Base adres IP integracji dodaje się w panelu eMAG w sekcji Moje konto - Profil - Szczegóły techniczne, a stamtąd pobiera się też kod API potrzebny do części funkcji. Własny serwer integracji musi mieć więc stały adres IP, a jego zmiana wymaga aktualizacji w panelu. Szczegóły tworzenia użytkownika API i ewentualnego środowiska testowego potwierdź w dokumentacji albo u opiekuna eMAG.
Przed pierwszym wywołaniem ustal z programistą kilka zasad bezpieczeństwa. Dane dostępowe trzymaj poza kodem źródłowym, w bezpiecznym magazynie haseł. Używaj osobnego użytkownika dla integracji, a nie konta właściciela, żeby zmiana hasła w panelu nie zatrzymała synchronizacji. Rejestruj wszystkie wywołania i odpowiedzi z błędami - bez tego trudno później ustalić, dlaczego cena albo stan nie zmieniły się na eMAG.
Jak wygląda obsługa zamówienia przez API eMAG
Najwięcej korzyści z API daje automatyczna obsługa zamówień, bo tu liczy się czas. Każde opóźnienie w przyjęciu zamówienia czy przekazaniu paczki kurierowi odbija się na wskaźnikach konta. Typowy cykl zamówienia w integracji wygląda tak:
[#chart:emg35b]
Ważny jest moment tworzenia listu przewozowego. Przy eMAG Courier wygenerowanie AWB wysyła zlecenie odbioru do kuriera, więc integracja powinna tworzyć je dopiero wtedy, gdy paczka jest gotowa. Jeśli wysyłasz własnym przewoźnikiem, numer przesyłki musi trafić do zamówienia na eMAG - według pomocy Base takie numery przekazuje się jako zewnętrzne AWB, po wcześniejszej aktywacji tej opcji po stronie eMAG. eMAG Academy wymienia wysyłkę bez AWB wygenerowanego z platformy wśród problemów, które psują wskaźniki sprzedawcy.
Ceny, VAT i czas realizacji w API
Kilka pól wymaga szczególnej uwagi przy mapowaniu danych. Według pomocy Base integracja przesyła do eMAG cenę netto razem ze stawką VAT, a eMAG wylicza cenę brutto, dlatego Twój system musi znać właściwą stawkę dla każdego produktu i kraju. Czas realizacji, czyli liczba dni do przekazania paczki kurierowi, przyjmuje według tej samej pomocy tylko określone wartości: 0, 1, 2, 3, 6, 9, 30, 60 lub 90 dni (stan na sierpień 2026 - sprawdź aktualną dokumentację). Przy wariantach pamiętaj, że według Base eMAG obsługuje najwyżej dwa parametry wariantujące w jednej rodzinie produktów.
Co przygotować dla programisty przed integracją z eMAG
Najdroższa część integracji to nie kod, tylko decyzje, których nikt nie podjął przed startem. Programista nie wie, które produkty mają trafić na eMAG, jak mapować Twoje kategorie na kategorie eMAG ani co zrobić z zamówieniem bez towaru. Zanim zlecisz pracę, przygotuj pakiet startowy:
| Element | Po co jest potrzebny | Kto przygotowuje |
|---|---|---|
| Dostęp do API i stały adres IP | Bez nich integracja nie wykona żadnego zapytania | Właściciel konta i administrator serwera |
| Lista produktów na eMAG | Określa zakres synchronizacji | Osoba od sprzedaży |
| Mapowanie kategorii i charakterystyk | Produkt bez wymaganych parametrów zostanie odrzucony | Osoba od ofert z programistą |
| Dane produktów: EAN, marka, zdjęcia, warianty | Publikacja nowych kart i łączenie z istniejącymi | Osoba od ofert |
| Reguły cen i walut | Cena netto, VAT i przeliczenie na leje, forinty i euro | Właściciel i księgowość |
| Proces zamówień i zwrotów | Kolejność statusów, faktury, AWB i zwroty | Magazyn i obsługa klienta |
| Źródło prawdy dla stanów | Jeden system decyduje o stanie na trzech rynkach | Właściciel z programistą |
Do pakietu dołącz też listę błędów, które już znasz z ręcznej pracy w panelu: produkty odrzucane przy walidacji dokumentacji, warianty, które nie łączą się w rodziny, oferty bez przycisku zakupu. To skraca testy, bo programista od razu sprawdzi, jak integracja zachowuje się w tych sytuacjach.
Limity zapytań i obsługa błędów
Dokumentacja i warunki korzystania z API określają limity liczby zapytań, a integratory opisują osobne limity dla zamówień i dla pozostałych zasobów. Integracja, która przy każdej zmianie stanu wysyła pojedyncze zapytanie, szybko w nie uderzy. Dlatego aktualizacje cen i stanów grupuj w paczki, ponawiaj zapytania odrzucone z powodu limitu z opóźnieniem i ustal priorytety: zamówienia zawsze przed aktualizacją opisów. Konkretne wartości limitów sprawdź w aktualnej wersji dokumentacji, bo mogą się zmieniać między wersjami.
Jak przetestować integrację z eMAG przed pełnym startem
Nawet dobrze napisana integracja potrzebuje kontrolowanego uruchomienia. Nie włączaj od razu synchronizacji całego katalogu na trzech rynkach. Plan, który ogranicza ryzyko, wygląda zwykle tak:
Pobierz kategorie, charakterystyki i stawki VAT i sprawdź, czy mapowanie obejmuje wszystkie produkty z listy.
Opublikuj lub połącz z istniejącymi kartami kilka produktów i sprawdź ich status oraz komunikaty o błędach w panelu.
Zmień cenę i stan jednego produktu w swoim systemie i zmierz, po jakim czasie zmiana jest widoczna na eMAG.
Przeprowadź pełny cykl zamówienia: przyjęcie, fakturę, list przewozowy, przekazanie paczki i finalizację.
Zasymuluj sytuacje awaryjne: brak towaru, anulowanie przez klienta, zwrot i przerwę w połączeniu.
Dopiero potem rozszerz synchronizację na cały katalog i kolejne platformy.
Na czas testów ustal z zespołem, kto pilnuje zamówień ręcznie w panelu. Jeśli integracja przez kilka godzin nie pobierze zamówień, a nikt tego nie zauważy, spóźnione przyjęcia i wysyłki odbiją się na wskaźnikach konta. Dobrą praktyką jest prosty alert: gdy przez określony czas nie przyszło żadne zamówienie, choć zwykle przychodzą, ktoś dostaje powiadomienie i sprawdza panel.
[#checklista] Przed przekazaniem projektu programiście przygotuj: dane użytkownika API i stały adres IP serwera, listę produktów na każdy rynek, mapowanie kategorii i charakterystyk, komplet EAN, marek i zdjęć, reguły cen netto, VAT i walut, opis procesu zamówień, faktur, AWB i zwrotów, decyzję o źródle prawdy dla stanów oraz plan testów i osobę odpowiedzialną za monitoring.
[#uwaga] Śledź wersje dokumentacji API eMAG. Integracja napisana pod starszą wersję może przestać działać albo tracić dane po zmianach po stronie platformy. Ustal z programistą, kto sprawdza komunikaty eMAG o nowych wersjach i ile czasu potrzeba na aktualizację.
Własne API czy gotowy integrator dla eMAG
Gotowe integratory obsługują eMAG w trzech krajach i pokrywają większość typowych procesów: wystawianie ofert, synchronizację cen i stanów, pobieranie zamówień, faktury, AWB i zwroty. Własna integracja z API daje pełną kontrolę, ale wymaga utrzymania: aktualizacji po zmianach dokumentacji, monitorowania błędów i reagowania na awarie. Podobny dylemat opisaliśmy dla innych platform we wpisach API Allegro dla serwisów zagranicznych i API OTTO Market - kiedy warto je wdrożyć. Dla eMAG decyzję ułatwia porównanie:
[#chart:emg35c]
W praktyce wiele firm łączy oba podejścia. Integrator obsługuje oferty i zamówienia na eMAG, a własny kod łączy integrator z ERP albo dostarcza dane, których integrator nie ma, np. ceny liczone z kosztów dostawy do każdego kraju. Przed decyzją o własnym API zrób listę procesów, których integrator nie obsłuży - często okazuje się krótsza, niż się wydawało.
Jak Vinson pomaga w integracji z 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 pomagamy polskim firmom uporządkować dane i procesy przed integracją z eMAG.
Analiza, czy wystarczy integrator, czy potrzebne jest własne połączenie z API.
Przygotowanie mapowania kategorii, charakterystyk i danych produktów.
Opis procesu zamówień, zwrotów i wysyłki dla programisty.
Konfiguracja integracji eMAG w Base i bieżąca obsługa sprzedaży.
Najczęściej zadawane pytania
Czy eMAG udostępnia API dla sprzedawców?
Tak. eMAG Academy opisuje API eMAG Marketplace jako sposób na synchronizację platformy sprzedawcy z eMAG w zakresie ofert i zamówień, dostępny dla Rumunii, Bułgarii i Węgier. Dokumentacja jest dostępna w eMAG Academy, a aktualna wersja to v4.5.1, obowiązująca od 2 marca 2026 roku.
Co można zautomatyzować przez API eMAG?
Publikację produktów i dokumentacji, aktualizację cen, stanów i czasu realizacji, pobieranie i przyjmowanie zamówień, faktury, listy przewozowe AWB oraz zwroty. Dokładny zakres zasobów sprawdź w aktualnej wersji dokumentacji.
Jak uzyskać dostęp do API eMAG Marketplace?
Potrzebujesz aktywnego konta sprzedawcy, użytkownika z uprawnieniami do API i zgłoszenia adresu IP serwera w panelu eMAG. Według pomocy Base adres IP dodaje się w sekcji Moje konto - Profil - Szczegóły techniczne.
Czy API eMAG działa osobno dla Rumunii, Bułgarii i Węgier?
Tak, każda platforma ma osobny adres API i osobną konfigurację, a zamówienia z każdego kraju pobierasz oddzielnie. Przy synchronizacji ofert w programie Cross-Border ustal, który system aktualizuje ceny i stany na poszczególnych rynkach.
Czy lepiej napisać własną integrację z API eMAG, czy użyć integratora?
Dla większości firm szybszy i tańszy jest gotowy integrator, który obsługuje oferty, zamówienia, AWB i zwroty w trzech krajach. Własne API ma sens przy nietypowych procesach, dużej skali albo konieczności połączenia z rozbudowanym ERP.
Planujesz zautomatyzować sprzedaż na eMAG i nie wiesz, od czego zacząć? Zobacz, jak prowadzimy sprzedaż na eMAG z Vinson - od przygotowania danych po integrację i obsługę zamówień w Rumunii, Bułgarii i na Węgrzech.
Jak uzyskać dostęp do eMAG Marketplace API
Dostęp do API mają sprzedawcy z aktywnym kontem na eMAG Marketplace. Połączenie opiera się na danych logowania użytkownika panelu z uprawnieniami do API oraz na liście adresów IP, z których eMAG przyjmuje zapytania. Według pomocy Base adres IP integracji dodaje się w panelu eMAG w sekcji Moje konto - Profil - Szczegóły techniczne, a stamtąd pobiera się też kod API potrzebny do części funkcji. Własny serwer integracji musi mieć więc stały adres IP, a jego zmiana wymaga aktualizacji w panelu. Szczegóły tworzenia użytkownika API i ewentualnego środowiska testowego potwierdź w dokumentacji albo u opiekuna eMAG.
Przed pierwszym wywołaniem ustal z programistą kilka zasad bezpieczeństwa. Dane dostępowe trzymaj poza kodem źródłowym, w bezpiecznym magazynie haseł. Używaj osobnego użytkownika dla integracji, a nie konta właściciela, żeby zmiana hasła w panelu nie zatrzymała synchronizacji. Rejestruj wszystkie wywołania i odpowiedzi z błędami - bez tego trudno później ustalić, dlaczego cena albo stan nie zmieniły się na eMAG.
Jak wygląda obsługa zamówienia przez API eMAG
Najwięcej korzyści z API daje automatyczna obsługa zamówień, bo tu liczy się czas. Każde opóźnienie w przyjęciu zamówienia czy przekazaniu paczki kurierowi odbija się na wskaźnikach konta. Typowy cykl zamówienia w integracji wygląda tak:
[#chart:emg35b]
Ważny jest moment tworzenia listu przewozowego. Przy eMAG Courier wygenerowanie AWB wysyła zlecenie odbioru do kuriera, więc integracja powinna tworzyć je dopiero wtedy, gdy paczka jest gotowa. Jeśli wysyłasz własnym przewoźnikiem, numer przesyłki musi trafić do zamówienia na eMAG - według pomocy Base takie numery przekazuje się jako zewnętrzne AWB, po wcześniejszej aktywacji tej opcji po stronie eMAG. eMAG Academy wymienia wysyłkę bez AWB wygenerowanego z platformy wśród problemów, które psują wskaźniki sprzedawcy.
Ceny, VAT i czas realizacji w API
Kilka pól wymaga szczególnej uwagi przy mapowaniu danych. Według pomocy Base integracja przesyła do eMAG cenę netto razem ze stawką VAT, a eMAG wylicza cenę brutto, dlatego Twój system musi znać właściwą stawkę dla każdego produktu i kraju. Czas realizacji, czyli liczba dni do przekazania paczki kurierowi, przyjmuje według tej samej pomocy tylko określone wartości: 0, 1, 2, 3, 6, 9, 30, 60 lub 90 dni (stan na sierpień 2026 - sprawdź aktualną dokumentację). Przy wariantach pamiętaj, że według Base eMAG obsługuje najwyżej dwa parametry wariantujące w jednej rodzinie produktów.
Co przygotować dla programisty przed integracją z eMAG
Najdroższa część integracji to nie kod, tylko decyzje, których nikt nie podjął przed startem. Programista nie wie, które produkty mają trafić na eMAG, jak mapować Twoje kategorie na kategorie eMAG ani co zrobić z zamówieniem bez towaru. Zanim zlecisz pracę, przygotuj pakiet startowy:
| Element | Po co jest potrzebny | Kto przygotowuje |
|---|---|---|
| Dostęp do API i stały adres IP | Bez nich integracja nie wykona żadnego zapytania | Właściciel konta i administrator serwera |
| Lista produktów na eMAG | Określa zakres synchronizacji | Osoba od sprzedaży |
| Mapowanie kategorii i charakterystyk | Produkt bez wymaganych parametrów zostanie odrzucony | Osoba od ofert z programistą |
| Dane produktów: EAN, marka, zdjęcia, warianty | Publikacja nowych kart i łączenie z istniejącymi | Osoba od ofert |
| Reguły cen i walut | Cena netto, VAT i przeliczenie na leje, forinty i euro | Właściciel i księgowość |
| Proces zamówień i zwrotów | Kolejność statusów, faktury, AWB i zwroty | Magazyn i obsługa klienta |
| Źródło prawdy dla stanów | Jeden system decyduje o stanie na trzech rynkach | Właściciel z programistą |
Do pakietu dołącz też listę błędów, które już znasz z ręcznej pracy w panelu: produkty odrzucane przy walidacji dokumentacji, warianty, które nie łączą się w rodziny, oferty bez przycisku zakupu. To skraca testy, bo programista od razu sprawdzi, jak integracja zachowuje się w tych sytuacjach.
Limity zapytań i obsługa błędów
Dokumentacja i warunki korzystania z API określają limity liczby zapytań, a integratory opisują osobne limity dla zamówień i dla pozostałych zasobów. Integracja, która przy każdej zmianie stanu wysyła pojedyncze zapytanie, szybko w nie uderzy. Dlatego aktualizacje cen i stanów grupuj w paczki, ponawiaj zapytania odrzucone z powodu limitu z opóźnieniem i ustal priorytety: zamówienia zawsze przed aktualizacją opisów. Konkretne wartości limitów sprawdź w aktualnej wersji dokumentacji, bo mogą się zmieniać między wersjami.
Jak przetestować integrację z eMAG przed pełnym startem
Nawet dobrze napisana integracja potrzebuje kontrolowanego uruchomienia. Nie włączaj od razu synchronizacji całego katalogu na trzech rynkach. Plan, który ogranicza ryzyko, wygląda zwykle tak:
Pobierz kategorie, charakterystyki i stawki VAT i sprawdź, czy mapowanie obejmuje wszystkie produkty z listy.
Opublikuj lub połącz z istniejącymi kartami kilka produktów i sprawdź ich status oraz komunikaty o błędach w panelu.
Zmień cenę i stan jednego produktu w swoim systemie i zmierz, po jakim czasie zmiana jest widoczna na eMAG.
Przeprowadź pełny cykl zamówienia: przyjęcie, fakturę, list przewozowy, przekazanie paczki i finalizację.
Zasymuluj sytuacje awaryjne: brak towaru, anulowanie przez klienta, zwrot i przerwę w połączeniu.
Dopiero potem rozszerz synchronizację na cały katalog i kolejne platformy.
Na czas testów ustal z zespołem, kto pilnuje zamówień ręcznie w panelu. Jeśli integracja przez kilka godzin nie pobierze zamówień, a nikt tego nie zauważy, spóźnione przyjęcia i wysyłki odbiją się na wskaźnikach konta. Dobrą praktyką jest prosty alert: gdy przez określony czas nie przyszło żadne zamówienie, choć zwykle przychodzą, ktoś dostaje powiadomienie i sprawdza panel.
[#checklista] Przed przekazaniem projektu programiście przygotuj: dane użytkownika API i stały adres IP serwera, listę produktów na każdy rynek, mapowanie kategorii i charakterystyk, komplet EAN, marek i zdjęć, reguły cen netto, VAT i walut, opis procesu zamówień, faktur, AWB i zwrotów, decyzję o źródle prawdy dla stanów oraz plan testów i osobę odpowiedzialną za monitoring.
[#uwaga] Śledź wersje dokumentacji API eMAG. Integracja napisana pod starszą wersję może przestać działać albo tracić dane po zmianach po stronie platformy. Ustal z programistą, kto sprawdza komunikaty eMAG o nowych wersjach i ile czasu potrzeba na aktualizację.
Własne API czy gotowy integrator dla eMAG
Gotowe integratory obsługują eMAG w trzech krajach i pokrywają większość typowych procesów: wystawianie ofert, synchronizację cen i stanów, pobieranie zamówień, faktury, AWB i zwroty. Własna integracja z API daje pełną kontrolę, ale wymaga utrzymania: aktualizacji po zmianach dokumentacji, monitorowania błędów i reagowania na awarie. Podobny dylemat opisaliśmy dla innych platform we wpisach API Allegro dla serwisów zagranicznych i API OTTO Market - kiedy warto je wdrożyć. Dla eMAG decyzję ułatwia porównanie:
[#chart:emg35c]
W praktyce wiele firm łączy oba podejścia. Integrator obsługuje oferty i zamówienia na eMAG, a własny kod łączy integrator z ERP albo dostarcza dane, których integrator nie ma, np. ceny liczone z kosztów dostawy do każdego kraju. Przed decyzją o własnym API zrób listę procesów, których integrator nie obsłuży - często okazuje się krótsza, niż się wydawało.
Jak Vinson pomaga w integracji z 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 pomagamy polskim firmom uporządkować dane i procesy przed integracją z eMAG.
Analiza, czy wystarczy integrator, czy potrzebne jest własne połączenie z API.
Przygotowanie mapowania kategorii, charakterystyk i danych produktów.
Opis procesu zamówień, zwrotów i wysyłki dla programisty.
Konfiguracja integracji eMAG w Base i bieżąca obsługa sprzedaży.
Najczęściej zadawane pytania
Czy eMAG udostępnia API dla sprzedawców?
Tak. eMAG Academy opisuje API eMAG Marketplace jako sposób na synchronizację platformy sprzedawcy z eMAG w zakresie ofert i zamówień, dostępny dla Rumunii, Bułgarii i Węgier. Dokumentacja jest dostępna w eMAG Academy, a aktualna wersja to v4.5.1, obowiązująca od 2 marca 2026 roku.
Co można zautomatyzować przez API eMAG?
Publikację produktów i dokumentacji, aktualizację cen, stanów i czasu realizacji, pobieranie i przyjmowanie zamówień, faktury, listy przewozowe AWB oraz zwroty. Dokładny zakres zasobów sprawdź w aktualnej wersji dokumentacji.
Jak uzyskać dostęp do API eMAG Marketplace?
Potrzebujesz aktywnego konta sprzedawcy, użytkownika z uprawnieniami do API i zgłoszenia adresu IP serwera w panelu eMAG. Według pomocy Base adres IP dodaje się w sekcji Moje konto - Profil - Szczegóły techniczne.
Czy API eMAG działa osobno dla Rumunii, Bułgarii i Węgier?
Tak, każda platforma ma osobny adres API i osobną konfigurację, a zamówienia z każdego kraju pobierasz oddzielnie. Przy synchronizacji ofert w programie Cross-Border ustal, który system aktualizuje ceny i stany na poszczególnych rynkach.
Czy lepiej napisać własną integrację z API eMAG, czy użyć integratora?
Dla większości firm szybszy i tańszy jest gotowy integrator, który obsługuje oferty, zamówienia, AWB i zwroty w trzech krajach. Własne API ma sens przy nietypowych procesach, dużej skali albo konieczności połączenia z rozbudowanym ERP.
Planujesz zautomatyzować sprzedaż na eMAG i nie wiesz, od czego zacząć? Zobacz, jak prowadzimy sprzedaż na eMAG z Vinson - od przygotowania danych po integrację i obsługę zamówień 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