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.

Rozwiązanie:

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

W przypadku użycia wersji SQL Server innych niż wspierane (2016, 2019 lub 2022), 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.

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.

Opis zdarzenia:

W przypadku konieczności przeniesienia aplikacji IdoSell Bridge na nowy komputer, należy uwzględnić wersję SQL Server, na której działa baza aplikacji. W zależności od sytuacji, istnieją dwa możliwe scenariusze:

Rozwiązanie:

Na początku powinniśmy sprawdzić subskrypcję. Najlepiej anulować obecną i dodać nową, aby można było skorzystać z Bridge na innym komputerze. Ewentualnie sugerujemy kontakt z działem wsparcia w celu resetu subskrypcji na inny komputer.

Zarządzać licencjami możemy, przechodzać do:

"Apps -> Lista subskrypcji -> IdoSell Bridge"

SCENARIUSZ 1: Ta sama wersja SQL Server na obu komputerach (np. SQL 2016)

W tym przypadku możliwe jest pełne odtworzenie aplikacji Bridge, łącznie z historią zamówień i konfiguracją, poprzez wgranie kopii zapasowej.

1. Wyczyść dziennik aplikacji (opcjonalnie, ale zalecane)

Aby uniknąć kłopotów z tworzeniem kopii zapasowej poprzez dużą ilość danych, warto wyczyścić dziennik Bridge:

• Otwórz: Podgląd zdarzeń → Dzienniki aplikacji i usług → IAI BRIDGE

• Kliknij prawym przyciskiem na „IAI BRIDGE” i wybierz „Wyczyść dziennik”

2. Utwórz kopię zapasową na komputerze, z którego będą przenoszone dane

• Otwórz aplikację Bridge → Narzędzia → Wykonaj kopię bezpieczeństwa danych

• Zapisz plik .zip w bezpiecznym miejscu

Kopia zawiera pełną konfigurację i bazę danych Bridge

Dobra praktyka: wykonaj zrzuty ekranu z ustawień aplikacji – dla bezpieczeństwa

3. Zainstaluj aplikację Bridge na nowym komputerze

• Pobierz instalator z panelu:
  "Apps -> Lista subskrypcji -> IdoSell Bridge -> Zarządzaj licencjami -> Windows"

• Uruchom instalator i użyj tej samej wersji SQL Server

• Wprowadź dane logowania do panelu

• Wskaż bazę danych Bridge (domyślnie np. .\IAIBRIDGE) oraz połącz z ERP (Instrukcja Konfiguraca wstępna )

4. Odtwórz kopię zapasową

• Otwórz aplikację → Narzędzia → Odtwórz dane z kopii zapasowej

• Wskaż utworzony plik .zip i poczekaj na zakończenie procesu

Jeśli wszystko przebiegnie pomyślnie – aplikacja zostanie uruchomiona z zachowaną konfiguracją i historią zamówień.

W przypadku braku towarów w zakładce "Synchronizowane" zalecany jest reset ustawień magazynowych .

Jeśli baza Bridge nie odtworzy się na urządzenie spróbuj odtworzyć ustawienia z pliku .

SCENARIUSZ 2: Różne wersje SQL Server (np. stara SQL 2016 → nowa SQL 2022)

W tym przypadku odtworzenie bazy danych nie będzie możliwe – instalator SQL utworzy nową bazę, a kopia może nie zostać zaakceptowana z powodu niezgodności wersji.

1. Wykonaj zrzuty ekranu z konfiguracji aplikacji Bridge

Przed migracją wykonaj zrzuty wszystkich zakładek w:

• Preferencje synchronizacji

• Ustawienia programu

Bez tego odtworzenie konfiguracji ręcznie będzie trudne lub niemożliwe.

2. Zainstaluj aplikację Bridge na nowym komputerze

• Pobierz instalator jak w scenariuszu pierwszym

• Przejdź kreator i stwórz nową bazę danych (Instrukcja Konfiguraca wstępna )

• Połącz się z panelem oraz bazą ERP

3. Odtwórz konfigurację ręcznie

Skorzystaj z zapisanych zrzutów lub:

• Przejdź do: Instrukcja odtwarzania ustawień

• Z poziomu panelu IdoSell ustaw wszystkie parametry aplikacji zgodnie z poprzednią konfiguracją

Instrukcja odtwarzania ustawień może nie zadziałać na innej wersji SQL.

WAŻNE – ograniczenia po ręcznym odtworzeniu konfiguracji:

• Nie będzie historii zamówień – Bridge nie zna wcześniejszych danych

• Nie zadziałają zwroty(korekty), czy zmiany statusów dla starych zamówień

• Synchronizacja wznowi się dopiero od nowej, wskazanej daty

• Cofając datę synchronizacji możemy pobrać duplikaty zamówień, ponieważ Bridge nie będzie posiadał zamówień w bazie

Porada eksperta:

Jeśli tylko to możliwe – utrzymuj tę samą wersję SQL Server na obu komputerach. To umożliwia pełną migrację z zachowaniem historii i danych.

Jeżeli nie masz pewności, jaką wersję SQL posiadasz, uruchom:

SELECT @@VERSION

w narzędziu Microsoft SQL Server Management Studio (SSMS), wybierając przedtem bazę Bridge.

Opis zdarzenia:

Podczas próby utworzenia nowej bazy danych programu IdoSell Bridge może pojawić się komunikat błędu:

„Wystąpił błąd podczas tworzenia nowej bazy danych programu IdoSell Bridge. Zgłoś odpowiedni komunikat w tej sprawie do działu wsparcia IdoSell. Program IdoSell Bridge zostanie teraz zamknięty.”

Przy połączeniu bazy (poprzednim kroku), często będzie w tym przypadku widoczny komunikat ostrzegawczy:

„Ostrzeżenie – sp_databases.Count == 0. Może to spowodować problemy z połączeniem z Serwerem SQL, proszę przekazać ten komunikat obsłudze IAI.”

Przyczyna:

Błąd pojawia się, gdy konto użytkownika, którego dane zostały wpisane w kreatorze Bridge, nie posiada odpowiednich uprawnień do tworzenia bazy danych na wskazanym serwerze SQL. Najczęściej konto ma jedynie prawa do odczytu, bez możliwości zapisu lub modyfikacji struktury bazy.

Rozwiązanie:

1. Zamknij aplikację Bridge i uruchom ją ponownie jako administrator.

2. W kreatorze połączenia wpisz login sa (lub inne konto z uprawnieniami administratora SQL Server) oraz poprawne hasło.

3. Alternatywnie:

   • Otwórz SQL Server Management Studio (SSMS),

   • Spróbuj ręcznie połączyć się z serwerem,

   • Jeśli połączenie się uda, spróbuj utworzyć nową bazę, lub edytować istniejącą — to pozwoli zweryfikować, czy użytkownik ma odpowiednie prawa (zapis + odczyt).

4. Jeśli nadal nie masz dostępu do operacji zapisu:

   • Skontaktuj się z osobą zarządzającą serwerem SQL w Twojej organizacji.

   • Poproś o nadanie uprawnień dbcreator lub db_owner dla konta SQL używanego przez Bridge.

Porada eksperta:

Najbezpieczniej jest instalować aplikację IdoSell Bridge na tym samym komputerze, na którym działa instancja SQL Server, zawierająca bazę danych Bridge. Dzięki temu nie występują ograniczenia sieciowe i te dotyczące uprawnień, typowe dla zdalnych połączeń z serwerem.

Rekomendujemy używać loginu (sa) do bazy danych (bez poświadczeń Windows). Ten użytkownik tworzy się przeważnie przy instalacji nowej bazy danych i posiada wszystkie uprawnienia.

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. Przejdź do punktu trzeciego.

✅ 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

W trakcie pracy z IdoSell Bridge może się zdarzyć, że stany magazynowe lub ceny w sklepie nie odpowiadają wartościom z systemu ERP. Zanim zgłosimy problem do wsparcia, warto samodzielnie sprawdzić, czy proces synchronizacji działa poprawnie i czy towar w ogóle jest objęty synchronizacją.

Rozwiązanie

Krok 1 – Sprawdzenie, czy działa synchronizacja

