Wiele firm rezygnuje z dobrodziejstw API, obawiając się wysokich kosztów wdrożenia systemów informatycznych. Tymczasem, aby hurtowo pobierać przez API dane z rejestrów publicznych (takich jak KRS), wystarczy Ci program Excel.
Dzięki narzędziu Power Query możesz połączyć swój arkusz bezpośrednio z zasobami MGBI, zamieniając zwykłą listę numerów KRS w pełną bazę danych o kontrahentach, bez napisania ani jednej linii kodu.
W tym poradniku wyjaśniamy jak skorzystać z tego rozwiązania i zyskać masowy dostęp do danych z wielu rejestrów publicznych.
Listę źródeł danych dostępnych w ramach MGBI API znajdziesz na stronie:
👉 Rejestry Publiczne API
Sprawdź także dokumentację techniczną dla Rejestrów publicznych API:
👉 Dokumentacja techniczna - Rejestry publiczne API
1. Przygotowanie listy identyfikatorów
Pierwszym krokiem jest stworzenie w arkuszu kolumny z identyfikatorami podmiotów, które chcesz sprawdzić (np. numery KRS).
Nadaj kolumnie czytelny nagłówek, np. "Numer KRS", a numery wprowadź jako wartości Tekstowe. Pozwoli to uniknąć błędów w formatowaniu (np. znikania zer na początku).
Następnie zaznacz dane i użyj na klawiaturze skrótu Ctrl + T. Następnie kliknij "OK" aby utworzyć tabelę.
Widok tabeli zmieni się, co można uznać za potwierdzenie poprawnego wykonania wcześniejszych kroków.
2. Import do Power Query
Zaznacz tabelę i przejdź do zakładki Dane. Wybierz opcję Pobierz dane → Z innych źródeł → Z tabeli/zakresu.
Otworzy się Edytor Power Query – to tutaj istnieje możliwość połączenia z MGBI API.
Upewnij się, że typ danych kolumny z numerami KRS to nadal tekst. Jeśli program zmienił go na liczbowy, zmień go z powrotem, aby zapytania do API były poprawne.
W nagłówku tabeli kliknij ikonę "123".
Na rozwijanej liście wybierz "Tekst".
Dane zostaną odświeżone, a numery KRS będą już wyświetlane poprawnie.
3. Konfiguracja zapytania
Kolejny krok to dodanie w Edytorze Power Query funkcji, która wyśle zapytanie do MGBI API dla każdego wiersza (numeru KRS) w Twojej tabeli.
Przejdź do karty Dodaj kolumnę i wybierz Kolumna niestandardowa.
Wyświetli się nowe okno.
W polu Formuła kolumny niestandardowej wklej zapytanie wykorzystujące funkcje Json.Document oraz Web.Contents.
Przykład formuły:
GET /v1/models/pl-krs-rdf-record/records?identifiers.pl_krs=[numer KRS] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]Znak & automatycznie podstawi odpowiedni numer z Twojej listy w adresie URL endpointu API. Po wprowadzeniu formuły kliknij przycisk "OK".
Na górze strony pojawi się komunikat. Kliknij Edytuj poświadczenia, aby przejść dalej.
W nowym oknie sprawdź czy wybrany poziom wskazuje adres endpointu API, z którego chcesz pozyskać dane, a następnie kliknij przycisk Połącz.
Pojawi się jeszcze jeden komunikat. Kliknij Kontynuuj.
Wybierz opcję "Ignoruj kontrole poziomów prywatności dla tego pliku", aby umożliwić swobodny przepływ danych. Na końcu kliknij przycisk Zapisz.
4. Rozpakowywanie i wybór danych
W nowej kolumnie niestandardowej zobaczysz wartości typu Record lub Table. Kliknij ikonę dwóch strzałek w nagłówku kolumny, aby „rozpakować” dane.
Wybierz wszystkie opcje: count, pages, results. Następnie kliknij przycisk "OK".
Ponownie kliknij na ikonę dwóch strzałek w nagłówku niestandardowej kolumny.
Teraz możesz wybrać jaki zakres danych ma znaleźć się w Twoim pliku. Następnie kliknij "OK".
Postępuj analogicznie do momentu, w którym podgląd tabeli będzie zawierał wszystkie dane, które chcesz pobrać do swojego arkusza.
5. Aktualizacja danych w arkuszu
Gdy tabela wygląda już tak, jak zaplanowałeś, wybierz Zamknij i załaduj.
Gotowe dane zostaną wstawione do Twojego arkusza jako nowa zakładka - Tabela.
Informacje o przedsiębiorcach dostępne w rejestrach publicznych, takich jak KRS, ulegają częstym zmianom (np. zmiana adresu siedziby, składu zarządu, wysokości kapitału zakładowego).
Aby upewnić się, że informacje w Twoim arkuszu są aktualne, przejdź do zakładki Dane i wybierz opcję Odśwież wszystko.
Excel połączy się z MGBI API, pobierze najświeższe rekordy i nadpisze stare dane w Twoim arkuszu.
Dzięki temu rozwiązaniu Twoja baza jest zawsze gotowa do pracy, a Ty oszczędzasz czas, unikając ręcznego sprawdzania każdego podmiotu z osobna.
6. Dodawanie nowych podmiotów
Jeśli chcesz dodać do swojego pliku kolejne podmioty, nie musisz tworzyć nowego zapytania.
Przejdź do tabeli źródłowej, w której znajdują się numery KRS i wpisz nowy identyfikator bezpośrednio w kolejnym pustym wierszu pod tabelą.
Dzięki temu, że użyłeś wcześniej skrótu Ctrl + T, Excel automatycznie rozpozna nowy wpis i „rozciągnie” zakres tabeli, aby go uwzględnić.
Pamiętaj, że nowy numer KRS również musi być wpisany jako wartość tekstowa, aby zapytanie do API zadziałało poprawnie.
