Opis usugi iKlientService v 0.9.

Usuga iKlientService

Alfa-Projekt Warszawa 2013

Opis usugi iKlientService v 0.9.1 Spis treci

1 KONTROLA DOKUMENTU .............................................................................................................................. 3 2 SKRCONY OPIS USUGI ............................................................................................................................... 4 3 METODY ........................................................................................................................................................ 5 4 METODA ZAPISZLIST. ................................................................................................................................... 7 5 METODA WYDRUKJETYKIETE ..................................................................................................................... 11 6 METODA WYDRUKJETYKIETEPACZKI.......................................................................................................... 11 7 METODA WYDRUKJLIST ............................................................................................................................. 12 8 METODA UTWORZDOKUMENTWYDANIA.................................................................................................. 12 9 METODA POBIERZNUMERDOKUMENTULIST ............................................................................................. 12 10 METODA POBIERZDOKUMENTWYDANIA ................................................................................................ 12 11 METODA STATUSYPRZESYLKI................................................................................................................... 14 12 METODA DODAJKLIENTA ........................................................................................................................... 15 13 METODA EDYTUJKLIENTA .......................................................................................................................... 16 14 METODA SZUKAJKLIENTA .......................................................................................................................... 16 15 LISTA KODW BDU ZWRACANYCH PRZEZ METODY WYKORZYSTANE W IKLIENTSERVICE. ..................... 17 16 DODATEK A: OGRANICZENIA PL W METODZIE ZAPISZLIST ...................................................................... 19

Kontrola dokumentu
Autor Opis zmian Utworzenie dokumentu Dodanie numeru zewntrznego dla podpaczki. Dodanie wydruku etykiety dla podpaczki.

Wersja Data 0.9.0 17.06.2013 0.9.0 13.08.2013 0.9.1 21.10.2013

2 Skrcony opis usugi

Usuga iKlientService pozwala na zbudowanie wasnego i dopasowanego do swoich potrzeb oprogramowania do drukowania listw przewozowych. W ramach usugi udostpniamy metody, ktre odzwierciedlaj funkcjonalnoci aplikacji iKlient, dodatkowo wszystkie listy utworzone poprzez iKlientService mog by drukowane/podgldane/raportowane bezporednio z aplikacji iKlient.

Schemat komunikacji wyglda nastpujco: 1. Z oprogramowania klienta wysyane s dane o licie przewozowym (metoda: zapiszList): dane odbiorcy, usugi, dane kontaktowe itp. W odpowiedzi z naszego serwera zostaje przesany numer listu przewozowego (oraz numery podpaczek jeeli zostay zaczone do komunikatu). 2. Po otrzymaniu numeru, moemy wydrukowa etykiet metoda: wydrukjEtykiete (w odpowiedzi przesane bd dane gotowe do przesania na port drukarki) 3. Nastpnie pozostanie przygotowanie dokumentu wydania za pomoc pozostaych metod.

Szerszy opis metod i przykadowe komunikaty znajduj si w dalszej czci instrukcji.

3 Metody
Metody dostpne s za pomoc standardowych mechanizmw WebService za porednictwem protokou SOAP.

W skad metod udostpnianych przez usug iKlientService wchodz: zapiszList (przygotowanie listu przewozowego) wydrukjEtykiete (wydruk etykiety, dostpne formaty: EPL,ZPL,PDF,PNG) wydrukjEtykietePaczki (wydruk etykiety dla jednej podpaczki, dostpne formaty: EPL,ZPL,PDF,PNG) wydrukjList (wydruk listu A4 w formacie PDF) zapiszDokumentWydania (przygotowanie Dokumentu Wydania Paczek) pobierzNumerDokumentuList (pobranie numeru Dokumentu Wydania Paczek) pobierzDokumentWydania (pobranie Dokumentu Wydania Paczek) pobierzStatusyPrzesylki (pobranie statusw przesyki) dodajKlienta (Metoda pozwala na dodanie odbiorcy lub nadawcy gotwkowego) szukajKlienta (Metoda pozwala na wyszukiwanie danych odbiorcy lub nadawcy gotwkowego) edytujKlienta (Metoda pozwala na edycj danych odbiorcy)

Metoda zapiszList

Parametry Dane o licie

Wynik

Opis

wydrukjEtykiete

