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

> Як в Excel заповнити назву, адресу, REGON і статус VAT контрагентів лише за NIP. Power Query і безкоштовний API реєстру платників VAT без ключа. Готовий код.

Джерело: https://przejmijai.pl/uk/artykuly/dane-firmy-po-nip-excel
Оновлено: 22 листопада 2026 р.
Автор: PrzejmijAI (przejmijai.pl)

Список контрагентів лише з номерами 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](https://www.gov.pl/web/kas/api-wykazu-podatnikow-vat)). Цього достатньо для типового заповнення даних контрагентів.

**API GUS (BIR)** безкоштовний, але [ключ користувача треба замовити електронною поштою](https://api.stat.gov.pl/Home/RegonApi?lang=en), вказавши, зокрема, назву й REGON фірми, контактну особу, IP-адреси та орієнтовну кількість запитів. Підключитися з Excel без програмування тут складно, тому в цій статті ми залишаємося при «білому списку». Окремі фірми, які не є платниками VAT, перевірите вручну в пошуковику REGON на сайті GUS (польського статистичного управління).

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

За даними [сторінки Міністерства фінансів про API](https://www.gov.pl/web/kas/api-wykazu-podatnikow-vat):

- метод пошуку (**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]?]
```

3. Натисніть **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 за допомогою ШІ](https://przejmijai.pl/uk/artykuly/porzadkowanie-danych-w-excelu-z-ai).

## Готові запити до ШІ

> У 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](https://przejmijai.pl/uk/artykuly/formuly-excel-po-polsku-z-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](https://przejmijai.pl/uk/artykuly/kursy-walut-nbp-excel).

Хочете впевненіше користуватися ШІ та автоматизацією на роботі? Перевірте свої знання й отримайте [безкоштовний сертифікат «ШІ в офісній роботі» українською](https://przejmijai.pl/uk/certyfikat?utm_source=artykul-uk&utm_medium=cta&utm_campaign=dane-firmy-po-nip-excel).
