Porady eksperta

W tej sekcji dzielimy się ekspercką wiedzą dotyczącą najczęściej zgłaszanych problemów, błędnych konfiguracji oraz sytuacji, które mogą prowadzić do nieprawidłowego działania aplikacji IdoSell Bridge.

Znajdziesz tu:

• opisy konkretnych problemów napotykanych przez klientów,

• rekomendowane rozwiązania i ustawienia konfiguracyjne,

• wskazówki, jak unikać najczęstszych błędów,

• szczegółowe instrukcje postępowania krok po kroku.

Informacja:
Strona jest regularnie aktualizowana – dodajemy nowe wpisy na podstawie realnych zgłoszeń i komunikatów z działów technicznych, aby jeszcze skuteczniej wspierać codzienną pracę użytkowników.

Opis zdarzenia:

Podczas uruchamiania aplikacji często pojawia się komunikat ostrzegawczy, na przykład:

Ostrzeżenie

Aplikacja IdoSell Bridge wykryła inną konfigurację komputera, niż jest wymagana do poprawnej pracy aplikacji:

Niezgodna wersja MS SQL Server
Próbujesz utworzyć bazę aplikacji IdoSell Bridge na wersji MS SQL Server, która nie jest obsługiwana. Masz aktualnie zainstalowaną wersję 15, a wymagana jest minimum MS SQL Server Express Edition 2008.

Rozwiązanie:

Bridge oficjalnie wspiera swoją wewnętrzną bazę danych (nie dotyczy to bazy systemu ERP) do wersji SQL Server Express 2016 (v13) włącznie.

W przypadku użycia nowszych wersji, takich jak SQL Server 2019 (v15) czy SQL Server 2022 (v16), podczas uruchamiania aplikacji może pojawić się informacyjny komunikat ostrzegawczy o niewspieranej wersji SQL.

Ten komunikat nie wpływa na działanie aplikacji ani synchronizację z panelem IdoSell i można go bezpiecznie zignorować.

Uwaga: Wersja SQL Server wykorzystywana przez system ERP może być dowolna — aplikacja Bridge nie zwraca na to uwagi.

Dla pełnej zgodności zalecamy wersję SQL Server 2016, jednak w większości przypadków nowsze wersje działają bezproblemowo.

Opis zdarzenia:

Podczas uruchamiania programu, wyskakuje komunikat:

Wykryliśmy, że z tą samą bazą danych jest skonfigurowana więcej niż jedna kopia programu IAI Bridge. 

Taka sytuacja występuję często po odtworzeniu danych z kopii zapasowej na innym, lub tym samym komputerze. Może również wystąpić np. po większej instalacji aktualizacji systemu operacyjnego Windows. 

Rozwiązanie:

Komunikat ma charakter wyłącznie informacyjny i nie wpływa na poprawność działania integracji, o ile rzeczywiście korzystają Państwo tylko z jednej instalacji aplikacji IdoSell Bridge połączonej z jedną bazą danych. 

Usunięcie tego komunikatu wymaga zdalnej interwencji serwisowej. W takim przypadku zdalne połączenie realizujemy bezpłatnie po wcześniejszym umówieniu terminu. Sugerujemy również wcześniejsze pobranie aplikacji  Microsoft Management Studio do zarządzania bazami danych, aby można było wykonać zapytanie. 

Samodzielne usunięcie komunikatu: 

Aby usunąć komunikat, sugerujemy wykonać poniższe zapytanie na bazie danych: 
 
delete from [iai_shop_bridge].[dbo].[app_settings] 
WHERE property='device_id'; 
 
To zapytanie usunie odpowiednią zmienną z tabeli. Po ponownym uruchomieniu aplikacji IdoSell Bridge zmienna zostanie odbudowana z nową, poprawną wartością. 

Przed wykonaniem jakichkolwiek zmian w bazie danych, sugerujemy wykonać kopię bezpieczeństwa Bridge.  

Opis zdarzenia:

Zdarza się, że po zmianach w środowisku systemowym (np. migracji, przywracaniu kopii zapasowej lub reinstalacji) konieczne jest ponowne uruchomienie kreatora połączeń w aplikacji IdoSell Bridge, aby na nowo wskazać bazy danych aplikacji i systemu ERP.

Rozwiązanie:

1. Zamknij aplikację IdoSell Bridge.

2. Przejdź do lokalizacji:
   C:\ProgramData\IAI\IAI-Shop.com Bridge

3. Zmień nazwę pliku DbConfig.xml – np. na DbConfigOld.xml.

4. Uruchom ponownie aplikację Bridge.

5. Zaloguj się do panelu IdoSell, podając login i hasło. Po udanym połączeniu kliknij „Dalej”.

6. Wybierz bazę danych aplikacji Bridge i połącz się z nią.

7. W kolejnym kroku wybierz swój system ERP i wskaż bazę danych ERP.

8. Po zakończeniu kreatora, aplikacja Bridge powinna uruchomić się poprawnie.

Wskazówki:

• Osoba konfigurująca połączenie powinna mieć uprawnienia administratora.

• Możliwie odznacz opcję „Użyj poświadczeń systemu Windows” i ręcznie wpisz dane dostępowe do bazy danych (np. login sa oraz odpowiednie hasło). Jest to bezpieczniejszy sposób na połączenie.

• Jeśli nie znasz danych dostępowych do baz danych Bridge i ERP, skontaktuj się z administratorem systemu w swojej firmie – to on powinien mieć dostęp do ścieżek oraz danych uwierzytelniających.

Kody integracyjne:

W aplikacji IdoSell Bridge kluczową rolę w poprawnym powiązaniu towarów pomiędzy systemem ERP a panelem IdoSell odgrywają kody integracyjne, czyli tzw. kody zewnętrznego systemu (KZS). Ich poprawna konfiguracja jest niezbędna do skutecznej synchronizacji danych.

Przypisanie kodów:

• Dla towarów bez wariantów (np. rozmiarów) — kod KZS przypisujemy bezpośrednio do towaru w panelu IdoSell.

• Dla towarów z wariantami (np. rozmiarami) — kod KZS przypisujemy do każdego wariantu osobno.

Przykłady dla najpopularniejszych systemów ERP:

• dla programu Subiekt GT i Subiekt Nexo jako kod zewnętrznego systemu należy wprowadzić wartość z kolumny Symbol

• dla programu Comarch ERP Optima jako kod zewnętrznego systemu należy wprowadzić wartość z kolumny Kod

• dla programu WAPRO Mag jako kod zewnętrznego systemu należy wprowadzić wartość kolumny Identyfikator produktu lub Indeks katalogowy w zależności od wyboru dokonanego podczas pierwszej konfiguracji IdoSell Bridge

• dla programu Enova365 .NET jako kod zewnętrznego systemu należy wprowadzić wartość z kolumny Kod

• dla programu Streamsoft Prestiż jako kod zewnętrznego systemu należy wprowadzić wartość z kolumny Indeks

WAŻNE:

• Nie zmieniaj kodów integracyjnych bez konsultacji!

Zmiana kodu KZS w panelu lub w systemie ERP bez odpowiednich działań po stronie aplikacji Bridge może spowodować:

• nadpisanie danych innych produktów,

• brak synchronizacji,

• błędy trudne do odwrócenia bez resetu i ponownej konfiguracji.

Opis zdarzenia:

Reset magazynów pozwala ponownie powiązać produkty między systemem ERP a panelem IdoSell. To kluczowe działanie w przypadku zmiany kodów integracyjnych lub rozbieżności w danych produktów.

Kiedy wykonać reset?

• Po zmianie kodów KZS w systemie ERP i/lub panelu.

• Gdy aplikacja nie rozpoznaje towaru, mimo jego poprawnej obecności po obu stronach.

• W przypadku wystąpienia błędów synchronizacji związanych z magazynami.

Uwaga przed resetem

1. Sprawdź, czy masz towary ignorowane
   Przejdź do zakładki: Towary -> Ignorowane.
   Jeśli masz tam produkty, zapisz listę lub zrób zrzut ekranu – po resecie ustawień magazynowych towary z tej listy trafią z powrotem do niesynchronizowanych i trzeba je będzie ręcznie oznaczyć jako ignorowane.

2. Sprawdź ustawienie automatycznego dodawania towarów
   Wejdź w: Preferencje synchronizacji -> Funkcje synchronizacji -> Synchronizacja towarów.
   Sprawdź, czy włączona jest opcja:
   ✅ „Automatyczne dodawanie towarów do listy synchronizowanych”
   Jeśli tak – Bridge po resecie sam doda produkty do listy synchronizowanych.
   Jeśli nie – będzie trzeba dodać towary ręcznie (lub włączyć tę funkcję tymczasowo po resecie).

Rozwiązanie:

1. Zapisz aktualne przypisania magazynów

Wejdź do: Preferencje synchronizacji -> Magazyny.
Zrób zrzut ekranu lub spisz przypisania (np. Magazyn M1 → Magazyn główny ERP).

2. Resetuj magazyny

1. W tej samej zakładce kliknij prawym przyciskiem na dowolny magazyn.

2. Wybierz: Resetuj ustawienia.

3. Uruchom ponownie aplikację Bridge.

✅ Efekt: Wszystkie towary znikną z list: synchronizowane, ignorowane, błędne → trafią do listy niesynchronizowanych.

3. Ponownie przypisz magazyny

1. Otwórz: Preferencje synchronizacji -> Magazyny.

2. Przypisz magazyny z panelu IdoSell do ERP (zgodnie z zapisanym wcześniej stanem).

3. Zaznacz checkbox przy każdej parze, aby włączyć synchronizację stanów.

4. Kliknij Zapisz.

4. Dodaj towary do synchronizacji

🔹 Jeśli masz włączone automatyczne dodawanie towarów:

Nic nie musisz robić – aplikacja Bridge sama doda towary z ERP do listy synchronizowanych na podstawie kodów KZS.

🔹 Jeśli nie masz włączonej tej funkcji:

Masz 2 opcje:

• Włącz automatyczne dodawanie:
  Preferencje synchronizacji -> Funkcje synchronizacji -> Synchronizacja towarów
  → zaznacz opcję „Automatyczne dodawanie towarów”.

• Lub dodaj ręcznie:
  Przejdź do: Towary -> Niesynchronizowane
  → zaznacz towary i kliknij Dodaj do synchronizowanych.

• Towary, które wcześniej były ignorowane, należy ponownie dodać do zakładki Ignorowane, jeśli mają być pomijane przez synchronizację.

Porada eksperta:

Jeśli planujesz zmienić kod KZS w ERP lub panelu, pamiętaj:

1. Najpierw usuń towar z listy synchronizowanych:
   Towary -> Synchronizowane → zaznacz produkt → Dodaj do niesynchronizowanych.

2. Zmień kod KZS w ERP i/lub panelu.

3. Dodaj produkt z powrotem do listy synchronizowanych (ręcznie lub automatycznie).

Opis zdarzenia:

W przypadku problemów z synchronizacją, błędów niepojawiających się na pierwszy rzut oka lub niestandardowych zachowań aplikacji IdoSell Bridge, dział wsparcia technicznego może poprosić o:

• kopię zapasową danych aplikacji Bridge,

• dziennik zdarzeń aplikacji Bridge.

Pliki te pozwalają na szczegółową analizę sytuacji i przyspieszają diagnozę problemu.

Jak przygotować wymagane pliki?

1. Wykonanie kopii zapasowej danych

1. Otwórz aplikację IdoSell Bridge.

2. Przejdź do: Narzędzia → Wykonaj kopię bezpieczeństwa danych.

3. Zapisz plik .zip w łatwo dostępnej lokalizacji (np. Pulpit).

2. Zapisanie dziennika zdarzeń

1. W aplikacji Bridge wybierz: Narzędzia → Dziennik zdarzeń.

2. Kliknij: Zapisz do pliku i wskaż lokalizację.

Problem z utworzeniem kopii? Komunikat o dzienniku systemowym?

Czasami przy próbie utworzenia kopii zapasowej pojawia się komunikat o zbyt dużym dzienniku zdarzeń systemowych Windows. Aby rozwiązać ten problem:

