GetDataFromGUSEx
Funkcja GetDataFromGUSEx() zwraca rozszerzony zakres informacji o danych przedsiębiorstwa dostarczanych przez APi Głównego Urzędu Statystycznego (GUS). Powinna być stosowana jako rozszerzenie informacji uzyskanych funkcją GatDataFromGus().
Składnia
GetDataFromGUSEx(contractorIdentityNumber); GetDataFromGUSEx(contractorIdentityNumber, [parameter]); GetDataFromGUSEx(contractorIdentityNumber, [parameter], [fieldSeparator], [rowSeparator], [reportName]);
Argumenty funkcji
- contractorIdentityNumber – (String) numer NIP, Regon albo KRS podmiotu, którego dane chcemy pobrać;
- parameter – (String) parametr zawiera nazwę pola (atrybutu) podmiotu, które chcemy uzyskać. Dostępne wartości, to wszystkie tagi widoczne w przykładach dla osoby prawnej albo osób fizycznych. Każdy tag zaczyna się od przedrostka „praw_” albo „fiz_”. W tym parametrze należy użyć pozostałej części nazwy. Przykład dla tagu „praw_nazwaSkrocona”, należy użyć „nazwaSkrocona”, a dla tagu „fiz_adSiedzMiejscowosc_Nazwa” należy użyć „adSiedzMiejscowosc_Nazwa”.
W trakcie wywołania funkcji nie podaje się, które dane (dla osób prawnych, czy fizycznych) mają być zwrócone. Funkcja na podstawie NIP/KRS/REGON sama rozpozna typ i zwróci odpowiedni zestaw danych. Wywołując funkcję musisz widzieć czego się spodziewać, aby prawidłowo interpretować dane.
Więcej informacji znajduje się na stronie https://api.stat.gov.pl/Home/RegonApi. - fieldSeparator – (String) separator, który zostanie użyty do rozdzielenia wartości, jeśli zostanie zwrócone więcej niż jedno pole (atrybut) podmiotu;
- rowSeparator – (String) separator, który zostanie użyty do rozdzielenia wartości, jeśli zostaną zwrócone dane więcej niż jednego podmiotu;
- reportName – (String) oryginalna, pełna nazwa raportu, który ma być pobrany z GUS API. Dostępne nazwy raportów GUS oraz w nawiasie dostępne „Parametry” w tych raportach: BIR11OsPrawnaSpCywilnaWspolnicy ( regonWspolnikSpolki, imiePierwsze, imieDrugie, nazwisko, firmaNazwa), BIR11OsPrawnaPkd ( pkdKod, pkdNazwa, pkdPrzewazajace ).
Zwracana wartość
Ta funkcja zwraca String. Jeżeli funkcja zostanie wywołana tylko z parametrem contractorIdentityNumber, to zwróci wszystkie dane o podmiocie gospodarczym w postaci XML. Zwracany plik XML w zależności od formy działalności będzie zawierał rożne zestawy danych.
Osoba prawna, Jednostka organizacyjna niemająca osobowości prawnej.
<root> <dane> <praw_regon9>016263968</praw_regon9> <praw_nip>5252171560</praw_nip> <praw_statusNip /> <praw_nazwa>ASTRAFOX SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ</praw_nazwa> <praw_nazwaSkrocona>ASTRAFOX SP. Z O.O.</praw_nazwaSkrocona> <praw_numerWRejestrzeEwidencji>0000193522</praw_numerWRejestrzeEwidencji> <praw_dataWpisuDoRejestruEwidencji>2004-02-18</praw_dataWpisuDoRejestruEwidencji> <praw_dataPowstania>2000-01-10</praw_dataPowstania> <praw_dataRozpoczeciaDzialalnosci>2000-01-11</praw_dataRozpoczeciaDzialalnosci> <praw_dataWpisuDoRegon /> <praw_dataZawieszeniaDzialalnosci /> <praw_dataWznowieniaDzialalnosci /> <praw_dataZaistnieniaZmiany>2020-05-28</praw_dataZaistnieniaZmiany> <praw_dataZakonczeniaDzialalnosci /> <praw_dataSkresleniaZRegon /> <praw_dataOrzeczeniaOUpadlosci /> <praw_dataZakonczeniaPostepowaniaUpadlosciowego /> <praw_adSiedzKraj_Symbol>PL</praw_adSiedzKraj_Symbol> <praw_adSiedzWojewodztwo_Symbol>14</praw_adSiedzWojewodztwo_Symbol> <praw_adSiedzPowiat_Symbol>65</praw_adSiedzPowiat_Symbol> <praw_adSiedzGmina_Symbol>138</praw_adSiedzGmina_Symbol> <praw_adSiedzKodPocztowy>02826</praw_adSiedzKodPocztowy> <praw_adSiedzMiejscowoscPoczty_Symbol>0988833</praw_adSiedzMiejscowoscPoczty_Symbol> <praw_adSiedzMiejscowosc_Symbol>0988833</praw_adSiedzMiejscowosc_Symbol> <praw_adSiedzUlica_Symbol>17021</praw_adSiedzUlica_Symbol> <praw_adSiedzNumerNieruchomosci>93</praw_adSiedzNumerNieruchomosci> <praw_adSiedzNumerLokalu /> <praw_adSiedzNietypoweMiejsceLokalizacji /> <praw_numerTelefonu>3552130</praw_numerTelefonu> <praw_numerWewnetrznyTelefonu /> <praw_numerFaksu>3552101</praw_numerFaksu> <praw_adresEmail>OFFICE@ASTRAFOX.PL</praw_adresEmail> <praw_adresStronyinternetowej /> <praw_adSiedzKraj_Nazwa>POLSKA</praw_adSiedzKraj_Nazwa> <praw_adSiedzWojewodztwo_Nazwa>MAZOWIECKIE</praw_adSiedzWojewodztwo_Nazwa> <praw_adSiedzPowiat_Nazwa>Warszawa</praw_adSiedzPowiat_Nazwa> <praw_adSiedzGmina_Nazwa>Ursynów</praw_adSiedzGmina_Nazwa> <praw_adSiedzMiejscowosc_Nazwa>Warszawa</praw_adSiedzMiejscowosc_Nazwa> <praw_adSiedzMiejscowoscPoczty_Nazwa>Warszawa</praw_adSiedzMiejscowoscPoczty_Nazwa> <praw_adSiedzUlica_Nazwa>ul. Poloneza</praw_adSiedzUlica_Nazwa> <praw_podstawowaFormaPrawna_Symbol>1</praw_podstawowaFormaPrawna_Symbol> <praw_szczegolnaFormaPrawna_Symbol>117</praw_szczegolnaFormaPrawna_Symbol> <praw_formaFinansowania_Symbol>1</praw_formaFinansowania_Symbol> <praw_formaWlasnosci_Symbol>214</praw_formaWlasnosci_Symbol> <praw_organZalozycielski_Symbol /> <praw_organRejestrowy_Symbol>071010050</praw_organRejestrowy_Symbol> <praw_rodzajRejestruEwidencji_Symbol>138</praw_rodzajRejestruEwidencji_Symbol> <praw_podstawowaFormaPrawna_Nazwa>OSOBA PRAWNA</praw_podstawowaFormaPrawna_Nazwa> <praw_szczegolnaFormaPrawna_Nazwa>SPÓŁKI Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ</praw_szczegolnaFormaPrawna_Nazwa> <praw_formaFinansowania_Nazwa>JEDNOSTKA SAMOFINANSUJĄCA NIE BĘDĄCA JEDNOSTKĄ BUDŻETOWĄ LUB SAMORZĄDOWYM ZAKŁADEM BUDŻETOWYM</praw_formaFinansowania_Nazwa> <praw_formaWlasnosci_Nazwa>WŁASNOŚĆ KRAJOWYCH OSÓB FIZYCZNYCH</praw_formaWlasnosci_Nazwa> <praw_organZalozycielski_Nazwa /> <praw_organRejestrowy_Nazwa>SĄD REJONOWY DLA M.ST.WARSZAWY W WARSZAWIE,XIII WYDZIAŁ GOSPODARCZY KRAJOWEGO REJESTRU SĄDOWEGO</praw_organRejestrowy_Nazwa> <praw_rodzajRejestruEwidencji_Nazwa>REJESTR PRZEDSIĘBIORCÓW</praw_rodzajRejestruEwidencji_Nazwa> <praw_liczbaJednLokalnych>0</praw_liczbaJednLokalnych> </dane> </root>
(dane nieprawdziwe)
Osoba fizyczna prowadząca działalność gospodarczą.
<root>
<dane>
<fiz_regon9>430908446</fiz_regon9>
<fiz_nazwa>Fryzjerstwo i kosmetyka - Anna Fryzura</fiz_nazwa>
<fiz_nazwaSkrocona>Anna Fryzura</fiz_nazwaSkrocona>
<fiz_dataPowstania>2012-05-25</fiz_dataPowstania>
<fiz_dataRozpoczeciaDzialalnosci>2012-06-01</fiz_dataRozpoczeciaDzialalnosci>
<fiz_dataWpisuDzialalnosciDoRegon>2012-05-29</fiz_dataWpisuDzialalnosciDoRegon>
<fiz_dataZawieszeniaDzialalnosci />
<fiz_dataWznowieniaDzialalnosci />
<fiz_dataZaistnieniaZmianyDzialalnosci>2019-10-17</fiz_dataZaistnieniaZmianyDzialalnosci>
<fiz_dataZakonczeniaDzialalnosci />
<fiz_dataSkresleniaDzialalnosciZRegon />
<fiz_dataOrzeczeniaOUpadlosci />
<fiz_dataZakonczeniaPostepowaniaUpadlosciowego />
<fiz_adSiedzKraj_Symbol>PL</fiz_adSiedzKraj_Symbol>
<fiz_adSiedzWojewodztwo_Symbol>04</fiz_adSiedzWojewodztwo_Symbol>
<fiz_adSiedzPowiat_Symbol>59</fiz_adSiedzPowiat_Symbol>
<fiz_adSiedzGmina_Symbol>010</fiz_adSiedzGmina_Symbol>
<fiz_adSiedzKodPocztowy>00209</fiz_adSiedzKodPocztowy>
<fiz_adSiedzMiejscowoscPoczty_Symbol>092233</fiz_adSiedzMiejscowoscPoczty_Symbol>
<fiz_adSiedzMiejscowosc_Symbol>092233</fiz_adSiedzMiejscowosc_Symbol>
<fiz_adSiedzUlica_Symbol>10988</fiz_adSiedzUlica_Symbol>
<fiz_adSiedzNumerNieruchomosci>19</fiz_adSiedzNumerNieruchomosci>
<fiz_adSiedzNumerLokalu>21</fiz_adSiedzNumerLokalu>
<fiz_adSiedzNietypoweMiejsceLokalizacji />
<fiz_numerTelefonu />
<fiz_numerWewnetrznyTelefonu />
<fiz_numerFaksu />
<fiz_adresEmail>annafryz9871@gmail.com</fiz_adresEmail>
<fiz_adresStronyinternetowej />
<fiz_adSiedzKraj_Nazwa>POLSKA</fiz_adSiedzKraj_Nazwa>
<fiz_adSiedzWojewodztwo_Nazwa>KUJAWSKO-POMORSKIE</fiz_adSiedzWojewodztwo_Nazwa>
<fiz_adSiedzPowiat_Nazwa>Toruń</fiz_adSiedzPowiat_Nazwa>
<fiz_adSiedzGmina_Nazwa>Toruń</fiz_adSiedzGmina_Nazwa>
<fiz_adSiedzMiejscowosc_Nazwa>Toruń</fiz_adSiedzMiejscowosc_Nazwa>
<fiz_adSiedzMiejscowoscPoczty_Nazwa>Toruń</fiz_adSiedzMiejscowoscPoczty_Nazwa>
<fiz_adSiedzUlica_Nazwa>ul. Jakaś ulica</fiz_adSiedzUlica_Nazwa>
<fizC_dataWpisuDoRejestruEwidencji>2012-05-25</fizC_dataWpisuDoRejestruEwidencji>
<fizC_dataSkresleniaZRejestruEwidencji />
<fizC_numerWRejestrzeEwidencji>003314911/2012</fizC_numerWRejestrzeEwidencji>
<fizC_OrganRejestrowy_Symbol>121000000</fizC_OrganRejestrowy_Symbol>
<fizC_OrganRejestrowy_Nazwa>MINISTER PRZEDSIĘBIORCZOŚCI I TECHNOLOGII</fizC_OrganRejestrowy_Nazwa>
<fizC_RodzajRejestru_Symbol>151</fizC_RodzajRejestru_Symbol>
<fizC_RodzajRejestru_Nazwa>CENTRALNA EWIDENCJA I INFORMACJA O DZIAŁALNOŚCI GOSPODARCZEJ</fizC_RodzajRejestru_Nazwa>
<fizC_NiePodjetoDzialalnosci>false</fizC_NiePodjetoDzialalnosci>
</dane>
</root>
Sposoby użycia
Należy wywołać funkcję z następującymi parametrami
GetDataFromGUS([NIP],"Typ, SilosID")
aby dowiedzieć się jakiego typu jest to jednostka organizacyjna. dostępne kombinacje dla Typ i SilosID podaje poniższa tabela
Example 1:
Gets all data from GUS API for contractor which NIP, Regon or KRS is equal to 12345678. Data format is XML.
GetDataFromGUSEx("12345678")Example 2:
Gets value of „Nazwa” parameter from GUS API for contractor which NIP, Regon or KRS is equal 12345678.
GetDataFromGUSEx("12345678", "Nazwa")Example 3:
Gets values of „Nazwa” and „Miejscowosc” parameters from GUS API for contractor which NIP, Regon or KRS is equal 12345678. It returns data in one string separated with ’;’.
GetDataFromGUSEx("12345678", "Nazwa, Miejscowosc")Example 4:
Gets values of „Nazwa” and „Miejscowosc” parameters from GUS API for contractor which NIP, Regon or KRS is equal 12345678. It returns data in one string separated with '##’.
GetDataFromGUSEx("12345678", "Nazwa, Miejscowosc", "##")Example 5:
Gets value of „imiePierwsze” parameter from GUS API from BIR11OsPrawnaSpCywilnaWspolnicy report for contractor which NIP, Regon or KRS is equal 12345678. It returns data in one string separated with '##’ for one record and each record is separated with '\n’ (a new line) character.
GetDataFromGUSEx("12345678", "imiePierwsze", "##", "\\n", "BIR11OsPrawnaSpCywilnaWspolnicy")