Weryfikator paczek przelewów — Biała Lista VAT

Q: Jakie formaty plików obsługuje weryfikator?

Elixir-0 (Multicash PLI) — najczęstszy format krajowy używany do paczek przelewów oraz CSV z eksportów bankowych (autodetekcja separatora ; lub ,, mapowanie kolumn po nazwach nazwa/odbiorca/kontrahent, nrb/konto/rachunek/iban, kwota, nip). Format pain.001 (XML ISO 20022) dodamy w kolejnej wersji.

Q: Czy plik z paczką przelewów zostaje na serwerze?

Nie. Plik jest usuwany zaraz po sparsowaniu. Nie zapisujemy nazw odbiorców, kwot ani powiązania Ciebie z rachunkami. Cache wyników API MF jest anonimowy i współdzielony — trzyma tylko publiczne dane z wykazu VAT.

Q: Co oznacza status DO SPRAWDZENIA?

Podobieństwo nazw mieści się w przedziale 45–62% — czyli nie na tyle wysokie żeby dać zielone światło, ale nie na tyle niskie żeby uznać przelew za podejrzany. Najczęściej to skrócona nazwa albo literówka. Jeśli paczka zawiera NIP odbiorcy i przy tym statusie widzisz dopisek „NIP potwierdza rachunek, ale nazwa nie pasuje" — potwierdź NIP osobno, bo mógł być podmieniony razem z rachunkiem.

Q: Jak działa check NIP + rachunek?

Gdy paczka zawiera NIP odbiorcy (typowo CSV z eksportu księgowego), pytamy oddzielnym endpointem MF, czy dana para NIP+NRB tworzy prawidłowe przypisanie. Odpowiedź jest wiążąca: TAK → ZGODNY, NIE → NIEZGODNY, niezależnie od podobieństwa nazw. Elixir-0 nie zawiera NIP odbiorcy, więc dla tego formatu decyduje samo porównanie nazw.

Q: Dlaczego mam status BRAK W WYKAZIE zamiast czerwonego alertu?

Biała Lista zawiera wyłącznie podatników VAT. Osoby prywatne, ZUS, urzędy skarbowe, komornicy, rachunki wirtualne czy zagraniczne banki nie figurują w wykazie. Status BRAK oznacza „nie znalazłem" — nie oznacza automatycznie oszustwa. Potwierdź kontakt inną drogą.

Q: Jak działa dopasowanie rozmyte nazw?

Normalizujemy obie nazwy: wielkie litery, usunięcie polskich znaków, wycięcie form prawnych (sp. z o.o., S.A., P.H.U., F.H.U., P.P.H.U. itd.), redukcja spacji. Potem liczymy podobieństwo procentowe (similar_text w PHP) i sprawdzamy zawieranie krótszej nazwy w dłuższej — bo format Elixir ucina nazwy do 35 znaków.

Q: Dlaczego widzę limit dzienny zapytań?

API Białej Listy MF ma dwa limity: 100 zapytań zbiorczych dziennie na IP dla metody search i 5000 podmiotów dziennie dla metody check. Po przekroczeniu któregokolwiek MF blokuje IP do godziny 0:00. Nasze narzędzie zatrzymuje się z zapasem i informuje o resetowaniu — zamiast blokować sobie dostęp.

Q: Co oznacza requestId w raporcie CSV?

Każde zapytanie do API MF zwraca requestId — urzędowy identyfikator, który jest dowodem, że tego dnia sprawdziłeś dane konta w Białej Liście VAT. Zachowaj raport CSV — w razie kontroli skarbowej to potwierdzenie należytej staranności.

Q: Czy to jest ta sama weryfikacja co w Ewidencja Faktur?

Tak, korzystamy z tego samego oficjalnego API MF i tego samego algorytmu. Różnica: w aplikacji Ewidencja Faktur weryfikacja odbywa się automatycznie przy każdej fakturze i przelewie, tutaj masz jednorazowe darmowe narzędzie do sprawdzenia gotowej paczki z innego systemu.

Q: Czym różni się wersja desktop od wersji WWW?

Aplikacja desktop dla Windows (plik instalacyjny ~8 MB) wykonuje weryfikację lokalnie na Twoim komputerze — plik z paczką nie opuszcza Twojej sieci, zapytania do API Białej Listy MF idą z Twojego adresu IP (własny limit 100/dobę dla search i 5000/dobę dla check zamiast puli wspólnej z innymi użytkownikami strony). Algorytm porównania nazw i reguła NIP są identyczne — obie implementacje przechodzą tę samą tabelę testów odniesienia, więc wyniki nie różnią się. Wybierz desktop, jeśli pracujesz z dużymi paczkami albo z danymi, które nie mogą wychodzić poza firmową sieć.

