Integracja programu firmowego ze sklepem lub Allegro nie synchronizuje

Integracja programu firmowego ze sklepem internetowym lub Allegro, która przestaje synchronizować zamówienia i stany magazynowe, to poważny problem operacyjny – klienci mogą kupować towar, którego faktycznie nie ma na stanie, albo zamówienia nie trafiają do realizacji. Przyczyny bywają zaskakująco różnorodne. Czasem wystarczy wygasła autoryzacja, zmienione hasło lub chwilowa awaria usługi, ale zdarzają się również problemy wynikające z niezgodnych wersji oprogramowania, błędnego mapowania produktów albo niewłaściwej konfiguracji serwera.

Brak synchronizacji nie zawsze oznacza całkowite zatrzymanie integracji. W praktyce część danych może być przesyłana poprawnie, a część pozostawać w kolejce lub kończyć się błędem. Przykładowo, nowe zamówienia mogą trafiać do programu, ale aktualne ceny i stany magazynowe nie są już wysyłane do sklepu. Innym scenariuszem jest pobieranie zamówień bez przekazywania zmian ich statusów. Dlatego przed rozpoczęciem naprawy warto ustalić, które elementy przepływu danych działają, a które zostały zatrzymane.

Integracje programów księgowo-magazynowych z platformami sprzedażowymi działają zwykle poprzez API, wtyczkę pośredniczącą (tzw. konektor) lub dedykowany moduł producenta. Każdy z tych elementów może zawieść niezależnie od pozostałych – problem bywa po stronie programu, po stronie sklepu/Allegro, w samym konektorze, lub wynika ze zmiany w API platformy, do której konektor nie został jeszcze dostosowany.

Znaczenie ma także sposób uruchomienia integracji. Konektor może działać jako program na komputerze pracownika, usługa systemowa na serwerze, zadanie harmonogramu albo aplikacja dostępna w chmurze. Jeżeli komputer zostanie wyłączony, usługa zatrzyma się po aktualizacji systemu lub zmieni się konto, na którym działa proces, synchronizacja może przestać działać bez widocznego komunikatu na stronie internetowej.

Najczęstsze przyczyny braku synchronizacji

Poniżej sytuacje odpowiedzialne za większość przerw w synchronizacji między programem a kanałem sprzedaży.

Wygasły token autoryzacyjny lub klucz API po zmianie hasła na platformie sprzedażowej.
Aktualizacja programu firmowego lub platformy sklepowej niekompatybilna z dotychczasową wersją konektora.
Przekroczony limit zapytań API narzucony przez Allegro lub platformę e-commerce.
Rozbieżność w mapowaniu indeksów towarowych między systemami po zmianach w kartotece.
Zawieszona lub wyłączona usługa synchronizacji działająca w tle na serwerze.

Częstym powodem jest również zmiana uprawnień użytkownika, z którego korzysta integracja. Jeżeli konto utraciło dostęp do zamówień, produktów, cen lub stanów magazynowych, połączenie może nadal być formalnie aktywne, ale poszczególne operacje będą odrzucane. W takim przypadku samo ponowne uruchomienie konektora nie rozwiąże problemu.

Warto sprawdzić, czy platforma sprzedażowa nie wymaga ponownego zaakceptowania regulaminu, dodatkowej weryfikacji konta albo odnowienia zgód dotyczących dostępu aplikacji. Podobny efekt może wywołać włączenie dodatkowego zabezpieczenia logowania lub zmiana adresu serwera, z którego dozwolone są połączenia.

Problemy z autoryzacją i połączeniem API

API jest mechanizmem, przez który program firmowy wymienia dane ze sklepem lub Allegro. Jeżeli serwer nie może się uwierzytelnić, nie pobierze nowych zamówień ani nie prześle zmian stanów. W logach mogą pojawić się informacje o nieprawidłowym tokenie, braku uprawnień, błędzie certyfikatu albo odrzuceniu żądania przez serwer zewnętrzny.

Najbezpieczniejsza diagnostyka polega na sprawdzeniu daty ostatniej udanej operacji oraz porównaniu jej z momentem, w którym zmieniło się hasło, konfiguracja konta lub wersja oprogramowania. Należy również upewnić się, że dane dostępowe są zapisane w tym miejscu, z którego faktycznie korzysta konektor. W niektórych instalacjach konfiguracja użytkownika różni się od konfiguracji usługi systemowej, dlatego poprawienie danych w panelu programu nie zawsze wystarcza.

