Стандарт відкритих даних порталу CoST «Прозора інфраструктура»

Вітаємо на сторінці документації стандарту відкритих даних порталу CoST «Прозора інфраструктура». Модель даних побудована відповідно до Open Contracting for Infrastructure Data Standards з урахуванням розширень порталу.

Висловити зауваження та пропозиції можна за адресою електронної info@costukraine.org пошти або на GitHub Issues.

Зміст

Опис схеми

Схему стандарту можна завантажити у форматі JSON Schema за посиланням або переглянути у форматі таблиць нижче. Непередбачені базовою версією стандарту атрибути мають позначку розширення.

Project

Project — це об’єкт найвищого рівня, що включає дані на рівні проекту та об’єкти нижчого рівня. Для опису предмета проекту додане розширення items (відповідає об’єкту Item в OCDS). Статус виконання графіка проекту зазначається в розширенні scheduleStatus, кошторисна вартість — budget/estimatedAmount.

Title	Description	Type	Format	Required
id		string		Required
Ідентифікатор	Унікальний ідентифікатор інфраструктурного проекту.
updated		string	date-time
Востаннє оновлено	Дата останнього оновлення інформації на рівні проекту.
title		string
Назва	Назва проекту. Джерело даних система Prozorro.
description		string
Опис	Детальний опис проекту, що наданий замовником.
status		string
Статус	Поточна фаза проекту відповідно до довідника ProjectStatus.
scheduleStatus		string
Статус виконання графіка	[Розширення] Поточний статус виконання графіка проекту відповідно до довідника ScheduleStatus.
period		object
Період	Період, протягом якого реалізується проект. See Period
sector		array[string]
Сектор	Один або декілька секторів інфраструктури, в межах яких впроваджується проект. Визначається відповідно до довідника ProjectSector.
purpose		string
Мета	Соціально-економічна мета реалізації проекту.
type		string
Тип	Тип проекту відповідно до довідника ProjectType.
items		array[Предмет угоди або проекту в цілому]
Предмет(-и) проекту	[Розширення] Характеристика предмета або предметів проекту. See Item
locations		array[Розташування]
Розташування	Характеристика розташування об’єкта інфраструктури. See Location
budget		object
Бюджет	Характеристики бюджету проекту.
budget/amount		object
Сума фінансування	Загальна сума фінансування проекту. See Value
budget/approvalDate		string	date-time
Дата затвердження фінансування	Дата ухвалення документа, яким затверджене фінансування проекту.
budget/estimatedAmount		object
Кошторисна вартість	[Розширення] Вартість проекту відповідно до затвердженого кошторису. See Value
budget/budgetBreakdown		array[Структура бюджету]
Структура бюджету	Структура фінансування проекту за основними джерелами. See BudgetBreakdown
documents		array[Документ]
Документи	Документи, що пов’язані з проектом. See Document
contractingProcesses		array[Закупівлі]
Закупівлі	Закупівлі, що пов’язані з проектом. See ContractingProcess
completion		object
Завершення	Остаточні характеристики проекту.
completion/endDate		string	date-time
Дата завершення	Остаточна дата завершення проекту.
completion/finalValue		object
Остаточна вартість	Остаточна вартість проекту. See Value

ContractingProcess

Один інфраструктурний проект може включати декілька закупівель. Об’єкт ContractingProcess включає

1. перелік;
2. істотні подробиці закупівель;
3. історію змін до угод.

Title	Description	Type	Format	Required
id		string		Required
Ідентифікатор	Ідентифікатор закупівлі. Для Prozorro вказується OCID (атрибут ‘tenderID’).
summary		object
Резюме	Основні відомості про закупівлю. See ContractingProcessSummary
releases		array[Реліз]
Пов’язані релізи	Пов’язані релізи, які містять інформацію про зміни в процесі закупівлі. See LinkedRelease

ContractingProcessSummary

Об’єкт ContractingProcessSummary містить подробиці здійснених закупівель та історію змін до угод.

