Про дані Prozorro.Sale
ДП “Прозорро.Продажі” оперує трьома інстансами системи електронних аукціонів: ЦБД-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
ЦБД-нова [версія]
№1: https://dgf-procedure.prozorro.sale/api
№2: https://procedure.prozorro.sale/api
Отримання даних
ЦБД-1, ЦБД-2:
- Робимо запит по відповідному ендпоінту
- У відповідь отримуємо:
- перелік зі 100 ID процедур
- посилання на сторінку з наступними 100 ID процедур
- Підставляючи в кінці адреси кожен з отриманих ID і у відповідь отримуємо дані кожної з процедур (наприклад, https://public.api.ea.openprocurement.org/api/2/auctions/8076e2654e2b4865a1b1fd7839e120b4)
- Переходимо на сторінку з наступними 100 ID процедур, отриманими на кроці 2.b (перехід за посиланням з uri)
ЦБД-нова:
- Переходимо за посиланням https://procedure.prozorro.sale/api/search/byDateModified/2021-01-01?limit=100 - це ендпоінт пошуку по даті зміни, запущений з 1.01.2021 з максимально доступним лімітом (100 записів)
- Отримуємо і забираємо повні дані 100 найстаріших процедур
- З отриманого сету процедур обираємо ту, що була змінена останньою, беремо значення dateModified для цієї процедури, додаємо до нього одну мілісекунду
- Підставляємо отримане значення в посилання з п.1 замість 2021-01-01, таким чином отримуємо наступні 100 процедур (наприклад, https://procedure.prozorro.sale/api/search/byDateModified/2021-01-04T14:15:31.763000Z?limit=100)
Напрями роботи і параметри процедур
Напрям роботи | ЦБД-1 | ЦБД-2 | ЦБД-нова |
Продаж майна та активів | - | procurementMethodType==dgfOtherAssets OR procurementMethodType==appraisal.insider крім аукціонів з ознакою оренди (CPVS==PA01-7), аукціонів з ознакою банкрутства (CPVS == QB23-5), аукціонів з ознакою деревини (CPVS == QB49-3), аукціонів з ознакою вагонів (CPVS == MA08-5) | Ендпоінт №2 sellingMetod==basicSell-english, sellingMetod==basicSell-dutch |
Відчуження | - | Була реалізована в межах базового продажу | Ендпоінт №2 sellingMetod==alienation-english |
Мала приватизація | - | procurementMethodType==sellout.english OR procurementMethodType==sellout.insider |
|
Оренда державного та комунального майна | - | CPVS== QB29-3 | Ендпоінт №2 sellingMetod==legitimatePropertyLease-* (priorityEnglish, english, dutch) |
Оренда майна та активів | CPVS==PA01-7 and CPVS != QB29-3 (всі аукціони оренди крім CPVS== QB29-3, які відносяться до оренди державного майна) |
| |
Продаж активів банків-банкрутів (ФГВФО) | procurementMethodType==dgfFinancialAssets FinancialAssets OR procurementMethodType==dgfOtherAssets OR procurementMethodType==dgfInsider | - | Ендпоінт №1 sellingMethod==dgf-english OR sellingMethod == dgf-dutch |
Банкрутство | - | CPVS == QB23-5 | Ендпоінт №2 (поки доступні тільки на sandbox оточенні. Для доступу достаньо використати посилання виду https://procedure-sandbox.prozorro.sale/api/search/bySellingMethod/bankRuptcy-english?limit=100&dateModified=2022-01-01T00:00:11.005000Z з заміною типу процедури на необхідний) sellingMetod==bankRuptcy--* (english, dutch, withoutAuction) |
Необроблена деревина | - | CPVS == QB49-3 | Ендпоінт №2 sellingMethod==timber-* (timber-english, timber-multyAwards, timber-english-manual іl всі тестові процедур для пісочниці та стейджингу) |
Оренда вагонів | - | CPVS == MA08-5 | Ендпоінт №2 sellingMethod==railwayCargo-* (railwayCargo-english, railwayCargo-dutch, railwayCargo-english-manual і всі тестові процедур для пісочниці та стейджингу) |
Спеціальні дозволи на користування надрами | - | edrpou == 37536031 | Ендпоінт №2 sellingMethod==subsoil-* (subsoil-english, subsoil-dutch, subsoil-english-manual і всі тестові процедур для пісочниці та стейджингу) |
Оренда землі | - | procurementMethodType==landLease | Ендпоінт №2 sellingMethod==landRental-english |
Продаж землі | - | - | Ендпоінт №2 sellingMethod==landSell-english, sellingMethod==landSell-priorityEnglish |
Комерційни продаж | CPVS = DA04-3 | Ендпоінт №2 sellingMethod==commercialSell-english, sellingMethod==commercialSell-dutch | |
Аукціон із закритими пропозиціями | - | sellingMethod==simpleSell-withoutAuction |
*поки доступно тільки на sandbox оточенні.
Зв’язок у Малій приватизації
Зв’язок між активами, лотами, аукціонами та контрактингом
Приклад стосується ситуації з успішним завершенням приватизації після проведення голландського аукціону після 2х неуспішних англійських аукціонів
# | Об’єкт ЦБД (посилання на api) | Зв’язок з пов’язаними об’єктами ЦБД |
1 |
| |
2 |
| |
3 |
| |
4 |
| |
5 |
| |
6 |
|
Статуси
В усіх джерелах поле status
ЦБД-1 | ЦБД-2 | ЦБД-нова | |
Прийняття заяв на участь | active.tendering | active.tendering | active_tendering |
Період редагування | - | active.rectification | active_rectification |
Аукціон | active.auction | active.auction | active_auction |
Очікується опублікування протоколу | active.qualification | active.qualification | active_qualification |
Очікується підписання договору | active.awarded | active.awarded | active_awarded |
Очікується оплата | pending.payment | pending.payment | pending_payment |
Очікується рішення про викуп | pending.admission | pending.admission | pending_admission |
Аукціон завершено. Договір підписано | complete | complete | complete |
Аукціон відмінено | cancelled | cancelled | cancelled |
Аукціон не відбувся | unsuccessful | unsuccessful | unsuccessful |
Період уточнень | active.enquiry | active.enquiry | active_enquiry |
АРІ-документація
ЦБД-1
http://dgf.api-docs.openprocurement.org/uk/latest/
ЦБД-2
http://dgf.api-docs.ea2.openprocurement.io/en/latest/
http://lease.api-docs.ea2.openprocurement.io/en/latest
http://appraisal-insider.api-docs.ea2.openprocurement.io/en/latest/
ЦБД-2 (оновлена)
№1: https://dgf-procedure-sandbox.prozorro.sale/api/doc
№2: https://procedure-staging.prozorro.sale/api/doc
Технічні завдання
ЦБД-1
https://docs.google.com/document/d/1dKg81cEvc_BZtXg-esvhrLvtKcobpgn1MRLYeNAh0ZA
https://confluence-sale.prozorro.org/pages/viewpage.action?pageId=42730023
ЦБД-2
https://docs.google.com/document/d/1GBfFp6CrXtXgcCUbooiemyx_WcxNhaRraQXpYEYCE68
https://confluence-sale.prozorro.org/pages/viewpage.action?pageId=42729635
ЦБД-нова
https://gitlab.prozorro.sale/public-projects/documentations/-/tree/master/technical_specification
Також зі структурою даних для різних процедур можна знайомитись у Swagger: https://procedure-staging.prozorro.sale/api/doc