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
Podstawowe informacje
Kategoria: Plus Vendor Checker
Umiejscowienie akcji: Zmienna, Przycisk
Aktualna wersja: 1.0.5
Opis
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
- Najpierw sprawdza w pamięci serwera (CACHE)
- 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
UWAGA
Ze względu na sprawdzanie w Pliku Płaskim, sprawdzanie za pomocą numeru REGON zostało usunięte (Nie wspierane przez Plik Płaski).
Parametry konfiguracyjne
| Nazwa parametru | Od wersji | Opis | Typ parametru | Wartość domyślna | Uwagi i ograniczenia |
|---|---|---|---|---|---|
| NIP* | 1.0.0 | Wartość przechowująca nr NIP | Tekst | Usuwane są inne znaki niż cyfry | |
IBAN* | 1.0.0 | Międzynarodowy numer rachunku bankowego | Tekst | Usuwane są inne znaki niż cyfry. | |
Data* | 1.0.0 | Pobrane dane z dnia | Data | Gdy wartość pusta ustawiana jest aktualna data | |
Parametr ten nie jest już wspierany | |||||
| Status | 1.0.0 | Zmienna 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 zapytania | 1.0.0 | Identyfikator 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.0 | Włącza / wyłącza komentarz do procesu | Logiczny | NIE | |
| Dopisz ID zapytania | 1.0.5 | Dopisuje id zapytania do komentarza. np. "ID zapytania: la0ah-884ifj3." | Logiczny | NIE | Widoczne 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
Przykładowa konfiguracja
Change log
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.
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