API onboardingu KYB — firmy UE i UK w 30 liniach kodu

Ta strona pokazuje, jak zbudować proces onboardingu KYB (Know Your Business) dla firm z UE i Wielkiej Brytanii za pomocą API Prometiam, z naciskiem na przypadek polskiego kontrahenta. Onboarding kontrahenta B2B w regulowanej branży finansowej wymaga udowodnienia, że firma legalnie istnieje, sprawdzenia, kto ją kontroluje, oraz zbadania ekspozycji na sankcje. Zamiast łączyć osobnych dostawców danych dla Hiszpanii, Francji, Wielkiej Brytanii, Irlandii, Polski i Norwegii oraz osobnego dostawcę sankcji, Prometiam pokrywa warstwę rejestrową i sankcyjną jednym zestawem endpointów REST, z rozliczeniem za wywołania.

Integracja w 30 sekund

Trzy endpointy pokrywają przepływ: znajdź kontrahenta przez /companies/search po numerze KRS (Polska) — parametr company_number — nazwie, NIF (Hiszpania) lub SIREN (Francja); pobierz pełny profil przez /companies/{id}; następnie sprawdź osobę prawną i osoby podane przez klienta w /sanctions/screen. Dla Polski API jest na poziomie firmy: nie zwraca członków zarządu, danych z CRBR ani z KRZ — dla Hiszpanii, Francji, Wielkiej Brytanii i Norwegii ten sam endpoint zwraca też dirigentów (appointments), więc krok screeningu członków zarządu dotyczy tych czterech krajów, nie Polski.

Co otrzymujesz

  • Tożsamość: nazwa, numer KRS/NIF/SIREN/company_number, forma prawna, adres, data założenia
  • Dane rejestrowe (tomo/libro/folio/hoja dla Hiszpanii, siedziba sądu rejestrowego dla Francji, numer Companies House dla Wielkiej Brytanii)
  • Dla ES/FR/GB/NO: obecni i historyczni członkowie zarządu; dla Polski i Irlandii — dane wyłącznie na poziomie firmy
  • Kapitał zakładowy i przedmiot działalności, status aktualizowany codziennie

Screening sankcyjny (beta) porównuje nazwy przybliżonym dopasowaniem wobec sześciu źródeł — UE, ONZ, OFAC, UK OFSI, francuski rejestr zamrożeń, oraz pełna US Consolidated Screening List (BIS Entity List, Denied Persons, ITAR) — ponad 44 000 aktywnych podmiotów, z progiem dopasowania do ustawienia. Screening PEP jest w becie i ograniczony do Hiszpanii, bez krewnych i bliskich współpracowników. Beneficjenci rzeczywiści są dostępni wyłącznie z brytyjskiego rejestru PSC. Dane BORME i BODACC aktualizowane są codziennie, polski rejestr KRS — codziennie, Companies House — comiesięcznym zbiorem plus codzienną aktualizacją.

Czytaj więcej (English edition) · Uzyskaj darmowy klucz API

Frequently asked questions

Co to jest KYB?
KYB (Know Your Business) to regulowany proces weryfikacji kontrahenta firmowego przed rozpoczęciem współpracy. Zwykle wymaga potwierdzenia istnienia prawnego (rejestr), beneficjentów rzeczywistych, ekspozycji na sankcje i negatywnych informacji medialnych. API Prometiam pokrywa warstwę rejestrową i sankcyjną w jednym zestawie endpointów.
Jakie kraje obejmuje KYB Prometiam?
Hiszpanię (BORME), Francję (BODACC), Wielką Brytanię (Companies House), Irlandię (CRO, poziom firmy), Polskę (KRS, poziom firmy) i Norwegię (Brønnøysundregistrene, firmy i osoby). Użyj ?country=ES|FR|GB|IE|PL|NO na każdym endpoincie.
Czy KYB Prometiam obejmuje screening sankcyjny?
Tak — plan Professional (29,99 €/mies.) obejmuje /sanctions/screen, który porównuje przybliżonym dopasowaniem wobec sześciu źródeł: skonsolidowanej listy UE, ONZ, OFAC, UK OFSI, francuskiego rejestru zamrożeń oraz pełnej US Consolidated Screening List list eksportowych, w jednym wywołaniu. Screening sankcyjny jest w wersji beta.
Czy dla Polski API zwraca zarząd i beneficjentów rzeczywistych (UBO)?
Nie. Dane polskie z KRS są na poziomie firmy: nazwa, numer KRS, adres, forma prawna, status. Prometiam nie udostępnia polskiego składu zarządu, danych z CRBR (Centralny Rejestr Beneficjentów Rzeczywistych) ani z KRZ (Krajowy Rejestr Zadłużonych). Hiszpania, Francja, Wielka Brytania i Norwegia zwracają przez ten sam endpoint obecnych i historycznych członków zarządu (appointments); dla brytyjskich spółek dostępny jest też rejestr PSC. Dla polskich kontrahentów screening sankcyjny obejmuje nazwę spółki oraz nazwiska, które poda klient — nie listę oficjalnych członków zarządu.
Czy dane są wystarczająco świeże dla onboardingu w czasie rzeczywistym?
Polski rejestr KRS, hiszpański BORME i francuski BODACC są aktualizowane codziennie z oficjalnych źródeł. Companies House jest aktualizowany comiesięcznym zbiorem plus codzienną aktualizacją delta. /coverage zwraca datę latest_filing dla każdego kraju.