Narzędzia & Towary

W tej części dokumentacji znajdują się wszystkie funkcje wspierające zarządzanie towarami oraz narzędzia diagnostyczne dostępne w aplikacji IdoSell Bridge. Sekcja łączy w sobie opcje z menu Towary i Narzędzia, które pozwalają na ręczne działania, kontrolę spójności danych oraz wykonywanie operacji technicznych — takich jak kopie zapasowe czy diagnostyka synchronizacji.

To miejsce szczególnie przydatne dla administratorów, operatorów systemów ERP oraz osób odpowiedzialnych za techniczną stronę działania integracji.

Funkcje dostępne z poziomu zakładki Narzędzia pozwalają na kontrolę, zabezpieczenie oraz przywracanie konfiguracji aplikacji Bridge:

• Synchronizuj dane z panelem
  Ręczne wywołanie pełnej synchronizacji danych pomiędzy panelem IdoSell a programem F/K. Może być przydatne w sytuacjach testowych lub po wprowadzeniu zmian w konfiguracji.

• Wykonaj kopię bezpieczeństwa danych / Odtwórz dane z kopii
  Narzędzie do tworzenia i przywracania kopii zapasowych danych aplikacji Bridge. Kluczowe przed większymi zmianami lub w razie awarii systemu.

• Przywróć konfigurację programu / połączenia z bazą danych
  Przydatne po reinstalacji aplikacji lub przeniesieniu jej na nowy komputer. Pozwala odzyskać ustawienia bez ponownej konfiguracji.

• Wykonaj zrzut bazy programu F/K
  Eksport danych z bazy programu finansowo-księgowego w celach diagnostycznych (np. do weryfikacji powiązań, kodów KZS, czy stanów magazynowych).

• Dziennik zdarzeń
  Rejestr wszystkich operacji oraz błędów wykrytych przez Bridge podczas synchronizacji. Niezastąpione narzędzie do analizy problemów i przyczyn błędów (np. stanów, cen, braków danych).

IdoSell Bridge wzbogacony został mechanizm, który raz na dobę w sposób automatyczny archiwizuje główne ustawienia programu oraz konfigurację połączenia z bazą danych, a następnie w zaszyfrowanej formie synchronizuje je wraz z innymi informacjami o urządzeniu z chmurą IdoSell, gdzie są one wyświetlane na liście subskrypcji dla danej instancji.

Ustawienia programu IdoSell Bridge

Wszystkie ustawienia programu IdoSell Bridge podzieliliśmy na dwa istotne obszary:

• konfiguracja ustawień aplikacji (dane dostępowe do panele sklepu, wszystkie parametry preferencji synchronizacji i ustawień programu)

• konfiguracja połączeń z bazą danych (dane dostępowe bazy Bridge oraz dane dostępowe bazy programu F/K)

Działanie mechanizmu zapisu i przywracania ustawień programu

Każda działająca instancja programu IdoSell Bridge raz na dobę zapisuje w panelu konfiguracje osobno dla każdego z dwóch powyższych obszarów.

Na liście zapisanych w panelu konfiguracji użytkownik ma dostęp do archiwalnych plików konfiguracyjnych danej instancji z ostatnich 20 dni. W dowolnym momencie może je pobrać, a następnie przywrócić po stronie programu IdoSell Bridge zainstalowanego w danej lokalizacji.

Przywracanie ustawień programu IdoSell Bridge  na przykładzie pliku konfiguracji aplikacji

Krok 1. 

Przejdź na stronę aplikacji IdoSell Bridge w swoim panelu administracyjnym IdoSell.

"Apps -> Lista subskrypcji -> IdoSell Bridge -> Zarządzaj licencjami -> Windows -> Starsze wersje i dodatki -> Wybierz"

Następnie w sekcji Subskrypcje aplikacji IdoSell Bridge kliknij w wierszu interesującej Cię instancji na znajdujący się w kolumnie Zapisane konfiguracje aplikacji przycisk Pokaż.

Pojawi Ci się wówczas nowe okno zawierające listę zapisanych konfiguracji. Interesującą Cię konfigurację pobierzesz i zapiszesz na dysku w wybranej lokalizacji klikając na link Pobierz plik w kolumnie Plik ustawień aplikacji.

Krok 2. 

W aplikacji IdoSell Bridge wybierz pozycję menu Przywróć konfigurację programu

• Potwierdź przywrócenie konfiguracji programu klikając na TAK, a następnie wskaż zapisany wcześniej na dysku plik konfiguracji.

Po wykonanej operacji konieczne będzie ponowne jego uruchomienie.

