Najlepsze API produktów dla dropshippingu i e-commerce w Polsce

Sklep ze stu produktami da się jeszcze ogarnąć ręcznie. Przy tysiącu pozycji, które co tydzień zmieniają cenę i stan magazynowy u dostawcy, ręczne wprowadzanie danych przestaje się opłacać — ktoś musi codziennie sprawdzać, czy produkt nadal jest dostępny, czy cena się nie zmieniła, czy zdjęcie się nie zgubiło. W praktyce kończy się to tak, że sklep sprzedaje towar, którego już nie ma w magazynie hurtowni, albo wystawia produkt po nieaktualnej cenie sprzed miesiąca.
API produktów to jeden ze sposobów, żeby ten problem rozwiązać — nie jedyny, i nie zawsze najlepszy w każdej sytuacji, ale zdecydowanie najczęściej wybierany, gdy skala sprzedaży przestaje pozwalać na pracę ręczną. W tym artykule wyjaśniamy, czym API produktów właściwie jest, czym różni się od pokrewnych pojęć (API hurtowni, API marketplace, feed XML), oraz jak wygląda to konkretnie na polskim rynku — z BaseLinkerem, Allegro, WooCommerce, Shopify, PrestaShop, Shoperem i IdoSell.

Czym jest API produktów?

API (Application Programming Interface) to po prostu ustandaryzowany sposób, w jaki dwa systemy informatyczne mogą się ze sobą komunikować bez udziału człowieka. Jeden system pyta o dane, drugi na to pytanie odpowiada — zawsze w tym samym, przewidywalnym formacie.

API produktów to węższe pojęcie: interfejs, przez który zewnętrzny system (np. sklep internetowy) może pobrać dane o produktach — nazwy, ceny, zdjęcia, stany magazynowe — bezpośrednio z bazy danych dostawcy tych informacji, zamiast wpisywać je ręcznie.

Najprostsza analogia: zamiast codziennie dzwonić do hurtowni i pytać „ile macie sztuk produktu X i w jakiej cenie”, Twój sklep „pyta” o to automatycznie, elektronicznie, co godzinę albo częściej — i sam aktualizuje swoją ofertę na podstawie odpowiedzi.

Konkretny przykład: sklep internetowy wysyła zapytanie do API hurtowni obuwniczej o dane produktu o danym SKU. W odpowiedzi otrzymuje strukturę danych (najczęściej w formacie JSON lub XML) zawierającą nazwę, cenę hurtową, dostępne rozmiary, stan magazynowy i adresy URL zdjęć. Sklep automatycznie zapisuje te dane u siebie i aktualizuje kartę produktu.

Ważne zastrzeżenie już na starcie: nie każde narzędzie reklamowane jako „integracja API” jest tym samym co API produktów w ścisłym sensie. Dalej w artykule dokładnie rozróżniamy API hurtowni, API sklepu, API marketplace i platformy integracyjne — to rozróżnienie realnie wpływa na to, jakiego rozwiązania potrzebujesz.

Jak działa API produktów?

Typowy przepływ danych między sklepem a dostawcą danych produktowych wygląda tak:

1. Połączenie – system sklepu (albo pośrednicząca platforma integracyjna) łączy się z adresem API dostawcy.
2. Uwierzytelnienie – najczęściej za pomocą klucza API (tokenu) wygenerowanego w panelu dostawcy; token identyfikuje, kto pyta i do jakich danych ma dostęp.
3. Zapytanie (request) – system wysyła żądanie, np. „pobierz dane produktów zmienionych po dacie X” albo „pobierz stan magazynowy dla SKU Y”.
4. Odpowiedź (response) – API zwraca dane w formacie JSON lub XML, zwykle wraz z kodem statusu informującym, czy zapytanie się powiodło.
5. Mapowanie danych – pola z odpowiedzi API (np. stock_quantity, price_net) trzeba dopasować do pól w bazie sklepu, bo nazewnictwo rzadko jest identyczne u obu stron.
6. Zapis lub aktualizacja – na podstawie zmapowanych danych system tworzy nowe produkty albo aktualizuje istniejące.
7. Synchronizacja cykliczna – cały proces powtarza się automatycznie w ustalonych odstępach (co godzinę, co kilka godzin, czasem w czasie rzeczywistym przez webhooki).

