Przejdź do treści

Integracja Empik Marketplace: wymagania i podłączenie

Zespół Fide-Soft ·

Empik Marketplace (w panelu i dokumentacji EmpikPlace) ma własny cykl zamówienia: zamówienie trzeba zaakceptować, zanim klient zostanie obciążony, a oferta musi wskazywać produkt z katalogu Empik. Dlatego integracja to więcej niż pobieranie zamówień. Opisujemy wymagania dla sprzedawcy, opłaty, zasady dla ofert i zamówień oraz to, co integrator wymienia z Empik przez API. Stan na 26.10.2026.

Kto może sprzedawać na Empik Marketplace

Strona Empik dla sprzedających wymienia cztery warunki: aktywną działalność gospodarczą, prowadzoną w państwie Unii Europejskiej, zarejestrowaną co najmniej miesiąc i z wysyłką z państwa Unii. Kod GTIN (EAN) jest obowiązkowym atrybutem produktu na platformie. Konto i wystawianie produktów nie mają osobnej opłaty.

Klienci Empik odbierają paczki w automatach paczkowych, w punktach DPD Pickup, od kuriera i w salonach Empik, których jest prawie 400. Dla ofert z dostawą w ramach Empik Premium potrzebna jest co najmniej jedna z metod: Paczkomat InPost, Poczta Polska, Żabka, DPD Pickup albo salony Empik.

Koszty: plany, prowizja i opłata platformowa

PozycjaIle wynosiUwagi
Plan Standard0 złbez opłaty za konto i wystawianie produktów
Plan PLUS99 zł netto za 30 dnidodatkowe narzędzia sprzedaży, Empik podaje 30 dni dostępu bez opłaty
Plan MAX499 zł netto za 30 dnim.in. regularny audyt technologiczny i wsparcie przy Empik Ads
Prowizja od sprzedażywedług siatki prowizji dla kategoriiliczona od całkowitej kwoty brutto (towar i wysyłka), powiększana o VAT
Opłata platformowa0,45% wartości brutto zamówieniapojawia się po zaakceptowaniu zamówienia, rozliczana raz w miesiącu

Empik ogłasza dla nowych sprzedawców 0% prowizji nawet do 3 miesięcy od dołączenia, na zasadach z osobnego regulaminu. Prowizje i reklamy Empik fakturuje zbiorczo po zakończeniu miesiąca. Wypłaty środków standardowo są dwa razy w miesiącu: 15. dnia i ostatniego dnia miesiąca.

Stawki prowizji dla konkretnych kategorii są w siatce prowizji w Centrum Pomocy EmpikPlace. Sprawdź je dla swoich kategorii, zanim policzysz cenę, bo prowizja liczy się od kwoty z wysyłką.

Oferty: EAN i katalog Empik

Oferta w Empik wskazuje produkt przez parametry product-id i product-id-type. Typ może być jednym z trzech:

  • EAN: produkt musi już istnieć w katalogu EmpikPlace,
  • SHOP_SKU: numer katalogowy produktu w Twoim sklepie,
  • SKU: wewnętrzny indeks produktu w Empik.

Gdy import ofert po EAN zwraca błąd „The product does not exist”, produktu nie ma w katalogu. Dodajesz go wtedy plikiem produktowym albo kontaktujesz się z pomocą Empik. Każda oferta ma też własne sku, czyli numer oferty widoczny w panelu jako SKU oferty, i ten numer musi być unikalny w pliku. Do zmiany samego stanu wystarczą sku, product-id, product-id-type i liczba sztuk, a nowy produkt oznaczasz stanem 11.

Dla integratora najważniejsze jest to, żeby SKU oferty w Empik i SKU produktu w integratorze były takie same. Wtedy stan i cena trafiają do właściwej oferty bez ręcznego łączenia.

Zamówienia: akceptacja w 5 dni i statusy