Porada eksperta

Przywracanie konfiguracji programu Bridge z pliku zapisanej konfiguracji w panelu IdoSell zadziała poprawnie tylko wtedy, gdy na nowym komputerze zainstalowana jest ta sama wersja Microsoft SQL Server, co na poprzednim stanowisku. Jeżeli wersje SQL różnią się (np. wcześniej był SQL Server 2016, a teraz 2019 lub 2022), próba przywrócenia zakończy się błędem – ze względu na niezgodność silnika bazy danych.

W takiej sytuacji zalecamy wykonanie nowej instalacji i ręczną konfigurację aplikacji Bridge na podstawie wcześniej wykonanych zrzutów ekranu z zakładek synchronizacji.

Warto pamiętać, że przy świeżej instalacji i braku poprzedniej bazy danych aplikacja nie będzie miała informacji o zarejestrowanych wcześniej zamówieniach, co może uniemożliwić wykonanie korekt (np. faktur korygujących) lub aktualizacji statusów zamówień z przeszłości.

Dlatego zalecamy:

• Odzyskiwać kopię, lub konfigurację na tej samej wersji silnika SQL.

• Przed zmianą stanowiska lub reinstalacją zawsze wykonać pełną kopię zapasową danych Bridge.

• W razie wątpliwości – skontaktować się z administratorem systemu lub wsparciem technicznym.

Zakładka Towary służy do zarządzania stanem synchronizacji produktów pomiędzy ERP a panelem IdoSell. Oferuje zarówno narzędzia analityczne, jak i operacyjne:

• Kontrola towarów – narzędzie do diagnostyki stanów magazynowych i cen z uwzględnieniem różnic między ERP a panelem IdoSell.

• Niesynchronizowane / Synchronizowane / Ignorowane / Błędne
  Zakładki te umożliwiają klasyfikację towarów w zależności od ich stanu integracji:

  • Niesynchronizowane – towary rozpoznane w ERP, ale niepowiązane z panelem IdoSell.

  • Synchronizowane – aktywnie synchronizowane produkty.

  • Ignorowane – celowo wyłączone z integracji.

  • Błędne – towary, których nie udało się poprawnie zsynchronizować (np. z powodu brakujących kodów KZS).

• Eksport opisów towarów do pliku IOF
  Funkcja pozwalająca wygenerować plik z ofertą towarową w formacie IOF, który następnie można zaimportować do IdoSell za pomocą programu IAI Downloader.

Narzędzie „Kontrola towarów” w aplikacji IdoSell Bridge pełni funkcję diagnostyczną i pozwala na porównanie danych magazynowych pomiędzy systemem ERP a panelem IdoSell. Jego celem nie jest bieżąca synchronizacja, lecz wskazanie różnic – zarówno w stanach magazynowych, jak i w cenach – które mogą wynikać z błędnej konfiguracji, rezerwacji lub blokad.

Bridge nie ma możliwości zdejmowania rezerwacji po stronie ERP ani po stronie IdoSell – dlatego narzędzie może wykazywać różnice nawet w sytuacjach, gdy synchronizacja działa poprawnie.

Aktualizacja stanów magazynowych

Po przejściu do zakładki aktualizacji stanów i kliknięciu „Aktualizuj”, aplikacja Bridge przesyła aktualny stan dyspozycyjny z ERP – uwzględniający rezerwacje w systemie ERP.

W systemie IdoSell rezerwacje są jednak niezależnie naliczane na podstawie zamówień i nie mogą być zdejmowane przez Bridge. Przykładowo:

• jeśli w ERP produkt jest dostępny, ale w IdoSell jego rezerwacja nadal trwa (zamówienie ma status „Realizowane”), to stan w panelu będzie obniżony aż do momentu zmiany statusu na „Wysłane/odebrane” lub „Anulowane/fałszywe”.

Z tego względu możliwe jest występowanie pozornych rozbieżności. Narzędzie to pomija bazę danych Bridge, dlatego pozwala wymusić synchronizację z pominięciem domyślnego cyklu.

Aktualizacja cen

Ta zakładka pozwala wykryć towary, których ceny różnią się pomiędzy ERP a panelem IdoSell. Wyświetlona zostanie lista towarów, których ceny można zaktualizować – zarówno w panelu, jak i w ERP, zależnie od kierunku synchronizacji.

Należy jednak pamiętać, że Bridge – jak każdy system integracyjny – nie ma możliwości usunięcia blokad cenowych po stronie IdoSell. Najczęstsze przyczyny problemów z aktualizacją cen to:

• ustawiona cena minimalna w panelu IdoSell, która jest wyższa od innych cen (np. hurtowych) – wówczas panel blokuje aktualizację,

• włączony automat do wyliczania cen – jeśli cena ma być obliczana w panelu, nie można jej przesłać z ERP.

Jak diagnozować błędy synchronizacji?

Jeśli podejrzewasz, że stan lub cena nie została zaktualizowana poprawnie, przejdź do:
Narzędzia → Dziennik zdarzeń

Znajdziesz tam szczegółowe komunikaty, np.:

• Wystąpił problem z synchronizacją stanu magazynowego oraz cen zakupu: 7 – Aktualizacja stanów została zablokowana, musisz zmienić konfigurację gospodarki magazynowej.

• Wystąpił problem z synchronizacją ceny: Identyfikator produktu – WOFOREVER15O, kod błędu: 72 – W towarze włączone jest automatyczne wyliczanie cen.

• Wystąpił problem z synchronizacją ceny: Identyfikator produktu – ZELAQUA, kod błędu: 32 – Nie możesz ustawić ceny minimalnej większej od innych cen (błędne ceny: hurtowe).

Porada eksperta:

• Jeśli dane różnią się między ERP a panelem IdoSell – najpierw sprawdź rezerwacje w obu systemach.

• Upewnij się, że w panelu nie działa automat do wyliczania cen, a ceny minimalne są prawidłowo ustawione względem innych typów cen (np. cena hurtowa nie może wtedy wynosić "0").

• Kilka wystąpień takich samych towarów w kontroli wskazuje na rozmiary dostępne na kilku magazynach

• Narzędzie Kontrola towarów nie modyfikuje rezerwacji, a jedynie porównuje dane – dlatego każda aktualizacja powinna być poprzedzona analizą przyczyny rozbieżności.

Ta część dokumentacji IdoSell Bridge zawiera opis zakładek służących do bieżącej kontroli i klasyfikacji przesyłanych danych — takich jak zamówienia, wpłaty, klienci i zwroty. Wszystkie te moduły oferują ten sam zestaw filtrów: Poprawne, Błędne, Pominięte oraz Ignorowane, co pozwala na precyzyjną identyfikację problemów w procesie synchronizacji.

Sekcja skierowana jest do użytkowników, którzy chcą szybko zdiagnozować, które elementy nie zostały poprawnie zsynchronizowane z systemem ERP oraz dlaczego.

Zakres funkcji dostępnych w tej sekcji:

Każda z zakładek: Zamówienia, Wpłaty, Klienci oraz Zwroty umożliwia przegląd i weryfikację danych w ramach czterech kategorii:

• Poprawne
  Dane, które zostały poprawnie przetworzone i zsynchronizowane pomiędzy panelem administracyjnym IdoSell a programem finansowo-księgowym (F/K). W tej zakładce znajdują się elementy zakończone pełną i prawidłową synchronizacją.

• Błędne
  Elementy, których nie udało się zsynchronizować z powodu wykrytych błędów. Mogą one dotyczyć np. braku powiązania z towarem, błędnych danych adresowych, czy konfliktów kodów zewnętrznych systemu (KZS). Szczegóły błędów widoczne są w Dzienniku zdarzeń (menu: Narzędzia → Dziennik zdarzeń).

• Pominięte
  Dane, które zostały tymczasowo pominięte przez aplikację Bridge – zwykle z powodu niespełnienia wymagań synchronizacji (np. nieprzypisany magazyn). Po usunięciu przyczyny można je ponownie zarejestrować ręcznie lub automatycznie.

• Ignorowane
  Dane wyłączone przez użytkownika z synchronizacji. Do tej kategorii mogą trafić np. testowe lub ręcznie wystawione zamówienia, niepowiązane wpłaty, niechciane zwroty. Oznaczenie danych jako ignorowanych zabezpiecza przed ich ponownym przetwarzaniem.

Porada eksperta:

Dane oznaczone jako błędne będą przy każdej synchronizacji ponownie podejmowane do przetworzenia – dlatego jeśli chcesz wykluczyć je z procesu, dodaj je do zakładki „Ignorowane”.

Ta sama zasada dotyczy każdej kategorii danych: Zamówień, Wpłat, Klientów oraz Zwrotów.

W każdej z tych sekcji, po kliknięciu w dany rekord, możesz sprawdzić szczegółowy powód błędu lub pominięcia. Informacja ta pomoże Ci samodzielnie skorygować dane lub odpowiednio je zakwalifikować.