MGBI dostarcza kompleksowe API do pobierania danych z rejestrów i ewidencji publicznych, w tym z Krajowego Rejestru Elektronicznego Przedsiębiorców Transportu Drogowego (KREPTD).
Listę źródeł danych dostępnych w tej usłudze znajdziesz na stronie:
👉 Rejestry Publiczne API
Ten poradnik dotyczy API dla Krajowego Rejestru Elektronicznego Przedsiębiorców Transportu Drogowego (KREPTD), który udostępniamy w ramach produktu:
👉 Krajowy Rejestr Elektroniczny Przedsiębiorców Transportu Drogowego API (KREPTD API)
Poniżej opisaliśmy, w jaki sposób możesz pobrać przez API rekord z aktualną treścią wpisu do KREPTD dla wskazanego przedsiębiorcy, na podstawie jego numerów rejestrowych lub numeru referencyjnego KREPTD.
Krok 1: Uzyskaj klucz autoryzacji w API
Aby zdobyć klucz autoryzacji wymagany przy wywoływaniu endpointów dostępnych w MGBI API, skontaktuj się z nami przy użyciu formularza kontaktowego na stronie produktu:
👉 Krajowy Rejestr Elektroniczny Przedsiębiorców Transportu Drogowego API (KREPTD API)
Krok 2: Wywołaj endpoint Get Records
Dane dostępne w KREPTD udostępniamy w MGBI API w modelu danych o identyfikatorze pl-kreptd-api-record.
API udostępnia dla tego modelu endpoint Get Records, który zwraca rekordy z treścią wpisów do KREPTD, spełniające podane kryteria.
👉 Dokumentacja endpointu Get Records dla modelu pl-kreptd-api-record
Pobranie rekordu z treścią wpisu do KREPTD dla danego przedsiębiorcy wymaga podania w endpoincie Get Records jego numeru rejestrowego: KRS, NIP lub REGON.
Przykład wywołania endpointu Get Records z numerem NIP:
GET /v1/models/pl-kreptd-api-record/records?identifiers.pl_nip=[numer NIP] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
Jeśli znasz numer referencyjny przedsiębiorcy w systemie KREPTD (w formacie P/RRRR/NNNNNNNN), możesz go podać w parametrze identifiers.pl_kreptd_reference_number.
Przykład wywołania endpointu Get Records z numerem referencyjnym KREPTD:
GET /v1/models/pl-kreptd-api-record/records?identifiers.pl_kreptd_reference_number=[numer referencyjny KREPTD] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
Krok 3: Odczytaj z odpowiedzi treść wpisu do KREPTD
Prawidłowe wywołanie endpointu Get Records zwraca w odpowiedzi aktualną treść wpisu do KREPTD dla danego przedsiębiorcy.
{
"count": 1,
"pages": 1,
"results": [
{
"id": "[identyfikator rekordu]",
"identifiers": "[identyfikatory podmiotu oraz numer referencyjny KREPTD]",
"content": "[treść wpisu do KREPTD]",
"meta": "[metadane rekordu]"
}
]
}
Wszystkie dane z wpisu do KREPTD dla wskazanego podmiotu możesz znaleźć w słowniku content.extracted_fields.
Przykładowa zawartość słownika content.extracted_fields:
{
"NumerReferencyjny": "[numer referencyjny przedsiębiorcy w KREPTD]",
"FirmaNazwa": "[nazwa przedsiębiorcy]",
"NIP": "[NIP przedsiębiorcy]",
"FormaPrawna": "[forma prawna przedsiębiorcy]",
"Adres": "[adres przedsiębiorcy]",
"ListaZarzadzajacyTransportemDaneWyszukane": {
"ZarzadzajacyTransportemDaneWyszukane": [
{
"Imiona": "[imię lub imiona osoby zarządzającej transportem]",
"Nazwisko": "[nazwisko osoby zarządzającej transportem]",
"NumerCertyfikatu": "[numer certyfikatu kompetencji zawodowych]",
"RodzajCertyfikatu": "[rodzaj certyfikatu kompetencji zawodowych]",
"DataWydaniaCertyfikatu": "[data wydania certyfikatu]",
"KrajWydajacyCertyfikat": "[kod kraju, który wydał certyfikat]"
}
]
},
"ListaZezwolenieNaWykonywanieZawoduPrzewoznikaDrogowegoTyp": {
"ZezwolenieNaWykonywanieZawoduPrzewoznikaDrogowegoTyp": [
{
"Zakres": "[zakres zezwolenia: Osoby / Rzeczy]",
"Numer": "[numer zezwolenia]",
"StatusZezwolenia": "[status zezwolenia: Ważne / Ważność wygasła]",
"OrganWydajacy": "[organ, który wydał zezwolenie]",
"DataWydania": "[data wydania zezwolenia]",
"LiczbaPojazdow": "[liczba pojazdów objętych zezwoleniem]"
}
]
},
"ListaLicencjaWspolnotowaTyp": {
"LicencjaWspolnotowaTyp": [
{
"Zakres": "[zakres licencji wspólnotowej]",
"Numer": "[numer licencji wspólnotowej]",
"StatusLicencji": "[status licencji wspólnotowej]",
"PoczatekWaznosci": "[data początku ważności licencji]",
"KoniecWaznosci": "[data końca ważności licencji]",
"LiczbaPojazdow": "[liczba pojazdów objętych licencją]"
}
]
},
"ListaWypisowZLicencjiTyp": "[wypisy z licencji wspólnotowych]",
"ListaWypisowZzezwoleniaTyp": "[wypisy z zezwoleń]",
"ListaPrzedstawicieliPrawnychTyp": {
"PrzedstawicielPrawny": [
{
"Imiona": "[imię lub imiona przedstawiciela prawnego]",
"Nazwisko": "[nazwisko przedstawiciela prawnego]"
}
]
}
}
Informacje o uprawnieniach przedsiębiorcy znajdziesz w listach zezwoleń na wykonywanie zawodu przewoźnika drogowego (ListaZezwolenieNaWykonywanieZawoduPrzewoznikaDrogowegoTyp) i licencji wspólnotowych (ListaLicencjaWspolnotowaTyp).
Aktualny status każdego dokumentu podają pola StatusZezwolenia i StatusLicencji. W przypadku cofnięcia, zawieszenia lub wygaśnięcia uprawnienia w rekordzie znajdziesz również odpowiednie daty oraz powód zawieszenia lub wycofania.
Uzyskaj więcej informacji:
👉 Struktura danych w modelu pl-kreptd-api-record
👉 Dokumentacja endpointów dla modelu pl-kreptd-api-record