GetDataFromGUSEx

Aktualizacja9 czerwca 2023

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 c ontractorIdentityNumber, 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.

    
        016263968
        5252171560
        
        ASTRAFOX SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ
        ASTRAFOX SP. Z O.O.
        0000193522
        2004-02-18
        2000-01-10
        2000-01-11
        
        
        
        2020-05-28
        
        
        
        
        PL
        14
        65
        138
        02826
        0988833
        0988833
        17021
        93
        
        
        3552130
        
        3552101
        OFFICE@ASTRAFOX.PL
        
        POLSKA
        MAZOWIECKIE
        Warszawa
        Ursynów
        Warszawa
        Warszawa
        ul. Poloneza
        1
        117
        1
        214
        
        071010050
        138
        OSOBA PRAWNA
        SPÓŁKI Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ
        JEDNOSTKA SAMOFINANSUJĄCA NIE BĘDĄCA JEDNOSTKĄ BUDŻETOWĄ LUB SAMORZĄDOWYM ZAKŁADEM BUDŻETOWYM
        WŁASNOŚĆ KRAJOWYCH OSÓB FIZYCZNYCH
        
        SĄD REJONOWY DLA M.ST.WARSZAWY W WARSZAWIE,XIII WYDZIAŁ GOSPODARCZY KRAJOWEGO REJESTRU SĄDOWEGO
        REJESTR PRZEDSIĘBIORCÓW
        0

(dane nieprawdziwe)

Osoba fizyczna prowadząca działalność gospodarczą.

  
    430908446
    Fryzjerstwo i kosmetyka - Anna Fryzura
    Anna Fryzura
    2012-05-25
    2012-06-01
    2012-05-29
    
    
    2019-10-17
    
    
    
    
    PL
    04
    59
    010
    00209
    092233
    092233
    10988
    19
    21
    
    
    
    
    annafryz9871@gmail.com
    
    POLSKA
    KUJAWSKO-POMORSKIE
    Toruń
    Toruń
    Toruń
    Toruń
    ul. Jakaś ulica
    2012-05-25
    
    003314911/2012
    121000000
    MINISTER PRZEDSIĘBIORCZOŚCI I TECHNOLOGII
    151
    CENTRALNA EWIDENCJA I INFORMACJA O DZIAŁALNOŚCI GOSPODARCZEJ
    false

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