Podłączone marketplace'y i czego każdy nie potrafi

W systemie jest ponad dwadzieścia konektorów marketplace: Allegro, Kaufland, Zalando, Empik, eBay, Erli, eMAG, Otto, Modivo, Pigu, Trendyol, Bol, Cdiscount, AboutYou, Tradebyte, InPost, Temu, Ceneo, BRW, Home&you, Shoper, PrestaShop, WooCommerce, Shopify, Sellasist, IdoSell, Goshop, Turis, AliExpress oraz kanał ręczny.

Krok po kroku

Sprawdzić, które konektory masz podłączone

1. Menu Integracje → Integracje, zakładka Dostępne integracje.
2. Filtr Typ ustaw na Marketplace. Zostaje sam katalog konektorów marketplace, pogrupowany po typie; nad grupą jest liczba pozycji.
3. Przejdź na zakładkę Moje integracje — to twoje połączenia, a nie katalog typów. Ten sam filtr Typ → Marketplace zawęża je tak samo. Kafelek pokazuje twoją nazwę połączenia, a pod nią mniejszym drukiem nazwę integracji.
4. Kanał, którego nie ma na liście „Moje integracje", nie jest podłączony — niezależnie od tego, czy widnieje w katalogu.

Sprawdzić, zanim obiecasz klientowi funkcję

