Czytaj po polsku →

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

22 листопада 2026 р. · 6 хв читання

Як в 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 (польського статистичного управління).

Безкоштовний сертифікат «ШІ в офісній роботі». 20 запитань українською, близько 20 хвилин, сертифікат із номером для резюме та LinkedIn. Отримати сертифікат →

Ліміти, які треба знати

За даними сторінки Міністерства фінансів про 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

  1. В Excel: Dane > Pobierz dane > Z innych źródeł > Puste zapytanie (Дані > Отримати дані > З інших джерел > Пустий запит).
  2. Натисніть 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]?]
  1. Натисніть Gotowe (Готово) і назвіть запит DaneFirmy.

Що робить цей код: видаляє з NIP дефіси, пробіли й префікс «PL», запитує реєстр про стан на сьогодні й повертає шість полів. Для компаній API подає адресу місцезнаходження, для одноосібних підприємців — адресу діяльності, тому код бере те поле, яке заповнене.

Крок 2: список контрагентів

  1. На аркуші впишіть NIP у стовпець із заголовком NIP і перетворіть діапазон на таблицю (Wstaw > Tabela, Вставлення > Таблиця). Назвіть її Kontrahenci.
  2. Клацніть у таблицю: Dane > Z tabeli/zakresu (Дані > З таблиці/діапазону).
  3. Змініть тип стовпця NIP на Tekst (Текст) — значок у заголовку стовпця.
  4. Dodaj kolumnę > Wywołaj funkcję niestandardową (Додати стовпець > Викликати користувацьку функцію), виберіть DaneFirmy, як nip вкажіть стовпець NIP.
  5. Розгорніть новий стовпець значком двох стрілок і позначте потрібні поля.
  6. 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 р..

Ціни, функції інструментів і закони можуть змінитися після цієї дати, тож перед важливими рішеннями перевірте актуальний стан у джерелі.

Безкоштовний сертифікат «ШІ в офісній роботі» українською.Перевірте свої знання за 20 хвилин і отримайте сертифікат для резюме та LinkedIn.Отримати сертифікат →

Читайте також