IdoSell Bridge - Kamsoft (KS‑AOW) Konfiguracja

Kamsoft Bridge to aplikacja integrująca system KS‑AOW firmy Kamsoft z apteką internetową opartą na IdoSell. Integracja działa dwukierunkowo - przekazuje dane o produktach, stanach magazynowych i cenach z KS‑Apteka do IdoSell oraz zamówienia i dane klientów z IdoSell do KS‑Apteka. Synchronizacja może odbywać się bezpośrednio przez API lub poprzez ofertę IOF generowaną przez aplikację. Rozwiązanie umożliwia centralne zarządzanie ofertą, magazynem, cenami i obsługą zamówień z poziomu systemu aptecznego, minimalizując ryzyko błędów oraz konieczność ręcznej aktualizacji danych.

• jak połączyć KS‑AOW z IdoSell,

• jak skonfigurować aplikację Kamsoft Bridge,

• jak synchronizować stany magazynowe i ceny,

• jak przesyłać zamówienia z IdoSell do KS‑AOW,

• jak mapować kurierów i formy płatności,

• Czy posiadasz aktywną subskrypcję Kamsoft Bridge?

• Czy program KS‑AOW posiada moduł APW‑45 Apteka Internetowa?

• Czy znasz identyfikator apteki używany w KS‑Apteka?

• Czy posiadasz uprawnienia administratora systemu Windows?

• Czy skonfigurowano moduł komunikacji APW‑45 w KS‑AOW?

Krok 1. Skonfiguruj połączenie z panelem IdoSell

1. Pobierz aplikację z sekcji: APPS > Katalog aplikacji i usług > Kamsoft Bridge.

2. Uruchom program jako administrator (prawy klawisz myszy – uruchom jako administrator).

3. Otwórz zakładkę Połączenie z panelem IdoSell.

4. Uzupełnij:

   1. domenę panelu - tym miejscu podać należy pełną domenę sklepu w postaci:

      • nazwasklepu.iai-shop.com

      • nazwasklepu.yourtechnicaldomain.com

      • clientID.idosell.com

      • własna dowolna domena podpięta do panel Twojej apteki internetowej

   2. login użytkownika,

   3. hasło użytkownika.

Krok 2. Skonfiguruj połączenie z KS‑Apteka

1. Otwórz zakładkę „Połączenie z programem KS‑Apteka”.

2. Wprowadź identyfikator apteki.

3. Wprowadź hasło komunikacyjne zgodne z konfiguracją modułu APW‑45.

Krok 3. Skonfiguruj synchronizację produktów

1. Wybierz produkty podlegające synchronizacji. Możesz wybrać:

• wszystkie produkty,

• wyłącznie produkty niewymagające recepty.

2. Wybierz identyfikator produktu Produkty mogą być identyfikowane:

• po kodzie BLOZ z karty aptecznej (ustawienie domyślne),

• po numerze ID z karty internetowej,

• po kodzie EAN z karty aptecznej,

• po identyfikatorze w centralnej bazie towarów.

Krok 4. Wybierz tryb synchronizacji

1. Synchronizacja przez API

Zmiany cen i stanów magazynowych są automatycznie przesyłane do panelu IdoSell. Bezpośrednio w panelu IdoSell, przechodząc do MAGAZYNY > Gospodarka magazynowa ustaw: Główny system magazynowo-sprzedażowy > Program innej firmy oraz: Integruję przez Bridge, Kamsoft Bridge.

2. Synchronizacja przez IOF

Kamsoft Bridge generuje ofertę XML, która jest przesyłana do IdoSell za pomocą Downloadera. W bezpośrednio IdoSell, przechodząc do MAGAZYNY > Gospodarka magazynowa ustaw: Główny system magazynowo-sprzedażowy > Program innej firmy oraz: Kontroluję, ale nie integruję go przez Bridge, Kamsoft Bridge.

W aplikacji Kamsoft Bridge przejdź do ustawień, a następnie otwórz zakładki Parametry synchronizacji i Synchronizacja zamówień. W tym miejscu możesz określić, które zamówienia mają być przenoszone do programu KS-AOW.

Statusy zamówień przenoszonych do KS-AOW

• Wszystkie statusy z wyłączeniem: klient anulował, fałszywe, stracone, połączone.

• Wszystkie statusy z wyłączeniem: nieobsłużone, oczekuje na wpłatę, klient anulował, fałszywe, stracone, połączone.

• Wyłącznie zamówienia ze statusami: Gotowe oraz Wysłane/Odebrane.

• Wyłącznie zamówienia ze statusem Wysłane / Odebrane.

Magazyny objęte synchronizacją

Możesz wskazać, z których magazynów mają pochodzić synchronizowane zamówienia. Dostępne opcje to:

• wszystkie magazyny,

• magazyn obcy,

• pojedyncze magazyny własne.

Sklepy powiązane z zamówieniami

Możesz wskazać sklepy, z którymi muszą być powiązane zamówienia, aby zostały poprawnie przeniesione do programu KS-AOW. Dostępny jest wielokrotny wybór spośród wszystkich sklepów posiadanych w panelu IdoSell.

Dodatkowe ustawienia synchronizacji

• Możesz wykluczyć z synchronizacji towary oznaczone jako „gratis”.

• Możesz określić, czy Kamsoft Bridge ma nie zmieniać statusów zamówień w panelu administracyjnym IdoSell, czy też je ustawiać lub aktualizować po przeniesieniu zamówień do programu KS-AOW.

