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