Co to jest API?

API jest pomostem łączącym jeden system (lub aplikację) z drugim. Wiele serwisów (GUS, NBP, Ministerstwo Finansów, VIES, CEIDG) wystawia dane w taki sposób, więc warto poszukać najprostszego sposobu ich pobierania. Więcej o API dowiesz się z lekcji nt. białej listy podatników.

Chcesz dowiedzieć się, jak pobierać dane z innego API?

Napisz w komentarzu.

Kurs „Pobieranie danych w Excelu dla finansistów” – co tydzień nowe wideo

Przed Tobą 20. lekcja z serii „Pobieranie danych w Excelu dla finansistów”. W kursie ukazały się dotychczas:

• Lekcja 1. Wczytaj przyjazny plik tekstowy
• Lekcja 2. Napraw „popsuty” plik tekstowy
• Lekcja 3. Połącz dane z wielu plików i uniknij Ctrl+C i Ctrl+V
• Lekcja 4. Najgorszy plik tekstowy, jaki mi się trafił
• Lekcja 5. Pobierz dane z pliku bankowego .MT940
• Lekcja 6. Dołącz w pionie wiele arkuszy z 1 pliku
• Lekcja 7. Wstaw tabelę przestawną na zapytaniu Power Query
• Lekcja 8. Porównaj 2 pliki Excel ze środkami trwałymi
• Lekcja 9. Zbuduj w Excelu saldo kont na bazie tabeli księgowań
• Lekcja 10. Napraw scalone komórki i spivotowane dane
• Lekcja 11. Pobierz plik z dysku OneDrive lub SharePointa
• Lekcja 12 i 13. Pobierz folder plików z dysku OneDrive lub SharePoint
• Lekcja 14. Pobierz dane z plików otrzymywanych regularnie na e-mail
• Lekcja 15. Pobierz dane do Excela z pliku PDF
• Lekcja 16. Pobierz dane z wielu plików PDF na raz
• Lekcja 17. Pobierz dane z pliku plik XML z deklaracją JPK_VAT
• Lekcja 18. Automatycznie pobieraj do Excela kursy walut z NBP
• Lekcja 19. Sprawdź kontrahenta na białej liście podatników przez API

Kurs bazuje na codziennych wyzwaniach z działów finansów, kontrolingu i księgowości 💲. Co tydzień pojawi się krótki film, w którym pokażę, jak każdy użytkownik Excela 💚 i Power BI 💛 może usprawnić swoją pracę.

Jeśli temat wykorzystania Power Query, Power Pivot, Power BI i dashboardów w pracy z danymi Cię interesuje, zapisz się na kurs POWER, zorganizuj szkolenie zamknięte lub weź udział w szkoleniu otwartym i rozpędź swoją karierę.

Sprawdzanie kontrahentów w Excelu poprzez KRS API

Pobierz plik Excel i sprawdź Twoich kontrahentów

Tu możesz pobrać plik Excel do łączenia się z KRS API i sprawdzić swoich kontrahentów.

Kurs „Pobieranie danych w Excelu dla finansistów” – co tydzień nowe wideo

Przed Tobą 19. lekcja z serii „Pobieranie danych w Excelu dla finansistów”. W kursie ukazały się dotychczas:

• Lekcja 1. Wczytaj przyjazny plik tekstowy
• Lekcja 2. Napraw „popsuty” plik tekstowy
• Lekcja 3. Połącz dane z wielu plików i uniknij Ctrl+C i Ctrl+V
• Lekcja 4. Najgorszy plik tekstowy, jaki mi się trafił
• Lekcja 5. Pobierz dane z pliku bankowego .MT940
• Lekcja 6. Dołącz w pionie wiele arkuszy z 1 pliku
• Lekcja 7. Wstaw tabelę przestawną na zapytaniu Power Query
• Lekcja 8. Porównaj 2 pliki Excel ze środkami trwałymi
• Lekcja 9. Zbuduj w Excelu saldo kont na bazie tabeli księgowań
• Lekcja 10. Napraw scalone komórki i spivotowane dane
• Lekcja 11. Pobierz plik z dysku OneDrive lub SharePointa
• Lekcja 12 i 13. Pobierz folder plików z dysku OneDrive lub SharePoint
• Lekcja 14. Pobierz dane z plików otrzymywanych regularnie na e-mail
• Lekcja 15. Pobierz dane do Excela z pliku PDF
• Lekcja 16. Pobierz dane z wielu plików PDF na raz
• Lekcja 17. Pobierz dane z pliku plik XML z deklaracją JPK_VAT
• Lekcja 18. Automatycznie pobieraj do Excela kursy walut z NBP

Kurs bazuje na codziennych wyzwaniach z działów finansów, kontrolingu i księgowości 💲. Co tydzień pojawi się krótki film, w którym pokażę, jak każdy użytkownik Excela 💚 i Power BI 💛 może usprawnić swoją pracę.

Jeśli temat wykorzystania Power Query, Power Pivot, Power BI i dashboardów w pracy z danymi Cię interesuje, zapisz się na kurs POWER, zorganizuj szkolenie zamknięte lub weź udział w szkoleniu otwartym i rozpędź swoją karierę.