StatusCo oznaczaCo robi sprzedawca albo integrator
WAITING_ACCEPTANCEzamówienie opłacane z góry czeka na akceptacjęakceptuje albo odrzuca w ciągu 5 dni
WAITING_DEBIT_PAYMENTEmpik sprawdza płatnośćczeka; bez płatności w ciągu 7 dni zamówienie anuluje się, a stan wraca do oferty
SHIPPINGzamówienie opłacone, gotowe do realizacjipakuje i nadaje paczkę
SHIPPEDwysłanedodaje numer listu przewozowego
RECEIVEDdostarczonenic, status zmienia się po potwierdzeniu odbioru przez klienta, na podstawie danych przewoźnika albo po 10 dniach od wysłania
CLOSEDzamknięte po 60 dniach od otrzymanianic, klient nie zgłosi już zwrotu ani incydentu

W czasie oczekiwania na akceptację klient może anulować zamówienie ze swojego panelu. Zamówienia za pobraniem pomijają etap sprawdzania płatności.

Co synchronizuje integrator z Empik

API Empik dzieli się na oferty, produkty i zamówienia. Metody zamówień mają kody:

KodMetodaDo czego służy
OR11GETpobieranie listy zamówień i ich statusów
OR21PUTakceptacja albo odrzucenie zamówienia
OR23PUTnumer listu przewozowego w zamówieniu
OR24PUTpotwierdzenie wysyłki
OR28PUTzwrot pieniędzy za zamówienie

Stany i ceny integrator wysyła importem ofert, a dokumentacja zaleca do tworzenia ofert metodę OF01. W API są też metody do kategorii i atrybutów produktów, wiadomości od klientów i dokumentów zamówienia.

Jak podłączyć Empik do integratora

  1. Zarejestruj konto sprzedawcy i uzupełnij dane firmy.
  2. Ustaw metody dostawy, w tym te, których wymaga Empik Premium, jeśli chcesz z niego korzystać.
  3. W panelu EmpikPlace kliknij swoją nazwę użytkownika w prawym górnym rogu, otwórz zakładkę Klucz API i kliknij „Wygeneruj nowy klucz”.
  4. Wklej klucz w panelu integratora. Klucz trafia do nagłówka Authorization każdego zapytania.
  5. Powiąż oferty z produktami po SKU i sprawdź na kilku ofertach, czy stan i cena zmieniają się po stronie Empik.
  6. Złóż zamówienie testowe i przejdź całą ścieżkę: akceptacja, wysyłka z numerem, potwierdzenie.

Empik ma środowisko produkcyjne marketplace.empik.com i testowe stg1.marketplace.empik.com, więc integrację da się sprawdzić bez prawdziwych zamówień. Na stronie dla sprzedających Empik wymienia też gotowe integracje z kilkunastoma platformami sklepowymi i integratorami.

Empik w Commerce OS Integrator

Empik jest w tabeli funkcji Commerce OS Integrator razem z Erli, Kaufland, Amazon i eBay. Na wdrożeniu podłączamy Twoje konto sprzedawcy i klucz API i testujemy połączenie na Twoim koncie. Zamówienia z Empik trafiają na wspólną listę z zamówieniami z Allegro, sklepu i innych kanałów, z tymi samymi folderami statusów. Sprzedaż w jednym kanale zmniejsza stan, a nowy stan wraca do pozostałych kanałów. Numer przesyłki wraca do kanału, w którym klient kupił.

Termin 5 dni na akceptację łatwo przeoczyć, gdy zamówień z Empik jest mało. Ustaw folder albo regułę dla zamówień z Empik czekających na akceptację, żeby trafiały na listę spraw do zrobienia. Przykłady reguł z warunkiem kanału opisujemy w artykule Automatyzacje zamówień Allegro, a pracę z wieloma kanałami w artykule Jedna lista zamówień z Allegro, sklepu i Erli.