Przykład z polskiego podwórka: sklep na WooCommerce współpracuje z hurtownią odzieżową, która udostępnia własne API. Skrypt po stronie sklepu (napisany samodzielnie albo działający jako wtyczka) co godzinę odpytuje API hurtowni o zmiany w stanach magazynowych, a wynik zapisuje bezpośrednio w bazie WooCommerce przez wbudowane REST API sklepu. Klient przeglądający sklep zawsze widzi aktualną dostępność — bez udziału człowieka po żadnej ze stron.

Jakie dane można pobierać przez API produktów?

Zakres danych zależy wyłącznie od tego, co konkretny dostawca zdecydował się udostępnić — nie ma tu jednego uniwersalnego standardu. Najczęściej spotykane pola to:

• nazwa produktu
• SKU (wewnętrzny identyfikator dostawcy)
• EAN (kod kreskowy, kluczowy przy wystawianiu ofert na Allegro i innych marketplace’ach — bez EAN wiele kategorii ma ograniczoną widoczność)
• opis (krótki i/lub długi)
• zdjęcia (zwykle jako adresy URL, rzadziej jako pliki binarne)
• kategorie i podkategorie
• warianty (rozmiar, kolor, pojemność itd.)
• atrybuty/parametry techniczne
• cena – tu warto zwrócić uwagę, czy API zwraca cenę netto czy brutto i w jakiej walucie; przy integracjach z polskimi hurtowniami niemal zawsze chodzi o PLN, ale przy dostawcach zagranicznych trzeba to sprawdzić
• stawka VAT
• stan magazynowy (dokładna liczba sztuk albo tylko status „dostępny/niedostępny”)
• dostawca/producent
• informacje o wysyłce (czas realizacji, waga, wymiary paczki – istotne przy kalkulacji kosztów dostawy)

Nie każde API zwraca komplet tych danych. Część hurtowni, szczególnie mniejszych, udostępnia jedynie podstawowy zestaw (nazwa, cena, stan), a resztę trzeba uzupełniać ręcznie albo pozyskiwać z innego źródła. To jedna z pierwszych rzeczy, które warto zweryfikować przed integracją — brak EAN w danych dostawcy to sygnał ostrzegawczy, bo utrudni późniejsze wystawianie ofert na marketplace’ach.

Do czego można wykorzystać API produktów?

• Import produktów od hurtowni – jednorazowe lub cykliczne wgranie całego katalogu do sklepu.
• Automatyczna aktualizacja produktów – zmiany opisu, kategorii czy parametrów bez ingerencji ręcznej.
• Synchronizacja stanów magazynowych – zapobiega sprzedaży towaru, którego już nie ma u dostawcy.
• Synchronizacja cen – ważne zwłaszcza przy dostawcach, którzy zmieniają cenniki kilka razy w miesiącu.
• Synchronizacja zdjęć produktowych – automatyczne pobieranie i podmiana grafik.
• Aktualizacja opisów – przydatne przy dużych katalogach, gdzie ręczna edycja tysięcy kart produktów jest niepraktyczna.
• Synchronizacja wariantów – rozmiary, kolory i inne opcje produktu aktualizowane razem z produktem głównym.
• Łączenie wielu sklepów – jedna baza produktowa zasilająca kilka witryn jednocześnie (np. sklep własny + biała etykieta dla partnera).
• Łączenie z marketplace’ami – wystawianie tego samego katalogu na Allegro, Amazon czy eBay bez powielania pracy.
• Przesyłanie zamówień do dostawcy – w modelu dropshippingowym zamówienie klienta trafia automatycznie do systemu hurtowni.
• Śledzenie statusu zamówień – informacja o wysyłce wraca do sklepu i trafia do klienta.
• Automatyzacja całego procesu dropshippingowego – połączenie powyższych punktów w jeden, w miarę bezobsługowy proces.