💻

Wersja desktop dla Windows

Jeśli nie chcesz wysyłać paczki przelewów przez internet, użyj aplikacji desktop. Weryfikacja odbywa się lokalnie na Twoim komputerze — plik z paczką nie opuszcza sieci wewnętrznej. Algorytm identyczny co w wersji WWW (przechodzi te same testy odniesienia).

⬇ Pobierz dla Windows (8 MB)

Jak to działa

6 kroków weryfikacji paczki

Cały proces jest automatyczny i trwa kilka sekund. Nie musisz nic konfigurować.

01

Wgrywasz plik

Elixir-0 (Multicash PLI) lub CSV z eksportu bankowego. Automatycznie wykrywamy format i kodowanie (CP1250, ISO-8859-2, UTF-8).

02

Parsujemy przelewy

Wyciągamy nazwę odbiorcy, numer rachunku i (dla CSV) NIP. Plik znika z serwera zaraz po sparsowaniu.

03

Walidacja NRB

Sprawdzamy sumę kontrolną każdego rachunku algorytmem IBAN (mod 97). Błędne NRB nie są wysyłane do API — oszczędzamy limit.

04

Pytamy API MF (search)

Jedno zapytanie zbiorcze do wl-api.mf.gov.pl (do 30 kont). Otrzymujemy właścicieli rachunków z Białej Listy VAT + requestId — urzędowy dowód weryfikacji.

05

Porównanie nazw

Dopasowanie rozmyte: normalizacja, usunięcie form prawnych, procentowe podobieństwo. Progi: ≥62% ZGODNY, 45–62% DO SPRAWDZENIA, <45% NIEZGODNY.

06

Check NIP + rachunek

Gdy paczka zawiera NIP odbiorcy — dodatkowe zapytanie potwierdzające przypisanie rachunku do NIP-u. Odpowiedź wiążąca: TAK zielone, NIE czerwone niezależnie od podobieństwa nazw.

Co oznaczają statusy?

ZGODNY

Nazwa odbiorcy pasuje do właściciela rachunku (≥62%) albo NIP potwierdza przypisanie rachunku. Przelew można wysłać bezpiecznie.

DO SPRAWDZENIA

Rozjazd nazw (45–62%) — najczęściej skrócona nazwa albo literówka. Jeśli NIP potwierdza rachunek mimo bardzo niskiej zgodności nazw — sprawdź, czy NIP w pliku nie został podmieniony.

NIEZGODNY

Możliwa podmiana konta. Nazwa nie zgadza się z właścicielem rachunku, albo NIP + rachunek nie tworzą prawidłowej pary. Wstrzymaj przelew i potwierdź konto u kontrahenta.

BŁĘDNY NRB

Numer rachunku ma nieprawidłową sumę kontrolną (algorytm IBAN). Popraw NRB w pliku.

BRAK W WYKAZIE

Konta nie ma na Białej Liście. Wykaz obejmuje tylko podatników VAT — osoby prywatne, ZUS, urzędy skarbowe, rachunki wirtualne z definicji tam nie figurują. Potwierdź kontakt inną drogą.

NIEZWERYFIKOWANY

Dzienny limit API MF wyczerpany albo błąd komunikacji. Powtórz weryfikację po północy — nie traktuj jako potwierdzonego.

Najczęstsze pytania

Jakie formaty plików obsługuje weryfikator?

Elixir-0 (Multicash PLI) — najczęstszy format krajowy używany do paczek przelewów oraz CSV z eksportów bankowych (autodetekcja separatora ; lub ,, mapowanie kolumn po nazwach nazwa/odbiorca/kontrahent, nrb/konto/rachunek/iban, kwota, nip). Format pain.001 (XML ISO 20022) dodamy w kolejnej wersji.

Czy plik z paczką przelewów zostaje na serwerze?

Nie. Plik jest usuwany zaraz po sparsowaniu. Nie zapisujemy nazw odbiorców, kwot ani powiązania Ciebie z rachunkami. Cache wyników API MF jest anonimowy i współdzielony — trzyma tylko publiczne dane z wykazu VAT.

Co oznacza status DO SPRAWDZENIA?

Podobieństwo nazw mieści się w przedziale 45–62% — czyli nie na tyle wysokie żeby dać zielone światło, ale nie na tyle niskie żeby uznać przelew za podejrzany. Najczęściej to skrócona nazwa albo literówka. Jeśli paczka zawiera NIP odbiorcy i przy tym statusie widzisz dopisek „NIP potwierdza rachunek, ale nazwa nie pasuje" — potwierdź NIP osobno, bo mógł być podmieniony razem z rachunkiem.

