Опис схеми¶
Схему стандарту можна завантажити у форматі 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[Закупівлі] | |||
Закупівлі | Закупівлі, що пов’язані з проектом. |
|||
completion |
object | |||
Завершення | Остаточні характеристики проекту. | |||
completion/endDate |
string | date-time | ||
Дата завершення | Остаточна дата завершення проекту. | |||
completion/finalValue |
object | |||
Остаточна вартість | Остаточна вартість проекту. See Value |
ContractingProcess¶
Один інфраструктурний проект може включати декілька закупівель. Об’єкт ContractingProcess
включає
- перелік;
- істотні подробиці закупівель;
- історію змін до угод.
Title | Description | Type | Format | Required |
---|---|---|---|---|
id |
string | Required | ||
Ідентифікатор | Ідентифікатор закупівлі. Для Prozorro вказується OCID (атрибут ‘tenderID’). | |||
summary |
object | |||
Резюме | Основні відомості про закупівлю. |
|||
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
).
- Угоди. Наразі portal.costukraine.org публікує лише інформацію про класифікацію предмета за CPV (атрибут
classification
). - Проекти. Як основна класифікація використовується класифікація за об’єктом робіт (атрибут
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] | |||
Тривалість (днів) | Тривалість періоду у днях. |