API produktów a dropshipping

W modelu dropshippingowym API produktów pełni rolę łącznika w łańcuchu:

Dostawca → API → Integracja → Sklep internetowy → Klient

Dane o produkcie (nazwa, cena, stan, zdjęcia) płyną od dostawcy do sklepu. Kiedy klient złoży zamówienie, informacja o nim płynie w drugą stronę — od sklepu z powrotem do dostawcy, który realizuje wysyłkę bezpośrednio do klienta końcowego. Dobrze skonfigurowana integracja sprawia, że sprzedawca w dropshippingu w ogóle nie dotyka fizycznie towaru — cały przepływ informacji odbywa się elektronicznie.

To jednak dobry moment, żeby wyraźnie powiedzieć, czego API nie załatwia automatycznie, bo to jedno z najczęstszych nieporozumień wśród początkujących w dropshippingu:

• Rzetelności dostawcy – API przekaże Ci dokładnie takie dane, jakie dostawca do niego wprowadził; jeśli dostawca ma problemy z terminowością wysyłek, żadna integracja tego nie naprawi.
• Jakości produktu – synchronizacja opisu nie gwarantuje, że opisany produkt faktycznie spełnia oczekiwania klienta.
• Czasu dostawy – API może zwracać deklarowany czas realizacji, ale nie kontroluje, czy dostawca faktycznie go dotrzymuje.
• Obsługi zwrotów i reklamacji – to wciąż proces, który trzeba ustalić i wynegocjować z dostawcą osobno, poza samą integracją techniczną.
• Marży i rentowności – automatyzacja przepływu danych nie zwalnia z konieczności policzenia, czy przy danej cenie hurtowej, prowizji marketplace’u i kosztach wysyłki biznes się w ogóle spina.
• Zgodności z regulaminem marketplace’u – np. Allegro wymaga, by w modelu dropshippingowym to sprzedawca był stroną wobec kupującego (własne dane na fakturze, własna obsługa reklamacji) — API nie zwolni z tego obowiązku.

Innymi słowy: API produktów automatyzuje przepływ informacji, a nie odpowiedzialność biznesową. To dobre narzędzie do skalowania operacji, ale nie substytut dobrego wyboru dostawcy.

Popularne API i platformy dla e-commerce w Polsce

Poniżej przegląd rozwiązań, z którymi najczęściej styka się polski sprzedawca. Celowo nie szeregujemy ich od „najlepszego” do „najgorszego” — każde odpowiada na inną potrzebę.

BaseLinker

BaseLinker to polskie narzędzie, które nie jest samo w sobie API produktów — to platforma integracyjna do zarządzania sprzedażą wielokanałową. Łączy w jednym panelu sklep internetowy, konta na marketplace’ach (Allegro, Amazon, eBay i inne), kurierów oraz systemy księgowe.

BaseLinker udostępnia jednak własne, w pełni udokumentowane REST-owe API (api.baselinker.com/connector.php), które komunikuje się w formacie JSON i wymaga tokenu przekazywanego w nagłówku X-BLToken. Deweloperzy mogą przez to API programowo pobierać i zapisywać dane o zamówieniach, produktach i stanach magazynowych — dokumentacja opisuje ok. 195 metod, a limit zapytań wynosi 100 na minutę. Zmiany (np. nowe zamówienia) trzeba odpytywać cyklicznie metodami dziennika zdarzeń (getJournalList) — BaseLinker nie publikuje oficjalnej dokumentacji webhooków, więc integracje oparte na powiadomieniach zdarzeniowych działają w praktyce na zasadzie obserwowanej, a nie udokumentowanej.

