Zanim zapłacisz pierwszą fakturę, sprawdź, czy dostawca istnieje, w jakim jest stanie i czy jego numer VAT ma sens. Jedno zapytanie REST po KRS, NIP lub REGON, potem stały monitoring.
Zakupy, finanse i księgowość robią w praktyce to samo: przy nowym dostawcy ktoś otwiera KRS, ktoś inny białą listę, trzeci sprawdza REGON w GUS. Każde z tych sprawdzeń trwa kilka minut, jest robione ręcznie i rzadko jest powtarzane po podpisaniu umowy. Tymczasem spółka może zmienić status, trafić do likwidacji albo zmienić siedzibę już po onboardingu.
Dla firmy płacącej setki faktur miesięcznie to realne ryzyko. Przy transakcji z innym przedsiębiorcą o wartości powyżej 15 000 zł przelew na rachunek spoza wykazu podatników VAT (białej listy) może wyłączyć wydatek z kosztów podatkowych (art. 15d ustawy o CIT), a nabywca może odpowiadać solidarnie za zaległy VAT dostawcy (art. 117ba Ordynacji podatkowej), chyba że zapłaci w mechanizmie podzielonej płatności albo złoży zawiadomienie ZAW-NR. Instytucje obowiązane w rozumieniu ustawy o przeciwdziałaniu praniu pieniędzy i finansowaniu terroryzmu muszą ponadto stosować środki bezpieczeństwa finansowego wobec własnych klientów, a nie tylko dostawców. API pozwala zautomatyzować to, co da się zautomatyzować, i zostawić człowiekowi decyzję.
Prometiam udostępnia jedno API REST z oficjalnymi danymi rejestrowymi z 18 krajów, a dla Polski z KRS. Przepływ weryfikacji dostawcy to dwa zapytania, a trzecie włącza obserwację:
GET /companies/search?country=PL szuka po numerze KRS (company_number), po NIP lub REGON albo po nazwie (name). Zwraca id rekordu.GET /companies/{id} zwraca pełny, ustandaryzowany profil: nazwa, status, forma prawna, adres, data założenia, numer VAT.GET /vat/{numer} sprawdza numer VAT UE w systemie VIES, gdy potrzebujesz potwierdzenia rejestracji.POST /monitor z {"company_id": ..., "country": "PL"} obserwuje spółkę i wysyła webhook przy zmianie statusu, rozwiązaniu lub trafieniu sankcyjnym.# 1. Znajdź dostawcę po numerze KRS (Orlen S.A.)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=PL&company_number=0000028860' \
-H 'Authorization: Bearer rk_live_...'
# 2. Pobierz profil po id z odpowiedzi
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/{id}' \
-H 'Authorization: Bearer rk_live_...'
# 3. Włącz monitoring po podpisaniu umowy
curl -X POST 'https://api.prometiam.com/functions/v1/risk-api/monitor' \
-H 'Authorization: Bearer rk_live_...' \
-H 'Content-Type: application/json' \
-d '{"company_id": 123, "country": "PL"}'
Samą spółkę możesz też najpierw sprawdzić za darmo w naszych narzędziach: wyszukiwarka KRS, sprawdzanie firmy po NIP i biała lista podatników VAT.
| Pole | Co oznacza |
|---|---|
company_name | Nazwa spółki z KRS |
company_number, identifiers | Numer KRS oraz NIP i REGON |
status i local_status | Standardowy status oraz status własnymi słowami rejestru |
legal_form i local_legal_form | Forma prawna: standardowa i taka, jak w rejestrze (sp. z o.o., S.A. itd.) |
founding_date | Data założenia |
| adres | Siedziba: ulica, miejscowość, kod pocztowy |
vat_number, vat_number_source | Numer VAT zbudowany z NIP (PL + NIP), źródło rule |
Numer VAT w Polsce ma źródło rule: format jest poprawny, ale rejestracja nie jest potwierdzona przez rejestr. Potwierdzenie czynnego statusu VAT dostajesz przez GET /vat/PL... (VIES) albo przez naszą białą listę VAT. Ten sam obiekt firmy ma identyczne klucze dla każdego z 18 krajów, więc dostawcę z Francji, Wielkiej Brytanii czy Hiszpanii sprawdzasz tym samym kodem.
POST /monitor), nie przez strumień zdarzeń./insolvency/search./companies/{id}/financials, plan Scale) tylko dla spółek giełdowych, często z opóźnieniem ponad roku.Przy zakupach, w których sprawdzasz kilkuset dostawców rocznie, wystarczy Starter (9,99 € miesięcznie, 1 000 kredytów). Webhooki z monitoringu i pełny screening sankcyjny (beta) są w planie Professional (29,99 €, 10 000 kredytów). Plan Scale (99,99 €, 50 000 kredytów) dodaje sprawozdania finansowe. Ceny są publiczne, bez rozmowy handlowej, a rozliczenie roczne daje dwa miesiące gratis.
Dane o Polsce pochodzą z Krajowego Rejestru Sądowego i są aktualizowane codziennie. Prometiam to API, nie wyciąg z rejestru: do celów prawnych korzystaj z oficjalnego odpisu.
Rozpocznij 14-dniowy darmowy okres próbny · Dokumentacja API
Okres próbny trwa 14 dni i obejmuje 500 kredytów. Wymagana jest karta, w trakcie okresu próbnego nic nie jest pobierane; potem obowiązuje plan Starter (9,99 € miesięcznie), jeśli go nie anulujesz.