Title	Description	Type	Format	Required
ocid		string
Ідентифікатор (OCID)	OCID закупівлі. У системі Prozorro відповідає атрибуту ‘tenderID’
nature		array[[string]]
Природа угоди	Природа угоди за переважними видами робіт відповідно до довідника ContractNature.
natureType		array[[string]]
Тип угоди	[Розширення] Тип угоди відповідно до довідника ContractNatureType.
scheduleStatus		string
Статус виконання графіка	[Розширення] Поточний статус виконання графіка робіт відповідно до довідника ScheduleStatus.
description		string
Опис	Детальний опис предмета угоди.
status		string
Статус	Статус укладення й реалізації угоди відповідно до довідника ContractingProcessStatus.
items		object
Предмет	[Розширення] Структурований опис предмета угоди. See Item
tender		object
Тендер	Характеристика тендеру.
tender/procurementMethod		string
Procurement method	Метод торгів, що використовується під час закупівлі, відповідно до довідника Method.
tender/procurementMethodDetails		string
Вид закупівлі	Вид закупівлі з системи Prozorro відповідно до довідника MethodDetails.
tender/costEstimate		object
Очікувана вартість	Очікувана вартість закупівлі. See Value
tender/numberOfTenderers		number
Кількість учасників	Кількість учасників тендеру.
tender/bids		array[Цінова пропозиція]
Цінові пропозиції	[Розширення] Дані про цінові пропозиції, що подані учасниками торгів. See Bid
tender/procuringEntity		object
Замовник	[Розширення] Дані про замовника. See Organization
suppliers		array[Організація]
Постачальники	[Розширення] Дані про всіх постачальників, з якими укладені угоди, в рамках даної закупівлі. See Organization
contractValue		object
Вартість угоди.	Початкова вартість угоди. See Value
contractPeriod		object
Термін	Початковий термін дії угоди. See Period
finalValue		object
Остаточна вартість	Остаточна вартість угоди. See Value
warranties		array[Гарантія]
Гарантії	Дані про гарантії на товари, роботи або їх окремі компоненти (властивості). See Warranty
documents		array[Документ]
Документи	Документи, що пов’язані з даною закупівлею. See Document
modifications		array[Зміни]
Зміни	Опис змін умов угоди. See Modification

Структурні блоки

Address

Запис адреси має містити щонайменше одне заповнене поле streetAddress або postalCode.

Title	Description	Type	Format	Required
streetAddress		[string]
Вулиця й номер будинку	Тип, назва вулиці або іншого топоніму, номер будинку. Цей атрибут може включати детальніші складові адреси: корпус, крило, офіс тощо.
locality		[string]
Населений пункт	Назва населеного пункту.
region		[string]
Регіон	Назва регіону.
postalCode		[string]
Індекс	Поштовий індекс.
countryName		[string]
Країна	Назва країни.

Bid

Один тендер може мати декілька цінових пропозицій. Кожна цінова пропозиція представлена об’єктом Bid.

Title	Description	Type	Format	Required
id		[string, integer]		Required
Ідентифікатор	Унікальний ідентифікатор пропозиції.
tenderers		array[Організація]
Учасник(-и)	Учасник(-и), що подали пропозицію. See Organization
value		object
Вартість	Вартість запропонованої пропозиції. See Value

BudgetBreakdown

Структура фінансування описується масивом, що складається з об’єктів BudgetBreakdown. Властивості з базового OC4IDS: uri, period, sourceParty, не використовуються.

Title	Description	Type	Format	Required
id		[string, integer]		Required
Ідентифікатор	Ідентифікатор статті фінансування.
description		[string]
Опис	Назва або опис статті фінансування.
amount		object
Обсяг	Обсяг коштів, що передбачений статтею фінансування. See Value

Classification

Для представлення всіх класифікацій використовується об’єкт Classification.

Title	Description	Type	Format	Required
scheme		[string]
Схема	Код, що використовується для ідентифікації використаного класифікатора.
id		[string, integer]
Ідентифікатор	Код або будь-який інший ідентифікатор класу.
description		[string]
Опис	Назва або текстовий опис класу.

