noscript

Про дані Prozorro.Sale


Дані електронної торгової системи Prozorro.Продажі є доступними та відкритими для їх подальшого вільного використання та поширення. Будь-яка особа може вільно копіювати, публікувати, поширювати, використовувати, у тому числі в комерційних цілях, у поєднанні з іншою інформацією або шляхом включення до складу власного продукту, публічну інформацію у формі відкритих даних з обов’язковим посиланням на джерело отримання такої інформації. Доступ до даних можливий двома способами: через публічний модуль аналітики (дані представлені у агрегованому вигляді за допомогою графіків та таблиць) та через спеціальні ендпоінти

Відкриті дані

ДП “Прозорро.Продажі” оперує трьома інстансами системи електронних аукціонів: ЦБД-1, ЦБД-2 та нова ЦБД. В різних інстансах в різний час відбувались аукціони  по різних напрямках роботи. Під напрямком мається на увазі групування аукціонів за типом процедури продажу. Наприклад, земельні торги або продаж необробленої деревини. Детальніше про напрямки можна почитати  тут:

Напрямки роботи

Основною одиницею даних є процедура аукціону (procedure). У цій структурі зберігаються такі дані:

- весь перебіг подій одного аукціону від оголошення до остаточного завершення

- інформаціяю про організатора процедури

- інформацію про об’єкт продажу (item) 

- інформацію про ставки учасників (bid)

- інформацію про можливих переможців (award)

- інформацію про укладені угоди


Різні типи процедур мають різну структуру даних і бізнес-процеси. Назви частини полів у ЦБД-1, ЦБД-2 та новій ЦБД відрізняються. Відмінностей у назвах ЦБД-3 та ЦБД-1 або ЦБД-2  більше, ніж у назвах полів ЦБД-1 та ЦБД-2 між собою

Адреси ЦБД

- ЦБД-1 (Майно та активи ФГВФО)

https://public.api.ea.openprocurement.org/api/2/auctions

https://public.api.registry.ea.openprocurement.net/api/0.1/assets

- ЦБД-2 (Майно та активи всіх інших організаторів. Нові процедури не розробляються)

https://public.api.ea2.openprocurement.net/api/2/auctions

- ЦБД-нова (Майно та активи всіх інших організаторів. Розробляються нові процедури, існуючі у ЦБД-2 процедури поступово будуть переноситись у нову ЦБД)

№1: https://dgf-procedure.prozorro.sale/api

№2: https://procedure.prozorro.sale/api


Як отримати дані

ЦБД-1, ЦБД-2:

  1. Робимо запит по відповідному ендпоінту
  2. У відповідь отримуємо:
    • перелік зі 100 ID процедур
    • посилання на сторінку з наступними 100 ID процедур
  3. Підставляючи в кінці адреси кожен з отриманих ID і у відповідь отримуємо дані кожної з процедур (наприклад, https://public.api.ea.openprocurement.org/api/2/auctions/8076e2654e2b4865a1b1fd7839e120b4)
  4. Переходимо на сторінку з наступними 100 ID процедур, отриманими на кроці 2.b (перехід за посиланням з uri)

ЦБД-нова:

  1. Переходимо за посиланням https://procedure.prozorro.sale/api/search/byDateModified/2021-01-01?limit=100 - це ендпоінт пошуку по даті зміни, запущений з 1.01.2021 з максимально доступним лімітом (100 записів)
  2. Отримуємо і забираємо повні дані 100 найстаріших процедур
  3. З отриманого сету процедур обираємо ту, що була змінена останньою, беремо значення dateModified для цієї процедури, додаємо до нього одну мілісекунду
  4. Підставляємо отримане значення в посилання з п.1 замість 2021-01-01, таким чином отримуємо наступні 100 процедур (наприклад, https://procedure.prozorro.sale/api/search/byDateModified/2021-01-04T14:15:31.763000Z?limit=100)


Більше інформації можна почитати у Confluence

  1. Інформація про параметри для різних напрямків роботи та статуси процедур
  2. Інофрмація про роботу з ВІ