Powrót do spisu komponentów: Plus VENDOR Checker

Jeśli masz problem ze zrozumieniem jak działa akcja, sprawdź opisy: Akcja, Wykonanie warunkowe, Parametry komponentów

Kategoria: Plus Vendor Checker

Umiejscowienie akcji: Zmienna, Przycisk

Aktualna wersja: 1.0.5

Akcja sprawdza nr NRB z nr NIP na tzw. Białej Liście z MF. Akcja uruchamia się na zmianę wartości zmiennych lub na przycisk na formularzu. Akcja zwraca odpowiedź w formie chmurki na formularzu lub zapisuje do zmiennej. Można także włączyć komentarz. Przy poprawnym zapytaniu zwracany jest nr zapytania, który można zapisać do zmiennej formularza. Każde poprawne zapytanie jest zapisywane w tabeli wewnętrznej. Tab_1. pm_vendor_checker.

Algorytm sprawdzania

  1. Najpierw sprawdza w pamięci serwera (CACHE)
  2. Gdy nie znaleziono, to sprawdza, czy w Bazie danych są dane, o które pytamy
    a. Jeżeli nie to pyta API MF (ONLINE)
    b. Jeżeli tak to odpytuje bazę danych (DATABASE), Jeżeli baza danych nie zwróci wyniku lub zwróci jakiś błąd to odpytuje dodatkowo API MF.

Aby akcja mogła sprawdzać w pliku płaskim, należy taki plik załadować do bazy danych za pomocą zadania zaplanowanego [Zadanie Zaplanowane] Pobieranie Pliku Płaskiego lub [Zadanie Zaplanowane] Pobieranie konkretnego Pliku Płaskiego

 

Z poziomu przeglądarki można sprawdzić numer za pomocą wyszukiwarki: https://www.podatki.gov.pl/wykaz-podatnikow-vat-wyszukiwarka 

lub za pomocą API https://wl-api.mf.gov.pl/api/search/bank-account/03124069609732000053279465?date=2021-01-01

Ze względu na sprawdzanie w Pliku Płaskim, sprawdzanie za pomocą numeru REGON zostało usunięte (Nie wspierane przez Plik Płaski).

Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaUwagi i ograniczenia
NIP*1.0.0Wartość przechowująca nr NIP Tekst Usuwane są inne znaki niż cyfry

IBAN*

1.0.0Międzynarodowy numer rachunku bankowegoTekst Usuwane są inne znaki niż cyfry.

Data*

1.0.0Pobrane dane z dniaData Gdy wartość pusta ustawiana jest aktualna data
Typ*1.0.4Wybór typu parametru NIP/REGONLista wartościNIP

Informuję jaki nr jest podany w parametrze NIP/REGON

Parametr ten nie jest już wspierany

Status1.0.0Zmienna do zapisu zwróconego statusu (TAK/NIE/Informacje o błędzie)Zmienna tekstowa Gdy nieustawiona parametru, informacja będzie zwracana w postaci chmurki na formularzu
Identyfikator zapytania1.0.0Identyfikator jest unikalnym identyfikatorem zapytania do API, mogącym także potwierdzać fakt dokonania tego zapytania przed organami podatkowymi.Zmienna tekstowa W momencie wystąpienia błędu zapisywana jest wartość pusta.
Komentarz *1.0.0Włącza / wyłącza komentarz do procesuLogicznyNIE 
Dopisz ID zapytania1.0.5Dopisuje id zapytania do komentarza. np. "ID zapytania: la0ah-884ifj3."LogicznyNIEWidoczne tylko wtedy gdy parametr Komentarz jest ustawiony na tak. Id zapytania zaczynające się od flatfile-... są to wewnętrzne identyfikatory systemu PlusWorkflow. Id bez tego prefixu są nadawane przez MF.

Parametr*- pole wymagane

 

1.0.1

  • Utworzenie komponentu

1.0.4 (obowiązująca dokumentacja)

  • Dodanie obsługi sprawdzania w pliku płaskim
  • Usunięcie sprawdzania za pomocą numeru REGON
  • Poprawa komunikatów w języku angielskim

1.0.5 (obowiązująca dokumentacja)

  • Dodanie możliwości zapisanie id zapytania w komentarzu.