Дані фірми за NIP в Excel: назва, адреса й REGON з «білого списку»

Як в Excel заповнити назву, адресу, REGON і статус VAT контрагентів лише за NIP. Power Query і безкоштовний API реєстру платників VAT без ключа. Готовий код.
Список контрагентів лише з номерами NIP (податковий номер), а для зведення потрібні повні назви, адреси й номери REGON (статистичний номер фірми). Копіювати з пошуковика по одній фірмі — це година роботи. Excel може завантажити ці дані сам із публічного Wykaz podatników VAT (реєстру платників VAT, так званого «білого списку»), який веде Міністерство фінансів Польщі.
Звідки брати дані: «білий список» чи GUS?
Є два офіційні джерела, і варто знати, чим вони відрізняються.
| «Білий список» (реєстр платників VAT) | GUS – база REGON (BIR) | |
|---|---|---|
| Ключ доступу | не потрібен | треба подати запит на ключ |
| Які фірми | платники VAT чинні, звільнені та виключені | усі суб’єкти в реєстрі REGON |
| Дані | назва, адреса, REGON, KRS, статус VAT, рахунки | повні реєстраційні дані, PKD, організаційно-правова форма |
| Найпростіший шлях з Excel | Power Query, кілька рядків коду | потрібен програміст (сервіс на технології SOAP) |
API «білого списку» не вимагає автентифікації (так зазначено в специфікації MF). Цього достатньо для типового заповнення даних контрагентів.
API GUS (BIR) безкоштовний, але ключ користувача треба замовити електронною поштою, вказавши, зокрема, назву й REGON фірми, контактну особу, IP-адреси та орієнтовну кількість запитів. Підключитися з Excel без програмування тут складно, тому в цій статті ми залишаємося при «білому списку». Окремі фірми, які не є платниками VAT, перевірите вручну в пошуковику REGON на сайті GUS (польського статистичного управління).
Ліміти, які треба знати
За даними сторінки Міністерства фінансів про API:
- метод пошуку (search) дозволяє 100 запитів на день, кожен — максимум про 30 суб’єктів,
- після вичерпання ліміту доступ можуть заблокувати до півночі, також у пошуковику на сайті,
- з 15 жовтня 2026 р. робоча адреса API —
https://wykazpodatnikowvat.mf.gov.pl/api/, а стараwl-api.mf.gov.plмає працювати до 1 грудня 2026 р., - реєстр буває важкодоступним щодня з 22:00 до 0:00, бо тоді оновлюються дані.
На практиці: один NIP — це один запит, тож цей спосіб підійде приблизно для 90 контрагентів на день. Для більших списків попросіть ШІ про версію з методом search/nips, який приймає до 30 номерів одночасно (запит нижче).
Крок 1: функція, що завантажує дані за NIP
- В Excel: Dane > Pobierz dane > Z innych źródeł > Puste zapytanie (Дані > Отримати дані > З інших джерел > Пустий запит).
- Натисніть Edytor zaawansowany (Розширений редактор), видаліть вміст і вставте:
(nip as any) =>
let
Nip = Text.Select(Text.From(nip), {"0".."9"}),
Dzis = Date.ToText(Date.From(DateTime.LocalNow()), "yyyy-MM-dd"),
Odpowiedz = try Json.Document(Web.Contents("https://wykazpodatnikowvat.mf.gov.pl",
[RelativePath = "api/search/nip/" & Nip, Query = [date = Dzis]])) otherwise null,
Podmiot = if Odpowiedz = null then null else Odpowiedz[result][subject]
in
if Podmiot = null then
[Nazwa = "BRAK W WYKAZIE LUB BŁĘDNY NIP", Adres = null, REGON = null, KRS = null, StatusVAT = null, IdZapytania = null]
else
[Nazwa = Podmiot[name],
Adres = if Podmiot[residenceAddress]? <> null then Podmiot[residenceAddress]? else Podmiot[workingAddress]?,
REGON = Podmiot[regon]?,
KRS = Podmiot[krs]?,
StatusVAT = Podmiot[statusVat]?,
IdZapytania = Odpowiedz[result][requestId]?]
- Натисніть Gotowe (Готово) і назвіть запит
DaneFirmy.
Що робить цей код: видаляє з NIP дефіси, пробіли й префікс «PL», запитує реєстр про стан на сьогодні й повертає шість полів. Для компаній API подає адресу місцезнаходження, для одноосібних підприємців — адресу діяльності, тому код бере те поле, яке заповнене.
Крок 2: список контрагентів
- На аркуші впишіть NIP у стовпець із заголовком
NIPі перетворіть діапазон на таблицю (Wstaw > Tabela, Вставлення > Таблиця). Назвіть їїKontrahenci. - Клацніть у таблицю: Dane > Z tabeli/zakresu (Дані > З таблиці/діапазону).
- Змініть тип стовпця
NIPна Tekst (Текст) — значок у заголовку стовпця. - Dodaj kolumnę > Wywołaj funkcję niestandardową (Додати стовпець > Викликати користувацьку функцію), виберіть
DaneFirmy, якnipвкажіть стовпецьNIP. - Розгорніть новий стовпець значком двох стрілок і позначте потрібні поля.
- Zamknij i załaduj (Закрити й завантажити).
У стовпці StatusVAT ви побачите, напр., «Czynny» (чинний) або «Zwolniony» (звільнений). IdZapytania — це унікальний ідентифікатор, який MF присвоює кожному запиту. Його варто зберегти як слід того, коли дані перевіряли.
Крок 3: оновлюйте з розумом
Кожне натискання Odśwież (Оновити) — це нова порція запитів у рахунок ліміту. Тому:
- не оновлюйте щохвилини, раз на день достатньо,
- після завантаження даних можна скопіювати результат і вставити його як значення на окремий аркуш,
- нових контрагентів додавайте в окрему коротку таблицю, а не оновлюйте весь список.
Попередній перегляд у редакторі Power Query теж надсилає запити, тож працюйте на кількох рядках, а все завантажте наприкінці.
Заповнення формулою замість ручного копіювання
Коли у вас уже є таблиця з даними з реєстру (назвемо її Wykaz), дані для рахунків чи зведень підтягнете звичайною формулою:
=X.WYSZUKAJ(A2;Wykaz[NIP];Wykaz[Nazwa];"SPRAWDŹ NIP")
Якщо NIP у вашому файлі записані з дефісами, спершу уніфікуйте їх:
=PODSTAW(PODSTAW(USUŃ.ZBĘDNE.ODSTĘPY(A2);"-";"");"PL";"")
Більше про очищення таких даних ми пишемо у статті про впорядкування даних в Excel за допомогою ШІ.
Готові запити до ШІ
У Power Query в мене є функція, яка завантажує дані фірми з API реєстру платників VAT (Wykaz podatników VAT) методом search/nip (код нижче). Перероби її так, щоб вона використовувала метод api/search/nips/{nips}, який приймає до 30 номерів NIP через кому. Список NIP є в таблиці Kontrahenci, стовпець NIP. Поділи його на пакети по 30 і поверни одну таблицю. [вставте код]
Польський Excel, назви функцій польською, крапка з комою як роздільник. У стовпці A є NIP у різних форматах: з дефісами, з пробілами, з префіксом PL. Напиши формулу, яка залишить самі цифри й позначить «BŁĘDNY», якщо цифр не рівно 10.
Поясни простими словами, чим адреса місцезнаходження відрізняється від адреси ведення діяльності в польському реєстрі платників VAT.
Перевірка формату NIP — добрий перший фільтр, перш ніж надіслати запит і витратити ліміт. Правила написання формул для польського Excel ми описуємо в тексті про формули Excel польською з ChatGPT.
Найпоширеніші проблеми
- «BRAK W WYKAZIE LUB BŁĘDNY NIP» (немає в реєстрі або неправильний NIP) для існуючої фірми. Фірма може не бути платником VAT. «Білий список» охоплює суб’єктів, зареєстрованих для VAT, а також тих, кого з реєстру виключили або не зареєстрували. Інші фірми перевірте в базі REGON.
- Раптом усі рядки з помилкою. Імовірно, вичерпано денний ліміт запитів. Зачекайте до півночі й оновіть менший список.
- Помилка «Formula.Firewall». Power Query блокує поєднання даних з аркуша з даними з інтернету. Перейдіть у Plik > Opcje i ustawienia > Opcje zapytania > Bieżący skoroszyt > Prywatność (Файл > Параметри й настройки > Параметри запиту > Поточна книга > Конфіденційність) і виберіть ігнорування рівнів конфіденційності. Робіть це лише у файлі, де до API надсилаються тільки номери NIP.
- NIP перетворюється на число й втрачає формат. Задайте стовпцю тип Tekst (Текст) перед викликом функції.
- Дані відрізняються від рахунку. Реєстр показує стан на день запиту. Якщо фірма змінила адресу, нове значення з’явиться після оновлення реєстру.
- Стара адреса API перестала працювати. Якщо копіюєте код з інших посібників, замініть
wl-api.mf.gov.plнаwykazpodatnikowvat.mf.gov.pl.
Та сама техніка (функція Power Query, яку викликають для кожного рядка) працює з курсами валют. Ми описали її у статті про курси валют NBP в Excel.
Хочете впевненіше користуватися ШІ та автоматизацією на роботі? Перевірте свої знання й отримайте безкоштовний сертифікат «ШІ в офісній роботі» українською.
Джерела і дата перевірки
Станом на 22 листопада 2026 р..
- специфікації MF (gov.pl)
- ключ користувача треба замовити електронною поштою (api.stat.gov.pl)
Ціни, функції інструментів і закони можуть змінитися після цієї дати, тож перед важливими рішеннями перевірте актуальний стан у джерелі.