Перш ніж підписати договір або перерахувати аванс, переконайтеся, що постачальник є в реєстрі, не перебуває в стані припинення й не втягнутий у справу про банкрутство. Відповідь дає один запит за кодом ЄДРПОУ, а моніторинг повідомить, якщо щось зміниться.
Постачальника зазвичай перевіряють один раз, перед підписанням договору. Але компанія може перейти в стан припинення, потрапити у справу про банкрутство або змінити назву вже за кілька місяців після першої перевірки. Для фінансових і закупівельних команд це ризик: аванс компанії, якої більше немає, або рахунок, назва в якому не збігається з реєстром. Реєстр відповідає на питання «чи існує юридична особа і в якому вона стані», тому перевірка за ним має бути не разовою, а регулярною.
Для України перевірку роблять за кодом ЄДРПОУ. Дані оновлюються щотижня, тож перевіряйте постачальника перед кожним новим договором і перед великою передоплатою, а для чинних постачальників увімкніть моніторинг: про зміну статусу, припинення, збіг із санкційними списками (бета) та зміни в реєстрі вебхук повідомить сам, без ручних повторних перевірок. Якщо вебхук вам не потрібен, лишається перевірка за розкладом (наприклад, раз на тиждень чи раз на місяць).
GET /companies/search?country=UA&company_number=... знаходить постачальника й повертає назву, форму, статус, дати та статутний капітал;POST /companies/lookup перевіряє список кодів одним викликом: кожна позиція коштує 1 кредит;POST /monitor додає постачальника до моніторингу: вебхук повідомляє про зміну статусу, припинення, збіг із санкційним списком (бета) і події змін у реєстрі;GET /company-events/search?country=UA&company_number=... повертає події змін у реєстрі (2 кредити);GET /sanctions/screen?name=... перевіряє назву за санкційними списками (бета, 3 кредити);GET /vat/{number} перевіряє номер ПДВ іноземного постачальника з ЄС у VIES.import requests
BASE = "https://api.prometiam.com/functions/v1/risk-api"
H = {"Authorization": "Bearer rk_live_..."}
suppliers = ["21673832", "14359609"] # коди ЄДРПОУ з вашого переліку постачальників
for code in suppliers:
r = requests.get(f"{BASE}/companies/search", headers=H, timeout=30,
params={"country": "UA", "company_number": code})
r.raise_for_status()
data = r.json().get("data", [])
if not data:
print(code, "немає в даних: перевірте код і тип особи")
continue
c = data[0]
flag = "" if c["status"] == "active" else " <-- ПЕРЕВІРИТИ"
print(code, c["company_name"], c["status"], c.get("local_status"), flag)
Скрипт можна запускати за розкладом: він показує, хто з постачальників більше не має статусу active або зник з даних, і лише їх треба переглядати вручну.
Перевірка за розкладом знаходить зміну лише під час наступного запуску. Моніторинг спрацьовує сам: додайте постачальника один раз, і вебхук повідомить про зміну статусу, припинення, збіг із санкційними списками (бета) та події змін у реєстрі. Події охоплюють назву, статус, організаційно-правову форму й статутний капітал; їх датовано днем, коли зміну вперше побачено в даних реєстру (дані читаються щотижня). Адрес у подіях немає, бо реєстр їх не публікує, а подій раніше за запуск України в жовтні 2026 року немає.
import requests
BASE = "https://api.prometiam.com/functions/v1/risk-api"
H = {"Authorization": "Bearer rk_live_..."}
for code in ["21673832", "14359609"]: # коди ЄДРПОУ постачальників
r = requests.get(f"{BASE}/companies/search", headers=H, timeout=30,
params={"country": "UA", "company_number": code})
r.raise_for_status()
for c in r.json().get("data", []):
requests.post(f"{BASE}/monitor", headers=H, timeout=30, json={
"company_id": c["id"],
"country": "UA",
"label": code, # ваша позначка: вона повертається в сповіщенні
"webhook_url": "https://example.com/hooks/prometiam",
}).raise_for_status()
Кожен вебхук підписано: заголовок X-Prometiam-Signature містить підпис HMAC-SHA256 від тіла сповіщення, обчислений із webhook_secret, який повертає POST /monitor. У сповіщенні є ваш label і тип (alert_type). Без вебхука сповіщення можна читати через GET /monitor. Керування моніторингом кредитів не коштує, а кількість компаній визначає тариф: Starter — 25, Professional — 250, Scale — 2 500.
Події однієї компанії повертає GET /company-events/search?country=UA&company_number=21673832. Без company_number той самий виклик дає стрічку недавніх подій усієї країни: за замовчуванням за 7 днів, не далі ніж на 31 день назад. Виклик коштує 2 кредити.
| Поле | Що це означає для перевірки постачальника |
|---|---|
status, local_status | Чинна реєстрація, стан припинення чи банкрутство; local_status — формулювання реєстру |
company_name, legal_form | Чи збігаються назва та форма з договором і рахунком |
founding_date | Дата державної реєстрації: як давно існує компанія |
dissolution_date | Дата припинення, якщо юридичну особу припинено |
capital_amount, capital_currency | Статутний капітал у гривнях (UAH), якщо реєстр його наводить |
Щоб перевірку можна було пояснити під час аудиту чи спору, зберігайте разом із рішенням: код ЄДРПОУ перевіреної компанії, отримані назву, форму, status і local_status, дату перевірки та того, хто її зробив. Якщо постачальник у моніторингу, зберігайте й отримані сповіщення з датами: дата події — це день, коли зміну вперше побачено в даних реєстру. Якщо перевірку повторюють за розкладом, зберігайте кожен результат із датою: так видно, коли зміна вперше потрапила у ваші дані.
dissolution_date: юридичну особу припинено; з’ясуйте, чи є правонаступник, перш ніж щось сплачувати.Це технічний опис роботи, а не юридична порада: рішення про співпрацю ухвалює ваша компанія.
Contains data from the Unified State Register of Legal Entities, Individual Entrepreneurs and Public Organisations (EDR), Ministry of Justice of Ukraine, published as open data on data.gov.ua under the Creative Commons Attribution licence (CC BY 4.0). Adapted by Prometiam.
Тарифи публічні, розмова з відділом продажів не потрібна. Starter коштує 9,99 € на місяць (1 000 кредитів), Professional — 29,99 € (10 000 кредитів), Scale — 99,99 € (50 000 кредитів), Enterprise — за домовленістю. Пошук компанії або її запис коштує 1 кредит, перевірка за санкційними списками (бета) — 3 кредити; відповіді з помилками безкоштовні. Пробний період триває 14 днів і містить 500 кредитів: потрібна банківська картка, під час пробного періоду кошти не списуються, далі діє Starter, якщо ви не скасуєте підписку. Докладніше: ціни.
Розпочати безкоштовний 14-денний пробний період · Документація API
Пробний період триває 14 днів і містить 500 кредитів. Потрібна банківська картка, під час пробного періоду кошти не списуються; далі діє тариф Starter (9,99 € на місяць), якщо ви не скасуєте підписку.