Dlaczego powstało nasze API?
Protokoły wymiany danych powstały w odpowiedzi na potrzeby naszych Klientów m.in.: banków, firm pożyczkowych, leasingodawców, telekomów czy towarzystw ubezpieczeniowych. Za pośrednictwem naszych usług web (tzw. WebService-ów) udostępniamy wszystkie wiodące usługi Krajowego Rejestru Długów BIG S.A. – dzięki temu pomogliśmy zautomatyzować obsługę zleceń w kilkuset firmach. Nasze API jest stale rozwijane przez kilkudziesięciu programistów i dostosowywane do potrzeb naszych partnerów.
Jakie korzyści płyną z wdrożenia protokołów KRD API?
Wykorzystanie protokołów wymiany danych automatyzuje proces oceny ryzyka i pozwala dokładnie profilować przyszłych i obecnych Klientów. Jednocześnie usługi web KRD to narzędzia, które pozwolą Ci wytworzyć skuteczne mechanizmy odzyskiwania należności, tym samym zwiększając ROI Twojego wdrożenia.
KRD API – Opis techniczny protokołów
KRD API umożliwia kompleksową integrację z systemem informatycznym KRD. Integracja możliwa jest poprzez protokoły:
-
Chase – sprawdzanie firm (po NIP-ie) i konsumentów (po PESEL-u),
-
Nicci – sprawdzanie firm i konsumentów, zarządzanie informacjami gospodarczymi, zarządzanie monitoringami oraz inne operacje,
-
Rastin – sprawdzenie w rejestrze PESEL i Rejestrze Dowodów Osobistych (RDO) Ministerstwa Cyfryzacji poprawności danych przesłanych w zapytaniu,
-
API Solvig – sprawdzanie wyniku analizy wiarygodności płatniczej podmiotu niebędącego konsumentem w KRD (po NIP-ie) – Scoring KRD oraz opcjonalnie (oprócz scoringu) sprawdzanie maksymalnej kwoty, do jakiej rekomendowana jest sprzedaż usług lub towarów z odroczonym terminem płatności konkretnemu kontrahentowi – Limit Kupiecki KRD,
-
API Amnell – sprawdzanie aktualnego na moment zapytania statusu zastrzeżenia PESEL w Rejestrze Zastrzeżeń Numerów PESEL Ministerstwa Cyfryzacji,
-
API Wexler – sprawdzanie firm (po NIP-ie) w Bazie Sprawozdań Finansowych KRS.
Protokoły KRD API realizowane są za pośrednictwem osobnych WebService’ów; technologicznie różnią się w następujących obszarach:
-
Protokół Chase:
-
udostępniany jest poprzez WebService Chase,
-
wymaga wytworzenia przez programistów Klienta zintegrowanej aplikacji,
-
jest synchroniczny – wynik jest natychmiastowo zwracany przez wywołaną metodę interfejsu usługi,
-
umożliwia uwierzytelnienie dedykowanym certyfikatem klienckim zabezpieczonym dodatkowym hasłem,
-
umożliwia także uwierzytelnienie za pomocą loginu i hasła użytkownika systemu KRD.
-
Protokół Nicci:
-
udostępniany poprzez WebService Siddin,
-
wymaga uwierzytelnienia za pomocą loginu i hasła użytkownika systemu KRD,
-
przyjmuje żądania w formacie XML o ustalonym schemacie XSD mogące zawierać zlecenia wykonania wielu operacji w systemie – są to tzw. transze,
-
jest asynchroniczny: przekazane transze trafiają do kolejki FIFO; każda transza ma swój status przetworzenia – użytkownik może sprawdzać, czy jego transza została już przetworzona, jeśli tak, może pobrać wyniki w postaci tzw. transzy wynikowej (również w postaci XML),
-
umożliwia zarówno pełną integrację programistyczną z istniejącym systemem Klienta, jak i wysyłkę przygotowanych transz Nicci przy użyciu istniejącej aplikacji klienckiej Sabar (dowiedz się więcej o programie Sabar).
-
Protokół Rastin:
-
udostępniany jest poprzez WebService Rastin,
-
wymaga wytworzenia przez programistów Klienta zintegrowanej aplikacji,
-
jest synchroniczny – wynik jest natychmiastowo zwracany przez wywołaną metodę interfejsu usługi,
-
umożliwia uwierzytelnienie dedykowanym certyfikatem klienckim zabezpieczonym dodatkowym hasłem,
-
umożliwia także uwierzytelnienie za pomocą loginu i hasła użytkownika systemu KRD.
-
API Solvig:
-
udostępniane jest poprzez WebService Solvig,
-
wymaga wytworzenia przez programistów Klienta zintegrowanej aplikacji,
-
jest synchroniczne – wynik jest natychmiastowo zwracany przez wywołaną metodę interfejsu, ale umożliwia także odpytania asynchroniczne: przekazane transze trafiają do kolejki FIFO; każda transza ma swój status przetworzenia – użytkownik może sprawdzać, czy jego transza została już przetworzona, jeśli tak, może pobrać wyniki w postaci tzw. transzy wynikowej (w formacie JSON),
-
dostęp do API wymaga autoryzacji przez Reference Token i odpowiednich uprawnień do produktu Scoring KRD i Limit Kupiecki KRD,
-
metoda token pozwala na uzyskanie tokena, który jest wymagany do autoryzacji dostępu do naszych usług.
-
API Amnell:
-
udostępniane jest poprzez WebService Amnell,
-
wymaga wytworzenia przez programistów Klienta zintegrowanej aplikacji,
-
jest asynchroniczne: przekazane transze trafiają do kolejki FIFO; każda transza ma swój status przetworzenia – użytkownik może sprawdzać, czy jego transza została już przetworzona, jeśli tak, może pobrać wyniki w postaci tzw. transzy wynikowej (w formacie JSON),
-
dostęp do API wymaga autoryzacji przez Reference Token i odpowiednich uprawnień,
-
metoda token pozwala na uzyskanie tokena, który jest wymagany do autoryzacji dostępu do naszych usług.
-
API Wexler:
-
udostępniane jest poprzez WebService Wexler,
-
wymaga wytworzenia przez programistów Klienta zintegrowanej aplikacji,
-
dostępne jest w dwóch wersjach:
-
Pojedynczej (synchroniczna) – system KRD umożliwia wysłanie pojedynczego zapytania o sprawozdania finansowe za pomocą API, poprzez podanie konkretnego, pojedynczego numeru NIP oraz opcjonalnie informacji, czy zapytanie ma dotyczyć wszystkich dostępnych sprawozdań, czy tylko ostatniego (domyślnie zwracane są wszystkie sprawozdania),
-
Masowej (asynchroniczna) – system KRD umożliwia wysłanie masowego zapytania o sprawozdania finansowe za pomocą API, poprzez podanie wielu wybranych numerów NIP oraz opcjonalnie informacji, czy zapytanie ma dotyczyć wszystkich dostępnych sprawozdań, czy tylko ostatniego (domyślnie zwracane są wszystkie sprawozdania),
-
dostęp do API wymaga autoryzacji przez Reference Token i odpowiednich uprawnień,
-
metoda token pozwala na uzyskanie tokena, który jest wymagany do autoryzacji dostępu do naszych usług.
Poniższe tabelki w prosty sposób pokazują różnice między tymi sześcioma protokołami/API.
Protokół |
Synchroniczny |
Umożliwia użycie certyfikatu klienckiego |
Zarządzanie informacjami gospodarczymi |
Sprawdzanie |
Monitorowanie |
Sprawdzanie w rejestrze PESEL i Rejestrze Dowodów Osobistych (RDO) Ministerstwa Cyfryzacji |
Chase |
✓ |
✓ |
|
✓ |
|
|
Nicci |
|
|
✓ |
✓ |
✓ |
|
Rastin |
✓ |
✓ |
|
|
|
✓ |
API |
Synchroniczne |
Asynchroniczne |
Umożliwia użycie Reference Token |
Sprawdzanie informacji o Scoringu KRD |
Sprawdzanie informacji o Scoringu KRD uzupełnionym o rekomendowaną kwotę Limitu Kupieckiego KRD |
Sprawdzanie w Rejestrze Zastrzeżeń Numerów PESEL Ministerstwa Cyfryzacji |
Solvig |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Amnell |
|
✓ |
✓ |
|
|
✓ |
API |
Synchroniczne |
Asynchroniczne |
Umożliwia użycie Reference Token |
Sprawdzanie w Bazie Sprawozdań Finansowych KRS |
Wexler |
✓ |
✓ |
✓ |
✓ |
Dokumentacja techniczna
Protokół Chase
Pliki do pobrania: specyfikacje, przykładowa aplikacja kliencka, tutorial...Protokół Nicci
Pliki do pobrania: specyfikacje, przykładowa aplikacja kliencka, tutorial...Protokół Rastin
Pliki do pobrania: specyfikacje...API Solvig
Pliki do pobrania: specyfikacje...API Amnell
Pliki do pobrania: specyfikacje...API Wexler
Pliki do pobrania: specyfikacje...