• Wejdź do aplikacji IdoSell Bridge.

• W prawym panelu bocznym znajdziesz:

  • Czas ostatniej synchronizacji

  • Czas kolejnej synchronizacji (jeśli włączono automatyczną synchronizację).

• Jeżeli czas znacząco odbiega od bieżącego:

  • wykonaj synchronizację ręczną: Narzędzia → Synchronizuj dane z panelem,

  • lub uruchom automat w: Preferencje synchronizacji → Automatyczna synchronizacja.

• Jeśli automat nie startuje, skorzystaj z instrukcji: Brak uruchomionej automatycznej synchronizacji .

Krok 2 – Sprawdzenie, czy towar jest synchronizowany

• W panelu sklepu znajdź towar i skopiuj wartość z pola Kod zewnętrznego systemu.

• W Bridge przejdź do Towary → Synchronizowane.

• Wybierz magazyn, wklej kod w wyszukiwarkę i kliknij Szukaj.

• Jeżeli towar się wyświetla – w kolumnie zobaczysz stan dyspozycyjny z ERP (już pomniejszony o rezerwacje).

• Dla pewności porównaj go z zakładką Magazyn w edycji towaru w panelu.

• Jeśli wartości są różne → sprawdź dziennik zdarzeń lub prześlij jego kopię do wsparcia: Kopia aplikacji Bridge i dziennik zdarzeń .

• Jeżeli towar nie wyświetla się w „Synchronizowanych”:

  • sprawdź w zakładce Towary → Niesynchronizowane i dodaj go ręcznie,

  • lub poczekaj na automat.

• Jeśli towaru nie ma w żadnej zakładce, oznacza to zmianę lub utratę kodu integracyjnego — wykonaj: Reset ustawień magazynowych Bridge .

Krok 3 – Weryfikacja ceny

• Jeżeli towar jest synchronizowany, ale cena się nie pojawia:

  1. Sprawdź w Bridge w Preferencje synchronizacji → Ceny, jaki cennik jest przypisany.

  2. W systemie ERP upewnij się, że towar posiada cenę w tym cenniku.

  3. W panelu sklepu w edycji towaru → zakładka Ceny sprawdź, czy nie ustawiono ceny minimalnej wyższej niż cena z ERP (panel nie przyjmie ceny niższej niż minimalna).

• Jeśli cena wygląda poprawnie, a dalej się nie aktualizuje, sprawdź dziennik zdarzeń lub wyślij kopię aplikacji Bridge i logi do wsparcia.

Porada eksperta

Najczęstsze rozbieżności wynikają z:

• różnicy między stanem magazynowym a stanem dyspozycyjnym (w panelu widoczny jest stan dyspozycyjny, pomniejszony o rezerwacje z ERP),

• błędnie przypisanego kodu zewnętrznego systemu,

• ustawionej w panelu ceny minimalnej, która blokuje wgranie niższej ceny z ERP.

Dlatego zawsze najpierw sprawdź, czy towar jest na liście synchronizowanych, a następnie porównaj stan/cenę między ERP, Bridge i panelem.

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.

Opis zdarzenia:

Po zainstalowaniu aplikacji IdoSell Bridge i skonfigurowaniu połączenia z systemem ERP, niektóre instalacje nie rozpoczynają automatycznej synchronizacji. Najczęściej dzieje się tak w środowiskach z dodatkowymi zabezpieczeniami lub tam, gdzie komputer z aplikacją Bridge znajduje się w domenie Active Directory (AD), a uruchamianie usług systemowych wymaga wskazania konta użytkownika domenowego.

Brak poprawnej konfiguracji usługi Windows skutkuje brakiem synchronizacji automatycznej, mimo że ręczne uruchomienie Bridge działa prawidłowo.

Rozwiązanie:

1. Zamknij aplikację IdoSell Bridge.

2. Otwórz systemową konsolę usług Windows (skrót: services.msc).

3. Znajdź usługę: IAI-Shop.com Bridge Service.

4. Kliknij prawym przyciskiem → Właściwości → zakładka „Logowanie”.

5. Wybierz opcję „To konto” i wpisz pełną nazwę użytkownika domenowego w formacie DOMENA\Użytkownik oraz hasło.

6. Zapisz zmiany.

Następnie:

1. Uruchom aplikację IdoSell Bridge jako administrator.

2. Przejdź do: Preferencje synchronizacji → Użytkownik.

3. Wprowadź dokładnie ten sam login i hasło, co w konfiguracji usługi.

4. Przejdź do: Preferencje synchronizacji → Automatyczna synchronizacja → Ustawienia automatycznej synchronizacji.

5. Zmień tryb na „Konto użytkownika Windows” i wpisz te same dane.

6. Kliknij przycisk Uruchom usługę i zapisz zmiany.

Po wykonaniu powyższych kroków usługa będzie uruchamiana automatycznie zgodnie z harmonogramem oraz np. uprawnieniami domenowymi.

Porada eksperta:

W środowiskach z domeną AD, gdzie polityki zabezpieczeń blokują uruchamianie usług systemowych przez użytkownika lokalnego, konieczne jest jawne podanie danych konta domenowego w konfiguracji usługi i samej aplikacji. W przeciwnym razie Bridge nie będzie mógł uruchomić automatycznej synchronizacji, nawet jeśli wszystko inne zostało skonfigurowane poprawnie.

Opis zdarzenia

Może wystąpić sytuacja, w której w IdoSell Bridge:

• czas ostatniej synchronizacji się aktualizuje,

• automatyczna i ręczna synchronizacja uruchamiają się poprawnie,
  ale w rzeczywistości dane nie są odświeżane w panelu.

W dzienniku zdarzeń mogą pojawiać się ostrzeżenia typu:

• „Cannot open database 'iai_shop_bridge' requested by the login. The login failed.”

• „Właściwość ConnectionString nie została zainicjowana.”

Oznacza to, że Bridge nie ma pełnych uprawnień do połączenia z bazą danych i nie może przeprowadzić synchronizacji.

Rozwiązanie

1) Sprawdź ustawienia połączeń w Bridge

• Wejdź do: Ustawienia programu → Program IdoSell Bridge → Konfiguracja połączenia z serwerem SQL bazy danych programu IdoSell Bridge.

• Upewnij się, że są tam poprawne dane dostępowe do SQL z pełnym dostępem.

• Następnie sprawdź: Ustawienia programu → Program {ERP} → Połączenie z bazą danych programu {ERP} (np. Połączenie z bazą programu Subiekt Nexo).

2) Wyłącz całkowicie aplikację

3) Uruchom Bridge jako administrator

• Kliknij prawym przyciskiem ikonę Bridge → Właściwości → Zgodność.

• Zaznacz: Uruchom ten program jako administrator.

• Zastosuj zmiany i uruchom ponownie aplikację.

Samo potwierdzenie przy starcie Bridge („Czy chcesz zezwolić tej aplikacji...”) nie oznacza uruchomienia w trybie administratora – konieczne jest ustawienie tej opcji we właściwościach.

4) Wyłącz blokady antywirusa

• Jeśli na komputerze działa oprogramowanie antywirusowe, dodaj Bridge do listy zaufanych programów.

Aktualizacja IdoSell Bridge może przywrócić domyślne ustawienia zgodności.

Po każdej aktualizacji sprawdź ponownie, czy opcja „Uruchom jako administrator” jest nadal aktywna.

Porada eksperta

Jeśli czas synchronizacji w Bridge się zmienia, ale nie widzisz zmian w panelu, oznacza to, że program nie ma faktycznego dostępu do bazy danych. W pierwszej kolejności zawsze upewnij się, że:

• połączenia do baz są poprawnie skonfigurowane,

• aplikacja uruchamia się zawsze w trybie administratora,

• żadne oprogramowanie ochronne nie blokuje działania Bridge.

Dzięki temu masz pewność, że proces synchronizacji przebiega w pełni i faktycznie aktualizuje dane.

Opis zdarzenia:

IdoSell Bridge nie obsługuje synchronizacji stanów magazynowych dla magazynu przedsprzedaży (MP), który jest częścią wbudowanej gospodarki magazynowej IdoSell. Systemy ERP z reguły nie mają odpowiednika takiego magazynu lub nie obsługują dat dostawy odsuniętych w czasie.