Jak działa check NIP + rachunek?

Gdy paczka zawiera NIP odbiorcy (typowo CSV z eksportu księgowego), pytamy oddzielnym endpointem MF, czy dana para NIP+NRB tworzy prawidłowe przypisanie. Odpowiedź jest wiążąca: TAK → ZGODNY, NIE → NIEZGODNY, niezależnie od podobieństwa nazw. Elixir-0 nie zawiera NIP odbiorcy, więc dla tego formatu decyduje samo porównanie nazw.

Dlaczego mam status BRAK W WYKAZIE zamiast czerwonego alertu?

Biała Lista zawiera wyłącznie podatników VAT. Osoby prywatne, ZUS, urzędy skarbowe, komornicy, rachunki wirtualne czy zagraniczne banki nie figurują w wykazie. Status BRAK oznacza „nie znalazłem" — nie oznacza automatycznie oszustwa. Potwierdź kontakt inną drogą.

Jak działa dopasowanie rozmyte nazw?

Normalizujemy obie nazwy: wielkie litery, usunięcie polskich znaków, wycięcie form prawnych (sp. z o.o., S.A., P.H.U., F.H.U., P.P.H.U. itd.), redukcja spacji. Potem liczymy podobieństwo procentowe (similar_text w PHP) i sprawdzamy zawieranie krótszej nazwy w dłuższej — bo format Elixir ucina nazwy do 35 znaków.

Dlaczego widzę limit dzienny zapytań?

API Białej Listy MF ma dwa limity: 100 zapytań zbiorczych dziennie na IP dla metody search i 5000 podmiotów dziennie dla metody check. Po przekroczeniu któregokolwiek MF blokuje IP do godziny 0:00. Nasze narzędzie zatrzymuje się z zapasem i informuje o resetowaniu — zamiast blokować sobie dostęp.

Co oznacza requestId w raporcie CSV?

Każde zapytanie do API MF zwraca requestId — urzędowy identyfikator, który jest dowodem, że tego dnia sprawdziłeś dane konta w Białej Liście VAT. Zachowaj raport CSV — w razie kontroli skarbowej to potwierdzenie należytej staranności.

Czy to jest ta sama weryfikacja co w Ewidencja Faktur?

Tak, korzystamy z tego samego oficjalnego API MF i tego samego algorytmu. Różnica: w aplikacji Ewidencja Faktur weryfikacja odbywa się automatycznie przy każdej fakturze i przelewie, tutaj masz jednorazowe darmowe narzędzie do sprawdzenia gotowej paczki z innego systemu.

Czym różni się wersja desktop od wersji WWW?

Aplikacja desktop dla Windows (plik instalacyjny ~8 MB) wykonuje weryfikację lokalnie na Twoim komputerze — plik z paczką nie opuszcza Twojej sieci, zapytania do API Białej Listy MF idą z Twojego adresu IP (własny limit 100/dobę dla search i 5000/dobę dla check zamiast puli wspólnej z innymi użytkownikami strony). Algorytm porównania nazw i reguła NIP są identyczne — obie implementacje przechodzą tę samą tabelę testów odniesienia, więc wyniki nie różnią się. Wybierz desktop, jeśli pracujesz z dużymi paczkami albo z danymi, które nie mogą wychodzić poza firmową sieć.

Inne narzędzia

Weryfikator paczek przelewów — Biała Lista VAT

Wersja desktop dla Windows

6 kroków weryfikacji paczki

Wgrywasz plik

Parsujemy przelewy

Walidacja NRB

Pytamy API MF (search)

Porównanie nazw

Check NIP + rachunek

Co oznaczają statusy?

Najczęstsze pytania

Pozostałe bezpłatne narzędzia

Automatyczna Biała Lista przy każdej fakturze

Weryfikator paczek przelewów — Biała Lista VAT

Wersja desktop dla Windows

6 kroków weryfikacji paczki

Wgrywasz plik

Parsujemy przelewy

Walidacja NRB

Pytamy API MF (search)

Porównanie nazw

Check NIP + rachunek

Co oznaczają statusy?

Najczęstsze pytania

Pozostałe bezpłatne narzędzia

Generator mikrorachunku US

Generator QR dla faktur KSeF

Konwerter CSV (mBank) → MT940 (.sta)

Konwerter XML → PDF (KSeF)

Przeglądarka e-SF XML

Sprawdzarka NIP — Biała Lista VAT

Automatyczna Biała Lista przy każdej fakturze