Sklepy internetowe Poradnik
Problemy z integracjami sklepu internetowego: 30 błędów z BaseLinkerem, Allegro, ERP, KSeF i kurierami (2026)
W skrócie
- Integracje sklepu psują się najczęściej z trzech powodów: brak jednego źródła danych (stanów, cen, produktów), łączenie rekordów po nazwie zamiast po SKU lub EAN i brak monitoringu, przez co awaria trwa dniami, zanim ktoś ją zauważy.
- Większości problemów zapobiega mapa integracji: który system jest źródłem jakich danych, w którą stronę płyną, jakim kluczem są łączone i kto dostaje powiadomienie, gdy wymiana się zatrzyma.
- Przy każdym z 30 problemów podajemy przyczynę i rozwiązanie, a przy najczęstszych link do szczegółowej naprawy; jeśli wolisz oddać połączenie sklepu z innymi systemami zespołowi, który robi to na co dzień, zrobimy to za Ciebie.
Nie masz czasu? Zrobimy to za Ciebie - Sklepy internetowe od 3 500 zł netto
Sklep internetowy rzadko działa sam. Zamówienia trafiają do BaseLinkera lub programu magazynowego, oferty na Allegro, dokumenty do programu księgowego i KSeF, paczki do kurierów, a produkty i stany przychodzą z hurtowni. Każde z tych połączeń oszczędza godziny ręcznej pracy, ale każde może też po cichu przestać działać albo przenosić błędy szybciej, niż człowiek zdążyłby je zrobić. Zebraliśmy 30 problemów z integracjami, które najczęściej widzimy w sklepach na WooCommerce i innych platformach.
Lista zaczyna się od zasad wspólnych dla wszystkich integracji, a potem przechodzi przez kolejne systemy: BaseLinker i marketplace, programy księgowe i ERP, KSeF, kurierów, płatności i hurtownie. Jeśli szukasz konkretnego objawu, użyj spisu treści albo wyszukiwania w przeglądarce (Ctrl+F).
Zasady i architektura integracji
Te cztery problemy stoją za większością pozostałych, dlatego warto zacząć od nich, nawet jeśli objaw wygląda na błąd jednej integracji.
1. Ten sam produkt ma inne dane w każdym systemie
Stan, cena i opis produktu są edytowane w sklepie, w programie magazynowym, w BaseLinkerze i na Allegro, a każda synchronizacja nadpisuje zmiany z innego miejsca. Nikt nie wie, która wartość jest prawdziwa. Skutkiem są sprzedaż towaru, którego nie ma, i ceny, które same wracają do starych.
Rozwiązanie: dla każdego rodzaju danych (stan, cena, opis, zdjęcia, dane klienta) wskaż jeden system źródłowy i ustaw synchronizację tylko z niego. W pozostałych systemach zablokuj ręczne zmiany tych pól albo przynajmniej opisz zasadę w procedurze zespołu.
2. Integracje łączą produkty po nazwie zamiast po kodzie
Nazwy zmieniają się ze względów marketingowych, a przy imporcie z hurtowni bywają różne dla tego samego produktu. Integracja, która szuka produktu po nazwie, tworzy duplikaty albo aktualizuje niewłaściwy produkt. Szczególnie cierpią na tym warianty, które mają podobne nazwy.
Rozwiązanie: nadaj każdemu produktowi i wariantowi unikalny SKU, a tam, gdzie to możliwe, także EAN, wpisany identycznie we wszystkich systemach. Używaj ich jako klucza we wszystkich integracjach, a stare identyfikatory zapisz w osobnym polu.
3. Integracja przestała działać i nikt tego nie zauważył
Wygasły token, zmienione hasło, wyłączony webhook albo nowa reguła zapory zatrzymuje wymianę danych bez komunikatu na ekranie. WooCommerce sam wyłącza webhook po kilku nieudanych dostarczeniach z rzędu. O awarii dowiadujesz się od klienta, który czeka na paczkę, albo od księgowości na koniec miesiąca.
Rozwiązanie: dla każdej integracji ustaw prosty test: porównanie liczby zamówień, dokumentów lub stanów między systemami raz na godzinę lub dobę, z powiadomieniem mailowym przy różnicy. Sprawdzaj też daty ważności tokenów i kluczy API.
4. Nikt nie wie, co z czym jest połączone
Integracje dokłada się latami: wtyczka do kuriera, aplikacja do Allegro, skrypt od programisty, scenariusz w narzędziu do automatyzacji. Po kilku latach nikt nie wie, który element wysyła stany, który pobiera zamówienia i co się stanie po wyłączeniu jednej wtyczki. Każda zmiana w sklepie to ryzyko.
Rozwiązanie: narysuj mapę integracji: systemy, kierunek przepływu danych, klucz łączenia, częstotliwość, osoba odpowiedzialna i miejsce, gdzie widać błędy. Przechowuj ją razem z dostępami do sklepu i aktualizuj przy każdej zmianie.
BaseLinker i marketplace
System do sprzedaży wielokanałowej spina zamówienia i stany z wielu kanałów, więc jego błędy widać od razu w magazynie.
5. BaseLinker nie pobiera zamówień ze sklepu
Najczęściej BaseLinker (dziś Base) nie może połączyć się z API sklepu: klucze usunięto lub mają tylko odczyt, zapora lub wtyczka bezpieczeństwa blokuje zapytania, odnośniki są ustawione na zwykłe albo wtyczka integracyjna jest nieaktualna. Po dłuższej przerwie część zamówień nie dociąga się automatycznie.
Rozwiązanie: sprawdź komunikat błędu w ustawieniach integracji, klucze API, wtyczkę i logi zapory, a po naprawie porównaj listy zamówień z okresu przerwy. Szczegóły i naprawa krok po kroku.
6. Zamówienia dublują się w BaseLinkerze
Duplikaty pojawiają się, gdy ten sam sklep jest podłączony dwiema integracjami (np. po migracji albo ponownej konfiguracji), gdy zamówienie przychodzi jednocześnie ze sklepu i z marketplace albo gdy integracja przekazuje zamówienia z powrotem do sklepu. Magazyn pakuje wtedy dwie paczki do jednego klienta.
Rozwiązanie: sprawdź listę integracji i wyłącz zdublowane źródła zamówień, a opcję przekazywania zamówień do sklepu włącz tylko tam, gdzie jest potrzebna. Po migracji sklepu wyłącz pobieranie ze starego sklepu przed włączeniem nowego.
7. Stany magazynowe w sklepie i na Allegro się nie zgadzają
Każdy kanał ma własną liczbę sztuk, a ktoś lub coś zmienia ją tylko w jednym miejscu. Do tego dochodzą rzadka synchronizacja, oferty powiązane z produktem głównym zamiast z wariantem i zwroty przyjmowane bez zmiany stanu.
Rozwiązanie: jeden system jako źródło stanów, powiązanie każdej oferty z produktem po SKU lub EAN, synchronizacja dopasowana do tempa sprzedaży i codzienny raport rozbieżności. Szczegóły i naprawa krok po kroku.
8. Statusy i numery przesyłek nie wracają do sklepu
Zamówienie jest wysłane w BaseLinkerze, a w sklepie wciąż „w trakcie realizacji”, więc klient nie dostaje maila z numerem przesyłki. Przyczyną jest brak powiązania statusów między systemami albo wyłączona aktualizacja statusów w ustawieniach integracji.
Rozwiązanie: powiąż statusy w BaseLinkerze ze statusami sklepu i włącz przekazywanie numerów nadania. Sprawdź na zamówieniu testowym, czy po zmianie statusu klient dostaje maila z linkiem do śledzenia.
9. Oferty na Allegro mają inne dane niż sklep
Opis, parametry i zdjęcia na Allegro przygotowano kiedyś ręcznie, a w sklepie od tego czasu wiele się zmieniło. Allegro wymaga też parametrów zależnych od kategorii, których sklep nie ma w swojej strukturze. Klient widzi różne informacje o tym samym produkcie.
Rozwiązanie: ustal, czy opisy i parametry na Allegro są generowane z danych sklepu, czy utrzymywane osobno, i trzymaj się jednej zasady. Brakujące parametry kategorii Allegro dodaj jako atrybuty produktu w źródle danych.
10. Ceny w kanałach sprzedaży się rozjeżdżają
Cena zmieniona w sklepie nie trafia na Allegro albo trafia z inną marżą, a reguły cenowe w systemie wielokanałowym nakładają się na promocje sklepu. Klient porównuje ceny i kupuje tam, gdzie taniej, a sklep nie wie, która cena jest właściwa.
Rozwiązanie: zdecyduj, czy ceny w kanałach są takie same, czy liczone regułą (np. narzut na prowizję marketplace), i ustaw tę regułę w jednym miejscu. Promocje planuj tak, żeby obejmowały wszystkie kanały albo świadomie tylko jeden.
Programy księgowe i ERP
Integracja z księgowością decyduje o tym, ile godzin w miesiącu zajmuje przepisywanie zamówień i szukanie różnic.
11. Zamówienia nie trafiają do programu księgowego
Dane są przepisywane ręcznie albo integracja przekazuje tylko część zamówienia: bez rabatów, kosztów dostawy albo NIP. Księgowość poprawia dokumenty, a różnice wychodzą przy zamknięciu miesiąca.
Rozwiązanie: wybierz sposób połączenia pasujący do programu (API, system wielokanałowy, moduł producenta albo własny łącznik) i przekazuj pełne zamówienie. Szczegóły i naprawa krok po kroku.
12. Dokumenty różnią się od zamówień o grosze
Sklep zaokrągla podatek po wierszu albo od sumy, a program księgowy liczy VAT od netto lub od brutto według własnych zasad. Przy rabatach procentowych i kilku pozycjach różnice groszowe pojawiają się regularnie.
Rozwiązanie: ustal jedną metodę zaokrąglania w sklepie i w programie i sprawdź ją na zamówieniu z kilkoma pozycjami, rabatem procentowym i dostawą. Dostawę przekazuj jako osobną pozycję z właściwą stawką.
13. Synchronizacja z ERP nadpisuje zmiany w sklepie
Program handlowy wysyła do sklepu ceny, opisy i stany, a zespół marketingu poprawia opisy i zdjęcia w sklepie. Przy kolejnej synchronizacji poprawki znikają. Problem dotyczy też cen promocyjnych ustawianych tylko w sklepie.
Rozwiązanie: rozdziel pola: ERP odpowiada za stany, ceny bazowe i dane logistyczne, a sklep za nazwy marketingowe, opisy, zdjęcia i promocje. Skonfiguruj integrację tak, aby aktualizowała tylko pola, za które odpowiada ERP.
14. Integracja działa tylko wtedy, gdy komputer w biurze jest włączony
Przy programach instalowanych lokalnie łącznik często działa na komputerze lub serwerze w biurze. Po wyłączeniu komputera, aktualizacji systemu albo zaniku internetu wymiana danych staje, a sklep sprzedaje według starych stanów.
Rozwiązanie: uruchom łącznik na serwerze, który działa stale, albo przenieś wymianę danych do usługi w chmurze. Dodaj powiadomienie, gdy łącznik nie zgłosi się przez ustalony czas.
15. Cenniki i warunki klientów B2B nie przechodzą do sklepu
Ceny indywidualne, rabaty grupowe i limity kupieckie są w programie handlowym, a sklep pokazuje wszystkim ceny detaliczne. Handlowcy przeliczają zamówienia firm ręcznie albo rozdają kupony.
Rozwiązanie: synchronizuj cenniki i przypisania klientów z programu handlowego, a w sklepie pokazuj je tylko zalogowanym, zaakceptowanym firmom. Zobacz wpis o cenach hurtowych w WooCommerce.
KSeF i dokumenty sprzedaży
Od 2026 roku faktury dla firm trafiają do Krajowego Systemu e-Faktur, więc błędy w danych zamówienia wychodzą od razu, a nie przy kontroli.
16. Jak przygotować sklep do KSeF?
Sklep sam nie łączy się z KSeF: fakturę wystawia program do faktur lub system księgowy, a sklep przekazuje mu dane. Obowiązek wystawiania faktur w KSeF obowiązuje od 1 lutego 2026 r. największych podatników, od 1 kwietnia 2026 r. pozostałych, a najmniejsze firmy od 1 stycznia 2027 r. Faktury dla konsumentów w KSeF są dobrowolne.
Rozwiązanie: połącz sklep z programem obsługującym KSeF, dodaj pole NIP z walidacją, ustal moment wystawienia faktury i obsługę korekt. Szczegóły i naprawa krok po kroku.
17. Faktura dla firmy powstaje bez NIP albo z błędnym NIP
Sklep nie ma pola NIP, klient wpisuje go w uwagach albo z literówką, a integracja nie ma skąd go wziąć. Faktura trafia wtedy do niewłaściwego nabywcy w KSeF albo powstaje jako faktura dla osoby prywatnej i wymaga korekty.
Rozwiązanie: dodaj wybór „kupuję jako firma” z polem NIP, walidacją formatu i, jeśli to możliwe, pobieraniem danych firmy z rejestru po NIP. Sprawdź, czy pole działa w zamówieniu zbudowanym z bloków.
18. Zwroty i reklamacje nie kończą się korektą
Zwrot przyjmuje się w sklepie albo w systemie wielokanałowym, a program księgowy o nim nie wie. Korekta powstaje z opóźnieniem albo wcale, a sprzedaż w księgowości różni się od rzeczywistej.
Rozwiązanie: połącz obsługę zwrotów z programem do faktur: zwrot w sklepie tworzy korektę albo zadanie dla osoby, która ją wystawi. Raz w miesiącu porównaj listę zwrotów z listą korekt.
19. KSeF nie działa, a faktury trzeba wystawić
Przy awarii lub braku połączenia program może wystawić fakturę w trybie offline24, ale trzeba ją dosłać do KSeF najpóźniej następnego dnia roboczego. Integracja, która przy błędzie po prostu pomija fakturę, zostawia dziury w ewidencji.
Rozwiązanie: upewnij się, że program do faktur obsługuje tryb offline i dosyłanie faktur, a integracja ma kolejkę z ponawianiem i powiadomienie o dokumentach, które nie dotarły do KSeF.
Darmowy skan sklepu
Sprawdź swój sklep za darmo
Wpisz adres, a przeniesiemy Cię do bezpłatnego skanu na stronie CodeScriptum.
Kurierzy i wysyłka
Integracje z przewoźnikami decydują o tym, ile czasu zajmuje wysłanie każdej paczki i czy klient wie, gdzie jest jego zamówienie.
20. Przy zamówieniu nie ma paczkomatów InPost
Metoda paczkomatowa nie jest dodana do strefy wysyłki, brakuje tokenu API albo wtyczka nie działa z koszykiem zbudowanym z bloków. Klient nie może wybrać punktu i rezygnuje albo wybiera kuriera, którego nie chciał.
Rozwiązanie: zainstaluj oficjalną integrację InPost, połącz ją z kontem i dodaj metodę do strefy wysyłki, a potem sprawdź wybór punktu w zamówieniu. Szczegóły i naprawa krok po kroku.
21. Etykiety wysyłkowe trzeba przepisywać ręcznie
Sklep nie jest połączony z kontem przewoźnika, więc adresy z zamówień przepisuje się do panelu kuriera. To strata czasu i źródło pomyłek, które rośnie razem z liczbą zamówień, szczególnie w sezonie.
Rozwiązanie: połącz sklep z kontami przewoźników przez oficjalne wtyczki albo system wielokanałowy i twórz etykiety z listy zamówień. Numer przesyłki powinien wracać do zamówienia automatycznie.
22. Klient nie dostaje numeru przesyłki
Numer nadania zostaje w panelu kuriera albo w systemie wielokanałowym i nie trafia do zamówienia w sklepie. Klient nie wie, gdzie jest paczka, i pisze do obsługi.
Rozwiązanie: ustaw automatyczne przypisanie numeru śledzenia do zamówienia i mail z linkiem przy zmianie statusu na wysłane. Sprawdź to na zamówieniu testowym dla każdego przewoźnika.
23. Koszty wysyłki w sklepie nie zgadzają się z cennikiem kuriera
Sklep liczy dostawę za sztukę zamiast za paczkę, nie uwzględnia gabarytów albo brakuje wag produktów. Klient płaci za dużo i rezygnuje albo sklep dopłaca do każdej paczki.
Rozwiązanie: uzupełnij wagi i wymiary produktów, użyj klas wysyłkowych dla gabarytów i porównaj koszty w koszyku z cennikiem przewoźnika na kilkunastu typowych zamówieniach. Szczegóły i naprawa krok po kroku.
24. Integracja kuriera nie obsługuje gabarytów i kilku paczek
Zamówienie z kilkoma dużymi produktami trzeba wysłać w kilku paczkach albo paletą, a integracja tworzy jedną etykietę ze standardowymi wymiarami. Kurier dolicza opłaty albo odmawia odbioru.
Rozwiązanie: sprawdź, czy integracja obsługuje wiele paczek w jednym zamówieniu i usługi dla gabarytów, i ustaw reguły podziału zamówienia na paczki. Jeśli gotowa integracja tego nie umie, rozważ system wielokanałowy albo własne rozszerzenie.
Płatności
Integracje płatności są najdroższe, bo ich błąd oznacza klienta, który zapłacił, a nie dostał zamówienia, albo pieniądze, których nikt nie umie przypisać.
25. Klient zapłacił, a zamówienie czeka na płatność
Sklep nie dostał powiadomienia od operatora płatności: blokuje je zapora, cache albo przekierowanie, adres powiadomień jest zły albo klucze pochodzą z trybu testowego. Pieniądze wpływają, a zamówienie stoi.
Rozwiązanie: sprawdź adres powiadomień w panelu operatora, wyklucz go z cache i zapory i przejrzyj logi wtyczki płatności. Szczegóły i naprawa krok po kroku.
26. Zwroty płatności robi się ręcznie w panelu operatora
Wtyczka płatności nie obsługuje zwrotów z poziomu zamówienia albo brakuje jej kluczy API. Zwrot robi się osobno u operatora, status zamówienia zmienia ręcznie, a korekta w księgowości powstaje albo nie.
Rozwiązanie: użyj wtyczki, która obsługuje zwroty z edycji zamówienia, uzupełnij klucze API i przetestuj zwrot częściowy i pełny. Połącz zwrot ze zmianą statusu i korektą dokumentu.
27. Wypłaty od operatora nie zgadzają się z zamówieniami
Operator wypłaca środki zbiorczo, po potrąceniu prowizji i zwrotów, a księgowość musi przypisać jedną wpłatę do wielu zamówień. Bez raportu rozliczeń z identyfikatorami zamówień to praca ręczna i źródło błędów.
Rozwiązanie: pobieraj z panelu lub API operatora raport rozliczeń z numerami zamówień i prowizjami, a numer zamówienia ze sklepu przekazuj do operatora przy każdej płatności. Dzięki temu rozliczenie można zautomatyzować.
Hurtownie i dropshipping
Integracje z dostawcami decydują o tym, czy katalog i stany w sklepie są prawdziwe.
28. Import z hurtowni nadpisuje opisy, zdjęcia i ceny
Import uruchamiany co kilka godzin aktualizuje wszystkie pola produktu. Praca włożona w opisy, zdjęcia i nazwy znika po każdej synchronizacji, a cena sprzedaży wraca do ceny z pliku hurtowni.
Rozwiązanie: ustaw w imporcie, które pola aktualizuje (zwykle stan i cena zakupu), a które są zarządzane w sklepie. Cenę sprzedaży wyliczaj regułą marży, a nie bezpośrednio z pliku.
29. Stany z hurtowni są nieaktualne
Plik hurtowni jest aktualizowany raz na dobę albo rzadziej, a towar sprzedaje się także w innych sklepach. Klient zamawia produkt, którego hurtownia już nie ma, i sklep musi anulować zamówienie.
Rozwiązanie: pobieraj stany tak często, jak pozwala hurtownia, ustaw rezerwę (pokazuj mniej sztuk niż w pliku) i ukrywaj produkty z niskim stanem. Sprawdź, czy hurtownia udostępnia częstsze aktualizacje lub API.
30. Zamówienia do hurtowni wysyła się ręcznie
W dropshippingu każde zamówienie trzeba przekazać dostawcy: mailem, przez panel albo plik. Ręczne przekazywanie opóźnia wysyłkę i prowadzi do pomyłek w adresach i ilościach, a numer przesyłki od hurtowni nie wraca do klienta.
Rozwiązanie: przekazuj zamówienia do dostawcy automatycznie (API, plik, mail w ustalonym formacie) i pobieraj od niego status oraz numer przesyłki do zamówienia w sklepie. Jeśli masz kilku dostawców, dziel zamówienie według produktu.
Od czego zacząć
Zacznij od problemów 1-4, bo bez źródła danych, wspólnego klucza i monitoringu każda kolejna integracja tylko powiększa chaos. Potem sprawdź te, które kosztują najwięcej każdego dnia: pobieranie zamówień (5), stany (7), płatności (25) i KSeF (16). Problemy samego WooCommerce, nie tylko integracji, zebraliśmy w liście 100 problemów z WooCommerce. Jeśli wolisz oddać połączenie sklepu z BaseLinkerem, Allegro, programem księgowym, KSeF i kurierami zespołowi, który robi to na co dzień, zobacz naszą usługę integracji sklepu internetowego.
Usługa CodeScriptum
Sklepy internetowe
od 3 500 zł netto
- WooCommerce, Shopify, PrestaShop, Shoper i sklepy dedykowane
- Migracja bez utraty pozycji w Google
- Integracje: płatności, InPost, BaseLinker, KSeF
Najczęściej zadawane pytania
Jakie integracje potrzebuje sklep internetowy?
Najczęściej: płatności, przewoźników i paczkomaty, program do faktur lub księgowy z obsługą KSeF, a przy sprzedaży w kilku kanałach system wielokanałowy lub integrację z marketplace. Sklepy korzystające z hurtowni potrzebują też importu produktów i stanów.
Czy BaseLinker zastąpi integracje sklepu?
Częściowo. System wielokanałowy spina zamówienia, stany, kurierów i dokumenty z wielu kanałów, ale nadal wymaga jednego źródła stanów, powiązania produktów po SKU i dobrze skonfigurowanego połączenia ze sklepem.
Jak sprawdzić, czy integracja działa poprawnie?
Porównuj automatycznie liczby: zamówienia w sklepie i w systemie, dokumenty i zamówienia, stany w źródle i w kanałach. Różnica, która utrzymuje się dłużej niż ustalony czas, powinna uruchamiać powiadomienie.
Czy sklep sam wysyła faktury do KSeF?
Nie. Fakturę w KSeF wystawia program do faktur lub system księgowy, a sklep przekazuje mu dane zamówienia przez integrację.
Gotowa wtyczka czy integracja na zamówienie?
Gotowa wtyczka wystarcza przy standardowym procesie. Integracja na zamówienie ma sens, gdy proces jest nietypowy, gdy kilka wtyczek się ze sobą kłóci albo gdy potrzebujesz kolejki, ponowień i monitoringu, których wtyczka nie ma.
Pojęcia w tym artykule
Źródła
- KSeF: etapy wdrożenia KSeF 2.0 (Ministerstwo Finansów) (otwiera się w nowej karcie) ksef.podatki.gov.pl
- KSeF 2.0: pytania i odpowiedzi (tryb offline24) (otwiera się w nowej karcie) ksef.podatki.gov.pl
- Base.com: integracja z WooCommerce (pomoc) (otwiera się w nowej karcie) base.com
- WooCommerce: webhooki (otwiera się w nowej karcie) woocommerce.com
- Dokumentacja REST API WooCommerce (otwiera się w nowej karcie) woocommerce.github.io