Перелік укладених договорів (укладені договори, інші правочини, додатки, додаткові угоди та інші матеріали до них)
1. Коротка довідка
| Критерій | Характеристика |
| Нормативно-правові акти, які визначають створення, збір, зберігання, використання й поширення даних | Закон України «Про відкритість використання публічних коштів» від 11.02.2015 № 183-VIII, Закон України «Про публічні закупівлі» від 25.12.2015 № 922-VIII, Закон України «Про оренду державного та комунального майна» від 10.04.1992 № 2269-XII, Земельний кодекс України та інші нормативно-правові акти. |
| Інформація, що створюється, збирається, зберігається й поширюється | Органи місцевого самоврядування здійснюють облік та оприлюднення договорів відповідно до профільного законодавства: Закону України «Про відкритість використання публічних коштів», Закону України «Про публічні закупівлі» та інших нормативно-правових актів. |
| Способи оновлення | Укладення, внесення змін, скасування договорів, укладення додаткових угод та інших правочинів, складення актів тощо. |
| Частота оновлення інформації | Позапланово (протягом трьох робочих днів з моменту внесення змін) |
| Тип даних | Структуровані |
| Формати файлів | XLSX, ODS, CSV, JSON можливі інші формати структурованих даних |
2. Огляд нормативно-правової бази
Облік та оприлюднення даних про договори відбувається відповідно до положень профільного законодавства, зокрема, Закону України «Про відкритість використання публічних коштів», Закону України «Про публічні закупівлі», Закону України «Про оренду державного та комунального майна», Земельного кодексу України, Закон України «Про рекламу» від 03.07.1996 № 270/96-ВР та інших нормативно-правових актів.
3. Підготовка даних та структура набору
3.1. Дані про договори щодо використання публічних коштів
Більшість договорів органів місцевого самоврядування стосуються використання публічних коштів і підлягають оприлюдненню на Єдиному веб-порталі використання публічних коштів (Spending.gov.ua) та в Єдиній системі електронних публічних закупівель ПроЗорро (Prozorro.gov.ua). Тому дублювати ці дані в окремому переліку недоцільно. Натомість набагато ефективніше оприлюднити їх через API (інтерфейс прикладного програмування) Spending.gov.ua у форматі JSON. Для цього необхідно сформувати посилання (кінцеву точку), за яким користувачі зможуть отримати дані певного розпорядника з бази даних порталу. Наприклад, для отримання переліку договорів посилання матиме вигляд:
http://api.spending.gov.ua/api/v2/disposers/contracts?disposerId=ЄДРПОУ Розпорядника
Останню частину (ЄДРПОУ Розпорядника) необхідно замінити на 8 чисел коду ЄДРПОУ розпорядника бюджетних коштів. Наприклад, у випадку Дніпровської міської ради (код ЄДРПОУ — 26510514) посилання буде наступним:
http://api.spending.gov.ua/api/v2/disposers/contracts?disposerId=26510514
Якщо скопіювати його в адресний рядок веб-переглядача (Google Chrome або Mozilla Firefox) і натиснути перейти, то можна отримати дані у форматі JSON. Перше число "size":471 вказує на загальну кількість доступних документів.
Рисунок 1 — Приклад даних spending.gov.ua у форматі JSON
Для отримання різних типів документів у Spending.gov.ua використовуються різні кінцеві точки (див. Таблицю 1).
Таблиця 1 — Посилання (кінцеві точки) для отримання даних
| Назва | Шаблон посилання (кінцевої точки) | Приклад посилання (кінцевої точки) |
| Перелік договорів | http://api.spending.gov.ua/api/v2/disposers/contracts?disposerId=ЄДРПОУ |
http://api.spending.gov.ua/api/v2/disposers/contracts?disposerId=04051327 |
| Перелік додаткових угод | http://api.spending.gov.ua/api/v2/disposers/addendums?disposerId=ЄДРПОУ |
http://api.spending.gov.ua/api/v2/disposers/addendums?disposerId=04051327 |
| Перелік актів/накладних до договорів | http://api.spending.gov.ua/api/v2/disposers/acts?disposerId=ЄДРПОУ |
http://api.spending.gov.ua/api/v2/disposers/acts?disposerId=04051327 |
| Перелік штрафів до договорів | http://api.spending.gov.ua/api/v2/disposers/peny?disposerId=ЄДРПОУ |
http://api.spending.gov.ua/api/v2/disposers/peny?disposerId=04051327 |
3.2. Дані про інші договори
У випадку оприлюднення даних про інші типи договорів, наприклад, розміщення тимчасових споруд, рекламних засобів тощо рекомендовано використовувати структури наступних ресурсів
- Contracts — перелік договорів;
- AdditionalDocuments — перелік додаткових угод та інших документів.
3.2.1. Перелік договорів (ресурс Contracts)
| Назва ресурсу | Contracts |
| Що є одним записом в таблиці (рядком) | Один договір |
| Спосіб оновлення | Розміщення нової версії ресурсу, можливе створення нового ресурсу щомісяця, щокварталу, щороку |
| Шаблон таблиці | Contracts.xlsx |
| Приклад таблиці | Example.xlsx |
| Структура (XLSX, CSV, JSON) | Structure.xlsx, Structure.csv, Structure.json |
Зверніть увагу! Набір необхідно готувати й вести в електронних таблицях Microsoft Excel, LibreOffice Calc або Google Таблицях. Для оприлюднення набору використовуються формати XLSX, ODS, CSV. На портал достатньо завантажити XLSX або ODS книгу, що містить один аркуш. За таких умов ресурс потрапить у базу даних порталу (сховище даних) і його CSV-версія згенерується автоматично. Також дані будуть доступними в форматі JSON через API порталу.
Таблиця 1 — Структура таблиці (ресурсу) Contracts
| Назва колонки (name) | Заголовок колонки (title) | Опис значень (description) | Тип даних (datatype) | Вимога заповнення (required) |
| id | Ідентифікатор | Унікальним ідентифікатором договору є рік його підписання та номер, що розділені знаком дефіс. Наприклад: 2018-345/п. Розпорядники можуть використовувати власні ідентифікатори. | Текст (string) | Істина (true) |
| number | Номер договору | Номер договору (без знаку «№»). Наприклад: 345/п. | Текст (string) | Істина (true) |
| dateSigned | Дата підписання | Дата підписання договору у форматі ISO 8601 (рррр-мм-дд). Наприклад: 2019-05-30. | Дата (date) | Істина (true) |
| supplierName | Ім'я або назва контрагента | Назва юридичної особи контрагента або прізвище, ім’я, по батькові ФОП. Наприклад: ТОВ «Реклама-плюс». | Текст (string) | Істина (true) |
| supplierID | Ідентифікатор контрагента | Код ЄДРПОУ юридичної особи контрагента. У випадку ФОП дані про РНОКПП знеособлюються. Наприклад: 01234567. | Текст (string) | Істина (true) |
| disposerName | Назва органу | Назва розпорядника, який є стороною договору. Наприклад: Виконавчий комітет Вінницької міської ради. | Текст (string) | Істина (true) |
| disposerID | Ідентифікатор органу | Код ЄДРПОУ розпорядника, який є стороною договору. Наприклад: 01234567. | Текст (string) | Істина (true) |
| description | Опис | Опис предмета договору. Наприклад: Розміщення рекламних засобів за адресою вул. Марка Кропивницького 19. | Текст (string) | Істина (true) |
| periodStartDate | Початок дії | Дата початку дії договору у форматі ISO 8601 (рррр-мм-дд). Наприклад: 2018-07-06. | Дата (date) | Істина (true) |
| periodEndDate | Завершення дії | Дата завершення дії договору у форматі ISO 8601 (рррр-мм-дд). Наприклад: 2018-09-06. | Дата (date) | Істина (true) |
| valueAmount | Сума договору | Загальна сума договору. Число вказується без зазначення валюти («грн», «UAH»). Наприклад: 3000. Десяткові значення відділяються крапкою або комою. Потрібно дотримуватися одного розділювача для всієї таблиці. | Десятковий дріб (decimal) | Істина (true) |
| valueCurrency | Валюта | Буквений код валюти, в якій виражена сума, відповідно до ДСТУ ISO 4217 (https://zakon.rada.gov.ua/rada/show/v0416832-14/conv). Наприклад: UAH. | Текст (string) | Істина (true) |
| status | Статус договору | Статус договору може мати одне зі значень: Чинний, Виконаний, Розірваний, Скасований. Наприклад: Чинний. | Текст (string) | Істина (true) |
| url | Посилання | Посилання на перегляд або завантаження договору включно з усіма додатками. Посилання має починатися з http:// або https://. Наприклад: https://www.example.gov.ua/contract-345.doc. | Посилання (anyURI) | Істина (true) |
3.2.2. Перелік додаткових угод та інших документів (ресурс AdditionalDocuments)
| Назва ресурсу | AdditionalDocuments |
| Що є одним записом в таблиці (рядком) | Один документ |
| Спосіб оновлення | Розміщення нової версії ресурсу, можливе створення нового ресурсу щомісяця, щокварталу, щороку |
| Шаблон таблиці | AdditionalDocuments.xlsx |
| Приклад таблиці | Example.xlsx |
| Структура (XLSX, CSV, JSON) | Structure.xlsx, Structure.csv, Structure.json |
Таблиця 2 — Структура таблиці (ресурсу) AdditionalDocuments
| Назва колонки (name) | Заголовок колонки (title) | Опис значень (description) | Тип даних (datatype) | Вимога заповнення (required) |
| id | Ідентифікатор документа | Унікальним ідентифікатором документа є ідентифікатор основної угоди з таблиці Contracts (колонка id) та номер документа, що розділені знаком дефіс. Наприклад: 2018-345/п-1. Розпорядники можуть використовувати власні ідентифікатори. | Текст (string) | Істина (true) |
| contractID | Ідентифікатор основного договору | Ідентифікатор основної угоди з таблиці Contracts (колонка id). Наприклад: 2018-345/п. | Текст (string) | Істина (true) |
| number | Номер | Номер документа (без знаку «№»). Наприклад: 1. | Текст (string) | Істина (true) |
| dateSigned | Дата підписання | Дата підписання документа у форматі ISO 8601 (рррр-мм-дд). Наприклад: 2014-05-30. | Дата (date) | Істина (true) |
| type | Тип | Тип документа: Акт, Додаткова угода, Протокол, тощо. Наприклад: Додаткова угода. | Текст (string) | Істина (true) |
| title | Назва | Повна назва документа. Наприклад: Додаткова угода №1 до Договору №345/п. | Текст (string) | Істина (true) |
| description | Опис | Короткий опис змісту документа. Наприклад: Додатковою угодою продовжений строк дії Договору до 31 грудня 2019 року, але в будь-якому разі до повного виконання сторонами своїх зобов’язань. | Текст (string) | Істина (true) |
| url | Посилання | Посилання на перегляд або завантаження документа. Посилання має починатися з http:// або https://. Наприклад: https://www.example.gov.ua/contract-345.doc. | Посилання (anyURI) | Істина (true) |
3.3. Публікація текстів договорів на порталі
Оскільки тексти договорів не є машиночитаними, їх рекомендовано розміщувати в одному архіві даних (ресурсі) на порталах. Не допускається публікація текстів у форматі сканованих зображень (TIFF, JPEG, PNG тощо) або PDF-документів. Для архівів даних рекомендовано використовувати формати ZIP, 7z.
4. Оформлення паспортів наборів та ресурсів
Зверніть увагу! Назва набору має відповідати Переліку, затвердженому Постановою КМУ № 835 (зі змінами). Також вона може включати назву розпорядника або населеного пункту, з яким пов'язані дані. Це полегшує пошук набору в пошукових системах.
Таблиця 3 — Приклад паспорта набору даних на data.gov.ua
| Назва поля | Приклад заповнення |
| Назва набору | Перелік укладених договорів Виконавчого комітету Луцької міської ради |
| Відомості про мову інформації, яка міститься у наборі | Українська |
| Частота оновлення | Один раз на квартал |
| Опис | Набір містить перелік укладених договорів, укладені договори, інші правочини, додатки, додаткові угоди та інші матеріали до них. Ресурси Contracts, Addendums, Acts, Peny містять інформацію з Єдиного веб-порталу використання публічних фінансів (spending.gov.ua). Тексти угод розмішені в ресурсі Texts. |
| Підстава та призначення збору інформації | Закон України «Про відкритість використання публічних коштів» від 11.02.2015 № 183-VIII, Закон України «Про публічні закупівлі» від 25.12.2015 № 922-VIII |
| Ключові слова | договір, угода, акт, штраф, пеня, додаткова угода, додаток, товари, послуги |
| Відповідальна особа | Симоненко Олена Петрівна |
| Адреса електронної пошти відповідальної особи | o.symonenko@example.gov.ua |
Таблиця 4 — Приклад додавання ресурсу Contracts
| Назва поля | Приклад заповнення |
| Посилання | http://api.spending.gov.ua/api/v2/disposers/contracts?disposerId=04051327 |
| Назва ресурсу | Contracts |
| Опис | Перелік договорів оприлюднених на Єдиному веб-порталі використання публічних фінансів (spending.gov.ua). Довідка щодо використання API spending.gov.ua доступна за посиланням — https://confluence.spending.gov.ua/. |
| Формат | API |
Таблиця 5 — Приклад додавання ресурсу Addendums
| Назва поля | Приклад заповнення |
| Посилання | http://api.spending.gov.ua/api/v2/disposers/addendums?disposerId=04051327 |
| Назва ресурсу | Addendums |
| Опис | Перелік додаткових угод оприлюднених на Єдиному веб-порталі використання публічних фінансів (spending.gov.ua). Довідка щодо використання API spending.gov.ua доступна за посиланням — https://confluence.spending.gov.ua/. |
| Формат | API |
Таблиця 6 — Приклад додавання ресурсу Acts
| Назва поля | Приклад заповнення |
| Посилання | http://api.spending.gov.ua/api/v2/disposers/acts?disposerId=04051327 |
| Назва ресурсу | Acts |
| Опис | Перелік актів до договорів оприлюднених на Єдиному веб-порталі використання публічних фінансів (spending.gov.ua). Довідка щодо використання API spending.gov.ua доступна за посиланням — https://confluence.spending.gov.ua/. |
| Формат | API |
Таблиця 7 — Приклад додавання ресурсу Peny
| Назва поля | Приклад заповнення |
| Посилання | http://api.spending.gov.ua/api/v2/disposers/peny?disposerId=04051327 |
| Назва ресурсу | Peny |
| Опис | Перелік штрафів до договорів оприлюднених на Єдиному веб-порталі використання публічних фінансів (spending.gov.ua). Довідка щодо використання API spending.gov.ua доступна за посиланням — https://confluence.spending.gov.ua/. |
| Формат | API |
Таблиця 8 — Приклад паспорта ресурсу Contracts
| Назва поля | Приклад заповнення |
| Назва ресурсу | Contracts.xlsx |
| Опис | Таблиця містить дані про договори, зокрема, номер, дату підписання, найменування та ідентифікатори сторін, опис умов, строки реалізації, посилання на копію, що оприлюднена в мережі Інтернет. Кожним записом до таблиці є один договір. |
| Формат | XLSX |
Таблиця 9 — Приклад паспорта ресурсу AdditionalDocuments
| Назва поля | Приклад заповнення |
| Назва ресурсу | AdditionalDocuments.xlsx |
| Опис | Таблиця містить перелік додаткових угод та інших документів (протоколів, актів тощо). Зокрема, реквізити основного договору, номер документа, дату підписання, тип, назву, опис, посилання на копію, що оприлюднена в мережі Інтернет. Кожним записом до таблиці є одна додаткова угода або інший документ. |
| Формат | XLSX |
Таблиця 10 — Приклад додавання ресурсу Texts
| Назва поля | Приклад заповнення |
| Назва ресурсу | Texts.zip |
| Опис | Архів даних текстів договорів, інших правочинів, додатків, додаткових угод та інших матеріалів до них. |
| Формат | ZIP |