Nie należy wielokrotnie generować nowych kluczy API bez zapisania informacji o tym, który klucz został użyty w konfiguracji. Może to doprowadzić do unieważnienia wcześniejszych danych i zwiększyć liczbę niepotrzebnych błędów. Po zmianie autoryzacji warto wykonać kontrolną synchronizację jednego produktu lub niewielkiej partii danych.

Błędy mapowania produktów i wariantów

Program magazynowy i sklep internetowy mogą posługiwać się różnymi identyfikatorami tego samego produktu. Jeden system używa indeksu handlowego, drugi identyfikatora zewnętrznego, a platforma sprzedażowa może dodatkowo rozróżniać ofertę, produkt oraz wariant. Jeżeli te wartości zostaną zmienione, konektor może nie wiedzieć, do którego rekordu wysłać stan magazynowy.

Problem pojawia się między innymi po skopiowaniu kartoteki, zmianie symbolu produktu, usunięciu i ponownym utworzeniu oferty albo po imporcie danych z pliku. Szczególnie podatne są produkty z wariantami, takie jak różne rozmiary, kolory lub konfiguracje sprzętu. Stan produktu głównego może być poprawny, ale warianty pozostaną niepowiązane albo będą wskazywały ten sam indeks.

Podczas sprawdzania mapowania należy porównać kilka elementów: nazwę produktu, symbol, identyfikator w programie firmowym, identyfikator oferty w sklepie oraz przypisany wariant. Nie powinno się poprawiać wszystkich powiązań masowo bez kopii konfiguracji. Błędna zamiana indeksów może spowodować wysłanie niewłaściwych stanów do wielu ofert.

Diagnostyka krok po kroku

Diagnozę warto zacząć od logów konektora integracyjnego – większość z nich zapisuje szczegółowe informacje o błędach każdej próby synchronizacji, co pozwala szybko ustalić, czy problem dotyczy autoryzacji, pojedynczych produktów, czy całej komunikacji. Następnie sprawdza się, czy dane logowania i klucze API są nadal aktualne oraz czy wersje programu i konektora są ze sobą zgodne.

Pierwszym krokiem powinno być ustalenie zakresu awarii. Trzeba sprawdzić, czy nie synchronizują się zamówienia, produkty, stany, ceny, statusy przesyłek, czy wszystkie wymienione dane. Należy też zanotować, od kiedy występuje problem oraz czy dotyczy wszystkich ofert, czy tylko wybranych pozycji.

Drugim krokiem jest sprawdzenie działania samego programu firmowego i platformy sprzedażowej. Jeżeli panel sklepu nie działa poprawnie albo program magazynowy zgłasza błędy bazy danych, problem może nie być związany bezpośrednio z integracją. Warto również sprawdzić, czy połączenie internetowe na serwerze jest stabilne i czy zapora sieciowa nie blokuje ruchu wychodzącego.

Trzecim krokiem jest analiza kolejki synchronizacji. Niektóre konektory zapisują oczekujące operacje i próbują je ponawiać. Jeżeli jedna uszkodzona pozycja blokuje całą kolejkę, kolejne zamówienia mogą nie zostać przetworzone. W takiej sytuacji trzeba zidentyfikować pierwszy błąd, a nie tylko usuwać najnowsze komunikaty.

Czwartym krokiem jest wykonanie kontrolnej synchronizacji. Test powinien obejmować konkretny produkt, zmianę jego stanu oraz przykładowe zamówienie. Po każdej operacji należy sprawdzić zarówno system źródłowy, jak i platformę docelową. Sam komunikat „synchronizacja zakończona” nie zawsze oznacza, że wszystkie pola zostały prawidłowo przesłane.

Awaria usługi działającej w tle

Jeżeli synchronizacja jest wykonywana przez usługę systemową, należy sprawdzić, czy proces działa, uruchamia się automatycznie i ma dostęp do katalogów oraz konfiguracji. Aktualizacja systemu, zmiana hasła konta technicznego, brak miejsca na dysku lub awaria serwera może zatrzymać usługę. Czasem proces jest widoczny jako uruchomiony, ale nie wykonuje pracy z powodu błędu wewnętrznego.

Pomocne jest porównanie czasu ostatniego uruchomienia procesu z czasem ostatniej poprawnej synchronizacji. Należy także sprawdzić dziennik zdarzeń systemowych i logi aplikacji. W przypadku pracy na komputerze użytkownika warto upewnić się, że komputer nie przechodzi regularnie w tryb uśpienia i że program nie jest zamykany przy wylogowaniu.