1. Otwórz menu Start i wpisz Podgląd zdarzeń, a następnie uruchom aplikację.
   (lub wejdź przez: Panel sterowania → System i zabezpieczenia → Narzędzia administracyjne → Podgląd zdarzeń)

2. W lewym menu kliknij prawym przyciskiem na „Dzienniki systemu Windows” → wybierz Zastosuj do wszystkich dzienników: Wyczyść dziennik.

3. Wybierz opcję Zapisz i wyczyść, a następnie zapisz plik (np. na Pulpicie).

4. Wróć do aplikacji Bridge i spróbuj ponownie wykonać kopię zapasową.

Jak przesłać pliki?

Z uwagi na rozmiar plików sugerujemy ich przesłanie za pomocą zewnętrznych serwisów, takich jak:

• Google Drive (upewnij się, że dostęp mają wszyscy posiadający link),

• OneDrive

• WeTransfer (opcja "Get transfer link", bez wysyłki na e-mail).

Dla bezpieczeństwa możesz:

- Można zabezpieczyć archiwum ZIP hasłem (np. Bridge2024),

- Hasło oraz link najlepiej dołączyć bezpośrednio w treści zgłoszenia,

- Opcjonalnie można ustawić termin wygaśnięcia linku (np. 7 dni).

Pliki prosimy nie przesyłać jako załączników mailowych – każdorazowo korzystaj z linku do zewnętrznego źródła i wysyłaj link w ramach zgłoszenia.

Opis zdarzenia:

Jeśli po synchronizacji zamówienie nie zawiera w panelu flagi API, oznacza to, że nie zostało zarejestrowane przez aplikację Bridge.

W pierwszej kolejności warto przejść do zakładki „Pominięte” w aplikacji Bridge i sprawdzić, czy dane zamówienie się tam znajduje. Po kliknięciu w przycisk „Informacje” można odczytać powód, dla którego zamówienie nie zostało przetworzone – w wielu przypadkach możliwe jest ponowne jego zarejestrowanie, jak pokazuje poniższy zrzut ekranu:

Jeśli zamówienia nie ma w zakładce „Pominięte”, możliwe przyczyny:

• Błąd synchronizacji, który został zapisany w dzienniku zdarzeń aplikacji
  (Narzędzia → Dziennik zdarzeń) – w takim przypadku zalecane jest samodzielne sprawdzenie logu lub jego przesłanie do działu technicznego (najlepiej z dołączoną kopią zapasową aplikacji).

• Nieprawidłowo zapisana data ostatniej synchronizacji – może się zdarzyć, gdy synchronizacja została przerwana przez awarię prądu, utratę połączenia z internetem lub ręczne zatrzymanie aplikacji. W wyniku takiego zdarzenia Bridge może pominąć zamówienie, które wpłynęło w tzw. „luce czasowej”.

Rozwiązanie:

1. Otwórz: Preferencje synchronizacji.

2. Na dole okna, w sekcji „Ustawienia daty i czasu ostatniej synchronizacji”, ustaw datę wcześniejszą niż moment złożenia zamówienia (np. o jeden dzień wstecz).

3. Zapisz zmiany.

Zrzut z ekranu (przykład cofnięcia czasu synchronizacji w Bridge):

Po zapisaniu zmian wystarczy uruchomić synchronizację ręcznie (Narzędzia → Synchronizuj dane z panelem) lub poczekać na synchronizację automatyczną. Pominięte wcześniej zamówienia zostaną przetworzone, otrzymają flagę API i zostaną przesłane do systemu ERP.

Porada eksperta:

Aby uniknąć sytuacji, w której zamówienie nie zostaje zarejestrowane przez Bridge, zalecamy:

Przed wyłączeniem lub uśpieniem komputera (hibernacją) zawsze sprawdzić, czy aplikacja Bridge nie prowadzi aktywnej synchronizacji.

Jeśli widnieje komunikat o trwającej synchronizacji, na dolnym pasku aplikacji Bridge, należy poczekać do jej zakończenia. Powinna widnieć wtedy informacja "Program oczekuje na kolejną synchronizację" - to jest znak, że możemy spokojnie zamknąć system.

