Як за допомогою API завантажити інформацію про тендери з Бази даних про публічні закупівлі (BZP), що стосуються вказаного суб’єкта?

MGBI надає комплексний API для отримання даних із державних реєстрів та облікових баз, зокрема з Бюлетеня державних закупівель (BZP).

Перелік джерел даних, доступних у цій службі, можна знайти на сторінці:
👉API публічних реєстрів

Цей посібник стосуєтьсяAPI для Бюлетеня державних закупівель, який ми надаємо в рамках продукту:
👉API Бюлетеня державних закупівель (BZP API)

Нижче ми описали, якза допомогою APIможназавантажити зміст оголошень, опублікованих у BZP для вказаного суб’єкта господарюванняна підставі його реєстраційного номера (NIP, REGON або KRS).

Крок 1: Отримати ключ авторизації в API

Щоб отримати ключ авторизації, необхідний для виклику кінцевих точок, доступних в MGBI API, зв’яжіться з нами за допомогою контактної форми на сторінці продукту:
👉Бюлетень державних закупівель API (BZP API)

Крок 2: Викличте кінцеву точку Get Records

Дані, доступні в BZP, ми надаємо в MGBI API у вигляді моделі даних з ідентифікаторомpl-bzp-record.

API надає для цієї моделі кінцеву точкуGet Records, яка повертає записи, що містять зміст оголошень BZP для суб’єктів, які відповідають вказаним критеріям.
👉Документація кінцевої точки Get Records для моделі pl-bzp-record

Щоб завантажити список оголошень для окремого суб’єкта господарювання, у кінцевій точці Get Records необхідно вказати його реєстраційний номер: NIP, REGON або KRS.

Приклад виклику ендпойнту Get Records із номером NIP:

GET /v1/models/pl-bzp-record/records?identifiers.pl_nip=[номер NIP] HTTP/1.1
Host: api.mgbi.pl
Authorization: [ключ авторизації]

Крок 3: З відповіді вичитайте перелік оголошень із BZP

При правильному виклику кінцевої точкиGet Recordsу відповідь повертається список записів, що відповідають вказаним критеріям.

У наведеному вище прикладі кінцева точка повинна повернути список результатів, що містить один або кілька записів:

{
    "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]"
        }
    ]
}

Кожен запис у списку містить набір оголошень про тендери з БЗП, що стосуються вказаного суб’єкта.

Найважливіша інформація про оголошення міститься у словникуnotice.

Зміст словника notice для окремого оголошення:

{
    "type": "[rodzaj ogłoszenia]",
    "number": "[numer ogłoszenia]",
    "poblication_datetime": "[data i czas publikacji]"
}

Усі детальні дані, наведені в оголошенні, а також його зміст у форматі HTML можна знайти у словникуcontent.raw_result.

Вміст словника content.raw_result для окремого оголошення:

{
    "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]"
}

Дізнайтеся більше:
👉Структура даних у моделі pl-bzp-record
👉Документація щодо кінцевих точок для моделі pl-bzp-record