Dla sklepów, które nie mają własnego programisty, BaseLinker oferuje też gotowe integracje z hurtowniami udostępniającymi plik XML — narzędzie samo pobiera i mapuje dane, bez pisania kodu.

Allegro API

Allegro API (dostępne pod developer.allegro.pl) to API marketplace’u, nie API produktowe dostawcy. Pozwala sprzedawcom (po autoryzacji OAuth) zarządzać własnymi ofertami na Allegro: wystawiać nowe produkty, aktualizować ceny i stany, obsługiwać zamówienia, promocje, zgłoszenia posprzedażowe i wiadomości z kupującymi.

Kluczowa różnica względem API hurtowni: Allegro API operuje na ofertach wystawionych na platformie, a nie na katalogu produktowym dostawcy. Jeśli chcesz zautomatyzować wystawianie ofert na podstawie danych z hurtowni, potrzebujesz dwóch elementów: źródła danych produktowych (API hurtowni albo feed XML) oraz integracji z Allegro API (własnej albo przez narzędzie typu BaseLinker/Apilo), które przełoży te dane na konkretne oferty.

Warto też sprawdzić na bieżąco status weryfikacji aplikacji do zasobów publicznych (np. GET /offers/listing) — Allegro okresowo wstrzymuje lub zmienia zasady dostępu do niektórych zasobów, więc przed integracją należy zweryfikować aktualny stan w oficjalnej dokumentacji.

WooCommerce REST API

WooCommerce, jako wtyczka do WordPressa, ma wbudowane REST API (dostępne od wersji 2.6) działające na formacie JSON, z autoryzacją przez klucze API generowane w panelu WooCommerce (Ustawienia → Zaawansowane → REST API). To API sklepu — pozwala na odczyt i zapis produktów, zamówień, klientów oraz obsługę webhooków przy zmianach statusu zamówienia.

W praktyce WooCommerce REST API jest tym elementem układanki, który odbiera dane z API hurtowni albo z platformy integracyjnej i zapisuje je bezpośrednio w bazie sklepu. Sam w sobie nie dostarcza danych produktowych — jedynie umożliwia ich programowe wprowadzanie i odczyt.

Shopify Admin API

Shopify oferuje Admin API do zarządzania sklepem — produktami, wariantami, stanami magazynowymi i zamówieniami. Istotna informacja na 2026 rok: Shopify oficjalnie oznaczyło REST Admin API jako przestarzałe (legacy) od października 2024 roku i rekomenduje budowanie nowych integracji na bazie GraphQL Admin API. Publiczne aplikacje korzystające ze starszych zasobów REST dla produktów i wariantów musiały zmigrować do lutego 2025 roku, a niestandardowe integracje obsługujące ponad 100 wariantów produktu również wymagają przejścia na GraphQL. Shopify wydaje nowe wersje API kwartalnie (np. 2026-01, 2026-04) — przy integracji warto zawsze przypinać się do konkretnej, aktualnej wersji, a nie do generycznego endpointu.

Dla sklepów planujących integrację z polską hurtownią lub z BaseLinkerem to oznacza jedno: nowe integracje (własne skrypty, nie gotowe wtyczki) warto od razu projektować pod GraphQL, a nie pod starsze REST-owe przykłady, które wciąż krążą w sieci.

PrestaShop Webservice API

PrestaShop ma wbudowany moduł Webservice, domyślnie oparty na formacie XML (JSON jest również obsługiwany), autoryzowany kluczem API generowanym w panelu administracyjnym (Zaawansowane → Usługa sieci Web). Webservice pozwala na zarządzanie produktami, stanami magazynowymi, kategoriami i zamówieniami oraz łączenie sklepu z zewnętrznymi systemami ERP.

To klasyczne API sklepu — w polskich wdrożeniach najczęściej łączone z modułami trzecich firm, które po stronie hurtowni obsługują import z plików XML/CSV lub bezpośrednie połączenie API, a po stronie PrestaShop zapisują dane przez Webservice.

