MGBI bietet eine umfassende API zum Abruf von Daten aus öffentlichen Registern und Verzeichnissen, darunter aus dem Amtsblatt für öffentliche Aufträge (BZP).
Eine Liste der in diesem Dienst verfügbaren Datenquellen findest du auf der Seite:
👉Öffentliche Register API
Dieser Leitfaden bezieht sichauf die API für das Amtsblatt für öffentliche Aufträge, die wir im Rahmen des Produkts „
“ zur Verfügung stellen 👉API für das Amtsblatt für öffentliche Aufträge (BZP API)
Im Folgenden beschreiben wir, wie Sieüber die API den Inhalt der im BZP veröffentlichten Ausschreibungen für ein bestimmtes Unternehmenanhand dessen Registrierungsnummer (NIP, REGON oder KRS)abrufenkönnen.
Schritt 1: Beziehen Sie einen Autorisierungsschlüssel über die API
Um den Autorisierungsschlüssel zu erhalten, der für den Aufruf der in der MGBI-API verfügbaren Endpunkte erforderlich ist, kontaktieren Sie uns bitte über das Kontaktformular auf der Produktseite:
👉API für das Amtsblatt für öffentliche Aufträge (BZP API)
Schritt 2: Rufe den Endpunkt „Get Records“ auf
Die im BZP verfügbaren Daten stellen wir in der MGBI-API im Datenmodell mit der Kennung„pl-bzp-record“ bereit.
Die API stellt für dieses Modell den Endpunkt„Get Records“ bereit, der Datensätze mit dem Inhalt von BZP-Anzeigen für Unternehmen zurückgibt, die die angegebenen Kriterien erfüllen.
👉Dokumentation zum Endpunkt „Get Records“ für das Modell „pl-bzp-record“
Um die Liste der Bekanntmachungen für ein einzelnes Unternehmen abzurufen, muss im Endpunkt „Get Records“ dessen Registrierungsnummer angegeben werden: NIP, REGON oder KRS.
Beispiel für den Aufruf des Endpunkts „Get Records“ mit der Steuernummer:
GET /v1/models/pl-bzp-record/records?identifiers.pl_nip=[Steuernummer] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]Schritt 3: Lesen Sie aus der Antwort die Liste der Ausschreibungen aus dem BZP ab
Ein korrekter Aufruf des Endpunkts„Get Records“gibt als Antwort eine Liste der Datensätze zurück, die den angegebenen Kriterien entsprechen.
Im obigen Beispiel sollte der Endpunkt eine Ergebnisliste mit einem oder mehreren Datensätzen zurückgeben:
{
"count": "[liczba wyników]",
"pages": "[liczba stron wyników]",
"results": [
{
"id": "[identyfikator rekordu]",
"identifiers": "[identyfikatory podmiotu]",
"content": "[treść ogłoszenia]",
"notice": "[informacje o ogłoszeniu]",
"meta": "[metadane rekordu]"
}
]
}Jeder Datensatz in der Liste enthält eine Reihe von Ausschreibungsbekanntmachungen aus dem BZP, die sich auf das angegebene Unternehmen beziehen.
Die wichtigsten Informationen zur Bekanntmachung finden Sie im Glossar unter„Bekanntmachung“.
Inhalt des „notice“-Wörterbuchs für eine einzelne Anzeige:
{
"type": "[rodzaj ogłoszenia]",
"number": "[numer ogłoszenia]",
"poblication_datetime": "[data i czas publikacji]"
}Alle in der Anzeige enthaltenen Details sowie deren Inhalt im HTML-Format findest du im Verzeichnis„content.raw_result“.
Inhalt des Wörterbuchs „content.raw_result“ für eine einzelne Anzeige:
{
"objectId": "[identyfikator ogłoszenia]",
"clientType": "[rodzaj zamawiającego]",
"orderType": "[rodzaj zamówienia]",
"tenderType": "[tryb zamówienia]",
"noticeType": "[rodzaj ogłoszenia]",
"noticeNumber": "[numer ogłoszenia]",
"bzpNumber": "[numer BZP]",
"isTenderAmountBelowEU": "[tryb / rodzaj procedury]",
"publicationDate": "[data publikacji]",
"orderObject": "[nazwa zamówienia / nazwa konkursu]",
"cpvCode": "[kod CPV]",
"submittingOffersDate": "[termin składania ofert]",
"procedureResult": "[wynik postępowania]",
"organizationName": "[nazwa zamawiającego]",
"organizationCity": "[miejscowość zamawiającego]",
"organizationProvince": "[województwo zamawiającego]",
"organizationCountry": "[kraj zamawiającego]",
"organizationNationalId": "[krajowy numer identyfikacyjny]",
"organizationId": "[identyfikator organizacji]",
"tenderId": "[identyfikator postępowania]",
"htmlBody": "[zawartość ogłoszenia w postaci HTML]",
"contractors": "[lista wykonawców]"
}Weitere Informationen:
👉Datenstruktur im Modell „pl-bzp-record“
👉Dokumentation der Endpunkte für das Modell „pl-bzp-record“