W planie Integrator Start podłączysz do 3 kanałów sprzedaży, w wyższych planach bez limitu. Ceny są w cenniku Integratora. Jeśli dziś obsługujesz Empik przez BaseLinkera, zakres przejścia opisujemy na stronie Migracja z BaseLinkera, a oszczędność policzysz w kalkulatorze zwrotu z migracji.

Na co uważać

  • Akceptacja zamówień. Po 5 dniach bez akceptacji zamówienie przepada, a w tym czasie klient może je anulować.
  • EAN spoza katalogu. Oferta po EAN nie powstanie, dopóki produktu nie ma w katalogu EmpikPlace.
  • Prowizja od wysyłki. Prowizja i opłata platformowa liczą się od kwoty z wysyłką, więc droga dostawa podnosi koszt sprzedaży.
  • Rezerwacja stanu. Do czasu płatności stan jest zarezerwowany przy zamówieniu, a po anulowaniu wraca do oferty.
  • Zamknięcie po 60 dniach. Do zamknięcia zamówienia klient może zgłosić zwrot albo incydent, więc dokumenty i historię zamówienia trzymaj co najmniej do tego czasu.

Najczęstsze pytania

Ile kosztuje sprzedaż na Empik Marketplace?
Plan Standard kosztuje 0 zł, PLUS 99 zł i MAX 499 zł netto za 30 dni. Do tego prowizja według siatki kategorii, liczona od kwoty brutto z wysyłką, i opłata platformowa 0,45% wartości brutto zamówienia.
Czy na Empik potrzebuję kodów EAN?
Tak, GTIN (EAN) jest obowiązkowym atrybutem produktu. Oferta po EAN wymaga, żeby produkt był już w katalogu EmpikPlace, a jeśli go nie ma, dodajesz go plikiem produktowym.
Ile mam czasu na akceptację zamówienia z Empik?
5 dni od złożenia zamówienia opłacanego z góry. W tym czasie klient może anulować zamówienie, a po akceptacji Empik czeka na płatność do 7 dni.
Gdzie wygenerować klucz API Empik?
W panelu EmpikPlace: kliknij nazwę użytkownika w prawym górnym rogu, otwórz zakładkę Klucz API i wybierz „Wygeneruj nowy klucz”. Klucz przesyła się w nagłówku Authorization.
Jak numer przesyłki trafia do Empik?
Integrator wysyła numer listu przewozowego metodą OR23 i potwierdza wysyłkę metodą OR24. Bez potwierdzenia zamówienie nie przechodzi do statusu wysłanego.
Czy Commerce OS Integrator obsługuje Empik Marketplace?
Tak. Empik jest w tabeli funkcji Integratora, a konto sprzedawcy i klucz API podłączamy na wdrożeniu. Zamówienia z Empik są na wspólnej liście, a stany i numery przesyłek wracają do Empik.

Źródła

  • Sprzedaż wielokanałowa

    Integracja Erli: jak podłączyć sklep i integrator

    26 października 2026

    Integracja Erli krok po kroku: kto może sprzedawać, prowizje i opłaty z regulaminu, wymagania dla ofert, co synchronizuje integrator przez API Erli i jak go podłączyć.

  • Sprzedaż wielokanałowa

    Integracja Kaufland.pl: wymagania i podłączenie

    26 października 2026

    Integracja Kaufland.pl: wymagania dla sprzedawcy, opłata podstawowa i prowizje, oferty po EAN, zamówienia w jednostkach, zwroty i podłączenie integratora do Seller API.

  • Sprzedaż wielokanałowa

    Jedna lista zamówień z Allegro, sklepu i Erli

    24 października 2026

    Jak zarządzać zamówieniami z wielu kanałów w jednym panelu: Allegro, sklep, Erli, Empik, Kaufland. Foldery statusów, wspólne stany, etykiety, faktury i zysk na kanale.

Wszystkie artykuły: Sprzedaż wielokanałowa