Pobierz dane z białej listy podatników Ministerstwa Finansów

W filmie proszę o polubienie mojego kanału na YouTube. Możesz to zrobić, klikając przycisk:

Pobierz plik i sprawdź swoich kontrahentów w Excelu

Tu możesz pobrać gotowy plik Excel do sprawdzania kontrahentów na białej liście podatników.

Plik może wymagać zignorowania poziomów prywatności przy 1. uruchomieniu.

Pobierz narzędzie Excel do sprawdzania numeru konta w wykazie podatników VAT

Istnieje wiele metod wyszukiwania dostępnych w API. Ja zdecydowałem się na tę przydatną dla mnie jako mikro przedsiębiorcy – przed zleceniem przelewu sprawdzam go w wykazie. Plik po sprawdzeniu mogę zapisać, zachowując identyfikator sprawdzenia.

—–> Tu możesz pobrać plik Sprawdź numer konta w wykazie podatników VAT w Excelu <——–

Jeśli nie działa u Ciebie powyższy plik, spróbuj drugi, gdzie parametr data jest pobierany z Power Query.

—-> Tu możesz pobrać plik Sprawdź numer konta w wykazie podatników VAT w Excelu w wersji bez daty <——–

Narzędzie udostępniam bezpłatnie i dołożyłem wszelkich starań, aby działało poprawnie, ale nie daję gwarancji jego działania w przyszłości z racji stałych zmian w API. Pamiętaj, że korzystasz z niego na własne ryzyko. Do poprawnego działania narzędzia potrzebny jest Excel 365, 2016 lub 2019, a w przypadku wersji 2010 lub 2013 potrzebujesz doinstalować Power Query. Narzędzie nie działa we wcześniejszych wersjach Excela. Pamiętaj, że potrzebujesz dostępu do Internetu.

Jak sprawdzić numer konta w wykazie podatników VAT?

Krok 1: Wklej numery kont do tabeli Excel do kolumny A

Tabela automatycznie powinna się rozciągnąć.

Upewnij się, że wkleiły się jako teksty (np. poprzez polecenie Wklej jako wartości), gdyż Excel lub zgubić końcówki długich liczb. Na wszelki wypadek ustawiłem formatowanie kolumny A jako tekstowe.

Krok 2: Wybierz datę

Data ustawiona jest domyślnie jako data aktualna, ale możesz podstawić inną datę. Pamiętaj o formacie RRRR-MM-DD.

Krok 3: Na karcie Dane kliknij polecenie Odśwież wszystko

Polecenie wyśle numery kont do serwisu Ministerstwa Finansów. Przy pierwszym uruchomieniu mogą pojawić się Ustawienia prywatności, które możesz zignorować.

Krok 4:  Sprawdź podsumowanie

Krok 5: Przejrzyj statusy lub filtruj

Krok 6: Zobacz szczegóły w drugiej zakładce

Krok 7: Na wszelki wypadek zapisz kopię pliku do własnego archiwum

Co jeśli numer konta nie zostanie znaleziony?

Proponuję sprawdzić numer na stronie Ministerstwa Finansów ręcznie, aby upewnić się, że go nie ma.

Ograniczenia

W momencie tworzenia narzędzia na stronie dokumentacji API wskazanych było szereg ograniczeń (np. nie więcej niż 10 zapytań dziennie po maksymalnie 30 numerów kont), ale testując narzędzie, na żadne z nich się nie natknąłem, wysyłając kilkanaście razy po 300 zapytań. Istnieje jednak wiele sytuacji, gdy narzędzie nie zadziała prawidłowo lub wygeneruje błąd, co może wynikać z mojego niedopatrzenia, być wynikiem działania API lub wprowadzonych w nim nowości. Jeśli napotkasz problemy, napisz w komentarzu.

Co to jest „biała lista podatników”?

Wykaz podatników VAT, nazywany „białą listą podatników”, jest centralnym, elektronicznym rejestrem podatników VAT. Baza jest prowadzona przez Szefa Krajowej Administracji Skarbowej. Zrobiło się o niej głośno pod koniec 2019 r., gdyż transakcje powyżej 15 tys. zł muszą być realizowane na rachunki widniejące w wykazie podatników VAT w dniu zlecenia przelewu. Jeśli nie, przedsiębiorca nie zaliczy wydatku do kosztów uzyskania przychodów. Dlatego przed wykonaniem przelewu warto sprawdzić, czy numer konta się tam znajduje. Więcej o wykazie i konsekwencjach prawnych przeczytasz na stronie Ministerstwa Finansów.

Jak powstało narzędzie?

Budowa narzędzia wymagała zapoznania się z konstrukcją API oraz zaprojektowania zapytań w Power Query w programie Excel.

Krok 1: Zbuduj 2 tabele i wczytaj je do Power Query

Na początek budujemy 2 tabele z danymi: jedną dla numerów kont, a drugą dla daty sprawdzania.

Krok 2: Stwórz parametr z daty

Metodą wyszczególniania komórek tworzymy parametr Data.

W ten sposób powstaje parametr na liście zapytań.