1. Znajdź kanał w tabeli różnic niżej. Tabela jest o tym, czego dany konektor nie robi.
2. Jeśli kanał jest w wierszu „brak", nie szukaj przełącznika na ekranie połączenia — nie ma go. Funkcja nie jest wyłączona; nie została zaimplementowana albo marketplace jej nie udostępnia.
3. Akcja wywołana mimo to nie zepsuje danych — kończy się informacją o braku obsługi i nic nie zostaje wysłane.
4. Zanim zgłosisz to jako usterkę, sprawdź jeszcze grupę dopasowania (sekcja „Dwa sposoby dopasowania oferty do produktu"). Bardzo częsty przypadek to nie brak funkcji, tylko produkt bez powiązanej oferty na kanale z pierwszej grupy.

Co potrafią wszystkie

Pobieranie zamówień i wysyłanie stanów magazynowych obsługują praktycznie wszystkie. To wspólna podstawa.

Gdzie zaczynają się różnice

Brak funkcji nie oznacza usterki — oznacza, że dany marketplace jej nie udostępnia albo nie została zaimplementowana. Przycisk w takim przypadku zwróci informację o braku obsługi.

Ceneo jest wyjątkiem wartym podkreślenia

Ceneo nie ma listy „moich ofert”. Pobieranie ofert pyta więc Ceneo o nasze własne produkty — po SKU (albo EAN, gdy SKU brak), po 300 naraz — i zapisuje te, które Ceneo zna. Produkt, którego na Ceneo nie ma, po prostu nie pojawia się na liście.

Ceneo odpowiada całą stroną produktu, razem z ofertami konkurencji. Swoją ofertę system rozpoznaje po ustawieniu Nazwa sklepu na Ceneo (np. mojsklep.pl). Bez niego oferty się pobiorą, ale bez ceny i stanu — cudza cena nigdy nie jest zapisywana jako nasza. Ustawienie pojawia się samo w ustawieniach połączenia Ceneo, w sekcji synchronizacji. Oferta ze statusem nieaktywnym (stan 0) to produkt, którego naszej oferty Ceneo akurat nie wyświetla (zwykle brak stanu), albo oferta, której Ceneo już w ogóle nie zwraca.

Odczyt to metoda analizy cen Ceneo — jeśli pakiet sklepu jej nie obejmuje, pobieranie skończy się błędem API Ceneo (w logu zadania). Gdy dwa nasze produkty są przypięte do tej samej strony produktu na Ceneo, ich cena i stan nie są zapisywane — z odpowiedzi Ceneo nie da się ustalić, która oferta jest która. Stany i tak wysyła się po SKU/EAN, lustro ofert nie jest do tego potrzebne.

Turis — hurtownia B2B, integracja w obie strony

Turis to platforma zamówień hurtowych: kupującym jest pracownik sklepu-detalisty, zamówienie należy do jego firmy, ceny są hurtowe, a płatność zwykle z terminem. Integracja:

• pobiera zamówienia zmienione od ostatniego pobrania;
• wysyła zmianę statusu — statusy są własne dla każdego sklepu Turis, więc najpierw zmapuj je na ekranie połączenia (lista wczytuje się po zapisaniu sekretu klienta API albo przyciskiem odświeżania statusów);
• wysyła link do śledzenia, nie numer przesyłki — Turis ma na to jedno pole na zamówienie. Link bierze się ze strony śledzenia kuriera; gdy kurier jej nie ma, z szablonu w ustawieniach połączenia. Bez żadnego z nich wysyłka kończy się błędem śledzenia, a nie cichym sukcesem.

• wysyła numer faktury do zamówienia (pole na numer, bez pliku PDF);
• pobiera lustro ofert — każdy produkt Turis (osobny rozmiar i kolor) to jedna oferta, łączona z naszym produktem po EAN, potem po SKU;
• tworzy nasze produkty z niepowiązanych ofert — gdy katalog prowadzisz w Turis, a u nas go jeszcze nie ma. Produkt z tym samym EAN albo SKU jest łączony, nigdy dublowany;
• wysyła stany po SKU Turis — wymaga pobranych ofert (włączone pobieranie i wysyłanie ofert) i mapowania magazynu ze zaznaczoną synchronizacją stanów;
• wysyła ceny hurtowe netto — podepnij grupę cen netto i wybierz w ustawieniach połączenia „Walutę ceny hurtowej". Cen promocyjnych Turis nie ma, więc ich nie wysyłamy;
• wystawia produkty z PIM — kategoria z mapowania kategorii albo z ustawienia „Domyślna kategoria Turis". Zakończenie oferty ukrywa produkt w Turis, nie kasuje go (SKU zostaje zajęte), a zdjęcia idą tylko przy pierwszym wystawieniu.

Zamówienie anulowane w Turis wchodzi jako nieaktywne tylko wtedy, gdy jego status jest wskazany w ustawieniu „Statusy Turis oznaczające anulowanie".

WooCommerce — własny sklep na WordPressie

Połączenie przez REST API sklepu: adres sklepu (tylko https) i para kluczy z WooCommerce (Ustawienia → Zaawansowane → REST API) z uprawnieniem Odczyt/Zapis. Klucz tylko do odczytu pobierze zamówienia, ale test połączenia ostrzeże, że nic nie wyśle. Integracja:

• pobiera zamówienia zmienione od ostatniego pobrania (wymaga WooCommerce 5.8 lub nowszego);
• wysyła zmianę statusu — statusy to te ze sklepu, razem z dodanymi przez wtyczki; lista wczytuje się po zapisaniu klucza tajnego;
• wysyła numer przesyłki jako notatkę do zamówienia — WooCommerce nie ma pola na numer przesyłki. Domyślnie to notatka dla klienta, którą sklep wysyła mu e-mailem; treść ustawisz w połączeniu. Opcjonalnie numer trafia też do wskazanego pola zamówienia, jeśli czyta je motyw albo wtyczka;
• pobiera lustro ofert — produkt prosty to jedna oferta, produkt z wariantami to oferta na każdy wariant. EAN czyta z pola GTIN (WooCommerce 9.2+) albo z pola wtyczki wskazanego w ustawieniach;
• wysyła stany do pobranych ofert i włącza w nich zarządzanie stanem;
• wysyła cenę regularną — tylko w tej postaci (brutto albo netto), w jakiej sklep wprowadza ceny, i tylko w walucie sklepu. Ceny promocyjnej nie rusza.

NIP i paczkomat nie mają w WooCommerce własnych pól — zapisują je wtyczki. Integracja szuka ich pod popularnymi kluczami; gdy Twoja wtyczka używa innych, dopisz je w ustawieniach połączenia. Faktur, akceptacji zamówień ani zwrotów WooCommerce nie przyjmuje.

AliExpress — konto sprzedawcy

Połączenie przez aplikację w konsoli AliExpress Open Platform: w połączeniu wpisujesz App Key i App Secret, a potem kod autoryzacji — sprzedawca otwiera link autoryzacji (instrukcja w opisie pola), loguje się i wkleja kod z adresu, na który wrócił. Kod jest ważny 30 minut; po zapisaniu integracja sama pobiera tokeny i odnawia je przed wygaśnięciem. Co około 60 dni AliExpress wymaga ponownej autoryzacji — wtedy pobieranie kończy się błędem z prośbą o nowy kod. Integracja:

• pobiera zamówienia zmienione od ostatniego pobrania (pierwsze pobranie: 7 dni wstecz). Nowych nieopłaconych nie importuje — przychodzą, gdy kupujący zapłaci. Nowych już wysłanych albo zakończonych na AliExpress też nie zakłada, żeby nie trafiły do kompletacji;
• stawka VAT pozycji: AliExpress jej nie podaje. Bierzemy stawkę kraju kupującego z ustawienia „Stawka VAT wg kraju kupującego” (np. DE=19), a dla pozostałych krajów stawkę domyślną (23);
• anuluje w WMS zamówienie zamknięte na AliExpress — AliExpress ma jeden status „zakończone” dla odebranych i zamkniętych; zamknięte bez odbioru przez kupującego trafiają do WMS jako „Zamknięte” i są anulowane;
• zmienia status na „wysłane” — to jedyny status, który AliExpress pozwala ustawić sprzedawcy: przypisz go w mapowaniu statusów, a zmiana w WMS zadeklaruje wysyłkę z numerem przesyłki. Pozostałe statusy (anulowanie, zamknięcie, akceptacja anulowania) AliExpress zmienia tylko w Seller Center — integracja zgłasza to w logu zamiast udawać sukces;
• wysyła numer przesyłki (deklaracja wysyłki) na dwa sposoby, do wyboru w ustawieniu „Sposób deklarowania wysyłki”: cross-border (usługa logistyczna AliExpress; bez przypisania kuriera numer idzie jako „inny przewoźnik” z linkiem do śledzenia) albo dostawa lokalna (DBS) — własny kurier w kraju kupującego, np. InPost czy DPD, dopasowany do przewoźnika AliExpress po nazwie albo przez listę KURIER=KOD. Przy dostawie lokalnej zamówienie z kilkoma paczkami dostaje jeden numer (pierwszej paczki);
• pobiera lustro ofert — oferta to SKU produktu. SKU bez kodu sprzedawcy jest widoczne, ale nie da się do niego wysłać stanu ani ceny. Kraje z własną ceną (te ustawione już na AliExpress i te wpisane w „Kraje z własną ceną na AliExpress”) dają dodatkową ofertę na kraj, np. 1005001:MUG-1@DE;
• wysyła stany, cenę bazową, cenę promocyjną (i jej usunięcie) oraz ceny per kraj — konfiguracja cen z krajem DE pisze cenę krajową DE. Odrzucane są: cena promocyjna nie niższa od ceny, cena krajowa poniżej 70% ceny bazowej (reguła AliExpress), inna waluta i inna postać (brutto/netto). Gdy jest kilka konfiguracji cen z krajami, w ustawieniu price_sync_countryless_offers wskaż kraj, którego cena jest ceną bazową;
• wystawia produkty z kreatora wystawiania: kategorie i ich atrybuty pobiera z AliExpress, produkt powstaje z jednym SKU i od razu jest włączany do sprzedaży. Przed pierwszym wystawieniem wybierz w ustawieniach połączenia szablon wysyłki (bez niego produktu nie da się wystawić) i język oferty — AliExpress nie przyjmuje tekstów po polsku, więc tytuł i opis idą z tłumaczenia produktu (domyślnie angielskiego). Jeśli AliExpress utworzy produkt, ale odmówi włączenia go do sprzedaży, oferta kończy się błędem z numerem produktu — włącz go w Seller Center zamiast wystawiać drugi raz. Warianty (kolory, rozmiary) wystawiają się na razie jako osobne produkty.

Paczkomaty: AliExpress nie przekazuje sprzedawcy punktu odbioru wybranego przez kupującego (API nie ma takiego pola), więc zamówienie przychodzi zawsze z adresem dostawy. Faktur ani akceptacji zamówień AliExpress nie przyjmuje przez API; zwrotów i sporów ta wersja jeszcze nie pobiera.

Shopify — sklep na platformie Shopify

Połączenie przez aplikację założoną w Shopify Dev Dashboard, w tej samej organizacji Shopify, do której należy sklep. W połączeniu wpisujesz adres nazwa.myshopify.com (własna domena sklepu nie przejdzie) oraz Client ID i Client secret aplikacji. Aplikacja musi mieć dostęp do chronionych danych klienta (imię, e-mail, telefon, adres) i musi być zainstalowana w sklepie. Uprawnienia read_orders i read_products są konieczne; do wysyłki numerów przesyłek, anulowania, stanów i cen potrzebne są kolejne — test połączenia wymieni, których brakuje i co bez nich nie zadziała. Sklepu z innej organizacji Shopify (aplikacja publiczna, instalacja przez OAuth) na razie podłączyć się nie da. Integracja:

• pobiera zamówienia zmienione od ostatniego pobrania — przy pierwszym połączeniu z ostatnich 7 dni (ustawienie, najwyżej 60). Zamówienia testowe pomija;
• nie pobierze zamówień bez danych klienta — jeśli aplikacja nie ma dostępu do chronionych danych klienta, pobieranie kończy się błędem, który to nazywa wprost, a test połączenia wymienia zablokowane pola. Zamówienia wracają same, gdy dostęp zostanie nadany;
• pobiera tylko to, co zostało do wysłania — pozycji albo sztuk zrealizowanych już w Shopify nie importuje. Druga linia adresu nigdy nie ginie: trafia do numeru („12/4”) albo do ulicy;
• pokazuje status wyliczony z płatności i realizacji — Shopify nie ma jednego statusu zamówienia. Katalog jest stały: anulowane, zwrócone, płatność unieważniona, zrealizowane, częściowo zrealizowane, wstrzymane, opłacone, autoryzowane, za pobraniem, oczekuje na płatność. Domyślnie nieaktywne są anulowane, zwrócone, z unieważnioną płatnością, oczekujące na płatność, wstrzymane (Shopify nie pozwala ich zrealizować) i zrealizowane w Shopify — żeby zamówienie wysłane już inną drogą nie wyszło drugi raz. Pominięte zamówienie przychodzi samo, gdy zmieni się w Shopify — np. po opłaceniu albo zdjęciu wstrzymania. Statusu do Shopify nie wysyła — nie ma go gdzie zapisać;
• rozpoznaje pobranie po nazwie metody płatności — domyślnie „Cash on Delivery (COD)”. Jeśli w Twoim sklepie ta metoda nazywa się inaczej (np. „Płatność przy odbiorze”), dopisz jej nazwę w połączeniu w „Metody płatności za pobraniem” — inaczej zamówienie za pobraniem wygląda jak czekające na płatność i nie przyjdzie;
• wysyła numery przesyłek jako realizację zamówienia — wszystkie paczki idą w jednej realizacji. InPost, DPD, DHL, GLS, UPS, FedEx i Packeta Shopify rozpoznaje i sam buduje link śledzenia; przy innych kurierach link idzie z szablonu kuriera w WMS. E-mail do klienta o wysyłce wychodzi tylko, gdy włączysz to w połączeniu. Paczki jednego zamówienia muszą iść jednym kurierem — paczek różnych kurierów naraz Shopify nie przyjmie w jednej realizacji, więc numery zostają niewysłane z błędem do wyjaśnienia. Tak samo przy zamówieniu anulowanym albo wstrzymanym w Shopify;
• anuluje zamówienie w Shopify — bez zwrotu pieniędzy i bez przywracania stanu w sklepie (to zostaje w rękach sklepu); powód z WMS trafia do notatki dla personelu;
• pobiera lustro ofert — każdy wariant produktu to osobna oferta;
• wysyła stany do jednej lokalizacji sklepu, wybranej w połączeniu („Lokalizacja stanów”). Bez wybranej lokalizacji stany nie wychodzą. Wariant, który w Shopify nie śledzi stanu albo nie jest magazynowany w tej lokalizacji, jest pomijany z komunikatem, co włączyć w Shopify;
• wysyła cenę wariantu — tylko w tej postaci (brutto albo netto), w jakiej sklep wprowadza ceny, i tylko w walucie sklepu. Ceny przekreślonej (promocji) nie rusza.

Produkty z Shopify założysz przyciskiem „Utwórz produkty z niepowiązanych ofert” na stronie ofert, po pobraniu lustra ofert: najpierw dopasowanie po EAN i SKU, bez dopasowania nowy produkt z nazwą, SKU, EAN, zdjęciami, marką, rozmiarem, kolorem i wagą. Opis nie jest pobierany.

Kwoty zamówień są w walucie, w której płacił klient. Pobranie rozpoznaje po nazwie metody płatności (lista w ustawieniach połączenia) i nigdy nie traktuje go jako opłacone z góry. NIP i paczkomat nie mają w Shopify własnych pól — integracja szuka ich w atrybutach zamówienia pod kluczami z ustawień połączenia. Faktur, akceptacji zamówień ani zwrotów Shopify nie przyjmuje.

Kanał ręczny

Pozycja Ręczny nie odpytuje niczego. Służy do wprowadzania zamówień spoza integracji, tak żeby przeszły normalną drogą magazynową. Nie szukaj przy nim ustawień synchronizacji.

Dwa sposoby dopasowania oferty do produktu

Konektory dzielą się na dwie grupy:

• Wymagające powiązanej oferty — stan poleci tylko dla produktu z dopasowaną, aktywną ofertą (Powiązanie oferty z produktem — bez niego nic nie jedzie). Tak działa większość, m.in. Allegro, Kaufland, eBay, Zalando, PrestaShop.
• Działające na kodach — wysyłają stan po EAN lub SKU, bez powiązanej oferty. Tak działa m.in. AboutYou (po SKU), Ceneo, Shoper, Temu, Tradebyte. AboutYou pobiera jednak listę ofert — bez niej nie da się zmieniać cen.

Ta różnica tłumaczy najczęstsze „u nas jedzie, a tam nie": w pierwszej grupie produkt bez powiązanej oferty jest po prostu pomijany.

Sellasist — zamówienia sklepu Sellingo zebrane w Sellasist

Sellasist zbiera zamówienia z wielu kanałów naraz: ze sklepu na Sellingo, ale też z Allegro czy Erli. Połączenie zakładasz z adresem panelu Sellasist (np. mojsklep.sellasist.pl — wystarczy wkleić; to nie adres sklepu) i kluczem API z Sellasist (Integracje → Klucze API). Po zapisaniu klucza wczytują się statusy zamówień z konta.

Integracja:

• importuje tylko zamówienia z zaznaczonych sklepów i kanałów — lista „Sklepy i kanały do importu” w zakładce Połączenie. Są na niej sklepy Sellingo, ale też konta marketplace i inne źródła zamówień zebrane w Sellasist (np. Allegro, Erli). Zaznacz tylko te, których nie masz podłączonych do WMS bezpośrednio: kanał podłączony i tu, i bezpośrednio (np. Allegro) wpadnie do WMS dwa razy. Przenosisz kanał z połączenia bezpośredniego do Sellasist? Po zaznaczeniu przyjdą też jego zamówienia z ostatnich dni (ustawienie „Ile dni wstecz sprawdzamy zmiany”), także te, które WMS już ma z połączenia bezpośredniego — na pierwsze pobranie ustaw tam 1 dzień albo zaznacz kanał, gdy stare zamówienia są już wysłane. Dopóki nic nie zaznaczysz, nic się nie importuje, a na liście problemów jest zgłoszenie;
• zapisuje numer zamówienia, który zna klient — przy zamówieniu z marketplace to numer z tego kanału (np. z Allegro). Zamówienie ze sklepu Sellingo przychodzi bez numeru sklepu, więc w jego miejscu jest numer zamówienia z Sellasist — po nim znajdziesz je w panelu Sellasist;
• odświeża zmiany statusu i płatności w zamówieniach z ostatnich dni (ustawienie „Ile dni wstecz sprawdzamy zmiany”, domyślnie 14). Starszych zamówień nie odświeża sama;
• anuluje zamówienie w WMS, gdy w Sellasist przejdzie do statusu zaznaczonego jako anulujący;
• wysyła do Sellasist zmianę statusu i numery przesyłek. Przekazanie statusu dalej do kanału, z którego przyszło zamówienie, jest domyślnie wyłączone;
• wysyła stany według symbolu produktu (SKU) albo EAN — do wyboru w ustawieniach.

Faktur Sellasist nie przyjmuje jako plików, więc integracja ich nie wysyła.

Uwaga dla wdrożeń

Rozpoznawanie konektora opiera się na jego symbolu. Zmiana symbolu w bazie albo ponowne zaseedowanie katalogu potrafi rozspójnić powiązania i zatrzymać zadania. To nie jest rzecz do zmieniania z panelu.