Shoper

Shoper (popularna polska platforma SaaS) udostępnia otwarte API (WebAPI) umożliwiające zewnętrznym aplikacjom zarządzanie produktami i zamówieniami. Historycznie było to API oparte na SOAP/XML — przed integracją warto bezpośrednio zweryfikować u dostawcy aktualną wersję i format (dokumentacja i możliwości API bywają rozwijane, a najświeższe szczegóły najlepiej potwierdzić w panelu sklepu lub bezpośrednio u Shopera).

IdoSell

IdoSell (dawniej IAI-Shop) prowadzi rozbudowane REST-owe Admin API 3 — w pełni RESTful, z nową dokumentacją i wsparciem dla integracji no-code; poprzednia wersja, API 2.0, została wycofana z rozwoju z końcem 2024 roku. Co istotne z punktu widzenia dropshippingu: IdoSell udostępnia też osobno udokumentowane bramki API (tzw. CustomerAPI w ramach formatu ICDF) dedykowane właśnie przyjmowaniu zamówień dropshippingowych przez hurtownie — czyli scenariuszowi, w którym to IdoSell działa po stronie dostawcy/hurtowni, a nie sklepu detalicznego. To dobry przykład na to, że jeden dostawca może udostępniać zarówno API sklepu, jak i osobne API zaprojektowane pod rolę dostawcy w łańcuchu dropshippingowym.

Polskie hurtownie i dostawcy

To jeden z najważniejszych faktów na polskim rynku dropshippingu: większość polskich hurtowni dropshippingowych nie udostępnia pełnego, publicznie udokumentowanego API produktowego — zamiast tego oferują cykliczny plik XML lub CSV pod stałym adresem URL, czasem zgodny z powszechnie stosowanym schematem (np. formatem IOF, wykorzystywanym przez wiele integracji z platformami takimi jak Apilo). Część większych hurtowni oferuje dodatkowo panel B2B do składania zamówień oraz, rzadziej, prawdziwe REST API.

Jeśli zastanawiasz się, czego dokładnie potrzebujesz od konkretnego dostawcy, dobrym punktem wyjścia jest proste pytanie wysłane do działu obsługi hurtowni: czy udostępniają bazę produktów w postaci linku do cyklicznie aktualizowanego pliku XML/CSV, czy pełną integrację przez API. Odpowiedź determinuje, jakiego typu integrator będziesz potrzebować po swojej stronie.

Dostępność, zakres danych i warunki współpracy różnią się między dostawcami i zmieniają się w czasie — przed podjęciem decyzji zawsze warto zweryfikować je bezpośrednio u konkretnej hurtowni.

API produktów vs feed XML/CSV

To rozróżnienie jest szczególnie istotne w Polsce, bo znaczna część hurtowni po prostu nie inwestuje w budowę pełnego API — udostępnienie pliku XML lub CSV jest tańsze i prostsze do utrzymania po ich stronie.

Kluczowy wniosek: feed XML lub CSV wcale nie jest gorszym rozwiązaniem — jeśli dostawca aktualizuje go co godzinę, a Twój sklep nie potrzebuje danych w czasie rzeczywistym, plik produktowy w zupełności wystarczy i jest zwykle prostszy oraz tańszy do wdrożenia niż pełne API. Prawdziwe API ma sens tam, gdzie liczy się szybkość reakcji na zmianę (np. wysoko rotujący asortyment elektroniczny) albo gdzie trzeba wysyłać dane w drugą stronę (np. zamówienia do dostawcy).

API hurtowni vs API sklepu vs API marketplace

To rozróżnienie odpowiada za większość nieporozumień wokół samego terminu „API produktów”. W praktyce mówimy o czterech różnych rolach:

API hurtowni (API dostawcy)
→ udostępnia dane o produktach należących do dostawcy: cenę hurtową, stan magazynowy, opis. To źródło danych w łańcuchu dropshippingowym.

