Integracja z API GUS: dane firmy po NIP
Klient wpisuje NIP, a formularz sam uzupełnia nazwę firmy, adres i REGON. Łączymy usługę BIR1 GUS z rejestracją, fakturami i CRM, tak żeby dane kontrahentów były poprawne od pierwszego wpisu i nie trzeba było ich przepisywać.
Formularz, który uzupełnia się sam
Usługa BIR1 GUS udostępnia dane z rejestru REGON bezpłatnie. Wyszukuje się po NIP, REGON albo KRS.
Klient wpisuje tylko NIP
Kreski i spacje nie przeszkadzają: do GUS wysyłamy same cyfry, w jednym parametrze wyszukiwania.
Dane z rejestru, ale do poprawy
Nazwa, adres, REGON i rodzaj firmy przychodzą z jednego wyszukiwania, a klient może je poprawić przed wysłaniem.
Status VAT sprawdzany osobno
Rejestr nie przechowuje statusu czynnego podatnika VAT. Status VAT sprawdza się w osobnym rejestrze i łączymy to w tym samym formularzu.
Rejestracja działa także bez GUS
Formularz nie blokuje klienta. Pola można wpisać ręcznie, a dane uzupełnią się w tle, gdy usługa wróci.
Wynik wyszukiwania a pola formularza
Pola z odpowiedzi DaneSzukajPodmioty, które wypełniają formularz firmy.
012345675 · Firma 01 sp. z o.o. · ul. Przykładowa · 12 · 4 · 00-950 Warszawa · P · (pusta)
Regon
REGON: jako tekst, bo zera wiodące mają znaczenie.
Nazwa
Nazwa firmy: pełna nazwa z rejestru, do edycji przez klienta.
Ulica, NrNieruchomosci, NrLokalu
Adres: złożone w jedną linię adresu.
KodPocztowy, Miejscowosc
Kod i miasto: MiejscowoscPoczty, gdy różni się od miejscowości.
Typ
Rodzaj kontrahenta: P to jednostka prawna, F osoba fizyczna z działalnością.
DataZakonczeniaDzialalnosci
Ostrzeżenie: wypełniona data oznacza działalność zakończoną.
Pełny raport tylko w razie potrzeby
Do uzupełnienia formularza wystarcza wynik wyszukiwania. DanePobierzPelnyRaport wołamy, gdy potrzebne są np. kody PKD albo sprawdzenie, czy firma jest aktywna.
Baza testowa z 2014 r.
Środowisko testowe ma pełną, ale nieaktualizowaną i zanonimizowaną bazę. Zgodność z prawdziwymi firmami sprawdzamy dopiero kluczem produkcyjnym.
Sesje i limity usługi BIR1
Twój serwer loguje się raz na sesję, a nie przy każdym NIP, i wysyła jej identyfikator w nagłówku sid. Limity zależą od pory dnia. Przekroczenie nie blokuje dostępu od razu, ale GUS informuje o nim użytkownika.
Twój serwer
formularze i nocna aktualizacja
- 3zapytania na sekundę8:00 do 16:59Nadmiar czeka, równe tempo
Usługa BIR1
SOAP 1.2, sid w nagłówku
Sesja na 60 minut
Sesja kończy się po wylogowaniu albo po godzinie. Integracja odnawia ją sama, gdy GetValue zwróci kod braku sesji.
Osobny sid na instancję
Za systemem równoważenia obciążenia sid z jednej instancji nie zostanie rozpoznany na drugiej. Każda loguje się sama.
Kod 4 czy kod 7
Pusty wynik to brak firmy albo wygasła sesja. Rozróżnia je kod z GetValue: 4 to brak podmiotów, 7 to brak sesji.
Nocna aktualizacja danych kontrahentów
Limity BIR1 zależą od pory dnia i w nocy są najwyższe, dlatego całą kartotekę odświeżamy nocą, paczkami po 20 NIP-ów.
Limit zapytań na godzinę, godzina po godzinie
- 8:00 do 16:59do 6000 na godzinę, do 120 na minutę, do 3 na sekundę
- 6:00 do 7:59 i 17:00 do 21:59do 8000 na godzinę, do 150 na minutę, do 3 na sekundę
- 22:00 do 5:59do 10 000 na godzinę, do 200 na minutę, do 4 na sekundę
3:20: GUS zamyka sesje. O tej godzinie GUS zamyka wszystkie aktywne sesje. Nocne zadania nie zakładają, że sesja przetrwa.
zapytania po 20 NIP-ów, 1840 kontrahentów, od 22:00 do 22:04
Przy aktualizacji wielu kontrahentów wysyłamy paczki po 20 NIP-ów zamiast pojedynczych zapytań.
kontrahentów po nocy
- bez zmian1790
- zmieniony adres, poprawiony46
- zakończona działalność, do sprawdzenia4
DataZakonczeniaDzialalnosci: wypełniona data oznacza działalność zakończoną.
Najczęstsze pytania o integrację z GUS
Odpowiedzi o kluczu, statusie VAT i przerwach w GUS.
Czytaj dalej
Gdzie dane z GUS przydają się najbardziej.
Chcesz, żeby formularz sam uzupełniał dane firmy?
Napisz, gdzie klienci podają dane firmy: rejestracja, zamówienie, faktura albo CRM. Odpowiemy w godzinę z pytaniami i wyceną.