Bridge nie pobiera informacji o przyszłych dostawach i nie synchronizuje stanów z magazynów typu MP – z uwagi na ich wirtualny charakter.

Rozwiązanie:

Aby skutecznie obsługiwać przedsprzedaż z pomocą Bridge, można wykorzystać magazyn M0 (obcy), a dostępność produktów ustawiać ręcznie:

1. Przejdź do: Edycja towaru → Magazyn.

2. Dodaj produkt do magazynu M0 za pomocą przycisków Dodaj produkty lub Odejmij produkty.

3. Skonfiguruj czas realizacji:

   • domyślnie – z poziomu: Produkty → Atrybuty → Lista dostawców,

   • indywidualnie – w zakładce Edycja towaru → Magazyn → Sprowadzenie towaru na zamówienie → Czas dostawy.

Alternatywnie, możesz użyć modułu aktualizacji webowej w panelu IdoSell, by hurtowo przypisać stany na M0, lub aplikacji Downloader .

Efekt:
Klient widzi w sklepie informacje o wydłużonym czasie realizacji – wynikającym z konfiguracji dostawcy i magazynu, ale samo zamówienie nie korzysta z MP, tylko z magazynu M0, który jest kompatybilny z systemem ERP i aplikacją Bridge.

Porada eksperta:

Synchronizacja z Bridge nie wspiera przedsprzedaży wprost, ale można ją odwzorować, przypisując towary do magazynu M0 i ustawiając dłuższy czas dostawy ręcznie. W razie potrzeby można modyfikować czas realizacji w karcie dostawcy codziennie – to pozwala na dynamiczne zarządzanie ofertą przedsprzedażową.

Opis zdarzenia:

Zamówienia na produkty realizowane w sklepie z magazynu M0 (magazynu obcego) mogą być przekazywane do systemu ERP za pośrednictwem aplikacji IdoSell Bridge. Należy jednak pamiętać, że Bridge nie synchronizuje stanów magazynowych dla M0 – obsługuje wyłącznie przepływ zamówień.

Rozwiązanie:

Aby poprawnie obsługiwać zamówienia z magazynu M0:

1. Przejdź do: Preferencje synchronizacji → Magazyny.

2. W tej sekcji przypisz magazyn z ERP (np. Magazyn pomocniczy) do obsługi zamówień z magazynu M0.

3. Zapisz konfigurację.

Efekt:
Od tej pory każde zamówienie z M0 zostanie przesłane do ERP z informacją o przypisanym magazynie, do którego ma trafić produkt. Sam magazyn M0 nie jest jednak źródłem synchronizowanych stanów. Stany magazynowe są aktualizowane tylko na podstawie przypisanych magazynów własnych.

Porada eksperta:

Jeśli zależy Ci na synchronizacji stanów magazynowych na M0, możesz do tego użyć aplikacji Downloader , lub modułu aktualizacji webowej , pobierając z pliku dane na temat dostępności towarów na zamówienie.

Zamówienia z M0 zostaną poprawnie przesłane do ERP tylko wtedy, gdy konfiguracja magazynów została ustawiona w zakładce Preferencje synchronizacji. Upewnij się, że każdemu magazynowi panelowemu przypisano jego odpowiednik w ERP – w przeciwnym razie zamówienia mogą trafić do zakładki Pominięte z komunikatem o braku powiązanego magazynu.

Opis zdarzenia:

W wielu przypadkach klienci zaznaczają w trakcie zakupów, że chcą otrzymać fakturę VAT. Sklepy potrzebują, aby taka informacja została automatycznie przekazana do systemu ERP razem z zamówieniem. Standardowo Bridge nie tworzy automatycznie faktur — może jednak przesłać tę informację jako notatkę, którą system ERP może wykorzystać w dalszym procesie sprzedażowym.

Rozwiązanie:

Aby automatycznie dodać informację o fakturze VAT do uwag w zamówieniu przesyłanym przez IdoSell Bridge, należy użyć tzw. bloków zdarzeniowych if:

Krok 1 – Wejście do konfiguracji bloków zdarzeniowych

• Otwórz panel administracyjny IdoSell

• Przejdź do: Apps → Aplikacje pomocnicze → Konfiguracja Bridge → Bloki zdarzeniowe if

Krok 2 – Dodanie nowego bloku

Dodaj poniższy kod:

[iai:if_client_invoice-begin]
Proszę o fakturę VAT
[iai:if_client_invoice-end]

Jeśli klient podczas składania zamówienia zaznaczy opcję faktury VAT, Bridge doda do pola z uwagami tekst: „Proszę o fakturę VAT”
Dzięki temu operator w ERP będzie wiedział, że dokument sprzedaży powinien mieć formę faktury VAT.

Jeśli klient nie zaznaczy tej opcji – notatka nie zostanie dodana.

Porada eksperta:

• Tekst „Proszę o fakturę VAT” możesz zmodyfikować lub rozbudować, np. dodając inne znaczniki identyfikujące typ klienta lub źródło zamówienia.

• W przypadku potrzeby bardziej zaawansowanej logiki — np. generowania różnego typu dokumentów sprzedaży w zależności od danych klienta — zalecane jest wdrożenie Bridge w Uniwersalnym Trybie Pracy (UDB) .

Opis zdarzenia:

W niektórych zamówieniach składanych przez klientów dane nabywcy (fakturowe) różnią się od danych odbiorcy (adres dostawy). Takie sytuacje są typowe m.in. dla zamówień firmowych, gdzie zakupy są fakturowane na dane spółki, a dostawa realizowana do oddziału, sklepu czy konkretnego pracownika.

W celu automatycznego przekazania obu zestawów danych do systemu ERP, można wykorzystać mechanizm notatek do zamówienia oraz bloków zdarzeniowych dostępnych w konfiguracji aplikacji IdoSell Bridge.

Rozwiązanie:

Aby w notatce do zamówienia przekazać komplet danych nabywcy i odbiorcy, sugerujemy:

1. Otworzyć panel administracyjny IdoSell.

2. Przejść do:
   Apps → Aplikacje pomocnicze → Konfiguracja Bridge → Bloki zdarzeniowe if

3. Dodać poniższy blok:

[iai:if_different_payer_address-begin]

Adres odbiorcy:
[iai:deliveryaddr_address]
[iai:deliveryaddr_city]
[iai:deliveryaddr_company_name]
[iai:deliveryaddr_country]
[iai:deliveryaddr_country_code]
[iai:deliveryaddr_firstname]
[iai:deliveryaddr_lastname]
[iai:deliveryaddr_phone]
[iai:deliveryaddr_zip]

Adres nabywcy:
[iai:payer_address_address]
[iai:payer_address_city]
[iai:payer_address_company_name]
[iai:payer_address_country]
[iai:payer_address_country_code]
[iai:payer_address_firstname]
[iai:payer_address_lastname]
[iai:payer_address_phone]
[iai:payer_address_tax_number]
[iai:payer_address_zip]

[iai:if_different_payer_address-end]

Powyższy blok spowoduje, że w notatce zamówienia (wysyłanej przez Bridge do ERP) pojawią się szczegółowe dane nabywcy i odbiorcy, ale tylko wówczas, gdy adresy te są różne.

Dzięki temu operator w ERP może łatwo zidentyfikować oba zestawy danych bez konieczności wchodzenia do panelu sklepu.

Pobieranie danych z panelu:

Dane nabywcy pobierają się z pkt1, z pkt2 zaś dane odbiorcy. Poniżej grafika:

Porada eksperta:

W zależności od potrzeb możesz zastosować dwa rozwiązania:

1. Ręczne przypisywanie danych w ERP
Po otrzymaniu zamówienia z notatką (uwagami) zawierającą oba zestawy danych, operator ręcznie ustawia dane nabywcy i odbiorcy w ERP (np. podczas wystawiania faktury lub dokumentu WZ).

2. Automatyzacja po stronie ERP
W przypadku większej liczby zamówień warto zlecić informatykowi obsługującemu system ERP stworzenie skryptu, który automatycznie:

• analizuje treść notatki w zamówieniu,