Numer listy Metoda suy do: (numer Wygenerowania podpaczek numeru listu opcjonalnie) przewozowego Wygenerowania numerw podpaczek (jeeli zawarte w wywoaniu) Obliczenia wag gabarytowych (jeeli zawarte w wywoaniu) Numer listu Etykieta w postaci Metoda suy do przewozowego binarnej (TXT,PDF wygenerowania lub PNG) wydruku etykiety, dostpne formaty:

Metoda wydrukjEtykietePaczki

Parametry Numer paczki

Wynik

Opis EPL,ZPL,PDF,PNG.

wydrukjList

Numer listu przewozowego

zapiszDokumentWydania

Numery listw

pobierzNumerDokumentuList Numer listu

pobierzDokumentWydania

Numer dokumentu wydania Numer listu przewozowego

pobierzStatusyPrzesylki

dodajNadawce

Dane nadawcy

dodajKlienta

Dane odbiorcy/ nadawcy Nowe odbiorcy/ nadawcy dane

edytujKlienta

szukajKlienta

Niepene dne odbiorcy/nadawcy

Etykieta w postaci Metoda suy do binarnej (TXT,PDF wygenerowania lub PNG) wydruku etykiety dal pojedynczej paczki, dostpne formaty: EPL,ZPL,PDF,PNG. List przewozowy Metoda suy do (PDF w postaci wygenerowania binarnej) wydruku listu w formacie A4 Dokument Wygenerowanie Wydania Paczek dokumentu wydania (PDF w postaci paczek z zaczonymi binarnej) listami podanymi w parametrach wywoania Numer Metoda pobiera numer dokumentu dokumentu wydania na wydania ktrym zawarty jest numer listu podany w parametrach Dokument Wygenerowanie Wydania Paczek dokumentu wydania (PDF w postaci paczek o numerze binarnej) podanym w parametrach Lista (bd Metoda pobiera ca pojedynczy) list statusw bd tylko statusw danej ostatni stan dla danej przesyki przesyki Dane nadawcy Metoda pozwala na uzupenione o dodanie nadawcy lub jego numer nadawcy gotwkowego Zaktualizowane Metoda pozwala na dane dodanie odbiorcy lub odbiorcy/nadawcy nadawcy gotwkowego Zaktualizowane Metoda pozwala na dane edycj danych odbiorcy odbiorcy/nadawcy lub nadawcy gotwkowego Dane Metoda pozwala na odbiorcy/nadawcy wyszukiwanie danych odbiorcy lub nadawcy gotwkowego

4 Metoda zapiszList.
Metoda suy do wprowadzenia do aplikacji iKlientService informacji o licie przewozowym, na ktrym ma zosta wykonana usuga transportowa. Informacj zwrotn jest nadany numer przesyki lub komunikat bdu.

4.1 Przykadowy komunikat .xml

<zapiszList xmlns="http://ws.alfaprojekt.com/"> <kodDostepu xmlns="">25384472862AC7DF68DEC78A19475552</kodDostepu> <przesylka xmlns=""> <nrPrzesylki></nrPrzesylki> <nrExt></nrExt> <formaPlatnosci>P</formaPlatnosci> <rodzajPrzesylki>K</rodzajPrzesylki> <placi>1</placi> <nadawca> <numer>124</numer> <imie></imie> <nazwisko></nazwisko> <nazwa></nazwa> <telKontakt></telKontakt> <emailKontakt></emailKontakt> </nadawca> <odbiorca> <numer></numer> <nrExt></nrExt> <nazwa></nazwa> <czyFirma>0</czyFirma> <nip></nip> <imie>Jan</imie> <nazwisko>Testowy</nazwisko> <miasto>Parczew</miasto> <kod>21-200</kod> <kodKraju></kodKraju> <ulica>Kolejowa</ulica>

<nrDom>12</nrDom> <nrLokal></nrLokal> <telKontakt></telKontakt> <emailKontakt></emailKontakt> </odbiorca> <platnik> <numer></numer> <telKontakt></telKontakt> </platnik> <potwierdzenieNadania> <podpisNadawcy>Alfowy</podpisNadawcy> <numerKuriera>12</numerKuriera> <dataNadania>2013-03-08 17:00</dataNadania> </potwierdzenieNadania> <uslugi> <pobranie> <formaPobrania></formaPobrania> <kwotaPobrania></kwotaPobrania> <nrKonta></nrKonta> </pobranie> <ubezpieczenie> <kwotaUbezpieczenia></kwotaUbezpieczenia> <opisZawartosci></opisZawartosci> </ubezpieczenie> <zwrotDokumentow>0</zwrotDokumentow> <zwrotKopiListu>0</zwrotKopiListu> <doreczeniaAdresPrywatny>0</doreczeniaAdresPrywatny> <doreczeniaSiecHandlowa>0</doreczeniaSiecHandlowa> <potwDostEmail>0</potwDostEmail> <potwNadEmail>0</potwNadEmail> <zastrzDorNaGodzine>0</zastrzDorNaGodzine> <zastrzDorDoGodziny>0</zastrzDorDoGodziny> <zastrzDorNaDzien>B</zastrzDorNaDzien> <ud01></ud01> <ud02></ud02> <ud03></ud03> <ud04></ud04> <ud05></ud05> <ud06></ud06> <ud07></ud07>

<ud08></ud08> <ud09></ud09> <ud10></ud10> <ud11></ud11> <ud12></ud12> <ud13></ud13> <ud14></ud14> <ud15></ud15> <ud16></ud16> <ud17></ud17> <ud18></ud18> <ud19></ud19> <ud20></ud20> </uslugi> <paczki> <paczka> <nrpp></nrpp> <typ>PC</typ> <waga>3</waga> <gab1>20</gab1> <gab2>30</gab2> <gab3>40</gab3> <ksztalt>0</ksztalt> <wagaGabaryt></wagaGabaryt> <nrExtPp>WZ127834/15A</nrExtPp> </paczka> </paczki> <uwagi></uwagi> <mpk></mpk> </przesylka> </zapiszList>

Naley pamita aby pomidzy znacznikami: <dataNadania>2009-10-22 18:00</ns1:dataNadania> Znajdowaa si aktualna data nadania przesyki, w przypadku gdy wpiszemy dat wsteczn bdzie zwrcony komunikat z bdem.

Ograniczenia co do wprowadzanych wartoci przedstawione s w dodatku A.

4.2 Uwagi
Standardowo obsugiwane s nastpujce definicje wartoci null (pustej)
<zastrzDorNaDzien xsi:nil="1"/> <zastrzDorNaGodz xsi:nil="1"/>

lub
<zastrzDorNaDzien xsi:nil="true"/> <zastrzDorNaGodz xsi:nil="true"/>

Jeli implementacja wywoywania metod WebService nie obsuguje takiego wywoania to mona uy poniszych wartoci dla podanych usug:
warto pola zastrzDorNaDzien - moe przybiera wartoci - S - sobota, N - niedziela, B - brak lub standardowo null (<zastrzDorNaDzien xsi:nil="true"/>) warto pola zastrzDorNaGodz - moe przybiera godzinowe przy czym warto 0, 00:00, 00 jest traktowana jako brak usugi. Standardowo mona uy "wartoci" null (<zastrzDorNaGodz xsi:nil="true"/>)

10

4.3 Sowniki

wykorzystane

typach
= = = = = = = = = = = = = = =

komunikatu

XML.
"0"; "1"; "G"; "P"; "L"; "K"; "1"; "2"; "3"; "B"; "P"; "KP"; "PC"; "PL"; "S";

TN_TYPE_NIE TN_TYPE_TAK FORMA_PLATNOSCI_TYPE_GOTOWKA FORMA_PLATNOSCI_TYPE_PRZELEW RODZAJ_PRZESYLKI_TYPE_LOKALNA RODZAJ_PRZESYLKI_TYPE_KRAJOWA PLACI_TYPE_NADAWCA PLACI_TYPE_ODBIORCA PLACI_TYPE_PLATNIK FORMA_POBRANIA_TYPE_BANK FORMA_POBRANIA_TYPE_PRZEKAZ PACZKA_TYP_KOPERTA PACZKA_TYP_PACZKA PACZKA_TYP_PALETA ZASTRZ_DOR_NA_DZIEN_SOBOTA ZASTRZ_DOR_NA_DZIEN_NIEDZIELA = "N";

5 Metoda wydrukjEtykiete
Metoda suy do pobrania z aplikacji iKlient wydruku etykiet 10 cm x 10 cm w zadanym formacie. Dostpne formaty: EPL, ZPL200, ZPL300, PDF, PNG. Informacj zwrotn jest etykieta w postaci binarnej w danym formacie lub komunikat bdu. Etykiety EPL i ZPL zwracane s jako plik TXT. Plik zwrotny zakodowany jest w formacie base64Binary.

Parametry: numerPrzesyki numer listu przewozowego, ktry chcemy wydrukowa kodDostepu -klucz API do usug iKlientService format format wydruku, dostpne formaty: EPL, ZPL200, ZPL300, PDF, PNG

6 Metoda wydrukjEtykietePaczki
Metoda suy do pobrania z aplikacji iKlient wydruku etykiet dla pojedynczej paczki (moe by pomocna przy obsudze wydruku etykiet dla przesyek wielopaczkowych. Rozmiar etykiety 10 cm x 10 cm w zadanym formacie. Dostpne formaty: EPL, ZPL200, ZPL300, PDF, PNG. Informacj zwrotn jest etykieta w postaci binarnej w danym formacie lub komunikat bdu. Etykiety EPL i ZPL zwracane s jako plik TXT. Plik zwrotny zakodowany jest w formacie base64Binary.

Parametry: numerPaczki numer paczki, ktry chcemy wydrukowa kodDostepu -klucz API do usug iKlientService format format wydruku, dostpne formaty: EPL, ZPL200, ZPL300, PDF, PNG

11

7 Metoda wydrukjList
Metoda suy do pobrania z aplikacji iKlientService wydruku listu przewozowego w formacie A4, na ktrym/ych ma zosta wykonana usuga transportowa. Informacj zwrotn jest dokument PDF w postaci binarnej (zakodowany base64Binary) lub komunikat bdu.

Parametry: numerPrzesyki numery listw ktre chcemy wydrukowa kodDostepu -klucz API do usug iKlientService

8 Metoda utworzDokumentWydania
Metoda suy do wygenerowania w aplikacji iKlientService dokumentu wydania na podstawie podanego zakresu listw przewozowych oraz jego pobrania . Informacj zwrotn dane binarne (PDF - base64Binary) z dokumentem wydania.

Parametry: kurier - nr kuriera numeryPrzesylek - wykaz numerw listw do zaczenia na dokumencie wydania kodDostepu -klucz API do usugi WS separator - separator numerw listw

9 Metoda pobierzNumerDokumentuList
Metoda ta suy do pobrania numeru dokumentu wydania paczek. Jako parametr przekazujemy numer przesyki ktra zaczona jest w podanym dokumencie
Parametry: numerPrzesyki numer listu ktry jest zawarty do dokumentu kodDostepu -klucz API

10 Metoda pobierzDokumentWydania
Metoda suy do pobrania wygenerowanego wczeniej w aplikacji iKlientService dokumentu wydania na podstawie numeru dokumentu wydania. Informacj zwrotn dane binarne (PDF - base64Binary) z dokumentem wydania.

Parametry: 12

numerDokumentu numer dokumentu (taki jak na PDF-ie) kodDostepu -klucz do usugi WS

13

11 Metoda statusyPrzesylki
Metoda umoliwia ledzenie stanu (statusu) przesyki z poziomu usug iKlientService. Dziki tej metodzie jestemy w stanie pobra ca list statusw bd najbardziej aktualny (ostatni) sterowanie parametrem wywoania. Dziki tej metodzie mog Pastwo sprawdzi statusy przesyek w Pastwa aplikacjach bez wykonywania dodatkowych czynnoci. Parametry: numerPrzesyki numer listu przewozowego czyOstatni parametr pozwalajcy okreli czy zwracana bdzie caa lista statusw (0) czy tylko ostatni najbardziej aktualny (1) kodDostepu -klucz WebAPI

14

12 Metoda dodajKlienta
Metoda suy do dodania do bazy danych klientw gotwkowych. Dane wejciowe s

przekazywane w postaci struktury, ktra jest take wykorzystywana do edycji klienta i wyszukiwania klienta. Zwracana jest analogiczna struktura z uzupenionym numerem klienta. Struktura komunikatu z danymi klienta przedstawia si nastpujco: <ulica> - dane adresowe (ulica) <emailKontakt> - e-mail kontaktowy <imie> - imi (w przypadku osb fizycznych) <numer> - numer klienta <nazwisko> - nazwisko (w przypadku osb fizycznych) <nrDom> - dane adresowe (nr domu) <nrLokal> - dane adresowe (nr lokalu) <kod> - dane adresowe (kod pocztowy) <nrExt> - numer zewntrzny numer nadawany przez klienta do atwego wyszukiwania <nazwa> - nazwa klienta (nazwa firmy) <telKontakt> - telefon kontaktowy <nip> - nr NIP (bez kresek) <czyFirma> - znacznik czy firma (wartoci 1 lub T oznacza firm) <kodKraju> - dwuliterowy kod kraju domylnie PL <miasto> - dane adresowe (miasto) <fax> - numer faksu <telefonKom> - numer telefonu komrkowego <czyNadawca> - znacznik czy klient jest nadawc (1 lub T) .

Uwagi do funkcjonowania metody: 1. Przy dodawaniu nadawcy gotwkowego uytkownik musi mie nadane uprawnienia
do uywania tej metody.

2. Po zapisie zwracane s dane klienta z uzupenionym numerem klienta 3. W przypadku osb fizycznych pola imi i nazwisko s zamieniane na pen nazw klienta (w komunikacie zwrotnym pole nazwa jest uzupenione, pola imi i nazwisko s wyczyszczone).

Przykadowy komunikat .xml

<dodajKlienta xmlns="http://ws.alfaprojekt.com/"> <kodDostepu xmlns="">25384472862AC7DF68DEC78A19475552</kodDostepu> <klient xmlns=""> <numer></numer> <nrExt></nrExt> <nazwa></nazwa> <czyFirma>0</czyFirma>

15

<nip></nip> <imie>Jan</imie> <nazwisko>Testowy</nazwisko> <miasto>Parczew</miasto> <kod>21-200</kod> <kodKraju></kodKraju> <ulica>KOlejowa</ulica> <nrDom>12</nrDom> <nrLokal></nrLokal> <telKontakt></telKontakt> <emailKontakt></emailKontakt> <czyNadawca>0</czyNadawca> <fax></fax> <telefonKom></telefonKom> </klient> </dodajKlienta>

13 Metoda edytujKlienta
Metoda suy do edycji danych klienta. W celu edycji naley poda dane klienta jak w opisanych wyej metodach dodajKlienta, ale naley take uzupeni pole numer klienta (patrz opis metody do wyszukiwania klienta). Zwracana struktura zawiera nowe dane i ewentualnie NOWY numer klienta

Uwagi do funkcjonowania metody: 1. Metoda suy do edycji nadawcw i odbiorcw gotwka

TYLKO z form patnoci

2. Uytkownik musi mie nadane uprawnienia do uywania tej metody.

3. Jeli dane klienta byy ju zapisane w systemie Centralnym to edytowany klient bdzie mia nadany nowy numer, a jego nieaktualna wersja bdzie oznaczona jako skasowana (nie bdzie dostpna do wybrania np. z wyszukiwarki w iKlientService). Na starych listach przewozowych bdzie funkcjonowaa wersja klienta sprzed zmiany

14 Metoda szukajKlienta
Metoda suy do wyszukiwania danych klienta. Parametry wyszukiwania podajemy w strukturze analogicznej jak w opisanych wyej metodach (np. dodajKlienta). Zwracana jest lista obiektw o strukturze jak opisano w metodzie dodajKlienta.

16

Uwagi do funkcjonowania metody: 1. Metoda suy do wyszukiwania nadawcw i odbiorcw TYLKO z form patnoci gotwka 2. Wyszukiwanie jest wykonywane wg pl jak poniej: <numer> - numer klienta <nrExt> - numer zewntrzny numer nadawany przez klienta do atwego wyszukiwania <nazwa> - nazwa klienta - naley poda minimalnie 3 znaki <miasto> - naley poda minimalnie 3 znaki <ulica> - naley poda minimalnie 3 znaki <nip> - nr NIP (bez kresek) - naley poda minimalnie 3 znaki <czyNadawca> - znacznik czy klient jest nadawc (1 lub T) l 3. Jeli podano warto dla ktregokolwiek z tych pl: <numer>, <nrExt>, <nip>, <nazwa> to wyszukiwanie odbdzie si po jednym z tych kryteriw 4. Jeli nie podano numeru klienta <numer> czy numeru zewntrznego (<nrExt>) to wyszukiwanie wg ulicy czy miasta wymaga podania co najmniej trzech parametrw jednoczenie np. ulicy, miasta, pocztku nazwy 5. Wyszukiwanie jest prowadzone w dwch trybach (parametr tryb) warto 1 dokadny np. wyszukiwanie wg nazwy dla podanej nazwy ALA zostan znalezione tylko dane klientw z nazw ALA. W trybie drugim (parametr tryb 2) znalezione zostan dane klientw z nazw zaczynajc si na podany napis ALA (np. ALABAMA itp.).

15 Lista kodw bdu zwracanych przez metody wykorzystane w iKlientService.

0001 Prosz jeszcze raz sprawdzi wypeniony formularz. <!-- %s //--> 0002 Pole %s ma za dug warto. 0003 Pole "%s" jest za dugie (>%s). 0004 Pole "%s" ma zy format. 0005 Pole "%s" jest wymagane. 1002 Bdne dane nadawcy - za stacja nadania. 1003 Bdne dane odbiorcy - za stacja odbioru. 1004 Nie wybrano nadawcy. 1005 Nie wybrano odbiorcy. 1006 Nie wybrano patnika. 1007 Nie wybrano osoby kontaktowej nadawcy. 1008 Nie wybrano osoby kontaktowej odbiorcy. 1009 Nie wybrano osoby kontaktowej patnika. 1010 Brak wprowadzonej nazwy penej odbiorcy. 1011 Brak wprowadzonej ulicy odbiorcy. 1012 Brak wprowadzonego nr domu odbiorcy. 1013 Brak lub bdny kod pocztowy odbiorcy. 1014 Brak wprowadzonego miasta odbiorcy.

17

1015 Bdny NIP odbiorcy. 1016 czna ilo paczek i palet przy imporcie nie moe przekracza %s. 1017 Brak okrelonej liczby paczek lub palet. 1018 czna ilo paczek i palet nie moe przekracza %s. 1019 Przy pobraniu i formie pobrania konto naley poda numer konta. 1020 Numer konta jest za krtki. Numer konta powinien zawiera 26 cyfr. 1021 Numer konta jest niepoprawny lub niezgodny ze standardami NRB lub IBAN. 1022 Przesyka za pobraniem musi by ubezpieczona. 1023 Przy pobraniu naley zdeklarowa warto pobrania. 1025 Kwota pobrania musi by formatu 99,99. 1026 Przy ubezpieczeniu naley zdeklarowa warto przesyki. 1027 Kwota ubezpieczenia musi by formatu 99,99. 1029 Kwota ubezpieczenia nie moe by mniejsza jak kwota pobrania. 1030 Przy ubezpieczeniu naley poda zawarto paczki. 1031 Data nadania musi by nastpujcego formatu RRRR-MM-DD GG:MI. 1032 Brak daty nadania. 1033 Godzina nadania musi by rna od 00:00. 1034 Nieaktualna data nadania. 1035 Data nadania nie moe wybiega w przyszo dalej ni 14 dni. 1036 Brak podpisu nadawcy. 1037 Podpis nadawcy musi zawiera co najmniej dwa znaki. 1038 Brak wprowadzonej cznej wagi paczek. 1039 czna waga paczek jest za dua. 1040 Brak wprowadzonej cznej wagi paczek powyej 30 kg. 1041 Waga paczek powyej 30 kg jest za maa. 1042 Brak wprowadzonej cznej wagi palet. 1043 czna waga palet jest za dua. 1044 Godzina przy zastrzeeniu dorczenia musi by z zakresu 00-23. 1045 W tabeli wag i iloci paczek ktre z pl ma niepoprawn warto. 1047 Brak wprowadzonego telefonu odbiorcy. 1048 Brak wprowadzonego telefonu nadawcy. 1049 Przy wybranej usudze 'Potwierdzenie dostawy na SMS' naley poda poprawny numer telefonu komrkowego (9 cyfr bez numeru kierunkowego). 1050 Brak wprowadzonego e-mail nadawcy. 1051 Wprowadzony e-mail nadawcy jest niepoprawny. 1052 Brak wprowadzonego e-mail odbiorcy. 1053 Wprowadzony e-mail odbiorcy jest niepoprawny. 1054 Brak wprowadzonej odlegoci. 1060 Nadawca moe paci tylko przelewem. 1061 Odbiorca moe paci tylko gotwk. 1062 Trzeci patnik moe paci tylko przelewem. 1064 Wprowadzono kopert/palet, opcja ksztat dostpna jest tylko dla paczek, zmie typ podpaczki! 1065 Dla iloci paczek wikszej ni 1, dane dotyczce ksztatu/wymiarw paczki naley wprowadzi w oknie podpaczek. 1066 Numer kuriera ma niewaciwy format. 1067 Musisz poda numer kuriera. 1068 Nie mona wybra jednoczenie usug: "doreczeniaSiecHandlowa" i "doreczeniaAdresPrywatny". 1069 Nie mona nada przesyki zagranicznej. Usuga niedostpna.

18

2001 Brak nazwiska. 2002 Brak imienia. 2003 Brak nazwy klienta. 2004 Brak NIPu. 2005 NIP jest niepoprawny. 2006 Brak kodu pocztowego. 2007 Kod pocztowy jest niepoprawny. 2008 Brak miasta. 2009 Brak ulicy. 2010 Brak nr domu. 2011 Brak telefonu. 2012 Wprowadzony e-mail jest niepoprawny. 2013 Wprowadzony e-mail osoby kontaktowej jest niepoprawny. 2014 Musisz poda nazwisko osoby kontaktowej. 2015 Wprowadzony telefon komrkowy osoby kontaktowej jest niepoprawny (9 cyfr bez numeru kierunkowego). 2016 Wprowadzony telefon komrkowy jest niepoprawny (9 cyfr bez numeru kierunkowego). 3001 Wprowadzony e-mail osoby kontaktowej jest niepoprawny. 3002 Musisz poda nazwisko osoby kontaktowej. 3003 Wprowadzony telefon komrkowy osoby kontaktowej jest niepoprawny (9 cyfr bez numeru kierunkowego). 4001 Nie wybrano adnej podpaczki. 4002 Bdna waga podpaczki nr %s. 4003 Bdna dugo podpaczki nr %s. 4004 Bdna szeroko podpaczki nr %s. 4005 Bdna wysoko podpaczki nr %s. 4006 Brak podanej wagi dla paczki nr %s. 4007 Brak podanej dugoci podpaczki nr %s. 4008 Brak podanej szerokoci podpaczki nr %s. 4009 Brak podanej wysokoci podpaczki nr %s. 4013 Typ ksztat moe mie tylko paczka (podpaczka nr %s).

16 Dodatek A: ograniczenia pl w metodzie zapiszList

Lp Nazwa pola Wartoci dozwolone Czy wyma gane N Opis

sekcja <przesylka> Dane o przesyce

<nrPrzesylki> nr przesyki uzupeniany po prawidowym wywoaniu metody numerem listu nadawanym przez usug iKlientService. numer zewntrzny np. zlecenia klienta. Pole do dyspozycji klienta

<nrExt>

30 znakw alfanumeryczny ch

19

Lp

Nazwa pola
<mpk>

Wartoci dozwolone
10 znakw alfanumeryczny ch

Czy wyma gane N

Opis
miejsce powstawania kosztw. Pole do dyspozycji klienta do wykorzystania w ramach rozlicze midzyoddziaowych rodzaj przesyki: K krajowa, L lokalna, kto paci za usug: 1 nadawca, 2 odbiorca, 3 trzeci patnik forma patnoci za przesyk: G gotwka, P przelew uwagi klienta odnonie przesyki numer nadawcy nazwisko osoby nadajcej przesyk imi osoby nadajcej przesyk telefon kontaktowy osoby nadajcej przesyk email osoby nadajcej przesyk numer odbiorcy w systemie iKlientService uzupeniany po dodaniu nowego kontrahenta do bazy danych numer zewntrzny (np. w systemie nadawcy). Pole do dyspozycji klienta znacznik czy odbiorca jest firm 1 tak 0 nie nazwa odbiorcy numer NIP odbiorcy (bez kresek) nazwisko odbiorcy imi odbiorcy

<rodzajPrzesylki>

1 litera

T T

<placi>

1 cyfra

<formaPlatnosci>

1 litera

<uwagi> sekcja <nadawca> dane nadawcy <numer> <nazwisko> <imie> <telKontakt> <emailKontakt> sekcja <odbiorca> - dane odbiorcy <numer>

200 znakw

N T N N N N N

10 cyfr 100 znakw 50 znakw 20 znakw 80 znakw

<nrExt>

<czyFirma>

10 znakw alfanumeryczny ch 1 cyfra

N T

<nazwa> <nip> <nazwisko> <imie>

150 znakw 10 cyfr 95 znakw 50 znakw

T N N N

Lp

Nazwa pola
<kodKraju> <kod>

Wartoci dozwolone
zgodnie z ISO 3166-1 alfa-2 6 znakw

Czy wyma gane T T T T T N N N T/N N

Opis
kod kraju odbiorcy kod pocztowy odbiorcy w formacie XX-XXX (gdzie x jest cyfr od 0 do 9) miasto odbiorcy ulica odbiorcy nr domu odbiorcy nr lokalu odbiorcy telefon kontaktowy odbiorcy adres email odbiorcy numer klienta patnika w systemie centralnym (CSK) telefon kontaktowy do patnika kwota ubezpieczenia przesyki opis zawartoci przesyki wymagany przy ubezpieczeniu kwota pobrania (separator dziesitny przecinek). Max. 11 000 PLN. Powyej 6000 PLN wymagane zaznaczenie usugi <odbWlas> forma zwrotu pobrania do nadawcy P przekaz pocztowy, B przelew bankowy (konieczne podanie numeru konta) numer konta w formacie IBAN potwierdzenie nadania przesyki na podany adres e-mail. Dopuszczalne wartoci 0 nie 1 - tak

<miasto> <ulica> <nrDom> <nrLokal> <telKontakt> <emailKontakt> sekcja <platnik> - dane patnika <numer> <telKontakt>

70 znakw 70 znakw 20 znakw 10 znakw 20 znakw 40 znakw 10 cyfr 50 znakw

sekcja <ubezpieczenie> - Dana o ubezpieczeniu przesyki

<kwotaUbezpieczenia> <opisZawartosci> 200 znakw

T/N T/N

sekcja <pobranie> - dane o pobraniu <kwotaPobrania>

Max 8 cyfr w tym dwie po przecinku

T/N

<formaPobrania>

1 litera

T/N

<nrKonta> <potwNadEmail>

26 cyfr 1 cyfra

T/N T

sekcja <uslugi> - dane usug

21

Lp

Nazwa pola
<zwrotDokumentow> <zwrotKopiListu> <doreczeniaAdresPrywatny> <doreczeniaSiecHandlowa> <potwDostEmail> <potwNadEmail> <ud01> <ud20:

Wartoci dozwolone
1 cyfra

Czy wyma gane T

Opis
0 nie 1 tak

Rezerwa, obecnie niewykorzystywane. <zastrzDorNaGodz> GG zastrzeenie dorczenie T przesyki na godzin, Dopuszczalne wartoci pene godziny np. 7 lub 14. 00:00 brak usugi 0 brak usugi <zastrzDorNaDzien> 1 litera zastrzeenie dorczenie T przesyki na dzie wolny, Dopuszczalne wartoci B brak usugi N niedziela S sobota sekcja <paczki> - lista paczek skadajca si z powtarzajcych si sekcji <paczka>. Musi wystpi przynajmniej jedna sekcja <paczka> <nrpp> 13 cyfr nr paczki uzupeniany po prawidowym wywoaniu metody <typ> 2 litery typ paczki. T Dopuszczalne wartoci PC paczka PL paleta KP koperta <waga> 5 cyfr (w tym waga paczki (w kg) T jedna cyfra po przecinku) <gab1> max. 5 cyfr dugo (w cm) T <gab2> max. 5 cyfr szeroko (w cm) T <gab3> max. 5 cyfr wysoko (w cm) T <ksztalt> 1 cyfra czy paczka posiada T nietypowy ksztat (np. wystajce elementy). Dopuszczalne wartoci 0 nie 1 - tak <wagaGabaryt> max 5 cyfr (w waga gabarytowa paczki tym jedna cyfra (obliczana (gab1 * gab2 * po przecinku) gab3) / 6000) pole wyliczane

22

Lp

Nazwa pola
<nrExtPp>

Wartoci dozwolone
max 50 znakw

Czy wyma gane

Opis
Numer zewntrzny przypisany do podpaczki

sekcja <potwierdzenieNadania> <dataNadania>

YYYY-MM-DD HH24:MI

<numerKuriera> <podpisNadawcy>

6 cyfr 50 znakw

T T

data nadania przesyki w formacie YYYY-MM-DD HH24:MI np. 2009-08-25 17:00 Data nie moe by mniejsza ni obecna. numer kuriera podejmujcego przesyk podpis nadawcy (np. nazwisko osoby nadajcej przesyk)

23