W aplikacji Kamsoft Bridge przejdź do ustawień, a następnie otwórz zakładki Parametry synchronizacji i Synchronizacja stanów magazynowych. W tym miejscu możesz określić, czy Kamsoft Bridge ma aktualizować stany synchronizowanych towarów oraz do którego magazynu w panelu administracyjnym IdoSell mają trafiać te stany.

Ustawienia wymagane do synchronizacji

• Włącz aktualizację stanów magazynowych.

• Wskaż magazyn IdoSell, do którego mają trafiać zsynchronizowane stany.

W aplikacji Kamsoft Bridge przejdź do ustawień, a następnie otwórz zakładki Parametry synchronizacji i Synchronizacja cen. W tym miejscu możesz zdecydować, czy ceny synchronizowanych towarów mają być aktualizowane.

Aby synchronizacja lub aktualizacja cen była możliwa, skonfiguruj:

• sklep, w którym mają być ustawiane synchronizowane ceny,

• mapowanie typów cen z programu KS-Apteka na typy cen dostępne w panelu IdoSell.

Rekomendowany tryb synchronizacji cen i stanów magazynowych

Rekomendujemy, aby w zakładce Parametry synchronizacji / Ogólne, w ustawieniu dotyczącym trybu synchronizacji cen i stanów magazynowych, wybrać opcję synchronizacji bezpośredniej przez API. Tylko taka konfiguracja zapewnia synchronizację cen leków na receptę z prawidłowym podziałem na dostępne rodzaje odpłatności.

Jeśli synchronizacja cen i stanów magazynowych odbywa się z użyciem aplikacji Downloader , Kamsoft Bridge eksportuje dla leków na receptę wyłącznie ceny podstawowe, bez podziału na rodzaje odpłatności.

Dodatkowo w zakładce synchronizacji cen możesz określić, czy synchronizowane przez Ciebie towary mają trafiać do wybranych stref hotspot w Twojej aptece internetowej IdoSell oraz wskazać, jakie typy cen ustawione w towarach w programie KS-Apteka mają decydować o tym przypisaniu.

W zakładce Mapowanie kurierów i form płatności możesz powiązać metody dostawy i płatności z panelu IdoSell z odpowiadającymi im ustawieniami w programie KS-AOW. Dzięki temu dane zostaną poprawnie odwzorowane na zamówieniu przeniesionym do KS-AOW.

Mapowanie kurierów

Dla każdej metody dostawy podaj wartość wymaganą przez program KS-Apteka: „Symbol” danego kuriera np. GLS.

Mapowanie form płatności

Dla każdej formy płatności podaj wartość wymaganą przez program KS-Apteka: „Symbol definicji” dokumentu pieniężnego np. GO (Gotówka).

W zakładce Eksport bazy towarów możesz określić parametry oferty XML w formacie IOF, którą Kamsoft Bridge generuje automatycznie podczas każdej synchronizacji. W tej sekcji ustawisz, jakie dane mają trafić do plików eksportu oraz w jaki sposób mają być filtrowane towary.

• Kategorie towarów — określ, jakie kategorie mają zostać przypisane do towarów w pliku full.xml oraz w drzewie kategorii w pliku categories.xml.

• Filtrowanie eksportowanych towarów — zdecyduj, czy towary eksportowane do oferty mają być dodatkowo filtrowane według typu, dostępności lub posiadanych kodów BLOZ, czy mają być eksportowane niezależnie od tych parametrów.

• Kod producenta — wybierz, z której wartości kodu w programie KS-Apteka ma być uzupełniany kod producenta zwracany przy towarach eksportowanych do pliku light.xml.

• Dodatkowe dane w pliku full.xml — wskaż, które informacje o eksportowanych towarach mają zostać umieszczone w pliku full.xml:

  • nazwa towaru,

  • cena towaru,

  • opis krótki,

  • opis długi,

  • nazwa jednostki miary,

  • nazwa producenta,

  • zdjęcia i ikona towaru,

  • parametry towaru: dawka, postać, lek na receptę, opakowanie, data ważności, nazwa międzynarodowa.

Produkty - sprawdź, czy produkty są widoczne w panelu IdoSell oraz czy mają poprawne podstawowe dane, takie jak nazwa, kod identyfikacyjny, opis, zdjęcia i parametry produktu.

Stany magazynowe - sprawdź, czy ilości produktów w panelu IdoSell są zgodne ze stanami w KS‑AOW oraz czy zmiana stanu w KS‑AOW jest poprawnie przenoszona do IdoSell.

Ceny - sprawdź, czy ceny produktów są aktualizowane automatycznie zgodnie z konfiguracją, czy przypisano właściwy sklep do synchronizacji cen oraz czy leki na receptę mają poprawnie przeniesione odpłatności.

Zamówienia - sprawdź, czy nowe zamówienia z IdoSell trafiają do KS‑AOW, czy są przenoszone zgodnie z wybranymi statusami, sklepami i magazynami oraz czy poprawnie zapisują się informacje o płatności i dostawie.

Po zakończeniu instalacji i podstawowej konfiguracji aplikacji Kamsoft Bridge możesz przejść do konfiguracji synchronizacji danych pomiędzy systemem KS‑Apteka a IdoSell. W osobnym artykule opisaliśmy:

• eksport i aktualizację towarów,

• synchronizację leków na receptę wraz z cenami i odpłatnościami,

• obsługę wielu placówek aptecznych,

• przywracanie konfiguracji aplikacji.