• wyciąga dane nabywcy i odbiorcy,

• przypisuje je do odpowiednich pól zamówienia w bazie ERP.

Dzięki temu możliwe będzie zautomatyzowanie całego procesu do momentu wystawienia dokumentu.

Można również dodać uproszczoną wersję komunikatu, np.:

[iai:if_different_payer_address-begin]
Zamówienie zawiera inne dane nabywcy niż odbiorcy
[iai:if_different_payer_address-end]

W ten sposób informacja o różnicy danych zostanie przekazana do ERP w formie krótkiej notatki – bez wyświetlania pełnych adresów.

Podsumowując, dodając tekst między [iai:if_different_payer_address-begin], a [iai:if_different_payer_address-end] wyświeli się on w uwagach zamówienia systemu ERP. Notatka zawsze dodaje się w momencie dodawania zamówienia do programu FK i nie jest aktualizowana.

Opis zdarzenia:

W systemach ERP często istotne jest, aby poprawnie rejestrować informacje o wpłatach za zamówienia. IdoSell Bridge umożliwia automatyczne przekazywanie tych informacji, jednak działa według jasno zdefiniowanej logiki, która może powodować nieporozumienia – szczególnie w przypadku zamówień za pobraniem.

Mechanizm działania synchronizacji wpłat:

Aplikacja IdoSell Bridge sprawdza, czy wpłata w zamówieniu posiada status „Przyjęta”.

• ✅ Jeśli wpłata ma status „Przyjęta” – informacja o niej zostanie przesłana do ERP (np. Subiekta), a dokument otrzyma odpowiednią formę płatności.

• ❌ Jeśli wpłata ma inny status niż „Przyjęta” – Bridge nie przekaże żadnej informacji o wpłacie i forma płatności nie zostanie zapisana.

Uwaga: Mechanizm ten jest standardowy i nie podlega zmianie – chyba że sklep korzysta z Uniwersalnego Trybu Pracy (UDB), gdzie samemu można zaprogramować własną logikę w łączniku pomiędzy bazą pośrednią, a systemem ERP.

Jak sprawdzić status wpłaty w panelu IdoSell?

1. Przejdź do: Zamówienia → Edycja zamówienia

2. Otwórz zakładkę „Wpłaty”

3. Kliknij „Zobacz szczegóły”

4. Sprawdź, czy status wpłaty to „Przyjęta”

Poniżej instrukcja graficzna:

Zamówienia za pobraniem – jak przekazać informację do ERP?

W przypadku zamówień z opcją pobrania, nie dochodzi do żadnej wpłaty w panelu – dlatego synchronizacja wpłat przez Bridge nie zostaje wywołana, chyba że zostanie przyjęta w panelu.

Aby poinformować dział księgowości lub operatora ERP, że dane zamówienie jest za pobraniem, można przyjąć wpłatę, jak na powyższych zrzutach z ekranu, albo wykorzystać notatkę dodawaną automatycznie do zamówienia:

Konfiguracja w aplikacji Bridge:

1. Przejdź do:
   Apps → Aplikacje pomocnicze → Konfiguracja Bridge

2. W sekcji Bloki zdarzeniowe if dodaj następujący wpis:

[iai:if_dsp-begin]
Zamówienie za pobraniem
[iai:if_dsp-end]

Efekt:

Każde zamówienie z opcją pobrania zostanie automatycznie opatrzone notatką:

Zamówienie za pobraniem

Dzięki temu pracownicy magazynu lub księgowości będą mieli jasną informację, że dokument powinien zostać ręcznie oznaczony jako pobranie w ERP – nawet jeśli system nie otrzymał informacji o wpłacie.

Porada eksperta:

• W systemie ERP forma płatności pobranie nie bazuje na zrealizowanej wpłacie, lecz na deklaracji klienta – dlatego nie jest technicznie „wpłatą”.

• Dobrą praktyką jest oznaczanie takich zamówień notatką, aby nie dochodziło do błędnych interpretacji danych w ERP, lub dodawanie wpłat do pobrania w panelu.

• Jeżeli Twoja firma potrzebuje automatycznego tworzenia odpowiednich dokumentów sprzedaży na podstawie typu płatności – rozważ wdrożenie Bridge w trybie Uniwersalnym (UDB) .

Opis zdarzenia:

W aplikacji IdoSell Bridge poszczególne moduły, takie jak Towary, Zamówienia, Wpłaty, Klienci czy Zwroty, mogą zawierać zakładki z błędnymi elementami. Przykładowo:

• Towary → Błędne

• Zamówienia → Błędne

• Wpłaty → Błędne itd.

• Klienci → Błędni

• Zwroty → Błędne

Każda nieprzetworzona pozycja w tych zakładkach jest traktowana przez mechanizm synchronizacji jako element wymagający ponownej próby przesłania. Jeśli tych elementów jest dużo, może to znacząco spowolnić działanie aplikacji – Bridge będzie za każdym razem próbował przetworzyć te same błędne dane.

Rozwiązanie:

Jeśli dana pozycja przez dłuższy czas nie może zostać zsynchronizowana (np. z powodu braku powiązania z systemem ERP), sugerujemy jej usunięcie lub przeniesienie do ignorowanych:

Przejdź do zakładki z błędnymi danymi, np.:

• Zamówienia → Błędne

Zaznacz błędne elementy, a następnie kliknij:

• Usuń, aby trwale je usunąć, lub

• Przenieś do ignorowanych, aby aplikacja pomijała je przy kolejnych synchronizacjach.

Sprawdź szczegóły błędu – klikając Informacje, otrzymasz komunikat z opisem przyczyny problemu. Przykład:

Następujące pozycje powodują błędy:

Identyfikator: 1212, rozmiar: uniw, BLOZ7-3134111

Taki wpis oznacza, że kod BLOZ7-3134111 nie został znaleziony w systemie ERP, co uniemożliwia prawidłowe przetworzenie zamówienia.

Porada eksperta:

Regularne czyszczenie zakładek z błędnymi danymi znacząco przyspiesza synchronizację i stabilizuje działanie Bridge. W szczególności w dużych instalacjach, gdzie system ERP nie zawiera pełnych danych, warto wdrożyć dobrą praktykę codziennego przeglądu zakładek z błędami i ich opróżniania.

Elementy ignorowane są bezpiecznie pomijane i nie blokują działania aplikacji. W każdej chwili można je przywrócić, zmienić dane lub ponownie zsynchronizować.

Opis zdarzenia:

Podczas próby zarejestrowania zamówienia w systemie ERP aplikacja IdoSell Bridge może zwrócić komunikat błędu:

Zamówienie zostało zarejestrowane jako błędne.
W zamówieniu znajdują się pozycje, które powodują błędy. Szczegóły błędu zostały zapisane w dzienniku zdarzeń.

Następujące pozycje powodują błędy:
Identyfikator: 1212, rozmiar: uniw, BLOZ7-3134111

Błąd ten oznacza, że Bridge nie rozpoznał towaru z panelem IdoSell, ponieważ nie widzi powiązania pomiędzy tym towarem w panelu a odpowiednikiem w systemie ERP. Taki brak powiązania uniemożliwia przesłanie zamówienia do systemu ERP.

Rozwiązanie:

1. Sprawdź, czy towar jest synchronizowany

• Otwórz aplikację Bridge i przejdź do zakładki:
  Towary → Synchronizowane

• Wyszukaj kod zewnętrznego systemu (KZS) wskazany w komunikacie – np. BLOZ7-3134111.

Jeśli towar nie znajduje się na liście, przejdź do kolejnego kroku.

2. Dodaj towar do synchronizowanych

• Przejdź do zakładki:
  Towary → Niesynchronizowane

• Wyszukaj kod BLOZ7-3134111 (lub inny wskazany w komunikacie).

• Zaznacz towar i kliknij:
  Dodaj do synchronizowanych

• Jeśli przeniesie się poprawnie, uruchom synchronizację ręcznie:
  Narzędzia → Synchronizuj dane z panelem

Po zakończeniu synchronizacji aplikacja Bridge automatycznie rozpozna powiązanie i ponowi próbę przetworzenia zamówienia – powinno ono zostać poprawnie przeniesione do ERP.