Przywrócenie stabilnej synchronizacji

Po zlokalizowaniu przyczyny naprawa zwykle polega na odnowieniu autoryzacji API, aktualizacji konektora do wersji zgodnej z obiema stronami integracji lub ręcznym poprawieniu mapowania produktów, które rozjechało się w wyniku zmian w kartotece. Warto też ustawić monitoring działania integracji, np. powiadomienia e-mail w razie przerwania synchronizacji, aby kolejna awaria została wykryta zanim wpłynie na sprzedaż. Serwis IT może wdrożyć taki monitoring oraz przeprowadzić pełną diagnostykę i naprawę integracji.

Po naprawie nie należy od razu uruchamiać pełnej synchronizacji bez kontroli. Najpierw warto wykonać kopię konfiguracji, sprawdzić kilka reprezentatywnych produktów i potwierdzić, że stany oraz ceny są prawidłowe. Następnie można przetworzyć oczekujące zamówienia według ich kolejności, zwracając uwagę na te, które mogły zostać wcześniej obsłużone ręcznie.

Jeżeli w czasie awarii sprzedaż była prowadzona równolegle w kilku kanałach, konieczne jest uzgodnienie stanów magazynowych. Trzeba porównać sprzedaż z programu, sklepu i Allegro, a także uwzględnić rezerwacje, zwroty oraz anulowane zamówienia. W przeciwnym razie po przywróceniu integracji system może nadpisać poprawne dane nieaktualną wartością.

Jak ograniczyć ryzyko kolejnych przerw

Stabilność integracji poprawia regularne aktualizowanie programu, konektora i wtyczek, ale aktualizacje powinny być wykonywane po sprawdzeniu zgodności wersji. Przed większą zmianą warto zapisać konfigurację oraz ustalić, jak przywrócić poprzednie ustawienia. Dobrą praktyką jest również prowadzenie krótkiej dokumentacji zawierającej informacje o używanym koncie API, miejscu instalacji konektora i sposobie uruchamiania synchronizacji.

Monitoring powinien kontrolować nie tylko działanie procesu, ale także świeżość danych. Usługa może być uruchomiona, a mimo to od wielu godzin nie przetwarzać żadnego zamówienia. Przydatne są alerty dotyczące braku udanej synchronizacji, rosnącej kolejki błędów, przekroczenia limitu API oraz niezgodności stanów.

Warto także ograniczyć ręczne zmiany w kartotece produktów. Każda zmiana symbolu, usunięcie oferty lub ponowne utworzenie wariantu może wymagać aktualizacji mapowania. Jeżeli pracownicy wiedzą, które pola są wykorzystywane przez integrację, łatwiej uniknąć przypadkowego zerwania powiązań.

Częste pytania dotyczące synchronizacji

Czy ponowne uruchomienie komputera może rozwiązać problem?

Może pomóc, jeżeli zawiesił się proces konektora lub usługa systemowa. Nie naprawi jednak wygasłego tokena, błędnego mapowania ani niezgodności wersji. Po restarcie należy sprawdzić logi i wykonać kontrolną synchronizację.

Czy można ręcznie zmienić stan produktu w sklepie?

Jest to rozwiązanie tymczasowe i wymaga ostrożności. Jeżeli program firmowy pozostaje głównym źródłem danych, kolejna synchronizacja może nadpisać ręcznie ustawioną wartość. Najpierw trzeba ustalić, który system powinien być źródłem prawidłowego stanu.

Dlaczego tylko niektóre produkty nie synchronizują się poprawnie?

Najczęściej przyczyną jest brak powiązania, duplikat indeksu, nieaktywny wariant albo nieprawidłowe dane wymagane przez platformę. Jeżeli pozostałe produkty działają, bardziej prawdopodobny jest błąd danych niż awaria całego połączenia.

Czy po naprawie wszystkie zamówienia pobiorą się automatycznie?

Zależy to od sposobu działania konektora i ustawień kolejki. Niektóre integracje ponawiają nieudane operacje, inne wymagają ręcznego uruchomienia importu za wskazany okres. Przed ponowieniem warto sprawdzić, czy dane zamówienie nie zostało już wprowadzone do programu, aby uniknąć duplikatów.

Zgłoszenie naprawy: 22 390 56 49 — telefon czynny całą dobę, siedem dni w tygodniu. Sprzęt odbieramy spod wskazanego adresu w Grodzisku Mazowieckim i okolicy.