Integracja eMAG z ERP - jak połączyć zamówienia z polskim systemem magazynowym

Miłosz Brzegowy
Miłosz Brzegowy
Head of Growth and Demand Generation
Integracja eMAG z ERP - jak połączyć zamówienia z polskim systemem magazynowym

Integracja eMAG z ERP polega na tym, że zamówienia z eMAG.ro, eMAG.hu i eMAG.bg automatycznie trafiają do polskiego systemu magazynowo-sprzedażowego, a ten oddaje do eMAG aktualne stany, ceny, dokumenty i statusy realizacji. Najczęściej między eMAG a ERP stoi integrator, np. Base, który obsługuje połączenie z API eMAG dla trzech rynków, a ERP pozostaje źródłem stanów i dokumentów sprzedaży. Bezpośrednie połączenie ERP z API eMAG też jest możliwe, ale wymaga programisty i stałego utrzymania.
Dla polskiej firmy, która ma już Subiekta, Comarch ERP Optima albo inny program magazynowy, eMAG to kolejny kanał sprzedaży, ale z trzema walutami, trzema rynkami i statusami zamówień, których nie zna żaden polski system. Jeśli nie ustalisz, który system za co odpowiada, ten sam produkt sprzeda się dwa razy, a faktura trafi do klienta z opóźnieniem. W tym wpisie pokazujemy, jak podzielić role między eMAG, integrator i ERP, jakie dane muszą płynąć w każdą stronę i kiedy warto rozważyć bezpośrednie połączenie z API.
[#wazne] W skrócie: integracja eMAG z ERP łączy zamówienia z Rumunii, Węgier i Bułgarii z polskim systemem magazynowym. Najprostszy model to eMAG - integrator (np. Base) - ERP: integrator pobiera zamówienia i wysyła do eMAG stany, ceny, faktury i numery przesyłek, a ERP rezerwuje towar i wystawia dokumenty. Każdy rynek eMAG to osobne połączenie, a zamówienia z magazynu eMAG wymagają osobnej obsługi. W Vinson pomagamy polskim firmom zaplanować integrację i prowadzimy sprzedaż na eMAG w trzech krajach.
Integracja eMAG z ERP - kto za co odpowiada
ERP (Enterprise Resource Planning) to system, w którym firma prowadzi magazyn, sprzedaż i dokumenty - w małych i średnich firmach w Polsce często jest to program typu Subiekt czy Comarch ERP Optima. Integracja eMAG z ERP to połączenie, dzięki któremu dane o zamówieniach, stanach i dokumentach przepływają między platformą a tym systemem bez przepisywania. Według eMAG Academy API eMAG Marketplace działa dla platform w Rumunii, Bułgarii i na Węgrzech, a aktualna dokumentacja ma wersję v4.5.1, obowiązującą od 2 marca 2026 roku (stan na czerwiec 2026 - sprawdź aktualną wersję).
Najwięcej problemów w takich projektach nie wynika z techniki, tylko z braku podziału ról. Każdy system powinien mieć jasno określone zadania, a dane, za które odpowiada, powinny płynąć tylko w jedną stronę. Typowy podział wygląda tak:
[#chart:emg40a]
Ten podział warto zapisać przed wdrożeniem, razem z nazwiskiem osoby, która odpowiada za każdy obszar. Przy sprzedaży w trzech krajach pojawiają się pytania, których nie ma przy Allegro: w jakiej walucie ERP ma zapisać zamówienie, jak oznaczyć rynek, z którego przyszło, i gdzie trafiają zamówienia realizowane z magazynu eMAG. Odpowiedzi na nie decydują o konfiguracji integratora.
Trzy rynki eMAG w jednym ERP
Według pomocy Base jedna integracja pobiera zamówienia tylko z jednego rynku, więc do sprzedaży na eMAG.ro, eMAG.hu i eMAG.bg dodajesz trzy połączenia. Zamówienia zwykłe i realizowane z magazynu eMAG wymagają osobnych integracji na tym samym rynku. Dla ERP oznacza to kilka źródeł zamówień, które warto rozróżnić już przy imporcie, np. osobnym oznaczeniem, magazynem dokumentów albo serią numeracji. Ułatwia to raporty sprzedaży dla każdego kraju i rozliczenia z księgowością. Jak aktywować sprzedaż na Węgry i do Bułgarii, opisujemy we wpisie Cross-Border na eMAG.
Jakie dane płyną między eMAG a ERP
Zanim wybierzesz narzędzie, rozpisz przepływ danych. Dla każdej informacji ustal kierunek i system, który jest jej źródłem. Przy sprzedaży z magazynu w Polsce typowy zestaw wygląda tak (stan na czerwiec 2026 - sprawdź aktualną dokumentację integratora):
| Dane | Kierunek | Źródło | Uwagi |
|---|---|---|---|
| Zamówienia | eMAG - integrator - ERP | eMAG | Osobno z eMAG.ro, eMAG.hu i eMAG.bg |
| Stany magazynowe | ERP - integrator - eMAG | ERP | Jeden stan dla wszystkich kanałów sprzedaży |
| Ceny | ERP lub integrator - eMAG | Ustalasz sam | Cena netto ze stawką VAT, waluta rynku |
| Statusy zamówień | Integrator - eMAG | Integrator | Nowe, przyjęte, przygotowane, zrealizowane |
| Faktury | ERP - integrator - eMAG | ERP lub program fakturowy | Dokument dołączany do zamówienia |
| Numery przesyłek | Integrator lub kurier - eMAG | System kurierski | AWB z platformy albo zewnętrzny numer |
| Zwroty | eMAG - integrator - ERP | eMAG | Korekta dokumentu i przyjęcie towaru |
Kluczowa zasada: stan magazynowy ma jedno źródło. Jeśli ERP prowadzi magazyn dla Allegro, sklepu i eMAG, to ERP decyduje o stanie, a integrator tylko go przekazuje. Gdy stan da się zmienić ręcznie w kilku miejscach, prędzej czy później dojdzie do sprzedaży towaru, którego nie ma, a anulowanie zamówienia przez sprzedawcę psuje wskaźniki konta w Account Health.
Integracja eMAG z ERP polega na tym, że zamówienia z eMAG.ro, eMAG.hu i eMAG.bg automatycznie trafiają do polskiego systemu magazynowo-sprzedażowego, a ten oddaje do eMAG aktualne stany, ceny, dokumenty i statusy realizacji. Najczęściej między eMAG a ERP stoi integrator, np. Base, który obsługuje połączenie z API eMAG dla trzech rynków, a ERP pozostaje źródłem stanów i dokumentów sprzedaży. Bezpośrednie połączenie ERP z API eMAG też jest możliwe, ale wymaga programisty i stałego utrzymania.
Dla polskiej firmy, która ma już Subiekta, Comarch ERP Optima albo inny program magazynowy, eMAG to kolejny kanał sprzedaży, ale z trzema walutami, trzema rynkami i statusami zamówień, których nie zna żaden polski system. Jeśli nie ustalisz, który system za co odpowiada, ten sam produkt sprzeda się dwa razy, a faktura trafi do klienta z opóźnieniem. W tym wpisie pokazujemy, jak podzielić role między eMAG, integrator i ERP, jakie dane muszą płynąć w każdą stronę i kiedy warto rozważyć bezpośrednie połączenie z API.
[#wazne] W skrócie: integracja eMAG z ERP łączy zamówienia z Rumunii, Węgier i Bułgarii z polskim systemem magazynowym. Najprostszy model to eMAG - integrator (np. Base) - ERP: integrator pobiera zamówienia i wysyła do eMAG stany, ceny, faktury i numery przesyłek, a ERP rezerwuje towar i wystawia dokumenty. Każdy rynek eMAG to osobne połączenie, a zamówienia z magazynu eMAG wymagają osobnej obsługi. W Vinson pomagamy polskim firmom zaplanować integrację i prowadzimy sprzedaż na eMAG w trzech krajach.
Integracja eMAG z ERP - kto za co odpowiada
ERP (Enterprise Resource Planning) to system, w którym firma prowadzi magazyn, sprzedaż i dokumenty - w małych i średnich firmach w Polsce często jest to program typu Subiekt czy Comarch ERP Optima. Integracja eMAG z ERP to połączenie, dzięki któremu dane o zamówieniach, stanach i dokumentach przepływają między platformą a tym systemem bez przepisywania. Według eMAG Academy API eMAG Marketplace działa dla platform w Rumunii, Bułgarii i na Węgrzech, a aktualna dokumentacja ma wersję v4.5.1, obowiązującą od 2 marca 2026 roku (stan na czerwiec 2026 - sprawdź aktualną wersję).
Najwięcej problemów w takich projektach nie wynika z techniki, tylko z braku podziału ról. Każdy system powinien mieć jasno określone zadania, a dane, za które odpowiada, powinny płynąć tylko w jedną stronę. Typowy podział wygląda tak:
[#chart:emg40a]
Ten podział warto zapisać przed wdrożeniem, razem z nazwiskiem osoby, która odpowiada za każdy obszar. Przy sprzedaży w trzech krajach pojawiają się pytania, których nie ma przy Allegro: w jakiej walucie ERP ma zapisać zamówienie, jak oznaczyć rynek, z którego przyszło, i gdzie trafiają zamówienia realizowane z magazynu eMAG. Odpowiedzi na nie decydują o konfiguracji integratora.
Trzy rynki eMAG w jednym ERP
Według pomocy Base jedna integracja pobiera zamówienia tylko z jednego rynku, więc do sprzedaży na eMAG.ro, eMAG.hu i eMAG.bg dodajesz trzy połączenia. Zamówienia zwykłe i realizowane z magazynu eMAG wymagają osobnych integracji na tym samym rynku. Dla ERP oznacza to kilka źródeł zamówień, które warto rozróżnić już przy imporcie, np. osobnym oznaczeniem, magazynem dokumentów albo serią numeracji. Ułatwia to raporty sprzedaży dla każdego kraju i rozliczenia z księgowością. Jak aktywować sprzedaż na Węgry i do Bułgarii, opisujemy we wpisie Cross-Border na eMAG.
Jakie dane płyną między eMAG a ERP
Zanim wybierzesz narzędzie, rozpisz przepływ danych. Dla każdej informacji ustal kierunek i system, który jest jej źródłem. Przy sprzedaży z magazynu w Polsce typowy zestaw wygląda tak (stan na czerwiec 2026 - sprawdź aktualną dokumentację integratora):
| Dane | Kierunek | Źródło | Uwagi |
|---|---|---|---|
| Zamówienia | eMAG - integrator - ERP | eMAG | Osobno z eMAG.ro, eMAG.hu i eMAG.bg |
| Stany magazynowe | ERP - integrator - eMAG | ERP | Jeden stan dla wszystkich kanałów sprzedaży |
| Ceny | ERP lub integrator - eMAG | Ustalasz sam | Cena netto ze stawką VAT, waluta rynku |
| Statusy zamówień | Integrator - eMAG | Integrator | Nowe, przyjęte, przygotowane, zrealizowane |
| Faktury | ERP - integrator - eMAG | ERP lub program fakturowy | Dokument dołączany do zamówienia |
| Numery przesyłek | Integrator lub kurier - eMAG | System kurierski | AWB z platformy albo zewnętrzny numer |
| Zwroty | eMAG - integrator - ERP | eMAG | Korekta dokumentu i przyjęcie towaru |
Kluczowa zasada: stan magazynowy ma jedno źródło. Jeśli ERP prowadzi magazyn dla Allegro, sklepu i eMAG, to ERP decyduje o stanie, a integrator tylko go przekazuje. Gdy stan da się zmienić ręcznie w kilku miejscach, prędzej czy później dojdzie do sprzedaży towaru, którego nie ma, a anulowanie zamówienia przez sprzedawcę psuje wskaźniki konta w Account Health.
- 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 GenerationZamówienie z eMAG w ERP krok po kroku
Najważniejszy proces w integracji to obsługa zamówienia, bo od jej tempa zależą wskaźniki konta. Według pomocy Base zamówienia na eMAG mają statusy: nowe, przyjęte, przygotowane, zrealizowane, a także anulowane i zwrócone, a zmiana statusu w Base może zmienić status w eMAG zgodnie z mapowaniem. Ścieżka zamówienia przy modelu z integratorem i ERP wygląda zwykle tak:
[#chart:emg40b]
Największe ryzyko kryje się na styku integratora i ERP. Jeśli import do ERP zatrzyma się na kilka godzin, zamówienie wisi w statusie nowym, magazyn go nie widzi, a termin przekazania paczki kurierowi biegnie. Dlatego warto ustawić prosty alarm: gdy zamówienie z eMAG nie pojawi się w ERP w określonym czasie, ktoś dostaje powiadomienie i sprawdza połączenie.
Statusy eMAG a dokumenty w ERP
Polskie programy magazynowe pracują na dokumentach: zamówieniu od klienta, rezerwacji, wydaniu z magazynu, fakturze lub paragonie. eMAG pracuje na statusach. Integracja musi więc przypisać zdarzenia jednego świata do drugiego. Przykładowe powiązanie, które sprawdza się przy wysyłce z Polski:
Status nowy w eMAG - zamówienie od klienta w ERP z rezerwacją towaru.
Status przyjęty - potwierdzenie, że towar jest i zamówienie trafia do kompletacji.
Status przygotowany - wydanie z magazynu, faktura dołączona do zamówienia i list przewozowy.
Status zrealizowany - przekazanie paczki kurierowi.
Anulowanie lub zwrot - zdjęcie rezerwacji albo korekta dokumentu i przyjęcie towaru.
Kolejność ma znaczenie. Pomoc Base zaleca tworzenie przesyłek przed zmianą statusu na wysłany, a eMAG Academy wymienia wysyłkę bez AWB wygenerowanego z platformy wśród problemów, które psują wskaźniki. Jeśli korzystasz z eMAG Courier Poland, pamiętaj, że po aktywacji usługi listy przewozowe wystawiasz tylko przez nią.
W praktyce oznacza to, że ERP nie musi znać statusów eMAG, ale musi wysyłać sygnał w odpowiednim momencie. Jeśli magazyn zatwierdza wydanie w ERP, integrator powinien od razu zmienić status zamówienia, dołączyć fakturę i utworzyć list przewozowy. Gdy te trzy czynności dzieją się w różnych systemach i o różnych porach, łatwo o zamówienie oznaczone jako przygotowane bez faktury albo przekazane kurierowi bez numeru przesyłki na platformie.
Stany magazynowe w integracji eMAG z ERP
Stany to obszar, w którym rozjazd kosztuje najwięcej. Według strony integracji Base stany mogą być synchronizowane nawet co 5 minut, a ceny do godziny, a oferta wyłącza się, gdy stan spada do zera (stan na czerwiec 2026 - sprawdź aktualne zasady w Base). To jednak tylko połowa drogi: liczy się też, jak często ERP przekazuje stan do integratora. Jeśli ERP synchronizuje stany raz na godzinę, a w tym czasie sprzedajesz ostatnie sztuki na Allegro i na eMAG, integrator nie pomoże.
Przy sprzedaży w trzech krajach dochodzi decyzja o tym, czy oferty na eMAG.hu i eMAG.bg są synchronizowane z Rumunią po stronie eMAG, czy aktualizowane osobno przez integrator. Według infocenter eMAG oferty wyeksportowane automatycznie mają taką samą cenę i stan jak w Rumunii, a oferty z pliku dostają inne identyfikatory i nie korzystają z synchronizacji. Ustal, który mechanizm odpowiada za stany na każdej platformie, bo dwa mechanizmy naraz nadpisują sobie dane.
Osobną sytuacją jest Fulfilment by eMAG. Gdy towar leży w magazynie eMAG, stanem zarządza platforma. Według pomocy Base przy fulfilmencie część aktualizacji, np. stanu i czasu obsługi, jest pomijana. W ERP warto więc prowadzić taki zapas jako osobny magazyn, żeby nie sprzedawać go w innych kanałach.
Integrator czy bezpośrednie połączenie ERP z API eMAG
Część producentów ERP i firm wdrożeniowych oferuje własne konektory do marketplace'ów, a duże firmy rozważają napisanie połączenia z API eMAG. Według strony integracji Base wśród systemów księgowych, które można połączyć z eMAG przez Base, są m.in. Subiekt, Optima, wFirma, inFakt, Fakturownia i iFirma (stan na czerwiec 2026 - sprawdź aktualną listę). Sklepy na Shoperze łączą się z eMAG przez aplikację Manager eMAG - Apilo. Kiedy który model ma sens, pokazuje porównanie:
[#chart:emg40c]
Ten sam dylemat znają firmy sprzedające w Niemczech - opisaliśmy go we wpisie automatyzacja zamówień z OTTO - magazyn, ERP i kurier. Logika jest podobna, ale przy eMAG dochodzą trzy rynki, trzy waluty i usługi logistyczne platformy.
Co sprawdzić przed wyborem narzędzia
Czy narzędzie obsługuje eMAG.ro, eMAG.hu i eMAG.bg oraz zamówienia z magazynu eMAG.
Jak często przekazuje stany i ceny w obie strony, także na odcinku do ERP.
Czy przenosi do ERP walutę zamówienia i oznaczenie rynku.
Czy przekazuje do eMAG faktury i numery przesyłek oraz w jakim momencie.
Jak obsługuje zwroty i korekty dokumentów.
Kto utrzymuje połączenie po zmianach w API eMAG i jak szybko reaguje.
Waluty, VAT i dokumenty w ERP
Zamówienia z eMAG przychodzą w lejach, forintach i euro, bo Bułgaria przyjęła euro 1 stycznia 2026 roku. ERP musi zapisać zamówienie w walucie, w jakiej zapłacił klient, a dokument sprzedaży wystawić zgodnie z zasadami VAT, które obowiązują Twoją firmę. Według pomocy Base do eMAG przesyłana jest cena netto ze stawką VAT, a cenę brutto wylicza eMAG, więc stawki w ERP i w integratorze muszą być spójne. Przy sprzedaży wysyłkowej do konsumentów w innych krajach UE w grę wchodzi procedura OSS. Sposób księgowania, kurs przeliczenia i stawki VAT ustal z księgowym lub doradcą podatkowym - tu opisujemy je tylko ogólnie.
[#checklista] Przed wdrożeniem integracji eMAG z ERP ustal: listę produktów na każdy rynek, system będący źródłem stanów i cen, mapowanie statusów eMAG na dokumenty w ERP, sposób oznaczania rynku i waluty zamówienia, moment wystawienia faktury i przekazania jej do eMAG, sposób generowania listów przewozowych, obsługę zwrotów i korekt, osobny magazyn dla zapasu w Fulfilment by eMAG oraz osobę, która monitoruje połączenie.
Najczęstsze błędy przy łączeniu eMAG z ERP
Większość problemów, które widzimy po wdrożeniach, powtarza się niezależnie od programu magazynowego. Rzadko chodzi o awarię - zwykle o decyzję, której nikt nie podjął przed startem:
Dwa źródła stanu - stan zmieniany ręcznie w panelu eMAG i jednocześnie wysyłany z ERP, przez co po kilku godzinach nikt nie wie, który jest prawdziwy.
Zamówienia bez oznaczenia rynku - w ERP nie da się odróżnić zamówienia z eMAG.hu od zamówienia z eMAG.ro, więc raporty i rozliczenia trzeba poprawiać ręcznie.
Waluta zamieniona na złote przy imporcie - kwoty w dokumencie nie zgadzają się z kwotą zapłaconą przez klienta i z rozliczeniem z eMAG.
Faktura wystawiona, ale niewysłana do eMAG - dokument istnieje w ERP, a zamówienie na platformie nie ma załącznika.
Zwrot przyjęty w magazynie bez korekty - towar wraca na stan, ale sprzedaż w ewidencji zostaje bez zmian.
Każdy z tych błędów da się wychwycić w pierwszym tygodniu, jeśli codziennie porównasz kilka zamówień w panelu eMAG z ich odpowiednikami w ERP: status, kwotę, walutę, dokument i numer przesyłki. Po kilku dniach bez rozbieżności kontrolę można ograniczyć do wyrywkowej.
Podobnie warto podejść do magazynu w Polsce przy innych zagranicznych platformach - zasady synchronizacji stanów i terminów dla rynku niemieckiego opisujemy we wpisie magazyn w Polsce a zamówienia z Kaufland.de.
Jak Vinson pomaga w integracji eMAG z ERP
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 połączyć eMAG z ich systemem magazynowym.
Analiza obecnego ERP i wybór modelu: integrator czy własne połączenie z API.
Opis przepływu danych, mapowanie statusów i dokumentów.
Konfiguracja integracji eMAG w Base dla trzech rynków.
Bieżąca obsługa sprzedaży i kontrola zgodności stanów.
Najczęściej zadawane pytania
Czy eMAG można połączyć z Subiektem lub Optimą?
Tak, najczęściej przez integrator. Według strony integracji Base przez Base można połączyć eMAG m.in. z Subiektem i Optimą, a także z programami fakturowymi, takimi jak wFirma, inFakt, Fakturownia czy iFirma. Zakres funkcji każdego połączenia sprawdź w dokumentacji integratora.
Czy integracja eMAG z ERP obsłuży Rumunię, Węgry i Bułgarię?
Tak, ale każdy rynek to osobne połączenie z eMAG. Według pomocy Base jedna integracja pobiera zamówienia z jednego rynku, więc dla eMAG.ro, eMAG.hu i eMAG.bg dodajesz trzy integracje, a zamówienia z magazynu eMAG wymagają kolejnych.
Który system powinien być źródłem stanów przy sprzedaży na eMAG?
Ten, w którym prowadzisz magazyn dla wszystkich kanałów sprzedaży, zwykle ERP. Integrator powinien tylko przekazywać stan do eMAG, a zmiany ręczne w panelu eMAG warto ograniczyć do sytuacji awaryjnych.
Czy warto połączyć ERP bezpośrednio z API eMAG?
Bezpośrednie połączenie ma sens przy dużej skali, nietypowych procesach albo rozbudowanym ERP, którego integrator nie obsłuży. Wymaga jednak programisty, monitoringu i aktualizacji po zmianach w dokumentacji API, której wersja v4.5.1 obowiązuje od 2 marca 2026 roku.
Jak ERP ma obsłużyć zamówienia z Fulfilment by eMAG?
Najlepiej jako osobne źródło zamówień i osobny magazyn, bo towarem w magazynie eMAG zarządza platforma. Według pomocy Base zamówienia z fulfilmentu obsługuje się w osobnej integracji, a część aktualizacji, np. stanu i czasu obsługi, jest dla nich pomijana.
Chcesz, żeby zamówienia z eMAG trafiały do Twojego ERP bez przepisywania i pomyłek w stanach? Zobacz, jak prowadzimy sprzedaż na eMAG z Vinson - od planu integracji po codzienną obsługę zamówień w Rumunii, na Węgrzech i w Bułgarii.
Zamówienie z eMAG w ERP krok po kroku
Najważniejszy proces w integracji to obsługa zamówienia, bo od jej tempa zależą wskaźniki konta. Według pomocy Base zamówienia na eMAG mają statusy: nowe, przyjęte, przygotowane, zrealizowane, a także anulowane i zwrócone, a zmiana statusu w Base może zmienić status w eMAG zgodnie z mapowaniem. Ścieżka zamówienia przy modelu z integratorem i ERP wygląda zwykle tak:
[#chart:emg40b]
Największe ryzyko kryje się na styku integratora i ERP. Jeśli import do ERP zatrzyma się na kilka godzin, zamówienie wisi w statusie nowym, magazyn go nie widzi, a termin przekazania paczki kurierowi biegnie. Dlatego warto ustawić prosty alarm: gdy zamówienie z eMAG nie pojawi się w ERP w określonym czasie, ktoś dostaje powiadomienie i sprawdza połączenie.
Statusy eMAG a dokumenty w ERP
Polskie programy magazynowe pracują na dokumentach: zamówieniu od klienta, rezerwacji, wydaniu z magazynu, fakturze lub paragonie. eMAG pracuje na statusach. Integracja musi więc przypisać zdarzenia jednego świata do drugiego. Przykładowe powiązanie, które sprawdza się przy wysyłce z Polski:
Status nowy w eMAG - zamówienie od klienta w ERP z rezerwacją towaru.
Status przyjęty - potwierdzenie, że towar jest i zamówienie trafia do kompletacji.
Status przygotowany - wydanie z magazynu, faktura dołączona do zamówienia i list przewozowy.
Status zrealizowany - przekazanie paczki kurierowi.
Anulowanie lub zwrot - zdjęcie rezerwacji albo korekta dokumentu i przyjęcie towaru.
Kolejność ma znaczenie. Pomoc Base zaleca tworzenie przesyłek przed zmianą statusu na wysłany, a eMAG Academy wymienia wysyłkę bez AWB wygenerowanego z platformy wśród problemów, które psują wskaźniki. Jeśli korzystasz z eMAG Courier Poland, pamiętaj, że po aktywacji usługi listy przewozowe wystawiasz tylko przez nią.
W praktyce oznacza to, że ERP nie musi znać statusów eMAG, ale musi wysyłać sygnał w odpowiednim momencie. Jeśli magazyn zatwierdza wydanie w ERP, integrator powinien od razu zmienić status zamówienia, dołączyć fakturę i utworzyć list przewozowy. Gdy te trzy czynności dzieją się w różnych systemach i o różnych porach, łatwo o zamówienie oznaczone jako przygotowane bez faktury albo przekazane kurierowi bez numeru przesyłki na platformie.
Stany magazynowe w integracji eMAG z ERP
Stany to obszar, w którym rozjazd kosztuje najwięcej. Według strony integracji Base stany mogą być synchronizowane nawet co 5 minut, a ceny do godziny, a oferta wyłącza się, gdy stan spada do zera (stan na czerwiec 2026 - sprawdź aktualne zasady w Base). To jednak tylko połowa drogi: liczy się też, jak często ERP przekazuje stan do integratora. Jeśli ERP synchronizuje stany raz na godzinę, a w tym czasie sprzedajesz ostatnie sztuki na Allegro i na eMAG, integrator nie pomoże.
Przy sprzedaży w trzech krajach dochodzi decyzja o tym, czy oferty na eMAG.hu i eMAG.bg są synchronizowane z Rumunią po stronie eMAG, czy aktualizowane osobno przez integrator. Według infocenter eMAG oferty wyeksportowane automatycznie mają taką samą cenę i stan jak w Rumunii, a oferty z pliku dostają inne identyfikatory i nie korzystają z synchronizacji. Ustal, który mechanizm odpowiada za stany na każdej platformie, bo dwa mechanizmy naraz nadpisują sobie dane.
Osobną sytuacją jest Fulfilment by eMAG. Gdy towar leży w magazynie eMAG, stanem zarządza platforma. Według pomocy Base przy fulfilmencie część aktualizacji, np. stanu i czasu obsługi, jest pomijana. W ERP warto więc prowadzić taki zapas jako osobny magazyn, żeby nie sprzedawać go w innych kanałach.
Integrator czy bezpośrednie połączenie ERP z API eMAG
Część producentów ERP i firm wdrożeniowych oferuje własne konektory do marketplace'ów, a duże firmy rozważają napisanie połączenia z API eMAG. Według strony integracji Base wśród systemów księgowych, które można połączyć z eMAG przez Base, są m.in. Subiekt, Optima, wFirma, inFakt, Fakturownia i iFirma (stan na czerwiec 2026 - sprawdź aktualną listę). Sklepy na Shoperze łączą się z eMAG przez aplikację Manager eMAG - Apilo. Kiedy który model ma sens, pokazuje porównanie:
[#chart:emg40c]
Ten sam dylemat znają firmy sprzedające w Niemczech - opisaliśmy go we wpisie automatyzacja zamówień z OTTO - magazyn, ERP i kurier. Logika jest podobna, ale przy eMAG dochodzą trzy rynki, trzy waluty i usługi logistyczne platformy.
Co sprawdzić przed wyborem narzędzia
Czy narzędzie obsługuje eMAG.ro, eMAG.hu i eMAG.bg oraz zamówienia z magazynu eMAG.
Jak często przekazuje stany i ceny w obie strony, także na odcinku do ERP.
Czy przenosi do ERP walutę zamówienia i oznaczenie rynku.
Czy przekazuje do eMAG faktury i numery przesyłek oraz w jakim momencie.
Jak obsługuje zwroty i korekty dokumentów.
Kto utrzymuje połączenie po zmianach w API eMAG i jak szybko reaguje.
Waluty, VAT i dokumenty w ERP
Zamówienia z eMAG przychodzą w lejach, forintach i euro, bo Bułgaria przyjęła euro 1 stycznia 2026 roku. ERP musi zapisać zamówienie w walucie, w jakiej zapłacił klient, a dokument sprzedaży wystawić zgodnie z zasadami VAT, które obowiązują Twoją firmę. Według pomocy Base do eMAG przesyłana jest cena netto ze stawką VAT, a cenę brutto wylicza eMAG, więc stawki w ERP i w integratorze muszą być spójne. Przy sprzedaży wysyłkowej do konsumentów w innych krajach UE w grę wchodzi procedura OSS. Sposób księgowania, kurs przeliczenia i stawki VAT ustal z księgowym lub doradcą podatkowym - tu opisujemy je tylko ogólnie.
[#checklista] Przed wdrożeniem integracji eMAG z ERP ustal: listę produktów na każdy rynek, system będący źródłem stanów i cen, mapowanie statusów eMAG na dokumenty w ERP, sposób oznaczania rynku i waluty zamówienia, moment wystawienia faktury i przekazania jej do eMAG, sposób generowania listów przewozowych, obsługę zwrotów i korekt, osobny magazyn dla zapasu w Fulfilment by eMAG oraz osobę, która monitoruje połączenie.
Najczęstsze błędy przy łączeniu eMAG z ERP
Większość problemów, które widzimy po wdrożeniach, powtarza się niezależnie od programu magazynowego. Rzadko chodzi o awarię - zwykle o decyzję, której nikt nie podjął przed startem:
Dwa źródła stanu - stan zmieniany ręcznie w panelu eMAG i jednocześnie wysyłany z ERP, przez co po kilku godzinach nikt nie wie, który jest prawdziwy.
Zamówienia bez oznaczenia rynku - w ERP nie da się odróżnić zamówienia z eMAG.hu od zamówienia z eMAG.ro, więc raporty i rozliczenia trzeba poprawiać ręcznie.
Waluta zamieniona na złote przy imporcie - kwoty w dokumencie nie zgadzają się z kwotą zapłaconą przez klienta i z rozliczeniem z eMAG.
Faktura wystawiona, ale niewysłana do eMAG - dokument istnieje w ERP, a zamówienie na platformie nie ma załącznika.
Zwrot przyjęty w magazynie bez korekty - towar wraca na stan, ale sprzedaż w ewidencji zostaje bez zmian.
Każdy z tych błędów da się wychwycić w pierwszym tygodniu, jeśli codziennie porównasz kilka zamówień w panelu eMAG z ich odpowiednikami w ERP: status, kwotę, walutę, dokument i numer przesyłki. Po kilku dniach bez rozbieżności kontrolę można ograniczyć do wyrywkowej.
Podobnie warto podejść do magazynu w Polsce przy innych zagranicznych platformach - zasady synchronizacji stanów i terminów dla rynku niemieckiego opisujemy we wpisie magazyn w Polsce a zamówienia z Kaufland.de.
Jak Vinson pomaga w integracji eMAG z ERP
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 połączyć eMAG z ich systemem magazynowym.
Analiza obecnego ERP i wybór modelu: integrator czy własne połączenie z API.
Opis przepływu danych, mapowanie statusów i dokumentów.
Konfiguracja integracji eMAG w Base dla trzech rynków.
Bieżąca obsługa sprzedaży i kontrola zgodności stanów.
Najczęściej zadawane pytania
Czy eMAG można połączyć z Subiektem lub Optimą?
Tak, najczęściej przez integrator. Według strony integracji Base przez Base można połączyć eMAG m.in. z Subiektem i Optimą, a także z programami fakturowymi, takimi jak wFirma, inFakt, Fakturownia czy iFirma. Zakres funkcji każdego połączenia sprawdź w dokumentacji integratora.
Czy integracja eMAG z ERP obsłuży Rumunię, Węgry i Bułgarię?
Tak, ale każdy rynek to osobne połączenie z eMAG. Według pomocy Base jedna integracja pobiera zamówienia z jednego rynku, więc dla eMAG.ro, eMAG.hu i eMAG.bg dodajesz trzy integracje, a zamówienia z magazynu eMAG wymagają kolejnych.
Który system powinien być źródłem stanów przy sprzedaży na eMAG?
Ten, w którym prowadzisz magazyn dla wszystkich kanałów sprzedaży, zwykle ERP. Integrator powinien tylko przekazywać stan do eMAG, a zmiany ręczne w panelu eMAG warto ograniczyć do sytuacji awaryjnych.
Czy warto połączyć ERP bezpośrednio z API eMAG?
Bezpośrednie połączenie ma sens przy dużej skali, nietypowych procesach albo rozbudowanym ERP, którego integrator nie obsłuży. Wymaga jednak programisty, monitoringu i aktualizacji po zmianach w dokumentacji API, której wersja v4.5.1 obowiązuje od 2 marca 2026 roku.
Jak ERP ma obsłużyć zamówienia z Fulfilment by eMAG?
Najlepiej jako osobne źródło zamówień i osobny magazyn, bo towarem w magazynie eMAG zarządza platforma. Według pomocy Base zamówienia z fulfilmentu obsługuje się w osobnej integracji, a część aktualizacji, np. stanu i czasu obsługi, jest dla nich pomijana.
Chcesz, żeby zamówienia z eMAG trafiały do Twojego ERP bez przepisywania i pomyłek w stanach? Zobacz, jak prowadzimy sprzedaż na eMAG z Vinson - od planu integracji po codzienną obsługę zamówień w Rumunii, na Węgrzech i w Bułgarii.


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