Про дані Prozorro.Sale

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

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

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

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

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

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

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

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

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

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

Різні типи процедур мають різну структуру даних і бізнес-процеси. Назви частини полів у ЦБД-1, ЦБД-2 та новій ЦБД відрізняються. Відмінностей у назвах ЦБД-оновлена та ЦБД-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. Інофрмація про роботу з ВІ

Контакти

Служба підтримки Прозорро.Продажі:
Питання по роботі системи та проведення аукціонів: