ServiceWersus
The following operations are supported. For a formal definition, please review the Service Description.
-
Autoryzacja
usługa do ustalenia zgodnosci hasla dla identyfikatora
Parametry wywołania :- IdentyfikatorUżytkownika - identyfikator nadany przez admnistratora usługi
- Hasło - hasło użytkownika
usługa zwraca true jeśli jest zgodne, lub false jeśli niezgodne
-
CzyDziala
usługa do ustalenia czy dzialają usługi WebSerwice
usługa zwraca 1 jeśli jest działa, lub nic jeśli nie
zwraca bool czy jest w spisie miejscowości
usługa zwraca nadrzędne właściwości kodu (Województwo/Powiat/Kod( (z bazy kodów)
Parametry wywołania :
- IdentyfikatorUżytkownika - identyfikator podany podczas rejestracji lub pusty string
- HasłoUżytkownika - hasło podane podczas rejestracji pusty string (demo)
- Kod - kod pocztowy dla którego chcemy poznać właściwości
usługa zwraca string Województwo+#+Powiat+#+Gmina
usługa do ustalenia nazwy, danych adresowych i konta bankowego (PIT) dla urzędu skarbowego na podstawie jego 4-ro cyfrowego symbolu
Parametry wywołania :
- Numer - identyfikator urzędu nadany przez Ministerstwo Finansów (specyfikacja)
usługa zwraca string[] {KodBledu,NazwaUrzedu,Ulica,Dom,KodPocztowy,Miejscowość,NumerKontaBankowego,DodatkoweZakodowaneInformacje}
Kody błędów :
- 0 - operacja poprawna
- 1 - nieznany błąd
- 2 - brak w bazie podanego symbolu urzędu
zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji bazy właściwości
zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji słownika gmin
zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji Kodow Ubezpieczenia
zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji Kodow Zawodu
zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji Kodow Ubezpieczenia
zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji PPK
zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji słownika powiatów
zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji słownika urzędów skarbowych
zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji słownika województw
usługa zwraca właściwości jednoznacznej miejscowości (z bazy miejscowośc)
Parametry wywołania :
- IdentyfikatorUżytkownika - identyfikator podany podczas rejestracji lub pusty string
- HasłoUżytkownika - hasło podane podczas rejestracji pusty string (demo)
- Miejscowość - miejscowość dla której chcemy poznać właściwości (wojowództwo/powiat/gmina)
usługa zwraca string Województwo+#+Powiat+#+Gmina
usługa do ustalenia niewykorzystanej liczby zapytań dla wskazanego użytkownika
Parametry wywołania :
- IdentyfikatorUżytkownika - identyfikator nadany przez admnistratora usługi
usługa zwraca string[] {LiczbaPozostalychZapytan,DataKoncowaLimitu,CzyJestNastepnyLimit(1-tak,0-nie)
usługa administracyjna do ustalenia dostępności zasobu
Parametry wywołania :
- Identyfikator/b> - identyfikator admnistratora usługi
- Hasło - hasło administratora
- Zasób - cechy zasobu rozdzielane znakiem #
- Aplikacja - symbol aplikacji
- Licencja - numer licencji
- Klucz - numer klucza
usługa zwraca true jeśli zasób dostępny lub false jeśli niedostępny
usługa administracyjna do ustalenia dostępności zasobu
Parametry wywołania :
- Identyfikator/b> - identyfikator admnistratora usługi
- Hasło - hasło administratora
- Zasób - cechy zasobu rozdzielane znakiem #
- Aplikacja - symbol aplikacji
- Licencja - numer licencji
- Klucz - numer klucza
- WersjaSystemuCPW - numer wersji cpw
- WersjaSystemuWin - nazwa systemu Windows
- WersjaBit - rodzaj systemu Windows 32/64
usługa zwraca true jeśli zasób dostępny lub false jeśli niedostępny
usługa testowa
usługa testowa 2
usługa pomocnicza do podpowiedzi właściwej ulicy (z bazy kodów)
Parametry wywołania :
- IdentyfikatorUżytkownika - identyfikator podany podczas rejestracji lub pusty string
- HasłoUżytkownika - hasło podane podczas rejestracji pusty string (demo)
- Miejscowość - nazwa miejscowości dla której poszukujemy kodu
- Województwo - województwo
- Powiat - powiat
- Gmina - gmina
- Miejscowość -miesjcowosc
- Ulica - ulica do weryfikacji
usługa zwraca string[] {Ulica,...})
Ograniczenia w wersji demo - tylko gminy rozpoczynające sie na A-B oraz ulice w miastach z wieloma kodami rozpoczynające się na A-B
usługa pomocnicza do podpowiedzi właściwej ulicy (z bazy kodów)
Parametry wywołania :
- IdentyfikatorUżytkownika - identyfikator podany podczas rejestracji lub pusty string
- HasłoUżytkownika - hasło podane podczas rejestracji pusty string (demo)
- Miejscowość - nazwa miejscowości dla której poszukujemy kodu
- Województwo - województwo
- Powiat - powiat
- Gmina - gmina
- Miejscowość -miesjcowosc
- Ulica - ulica do weryfikacji
- zgodnosc - istnienie zgodnej zapewnia zgodność
usługa zwraca string[] {Ulica,...})
Ograniczenia w wersji demo - tylko gminy rozpoczynające sie na A-B oraz ulice w miastach z wieloma kodami rozpoczynające się na A-B
usługa zwraca właściwości kodu (z bazy kodów)
Parametry wywołania :
- IdentyfikatorUżytkownika - identyfikator podany podczas rejestracji lub pusty string
- HasłoUżytkownika - hasło podane podczas rejestracji pusty string (demo)
- Kod - kod pocztowy dla którego chcemy poznać właściwości
usługa zwraca string[] {Województwo,Powiat,Gmina,Miejscowość,Ulica,TypNumeru,ZakresOd-Do})
Ograniczenia w wersji demo - tylko gminy rozpoczynające sie na A-B oraz ulice w miastach z wieloma kodami rozpoczynające się na A-B
usługa do ustalenia kodu pocztowego
Parametry wywołania :
- IdentyfikatorUżytkownika - identyfikator podany podczas rejestracji lub pusty string
- HasłoUżytkownika - hasło podane podczas rejestracji pusty string (demo)
- Miejscowość - nazwa miejscowości dla której poszukujemy urzędu
- Województwo - opcjonalnie województwo (przy powtarzających sie gminach)
- Powiat - opcjonalnie powiat (przy powtarzających sie gminach)
- Gmina - nazwa gminy, jesli niewprowadzona to przyjęta z pola Miejscowość
- Ulica - opcjonalna ulica (dla miast z wieloma kodami)
- Dom - opcjonalny numer domu (dla ulic o róznych kodach)
usługa zwraca string[] {KodBłedu,...(zależy od otrzymanego kodu błędu, patrz niżej)
Kody błędów :
- 0 - operacja jednoznacznie poprawna
- KodPocztowy - string z numerem kodu pocztowego w formacie 99-999
... = KodPocztowy}
Ograniczenia w wersji demo - tylko gminy rozpoczynające sie na A-B oraz ulice w miastach z wieloma kodami rozpoczynające się na A-B
usługa do ustalenia numer urzędu skarbowego zgodny ze specyfikacją Ministerstwa Finansów (e-Deklaracje)
Parametry wywołania :
- IdentyfikatorUżytkownika - identyfikator podany podczas rejestracji lub pusty string (demo)
- HasłoUżytkownika - hasło podane podczas rejestracji pusty string (demo)
- IdentyfikatorPrzypisania - wcześniej zwrócony przez usługę identyfikator przypisania urzędu, jeśli identyfikator bieżącego przypisania będzie identyczny (dla takiego samego adresu taki sam urząd) system nie policzy tego jako wykonanie usługi
- Miejscowość - nazwa miejscowości dla której poszukujemy urzędu
- Województwo - opcjonalnie województwo (przy powtarzających sie gminach)
- Powiat - opcjonalnie powiat (przy powtarzających sie gminach)
- Gmina - nazwa gminy, jesli niewprowadzona to przyjęta z pola Miejscowość (demo)
- Ulica - opcjonalna ulica (dla miast wielourzędowych)
- Dom - opcjonalny numer domu (dla ulic przynależnych do różnych urzędów)
usługa zwraca string[] {KodBłedu,...(zależy od otrzymanego kodu błędu, patrz niżej)
Kody błędów :
- 0 - operacja jednoznacznie poprawna
- KodPrzypisu - zaszyfrowany identyfikator przypisania urzędu skarbowego na podstawie podanych danych adresowych
- KodUrzędu - string z numerem urzędu skarbowego zgodny ze specyfikacją Ministerstwa Finansów (e-Deklaracje)
- Województwo - województwo przypisane do właściwości urzędu
- Powiat - powiat przypisany do właściwości urzędu
- Gmina - gmina przypisana do właściwości urzędu
- 1 - niejednoznaczne określenie gminy
- 2 - brak w bazie podanej gminy
- 3 - niepełne określenie ulicy (wiele podpowiedzi, działa przy podaniu conajmniej 5 znaków nazwy ulicy), operacja trwa dłużej niż inne
- 4 - brak w bazie podanej ulicy, problem dla urzędów dzielonych, zwraca kod błędu, Wojewodztwo, Powiat, Gminę
- 5 - zapytanie przekracza ograniczenie wersji demo
- 6 - ulica dzielona pomiędzy urzędy, potrzebne podanie numeru domu
- 7 - niejednoznaczne określenie gminy (wiele podpowiedzi, działa przy podaniu conajmniej 5 znaków nazwy gminy)
- 8 - wyczerpany limit zapytań
- 9 - nieznany błąd
- 10 - operacja poprawna (na podstawie gminy) ale brak zgodności przynależności miejscowości do gminy/powiat/województwa, zwraca wartości takie jak kod 0
- 11 - niejednoznaczność przy próbie określenia gminy na podstawie miejscowości - miejscowość występuje w wielu województwach
- 12 - niejednoznaczność przy próbie określenia gminy na podstawie miejscowości - miejscowość występuje w wielu powiatach województwa (musi być podane województwo
- 13 - niejednoznaczność przy próbie określenia gminy na podstawie miejscowości - miejscowość występuje w wielu gminach powiatu (musi być podana powiat i województwo
- 14 - niepełne określenie miejscowości (wiele podpowiedzi, działa przy podaniu conajmniej 5 znaków nazwy miejscowości), operacja trwa dłużej niż inne
- 15 - brak w bazie podanej miejscowości
- 16 - brak zgodności przynależności miejscowości do gminy/powiat/województwa
... = KodUrzędu,KodPrzypisu,Województwo,Powiat,Gmina}
... = Gmina/Powiat1/Wojewodztwo1,Gmina/Powiat2/Wojewodztwo2,ewGmina/ewPowiat3/ewWojewodztwo3,...}
... = Ulica1,Ulica2,ewUlica3,...}
... = Gmina1,Gmina2,ewGmina3,...}
... = KodUrzędu,KodPrzypisu,Województwo,Powiat,Gmina}
... = Województwo1,Województwo2,ewWojewództwo3,...}
... = Powiat1/Województwo,Powiat2/Województwo,ewPowiat3/Województwo,...}
... = Gmina1,Gmina2,ewGmina3,...}
... = Miejscowość1,Miejscowość2,ewMiejscowość3,...}
Ograniczenia w wersji demo - tylko gminy rozpoczynające sie na A-B oraz ulice w miastach wielourzędowych rozpoczynające się na A-B
usługa do ustalenia numer urzędu skarbowego zgodny ze specyfikacją Ministerstwa Finansów (e-Deklaracje)
Parametry wywołania :
- IdentyfikatorUżytkownika - identyfikator podany podczas rejestracji lub pusty string (demo)
- HasłoUżytkownika - hasło podane podczas rejestracji pusty string (demo)
- Miejscowość - nazwa miejscowości dla której poszukujemy urzędu
- Województwo - opcjonalnie województwo (przy powtarzających sie gminach)
- Powiat - opcjonalnie powiat (przy powtarzających sie gminach)
- Gmina - nazwa gminy, jesli niewprowadzona to przyjęta z pola Miejscowość (demo)
- Ulica - opcjonalna ulica (dla miast wielourzędowych)
- Dom - opcjonalny numer domu (dla ulic przynależnych do różnych urzędów)
usługa zwraca string[] {KodBłedu,...(zależy od otrzymanego kodu błędu, patrz niżej)
Kody błędów :
- 0 - operacja jednoznacznie poprawna
- Województwo - województwo przypisane do właściwości urzędu
- Powiat - powiat przypisany do właściwości urzędu
- Gmina - gmina przypisana do właściwości urzędu
- 1 - niejednoznaczne określenie gminy
- 2 - brak w bazie podanej gminy
- 3 - niepełne określenie ulicy (wiele podpowiedzi, działa przy podaniu conajmniej 5 znaków nazwy ulicy), operacja trwa dłużej niż inne
- 4 - brak w bazie podanej ulicy, problem dla urzędów dzielonych, zwraca kod błędu, Wojewodztwo, Powiat, Gminę
- 5 - zapytanie przekracza ograniczenie wersji demo
- 6 - ulica dzielona pomiędzy urzędy, potrzebne podanie numeru domu
- 7 - niejednoznaczne określenie gminy (wiele podpowiedzi, działa przy podaniu conajmniej 5 znaków nazwy gminy)
- 8 - wyczerpany limit zapytań
- 9 - nieznany błąd
- 10 - operacja poprawna (na podstawie gminy) ale brak zgodności przynależności miejscowości do gminy/powiat/województwa, zwraca wartości takie jak kod 0
- 11 - niejednoznaczność przy próbie określenia gminy na podstawie miejscowości - miejscowość występuje w wielu województwach
- 12 - niejednoznaczność przy próbie określenia gminy na podstawie miejscowości - miejscowość występuje w wielu powiatach województwa (musi być podane województwo
- 13 - niejednoznaczność przy próbie określenia gminy na podstawie miejscowości - miejscowość występuje w wielu gminach powiatu (musi być podana powiat i województwo
- 14 - niepełne określenie miejscowości (wiele podpowiedzi, działa przy podaniu conajmniej 5 znaków nazwy miejscowości), operacja trwa dłużej niż inne
- 15 - brak w bazie podanej miejscowości
- 16 - brak zgodności przynależności miejscowości do gminy/powiat/województwa
... = Województwo,Powiat,Gmina}
... = Gmina/Powiat1/Wojewodztwo1,Gmina/Powiat2/Wojewodztwo2,ewGmina/ewPowiat3/ewWojewodztwo3,...}
... = Ulica1,Ulica2,ewUlica3,...}
... = Gmina1,Gmina2,ewGmina3,...}
... = KodUrzędu,KodPrzypisu,Województwo,Powiat,Gmina}
... = Województwo1,Województwo2,ewWojewództwo3,...}
... = Powiat1/Województwo,Powiat2/Województwo,ewPowiat3/Województwo,...}
... = Gmina1,Gmina2,ewGmina3,...}
... = Miejscowość1,Miejscowość2,ewMiejscowość3,...}
Ograniczenia w wersji demo - tylko gminy rozpoczynające sie na A-B oraz ulice w miastach wielourzędowych rozpoczynające się na A-B