3. Co zrobić, jeśli towaru nie ma na liście?

Jeśli nie widzisz towaru ani w „Synchronizowanych”, ani w „Niesynchronizowanych”, prawdopodobnie zmieniono (choć na chwilę) kod integracyjny w systemie ERP, lub w panelu.

W takiej sytuacji należy upewnić się, że aktualnie kody są poprawne i zresetować ustawienia magazynowe w Bridge. Instrukcję wykonania tej operacji opisaliśmy krok po kroku w osobnym artykule:

👉 Reset ustawień magazynowych Bridge – instrukcja krok po kroku

Po wykonaniu resetu i ponownej synchronizacji towar powinien pojawić się na liście, a błędne zamówienie zostanie poprawnie przetworzone.

Porada eksperta:

Jeśli często zdarzają się podobne błędy z rozpoznaniem towarów, warto upewnić się, że:

• Kody integracyjne (KZS) są konsekwentnie przypisane do towarów w panelu i systemie ERP,

• towary są odpowiednio przypisane do magazynów synchronizowanych,

• nie dokonuje się zmian kodów bez uprzedniego usunięcia towaru z listy synchronizowanych i ponownego przypisania.

Dzięki temu synchronizacja będzie przebiegać szybciej i bezbłędnie.

W tej sekcji znajdują się porady i instrukcje związane z ogólną konfiguracją aplikacji IdoSell Bridge, które nie dotyczą bezpośrednio narzędzi czy preferencji synchronizacji, ale wpływają na stabilność działania programu i jego środowisko systemowe.

Opis zdarzenia:

Podczas uruchamiania aplikacji IdoSell Bridge może pojawić się komunikat:

Wystąpił błąd podczas aktualizacji bazy danych IdoSell Bridge:
System.Data.SqlClient.SqlException (0x80131904): Incorrect syntax near the keyword 'IF'.

Taki komunikat oznacza, że aplikacja zaktualizowała się poprawnie, ale nie udało się zaktualizować bazy danych, co może prowadzić do problemów z działaniem Bridge lub z synchronizacją danych.

Rozwiązanie:

1. Zamknij aplikację IdoSell Bridge.

2. Pobierz najnowszy instalator aplikacji z panelu administracyjnego.

3. Uruchom instalator koniecznie jako administrator (prawy przycisk myszy → Uruchom jako administrator).

4. Przejdź przez proces instalacji ponownie.

Jeśli ponowna instalacja nie rozwiązuje problemu, poinformuj osobę zarządzającą serwerem SQL w Twojej firmie. Administrator powinien zweryfikować:

• Uprawnienia użytkownika,

• Reguły bezpieczeństwa SQL Server,

• Czy serwer SQL nie blokuje skryptów aktualizacyjnych.

Jak sprawdzić, czy baza została pomyślnie zaktualizowana?

Powinniśmy przejść do: Bridge → Ustawienia programu → Program IdoSell Bridge → Sprawdź strukturę bazy danych.

Porada eksperta:

Ten błąd najczęściej występuje, gdy baza danych Bridge znajduje się na innym komputerze niż aplikacja. Zalecamy, aby baza danych Bridge oraz sama aplikacja znajdowały się na tym samym urządzeniu.

Jeśli organizacja wymaga rozdzielenia tych elementów, administrator IT powinien zapewnić Bridge odpowiednie uprawnienia (np. db_owner) do bazy danych, by umożliwić jej samodzielną aktualizację.

Opis zdarzenia:

W panelu IdoSell w karcie towaru znajduje się pole „Ostatnia cena jedn. zakupu” – wielu użytkowników oczekuje, że będzie ono odzwierciedlać aktualną średnią cenę zakupu z systemu ERP. W praktyce jednak wartość ta jest przesyłana przez aplikację Bridge w bardzo uproszczony sposób i może nie odpowiadać rzeczywistym kosztom zakupu w firmie.

Jak to działa w Bridge:

Bridge nie wylicza średniej ceny zakupu na podstawie wielu dostaw. Zamiast tego:

• do panelu IdoSell przesyłana jest ostatnia cena zakupu, jaką Bridge odczytał z ostatniego dokumentu PZ (przyjęcie zewnętrzne) lub PW (przyjęcie wewnętrzne),

• jeśli dla jednego towaru były trzy dostawy po różnych cenach (np. 3×4 sztuki po 10, 12 i 14 zł), do panelu trafi wyłącznie cena z ostatniego przyjęcia (czyli np. 14 zł),

• historia i rozbieżności w cenach nie są brane pod uwagę.

Cena zakupu widoczna w panelu IdoSell w przypadku integracji z systemem ERP nie odzwierciedla średniego kosztu towaru, a jedynie ostatnio zarejestrowaną cenę na podstawie jednego dokumentu. To może prowadzić do nieporozumień, zwłaszcza jeśli:

• dostawy odbywają się cyklicznie po różnych stawkach,

• użytkownik oczekuje spójności z narzędziami analitycznymi systemu ERP,

• dane te są wykorzystywane do wyliczeń marży w panelu.

Rekomendacje:

• Nie opieraj się na cenie zakupu w panelu IdoSell, jeśli korzystasz z zewnętrznego systemu ERP – te dane mają charakter pomocniczy, a nie analityczny.

• Wyliczenia marży, analiza rentowności oraz kontrola kosztów powinny być prowadzone w systemie ERP, który zapewnia:

  • dostęp do dokumentów źródłowych (PZ, PW),

  • historię zakupów,

  • mechanizmy księgowania i analizy kosztów.

Porada eksperta:

Jeśli korzystasz z systemu ERP – to właśnie on powinien być głównym źródłem do zarządzania cenami zakupu, wyliczania marż, prowadzenia analiz i raportowania. Systemy ERP oferują znacznie bardziej rozbudowane i precyzyjne narzędzia do kontroli kosztów niż panel IdoSell.

Dane przesyłane do panelu IdoSell przez Bridge, takie jak cena zakupu, mają w tym przypadku charakter czysto informacyjny – bazują wyłącznie na ostatnim przyjęciu i nie powinny być traktowane jako referencyjne w procesach analitycznych.

Jeśli nie korzystasz z systemu ERP i zarządzasz gospodarką magazynową bezpośrednio w IdoSell, wtedy warto rozważyć wdrożenie magazynu WMS (MP), który umożliwia dokładniejsze śledzenie cen zakupu i rejestrację każdej dostawy, również z uwzględnieniem zmian cenowych.

Opis zdarzenia:

Często zdarza się, że sklep internetowy prowadzony w panelu IdoSell ma już rozbudowaną bazę produktów, natomiast w systemie ERP kartoteki nie zostały jeszcze utworzone. Pojawia się wówczas potrzeba jednorazowego przeniesienia wszystkich towarów z panelu do ERP, aby od tego momentu możliwa była pełna automatyczna synchronizacja przez aplikację IdoSell Bridge.

Rozwiązanie:

IdoSell Bridge nie posiada funkcji automatycznego dodawania kartotek z panelu do ERP. W praktyce sugerujemy:

1. W panelu IdoSell przejść do wyszukiwarki towarów, zaznaczyć produkty i wyeksportować je do pliku CSV lub XML (Zaznacz towary na wszystkich stronach > Eksport > Eksportuj zaznaczone towary do CSV / XML).

2. Zaimportować przygotowany plik do systemu ERP przy pomocy jego wbudowanych narzędzi (np. importu kartotek, API).

3. Upewnić się, że w ERP symbole produktów odpowiadają wartościom w polu „Kod zewnętrznego systemu” w panelu – to podstawa poprawnej synchronizacji.

4. Od tego momentu wszystkie nowe towary i zmiany rekomendujemy wprowadzać w ERP, a IdoSell Bridge wraz z aplikacją Downloader automatycznie przeniesie je do panelu.

Porada eksperta:

Wdrożenie integracji warto rozpocząć od uporządkowania bazy produktowej. Jeżeli korzystasz z ERP – to on powinien być głównym źródłem kartotek i miejscem ich uzupełniania (nazwy, symbole, kody). Panel IdoSell powinien pełnić funkcję systemu sprzedażowego, który otrzymuje podstawowe dane z ERP. Jednorazowy eksport z panelu i import do ERP pozwoli uniknąć dublowania pracy i zapewni spójność danych. Dzięki temu kolejne dodania i aktualizacje produktów będą realizowane już w pełni automatycznie poprzez Bridge.

