DOKUMENTACJA TECHNICZNA KAMSOFT S.A. 40-235 Katowice ul. 1-Maja 133 Tel. (032) 2090705, Fax. (032) 2090715 http:www.kamsoft.pl, e-mail: 5420@kamsoft.pl SYSTEM INFORMATYCZNY NR KATALOGOWY 2334PI06.00 WYDANIE 2016.00.0.0 Katowice, 2016 r. Strona 1 z 21
DOKUMENTACJA TECHNICZNA SPIS ZAWARTOŚCI 1. Komunikacja z aptekami... 3 1.1. Generowanie ofert... 3 2. Komunikacja z KAMSOFT... 4 2.1. Pobieranie i aktualizacja bazy BLOZ dla wersji 2014.02.x.x lub nowszej.... 7 2.1.1. Weryfikacja poprawności przyjęcia bazy BLOZ.... 12 2.2. Pobieranie i aktualizacja komunikatów GIF i BLUR... 13 3. Konfiguracja wysyłki odmów do innego celu niż KS-EWD... 15 3.1. Weryfikacja źródła SEND_DOK w... 15 3.2. Konfiguracja w KS-HFW... 15 3.3. Konfiguracja w... 16 3.3.1. Uruchomienie skryptu... 16 3.3.2. Konfiguracja opcji w... 17 4. Jednoczesna konfiguracja zarówno wysyłki odmów jak i wysyłki zamówień odbiorcy do innego celu niż KS-EWD... 18 4.1. Weryfikacja źródła SEND_DOK w... 18 4.2. Konfiguracja w KS-HFW... 18 4.3. Konfiguracja w... 19 4.3.1. Uruchomienie skryptu... 19 4.3.2. Konfiguracja opcji w... 20 Strona 2 z 21
DOKUMENTACJA TECHNICZNA W poniższym dokumencie opisana została funkcjonalności i jej konfiguracja w zakresie współpracy z systemem hurtowym KAMSOFT KS-HFW. 1. KOMUNIKACJA Z APTEKAMI W rozdziale tym opisano konfigurację funkcjonalności po stronie systemu dotyczącą usług przeznaczonych głównie dla aptek. 1.1. Generowanie ofert Obecnie proces generowania ofert został zdefiniowany jako dwa zadania harmonogramowe w systemie. W celu uruchomienia generowania ofert należy wybrać zakładkę Zadania. Zakładka Zadania umożliwia uruchomienie zadań harmonogramowych w systemie KS-JOBS z poziomu Administratora WWW Przycisk Dodaj umożliwia dodanie do listy zadań nowego zadania. Przykładowe okna, w którym możemy zdefiniować Generowanie ofert indywidualnych oraz Generowanie ofert ogólnych, wyglądają tak: Okna umożliwiają konfigurację harmonogramu zgodnie w własnymi preferencjami. Po dokonaniu odpowiednich ustawień oraz zaznaczeniu opcji jako Aktywne generowanie ofert będzie się odbywać zgodnie z preferencjami. Strona 3 z 21
DOKUMENTACJA TECHNICZNA W celu poprawnej obsługi generowania ofert należy jeszcze w opcji DST_DEF_DESTINATION dla zlecenia RECV_OFT jako wartość zdefiniować KSHOST: Tak skonfigurowane zadania będą zapisywać pliki ofert do katalogu elektronicznej wymiany danych zdefiniowanym w opcji DST_HST_DIR. Szczegółowe ścieżki zapisu dla ofert indywidualnych i ogólnej znajduje się odpowiednio w opcjach DST_HST_OFR_DIR oraz DST_HST_OFR_CMN_DIR. Dodatkowo istnieje możliwość skonfigurowania powiadomień e-mail informujących o stanie wykonania poszczególnych zleceń. Aby uruchomić taką funkcjonalność należy skonfigurować poniższe opcje: DST_EMAIL_FROM - Adres e-mail, który będzie ustawiany jako adres wysyłającego e-mail DST_EMAIL_SMTP_PASS - Hasło do autoryzacji na serwerze SMTP DST_EMAIL_SMTP_URL - Adres serwera SMTP, z którego będą wysyłanie wiadomości e-mail DST_EMAIL_SMTP_USER - Użytkownik do autoryzacji na serwerze SMTP ALT_EMAIL_TO - Adres e-mail, na który mają zostać przesyłane powiadomienia. W przypadku zdefiniowania kilku adresów, jako separator na należy stosować średnik TSK_ALERT_SEND - Określa, czy wysłać alert po błędnym wykonaniu zlecenia (TAKNIE) należy ustawić w kontekście konkretnego zlecenia np. RECV_OFT TSK_INFO_SEND - Określa, czy wysłać powiadomienie po poprawnym wykonaniu zlecenia (TAKNIE) należy ustawić w kontekście konkretnego zlecenia np. RECV_OFT. Pozostałe opcje dotyczące ustawień generowania ofert są dostępne w kategorii Usługi KS-HFW : UWAGA Opcję w kategorii Usługi KS-HFW posiadają wartości domyślne pozwalające na generowanie ofert zgodnie z aktualnymi ustawieniami w systemie KS-HFW. 2. KOMUNIKACJA Z KAMSOFT W rozdziale tym opisano konfigurację funkcjonalności po stronie systemu dotyczącą usług wymagającej komunikacji z KAMSOFT. W celu zapewnienia poprawnej konfiguracji komunikacji z KAMSOFT należy zdefiniować widok: Strona 4 z 21
DOKUMENTACJA TECHNICZNA CREATE OR REPLACE VIEW V_JOB_KAM ( NWBR ) AS select '000002' NWBR from dual gdzie '000002' jest przykładowym NWBR kontrahenta KAMSOFT Następnie w opcji SRC_JOB_NWBR_VIEW należy dla zleceń SEND_RQST_BLZ, SEND_RQST_GIF oraz SEND_RQST_BLR wskazać wartość V_JOB_KAM: Strona 5 z 21
DOKUMENTACJA TECHNICZNA Następnie w zakładce Kartoteki należy założyć kontrahenta o NWBR zgodnym z widokiem V_JOB_KAM (w tym przypadku 000002) jak przedstawiono na poniższym rysunku: Strona 6 z 21
DOKUMENTACJA TECHNICZNA 2.1. Pobieranie i aktualizacja bazy BLOZ dla wersji 2014.02.x.x lub nowszej. DO URUCHOMIENIA TEJ METODY WYMAGANA JEST SYSTEM KS-HFW W WERSJI CO NAJMNIEJ 2014.09.0.0. Obecnie proces pobierania i aktualizacji bazy BLOZ został zdefiniowany jako zadanie harmonogramowe z systemie. W celu uruchomienia generowania ofert należy wybrać zakładkę Zadania. Przy pomocy przycisku Dodaj wybieramy zadanie Aktualizacja BLOZ. Spowoduje to otwarcie okna umożliwiającego konfigurację harmonogramu zgodnie w własnymi preferencjami: Po dokonaniu odpowiednich ustawień oraz zaznaczeniu opcji jako Aktywne pobierania i aktualizacji bazy BLOZ będzie się odbywać zgodnie z preferencjami. W celu poprawnej obsługi aktualizacji bazy BLOZ należy jeszcze: Włączyć zadanie archiwizacji raz dziennie w nocy. Strona 7 z 21
DOKUMENTACJA TECHNICZNA Ustawić wartość opcji SRC_DEL_FILES_AFTER_FINISH na TAK Ustawić opcję TSK_DEL_FILES_AFTER_FINISH dla zlecenia RECV_BLZ na TAK Strona 8 z 21
DOKUMENTACJA TECHNICZNA W opcji DST_DEF_DESTINATION dla zlecenia SEND_RQST_BLZ jako wartość zdefiniować OSOZWS. W tej samej opcji DST_DEF_DESTINATION dla innego zlecenia RECV_BLZ jako wartość zdefiniować KSHRT. Strona 9 z 21
DOKUMENTACJA TECHNICZNA W opcji DST_PKE_PASS ustawić hasło. W polu wartość wpisujemy hasło do inauguracji. W opcji DST_OSOZ_SERVICE_URL dla zlecenia SEND_RQST_BLZ jako wartość wpisać adres https:www.osoz.plws-broker-server-blozservicesservicebrokeranonymous Dla zleceń SEND_RQST_BLZ oraz RECV_BLZ proszę ustawić opcję TSK_WAIT_TIME na wartość 7200. Strona 10 z 21
DOKUMENTACJA TECHNICZNA UWAGA Jeśli podczas pobierania lub aktualizacji bazy BLOZ, w zleceniu RECV_BLZ wystąpi błąd typu Out Of Memory należy zmienić ilość przydzielonej pamięci. Dokonujemy tego poprzez edycję pliku Catalina (C:\KS\Tomcat\4.1.x\bin\Catalina.bat) modyfikując wartość parametru Xmx na wartość 1400m (-Xmx 1400m ). JEŚLI SYSTEM KORZYSTA Z WERSJI XE BAZY DANYCH ORACLE, NALEŻY DODATKWO USTAWIĆ DWIE OPCJE: Opcję ARCH_DELETE_ROWS na TAK Opcja określa, czy proces archiwizacji wierszy z tabel ma je przenosić do archiwum, czy też usuwać. Domyślną wartością tej opcji jest NIE. Wprowadzenie wartości TAK dla tej opcji spowoduje, iż proces archiwizacji, zamiast przenosić wpisy z tabel głównych do tabel przechowujących wpisy archiwalne, spowoduje ich usunięcie. Strona 11 z 21
DOKUMENTACJA TECHNICZNA Opcję ARCH_VALIDITY na wartość 14 lub 7. Opcja określająca, po jakim czasie, wpisy z tabeli zleceń, mają zostać przeniesione do archiwum. Wartość tej opcji należy podawać w dniach. Wartością domyślną jest liczba 30 co powoduje, iż po uruchomieniu zadania archiwizacji wszystkie starsze (niż 30 dni) rekordy tabeli zostaną przeniesione do archiwum. Jeśli system korzysta z wersji XE bazy danych Oracle zaleca się ustawić 14 lub 7 dni. 2.1.1. Weryfikacja poprawności przyjęcia bazy BLOZ. W celu zweryfikowania poprawności przyjęcia bazy BLOZ należy uruchomić zadanie Aktualizacja BLOZ. W tym celu wchodzimy w zadania i klikamy ikonkę Uruchom teraz. Następnie po uruchomieniu zadania Aktualizacja BLOZ przechodzimy do zakładki Zlecenia. W zakładce tej oba typy zleceń SEND_RQST_BLZ oraz następujące po nim RECV_BLZ powinno zakończy się powodzeniem co symbolizuje symbol w kolumnie Status. Dodatkowo, na liście dla zleceń SEND_RQST_BLZ oraz RECV_BLZ można kliknąć na ikonę lupki w kolumnie Akcja i tym samym przejść do szczegółów zlecenia, dodatkowo weryfikując czy nie pojawił się żaden błąd bezpośrednio w logach konkretnego zlecenia. Strona 12 z 21
DOKUMENTACJA TECHNICZNA 2.2. Pobieranie i aktualizacja komunikatów GIF i BLUR Obecnie proces pobierania komunikatów GIF i BLUR został zdefiniowany jako zadanie harmonogramowe z systemie. W celu uruchomienia pobierania komunikatów GIF oraz BLUR należy wybrać zakładkę Zadania. Obecnie proces pobierania komunikatów GIF i BLUR został zdefiniowany jako zadania harmonogramowe z systemie. W celu uruchomienia pobierania komunikatów GIF oraz BLUR należy wybrać zakładkę Zadania. Przy pomocy przycisku Dodaj wybieramy zadania Pobieranie komunikatów GIF, a później Pobieranie komunikatów BLUR. Spowoduje to otwarcie okien umożliwiającego konfigurację harmonogramu zgodnie w własnymi preferencjami: Po dokonaniu odpowiednich ustawień oraz zaznaczeniu opcji jako Aktywne pobierania komunikatów GIF i BLUR będzie się odbywać zgodnie z preferencjami. W celu poprawnej obsługi pobierania komunikatów należy jeszcze w opcji DST_DEF_DESTINATION dla zlecenia SEND_RQST_GIF i SEND_RQST_BLR oraz jako wartość zdefiniować KSEWD: Strona 13 z 21
DOKUMENTACJA TECHNICZNA W tej samej opcji DST_DEF_DESTINATION dla zleceń RECV_BLR oraz RECV_GIF jako wartość zdefiniować KSHRT. Strona 14 z 21
DOKUMENTACJA TECHNICZNA UWAGA DALSZA CZĘŚĆ INSTRUKCJI POKAZUJE KONFIGURACJĘ WYSŁKI ODMÓW DO INNEGO CELU NIŻ KS-EWD (PUNKT 3) ORAZ KONFIGURACJĘ WYSŁKI ODMÓW JEDNOCZEŚNIE Z WYSŁKĄ ZAMÓWIEŃ ODBIORCY DO INNEGO CELU NIŻ KS- EWD (PUNKT 4). W ZALEZNOŚCI OD TEGO JAKĄ WERSJĘ CHCEMY SKONFIGUROWAĆ, STOSUJEMY SIĘ DO PUNKTU 3 LUB 4. 3. KONFIGURACJA WYSYŁKI ODMÓW DO INNEGO CELU NIŻ KS-EWD W rozdziale tym opisano konfigurację funkcjonalności po stronie systemu KS-HFW oraz dotyczącą obsługi odmów do innych celów niż KS-EWD. Domyślnie odmowa będzie kierowana do celu zgodnego z zamówieniem którego dotyczy, jakie zostało odebrane przez system. 3.1. Weryfikacja źródła SEND_DOK w Przed przystąpieniem do konfiguracji należy sprawdzić, czy obecnie nie jest wykorzystywane źródło SEND_DOK do wysyłki faktur, jeśli jest prosimy o kontakt mailowy na 5420@kamsoft.pl w celu ustawienia odpowiedniej konfiguracji. 3.2. Konfiguracja w KS-HFW W pierwszej kolejność należy wykonać skrypt na schemacie HURT przyznający odpowiednie uprawnienia: GRANT EXECUTE ON SEW_CHECK_KNT_NEW_DOK TO SEW GRANT SELECT ON V_SEW_SEND_ODM TO SEW GRANT EXECUTE ON SEW_ODM_SEND_CONFIRM TO SEW GRANT SELECT ON V_SEW_SEND_ZOD TO SEW GRANT EXECUTE ON SEW_ZOD_SEND_CONFIRM TO SEW Strona 15 z 21
DOKUMENTACJA TECHNICZNA 3.3. Konfiguracja w konfigurujemy dwuetapowo wg poniższych punktów. 3.3.1. Uruchomienie skryptu Na schemacie SEW należy uruchomić następujący skrypt: INSERT INTO ZRD (NZRD,NAZW,SYMB,INTV,NZKL,AKTW,INST,NSTN) VALUES (20,'Rozsyłanie Dokumentów','SEND_DOK',60000,'pl.kamsoft.app.sew.source.table.SEND_DOK.KSSewSource_SEND_DOK','T','N',null) INSERT INTO OPD (NOPD,ZMIE,WART,OPIS,INST,KODW) VALUES (289,'SRC_SEND_DOK_VIEW','V_SRC_SEND_DOK','Widok dla źródła SEND_DOK','N','N') INSERT INTO OPD (NOPD,ZMIE,WART,OPIS,INST,KODW) VALUES (290,'SRC_SEND_DOK_CONFIRM_REG','SRC_SEND_DOK_CONFIRM_REG','Procedura potwierdzająca zarejestrowanie zlecenia wysłania dokumentu dla źródła SEND_DOK.','N','N') INSERT INTO OPD (NOPD,ZMIE,WART,OPIS,INST,KODW) VALUES (291,'SRC_SEND_DOK_CONFIRM_PASS','SRC_SEND_DOK_CONFIRM_PASS','Procedura potwierdzająca przekazanie do celu zlecenia wysłania dokumentu dla źródła SEND_DOK.','N','N') CREATE OR REPLACE VIEW V_SRC_SEND_DOK_HURT ("NWBR_DOST", "NWBR_ODBR", "NWBR_ODD", "IDDK", "NAZW", "PLIK", "FMWE", "FMWY", "CELZ", "EMAL", "SYMB") AS SELECT NWBR_DOST, NWBR_ODBR, NWBR_ODD, IDDK, NAZW, PLIK, FMWE, FMWY, DECODE(CELZ, 'P', 'KT', 'F', 'FTP', 'H', 'KSHOST', NULL) CELZ, EMAL, 'SEND_ORZ' SYMB FROM HURT.V_SEW_SEND_ODM CREATE OR REPLACE PROCEDURE SRC_SEND_DOK_CONFIRM_PASS_HURT ( pnwbr_dost IN VARCHAR2, --ID KAMSOFT dostawcy pnwbr_odbr IN VARCHAR2, --ID KAMSOFT odbiorcy pdok_id IN VARCHAR2,-- ID dokumentu pnrzl IN NUMBER, --numer zlecenia psymb IN VARCHAR2 --Symbol zlecenia ) IS BEGIN HURT.SEW_ODM_SEND_CONFIRM(pDOK_ID,'T'); COMMIT; END; CREATE OR REPLACE PROCEDURE SRC_SEND_DOK_CONFIRM_REG_HURT ( pnwbr_dost IN VARCHAR2, --ID KAMSOFT dostawcy pnwbr_odbr IN VARCHAR2, --ID KAMSOFT odbiorcy pdok_id IN VARCHAR2,-- ID dokumentu psymb IN VARCHAR2 --Symbol zlecenia ) IS BEGIN HURT.SEW_ODM_SEND_CONFIRM(pDOK_ID,'R'); COMMIT; END; COMMIT Strona 16 z 21
DOKUMENTACJA TECHNICZNA 3.3.2. Konfiguracja opcji w W kolejnym kroku po wykonaniu skryptu ustawiamy następujące opcje: W opcji SRC_SEND_DOK_VIEW ustawiamy wartość V_SRC_SEND_DOK_HURT W opcji SRC_SEND_DOK_CONFIRM_REG ustawiamy wartość SRC_SEND_DOK_CONFIRM_REG_HURT Strona 17 z 21
DOKUMENTACJA TECHNICZNA W opcji SRC_SEND_DOK_CONFIRM_PASS ustawiamy wartość SRC_SEND_DOK_CONFIRM_PASS_HURT 4. JEDNOCZESNA KONFIGURACJA ZARÓWNO WYSYŁKI ODMÓW JAK I WYSYŁKI ZAMÓWIEŃ ODBIORCY DO INNEGO CELU NIŻ KS-EWD W rozdziale tym opisano konfigurację funkcjonalności po stronie systemu KS-HFW oraz dotyczącą obsługi odmów i wysyłki zamówień odbiorcy do innych celów niż KS-EWD. Domyślnie odmowa, czy zamówienie odbiorcy będzie kierowane do celu zgodnego z zamówieniem którego dotyczy, jakie zostało odebrane przez system. 4.1. Weryfikacja źródła SEND_DOK w Przed przystąpieniem do konfiguracji należy sprawdzić, czy obecnie nie jest wykorzystywane źródło SEND_DOK do wysyłki faktur, jeśli jest prosimy o kontakt mailowy na 5420@kamsoft.pl w celu ustawienia odpowiedniej konfiguracji. 4.2. Konfiguracja w KS-HFW W pierwszej kolejność należy wykonać skrypt na schemacie HURT przyznający odpowiednie uprawnienia: GRANT EXECUTE ON SEW_CHECK_KNT_NEW_DOK TO SEW GRANT SELECT ON V_SEW_SEND_ODM TO SEW GRANT EXECUTE ON SEW_ODM_SEND_CONFIRM TO SEW GRANT SELECT ON V_SEW_SEND_ZOD TO SEW GRANT EXECUTE ON SEW_ZOD_SEND_CONFIRM TO SEW Strona 18 z 21
DOKUMENTACJA TECHNICZNA 4.3. Konfiguracja w konfigurujemy dwuetapowo wg poniższych punktów. 4.3.1. Uruchomienie skryptu Na schemacie SEW należy uruchomić następujący skrypt: INSERT INTO ZRD (NZRD,NAZW,SYMB,INTV,NZKL,AKTW,INST,NSTN) VALUES (20,'Rozsyłanie Dokumentów','SEND_DOK',60000,'pl.kamsoft.app.sew.source.table.SEND_DOK.KSSewSource_SEND_DOK','T','N',null) INSERT INTO OPD (NOPD,ZMIE,WART,OPIS,INST,KODW) VALUES (289,'SRC_SEND_DOK_VIEW','V_SRC_SEND_DOK','Widok dla źródła SEND_DOK','N','N') INSERT INTO OPD (NOPD,ZMIE,WART,OPIS,INST,KODW) VALUES (290,'SRC_SEND_DOK_CONFIRM_REG','SRC_SEND_DOK_CONFIRM_REG','Procedura potwierdzająca zarejestrowanie zlecenia wysłania dokumentu dla źródła SEND_DOK.','N','N') INSERT INTO OPD (NOPD,ZMIE,WART,OPIS,INST,KODW) VALUES (291,'SRC_SEND_DOK_CONFIRM_PASS','SRC_SEND_DOK_CONFIRM_PASS','Procedura potwierdzająca przekazanie do celu zlecenia wysłania dokumentu dla źródła SEND_DOK.','N','N') CREATE OR REPLACE VIEW V_SRC_SEND_DOK_HURT ( NWBR_DOST, NWBR_ODBR, NWBR_ODD, IDDK, NAZW, PLIK, FMWE, FMWY, CELZ, EMAL, SYMB ) AS SELECT NWBR_DOST, NWBR_ODBR, NWBR_ODD, IDDK, NAZW, PLIK, FMWE, FMWY, DECODE(CELZ, 'P', 'KT', 'F', 'FTP', 'A', 'APOCKET', 'H', 'KSHOST', 'E', 'EMAIL', NULL) CELZ, EMAL, 'SEND_ORZ' SYMB FROM HURT.V_SEW_SEND_ODM UNION ALL SELECT NWBR_DOST, NWBR_ODBR, NWBR_ODD, IDDK, NAZW, PLIK, FMWE, FMWY, DECODE(CELZ, 'P', 'KT', 'F', 'FTP', 'H', 'KSHOST', 'E', 'EMAIL', NULL) CELZ, EMAL, 'SEND_ZOD' SYMB FROM HURT.V_SEW_SEND_ZOD CREATE OR REPLACE PROCEDURE SRC_SEND_DOK_CONFIRM_PASS_HURT ( pnwbr_dost IN VARCHAR2, --ID KAMSOFT dostawcy pnwbr_odbr IN VARCHAR2, --ID KAMSOFT odbiorcy pdok_id IN VARCHAR2,-- ID dokumentu pnrzl IN NUMBER, --numer zlecenia psymb IN VARCHAR2 --Symbol zlecenia ) IS BEGIN IF psymb = 'SEND_ORZ' THEN HURT.SEW_ODM_SEND_CONFIRM(pDOK_ID,'T'); ELSIF psymb = 'SEND_ZAM' THEN HURT.SEW_ZOD_SEND_CONFIRM(pDOK_ID,'T'); ELSIF psymb = 'SEND_ZOD' THEN HURT.SEW_ZOD_SEND_CONFIRM(pDOK_ID,'T'); END IF; COMMIT; END; CREATE OR REPLACE PROCEDURE SRC_SEND_DOK_CONFIRM_REG_HURT ( pnwbr_dost IN VARCHAR2, --ID KAMSOFT dostawcy pnwbr_odbr IN VARCHAR2, --ID KAMSOFT odbiorcy pdok_id IN VARCHAR2,-- ID dokumentu psymb IN VARCHAR2 --Symbol zlecenia ) IS Strona 19 z 21
DOKUMENTACJA TECHNICZNA BEGIN IF psymb = 'SEND_ORZ' THEN HURT.SEW_ODM_SEND_CONFIRM(pDOK_ID,'R'); ELSIF psymb = 'SEND_ZAM' THEN HURT.SEW_ZOD_SEND_CONFIRM(pDOK_ID,'R'); ELSIF psymb = 'SEND_ZOD' THEN HURT.SEW_ZOD_SEND_CONFIRM(pDOK_ID,'R'); END IF; COMMIT; END; COMMIT 4.3.2. Konfiguracja opcji w W kolejnym kroku po wykonaniu skryptu ustawiamy następujące opcje: W opcji SRC_SEND_DOK_VIEW ustawiamy wartość V_SRC_SEND_DOK_HURT W opcji SRC_SEND_DOK_CONFIRM_REG ustawiamy wartość SRC_SEND_DOK_CONFIRM_REG_HURT Strona 20 z 21
DOKUMENTACJA TECHNICZNA W opcji SRC_SEND_DOK_CONFIRM_PASS ustawiamy wartość SRC_SEND_DOK_CONFIRM_PASS_HURT Strona 21 z 21