ServiceWersus


The following operations are supported. For a formal definition, please review the Service Description.


usługa zwraca 1 jeśli jest działa, lub nic jeśli nie

  • CzyJestWSpisieMiejscowosci
    zwraca bool czy jest w spisie miejscowości
  • DaneNadrzedneKodu
    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


  • DaneUrzedu
    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
  • DataOstatniejAktualizacjiBazy
    zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji bazy właściwości
  • DataOstatniejAktualizacjiSlownikaGmin
    zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji słownika gmin
  • DataOstatniejAktualizacjiSlownikaKodUbezpieczenia
    zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji Kodow Ubezpieczenia
  • DataOstatniejAktualizacjiSlownikaKodZawodu
    zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji Kodow Zawodu
  • DataOstatniejAktualizacjiSlownikaKoduAbsencji
    zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji Kodow Ubezpieczenia
  • DataOstatniejAktualizacjiSlownikaPPK
    zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji PPK
  • DataOstatniejAktualizacjiSlownikaPowiatow
    zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji słownika powiatów
  • DataOstatniejAktualizacjiSlownikaUrzedowSkarbowych
    zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji słownika urzędów skarbowych
  • DataOstatniejAktualizacjiSlownikaWojewodztw
    zwraca string (dd-mm-yyyy gg:mm:ss) ostatniej modyfikacji słownika województw
  • JednoznaczneDaneMiejscowosci
    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

  • LimitZapytan
    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)
  • OdpiszUzycieZasobu
    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
  • OdpiszUzycieZasobuN
    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
  • Test
    usługa testowa
  • Test2
    usługa testowa 2
  • UliceDlaKodu
    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
  • UliceDlaKoduJ
    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
  • WłasnosciKodu
    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
  • ZwrocKodPocztowy
    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}
      • KodPocztowy - string z numerem kodu pocztowego w formacie 99-999


    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
  • ZwrocNumerMFUrzeduSkarbowego
    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

    • ... = KodUrzędu,KodPrzypisu,Województwo,Powiat,Gmina}
      • 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

    • ... = Gmina/Powiat1/Wojewodztwo1,Gmina/Powiat2/Wojewodztwo2,ewGmina/ewPowiat3/ewWojewodztwo3,...}
    • 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

    • ... = Ulica1,Ulica2,ewUlica3,...}
    • 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)

    • ... = Gmina1,Gmina2,ewGmina3,...}
    • 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

    • ... = KodUrzędu,KodPrzypisu,Województwo,Powiat,Gmina}
    • 11 - niejednoznaczność przy próbie określenia gminy na podstawie miejscowości - miejscowość występuje w wielu województwach

    • ... = Województwo1,Województwo2,ewWojewództwo3,...}
    • 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

    • ... = Powiat1/Województwo,Powiat2/Województwo,ewPowiat3/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

    • ... = Gmina1,Gmina2,ewGmina3,...}
    • 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

    • ... = Miejscowość1,Miejscowość2,ewMiejscowość3,...}
    • 15 - brak w bazie podanej miejscowości
    • 16 - brak zgodności przynależności miejscowości do gminy/powiat/województwa

    Ograniczenia w wersji demo - tylko gminy rozpoczynające sie na A-B oraz ulice w miastach wielourzędowych rozpoczynające się na A-B
  • ZwrocPoprawionyAdres
    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,Powiat,Gmina}
      • 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

    • ... = Gmina/Powiat1/Wojewodztwo1,Gmina/Powiat2/Wojewodztwo2,ewGmina/ewPowiat3/ewWojewodztwo3,...}
    • 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

    • ... = Ulica1,Ulica2,ewUlica3,...}
    • 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)

    • ... = Gmina1,Gmina2,ewGmina3,...}
    • 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

    • ... = KodUrzędu,KodPrzypisu,Województwo,Powiat,Gmina}
    • 11 - niejednoznaczność przy próbie określenia gminy na podstawie miejscowości - miejscowość występuje w wielu województwach

    • ... = Województwo1,Województwo2,ewWojewództwo3,...}
    • 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

    • ... = Powiat1/Województwo,Powiat2/Województwo,ewPowiat3/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

    • ... = Gmina1,Gmina2,ewGmina3,...}
    • 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

    • ... = Miejscowość1,Miejscowość2,ewMiejscowość3,...}
    • 15 - brak w bazie podanej miejscowości
    • 16 - brak zgodności przynależności miejscowości do gminy/powiat/województwa

    Ograniczenia w wersji demo - tylko gminy rozpoczynające sie na A-B oraz ulice w miastach wielourzędowych rozpoczynające się na A-B