Opis zdarzenia:

Jeśli chcesz dodać ofertę towarową z programu F/K (systemu ERP) do panelu IdoSell, możesz zrobić to szybko i bezproblemowo, wykorzystując narzędzia: IdoSell Bridge oraz IdoSell Downloader.

Czego potrzebujesz?

Aby rozpocząć eksport towarów z systemu ERP, upewnij się, że masz:

• Poprawnie skonfigurowany program IdoSell Bridge,

• Zainstalowaną aplikację IdoSell Downloader (dostępna w panelu administracyjnym w dziale Apps),

• Pełne dane towarów w systemie ERP (uzupełnione kartoteki produktów).

Jakie dane są eksportowane?

Dzięki tej integracji możliwy jest eksport:

• nazwy towaru,

• opisu krótkiego i długiego,

• ikony i zdjęć,

• symboli, kodów kreskowych,

• wagi i parametrów.

Dane o ilości (stanach magazynowych) oraz cenach są synchronizowane wyłącznie przez Bridge, nie przez Downloadera.

Krok po kroku – eksport towarów z ERP do IdoSell

1. Weryfikacja towarów do eksportu

Na początek sprawdź w systemie ERP, które towary mają zostać przeniesione do IdoSell.

2. Eksport bazy towarów w Bridge

Przejdź do:
Bridge → Ustawienia programu → Eksport bazy towarów

Sprawdź ustawienia zaawansowane (np. „eksport tylko towarów aktywnych”) w sekcji Zaawansowane ustawienia IOF – dostosuj je do swoich potrzeb i zapisz zmiany.

3. Generowanie pliku XML (IOF)

Bridge wygeneruje pliki XML z towarami zgodnie z konfiguracją. Znajdziesz je w folderze wskazanym w polu Katalog docelowy w zakładce Eksport bazy towarów.

Dostępne są dwa sposoby generowania plików:

• Ręczny – Bridge → Towary → Eksport opisów towarów do pliku IOF,

• Automatyczny – aktywowany w:
  Preferencje synchronizacji → Funkcje synchronizacji → Synchronizacja towarów → Generowanie bazy opisów towarów
  (uwaga: może to znacząco spowolnić synchronizację przy dużych bazach danych).

4. Wykorzystanie Downloadera do wgrywania oferty

IdoSell Downloader służy do importu nowych kartotek towarowych do panelu IdoSell z plików CSV lub XML.

• Bridge synchronizuje dane,

• Downloader umożliwia ich wgranie do panelu.

Dzięki temu możliwe jest automatyczne, regularne dodawanie oferty do sklepu. Downloader może być także uruchamiany z harmonogramem.

5. Wgranie oferty po raz pierwszy

1. Uruchom aplikację Downloader.

2. W Bridge kliknij ręcznie „Eksport IOF” lub poczekaj na automatyczne wygenerowanie.

3. Po zakończeniu generowania pojawi się pytanie, czy chcesz dodać ofertę – wybierz Tak.

4. Przejdź do konfiguracji nowej oferty w Downloaderze.

6. Konfiguracja oferty w Downloaderze

W Downloaderze przejdź do:
Ustawienia źródeł informacji o towarach i wybierz nową ofertę. Skonfiguruj ją według poniższych kroków:

Ustawienia:

• Ustaw aktualizację na „Nie aktualizuj”, a import na „Importuj” – dodasz tylko nowe towary.

• W przypadku chęci aktualizacji, skorzystaj z tabeli preferencji importu.

Kategorie:

• Zaznacz wszystkie lub wybrane kategorie – brak zaznaczenia oznacza brak importu.

Przetwarzanie towarów:

• Ustaw widoczność i przypisanie do sklepów – często warto ukryć towary do momentu ich pełnej konfiguracji.

Rozmiary:

• Najczęściej wybierane: uniw jako Uniwersalny rozmiar – możesz też skorzystać z automatycznego odwzorowania.

Marki:

• Zaznacz przynajmniej jedną markę – brak zaznaczenia = brak synchronizacji.

Parametry:

• Możliwość importu i odwzorowania parametrów z ERP – zależnie od potrzeb.

Jednostki miar:

• Zaznacz np. szt. jako sztuka lub użyj automatycznego odwzorowania.

Serie, Gwarancje:

• Można pozostawić bez zmian.

7. Uruchomienie synchronizacji

Po konfiguracji:

• Kliknij „Synchronizuj” – aby natychmiast dodać produkty,
  lub

• Przejdź do: Ustawienia → Opcje → Automatyczna synchronizacja – aby ustawić harmonogram synchronizacji.

8. Dodanie towarów do synchronizowanych

Na koniec wejdź w Bridge: 

Preferencje synchronizacji -> Funkcje synchronizacji -> Synchronizacja towarów

Sprawdź, czy włączona jest opcja:
✅ „Automatyczne dodawanie towarów do listy synchronizowanych”, lub ręcznie przenieś towary z zakładki „Niesynchronizowane" do zakładki „Synchronizowane.

Tylko towary w zakładce „Synchronizowane" będą otrzymywać stan, oraz dodawać się do zamówień.

Porada eksperta:

Jeśli Twoim głównym systemem zarządzania produktami jest program ERP, to właśnie tam można prowadzić pełną kontrolę nad danymi towarowymi – łącznie z nazwami, opisami, zdjęciami, kodami i cenami.

Dobrą praktyką jest dodanie towarów i ich aktualizacja w panelu, dodając więcej zdjęć, czy zmieniając ich opisy. Nowe towary będą dodawać się zgodnie z danymi dostępnymi w programie F/K.

Zadbaj o dobrą jakość danych już w ERP – dzięki temu cały proces synchronizacji będzie przebiegał sprawnie i bez potrzeby, lub z niewielką potrzebą ręcznych poprawek w panelu.

W tej części znajdziesz odpowiedzi na najczęściej zadawane pytania dotyczące działania aplikacji IdoSell Bridge. Zebraliśmy tu praktyczne wyjaśnienia i wskazówki, które pomogą lepiej zrozumieć logikę pracy programu, sposób obsługi zamówień oraz integracji z systemami ERP.

Sekcja jest regularnie rozwijana o nowe wpisy na podstawie pytań zgłaszanych przez klientów i doświadczeń zespołu wsparcia technicznego.

Opis zdarzenia:

IdoSell Bridge posiada gotowe integracje z najpopularniejszymi systemami ERP, takimi jak:

• Subiekt GT i Subiekt Nexo

• Comarch ERP Optima

• WAPRO Mag

• Enova365 (.NET)

• Streamsoft Prestiż

• Symfonia Handel

W przypadku korzystania z innego, niewspieranego systemu ERP, możliwe jest przygotowanie integracji indywidualnej. W tym celu aplikacja Bridge udostępnia tzw. uniwersalny tryb pracy (UDB), który pozwala na zaprojektowanie łącznika pomiędzy bazą danych Bridge a bazą wykorzystywanego systemu ERP.

Rozwiązanie:

1) Wdrożenie uniwersalnego trybu pracy (UDB)

• Szczegółowa dokumentacja techniczna znajduje się pod adresem: Dokumentacja UDB

• Tryb UDB umożliwia obsługę kluczowych funkcji: synchronizacji stanów magazynowych, cen, zamówień oraz kontrahentów.

• Do wdrożenia potrzebny jest programista znający dany system ERP – IdoSell nie przygotowuje łączników na zamówienie, można jednak we własnym zakresie taką integracje przygotować.

• W trybie UDB to Bridge przekazuje dane do panelu IdoSell, co za tym idzie jest wyłączony z naliczeń wywołań API w przeciwieństwie do rozwiązań REST API

2) Integracja przy użyciu API Panelu Administracyjnego

• Dokumentacja API dostępna jest pod adresem: REST API Panelu Administracyjnego

• API umożliwia tworzenie własnych aplikacji integracyjnych w dowolnym języku programowania.