Krok 3: Zbuduj przykładowe zapytanie do API

Tworzę nowe puste zapytanie do sieci Web i testuję, jak je interpretuje Power Query. Adres internetowy powstał po analizie dokumentacji API na stronie ministerstwa.

Krok 4: Skopiuj kod języka M i stwórz nową kolumnę niestandardową

Kolumna przyjmuje postać:

=Json.Document(Web.Contents("https://wl-api.mf.gov.pl/api/search/bank-account/"&[#"Podaj 26-znakowy numer konta"]&"?date="&Date.ToText(Data,"yyyy-MM-dd")))

gdzie Data to mój parametr z Excela.

Krok 5: Rozpakuj do poszukiwanych kolumn

Mnie interesuje, czy numer konta jest w ogóle na liście. Jeśli numer konta był błędny otrzymamy Error. Jeśli konto jest prawidłowe, możemy rozpakować dodatkowe parametry zapytania.

Po zamianie błędów na null, mogę przejść do rozpakowania.

Następnie tworzę kolumnę warunkową, która potwierdzi, czy numer konta jest czy go nie ma.

Krok 6: Rozdziel zapytania na podsumowanie, statusy i szczegóły

Poprzez odwołanie w Power Query tworzę 3 oddzielne zapytania i buduję z tego narzędzie z formatowaniem warunkowym.

Masz pytania lub uwagi?

Podziel się w komentarzu.

Krok 1: Utwórz konto Freemium na Here Maps

Konto założysz na stronie dla deweloperów Here Maps.

Po założeniu konta utwórz projekt i znajdź dla niego klucz API – jest niezbędny do stworzenia zapytania.

Krok 2: Stwórz kolumnę z adresem i zamień ją na tabelę

Utwórz nagłówek > wpisz (wklej) adresy > wstaw Tabelę (Ctrl + T).

Krok 3: Wczytaj tabelę jako nowe zapytanie do Excel Power Query

W Excelu 365 odpowiada za to przycisk Z tabeli / zakresu, na karcie Dane.

Krok 4: Dodaj kolumnę niestandardową i wklej link do API

Formuła API:

=Json.Document(Web.Contents("https://geocoder.ls.hereapi.com/6.2/geocode.json?apikey=X&searchtext="&[Adres]))

Gdzie X – to Twój kod API.

Krok 5: Rozpakuj strukturę json

Widełkami w prawym górnym rogu rozpakuj strukturę wyniku z json do tabelarycznej. Po chwili dokopiesz się do kolumn: Latitude i Longitude. Znajdziesz tam inne przydatne kolumny, np. Stopień dokładności i Poziom.

Krok 6: Pokaż punkty na mapie

Oto przykład mapy wstawionej do programu Excel do Mapy 3D.

Pobierz szablon Excel (wstaw swój klucz API)

Tu możesz pobrać plik z zapytaniem geokodującym w Here Maps, gdzie w miejsce X możesz w kodzie wstawić swój klucz API.

Co to jest API?

API, czyli interfejs programistyczny aplikacji (ang. Application Programming Interface), to sposób, w jaki programy komputerowe komunikują się między sobą. W skrócie chodzi o to, aby pomimo różnic pomiędzy systemami dane można było przesyłać w sposób zgodny i spójny. API jest zestawem reguł tych komunikacji.

Jak wygląda pobieranie danych z API KRS?

API KRS zostało zbudowane przez Fundację Moje Państwo. Szczegółowy opis tego API możemy znaleźć na stronie: https://rejestr.io/.

API pozwala na wyszukiwanie danych dla konkretnych firm w różnych polach. Aby skorzystać z API wybieramy w Excel Power Query pobieranie danych z sieci Web i wklejamy odpowiedni link.

Otrzymamy dane w formacie JSON, które w Power Query możemy skonwertować do postaci tabelarycznej.

Stąd już prosta droga do przeniesienia danych bezpośrednio do programu Excel.

Budowa narzędzi do zbiorowego przeszukiwania KRS

Bazując na API KRS możemy na wiele sposobów usprawnić swoją pracę – poprzez wykorzystanie go w ramach jednorazowych projektów (sprawdzenie wszystkich kontrahentów) lub cyklicznych procesów (każdorazowe sprawdzenie spółki). Przykładowo weryfikacja reprezentacji spółki, sprawdzana zwykle przez działy prawne przed podpisaniem umowy, może zająć tylko kilka sekund:

1. Wprowadź nazwę firmy
2. Kliknij „Sprawdź w KRS”

Wynik otrzymujesz w komórce.

Poznaj usługi pobierania danych

Serwis oferuje dużo więcej możliwości, jednak samodzielne zbudowanie narzędzia może okazać się rzeczą skomplikowaną. Dlatego warto spytać ekspertów – zajmujemy się budową różnych aplikacji z wykorzystaniem narzędzi BI Microsoft (Excel, Power BI, SQL Server, Azure). Nasze doświadczenia dotyczą nie tylko tego API KRS, ale też innych – dla każdego serwisu podejście może wyglądać w szczegółach inaczej.

Zainteresowany? Napisz do nas.