Przejdź do treści

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

https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc http://CIS/BIR/PUBL/2014/07/IUslugaBIRzewnPubl/DaneSzukajPodmioty 5250008198 ```

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:

Walidacja na pole NIP gdy nie ma wybranego kraju

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:

Formularz zaproszenia z widoczną nazwą firmy pobraną z GUS

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

Komunikat informujący o weryfikacji po wysłaniu zaproszenia

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

Formularz rejestracji z zablokowanymi polami firmy

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 enabled firmy musi być ustawiona na true) z takim NIPem (w tabeli company),
  • 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:

Mail informujący o awarii połączenia z GUS

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