# GUS

## Testowanie metody weryfikującej firmę w bazie GUS

\`\`\`http request GET [http://localhost:8080/apollo/api/gus/verify?nip=7342867148&amp;ibanSymbol=PL](<http://localhost:8080/apollo/api/gus/verify?nip=7342867148&amp;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](<https://wyszukiwarkaregontest.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc>) Content-Type: application/soap+xml; sid: SECRET\_KEY

[https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc](<https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc%3C/wsa:To%3E>) [http://CIS/BIR/PUBL/2014/07/IUslugaBIRzewnPubl/DaneSzukajPodmioty](<http://CIS/BIR/PUBL/2014/07/IUslugaBIRzewnPubl/DaneSzukajPodmioty%3C/wsa:Action%3E>)    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](<https://docs.logintegra.com/apollo-backend/static/Microservices &amp; Integrations/integrations/gus/gus-nip-field-country-null-validation.png>)

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](<https://docs.logintegra.com/apollo-backend/static/Microservices &amp; Integrations/integrations/gus/gus-verification-invitation-formula.png>)

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

![Komunikat informujący o weryfikacji po wysłaniu zaproszenia](<https://docs.logintegra.com/apollo-backend/static/Microservices &amp; Integrations/integrations/gus/gus-info-about-company-verifications.png>)

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](<https://docs.logintegra.com/apollo-backend/static/Microservices &amp; Integrations/integrations/gus/gus-registration-formula.png>)

Informacje odnośnie uprawnień edycji pól firmy można znaleźć tu: [Uprawnienia do edycji firmy](<https://docs.logintegra.com/apollo-backend/3. Users &amp; Companies/companies/edit-permission/index.md>).

## 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.`.

![](<https://docs.logintegra.com/apollo-backend/static/Microservices &amp; Integrations/integrations/gus/gus-add-company-verification.png>)

## 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](<https://docs.logintegra.com/apollo-backend/static/Microservices &amp; Integrations/integrations/gus/gus-accident-mail.png>)