• Rozwiązanie to sprawdzi się szczególnie wtedy, gdy integracja ma być elastyczna i obsługiwać dodatkowe procesy biznesowe.

• Użycie API jest naliczane standardowo, zgodnie z cennikiem .

Porada eksperta:

Jeśli planujesz współpracę z niestandardowym systemem ERP:

• Najpierw zweryfikuj, czy kluczowe procesy (stany magazynowe, ceny, zamówienia, kontrahenci) mogą być odwzorowane w trybie UDB.

• Wybierz rozwiązanie:

  • UDB – gdy zależy Ci na pełnej wymianie danych między ERP a panelem, wywołań API w cenie licencji i gotowej przygotowanej integracji (stanów, cen, zamówień, kontrahentów),

  • API – gdy potrzebujesz większej kontroli i własnej logiki integracyjnej.

• Realizację łącznika najlepiej zlecić firmie lub programistom posiadającym doświadczenie w pracy z wybranym systemem ERP.

Opis zdarzenia:

Pojawia się często pytanie, czy jedno zamówienie może być wielokrotnie przenoszone z panelu IdoSell do programu finansowo-księgowego (F/K) za pośrednictwem aplikacji IdoSell Bridge.

Rozwiązanie:

1. Standardowe działanie Bridge

   • Jeżeli zamówienie zostało pobrane przez Bridge i oznaczone jako poprawne, to zostało już przeniesione do programu F/K.

   • Takiego zamówienia nie można ponownie dodać do programu F/K.

   • Dopóki zamówienie w F/K nie zostanie zrealizowane (tzn. nie wystawiono dla niego dokumentu sprzedaży – faktury lub paragonu), będzie ono podczas każdej synchronizacji aktualizowane (przy uruchomieniu opcji aktualizacji zamówień).

   • Jeśli w panelu administracyjnym sklepu zmieni się np. cena, dodamy lub usuniemy produkty – Bridge automatycznie zaktualizuje to zamówienie w F/K (przy uruchomieniu opcji aktualizacji zamówień).

2. Zamówienia zrealizowane

   • W momencie, gdy zamówienie zostanie zrealizowane w F/K (wystawiony dokument sprzedaży), Bridge nie może go już aktualizować.

   • Wszelkie zmiany należy wówczas wprowadzić ręcznie w zewnętrznym programie F/K, np. poprzez wystawienie korekty.

3. Sytuacje wyjątkowe – czysta baza danych Bridge

   • Jeśli Bridge działa na czystej bazie danych (np. po nowej instalacji, ręcznym wyczyszczeniu bazy lub odtworzeniu kopii bezpieczeństwa z wcześniejszego okresu), to nie ma zapisanej historii pobranych zamówień.

   • Wówczas przy ustawieniu czasu synchronizacji np. 2 lata wstecz, Bridge pobierze wszystkie zamówienia z tego okresu i wprowadzi je do systemu ERP – nawet jeśli były już wcześniej zrealizowane.

   • Zamówienia takie będą miały aktualną datę pobrania, ponieważ Bridge traktuje je jako nowe.

4. Jak uniknąć powielania zamówień przy odtwarzaniu bazy

   • Po odtworzeniu kopii bezpieczeństwa lub instalacji nowej instancji, należy zwrócić szczególną uwagę na czas synchronizacji.

   • W aplikacji Bridge przejdź do:
     Preferencje synchronizacji → Ustawienia czasu ostatniej synchronizacji

   • Ustaw datę początkową tak, aby program pobierał zamówienia tylko od momentu, od którego faktycznie chcemy zsynchronizować dane do ERP.

   • Dzięki temu unikniemy ponownego pobrania i zarejestrowania starych zamówień.

Porada eksperta:

Bridge pamięta tylko te zamówienia, które są zapisane w jego bazie danych. Jeśli baza zostanie wyczyszczona lub odtworzona z kopii sprzed dłuższego okresu, to przy pierwszej synchronizacji może pobrać dużą liczbę historycznych zamówień i zarejestrować je w ERP jako nowe.

Dlatego po każdej reinstalacji lub odtworzeniu backupu:

• zawsze sprawdzaj i koryguj ustawienia czasu ostatniej synchronizacji,

• upewnij się, że ERP nie otrzyma ponownie zamówień, które zostały już wcześniej zrealizowane,

• w razie wątpliwości najpierw przetestuj synchronizację na kopii testowej bazy ERP, zanim wykonasz ją na produkcji.

Opis zdarzenia:

Część użytkowników prowadzących kilka punktów sprzedaży zastanawia się, czy możliwe jest jednoczesne korzystanie z wielu kopii aplikacji IdoSell Bridge – np. z różnymi systemami finansowo-księgowymi (F/K) albo z tym samym systemem F/K, ale zainstalowanym na różnych komputerach.

Rozwiązanie:

1. Wiele subskrypcji Bridge dla jednego panelu IdoSell

   • Możesz wykupić kilka subskrypcji Bridge dla jednego panelu administracyjnego.

   • Każda instalacja Bridge powinna być przypisana do innego magazynu sklepu.

   • Dzięki temu dane będą synchronizowane oddzielnie i unikniesz konfliktów między magazynami.

2. Dlaczego nie można używać tej samej konfiguracji w wielu kopiach Bridge?

   • Jeżeli na kilku komputerach działa Bridge zsynchronizowany z tym samym magazynem i tymi samymi towarami, może to prowadzić do rozbieżności w stanach magazynowych.

   • Zamówienia również będą problematyczne – Bridge pobiera nowe zamówienia ze sklepu. Uruchomienie kilku instancji spowoduje, że te same zamówienia mogą być pobierane wielokrotnie.

3. Rekomendowane rozwiązania

   • Kilka sklepów w panelu IdoSell – jeśli posiadasz więcej niż jeden sklep, każdą kopię Bridge możesz skonfigurować tak, aby pobierała zamówienia tylko z wybranego sklepu.

   • Jeden sklep – jedno Bridge – w przypadku jednego sklepu nie jest ani zalecane, ani uzasadnione korzystanie z kilku instancji aplikacji Bridge.

4. Gospodarka magazynowa w panelu IdoSell

   • Należy pamiętać, że gospodarka magazynowa w panelu IdoSell jest globalna – nie można prowadzić jej częściowo przez Bridge, a częściowo ręcznie.

   • Instalacja Bridge odbywa się per magazyn.

   • Możesz więc skonfigurować:

     • jeden system ERP na komputerze A → magazyn M1,

     • inny system ERP na komputerze B → magazyn M2.

   • Każdy magazyn sklepu może być powiązany z inną instancją Bridge i innym systemem ERP, ale zawsze w ramach tej samej, spójnej gospodarki magazynowej panelu IdoSell.

Porada eksperta:

Najlepszą praktyką jest przypisywanie każdej kopii Bridge do osobnego magazynu w panelu, osobnego sklepu i odrębnego systemu ERP.

Opis zdarzenia:

W przypadku prowadzenia sprzedaży międzynarodowej mogą pojawić się zamówienia w walucie obcej (np. EUR, USD). Aby zostały poprawnie przeniesione do programu finansowo-księgowego (F/K) przez aplikację IdoSell Bridge, konieczne jest odpowiednie przygotowanie konfiguracji zarówno w panelu administracyjnym IdoSell, jak i w systemie ERP.

Rozwiązanie:

1. Sprawdź konfigurację walut w panelu IdoSell

   • Wejdź do:
     Ustawienia → Waluty → Konfiguracja walut dla strony

   • Upewnij się, że dana waluta (np. EUR) jest aktywna i prawidłowo skonfigurowana.

   • Kurs waluty ustawia się bezpośrednio w panelu – to ten kurs będzie wykorzystywany przez Bridge przy przenoszeniu zamówień.

   • Instrukcja szczegółowa: Waluty i kursy walut w panelu IdoSell.

2. Weryfikacja konfiguracji w systemie ERP

   • Sprawdź, czy w Twoim systemie F/K została dodana odpowiednia waluta obca (np. EUR).

   • Upewnij się, że w systemie ERP istnieje właściwa stawka VAT dla kraju, do którego przypisane jest zamówienie (np. 19% VAT dla Niemiec).

   • Brak waluty lub stawki VAT w ERP uniemożliwi poprawne zaksięgowanie zamówienia.