API sklepu
→ zarządza danymi w Twoim sklepie: produktami, zamówieniami, klientami. Przykłady: WooCommerce REST API, Shopify Admin API, PrestaShop Webservice, IdoSell Admin API 3.

API marketplace
→ zarządza ofertami wystawionymi na konkretnej platformie sprzedażowej: Allegro API, ewentualne API innych marketplace’ów. Operuje na poziomie oferty, nie katalogu produktowego dostawcy.

Platforma integracyjna
→ nie jest żadnym z powyższych z osobna, tylko spina je wszystkie w jednym panelu. BaseLinker i podobne narzędzia (np. Apilo) same udostępniają API, ale ich główną funkcją jest łączenie hurtowni, sklepu i marketplace’ów w jeden przepływ danych bez pisania własnego kodu integracyjnego.

Kiedy ktoś szuka „API produktów”, w zależności od kontekstu może mieć na myśli którykolwiek z powyższych czterech elementów — i to właśnie ta niejednoznaczność najczęściej prowadzi do rozczarowania po zakupie złego narzędzia.

Jak wybrać API produktów dla sklepu internetowego?

• Dokumentacja – czy jest kompletna, aktualna i publicznie dostępna, czy trzeba o nią prosić dopiero po podpisaniu umowy?
• Uwierzytelnianie – token API, OAuth, klucz w nagłówku – jaki mechanizm i czy jest bezpieczny (HTTPS obowiązkowo)?
• REST czy GraphQL – zwłaszcza istotne przy Shopify, gdzie REST jest już rozwiązaniem wycofywanym.
• Limity zapytań (rate limits) – ile zapytań na minutę/godzinę dopuszcza dostawca i czy wystarczy to przy Twojej skali katalogu.
• Webhooki vs polling – czy dostawca informuje o zmianach automatycznie, czy trzeba je samodzielnie sprawdzać cyklicznie.
• Paginacja – jak API obsługuje duże katalogi (tysiące produktów) bez przeciążania zapytań.
• Obecność SKU i EAN – brak EAN utrudni później sprzedaż na marketplace’ach.
• Obsługa wariantów produktowych – rozmiary, kolory, warianty pakowania.
• Zdjęcia i opisy – w jakim formacie i czy licencja pozwala na ich komercyjne wykorzystanie.
• Waluta i stawki VAT – zwłaszcza przy dostawcach spoza Polski, gdzie ceny mogą nie być w PLN.
• Alternatywa w postaci XML/CSV – czy istnieje, gdyby integracja API okazała się zbyt kosztowna.
• Synchronizacja zamówień – czy API pozwala przesyłać zamówienia z powrotem do dostawcy.
• Wsparcie dla marketplace’ów – czy dostawca lub integrator ułatwia wystawianie na Allegro i inne platformy.
• Kompatybilność z Twoją platformą – WooCommerce, Shopify, PrestaShop, Shoper, IdoSell – nie każde API ma gotowe wtyczki pod każdą platformę.
• Stabilność i SLA – jak często API bywa niedostępne i czy dostawca to komunikuje.
• Skalowalność – czy rozwiązanie wytrzyma wzrost katalogu z kilkuset do kilkudziesięciu tysięcy produktów.
• Monitoring i obsługa błędów – czy masz (lub zamierzasz wdrożyć) system alertów informujący o zerwanej synchronizacji.

Jak zintegrować API produktów ze sklepem?

