BIR - konfiguracja API
← Ustawienia
📘
Dokumentacja i rejestracja klucza API
api.stat.gov.pl/Home/RegonApi ↗
Tam zlozysz wniosek o klucz produkcyjny (formularz na stronie -> zakladka Rejestracja). Wniosek jest bezplatny, GUS rozpatruje go w kilka dni roboczych. Po zatwierdzeniu klucz produkcyjny dostaniesz e-mailem.
Srodowisko testowe
Klucz:
abcde12345abcde12345Endpoint:
https://wyszukiwarkaregontest.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc
WSDL BIR1.1:
https://wyszukiwarkaregontest.stat.gov.pl/wsBIR/wsBIR/wsdl/UslugaBIRzewnPubl-ver11-test.wsdl
Srodowisko produkcyjne
Klucz: z wniosku na stronie GUS
Endpoint BIR1.1:
https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc
WSDL BIR1.1:
https://wyszukiwarkaregon.stat.gov.pl/wsBIR/wsBIR/wsdl/UslugaBIRzewnPubl-ver11-prod.wsdl
BIR1.1 vs BIR1.2: BIR1.1 zwraca dane jako XML (SOAP), BIR1.2 to nowszy standard z rozszerzonymi danymi.
W praktyce wiekszosc bibliotek PHP korzysta z BIR1.1 - wybierz 1.2 tylko jezeli Twoja biblioteka to jawnie wspiera.
Dane dostepne przez API: NIP, REGON, nazwa, adres, PKD, forma prawna, status VAT.
Dane dostepowe do BIR
Klucz API, adres serwisu BIR (1.1 lub 1.2) i adres pliku WSDL.