ContactPoint

Контактні дані організацій подаються в об’єкті ContactPoint. У Prozorro обов’язковим є заповнення одного з полів або email, або telephone.

Title	Description	Type	Format	Required
name		[string]
Ім’я або назва	Прізвище, ім’я, по батькові контактної особи, назва підрозділу або приймальні.
email		[string]
Електронна пошта	Адреса електронної пошти.
telephone		[string]
Телефон	Номер телефону, включаючи код країни й населеного пункту.
faxNumber		[string]
Факс	Номер телефону, включаючи код країни й населеного пункту.
url		[string]	uri
URL	Веб-адреса.

Dates

Для зазначення дат використовується стандарт ISO 8601 включно з часовою зоною, наприклад:

2019-07-25T12:30:00+03:00

Document

Для представлення метаданих документів використовується об’єкт Document. Базовий стандарт розширено властивістю number. Вона містить дані про номер документа, що присвоюється видавником.

Title	Description	Type	Format	Required
id		[string, integer]		Required
Ідентифікатор	Локальний унікальний ідентифікатор документа.
documentType		[string]
Тип	Тип документа відповідно до довідника DocumentType.
title		[string]
Назва	Назва документа.
number		[string]
Номер	[Розширення] Номер документа, що присвоєний його видавником.
url		[string]	uri
URL	Посилання на документ або веб-сторінку, що містить інформацію документа.
datePublished		[string]	date-time
Оприлюднено	Дата оприлюднення документа.
dateModified		[string]	date-time
Востаннє змінено	Дата внесення змін в документ.
format		[string]
Формат	Формат документа відповідно до переліку кодів IANA Media Types (http://www.iana.org/assignments/media-types/). Код ‘offline/print’ використовується для друкованих документів, ‘text/html’ — для посилань на веб-сторінку, що містить інформацію документа
language		[string]
Мова	Літерний код мови документа відповідно до в ISO 639-1 (https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) або розширені мовні теги BCP47 (http://www.w3.org/International/articles/language-tags/).

Item

Об’єкт Item використовується як розширення для представлення предмета(-ів) угоди (об’єкт ContractingProcessSummary) або проекту в цілому (об’єкт Project).

1. Угоди. Наразі portal.costukraine.org публікує лише інформацію про класифікацію предмета за CPV (атрибут classification).
2. Проекти. Як основна класифікація використовується класифікація за об’єктом робіт (атрибут classification), а одиниця вимірювання — площа ремонту (атрибути quantity і unit).

Title	Description	Type	Format	Required
id		[string, integer]		Required
Ідентифікатор	Локальний унікальний ідентифікатор предмета.
classification		object
Класифікація	Основна класифікація предмета. See Classification
additionalClassifications		array[Класифікація]
Додаткові класифікації	Додаткові класифікації предмета. See Classification
quantity		[number, null]
Кількість	Кількість одиниць, у яких вимірюється предмет.
unit		object
Одиниця вимірювання	Одиниця вимірювання предмета.
unit/scheme		[string, null]
Схема	Код або будь-який інший ідентифікатор переліку одиниць вимірювання. Портал «Прозора інфраструктура» використовує одиниці вимірювання UN/CEFACT.
unit/id		[string, null]
Ідентифікатор	Ідентифікатор одиниці виміру відповідно до довідника UnitCodes.
unit/name		[string, null]
Назва	Назва одиниці виміру відповідно до довідника UnitCodes.

Location

Проект може мати одне або більше розташувань, які зазначаються в одному масиві. Об’єкт Location описує розташування у декілька способів:

• просторові дані в форматі JSON;
• газетир;
• адреса.

У якості газетира для автомобільних шляхів використовується Перелік автомобільних доріг загального користування затверджений Постановою Кабінету Міністрів України від № 55 30.01.2019. В об’єкт Location додані розширення порталу: pikets (пікетна прив’язка), length (довжина відрізка шляху).

Title	Description	Type	Format	Required
id		string		Required
Ідентифікатор	Локальний унікальний ідентифікатор розташування.
geometry		[object]
Геометрія	Просторові дані у стандарті GeoJSON (https://geojson.org/).
geometry/type		[string]
Тип	Тип геометричних об’єктів відповідно до довідника GeometryType
geometry/coordinates		array[[number, array]]
Координати	Масив або вкладений масив географічних координат, що описують геометричні об’єкти
gazetteer		[object]
Газетир	Опис розташування за допомогою газетира.
gazetteer/scheme		[string]
Схема	Код або будь-який інший ідентифікатор використаного газетира.
gazetteer/identifiers		array[[string]]
Ідентифікатор(-и)	Один або більше кодів з визначеного газетира. У випадку автомобільних шляхів, зазначаються індекси.
length		[object]
Довжина	[Розширення] Довжина відрізка автомобільного шляху.
length/quantity		[number, null]
Кількість	Кількість одиниць, у яких вимірюється довжина відрізка.
length/unit		object
Одиниця вимірювання	Одиниця вимірювання.
length/unit/scheme		[string, null]
Схема	Код або будь-який інший ідентифікатор переліку одиниць вимірювання. Портал «Прозора інфраструктура» використовує одиниці вимірювання UN/CEFACT.
length/unit/id		[string, null]
Ідентифікатор	Ідентифікатор одиниці виміру відповідно до довідника UnitCodes.
length/unit/name		[string, null]
Назва	Назва одиниці виміру відповідно до довідника UnitCodes.
pikets		array[[object]]
Пікети	[Розширення] Пікети, які обмежують відрізок(-ки) робіт.
pikets/0/startPiket		[integer, null]
Початковий пікет	Відстань початкового пікету в метрах.
pikets/0/endPiket		[integer, null]
Кінцевий пікет	Відстань кінцевого пікету в метрах.
address		object
Адреса	Адреса, за якою відбуваються роботи. See Address

Modification

Modification — об’єкт, що містить структурований опис змін умов угоди. Стандарт даних передбачає лише фіксацію змін вартості й строків виконання угоди. Властивості з базового OC4IDS: description і rationale, не використовуються.

Title	Description	Type	Format	Required
id		[string, integer]		Required
Ідентифікатор	Локальний унікальний ідентифікатор змін.
date		[string]	date-time
Дата	Дата внесення змін.
contractNumber		[string]
Номер угоди	[Розширення] Номер додаткової угоди, відповідно до якої вносяться зміни.
type		[string]
Тип	Тип змін відповідно до довідника ModificationType.
oldContractValue		object
Стара вартість угоди	Вартість угоди до внесення даних змін, враховуючи попередні зміни. See Value
newContractValue		object
Нова вартість угоди	Вартість угоди після внесення змін. See Value
oldContractPeriod		object
Старий термін дії угоди	Термін дії угоди до внесення даних змін, враховуючи попередні зміни. See Period
newContractPeriod		object
Новий термін дії угоди	Термін дії угоди після внесення змін. See Period

Organization

Organization — об’єкт, що використовується для представлення даних про організації (у тому числі, юридичних осіб і фізичних осіб-підприємців). Стандарт даних portal.costukraine.org, як і Prozorro, використовує модифікацію OCDS. Властивості id, roles та additionalIdentifiers не використовуються. Об’єкт OrganizationReference виключений з моделі даних.

Title	Description	Type	Format	Required
name		[string]
Назва	Назва організації.
identifier		object
Ідентифікатор	Дані про ідентифікатор організації. See Identifier
identifier/scheme		[string]
Схема	Код чинної схеми ідентифікації організацій відповідно до довідника OrganizationIdentifierScheme.
identifier/id		[string, integer]
Ідентифікатор	Ідентифікатор організації у визначеній схемі ідентифікації організації.
address		object
Адреса	Адреса реєстрації організації або контактна поштова адреса. See Address
contactPoint		object
Контактні дані	Контактні дані організації. See ContactPoint

Period

Period — об’єкт, що використовується для позначення відрізків часу. Стандарт даних portal.costukraine.org не використовує властивість ‘maxExtentDate’ (як і Prozorro). Властивість ‘durationInDays’ використовується для представлення гарантійних термінів, коли дати початку та кінця гарантії невказані. Всі дати подаються відповідно до стандарту ISO 8601.

Title	Description	Type	Format	Required
startDate		[string]	date-time
Початок	Дата початку періоду.
endDate		[string]	date-time
Завершення	Дата завершення періоду.
durationInDays		[integer]
Тривалість (днів)	Тривалість періоду у днях.

LinkedRelease

Метадані OCDS релізів представлені об’єктом LinkedRelease. Властивість tag не використовується в стандарті, оскільки дані з системи Prozorro оприлюднюються одним релізом.

Title	Description	Type	Format	Required
id		string		Required
Ідентифікатор	Унікальний ідентифікатор релізу. У Prozorro відповідає атрибуту ‘id’, об’єкта ‘Tender’.
date		string	date-time	Required
Дата	Дата релізу. У Prozorro відповідає атрибуту ‘date’, об’єкта ‘Tender’.
url		string	uri	Required
URL	Посилання на реліз.

Value

Для зазначення всіх вартостей використовується об’єкт Value.

Title	Description	Type	Format	Required
amount		[number]
Обсяг	Обсяг як число.
currency		[string]
Валюта	Код валюти, у якій виражений обсяг, відповідно до ISO4217.

Warranty

Товари, роботи, їх окремі компоненти (властивості) можуть мати кілька гарантійних термінів. Кожна гарантія представляється об’єктом Warranty. Термін гарантії окреслюється датою початку та завершення. Якщо дати невідомі, то вказується загальна тривалість терміну у днях.

Title	Description	Type	Format	Required
id		[string, integer]
Ідентифікатор	Локальний унікальний ідентифікатор гарантії.
description		[string]
Опис	Назва або опис товару, роботи або їх окремих компонентів (властивостей), на які поширюється гарантія.
period		object
Період	Період, на який поширюється гарантія для даного предмета. See Period
period/startDate		[string]	date-time
Початок	Дата початку періоду.
period/endDate		[string]	date-time
Завершення	Дата завершення періоду.
period/durationInDays		[integer]
Тривалість (днів)	Тривалість періоду у днях.

Довідники

Цей розділ містить інформацію про довідники (codelists), які використані в стандарті даних. Непередбачені базовою версією стандарту довідники мають позначку розширення.

Дізнатися більше

Більше інформації про довідники в Open Contracting for Infrastructure Data Standards можна отримати за посиланням.

ContractingProcessStatus

Статус укладення й реалізації угоди.

Code	Title
pre-award	До укладення угоди
active	Активний
closed	Закритий

ContractNature

Природа угоди за переважаючими видами робіт.

Code	Title
design	Проектування
construction	Будівництво
supervision	Нагляд

ContractNatureType [розширення]

Тип угоди за її предметом.

Code	Title
constructionContractor	Будівництво, підрядник
constructionSubcontractor	Будівництво, субпідрядник
consultantEngineer	Інженер-консультант
design	Проектування
technicalSupervision	Технічний нагляд

DocumentType

Типи документів.

Code	Title	Source
contractSigned	Підписаний договір	OCDS for PPPs
subContract	Договір підряду	OCDS
environmentalImpact	Оцінка впливу на довкілля	OC4IDS
awardNotice	Повідомлення про рішення	OCDS
completionCertificate	Експертний висновок	OCDS
initializationDecision	Рішення уповноваженого органу про початок проекту	portal.costukraine.org
completionDeclaration	Декларація про готовність об’єкта до експлуатації	portal.costukraine.org
acceptanceDeliveryCertificate	Акт приймання-передачі	portal.costukraine.org
qualityMoniringDecision	Наказ з моніторингу якості	portal.costukraine.org
qualityMoniringProtocol	Протокол моніторингу якості	portal.costukraine.org
completionReport	Звіт про виконання договору.	portal.costukraine.org
bidders	Документи, що містять інформацію про учасників. Наприклад, сертифікат інженера з технічного нагляду.	OCDS
budgetApproval	Затвердження фінансування	OC4IDS

GeometryType

Тип геометрії в GeoJSON.

Code	Title	Extension
Point	Точка	Location
MultiPoint	Мультиточка	Location
LineString	Лінія	Location
MultiLineString	Мультилінія	Location
Polygon	Полігон	Location
MultiPolygon	Мультиполігон	Location

Method

Метод торгів, що використовується під час закупівлі.

Code	Title	Extension
open	Відкриті	OCDS Core
selective	Вибіркові	OCDS Core
limited	Обмежені	OCDS Core
direct	Прямі	OCDS Core

MethodDetails [розширення]

Вид закупівлі з Єдиної системи електронних закупівель (prozorro.gov.ua). Довідник Prozorro у форматі JSON можна завантажити за посиланням.

Code	Title
belowThreshold	Допорогові закупівлі
aboveThresholdUA	Відкриті торги
aboveThresholdEU	Відкриті торги з публікацією англійською мовою
negotiation	Переговорна процедура
negotiation.quick	Переговорна процедура (скорочена)
aboveThresholdUA.defense	Переговорна процедура для потреб оборони
competitiveDialogueUA	Конкурентний діалог 1-ий етап
competitiveDialogueEU	Конкурентний діалог з публікацією англійською мовою 1-ий етап
competitiveDialogueUA.stage2	Конкурентний діалог 2-ий етап
competitiveDialogueEU.stage2	Конкурентний діалог з публікацією англійською мовою 2-ий етап
reporting	Звіт про укладений договір
esco	Відкриті торги для закупівлі енергосервісу
closeFrameworkAgreementUA	Укладання рамкової угоди
closeFrameworkAgreementSelectionUA	Відбір для закупівлі за рамковою угодою

ModificationType

Тип змін до угод.

Code	Title
duration	Тривалість
value	Вартість
scope	Предмет

ProjectSector

Сектор інфрфструктури, якому реалізується проект.

Code	Title
education	Освіта
health	Охорона здоров’я
energy	Енергетика
communications	Комунікації
waterAndWaste	Водовідведення і тверді побутові відходи
governance	Урядування
economy	Економіка
cultureSportsAndRecreation	Культура, спорт і рекреація
transport	Транспорт
transport.air	Повітряний транспорт
transport.water	Водний транспорт
transport.rail	Залізниця
transport.road	Автомобільні шляхи
transport.urban	Міський транспорт
socialHousing	Соціальне житло

ProjectStatus

Статус реалізації проекту.

Code	Title
identification	Ідентифікація
preparation	Підготовка
implementation	Впровадження
completion	Завершення
completed	Завершений
cancelled	Скасований

ProjectType

Тип проекту за переважаючими видами робіт.

Code	Title
construction	Будівництво
rehabilitation	Реконструкція
replacement	Заміна

ScheduleStatus [розширення]

Статус виконання графіка проекта.

Code	Title
lagsBehindSchedule	Відстає від графіка
timely	Згідно з графіком
aheadOfSchedule	Випереджає графік

Інші довідники

Currency

Коди валют відповідно до ISO 4217:2010 у форматі CSV (Джерело: Open Contracting for Infrastructure Data Standards), й у форматі JSON (Джерело: Державна служба статистики України).

UnitCodes

Одиниці виміру UN/CEFACT, що є рекомендованими й використовуються в Prozorro, у форматі JSON (Джерело: Довідники системи Prozorro).

OrganizationIdentifierScheme

Схеми ідентифікації організацій відповідно до org-id.guide у форматі CSV, JSON (Джерело: org-id.guide) й у форматі JSON (Джерело: Довідники системи Prozorro).

Історія змін

Історія зімн до стандарту даних.

v. 1.0.

Дата: 2019-00-00
Опис: Випуск версії 1.0.