1. Wybór dostawcy danych – hurtownia z własnym API, gotowa platforma integracyjna (np. BaseLinker) albo feed XML/CSV.
2. Uzyskanie danych dostępowych – token, klucz API, dane logowania do panelu dewelopera.
3. Zapoznanie się z dokumentacją – zwłaszcza z listą dostępnych metod i formatem odpowiedzi.
4. Połączenie z API – wykonanie pierwszego testowego zapytania i weryfikacja poprawnej autoryzacji.
5. Mapowanie pól – dopasowanie nazw i struktur danych (np. nazwa_produktu u dostawcy do post_title w WooCommerce).
6. Import produktów – pierwsze, zwykle jednorazowe wgranie całego katalogu.
7. Aktualizacja stanów magazynowych – ustawienie cyklu synchronizacji dopasowanego do tempa zmian u dostawcy.
8. Aktualizacja cen – analogicznie, z uwzględnieniem ewentualnej narzuconej marży.
9. Obsługa błędów – co się dzieje, gdy zapytanie się nie powiedzie (produkt zniknął, zmienił się format odpowiedzi, przekroczono limit zapytań).
10. Monitoring synchronizacji – alerty przy przerwanej integracji, żeby nie dowiedzieć się o problemie od klienta.

Proste integracje z pojedynczą hurtownią, przez gotowe narzędzie typu BaseLinker, da się skonfigurować samodzielnie, korzystając z kreatora integracji. Integracje niestandardowe — własne API hurtowni bez gotowego modułu, kilka źródeł danych naraz, czy migracja z REST na GraphQL przy Shopify — zwykle wymagają zaangażowania developera.

Najczęstsze problemy z API produktów

• Niepoprawne dane produktowe – dostawca zmienia strukturę pola bez uprzedzenia, integracja zaczyna zapisywać puste wartości. Rozwiązanie: walidacja danych przed zapisem, alerty przy nietypowych wartościach.
• Brakujący EAN – uniemożliwia wystawienie oferty w wielu kategoriach na Allegro. Rozwiązanie: filtrowanie produktów bez EAN i ręczne uzupełnianie tylko najważniejszych pozycji, albo rezygnacja z konkretnego dostawcy.
• Duplikaty produktów – ten sam produkt importowany wielokrotnie pod różnymi identyfikatorami. Rozwiązanie: jednoznaczny klucz mapowania (najlepiej EAN lub SKU dostawcy), a nie nazwa produktu.
• Przekroczenie limitów zapytań (rate limits) – integracja zaczyna zwracać błędy 429. Rozwiązanie: implementacja kolejkowania zapytań i mechanizmu ponawiania z opóźnieniem.
• Błędy uwierzytelniania – wygasły token, zmieniony klucz API. Rozwiązanie: monitoring ważności tokenów i automatyczne odświeżanie tam, gdzie API na to pozwala.
• Niespójne SKU – różne systemy stosują różne konwencje identyfikatorów. Rozwiązanie: ustalenie jednego, nadrzędnego identyfikatora na starcie integracji.
• Brakujące zdjęcia – linki do grafik przestają działać po stronie dostawcy. Rozwiązanie: lokalne cache’owanie zdjęć zamiast polegania wyłącznie na zewnętrznych URL-ach.
• Nieaktualne stany magazynowe – zbyt rzadka synchronizacja przy szybko rotującym asortymencie. Rozwiązanie: dostosowanie częstotliwości synchronizacji do realnego tempa zmian u dostawcy.
• Zmiany cen niezauważone w porę – ryzyko sprzedaży poniżej kosztu. Rozwiązanie: automatyczne reguły przeliczania marży zamiast sztywnych cen.
• Przestoje API (downtime) – dostawca ma awarię, synchronizacja się zatrzymuje. Rozwiązanie: mechanizm powiadomień o nieudanych synchronizacjach oraz plan awaryjny (np. tymczasowe oznaczenie produktów jako „sprawdź dostępność”).
• Problemy z plikami feed – uszkodzony lub niepełny plik XML/CSV. Rozwiązanie: walidacja struktury pliku przed importem, a nie po fakcie.
• Zmiany wersji API – dostawca wycofuje starą wersję (jak w przypadku Shopify REST czy IdoSell API 2.0). Rozwiązanie: śledzenie changelogów dostawców i planowanie migracji z wyprzedzeniem, zanim stara wersja przestanie działać.