Про дані 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:

  1. Робимо запит по відповідному ендпоінту
  2. У відповідь отримуємо:
    1. перелік зі 100 ID процедур
    2. посилання на сторінку з наступними 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)

Напрями роботи і параметри процедур


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

ЦБД-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, які відносяться до оренди державного майна)

Ендпоінт №2

sellingMetod==regulationsPropertyLease-* (english, dutch)

Продаж активів банків-банкрутів (ФГВФО)

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


Комерційна оренда


CPVS = DA04-3 &  CPVS = PA01-7

Ендпоінт №2

sellingMethod==commercialPropertyLease-* (english, dutch)


Аукціон із закритими пропозиціями


-

sellingMethod==simpleSell-withoutAuction

*поки доступно тільки на sandbox оточенні. 

Зв’язок у Малій приватизації

Зв’язок між активами, лотами, аукціонами та контрактингом

Приклад стосується ситуації з успішним завершенням приватизації після проведення голландського аукціону після 2х неуспішних англійських аукціонів

#

Об’єкт ЦБД (посилання на api)

Зв’язок з пов’язаними об’єктами ЦБД

1

Об’єкт малої приватизації (реєстр активів)

    1. Лот
  1. "relatedProcesses":"relatedProcessID": "7383baad5a17417292e4e6a59b44bf8d"
  2. "relatedProcesses":"identifier": "UA-LR-SSP-2018-11-07-000018-3"
  3. "relatedProcesses":"type": "lot"

2

Інформаційне повідомлення (лот)

    1. Актив
  1. "relatedProcesses":"identifier": "UA-AR-P-2018-07-26-000120-1"
  2. "relatedProcesses":"relatedProcessID": "d2d3a81e8ddc4ed6b710615065c44546"
    1. Аукціон: "auctions"
      1. англійський
  1. "auctionID": "UA-PS-2018-11-09-000030-1"
  2. "relatedProcessID": "3fb30cecc01c4375a381272d54703c43"
  3. "tenderAttempts": 1
  4. "procurementMethodType": "sellout.english"
      1. англійський -50%
  1. "auctionID": "UA-PS-2018-12-11-000013-1"
  2. "relatedProcessID": "32dd3bf325974bd3a78591b5770f0fa4"
  3. "tenderAttempts": 2
  4. "procurementMethodType": "sellout.english"
      1. голл
  1. "auctionID": "UA-PS-2019-01-14-000039-2"
  2. "relatedProcessID": "ceaf2b7e000a4f3a8d13e8a641f59b5b"
  3. "tenderAttempts": 3
  4. "procurementMethodType": "sellout.insider"
    1. Контракт
  1. "contracts":"relatedProcessID": "d00151aeaf99432197f589cf3cbf97a3"
  2. "contracts":"contractID": "UA-PS-2019-01-14-000039-2-21"

3

Англійський аукціон

  1. Лот: "merchandisingObject": "7383baad5a17417292e4e6a59b44bf8d"

4

Англійський аукціон -50%

  1. Лот: "merchandisingObject": "7383baad5a17417292e4e6a59b44bf8d"

5

Голландський аукціон

  1. Лот: "merchandisingObject": "7383baad5a17417292e4e6a59b44bf8d"
  2. Контракт: "contracts":"contractID": "UA-PS-2019-01-14-000039-2-21"

6

Об’єкт “контракт” у модулі контрактингу

  1. Лот: "merchandisingObject": "7383baad5a17417292e4e6a59b44bf8d"
  2. Аукціон, на основі якого сформовано контракт: "relatedProcessID": "ceaf2b7e000a4f3a8d13e8a641f59b5b"


Статуси

В усіх джерелах поле 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


Анонімізація даних на час військового стану

На час військового стану запроваджена можливість анонімізувати дані у публічно доступних ендпоїнтах. Передбачено два рівні анонімізації: часткова (medium) та повна (hight). Ідентифікувати сутності ЦБД для яких застосована анонімізація можна по  значенню параметру _protected=true. За рівень анонімізації відповідає _protect_level. Повний доступ зберігається у організатора процедури та учасників процедури

Часткова анонімізація передбачає приховання всієї інформації про учасиків процедури та протоколу процедури. Приклад процедури з частковою анонімізацією: https://procedure.prozorro.sale/api/procedures/62ea4c490174727332f8b0d1

Повна анонімізація, додатково до інформації що прихована у сежах часткової анонімізації, приховує дані про організатора та інформацію про об'єкт. Приклад об'єкту переліку оренди: https://procedure.prozorro.sale/api/registry/objects/5f9fb808aa56594a84909f65

Після завершення військового стану всі анонімізовані дані стануть загальнодоступними.

АРІ-документація

ЦБД-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



  • No labels