Strona może być nieaktualna
Nikt jej nie zmieniał od 46 miesięcy (ostatni commit: 2023-01-19, Dariusz). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.
GUS¶
Testowanie metody weryfikującej firmę w bazie GUS¶
```http request GET http://localhost:8080/apollo/api/gus/verify?nip=7342867148&ibanSymbol=PL
## Testowanie komunikacji z serwisem GUS
### Zapytanie o klucz
```http request
POST https://wyszukiwarkaregontest.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc
Content-Type: application/soap+xml
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
xmlns:ns="http://CIS/BIR/PUBL/2014/07">
<soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
<wsa:To>https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc</wsa:To>
<wsa:Action>http://CIS/BIR/PUBL/2014/07/IUslugaBIRzewnPubl/Zaloguj</wsa:Action>
</soap:Header>
<soap:Body>
<ns:Zaloguj>
<ns:pKluczUzytkownika>abcde12345abcde12345</ns:pKluczUzytkownika>
</ns:Zaloguj>
</soap:Body>
</soap:Envelope>
Zapytanie o dane firmy¶
```http request POST https://wyszukiwarkaregontest.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc Content-Type: application/soap+xml; sid: SECRET_KEY
Gdzie SECRET_KEY jest kluczem otrzymanym w odpowiedzi na IUslugaBIRzewnPubl/Zaloguj (poprzednie zapytanie).
Weryfikacja nowej firmy z Polski w GUS¶
Weryfikacja nowej firmy w GUS po zaproszeniu użytkownika¶
Przy zapraszaniu użytkowników obowiązkowo trzeba podawać numer NIP firmy oraz kraj. Na potrzeby integracji z GUS została też dodana walidacja na pole NIP - jeżeli użytkownik nie poda kodu kraju to pole nie będzie aktywne:

W przypadku, gdy w zaproszeniu zostanie podany NIP firmy, której jeszcze nie ma w bazie, to informacja o takiej firmie zostanie pobrana z bazy GUS. Po wybraniu kraju i podaniu numeru NIP w formularzu zaproszenia pod polem z numerem NIP wyświetla się nazwa firmy pobrana z GUS:

Po wysłaniu zaproszenia użytkownik jest informowany o weryfikacji firmy:

Użytkownik wypełniający formularz rejestracji ma w takim przypadku pola "Nazwa", "NIP", "Kraj" już wypełnione i niedostępne do edycji:

Informacje odnośnie uprawnień edycji pól firmy można znaleźć tu: Uprawnienia do edycji firmy.
Weryfikacja nowej firmy w GUS podczas tworzenia nowej firmy na platformie¶
Analogicznie jak podczas zapraszania nowej firmy, firmy tworzone na platformie przy pomocy przycisku "Dodaj firmę" (zakładka "Firmy" -> "Dodaj firmę"; wymagane uprawnienie: ROLE_CREATE_COMPANY) również poddawane są weryfikacji w GUS.
Jeśli uzupełniony w formularzu kraj to Polska, to po uzupełnieniu numeru NIP próbujemy ustalić nazwę firmy:
- w pierwszej kolejności sprawdzamy, czy istnieje aktywna firma (UWAGA: oznacza to, że flaga
enabledfirmy musi być ustawiona natrue) z takim NIPem (w tabelicompany), - następnie patrzymy do tabeli
gus_company, czy przypadkiem nie pytaliśmy już wcześniej GUSu o wskazany NIP, - na końcu rzeczywiście pytamy GUS, czy ma dane firmy o wskazanym NIPie.
Jeśli uda nam się ustalić nazwę firmy - ustawiamy ją w formularzu tworzenia firmy i blokujemy jej edycję:
Przypadek gdy firma istnieje już w apollo¶
Analogicznie do poprzedniego paragrafu, jeżeli firma istnieje już w bazie danych Apollo to blokujemy edycje nazwy firmy i wyświetlamy komunikat Firma już istnieje w platformie. Nie możesz edytować pełnej nazwy firmy..

Postępowanie w przypadku awarii integracji z GUS¶
W przypadku gdy nie uda się połączyć z GUS w platformie pojawia się pod polem z numerem NIP komunikat informujący o braku nawiązania połączenia Z GUS. Użytkownik ma wtedy odblokowane pole z nazwą firmy by była możliwa rejestracja.
Jeżeli wystąpi taka sytuacja, to po rejestracji wysyłany jest powiadomienie mailowe do supportu z prośbą o sprawdzenie danych firmy:

Ostatnia zmiana: 2023-01-19 · Dariusz
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e