Przerwanie pracy komputera w trakcie synchronizacji może skutkować powstaniem tzw. luki czasowej – aplikacja zapisze błędny czas ostatniego połączenia z panelem, co uniemożliwi późniejsze pobranie niektórych zamówień i może wymagać ręcznego cofania czasu synchronizacji.

Opis zdarzenia:

Przycisk „Zatrzymaj synchronizację” służy do ręcznego zatrzymania aktywnej synchronizacji danych pomiędzy systemem ERP a panelem IdoSell. Powinniśmy jednak pamiętać, że użycie tego przycisku w nieodpowiednim momencie – np. w trakcie przesyłania danych, przy utracie połączenia z internetem lub przy nagłym wyłączeniu komputera – może doprowadzić do zablokowania procesu synchronizacji. Objawem takiej sytuacji jest zawieszenie się Bridge’a w stanie „zatrzymywania” bez końca.

Rozwiązanie:

1. Połącz się z bazą danych Bridge

Do wykonania operacji potrzebne będzie narzędzie takie jak np. SQL Server Management Studio (SSMS) – można je pobrać bezpłatnie ze strony Microsoft :

• Uruchom SSMS i kliknij Połącz.

Wybierz odpowiedni serwer z bazą danych aplikacji Bridge.
Sprawdź w narzędziu Usługi w systemie, jak nazywa się instancja bazy danych, przykład MSSQL$IAIBRIDGE.

• Połącz się z bazą iai_shop_bridge.

2. Odblokuj synchronizację

Przejdź do zapytania SQL i uruchom poniższe polecenie:

UPDATE [iai_shop_bridge].[dbo].[app_settings]
SET value = 0
WHERE property = 'sync_status' AND value = 5;

To polecenie zmienia status synchronizacji z „trwa zatrzymywanie” (5) na „gotowe” (0) i pozwala ponownie uruchomić Bridge bez zawieszenia.

Jeśli po wykonanej akcji synchronizacja nie będzie mogła się uruchomić, rekomendujemy uruchomić ponownie aplikację Bridge.

Alternatywnie możesz:

• rozwinąć bazę iai_shop_bridge,

• przejść do tabeli dbo.app_settings,

• kliknąć prawym przyciskiem -> Edit Top 200 Rows,

• odszukać wiersz z kolumną property = sync_status,

• zmienić value z 5 na 0,

• zatwierdzić zmiany klawiszem Enter.

Porada eksperta:

Zatrzymywanie synchronizacji może wpływać na spójność danych w bazie aplikacji Bridge. Dlatego przed wykonaniem jakichkolwiek operacji w bazie danych zaleca się wykonanie kopii zapasowej Bridge, np. poprzez narzędzie SSMS, jeśli Bridge będzie zablokowany.

Opis zdarzenia:

Podczas synchronizacji cen z programu F/K do panelu IdoSell, aplikacja Bridge może się zatrzymać (timeout), gdy na towarze jest włączony automat do wyliczania ceny,

Objawy:

• Proces synchronizacji nie kończy się lub zawiesza aplikację,

• Kontrola towarów ("Bridge" -> "Towary" -> "Kontrola towarów") zawiesza proces,

• W aplikacji Bridge pojawia się komunikat o braku połączenia z panelem sklepu (czerwony komunikat),

• Synchronizacja cen w ogóle się nie rozpoczyna lub blokuje pozostałe procesy synchronizacji.

Rozwiązanie:

Sprawdź w ustawieniach towarów, czy wszystkie aktywne automaty do cen mają zdefiniowaną formułę wyliczania.

Jeśli nie — dezaktywuj automat lub uzupełnij regułę.

Ścieżka: "Edycja towaru" -> "Ceny" -> "Tryb wyliczania ceny"

Dlaczego to ważne?
Zdarza się, że automatyczne wyliczanie cen w panelu uniemożliwia poprawne działanie Bridge’a, co może prowadzić do zawieszenia synchronizacji oraz problemów z komunikacją z panelem IdoSell.
Ponieważ błąd nie zawsze jest jednoznacznie identyfikowany, warto w pierwszej kolejności wykluczyć ten scenariusz.