Integracja sklepu z hurtownią przez XML: BaseLinker, wtyczka czy Make
Jak podłączyć hurtownię do sklepu lub Allegro przez plik XML: co zawiera feed, BaseLinker, wtyczka czy Make, aktualizacja stanów i typowe błędy.
Zespół Dropcom.eu 6 min czytania
Sklep integrujesz z hurtownią, wklejając link do jej pliku XML w importerze platformy albo w integratorze, który potem regularnie pobiera plik i aktualizuje produkty, stany i ceny. Masz trzy drogi: integrator typu BaseLinker, wtyczkę lub importer wbudowany w platformę albo własny scenariusz w Make. Wybór zależy od liczby kanałów sprzedaży, wielkości katalogu i tego, ile chcesz konfigurować sam.
W skrócie
- Plik XML hurtowni to lista produktów z nazwami, opisami, zdjęciami, parametrami, stanami i cenami. W Polsce najpopularniejszy jest format CENEO.
- Integrator (BaseLinker, Apilo, SellAsist) to najlepsza droga, gdy sprzedajesz w kilku kanałach, np. w sklepie i na Allegro.
- Importer w platformie wystarczy, jeśli masz jeden sklep i nie sprzedajesz na marketplace’ach.
- Make ma sens dla nietypowych przypadków i małych katalogów. Przy tysiącach produktów koszt kredytów szybko rośnie.
- Najczęstszy problem to sprzedaż produktu, którego już nie ma. Rozwiązuje go częstsze pobieranie pliku i ukrywanie pozycji z zerowym stanem.
Co zawiera plik XML hurtowni i jak go czytać
Plik XML to zwykły tekst ze znacznikami, który otworzysz w przeglądarce. Każdy produkt ma swój blok z polami. Typowy feed zawiera:
- identyfikator i nazwę produktu, czasem kod producenta,
- kategorię w drzewie hurtowni,
- opis (często w HTML),
- atrybuty techniczne: EAN, wymiary, waga, kolor, materiał,
- linki do zdjęć,
- stan magazynowy i dostępność,
- cenę, w hurtowniach B2B zwykle indywidualną dla klienta.
Na przykładzie Dropcom.eu: plik generuje się automatycznie w formacie CENEO, osobno dla każdego klienta z jego cennikiem. Zawiera wszystkie produkty z panelu, także te bez stanu, a stan opisują pola stock (liczba sztuk) i avail (1 dostępny, 0 niedostępny). Link do pliku znajdziesz po aktywacji konta w panelu B2B, w zakładce „XML”. Szczegóły i trzy kroki sprawdzania pliku opisuje poradnik o pliku XML i integracjach.
Sprawdź też, na co pozwala hurtownia przy treściach z pliku. Dropcom.eu pozwala używać zdjęć i opisów z XML do sprzedaży kupionych u siebie produktów: w Twoim sklepie, na Twoich kontach marketplace i w Twoich materiałach. Nie wolno ich odsprzedawać ani przekazywać dalej. Inne hurtownie mogą mieć inne zasady, a ich naruszenie bywa powodem zgłoszeń na marketplace’ach.
Zanim podłączysz feed, sprawdź ręcznie trzy produkty: czy stan i dostępność zgadzają się z panelem hurtowni, czy EAN jest wypełniony i czy linki do zdjęć się otwierają. Pięć minut takiej kontroli oszczędza godziny szukania błędów po imporcie.
Trzy sposoby integracji: tabela porównawcza
| Kryterium | Integrator (np. BaseLinker) | Wtyczka lub importer platformy | Własny scenariusz w Make |
|---|---|---|---|
| Kanały sprzedaży | sklep, Allegro i inne marketplace’y naraz | tylko ten sklep | dowolne, ale każdy trzeba zbudować |
| Trudność | średnia, konfiguracja w panelu | niska do średniej | wysoka, wymaga znajomości API |
| Model kosztów | według liczby zamówień | abonament platformy lub płatna wtyczka | kredyty za każdą operację |
| Duży katalog (tysiące pozycji) | dobrze | zależy od importera i hostingu | drogo bez filtrowania |
| Mapowanie kategorii i parametrów | rozbudowane | zależy od platformy | ręcznie w scenariuszu |
| Dla kogo | sprzedaż wielokanałowa | jeden sklep | nietypowe procesy, mały katalog |
Według cennika Base.com z października 2026 BaseLinker ma plan Freemium bezpłatny do 100 zamówień miesięcznie oraz 14 dni testu z pełnym dostępem. Make w planie Free daje 1 000 kredytów miesięcznie. Ceny narzędzi zmieniają się często, więc przed decyzją sprawdź aktualne cenniki.
Integracja przez BaseLinker krok po kroku
Kolejność kroków jest podobna w innych integratorach, zmieniają się nazwy menu.
- Załóż konto i podłącz kanały. Dodaj sklep i konto Allegro w sekcji integracji. Allegro autoryzujesz przez logowanie na swoje konto.
- Dodaj hurtownię. W module magazynu i hurtowni wybierz dostawcę z listy albo dodaj własny plik XML, wklejając link z panelu hurtowni.
- Zmapuj pola. Wskaż, które pole pliku to nazwa, cena, stan, EAN, zdjęcia. Przy formacie CENEO wiele pól rozpozna się samo.
- Ustaw częstotliwość i zasady aktualizacji. Zdecyduj, co ma się aktualizować przy każdym pobraniu (zwykle stan i cena), a czego nie ruszać (opisy i tytuły, które poprawiasz ręcznie).
- Ustal narzut. Jeśli w pliku jest cena zakupu, ustaw regułę ceny sprzedaży, np. procentowy narzut z zaokrągleniem.
- Wystaw oferty. Wybierz produkty, przypisz kategorie Allegro i parametry, przygotuj szablon oferty. Zacznij od kilkunastu produktów, nie od całego katalogu.
- Przetestuj zero. Sprawdź na jednym produkcie, co dzieje się z ofertą, gdy stan w pliku spada do zera.
Pamiętaj, że plik XML przenosi produkty i stany, ale nie zawsze zamówienia. W Dropcom.eu plik służy do produktów i stanów, a zamówienie od klienta składasz w panelu b2b.dropcom.eu.
Wtyczki i importery w popularnych platformach
Jeśli sprzedajesz tylko we własnym sklepie, integrator może być zbędny. Polskie platformy SaaS, takie jak Shoper, IdoSell, Sky-Shop czy RedCart, mają importery plików XML, a część hurtowni ma w nich gotowe integracje. W systemach open source import robi wtyczka: dla WooCommerce i PrestaShop jest kilka płatnych rozwiązań, a niektóre hurtownie współpracują z konkretnymi producentami wtyczek.
Plik Dropcom.eu ma gotowe integracje m.in. w Sky-Shop, RedCart, TakeDrop, IdoSell, Shoper, a także w BaseLinker, Apilo i SellAsist. W PrestaShop i WooCommerce działa przez wtyczki partnerów. Jeśli Twojej platformy nie ma na liście, format CENEO zwykle wczyta się przez zwykły import.
Przy wyborze importera zwróć uwagę na trzy rzeczy:
- minimalny interwał pobierania (co 15 minut to co innego niż raz na dobę),
- zachowanie przy zerowym stanie: ukrycie, wyłączenie zakupu czy tylko informacja „niedostępny”,
- ochronę ręcznych zmian: czy możesz zablokować nadpisywanie opisu i zdjęć.
Jeśli dopiero wybierasz platformę, porównanie kosztów i integracji znajdziesz w rankingu platform e-commerce.
Własny scenariusz w Make: kiedy ma sens
Make przydaje się, gdy potrzebujesz czegoś, czego nie robi ani importer, ani integrator. Przykłady: aktualizacja stanów tylko dla 50 wybranych ofert na Allegro, alert, gdy ulubiony produkt znika z pliku, albo połączenie feedu z arkuszem, w którym liczysz marże.
Schemat scenariusza jest prosty: pobranie pliku modułem HTTP, parsowanie XML, filtr do produktów, które sprzedajesz, porównanie z poprzednim stanem i wysłanie tylko zmian. Problem w tym, że każda operacja kosztuje kredyt, a iteracja po całym katalogu przy każdym uruchomieniu może kosztować dziesiątki lub setki tysięcy kredytów miesięcznie. Do tego dochodzą limity zapytań API Allegro i konieczność obsługi autoryzacji OAuth. Całą konfigurację, z endpointami i szacunkiem kredytów, opisujemy w poradniku Make.com i Allegro.
Częstotliwość aktualizacji, mapowanie kategorii i typowe błędy
Jak często pobierać plik
Platformy nie pobierają pliku na bieżąco, tylko co ustalony czas: co 15 minut, co 30 minut albo co kilka godzin. Im dłuższa przerwa, tym większa szansa, że ktoś kupi produkt, który właśnie się wyprzedał. Rozsądny punkt wyjścia to 15–60 minut, a w sezonie (święta, majówka, lato) warto skrócić interwał do 5–10 minut, jeśli Twoje narzędzie na to pozwala. Regulamin Dropcom.eu zaleca synchronizację co najmniej raz na dobę, ale to absolutne minimum.
Mapowanie kategorii
Drzewo kategorii hurtowni prawie nigdy nie pokrywa się z kategoriami Allegro czy Twojego sklepu. Mapuj kategorie raz, starannie, i zapisz reguły. Przy Allegro uzupełnij też parametry wymagane w danej kategorii, bo bez nich oferta może się nie wystawić albo gorzej wypadać w wyszukiwaniu.
Typowe błędy
- Import całego katalogu naraz. Tysiące ofert z identycznymi opisami rzadko sprzedają się lepiej niż kilkadziesiąt dopracowanych.
- Nadpisywanie poprawionych opisów przy każdej aktualizacji, bo nie zablokowano tych pól.
- Brak reguły dla zerowego stanu, przez co produkty niedostępne wiszą w sklepie jako aktywne.
- Stary link do pliku. Jeśli w panelu hurtowni data ostatniego pobrania jest stara, platforma przestała pobierać plik. Napisz wtedy do dostawcy oprogramowania sklepu.
- Czas wysyłki w ofercie krótszy niż realny, bez buforu na przekazanie zamówienia do hurtowni.
Od czego zacząć
Otwórz link do pliku XML w przeglądarce, sprawdź kilka produktów z panelem hurtowni i zdecyduj, czy sprzedajesz w jednym kanale (importer platformy), czy w kilku (integrator). Potem podłącz kilkanaście produktów, przetestuj zachowanie przy zerowym stanie i dopiero wtedy rozszerzaj katalog. Jeśli dopiero zaczynasz, przeczytaj też, jak działa dropshipping, a jeśli chcesz skonfigurować import i integrator razem z konsultantem, sprawdź pakiety wsparcia eksperckiego.
Najczęstsze pytania
Jak często aktualizować stany z pliku XML?
Na co dzień zwykle wystarcza pobieranie co 15–60 minut, a w sezonie warto zejść do 5–10 minut dla najlepiej sprzedających się produktów. Regulamin Dropcom.eu zaleca synchronizację danych co najmniej raz na dobę, ale przy aktywnej sprzedaży to za rzadko.
Czy mogę zmienić opisy i zdjęcia zaimportowane z XML?
Tak, i często warto, bo ten sam opis ma wielu sprzedawców. Ustaw w importerze, żeby kolejne aktualizacje nie nadpisywały pól, które edytujesz ręcznie, a zmieniały tylko stan i cenę.
Co się dzieje z ofertą, gdy produktu zabraknie w hurtowni?
Przy poprawnej integracji stan spada do zera przy najbliższej aktualizacji, a oferta jest ukrywana albo wstrzymywana, zależnie od ustawień. Między aktualizacjami produkt nadal może zostać kupiony, dlatego częstotliwość pobierania pliku ma znaczenie.
Czy integracja XML działa z Allegro?
Allegro nie wczytuje pliku XML bezpośrednio. Feed podłączasz do integratora (np. BaseLinker, Apilo, SellAsist) albo platformy z integracją Allegro, a ona tworzy i aktualizuje oferty przez API Allegro.
