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 &quot;Słoneczna&quot;</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

Podobne dokumenty