W skrócie
- Sposób połączenia zależy od systemu sklepu: WooCommerce łączy się jednym kliknięciem, Shoper, IdoSell, PrestaShop i Shopify kluczem API, a każdy inny system plikiem XML/CSV.
- Sklep powinien pozostać głównym źródłem danych: zmiany cen, stanów i opisów robisz w jednym miejscu, a marketplace je odczytuje.
- Dla klucza API stosuj zasadę najmniejszych uprawnień: osobny klucz na jedną integrację, przechowywany poza mailem i arkuszami.
- Po podłączeniu katalog warto przejrzeć w poczekalni: braki w kategoriach i parametrach uzupełnia się grupami, a nie pojedynczo.
- Integrację uznaj za skończoną dopiero po teście: porównaj liczbę produktów, ceny i stany, zmień wartość testowo i sprawdź, czy zamówienie widać w panelu sprzedawcy.
Co naprawdę dzieje się po drugiej stronie połączenia
Integracja sklepu z marketplace to ustalenie dwóch rzeczy: skąd platforma ma brać dane o Twoich produktach i w którą stronę mają płynąć informacje. Katalog (nazwy, opisy, zdjęcia, parametry), ceny i stany magazynowe idą ze sklepu do marketplace. Zamówienia wracają do Ciebie, żebyś mógł je zrealizować. Dobrze zaprojektowane połączenie zostawia sklep jako główne źródło danych, a platforma jedynie czyta katalog i nie przejmuje nad nim kontroli.
Dlatego sam wybór drogi technicznej jest mniej ważny niż porządek w danych źródłowych. Jeżeli w sklepie masz zdublowane produkty, brakujące EAN-y albo ceny wpisane w różnych formatach, każda integracja przeniesie ten bałagan na marketplace, tylko szybciej. O idei jednego katalogu dla wielu kanałów piszemy w osobnym poradniku, podobnie jak o synchronizacji stanów i o tym, co powinien zawierać plik produktowy. Tutaj skupiamy się na samym podłączeniu.
Zanim zaczniesz, zbierz kilka rzeczy. Oszczędzi Ci to przerw w połowie konfiguracji, kiedy okazuje się, że nie masz uprawnień administratora albo nie wiesz, kto zarządza hostingiem.
- Dostęp administratora do panelu sklepu (albo osoba, która może go na chwilę udzielić).
- Informację, na jakim systemie i w jakiej wersji działa sklep oraz jakie wtyczki modyfikują katalog.
- Zdecydowanie, które produkty mają trafić na marketplace: cały asortyment czy wybrane kategorie.
- Ceny brutto w sklepie, które chcesz sprzedawać także na platformie, albo decyzję o osobnej polityce cenowej.
- Porządek w identyfikatorach: unikalne SKU, a przy produktach markowych kody EAN.
Droga pierwsza: połączenie jednym kliknięciem (WooCommerce)
Najkrótsza ścieżka jest dla sklepów na WooCommerce. W przypadku allee Connect to właśnie połączenie jednym kliknięciem: nie generujesz kluczy, nie przygotowujesz pliku i nie prosisz programisty o adres do eksportu. Autoryzujesz połączenie, a katalog trafia do poczekalni, o której piszemy dalej.
Jedno kliknięcie nie oznacza jednak, że można pominąć myślenie. Zanim je wykonasz, zaloguj się na konto administratora i upewnij się, że sklep jest w aktualnej wersji razem z wtyczkami odpowiadającymi za produkty, warianty i ceny. Przy takim połączeniu zwykle zatwierdzasz zgodę na dostęp do danych sklepu. Przeczytaj, jakiego dostępu dotyczy, i zapisz, kto i kiedy ją wyraził.
Po połączeniu nie zaczynaj od publikowania wszystkiego. Najpierw przejrzyj, co faktycznie przyszło ze sklepu, bo to, co wygląda poprawnie w witrynie, nie zawsze jest kompletne po stronie danych. Pola niewidoczne dla klienta, jak brakujący EAN czy pusta marka, wychodzą dopiero przy dopasowywaniu kategorii.
Droga druga: klucz API (Shoper, IdoSell, PrestaShop, Shopify)
Klucz API to rodzaj hasła, którym jedna aplikacja ma dostęp do danych drugiej, bez logowania się na Twoje konto administratora. W przypadku allee Connect dla systemów Shoper, IdoSell, PrestaShop i Shopify wystarczy taki klucz wygenerowany w panelu sklepu i wklejony w panelu integracji. Nazwy menu różnią się między systemami (integracje, aplikacje, webserwis, dostęp do API), więc jeśli nie widzisz właściwej opcji, zajrzyj do dokumentacji swojego systemu.
Najczęstszy błąd to dawanie kluczowi więcej uprawnień, niż trzeba, tylko po to, żeby od razu zadziałało. Poświęć dwie minuty na to, żeby tego uniknąć. Kolejność działań wygląda tak:
Jeśli po wklejeniu klucza nic się nie dzieje, najczęstsze przyczyny są banalne: klucz skopiowany ze spacją na końcu, wygasły albo odwołany klucz, zablokowany dostęp po stronie hostingu lub zbyt wąskie uprawnienia. Zacznij od wygenerowania nowego klucza zamiast poprawiania starego. Tak łatwiej też wiesz, który jest aktualny.
- Zaloguj się do panelu sklepu na konto administratora, najlepiej z włączonym dodatkowym uwierzytelnianiem.
- Znajdź w ustawieniach miejsce, w którym tworzy się dostęp do API lub integracje zewnętrzne.
- Utwórz osobny klucz tylko dla tego marketplace i nazwij go tak, żeby za rok było wiadomo, do czego służy.
- Nadaj uprawnienia potrzebne do odczytu katalogu, cen i stanów oraz tylko te, o które prosi integracja. Wątpliwości rozstrzygnij w opisie integracji.
- Skopiuj klucz od razu, bo w wielu systemach widać go tylko raz, i wklej w panelu integracji.
- Zapisz w swoim rejestrze, kiedy klucz utworzono i kto za niego odpowiada.
- Sprawdź, czy katalog pojawił się w poczekalni i czy liczba produktów zgadza się ze sklepem.
Droga trzecia: plik produktowy XML lub CSV
Jeśli Twój sklep działa na innym systemie, na przykład Magento, Sky-Shop, AtomStore, RedCart, OpenCart czy Comarch e-Sklep, wybierasz plik produktowy XML lub CSV. To ten sam rodzaj pliku, który zwykle przygotowuje się dla Ceneo czy Google. Jeżeli już go masz, połowa pracy jest za Tobą. Informacje o integracji dla sklepów znajdziesz na allee.pl/dla-sklepow.
Tu najwięcej zależy od jakości i regularności pliku. Plik powinien być dostępny pod stałym adresem, który się nie zmienia po każdej aktualizacji sklepu, i odświeżać się automatycznie, a nie wtedy, gdy ktoś o tym pamięta. Identyfikatory produktów muszą być stabilne: jeśli SKU zmienia się przy każdym eksporcie, platforma uzna to za nowy produkt. Pilnuj też spójnego kodowania znaków (polskie litery) i jednolitego zapisu cen.
Plik ma jedną słabość w porównaniu z połączeniem na żywo: jest tak aktualny, jak ostatni eksport. Gdy sprzedajesz sztuki z małym zapasem, ustaw częste odświeżanie i sprawdź, jak często marketplace pobiera plik. Szczegóły, czyli które pola są obowiązkowe i jak je nazywać, opisaliśmy w osobnym poradniku o pliku produktowym.
Którą drogę wybrać, gdy masz wybór
Zwykle wybór narzuca system: WooCommerce to jedno kliknięcie, cztery wymienione systemy to klucz API, reszta to plik. Zdarza się jednak, że sklep na Shoperze ma też gotowy eksport XML dla porównywarki cen i ktoś proponuje użyć właśnie jego. Kieruj się tym, co łatwiej utrzymać w czasie. Rozwiązanie, które działa bez Twojej ingerencji i nie zależy od cudzej pamięci, jest lepsze od tego, które jest szybsze tylko w dniu uruchomienia.
Jedna zasada bez wyjątków: jeden katalog podłączasz jednym kanałem. Jeśli ten sam sklep wprowadzisz na marketplace raz kluczem API, a drugi raz plikiem, dostaniesz dublujące się oferty, rozbieżne ceny i kłopot z ustaleniem, która wersja jest prawdziwa. Gdy zmieniasz metodę, najpierw odłącz poprzednią, a dopiero potem aktywuj nową.
- WooCommerce: połączenie jednym kliknięciem.
- Shoper, IdoSell, PrestaShop, Shopify: klucz API z panelu sklepu.
- Magento, Sky-Shop, AtomStore, RedCart, OpenCart, Comarch e-Sklep i inne: plik XML/CSV.
- Własny system lub rozwiązanie szyte na miarę: plik produktowy, jeśli potrafi go generować.
Poczekalnia: dopasowanie kategorii i uzupełnianie braków
Po podłączeniu katalog nie trafia od razu do sprzedaży. W allee Connect ląduje najpierw w poczekalni, gdzie platforma dopasowuje kategorie i parametry produktów, a następnie pokazuje braki. Dzięki temu widzisz, które oferty są gotowe, a które wymagają uzupełnienia, zanim zobaczy je klient.
Braki uzupełniasz grupami, nie pojedynczo. Załóżmy przykładowo, że w katalogu masz 1200 produktów, a w 300 z nich brakuje parametru „materiał”. Jeśli są to głównie torby i plecaki z kilku kolekcji, wypełniasz pole raz dla całej grupy zamiast otwierać trzysta kart produktów. Zaczynaj od najliczniejszych grup braków, bo każda rozwiązana grupa skraca listę najbardziej.
Z naszych porad możesz tu skorzystać dwukrotnie: o tym, dlaczego kompletne parametry i dobra kategoria podnoszą sprzedaż, piszemy w osobnym poradniku. Jeśli większość braków wynika z danych źródłowych, popraw je w sklepie, a nie tylko na platformie. W przeciwnym razie przy następnej synchronizacji problem wróci.
Bezpieczeństwo dostępu: jak nie oddać więcej, niż trzeba
Integracja daje zewnętrznej usłudze wgląd w dane Twojego sklepu, więc warto potraktować ją jak zatrudnienie nowej osoby: zakres obowiązków ma być jasny, a dostęp ograniczony do tego, co potrzebne. W integracji opartej na odczycie katalogu, jak allee Connect, sklep zostaje po Twojej stronie. Mimo to klucz, który dziś otwiera katalog, jutro może otworzyć coś więcej, jeśli ktoś nadał mu szerokie uprawnienia.
Zadbaj też o to, co dzieje się wokół klucza. Klucze, które przez lata krążą w mailach, komunikatorach i wspólnych arkuszach, w końcu trafiają w niewłaściwe ręce, zwłaszcza po zmianie agencji czy pracownika. Dobrą praktyką jest rejestr dostępów: kto, do czego, od kiedy.
Zamówienia zawierają dane osobowe klientów, więc ich ochrona to obowiązek wynikający z RODO. Dostęp do panelu sprzedawcy dawaj tylko osobom, które realizują zamówienia, i usuwaj konta osób, które odeszły. Adres pliku produktowego nie powinien zawierać żadnych danych klientów. Jeśli feed jest dostępny publicznie, sprawdź, czy nie zdradza informacji, których nie chcesz pokazywać konkurencji, jak ceny zakupu czy dane dostawców.
- Osobny klucz API dla każdej integracji, z jasną nazwą i datą utworzenia.
- Najmniejszy możliwy zakres uprawnień; szersze dopiero wtedy, gdy integracja tego wymaga.
- Konto administratora zabezpieczone mocnym hasłem i dodatkowym uwierzytelnianiem.
- Klucz przesyłany tylko bezpiecznym kanałem, bez zapisywania w arkuszach i wiadomościach.
- Odwołanie lub wymiana klucza, gdy kończysz współpracę z agencją albo osobą, która go znała.
- Adres pliku produktowego z szyfrowaniem (https) i bez kolumn z cenami zakupu lub danymi wewnętrznymi.
- Regularny przegląd kont w panelu sprzedawcy, najlepiej raz na kwartał.
Co sprawdzić po podłączeniu: lista kontrolna na pierwszy dzień
Połączenie, które „działa”, to jeszcze nie połączenie, które działa dobrze. Poświęć godzinę na testy w dniu uruchomienia, bo błąd wykryty teraz kosztuje Cię kilka kliknięć, a wykryty po pierwszym zamówieniu to zwykle zwrot pieniędzy i nieprzyjemna rozmowa z klientem.
Zacznij od liczb. Porównaj liczbę produktów w sklepie z liczbą w poczekalni i na marketplace. Różnica oznacza, że część produktów została odfiltrowana (brak zdjęcia, brak ceny, nieprawidłowa kategoria) albo się zdublowała. Potem weź kilkanaście losowych ofert z różnych kategorii i sprawdź je od początku do końca, tak jak zrobiłby to klient. Na koniec przetestuj synchronizację: zmień cenę i stan jednego produktu i obserwuj, ile czasu zajmuje pojawienie się zmiany po drugiej stronie.
Osobno sprawdź zamówienia. Jeśli to możliwe, złóż próbne zamówienie na tani produkt i zobacz, czy trafia do panelu sprzedawcy, czy dane do wysyłki są kompletne i czy potrafisz je przenieść do swojego procesu realizacji. O automatyzacji statusów i etykiet piszemy w osobnym poradniku, a o tym, jak policzyć opłacalność przy prowizji platformy, w poradniku o kalkulacji marży.
- Czy liczba produktów w sklepie i na marketplace się zgadza, a różnice masz wyjaśnione.
- Czy ceny brutto w ofertach są takie, jak zaplanowałeś, łącznie z ewentualnym narzutem na prowizję.
- Czy stany zgadzają się ze sklepem, a produkt ze stanem zero jest niedostępny do zakupu.
- Czy warianty (rozmiar, kolor) trafiły do jednej oferty zamiast kilku osobnych.
- Czy zdjęcia, opisy i parametry wyglądają poprawnie, bez uciętych polskich znaków i znaczników technicznych.
- Czy koszty i czas dostawy odpowiadają Twoim rzeczywistym warunkom.
- Czy zmiana ceny i stanu w sklepie przenosi się na platformę w rozsądnym czasie.
- Czy próbne zamówienie widać w panelu sprzedawcy i da się je zrealizować bez ręcznego przepisywania.
Typowe błędy i rutyna na kolejne tygodnie
Sprzedawcy najczęściej potykają się o te same rzeczy. Pierwsza to podłączenie tego samego katalogu dwoma drogami naraz. Druga to zmiana struktury kategorii w sklepie bez sprawdzenia, jak wpłynie na dopasowanie na platformie. Trzecia to aktualizacja systemu lub wtyczek bez testu integracji, po której klucz przestaje działać albo plik produktowy zmienia format. Czwarta, najbardziej kosztowna, to zignorowanie komunikatu o brakach, bo „przecież wszystko się synchronizuje”.
Zbuduj z tego prostą rutynę. Raz w tygodniu przejrzyj listę braków i błędów w panelu, a po każdej większej zmianie w sklepie (nowa wtyczka, migracja, zmiana motywu, import cennika) powtórz skrócony test: kilka produktów, cena, stan. Raz na kwartał sprawdź, kto ma dostęp do kluczy i kont. To zajmuje kwadrans, a chroni przed sytuacją, w której sprzedajesz towar, którego nie masz, albo po cenie sprzed miesiąca.
Gdy integracja działa stabilnie, możesz skupić się na tym, co daje wynik: jakości ofert, czasie wysyłki i obsłudze klienta. Dobre połączenie techniczne jest warunkiem koniecznym, ale to właśnie te elementy decydują o tym, czy klient wróci.
Najczęstsze pytania
Czy do podłączenia sklepu do marketplace potrzebny jest programista?
Przy połączeniu jednym kliknięciem (WooCommerce) i kluczu API (Shoper, IdoSell, PrestaShop, Shopify) zwykle wystarczy osoba z dostępem administratora do sklepu. Plik produktowy XML/CSV bywa łatwy, jeśli system ma gotowy eksport dla porównywarek. Pomoc programisty przydaje się przy własnych rozwiązaniach albo niestandardowych polach produktowych.
Gdzie w sklepie znaleźć klucz API?
Klucz tworzy się w panelu administracyjnym, zwykle w ustawieniach integracji, aplikacji lub dostępu do API. Nazwy menu różnią się między Shoperem, IdoSell, PrestaShop i Shopify, więc sprawdź dokumentację swojego systemu. Wygeneruj osobny klucz dla marketplace i skopiuj go od razu, bo w wielu systemach widać go tylko raz.
Mój sklep nie ma gotowej integracji z marketplace. Co mogę zrobić?
Użyj pliku produktowego XML lub CSV, takiego jak dla Ceneo czy Google. Taką drogą łączy się m.in. Magento, Sky-Shop, AtomStore, RedCart, OpenCart i Comarch e-Sklep. Plik musi mieć stały adres, stabilne identyfikatory produktów i regularne odświeżanie.
Jak często powinien odświeżać się plik produktowy?
Zależy od tego, jak szybko zmieniają się u Ciebie ceny i stany. Przy małych zapasach i dużej rotacji odświeżaj plik częściej, bo każda zwłoka to ryzyko sprzedaży towaru, którego już nie masz. Sprawdź też, jak często marketplace pobiera plik, bo to ogranicza sens zbyt częstego eksportu.
Czy podłączenie sklepu jest bezpieczne?
Jest, jeśli stosujesz zasadę najmniejszych uprawnień. Utwórz osobny klucz dla jednej integracji, nadaj tylko niezbędne uprawnienia, nie wysyłaj go mailem i wymień, gdy ktoś z dostępem odchodzi. Zadbaj też o zabezpieczone konto administratora z dodatkowym uwierzytelnianiem.
Co zrobić, gdy po podłączeniu ceny lub stany różnią się od tych w sklepie?
Najpierw sprawdź, czy źródłem nie jest sam sklep: cache, wtyczka zmieniająca ceny albo opóźniony eksport pliku. Potem upewnij się, że ten sam katalog nie jest podłączony dwiema drogami. Jeśli rozbieżność dotyczy wszystkich produktów, wygeneruj nowy klucz lub sprawdź adres pliku.