3. Wpłaty w walucie obcej

   • Bridge nie przenosi wpłat w walutach obcych – wpłaty przesyłane są wyłącznie w PLN.

   • Oznacza to, że zamówienie w walucie obcej (np. EUR) zostanie dodane do ERP w wartości zgodnej z panelem (1:1, zgodnie z kursem ustawionym w panelu), natomiast wpłata do takiego zamówienia nie zostanie zsynchronizowana.

4. Ustawienia stawek VAT w Bridge

   • W Bridge możesz zdecydować, skąd pobierane będą stawki VAT w zamówieniach.

   • Ścieżka:
     Ustawienia programu → Program {system ERP} → Parametry programu → Wybór stawki VAT ustawianej dla towarów w zamówieniach

   • Dostępne opcje:

     • Według stawek VAT towarów w programie F/K – Bridge korzysta z definicji VAT w ERP.

     • Według stawek VAT towarów w zamówieniu ze sklepu – Bridge przenosi stawki dokładnie tak, jak zostały zapisane w zamówieniu w panelu IdoSell (najczęściej wybierana opcja, aby zachować spójność).

Porada eksperta:

• Zawsze upewnij się, że w ERP masz dodane wszystkie stawki VAT, które obowiązują w krajach, do których wysyłasz zamówienia.

• Jeśli obsługujesz kilka walut, ustaw kursy w panelu IdoSell i regularnie je aktualizuj – Bridge zawsze korzysta z kursu zdefiniowanego w panelu, nie z ERP.

• Najbezpieczniejszą praktyką jest ustawienie w Bridge wyboru stawek VAT według zamówienia ze sklepu – dzięki temu faktura w ERP będzie zgodna z danymi, jakie widział klient podczas zakupu.

Opis zdarzenia:

W panelu administracyjnym IdoSell możesz tworzyć zestawy i kolekcje towarów. Pojawia się pytanie, w jaki sposób takie zestawy są obsługiwane przez aplikację IdoSell Bridge i jak są przenoszone do programu finansowo-księgowego (F/K).

Rozwiązanie:

1. Sposób działania Bridge przy zestawach

   • Bridge nie przesyła do ERP całego zestawu jako jednego towaru.

   • Do systemu ERP trafiają wyłącznie składowe zestawu, rozbite na części.

   • Wartość zamówienia jest zachowana – suma cen wszystkich składowych zawsze odpowiada cenie zestawu w panelu (1:1).

2. Tworzenie i zarządzanie zestawami

   • Zestawy i kolekcje tworzymy zawsze w panelu IdoSell, a nie w ERP.

   • Bridge traktuje je jako grupę produktów i rozbija na elementy składowe przy eksporcie do systemu ERP.

   • Uwaga – zestaw nie posiada własnego stanu magazynowego. Stany są wyliczane wyłącznie na podstawie stanów jego składowych.

3. Warunki poprawnej synchronizacji

   • Każdy towar wchodzący w skład zestawu musi być dodany do listy towarów synchronizowanych w Bridge.

   • W przeciwnym razie podczas przenoszenia zamówienia do ERP pojawi się błąd z komunikatem, że w zamówieniu znajdują się towary niesynchronizowane.

   • Jeżeli chcesz synchronizować również ceny zestawu, dodaj go do synchronizowanych tak samo jak zwykły towar – zestaw w panelu posiada własne pole „Kod zewnętrznego systemu” potrzebne do integracji.

4. Efekt w programie ERP

   • Na zamówieniu w ERP nie pojawi się pozycja „zestaw”.

   • Zostaną dodane wszystkie składowe zestawu, z cenami przeliczonymi tak, aby ich suma była równa wartości zestawu w panelu.

Porada eksperta:

Aby korzystać z zestawów bez błędów:

• zawsze dodawaj wszystkie składowe zestawu do synchronizowanych towarów w Bridge,

• pamiętaj, że stan zestawu = minimum stanów jego składowych,

• jeśli chcesz, aby zestaw miał również cenę kontrolowaną w ERP, wprowadź dla niego kod zewnętrznego systemu w panelu i włącz synchronizację,

• w ERP zestaw zawsze będzie widoczny jako rozbite składowe – dzięki temu dokumenty sprzedaży pozostają spójne z rzeczywistymi stanami magazynowymi.

Opis zdarzenia:

Podczas przenoszenia zamówień z panelu administracyjnego IdoSell do programu finansowo-księgowego (F/K), aplikacja IdoSell Bridge zawsze sprawdza, czy klient już istnieje w bazie ERP. Ma to na celu uniknięcie duplikatów i zapewnienie spójności danych kontrahentów.

Rozwiązanie:

1. Kolejność sprawdzania klienta przez Bridge:

   • w pierwszej kolejności sprawdzany jest kod zewnętrznego systemu (KZS),

   • następnie wyszukiwana jest zgodna skrócona nazwa oraz login lub adres e-mail,

   • w ostateczności sprawdzany jest NIP.

2. Aktualizacja danych klienta:

   • jeśli klient zostanie odnaleziony, a dane w ERP różnią się od danych w panelu IdoSell, Bridge przy przenoszeniu zamówienia automatycznie zaktualizuje kartotekę klienta w ERP na podstawie danych z panelu.

   • jeśli klient nie zostanie odnaleziony, Bridge utworzy w ERP nową kartotekę kontrahenta.

3. Ważne ograniczenia:

   • Nie zalecamy przenoszenia więcej niż jednego klienta o tym samym numerze NIP.

   • Jeśli w ERP istnieje już klient o danym NIP, przeniesienie kolejnego spowoduje przypisanie mu danych pierwszego klienta w ERP – te dane mogą zostać także zsynchronizowane do panelu.

   • Może to prowadzić do poważnych błędów, np. przypisania zamówienia do niewłaściwego klienta lub błędnej wysyłki towaru.

Porada eksperta:

Dla poprawnej obsługi klientów najlepiej unikać powielania numerów NIP, adresów e-mail i dbać o spójność danych pomiędzy ERP a panelem IdoSell. W przypadku dużej liczby kontrahentów warto okresowo weryfikować kartoteki klientów w panelu oraz systemie ERP, aby uniknąć niespójności.

Opis zdarzenia:

Część sklepów internetowych oferuje w sprzedaży nie tylko towary, ale również usługi (np. rehabilitacja, szkolenia, doradztwo). Powstaje pytanie, w jaki sposób aplikacja IdoSell Bridge obsługuje takie przypadki i czy możliwe jest przenoszenie usług do ERP.

Rozwiązanie:

1. Standardowe działanie Bridge:

   • IdoSell Bridge synchronizuje wyłącznie towary – ich stany magazynowe, ceny i zamówienia.

   • Usługi nie są synchronizowane wprost.

   • Usługi mogą być przesyłane jedynie jako dodatki do towarów (np. transport, ubezpieczenie).

2. Jak obejść brak synchronizacji usług?
   Aby możliwe było przeniesienie usługi do ERP, można ją potraktować jak towar:

   • dodać usługę w panelu jako towar i przypisać jej stan (np. przyjęcie wewnętrzne np. na M1 lub stan na magazynie M0 – magazynie od dostawcy),

   • w ERP zamówienie z takim „towarem” można następnie zmienić na usługę.

3. Przykłady:

   • Transport – może być dodany jako towar dodatkowy i przeniesiony razem z zamówieniem.

   • Rehabilitacja – nie zostanie przesłana jako usługa, ale może być wprowadzona jako „towar-usługa” w panelu, aby zamówienie mogło trafić do ERP.

Porada eksperta:

IdoSell Bridge nie obsługuje usług w sposób natywny. Jeśli usługi są istotnym elementem sprzedaży, najlepszą praktyką jest:

• zdefiniowanie ich jako towary techniczne w panelu,

• synchronizowanie ich tak samo jak inne towary,

• a następnie odpowiednie oznaczanie lub konwersja w ERP (np. zmiana towaru na usługę).

Dzięki temu zamówienia będą poprawnie przenoszone, a księgowość w ERP będzie mogła obsłużyć zarówno towary, jak i powiązane usługi.