IdoSell Bridge - Kamsoft (KS‑AOW) Synchronizacja danych
Aplikacja Kamsoft Bridge jest elementem integracji pomiędzy systemem KS-Apteka a platformą IdoSell. Odpowiada za wymianę danych pomiędzy obydwoma systemami, w tym synchronizację towarów, cen, stanów magazynowych oraz zamówień internetowych. Ten artykuł stanowi rozwinięcie dokumentacji IdoSell Bridge - Kamsoft (KS‑AOW) Konfiguracja . Skupia się na zadaniach wykonywanych już po instalacji i podstawowej konfiguracji integracji.
Ten artykuł jest rozwinięciem dokumentacji integracji KS-AOW z IdoSell. Jeśli nie masz jeszcze skonfigurowanej aplikacji, zapoznaj się najpierw z artykułem głównym dotyczącym integracji IdoSell Bridge - Kamsoft, a następnie wróć do instrukcji opisanych poniżej.
Co znajdziesz w tym artykule?
jak wyeksportować towary z KS-AOW do IdoSell,
jak synchronizować leki na receptę wraz z cenami sprzedaży,
jak obsłużyć wiele placówek aptecznych,
jak przywrócić konfigurację.
Zanim zaczniesz sprawdź
Czy usługa Kamsoft Bridge jest uruchomiona?
Czy program KS-AOW posiada skonfigurowany moduł Apteka Internetowa (KS-AOW / APW45)?
Czy masz dostęp do panelu IdoSell?
Eksport towarów z KS-AOW do IdoSell
Krok 1. Wygeneruj ofertę IOF w KS-AOW
W module KS-APW45 wybierz: Komunikacja > Aktualizuj ofertę sklepu internetowego. Podczas aktualizacji:
usługa Kamsoft Bridge musi być aktywna,
opcja Informacje o firmie musi być włączona.
Każde uruchomienie generuje ofertę IOF zawierającą:
towary,
stany magazynowe,
ceny sprzedaży.
Na podstawie tej oferty można:
dodawać nowe produkty do IdoSell,
aktualizować istniejące produkty.
Generując ofertę w programie KS-AOW przy uruchomionej usłudze w aplikacji pomocniczej Kamsoft Bridge, włączona aplikacja Downloder sama wykrywa nową ofertę.
Krok 2. Skonfiguruj Downloader
Po wygenerowaniu nowej oferty:
1. Uruchom aplikację Downloader,
2. Poczekaj na automatyczne wykrycie nowej oferty.
3. Zmapuj kategorie KS-AOW w zakładce "Kategorie" z kategoriami IdoSell.
4. Określić, które kategorie mają być synchronizowane.
5. Opcjonalnie w zakładce "Przetwarzanie towarów" ustawić marżę dla wybranych kategorii.
Krok 3. Skonfiguruj magazyny
W zakłdce "Magazyny" dla każdego magazynu:
Wskaż magazyn z wygenerowanej oferty.
Przypisz go do magazynu w panelu IdoSell.
Dzięki temu stany magazynowe będą synchronizowane z właściwym magazynem.
Krok 4. Uzupełnij mapowania dodatkowe
Przypisz:
rozmiary w zakładce "Rozmiary",
producentów w zakładce "Producenci",
jednostki miary w zakłądce "Jednostki miar".
Krok 5. Uruchom synchronizację
Pierwsza synchronizacja:
doda produkty do panelu IdoSell.
Kolejne synchronizacje w aplikacji Downloader:
zaktualizują istniejące towary,
dodadzą nowe produkty pojawiające się w KS-AOW.
Synchronizacja leków na receptę i ich cen
Leki oznaczone w module KS-AOW / APW45 jako "Lek na receptę” mogą być synchronizowane do IdoSell wraz z odpłatnościami i cenami sprzedaży. Takie produkty można zamawiać w aptece internetowej wyłącznie z odbiorem osobistym.
Krok 1. Zweryfikuj plan abonamentowy
Synchronizacja leków na receptę wymaga planu:
ELASTIC CLOUD
CLOUD PRO
Funkcja wykorzystuje mikroserwis obsługujący formuły cenowe JavaScript.
Krok 2. Włącz rozszerzone zarządzanie lekami
W module KS-AOW / APW45: Komunikacja > Ustawienia > Ustawienia, włącz opcję: Rozszerzone zarządzanie lekami na receptę (ryczałt, odpłatność, ceny, limit). Domyślnie opcja jest wyłączona.
Krok 3. Skonfiguruj IdoSell
W panelu IdoSell przejdź do: Administracja > Konfiguracja magazynów i gospodarki magazynowej. Ustaw:
Główny system magazynowo-sprzedażowy to program innej firmyoraz
Stany magazynowe w programie innej firmy : integruję przez Bridge, Kamsoft Bridge
Po tej zmianie operacje magazynowe w IdoSell zostaną zablokowane.
Krok 4. Skonfiguruj tryb synchronizacji
W Kamsoft Bridge przejdź do ustawień. W zakładce Preferencje synchronizacji > Ogólne ustaw:
Typy towarów = wszystkie
Tryb synchronizacji cen i stanów = synchronizacja bezpośrednia przez API
Krok 5. Wybierz sklep docelowy
W Kamsoft Bridge, w zakładce: Preferencje synchronizacji > Synchronizacja cen, wybierz sklep, do którego mają trafiać ceny z panelu IdoSell.
Co dzieje się podczas synchronizacji leków na receptę?
Dla produktów oznaczonych jako Lek na receptę:
pomijane jest ustawieni mapowania cen,
pomijane są standardowe strefy prezentacji towarów w sklepie IdoSell (w przypadku tych towarów pod uwagę braną jest jedynie konfiguracja sklepów),
ceny wgrywane są w formie kodu JavaScript,
na karcie towaru ustawiany jest dedykowany "Tryb wyliczania ceny" = Formuła do wyliczenia ceny,
jako cena bazowa przyjmowana jest najwyższa wyliczona wartość dla wszystkich rodzajów odpłatności.
Dodatkowo na karcie towaru ustwiany jest również:
dedykowany profil wysyłki i zwrotów: Lek na receptę, odbiór osobisty [profil systemowy] (zadaniem profilu będzie ograniczenie listy dopuszczalnych form dostawy na stronie apteki internetowej tylko do odbioru osobistego oraz zablokowanie w sklepie możliwości zwrotu i reklamacji takiego towaru).
parametr specjalny Lek na receptę = Tak (profil Lek na receptę, odbiór osobisty [profil systemowy] jest zależy od kontekstu specjalnego Lek na receptę oznacza to, że abyś mógł go ustawić w towarze w panelu IdoSell, towar ten musi mieć przypisany parametr z takim właśnie kontekstem specjalnym o wartości tak. W innym wypadku ten konkretny profil wysyłki i zwrotów nie będzie w ogóle widoczny na liście profili wysyłki i zwrotów możliwych do wyboru.)
Obsługa wielu placówek aptecznych
Kamsoft Bridge umożliwia przypisywanie zamówień internetowych do konkretnych placówek stacjonarnych. Dzięki temu zamówienia są realizowane przez właściwy punkt apteczny. Poniżej prezentujemy krótką instrukcję, która przedstawia, jak prawidłowo skonfigurować synchronizację zamówień internetowych, aby ich realizacja była możliwa w poszczególnych stacjonarnych punktach aptecznych.
Krok 1. Powiąż magazyn
W ustawieniach Kamsof Bridge w zakładce Parametry synchronizacji > Synchronizacja zamówień wybierz magazyn IdoSell odpowiadający konkretnej placówce.
Krok 2. Powiąż sklep
W ustawieniach Kamsof Bridge w zakładce Parametry synchronizacji > Synchronizacja zamówień wskaż sklep internetowy, z którego mają być pobierane zamówienia.
Krok 3. Skonfiguruj statusy
Możesz ustawić automatyczną zmianę statusu zamówienia w IdoSell na:
Gotowe
Realizowane
Wysłane
lub skonfigurować mapowanie statusów KS-AOW. Dostępne statusy:
Nowe
Potwierdzone
W trakcie realizacji
Zafakturowane
Wysłane
Wstrzymane
Odrzucone
Odebrane
Spakowane
Zapraszamy po odbiór
Sprawdzone
Zarezerwowane
Przywracanie konfiguracji Kamsoft Bridge
Uruchomiony program Kamsoft Bridge raz na dobę zapisuje w chmurze IdoSell swoją konfigurację, przy czym liczba przechowywanych konfiguracji ograniczona jest do 20 ostatnio zapisanych. Dostęp dla użytkowników do zapisanych plików konfiguracji, możliwy jest w panelu IdoSell.
Krok 1. Pobierz konfigurację
W panelu IdoSell: Apps > Katalog aplikacji i usług > Kamsoft Bridge > Wybierz (Starsze wersje i dodatki). W kolumnie "Zapisane konfiguracje programu" kliknij "Pokaż", następnie "Pobierz plik", zapisz konfigurację lokalnie.
Krok 2. Zatrzymaj usługę
Przed przywróceniem ustawień zatrzymaj usługę Kamsoft Bridge.
Krok 3. Uruchom przywracanie
W aplikacji wybierz: Przywróć konfigurację programu.
Krok 4. Wskaż plik.
Wskaż pobrany wcześniej plik konfiguracji.
Krok 5. Potwierdź operację.
Potwierdź przywracanie konfiguracji. Konieczne będzie ponowne uruchomienie programu. Poprzednia konfiguracja zostanie dodatkowo zapisana lokalnie na dysku w celu zabezpieczenia.