leki - Apteka
Transkrypt
leki - Apteka
SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 Nr <TOW> SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ 1. INFORMACJE PODSTAWOWE Wymiana danych pomiędzy programem KS-APTEKA Windows odbywa się z wykorzystaniem technologii Web Services (protokół SOAP – Simple Object Access Protocol, więcej informacji na ten temat można znaleźć pod adresem http://www.w3.org/TR/soap). Po stronie programu aptecznego zaimplementowany jest klient usług, zaś po stronie sklepu internetowego konieczne jest zaimplementowanie serwera usług. Rozwiązanie takie jest podyktowane faktem, że wiele aptek jako medium dostępu do Internetu wykorzystuje usługi, które nie gwarantują stałego adresu IP. Klient usług jest wbudowany do modułu APW45 – Apteka internetowa wchodzącego w skład programu KS-APTEKA Windows. Działanie modułu jest możliwe po wykupieniu dodatkowej licencji w firmie KAMSOFT. Jeśli apteka nie posiada licencji na APW45, moduł uruchamia się w trybie demonstracyjnym, co pozwala na testowanie napisanych funkcji wymiany danych mimo pewnych ograniczeń narzucanych przez moduł. APW45 generuje raporty z wymiany danych (pliki XML przekazywane w obu kierunkach), które zapisywane są do katalogu C:\KS\APW\Raporty\iApEwd (przy założeniu, że program apteczny został zainstalowany do domyślnego katalogu). Nazwy plików: Offer_out_1.xml – plik zawierający listę towarów i definicje. W przypadku, gdy razem z towarami przesyłane są opisy lub zdjęcia oferta jest dzielona na części, w wyniku czego powstaje większa ilość kolejno ponumerowanych plików. Orders_in.xml – plik zawiera zamówienia pobrane przez APW45 z serwera, na którym pracuje sklep internetowy. Orders_out_1.xml – zamówienia, które zostały zmodyfikowane w programie aptecznym przesyłane na serwer w celu odnotowania zmian w sklepie internetowym. Zamówienia te dzielone są na części, w wyniku czego może powstać większa ilość kolejno ponumerowanych plików. Oprócz tego do podanego wyżej katalogu zapisywane są tzw. koperty SOAP zwierające informacje o wysłanych i odebranych pakietach danych. Pliki nazywane są wg schematu: SynchEnv_out_yyyymmddhhmmss.xml – dla pakietów wysyłanych, gdzie yyyymmddhhmmss jest oznaczeniem bieżącej daty i czasu z dokładnością do sekund; SynchEnv_in_yyyymmddhhmmss.xml – dla pakietów odbieranych. ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 1 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> 2. USŁUGI WYMIANY DANYCH 2.1. Wymiana danych o ofercie apteki internetowej 2.1.1. SetOffer Argumenty AUserName APassword AOffer string string string Nazwa użytkownika hasło użytkownika informacje o ofercie apteki internetowej Wynikiem wywołania usługi jest wartość logiczna True lub False. Usługa przesyła do serwisu internetowego ofertę apteki w formacie XML. Na ofertę składają się następujące elementy: Wizytówka apteki (dane właściciela apteki internetowej) – znacznik <card>; Definicje form transportu – element <transports>. Poszczególne formy transportu reprezentują elementy <transport>; Definicje form płatności – element <payments>. Poszczególne formy płatności reprezentują elementy <payment>; Definicje krajów – element <countries>. Poszczególne kraje są reprezentowane przez elementy <country>. Pole <code> zawiera kod kraju zgodny z ISO 3166-1 alfa-2. Ze względu na możliwą dużą ilość krajów przesyłane są informacje tylko o krajach aktywnych (dostępnych do wyboru z poziomu sklepu internetowego). Definicje przedziałów opłat za transport – element <transportranges>. Poszczególne przedziały są reprezentowane przez elementy <transportrange>. Znaczenie wybranych elementów opisujących przedział: o <id> - identyfikator przedziału opłat po stronie KS-AOW; o <paymentid> – identyfikator formy płatności (pole <id> elementu <payment> opisującego formę płatności), może być równy 0; o <transportid> – identyfikator formy transportu (pole <id> elementu <transport> opisującego formę transportu), może być równy 0; o <countrycode> – kod kraju (pole <code> elementu <country> opisującego kraj), może być pusty; o <rangestart> – wartość zamówienia od jakiej będzie aktyny dany przedział płatności dla wskazanej formy płatności, formy transportu, kraju i kodów pocztowych; o <price> – opłata za transport; o <codprice> – dodatkowa opłata za pobranie; o <postcodes> - lista kodów pocztowych, wykorzystywana np. w sytuacji, gdy apteka dowozi bezpłatnie własnym transportem zamówione w aptece internetowej leki w obrębie danego miasta. Poszczególne kody pocztowe są oddzielone przecinkami; Towary – element <items>, zawiera następujące atrybuty: o descriptions – informuje czy operator wyraził chęć eksportu opisów towarów („yes” – z opisami, „no” – bez opisów). Jeśli atrybut ma wartość „no” nie ma potrzeby aktualizacji pól z opisami; o photos – informuje czy operator wyraził chęć eksportu zdjęć towarów („yes” – ze zdjęciami, „no” – bez zdjęć). Poszczególne towary reprezentują elementy <item>. Znaczenie wybranych elementów opisujących towar: o <id> – identyfikator towaru w ofercie apteki internetowej po stronie KS-AOW (przegląd w APW45); o <idtowr> – identyfikator towaru w aptecznej bazie towarów; o <nrtowr> – numer apteczny towaru widoczny w programie aptecznym; o <name> – nazwa towaru; o <intname> – nazwa międzynarodowa, o <form> – postać, o <dose> – dawka, o <package> – opakowanie, o <producer> – nazwa podmiotu odpowiedzialnego za dystrybucję towaru na terenie Polski; o <country> – kraj pochodzenia podmiotu odpowiedzialnego; o <bloz07>, <bloz12> – 7 i 12 cyfrowy identyfikator towaru w Ogólnopolskiej Bazie Leków i Środków Ochrony Zdrowia BLOZ tworzonej przez KAMSOFT; o <ean> – kod leku nadany przez Ministerstwo Zdrowia; o <centralcode> – identyfikator towaru w centralnej bazie towarów (np. w sytuacji, gdy apteka prezentuje w Internecie ofertę sieci aptek); o <unit> – jednostka miary, o <price> – cena towaru; ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 2 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> <originalprice> – cena pierwotna; <baseprice> – cena bazowa, na podstawie której jest obliczana cena w ofercie internetowej; <rx> – wskaźnik czy towar jest lekiem sprzedawanym na receptę (0-nie jest, 1-jest); <currentamount> – aktualna ilość towaru na stanie magazynowym apteki (w chwili eksportu oferty); <deleted> – wskaźnik czy towar został ukryty w ofercie. Jeżeli towar został ukryty to nie jest przesyłany jego opis i zdjęcie (przesyłane są puste elementy – <desc /> i <photo />). Jeśli dany towar jest lekiem sprzedawanym tylko na receptę, zestaw informacji opisujących towar jest rozszerzony o następujące pola: o <departmentprice> - cena urzędowa detaliczna nadana przez Ministerstwo Zdrowia; o <limit> - limit cenowy; o <lumpsumamount> - ilość ryczałtowa; o <lumpsumamountchronic> - ilość ryczałtowa dla chorych przewlekle (Tylko wersja 2012); o <deffeewhite> - domyślna odpłatność na receptę białą; o <deffeelong> - domyślna odpłatność na receptę białą dla przewlekle chorych. Pola <deffeewhite> i <deffeelong> mogą przyjmować następujące wartości: ZK – honorowy dawca krwi; IB – inwalida wojenny; IW – inwalida wojskowy; BZ – bezpłatnie z ewentualną dopłatą ponad limit; R – ryczałt; U3 – zniżka 30%; U5 – zniżka 50%; 100 – pełnopłatna – 100%; PO – żołnierz zasadniczej służby wojskowej; AZ – osoba, której przysługuje prawo do otrzymania leków refundowanych na podstawie ustawy o zakazie stosowania wyrobów zawierających azbest. o <storemaxtemp> - maksymalna temperatura przechowywania produktu w stopniach Celsjusza. Jeśli nie ma nałożonego maksymalnego ograniczenia na temperaturę przechowywania produktu, to pole przyjmuje największą dostępna wartość dla skali Celsjusza. *NOWOŚĆ APW45 2012.3.1.0* o <storemintemp> - minimalna temperatura przechowywania produktu w stopniach Celsjusza. Jeśli nie ma nałożonego minimalnego ograniczenia na temperaturę przechowywania produktu, to pole przyjmuje najmniejszą dostępna wartość dla skali Celsjusza. *NOWOŚĆ APW45 2012.3.1.0* o <stockamount> - aktualna ilość towaru na stanie zapasowym magazynu apteki. o <expirydate> - data ważności wybranej dostawy dla sprzedaży internetowej o <supplyamount> - ilość na stanie magazynowym wybranej dostawy dla sprzedaży internetowej o <weight> - waga produktu. o <stockamount> - ilość produktów na magazynach zapasowych. o <kind> - rodzaj produktu. o <suppliername> - nazwa dostawcy. Kategorie towarów – element <groups>. Każdą grupę reprezentuje znacznik <group> zaś pozycje grupy element <items> będący elementem podrzędnym w stosunku do elementu <group>. Pozycje grupy są reprezentowane elementem <item>. Znaczenie elementów opisujących pozycję grupy: o <idiatw> – numer towaru w ofercie apteki internetowej po stronie KS-AOW, o <itemno> – numer kolejny pozycji w grupie; o <deleted> – wskaźnik czy pozycja grupy została usunięta. Informacje o wysyłanych paczkach produktów zapisane są w argumentach znacznika <offer> w polach: o actualPackage – wskaźnik zawierający na numer aktualnie wysyłanej paczki; o countPackage – wskaźnik zawierający ogólną ilość paczek do wysłania; o collectivepackage – opakowanie zbiorcze. Liczba zmiennoprzecinkowa. o size – objętość. Wyrażona w metrach sześciennych. o o o o o Użytkownik programu w momencie wywołania funkcji aktualizacji oferty ma możliwość wyboru elementów oferty, które mają być wysłane na serwer. Jeśli do aktualizacji wybrane zostaną opisy i/lub zdjęcia towarów, oferta jest dzielona na części. W takiej sytuacji pierwsza część oferty zawiera informacje o wizytówce firmy, definicjach form transportu i płatności, państwach i definicje przedziałów opłat za transport oraz pierwszą część informacji o towarach. Ostatnia część zawiera, oprócz informacji o towarach, dane dotyczące kategorii. Opis towaru oraz zdjęcie są zapisane jako dane znakowe CDATA. Zdjęcie jest dodatkowo zakodowane algorytmem BASE64. ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 3 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> Po każdym poprawnym wysłaniu oferty do serwera, w programie KS-AOW zapisywana jest data ostatniego eksportu towarów oraz, osobno, data ostatniego eksportu kategorii. Przy następnej próbie komunikacji zostaną wysłane dane, dla których data modyfikacji będzie nowsza od daty zapisanej w odpowiednich parametrach. Pozostałe dane składające się na ofertę apteki są zawsze wysyłane w całości. Informacja przekazywana argumentem AOffer posiada strukturę zgodną z przykładem przedstawionym poniżej. <?xml version="1.0" encoding="windows-1250"?> <offer actualPackage=”1” countPackage=”1”> *NOWOŚĆ APW45 2013.3.3.0* <card> <id>000001</id> <name1>Apteka "Słoneczna"</name1> <name2>mgr.farm. Jan Kowalski</name2> <name3></name3> <name4></name4> <postcode>40-235</postcode> <city>Katowice</city> <street>ul. 1-go Maja</street> <houseno>133</houseno> <placeno></placeno> <nip>634-013-21-17</nip> <regon>271034150</regon> <phoneno>(032) 209-07-05</phoneno> <faxno>(032) 209-07-15</faxno> <bank>PKO BP</bank> <account>12 1234 5678 1234 3456 5678 7890</account> </card> <transports> <transport> <id>1</id> <name>Poczta Polska</name> <symbol>PP</symbol> <price>6.5</price> <codprice>1.5</codprice> <active>1</active> </transport> </transports> <payments> <payment> <id>1</id> <name>Przelew</name> <symbol>PR</symbol> <active>1</active> </payment> </payments> <countries> <country> <id>4</id> <name>Polska</name> <code>PL</code> </country> <country> <id>29</id> <name>Wielka Brytania</name> <code>UK</code> </country> </countries> <transportranges> <transportrange> <id>1</id> <paymentid>0</paymentid> <transportid>2</transportid> <countrycode>UK</countrycode> <rangestart>0</rangestart> <price>70</price> <codprice>10</codprice> <postcodes>40-655,40-235</postcodes> <deleted>0</deleted> </transportrange> </transportranges> <receivepoints> *NOWOŚĆ <receivepoint> *NOWOŚĆ <id>1</id> *NOWOŚĆ <name>Odbiór 1</name> *NOWOŚĆ <symbol>OD1</symbol> *NOWOŚĆ <city>Odbiór_Miasto</city> *NOWOŚĆ <postcode>40-235</postcode> *NOWOŚĆ ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka APW45 APW45 APW45 APW45 APW45 APW45 APW45 2014.2.0.0* 2014.2.0.0* 2014.2.0.0* 2014.2.0.0* 2014.2.0.0* 2014.2.0.0* 2014.2.0.0* Zatwierdził: Adam Kukowka Strona 4 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> <street>ul. 1-go Maja</street> *NOWOŚĆ APW45 2014.2.0.0* <houseno>133</houseno> *NOWOŚĆ APW45 2014.2.0.0* <placeno></placeno> *NOWOŚĆ APW45 2014.2.0.0* <phoneno>(032) 209-07-05</phoneno> *NOWOŚĆ APW45 2014.2.0.0* <email>[email protected]</email> *NOWOŚĆ APW45 2014.2.0.0* <webaddress></webaddress> *NOWOŚĆ APW45 2014.2.0.0* <deleted>0</deleted> *NOWOŚĆ APW45 2014.2.0.0* </receivepoint> *NOWOŚĆ APW45 2014.2.0.0* </receivepoints> <items> <item> <id>1</id> <idtowr>1</idtowr> <nrtowr>12</nrtowr> <name>Elmex Płyn d/pł.ust Sensitive 400ml</name> <intname>-</intname> <form>-</form> <dose>-</dose> <package>400 ml</package> <producer>GABA INTERNATION.AG</producer> <country>Szwajcaria</country> <bloz07>7028143</bloz07> <bloz12>721310212518</bloz12> <ean>7610108065417</ean> <centralcode>435421</centralcode> <unit>op.</unit> <pkwiu></pkwiu> <vat>22</vat> <price>18.53</price> <originalprice>18.53</originalprice> <baseprice>18.53</baseprice> <rx>0</rx> <departmentprice>0</departmentprice> <limit>0</limit> <lumpsumamount>1</lumpsumamount> <lumpsumamountchronic>1</lumpsumamountchronic> <deffeewhite>100</deffeewhite> <deffeelong>100</deffeelong> <expirydate>2014.08.12</expirydate> *NOWOŚĆ APW45 2014.2.3.0* <supplyamount>5</supplyamount> *NOWOŚĆ APW45 2014.2.3.0* <currentamount>10</currentamount> <stockamount>50</stockamount> *NOWOŚĆ APW45 2013.2.0.1* <weight>650</weight> *NOWOŚĆ APW45 2013.2.0.1* <storemintemp>15</storemintemp> *NOWOŚĆ APW45 2012.3.1.0* <storemaxtemp>25</storemaxtemp> *NOWOŚĆ APW45 2012.3.1.0* <kind>kosmetyk</kind> *NOWOŚĆ APW45 2013.3.2.0* <suppliername>KAMSOFT S.A.</suppliername> *NOWOŚĆ APW45 2013.3.2.0* <collectivepackage>33.00000</collectivepackage> *NOWOŚĆ APW45 2014.3.1.0* <size>23.12</size> *NOWOŚĆ APW45 2014.3.1.0* <deleted>0</deleted> <desc><![CDATA[Opis towaru]]></desc> <photo><![CDATA[Zdjęcie towaru zakodowane algorytmem BASE64]]></photo> </item> </items> <groups> <group> <id>1</id> <parentid>0</parentid> <name>Nowości</name> <symbol>NW</symbol> <deleted>0</deleted> <items> <item> <idiatw>6263</idiatw> <itemno>1</itemno> <deleted>0</deleted> </item> </items> </group> </groups> </offer> ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 5 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> 2.1.2. Opis struktury danych dla pliku offert_out.xml. Zagnieżdżenie Znacznik Typ danych Opis <offer><card> <id> <name1> <name2> <name3> <name4> <postcode> <city> <street> <houseno> <placeno> <nip> <regon> <phoneno> <faxno> <bank> <account> Integer String String String String String String String String String String String String String String String Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Integer String String Float Float Integer Brak Brak Brak Brak Brak Brak Integer String String Float Integer Brak Brak Brak Brak Brak Integer String String Brak Brak Brak <offer><transports><transport> <id> <name> <symbol> <price> <codeprice> <active> <offer><payments><payment> <id> <name> <symbol> <price> <active> <offer><countries><country> <id> <name> <code> <offer><transportranges><transportrange> <id> <name> <symbol> <price> <codprice> <deleted> Integer String String Float Float Integer Brak Brak Brak Brak Brak Brak <offer><receivepoints><receivepoint> <id> <name> <symbol> <city> <postcode> ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Integer String(100) String(5) String(30) String(6) Sprawdził: Adam Kukowka Brak Brak Brak Brak Brak Zatwierdził: Adam Kukowka Strona 6 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <street> <houseno> <placeno> <phoneno> <email> <webaddress> <deleted> String(30) String(7) String(7) String(20) String(100) String(100) Integer <id> <idtowr> <nrtowr> <name> <intname> <form> <dose> <package> <producer> <country> <bloz07> <bloz12> <ean> <centralcode> <unit> <pkwiu> <vat> <price> <originalprice> <rx> <departmentprice> <limit> <lumpsumamount> <lumpsumamountchronic> <deffeewhite> <deffeelong> <expirydate> <supplyamount> <currentamount> <stockamount> <weight> <storemintemp> <storemaxtemp> <kind> <suppliername> <collectivepackage> <size> <deleted> <desc> <photo> Integer Integer Integer String String String String String String String String String String Integer String String String Float Float Integer Float Float Float Float Float Float String(Date) Float Float Float Integer Float Float String String Float Float Integer BLOB BLOB <TOW> Brak Brak Brak Brak Brak Brak Brak <offer><items><item> Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak np. 2006.07.29 Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak <offer><groups><group> <id> <parentid> <symbol> <deleted> Integer Integer String Integer Brak Brak Brak Brak Integer String String Brak Brak Brak <offer><groups><group><items><item> <id> <name> <code> ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 7 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> 2.2. Wymiana danych o zamówieniach 2.2.1. GetOrders Argumenty: AUserName APassword ALastOrderId string string integer nazwa użytkownika hasło użytkownika numer ostatniego poprawnie odebranego zamówienia Usługa zwraca informacje w postaci ciągu znaków (string) w formacie XML o zamówieniach złożonych przez klientów sklepu internetowego. Odpowiedź powinna zawierać zamówienia o identyfikatorach wyższych od podanego argumentem ALastOrderId. Pojedyncze zamówienie jest reprezentowane przez znacznik <order>. Pola <name1> do <placeno> w nagłówku zamówienia służą do przekazania alternatywnego odbiorcy oraz adresu dostawy, jeśli mają być inne niż te zapisane przy kliencie (pole <customer>). W przypadku, gdy pola te będą puste, program wypełnia te pola danymi odczytanymi z opisu klienta. Działanie takie związane jest z faktem, że do dalszej obsługi zamówień, np. drukowanie listów przewozowych, wykorzystywane są dane odbiorcy i adres dostawy z nagłówka zamówienia. Ponadto element <order> zawiera następujące informacje: o <remarks> – uwagi do zamówienia; o <orderrebate> – wartość rabatu do zamówienia, jeśli nie został on wliczony w ceny poszczególnych pozycji; o <transportprice> – opłata za transport, jeśli wartość tego pola jest równa zero, to program podczas importu zamówień próbuje określić wysokość opłaty za transport na podstawie informacji zapisanych w APW45; o <codprice> – dodatkowa opłata za przesyłkę za pobraniem, jeśli równe zero to zasady jak wyżej; o <transportrebate> – wartość rabatu na transport; o <epayed> – informacja, że zamówienie zostało opłacone za pomocą płatności elektronicznych, np. przelewy24 (0-nie zostało opłacone, 1-zostało opłacone); takie zamówienie zostanie w APW45 oznaczone statusem „Nowe (zapłacone)”. o <nick> – informacja, że zamówienie zostało zakupione przez portal Allegro. o <numberosoz> -Numer karty OSOZ przypisany do pacjenta o <weight> – waga przesyłki. o <fvvat> – znacznik faktury (wpływa na wydruk zamówienia). Zarządzane wartości: a) 0 – brak zinfromacji o fakturze (brak infromacji na wydruku) b) 1 – faktura vat (na wydruku napis FV VAT) c) 2 – faktura dla osób fizycznych (na wydruku napis FV FIZ) o <feature> - cecha zamówienia (wpływa na zarządzanie zamówieniami). Zarządzane wartości i ich prezentacja w przeglądzie zamówień: a) 0 – brak oznaczenia. b) 1 – MM (czarna ramka z białym tłem i z napisem MM). c) 2 – MM + FV (czarna ramka z białym tłem i z napisem MM+FV) d) 3 – VIP (napis VIP niebieska czcionka) e) 4 – WERYFIKACJA (trzy wykrzykniki !!!, czerwona czcionka) Klient, który złożył zamówienie reprezentowany jest przez znacznik <customer>. Informacje o klientach zapisywane są do aptecznej bazy pacjentów. Klient jest identyfikowany na podstawie pola „login” odpowiadającego nazwie konta klienta w sklepie internetowym. W następnej kolejności klient jest identyfikowany po adresie e-mail oraz po danych adresowych. Po jakich polach klient będzie rozpoznawany w bazie aptecznej definiujemy w rozszerzonych opcjach dla komunikacji w module apteki internetowej. Jeśli w aptecznej bazie pacjentów zostanie odnaleziony klient o podanym loginie to jego dane są aktualizowane na podstawie danych dostarczonych z zamówieniem, w przeciwnym wypadku zakładana jest nowa karta pacjenta. Klient jest rozpoznawany w charakterze pacjenta, jeśli jest wypełnione pole <pesel>. Znowu, jeśli jest wprowadzona wartość dla pola <regon>, a pole <pesel> jest niewypełnione, to klient jest traktowany w charakterze odbiorcy. *NOWOŚĆ APW45 2012.3.1.0* Formy płatności (pole <payment>) i transportu (pole <transport>) identyfikowane są za pomocą pola <symbol>. Pole <name> jest przekazywane w celach informacyjnych W celu poprawnego powiązania konieczne jest w programie aptecznym stworzenie odpowiadających definicji dokumentów pieniężnych oraz definicji form transportu. ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 8 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> Zamawiane towary mogą być identyfikowane na trzy sposoby: o Pole <idtowr> – klient usług spodziewa się w tym miejscu identyfikatora towaru z aptecznej bazy towarów. Rozwiązanie takie może być stosowane przez apteki, które ofertę apteki internetowej budują za pomocą panelu administracyjnego sklepu internetowego; o Pole <idiatw> – klient usług spodziewa się w tym miejscu identyfikatora towaru pochodzącego ze zbudowanej w programie APW45 oferty apteki internetowej; o Pola <bloz07> i <bloz12> –siedmio i dwunastocyfrowy identyfikator towaru pochodzący z bazy BLOZ. o Pole <centralcode> – identyfikator towaru w centralnej bazie towarów (np. w sytuacji, gdy apteka prezentuje w Internecie ofertę sieci aptek); W przypadku, gdy żaden z wymienionych wyżej identyfikatorów nie zostanie określony lub klient nie odnajdzie w bazie towarów odpowiadającej pozycji, użytkownik programu KS-AOW ma możliwość ręcznego powiązania pozycji zamówienia z pozycją aptecznej bazy towarów. Informacja zwrotna powinna mieć strukturę zgodną z poniższym przykładem: <?xml version="1.0" encoding="windows-1250"?> <orders> <order> <id>4478</id> <number>4478</number> <date>2006-07-28T08:12:22</date> <status>0</status> <name1>Kowalski</name1> <name2>Jan</name2> <country></country> <city>Katowice</city> <postcode>40-235</postcode> <street>ul. 1-go Maja</street> <houseno>133</houseno> <placeno></placeno> <phoneno>(032) 209 07 05</phoneno> *NOWOŚĆ APW45 2015.3.1.0* <email>[email protected]</email> *NOWOŚĆ APW45 2015.3.1.0* <remarks>Uwagi dotyczące zamówienia</remarks> <orderrebate>0.00</orderrebate> <transportprice>6.50</transportprice> <codprice>3.50</codprice> <transportrebate>0.00</transportrebate> <epayed>0</epayed> <weight>20.30</weight> *NOWOŚĆ APW45 2013.2.1.0* <fvvat>2</fvvat> *NOWOŚĆ APW45 2013.2.3.0* <feature>3</feature> *NOWOŚĆ APW45 2013.3.2.0* <customer> <id>2274</id> <name1>Przedsiębiorstwo Informatyczne</name1> <name2>Kamsoft</name2> <country></country> <city>Katowice</city> <postcode>40-235</postcode> <street>ul. 1-go Maja</street> <houseno>133</houseno> <placeno></placeno> <nip></nip> <regon></regon> <phoneno>(032) 209 07 05</phoneno> <mobileno></mobileno> <faxno>(032) 209 07 15</faxno> <email>[email protected]</email> <login>ksadmin</login> <pesel>49040501580</pesel> *NOWOŚĆ APW45 2012.3.1.0* <nick>ksallegro</nick> *NOWOŚĆ APW45 2012.3.3.0* <numberosoz>1234512345</numberosoz> *NOWOŚĆ APW45 2014.3.0.0* </customer> <payment> <id>2</id> <symbol>ZP</symbol> <name>Za pobraniem</name> </payment> <transport> <id>4</id> <symbol>PP</symbol> <name>Poczta Polska</name> ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 9 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> </transport> <receivepoint> *NOWOŚĆ APW45 2014.2.0.0* <id>1</id> *NOWOŚĆ APW45 2014.2.0.0* <symbol>OD1</symbol> *NOWOŚĆ APW45 2014.2.0.0* <name>Odbiór 1</name> *NOWOŚĆ APW45 2014.2.0.0* </receivepoint> *NOWOŚĆ APW45 2014.2.0.0* <items> <orderitem> <itemno>1</itemno> <idtowr>4321</idtowr> <idiatw></idiatw> <quantity>2</quantity> <price>12.09</price> <bloz07>8052711</bloz07> <bloz12>224780211395</bloz12> <name>2 KC Xtreme 12 tabl.</name> <producer>Zakłady farmaceutyczne Colfarm, Polska</producer> <centralcode>1240</centralcode> <expirydate>2013-07-28</expirydate> *NOWOŚĆ APW45 2013.2.1.0* </orderitem> </items> </order> </orders> 2.2.2. Opis struktury danych dla pliku orders_in.xml. Zagnieżdżenie Znacznik Typ danych Opis <orders><order> <id> <number> <date> <status> <name1> <name2> <country> <city> <postcode> <street> <houseno> <placeno> <remarks> <orderrebate> <transportprice> <codprice> <transportrebate> <epayed> <weight> <fvvat> <feature> String(40) String(25) String(DateTime) Integer String(80) String(80) String(128) String(50) String(20) String(100) String(7) String(7) Blob Double Double Double Double Integer Double Integer Integer Brak Brak Np. 2006.07.28 08:12:22 Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak <orders><order><customer> <id> <name1> <name2> <country> <city> <postcode> <street> <houseno> <placeno> <nip> ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Integer String(40) String(40) String(128) String(30) String(6) String(30) String(7) String(7) String(14) Sprawdził: Adam Kukowka Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Zatwierdził: Adam Kukowka Strona 10 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <regon> <phoneno> <mobileno> <faxno> <email> <login> <pesel> <nick> <numberosoz> String(20) String(20) String(20) String(20) String(128) String(50) String(11) String(128) String(30) Brak Brak Brak Brak Brak Brak Brak Brak Brak Integer String(50) String(80) Brak Brak Brak Integer String(5) String(80) Brak Brak Brak Integer String(5) String(100) Brak Brak Brak <TOW> <orders><order><payment> <id> <symbol> <name> <orders><order><transport> <id> <symbol> <name> <offer><order><receivepoint> <id> <symbol> <name> <orders><order><items><orderitem> <itemno> <idtowr> <idiatw> <quantity> <price> <bloz07> <bloz12> <name> <producer> <centralcode> <expirydate> ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Integer Integer Integer Integer Double String(7) String(12) String(100) String(128) Integer String(Date) Sprawdził: Adam Kukowka Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak np. 2006.07.29 Zatwierdził: Adam Kukowka Strona 11 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> 2.2.3. SetOrders Argumenty: AUserName APassword AOrders string string string nazwa użytkownika hasło użytkownika informacje o zamówieniach, w których zaszły zmiany w aptece Usługa przekazuje do sklepu internetowego (argument AOrders) informacje o zamówieniach, które uległy zmianom w programie APW45. Zmianą taką może być: Przypisanie towaru do pozycji zamówienia; Zmiana statusu zamówienia; Wystawienie listu przewozowego do zamówienia. Wynikiem wywołania usługi jest wartość logiczna True lub False. Struktura informacji przekazywanych do serwera usług jest podobna do struktury informacji zwracanych przez usługę GetOrders. Zestaw informacji opisujących zamówienie jest rozszerzony o pole <deleted> informujące o usunięciu zamówienia (przyjmuje wtedy wartość „1”). Ponadto, przy każdym zamówieniu, przekazywana jest informacja o numerze wystawionego listu przewozowego oraz dacie jego wystawienia (pole <letter>). W polu <status> dla znacznika <order> przekazywany jest aktualny status zamówienia w programie KS-AOW. Pole to może przyjmować jedną z poniższych wartości: 0 – Nowe (niezrealizowane), 1 – Potwierdzone (niezrealizowane), 2 – W trakcie realizacji, 3 – Zafakturowane, 4 – Wysłane, 5 – Wstrzymane, 6 – Odrzucone, 7 – Odebrane, *NOWOŚĆ APW45 2013.2.0.1* 8 – Spakowane. *NOWOŚĆ APW45 2013.2.0.1* 9 – Zapraszamy po odbiór *NOWOŚĆ APW45 2014.2.0.1* 10 – Sprawdzone *NOWOŚĆ APW45 2014.3.0.0* W polu <status> dla znacznika <orderitem> przekazywany jest aktualny status pozycji dla zamówienia w programie KS-AOW. Pole to może przyjmować jedną z poniższych wartości: 0 – w realizacji (pozycja zamówienia czeka na zarezerwowanie), 1 – zarezerwowany (pozycja zamówienia w pełni zarezerwowana), 2 – niedostępny (rezygnacja z pozycji zamówienia). Po każdym poprawnym wysłaniu zamówień do serwera, w programie KS-AOW zapisywana jest data ostatniego przesłania danych. Przy następnej próbie komunikacji zostaną wysłane zamówienia, dla których data modyfikacji będzie nowsza od daty zapisanej. ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 12 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> Informacja przekazywana argumentem AOrders ma następującą postać: <?xml version="1.0" encoding="windows-1250"?> <orders> <order> <id>190</id> <number>4478</number> <date>2006.07.28 08:12:22</date> <status>4</status> <name1>Kowalski</name1> <name2>Jan</name2> <country></country> <city>Katowice</city> <postcode>40-235</postcode> <street>ul. 1-go Maja</street> <houseno>133</houseno> <placeno></placeno> <phoneno>(032) 209 07 05</phoneno> *NOWOŚĆ APW45 2015.3.1.0* <email>[email protected]</email> *NOWOŚĆ APW45 2015.3.1.0* <remarks>Uwagi dotyczące zamówienia</remarks> <orderrebate>0.00</orderrebate> <transportprice>6.50</transportprice> <codprice>3.50</codprice> <transportrebate>0.00</transportrebate> <epayed>0</epayed> *NOWOŚĆ APW45 2013.2.0.1* <deleted>0</deleted> <customer> <id>780</id> <name1>Przedsiębiorstwo Informatyczne</name1> <name2>Kamsoft</name2> <country></country> <city>Katowice</city> <postcode>40-235</postcode> <street>ul. 1-go Maja</street> <houseno>133</houseno> <placeno></placeno> <nip></nip> <regon></regon> <phoneno>(032) 209 07 05</phoneno> <mobileno></mobileno> <faxno>(032) 209 07 15</faxno> <email>[email protected]</email> <login>ksadmin</login> <pesel>49040501580</pesel> *NOWOŚĆ APW45 2012.3.1.0* <nick>ksallegro</nick> *NOWOŚĆ APW45 2012.3.3.0* <numberosoz>1234512345</numberosoz> *NOWOŚĆ APW45 2014.3.0.0* </customer> <payment> <id>102</id> <symbol>ZP</symbol> <name>Za pobraniem</name> </payment> <transport> <id>4</id> <symbol>PP</symbol> <name>Poczta polska</name> </transport> <receivepoint> *NOWOŚĆ APW45 2014.2.0.0* <id>1</id> *NOWOŚĆ APW45 2014.2.0.0* <symbol>OD1</symbol> *NOWOŚĆ APW45 2014.2.0.0* <name>Odbiór 1</name> *NOWOŚĆ APW45 2014.2.0.0* </receivepoint> *NOWOŚĆ APW45 2014.2.0.0* <items> <orderitem> <itemno>1</itemno> <idtowr>4321</idtowr> <idiatw></idiatw> <quantity>2</quantity> <price>12.09</price> <bloz07>8052711</bloz07> <bloz12>224780211395</bloz12> <name>2 KC Xtreme 12 tabl.</name> <producer>Zakłady farmaceutyczne Colfarm, Polska</producer> <status>1</status> <centralcode>1240</centralcode> </orderitem> </items> ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 13 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> <letter> <number>159007733334347449</number> <date>2006.07.29</date> </letter> </order> </orders> 2.2.4. Opis struktury danych dla pliku orders_out.xml. Zagnieżdżenie Znacznik Typ danych Opis <orders><order> <id> <number> <date> <status> <name1> <name2> <country> <city> <postcode> <street> <houseno> <placeno> <remarks> <orderrebate> <transportprice> <codprice> <transportrebate> <epayed> <deleted> String(40) String(25) String(DateTime) Integer String(80) String(80) String(128) String(50) String(20) String(100) String(7) String(7) Blob Double Double Double Double Integer Integer Brak Brak Np. 2006.07.28 08:12:22 Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak <orders><order><customer> <id> <name1> <name2> <country> <city> <postcode> <street> <houseno> <placeno> <nip> <regon> <phoneno> <mobileno> <faxno> <email> <login> <pesel> <nick> <numberosoz> Integer String(40) String(40) String(128) String(30) String(6) String(30) String(7) String(7) String(14) String(20) String(20) String(20) String(20) String(128) String(50) String(11) String(128) String(30) Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Integer String(50) String(80) Brak Brak Brak Integer String(5) String(80) Brak Brak Brak <orders><order><payment> <id> <symbol> <name> <orders><order><transport> <id> <symbol> <name> ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 14 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> <offer><order><receivepoint> <id> <symbol> <name> Integer String(5) String(100) Brak Brak Brak <orders><order><items><orderitem> <itemno> <idtowr> <idiatw> <quantity> <price> <bloz07> <bloz12> <name> <producer> <status> <centralcode> Integer Integer Integer Integer Double String(7) String(12) String(100) String(128) Integer Integer Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak Brak <orders><order><letter> <number> <date> String(25) String(Date) Brak np. 2006.07.29 2.3. WSDL Interfejs serwera wymiany danych powinien być zgodny z dokumentem WSDL (Web Service Definition Language) przedstawionym poniżej: <?xml version="1.0"?> <definitions name="iShopService" targetNamespace="urn:iShopService" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="urn:iShopService" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns="http://schemas.xmlsoap.org/wsdl/"> <types xmlns="http://schemas.xmlsoap.org/wsdl/" /> <message name="GetOrdersRequest"> <part name="AUserName" type="xsd:string" /> <part name="APassword" type="xsd:string" /> <part name="ALastOrderId" type="xsd:int" /> </message> <message name="GetOrdersResponse"> <part name="return" type="xsd:string" /> </message> <message name="SetOrdersRequest"> <part name="AUserName" type="xsd:string" /> <part name="APassword" type="xsd:string" /> <part name="Orders" type="xsd:string" /> </message> <message name="SetOrdersResponse"> <part name="return" type="xsd:boolean" /> </message> <message name="SetOfferRequest"> <part name="AUserName" type="xsd:string" /> <part name="APassword" type="xsd:string" /> <part name="Offer" type="xsd:string" /> </message> <message name="SetOfferResponse"> <part name="return" type="xsd:boolean" /> </message> <portType name="iShopServicePort"> <operation name="GetOrders"> <input message="tns:GetOrdersRequest" /> <output message="tns:GetOrdersResponse" /> </operation> <operation name="SetOrders"> <input message="tns:SetOrdersRequest" /> <output message="tns:SetOrdersResponse" /> </operation> <operation name="SetOffer"> <input message="tns:SetOfferRequest" /> <output message="tns:SetOfferResponse" /> ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 15 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> </operation> </portType> <binding name="iShopServiceBinding" type="tns:iShopServicePort"> <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http" /> <operation name="GetOrders"> <soap:operation soapAction="urn:SOAP_ISHOP#soap_ishop_server#GetOrders" /> <input> <soap:body use="encoded" namespace="urn:SOAP_ISHOP" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> </input> <output> <soap:body use="encoded" namespace="urn:SOAP_ISHOP" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> </output> </operation> <operation name="SetOrders"> <soap:operation soapAction="urn:SOAP_ISHOP#soap_ishop_server#SetOrders" /> <input> <soap:body use="encoded" namespace="urn:SOAP_ISHOP" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> </input> <output> <soap:body use="encoded" namespace="urn:SOAP_ISHOP" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> </output> </operation> <operation name="SetOffer"> <soap:operation soapAction="urn:SOAP_ISHOP#soap_ishop_server#SetOffer" /> <input> <soap:body use="encoded" namespace="urn:SOAP_ISHOP" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> </input> <output> <soap:body use="encoded" namespace="urn:SOAP_ISHOP" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> </output> </operation> </binding> <service name="iShopServiceService"> <documentation /> <port name="iShopServicePort" binding="tns:iShopServiceBinding"> <soap:address location="https://www.apteka.pl/connect/ishopservice.php" /> </port> </service> </definitions> ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 16 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> 3. APW45 – APTEKA INTERNETOWA 3.1. Konfiguracja parametrów połączenia Parametry związane z połączeniem klienta usług z serwerem należy określić w module APW45. Odpowiednia funkcja dostępna jest pod pozycją „Ustawienia” w menu „Komunikacja” (rys. 1). Rys. 1. Okno ustawień komunikacji. Należy określić wartości pól: Apteka internetowa – w polu tym należy wskazać wartość „Inna”; Adres serwera wymiany danych – w to pole należy wpisać adres dokumentu WSDL opisującego usługę; Hasło – hasło przekazywane jako argument funkcji wymiany danych. Oprócz hasła, funkcje wymiany danych wymagają także podania nazwy użytkownika. Jako nazwę użytkownika program przekazuje do usługi sześciocyfrowy numer apteki nadany przez firmę KAMSOFT. Numer ten można znaleźć na zakładce „Licencja” wizytówki apteki (rys. 2) dostępnej w module APW41 – Administrator. Rys. 2. Informacja o identyfikatorze apteki w wizytówce. ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 17 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> Oprócz parametrów wymienionych powyżej, dostępne są także parametry mające wpływ na zachowanie funkcji wymiany danych. Dostęp do tych ustawień można uzyskać po naciśnięciu kombinacji klawiszy Ctrl+Alt+U w oknie na rys. 1. W wyniku wywołania kombinacji klawiszy wygląd okna przyjmie postać widoczną na rys. 3. Rys. 3. Parametry wymiany danych. Za pomocą parametrów w sekcji „Oferta” można sterować funkcją wymiany danych o ofercie apteki internetowej: o Liczba towarów w paczce – określa ilość towarów jaka zostanie jednorazowo przesłana argumentem AOffer funkcji SetOffer (wartość domyślna – 250); o Data eksportu towarów – określa datę ostatniego wysłania towarów do sklepu internetowego. Przy następnym wywołaniu funkcji SetOffer wysłane zostaną tylko towary, które uległy modyfikacjom po tej dacie. Jeśli zajdzie potrzeba wysłania pełnej oferty należy wyczyścić zawartość tego pola; o Data eksportu kategorii – parametr analogiczny do poprzedniego, przy czym dotyczy kategorii towarów. Sekcja „Zamówienia” zawiera opcje mające wpływ na działanie funkcji wymiany danych o zamówieniach: o Nr ostatnio odebranego – numer zamówienia (element <id> elementu <order>), które zostało jako ostatnie odebrane ze sklepu internetowego. Zmieniając wartość tej opcji można zmienić zakres danych importowanych do APW45; o Liczba zamówień w paczce – podobnie jak w przypadku oferty, zmodyfikowane w aptece zamówienia są dzielone na części. W jednym wywołaniu funkcji SetOrders przekazana zostanie ilość zamówień określona niniejszym parametrem (wartość domyślna – 250); o Data ostatniego importu – informacja o dacie ostatniego importu zamówień do APW45; o Data ostatniego eksportu – data ostatniego wywołania funkcji SetOrders. Przy następnym wywołaniu funkcji wysłane zostaną tylko zamówienia, które uległy zmianie od tej daty. Zmiana wartości tego parametru wpływa na ilość przekazywanych zamówień do sklepu internetowego. ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 18 z 19 SPECYFIKACJE SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ ISO 9001:2000 Dokument: 1 Wydanie: 2014-01-13 Waga: 60 <TOW> 3.2. Funkcje wymiany danych Funkcje związane z wymianą danych zgrupowane zostały w menu „Komunikacja” modułu APW45 (rys. 4). Rys. 4. Funkcje wymiany danych w APW45. Do dyspozycji są następujące funkcje: Pobierz zamówienia – wywołanie funkcji powoduje w pierwszym kroku przesłanie na serwer informacji o zamówieniach, które uległy zmianie w aptece, a następnie pobranie z serwera nowych zamówień. Pobierz opinie o towarach – funkcja umożliwia pobranie wpisanych przez klientów apteki internetowej opinii dotyczących poszczególnych towarów. Po zatwierdzeniu przez operatora opinie są prezentowane pozostałym klientom wraz z opisem towaru, którego dotyczą (funkcja niezaimplementowana). Pobierz bazę adresów funkcji Newsletter – funkcja pobiera z serwisu internetowego adresy e-mail klientów, którzy wyrazili chęć otrzymywania nowinek dotyczących apteki (funkcja niezaimplementowana). Aktualizuj ofertę – wywołanie funkcji powoduje wysłanie na serwer informacji o ofercie apteki internetowej utworzonej w APW45. Po wywołaniu funkcji wyświetlane jest okno (rys. 5), w którym użytkownik decyduje jakie elementy oferty mają zostać zaktualizowane. Rys. 5. Wybór elementów do aktualizacji. W przypadku zaznaczenia opcji „Aktualizuj zdjęcia zapisane w katalogu” na serwer wysyłane będą także zdjęcia zapisane w katalogu określonym opcją „Ścieżka do katalogu ze zdjęciami towarów” w oknie ustalania reguł budowania oferty apteki internetowej. ApwWebSrv_iApteka_2015_02_2713 Wykonał: Adam Kukowka Sprawdził: Adam Kukowka Zatwierdził: Adam Kukowka Strona 19 z 19