Документи та посилання на ресурси: 

Мирорр клієнт https://gitlab.prozorro.sale/public-projects/mirror-clients

...

В: Невеликий документ, який може додати ясності в логіці роботи з реєстрами: Переліки (реєстр) оренди, поступово вын буде доповнюватися.

Невеликий документ по роботі з реєстрами: Переліки (реєстр) оренди

Документація по перелікам

Пошук у переліках на пісочниці

Помилки,взаємодії  з АРІ та ЦБД: 

ЦБД П: В якому форматі майданчики мають передавати auctionPeriod startDate, виходячи з того, що при публікаціїї до ЦБД startDate на три години менший від datePublished?

...

В: Так, такий порядок дій є вірним, додатково про ЕЦП можна подивитися за посиланням https://confluence-sale.prozorro.org/display/PUB/CDB-3+FAQ 

Процедури:

Procedure GE П: Чи має бути у Гарантованого покупця можливість завантажувати документ з типом clarifications на єтапі редагування аукціону?

...

з тегом classifiers - https://procedure-sandbox.prozorro.sale/api/doc#/classifiers — відображає список всіх класифікаторів, що є в системі
по ендпоінту - https://procedure-sandbox.prozorro.sale/api/classifiers/{classifier} (https://procedure-sandbox.prozorro.sale/api/classifiers/timberEnglish-species) — відображає всі варіанти id для потрібного класифікатора

Procedure ЗЕGE, Надра Subsoil П: Чи вірно, що функції cancel_admission()  в AwardsApi використовується для того, щоб відмінити авард, який знаходиться в статусі pending_waiting і є відмовою учасника, що зайняв друге місце, від очікування?

В: В процедурі renewables ця функція використовується для того, щоб скасувати Авард, який отримав залишок квоти і знаходиться в статусі pending_admission. Аналогічні дії в надрах виконуються через update_award_status

Procedure ЗЕ GE П:Чи достатньо буде для учасника використовувати лише IBAN?

...

В: Ознака public\private у документах, на стороні ЦБД буде валідація, які з типів документів які ознаки підтримують. Майданчик відображає конфіденційні документи учасника тільки для такого учасника та для організатора, який опублікував процедуру.

Procedure, timberEnglishПtimberEnglish П: Як реалізувати розміщення багатьох аукцвонів на одній закладці в рамках реалізації room+timberEnglish?

...

В: Поле terminationReason - це поле award, а не контракту, тому з полями контракту не спрацьовує, відповідно, причина дисквалификації передаєтся до авард, а не до контракту.

Procedure, УЗ railwayCargo П:  В процедурі railwayCargo auctionProtocol  від учасника завантажується в award?

...

В: В рамках active_qualification, протягом verificationPeriod для учасника доступне завантаження/оновлення/видалення документів типу - auctionProtocol та digitalSignature, що були завантажені Учасником в бід лише протягом verificationPeriod

Procedure, УЗ railwayCargo П:  Де можна подивитися список причин дискваліфікації по УЗ?

...

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

Procedure, ЗЕ GE П:З якою метою в процедурі реалізовано три різні поля для валюти value, contractTotalValue і x_valueUAH?

...

В: Дана помилка свідчить про те, що майданчик намагається видалити вже видалений, тобто не уснуючий, документ.

Procedure, Надра Subsoil П:  Чи має можливість у Учасника №2 (pending_waiting) повернути гарантійний внесок, за умови що контракт знаходиться в статусі active процедура в статусі pending_admission?

...

Procedure, railwayCargo-english, П: З якими  документами Учасник може працювати в рамках кваліфікаціїЯкий розмір  гарантійного та реєстраційного внесків? 

В: При розрахунку вказаних внесків слід орієнтуватися на документ: Постанова КМУ "Про реалізацію експериментального проекту щодо проведення електронних аукціонів з продажу необробленої деревини"
https://www.kmu.gov.ua/npas/pro-realizaciyu-eksperimentalnogo-pr-a1178

Procedure, railwayCargo-english, П: З якими  документами Учасник може працювати в рамках кваліфікації? 

В:  В railwayCargo-english  в рамках кваліфікації учасник може працювати тільки з auctionProtocol.

...

реалізувати логіку, за якою робота з кожним документом (створення, оновлення, видалення) відбувається окремо

Procedure, П:  Яким чином, у випадку розробки функціоналу для учасника, можна (для тестування) створювати необхідні ситуації, з боку організтора? 

В:  В разі розробки тільки функціоналу Учасника, доступні наступні варіанти:  1. Публікація аукціонів на одному з інших майданчиків (треба домовитись, щоб вам там надали тестовий кабінет) 2. Самостійна публікація необхідних процедур\створення ситуацій напряму у ЦБД за допомогою postman або інших інструментів 3. Розробка власного мінімального інтерфейсу для організатора, через який можна виконати базові дії

Procedure, П:  Чи прив'язаний JWT токен з DS  до майданчика і чи допустимо використовувати один і той самий JWT токен для кількох майданчиків (клонів)? 

В: JWT токен з DS  до майданчика не прив'язано і итакий токен, потенційно може бути використаним для кількох майданчиків. 

Procedure, П:  Наскільки небезпечною є ситуація, якщо  коистувач на вкладці network  знайде JWT токен документу?,

В: Токен визначає володаря документу, відповідно той у кого токен може виконувати з ним деякі дії (прочитати, прикріпити до процедур) видалити документ він не зможе, тобто за негативного сценарія, що може бути володар токенв може отримати  можливість прочитати приватні документи за допомогою токена власника

Procedure, timber-multiAwards, П:   Яка офіційна назва процедури timber-multiAwards?

В:  Всі назви процедур будуть перераховано за посиланням: https://procedure-sandbox.prozorro.sale/api/legal_names

Procedure, railwayCargo-dutch,  П:  В тест кейсах по процедурі вказано "Публікація та активація заяви на участь під час DUTCH PART”. Учасник має можливість подавати заяву на участь лише протягом tenderPeriod до завершення Dutch Part. В якому полі приходить інформація про Dutch Part?

В: В голандському варіанті процедури tenderPeriod триває до завершення Dutch Part

Procedure, railwayCargo-dutch,  П: В свагері для процедури railwayCargoDutch є два поля minimalStep та dutchStep з однаковим legalName “Розмір кроку аукціону“. В чому різниця між ними?

В: Тут minimalStep автогенерується api

Procedure, railwayCargo-english, П: Підкажіть, як отримати протокол про результати аукціону у JSON або YAML форматах?

В:  https://auction-sandbox.prozorro.sale/api/auctions/TIE001-UA-20200929-59003/protocol- json
https://auction-sandbox.prozorro.sale/api/auctions/TIE001-UA-20200929-59003/protocol/yaml- yaml

Procedure, lease, П: В структурі даних БДК для entity не вказано broker, проте в описі функційЗміна адміністратора організаціїтаБлокування/розблокування користувача(пункт 4.3) викорисовується broker організації. Або все таки мається на увазі broker користувача, або треба розширити entity на broker?

В: Після спрощення структури - це має потягнути відмову від бдк. Тобто логіка перших версій буде аналогічна до логіки цбд: майданчик - оунер, ендюзери - авторизуються тільки на своєму майданчику

Procedure, lease, П:  Згідно ТЗ Орендодавець - підтверджувач дій по об'єкту: визначається шляхом приналежності до організації, EDR-ID якої прописано в полі полі organizingEntity для кожного об'єкту в БДР. Має наступні повноваження:

• активація об'єкт, первинно створений власником об'єкту 
• підтвердження зміни значення listType об'єкту, виконаної власником об'єкту
• завантаження в ДСх документів і асоціація їх зі своїм об'єктом
• завантаження в ДСх документів і асоціація їх з заявками, що прикріплені до його об'єкта

Відповідно, згідно https://prozorrosale.slack.com/archives/C019HQJKQ15/p1599822030016600 Орендодавець(підтверджувач дій по об'єкту) може створювати registry.RealEstate, registry.JointPropertyComplex,  registry.Vehicle, registry.OtherProperty.

В: Інформацію про інші організації заповнює орендодавець. Часто він співпадатиме з балансоутримувачем (хоча не завжди)

Procedure, lease, П: Орендодавець(підтверджувач дій по об'єкту) == sellingEntity ?

В: Так, все вірно

Procedure, lease, П: Стосовно "Інформацію про інші організації заповнює орендодавець" - чи означає це, шо  при створенні об'єкту Орендодавець вручну вносить дані по всім іншим ролям в relatedOrganizations ?

В: Так. Там з обов’язкового Балансоутримувач, інші - опціональні (і де юре, і де факто)

Procedure, lease, П:Чи мають майданчики  для переліків реалізовувати пошукові фільтри?

В: Для першого етапу достатньо інтерфейсу у якому можливо: 

1. Опублікувати об'єкт з усіма доступними полями 
2. Додати документи до цього об'єкту
3. Редагувати цей об'єкт

В подальшому: 
Фільтри, відображення усіх об'єктів з переліку, робота з заявками

Procedure, lease, П: Чи потрібно по оренді створити нову роль організатора, який зможе додавати об'єкти в реєстр, а потім у перспективі створювати з цього об'єкту аукціон, так?

В: Так, мінімально має з’явитись роль “орендодавець“, яка дозволятиме створювати і редагувати власні записи в реєстрі

Procedure, lease, П: Чи достатньо, для передачі  на тестування щоб на майданчику відображався список власних створених об'єктів? тобто можна поки не відображати об'єкти інших майданчиків, поки не буде розроблено функціонал міррора?

В: Для початку тестування так. Для початку роботи на продуктиві потрібно відображати у будь-якому вигляді об'єкти з ендоінту з переліком об'єктів. Бо інакше потенційні орендарі не зможуть знаходити об'єкти на інших майданчиках і формально нормативка не буде виконана. Якщо це сильно ускладнює роботу на стороні майданчика, будемо думати, як встигнути запустити повноцінний search або додати це до mirror.

Procedure, lease, П: Чи вірно, що скоріш всього на продуктиві реєстру не буде мірор а буде в кращому разі search ендпоінт?

В: В першій версії, скоріше за все не буде

Procedure, lease, П: Де можна знайти словники? 

В: https://gitlab.prozorro.sale/prozorro-sale/prozorro-registry/-/tree/master/classifiers - тут есть yaml файли со словарями, которые сейчас. https://gitlab.prozorro.sale/prozorro-sale/prozorro-registry/-/issues/9 - словари, которые будут в слудующем релизе

Procedure, lease, П: Є сгенерований клієнт: https://pypi.prozorro.sale/simple/procedure-api-client/, чи планується до нього додавання  registry?

В: Так, планується

Procedure, lease, П: Де можна знайти інформацію по логіці роботи з реєстрами?

В:Тут

Procedure, lease, П: Чи можливо на  етапі реєстрації Орендодавця (sellingEntity) та створення нового об'єкту,  значення в поля propertyOwner тягнути з sellingEntity, чи потрібно їх вводити вручну?

В: В разі, якщо вони співпадають (що трапляється, але далеко не завжди) - можна тягнути, звісно

Procedure, lease, П: В чому принципова різниця між ролями Орендодавець та Балансоутримувач? Чи може одна й та сама особа бути і Орендодавцем і Балансоутримувачем? Наведіть нам якійсь приклад з реального життя взаємовідносин Балансоутримувача і Орендодавця.

В: Так, може, але це не точно (див.п.1). частішим буде випадок, коли, наприклад, орендодавець - фонд держмайна, а балансоутримувач - якесь ДП

Procedure, lease, П: Чи може, гіпотетично,  фізична особа бути Орендодавцем чи Балансоутримувачем?

В: Ні, не може

Procedure, lease, П: В документіПереліки (реєстр) орендиє Перелік формальних дій. Прокоментуйте будь-ласка першу дію “1. Балансоутримувач надсилає орендодавцю копію рішення про намір передачі майна в оренду через ЕТС“. - яким чином ця дія має відобразитися в системі? чи це офлайнова дія?

В:  Тут певна офлайнова дія, під яку доброчесний балансоутримувач має створити додатково сутність “дія“, куди долучить скан цього рішення. ну або - принаймні - має долучити цей скан безпосередньо до сутності об‘єкта. ми це жорстко не регламентуємо

Procedure, lease, П: Чи потрібно реалізувати весь перелік Дій? Чи поки достатньо функціоналу створення обьєкту?

В: Потрібно реалізувати Об’єкти, Заявки і Дії. Дії відрізняються одна від іншої єдиним полем - actionType. від його значення ніяка логіка не залежить

Procedure, lease, П: З яких причин  у свагері  в base.RegistryObject не додано масив registryObjectItems?

В: В даному випадку registryObjectItemsце поле структуриregistry.RealEstate  в залежності від itemTypeтам різне наповнення, тому базова модель для нього відсутня. Дляregistry.JointPropertyComplex в ціх полях будеregistry.JointPropertyComplexItem

Procedure, lease, П: Чи має бути можливість створювати чернетку обєкту?

В: Так, на стороні майданчика до публікації у ЦБД так, як і при роботі з іншими сутностями

Procedure, lease, П: Чи потрібно створювати окрему роль для роботи з переліками?

В: Якщо вже є роль для Орендодавця по ЗУ, який працює з аукціонами з оренди у ЦБД-2, окремий обліковий запис створювати немає потреби, цей орендодавець може працювати і з переліками у ЦБД-3. Юридично Орендодавець по ЗУ - це та сама особа, що являється Орендодавцем, який публікує інформацію у переліках. І яка потім буде публікувати аукціони
І набір даних у неї співпадає. Відмінності, які можуть бути, вже на рівні ЦБД

Procedure, lease, П: Підкажіть, де можна переглянути список типів документів об"єкту в розрізі типу об"єкту?

В: По-перше - рекомендую використовувати свіжіщий спрощений документ: https://prozorrosale.slack.com/archives/C019HQJKQ15/p1600424693005800щодо питання по суті: в поточній версії домовились відмовитись від обмежень типів документів. тобто поняття обов’язкових документів немає, і ви можете самостійно визначати типи документів, які завантажуєте

Procedure, lease, П: Підкажіть будь-ласка, після того як Орендодавець заповнить поля в формі створення нового обєкту і натисне кнопку Створити і дані відправляться в цбд, а що ми отримаємо у відповідь?

В:  idоб'єкта та acc_tokenоб'єкта

Procedure, lease, П: Чи вірно, що в реєстрах об"єктів маємо виводити перелік об"єктів чи перелік айтемів в об"єктах?

В:  Остаточна організація на фронті насправді на ваш розсуд. можна виводити об‘єкти, і давати можливість подивитись всередину. можна виводити айтеми, а приналежність до об‘єкту давати як атрибут. насправді ми очікуємо, що більша яаствна об’єктів матиме в собі лише один айтем, принаймні на початку

Procedure, lease, П: В свагері   RealEstateItem ->basicInfo->additionalClassification написано, що їх може бути  необмежена кількість, але за схемою це не масив, а об'єк? 

В:  base.additionalClassification действительно может сожержать неограниченное колличество класификаторов в зависимости от процедуры.Это базовое описание базовой модели. Так же для реестров basicInfo.additionalClassification необязательное поле и кол-во класификаторов не определено. 

Procedure, lease, П:  registryObjectItems->reProps->powerSupplyClass не приймає значення зі словника "second"  та registryObjectItems->reProps->locationInBuilding  не приймає нічого зі словника, окрім "basement"

В: Скоріше за все, словники ще не реалізовано  (24.09.2020)

Procedure, lease, П: Як валідується contactPoint.url?

В: По http://

Procedure, lease, П:  Як працювати по полями, якщо у  табличці з прикладами є чимало полів, яких немає в свагері? 
Наприклад:

• Дата рішення балансоутримувача про намір передачі майна в оренду
• Дата рецензії
• Дата затвердження висновку про вартість майна
• Дата оцінки, на яку визначена ринкова вартість
• Дата державної реєстрації права власності
• Дата рішення органу управління про намір передачі майна в оренду
• Дата рішення орендодавця про включення до Переліку першого типу
• В:  Після поля про наявність певного рішення іде всюди поле з реквізитами рішення, текстове. домовились, що всі ці деталі мають потрапляти туди

Procedure, lease, П: Як опрацьовувати дані з наступних полів: 

• Електроенергія
• Опалення
• Холодна вода (постачання і відведення)
• Гаряча вода (постачання і відведення)
• Постачання природного газу
• Утримання будинку і прибудинкової території
• Вивіз сміття
• Порядок сплати орендарем комунальних послуг

В:  Всі ці дані йдуть в одне поле, servicesDescription - під все, якщо будемо бачити, що на це у користувачів є попит - будемо розширяти

Procedure, lease, П: Для чого потрібне поле _version  і чи має майданчик його відображати? 

В: Не потрібно, це внутрішнє поле потрібне для міграції, на клієнтську частину воно ніякого впливу немає

Procedure, lease, П: З яких причин при створенні  об'єкту реєстру  на стейджингу - помилкавалідації? 

Image Added

В:  ЦБД приймає тільки варіант: 

Image Added

Procedure, lease, П: В LeaseAction поле що пов'язує  "Дію"  з об'єктом має назву relatedObjectId, в  LeaseRequest поле що пов'язує "Заявку" з об'єктом має назву  registryItemId - чи вірно, що   "Дію" створюють на об'єкт, а "Заявку" на окремий айтем об'єкту? 

В:  Тут опис структури дії. вона може бути пов’язана з чим завгодно: 

Image Added

це - для завяки. вона має кріпитися до об’єкту: 

Image Added

Procedure, lease, П: Чи вірно що LeaseAction.description и  LeaseRequest.description   не  multiLang? 

В: Згодом будуть внесено зміни, зараз вірно 

Procedure, lease, П: Через що виникає помилка, при спробі публікації реєстра? 

Image Added

В: Дана помилка виникає череез невірно використаний класифікатор. має використовуватися CAV   а не CPV

Procedure, lease, П:  Чи правильно, що для всіх 4 relatedOrganizations потрібно залишити виключно UA-EDR виходячи з: 

Image Added

В:  Так, все вірно, за нормативкою це або ЦОВВ і їх підрозіділи, або ДП/КП (або ще хтось, про кого я не знаю), але енівей - юр.особа. ще й державна так чи інакше

Procedure, lease, П: Чи має майданчик виводити на форму створення обєкту інформацію ізhttps://procedure-staging.prozorro.sale/api/doc#  statusesDecisions→description?

В:  Дискріпшни - це скрізь  технічне поле для проясненя за що та чи інша модель відповідає, обов’язковим є виведення тільки лігалнеймів

Procedure, lease, П: Який словник використовувати для  додаткового класифікатора реєстрів?

В: На зараз (05.10.2020) основний класифікатор CAV, додаткові можуть різнитися від процедури до процедури.

Procedure, lease, П: Чи можуть для LeaseAction бути заповненими  relatedObjectId, relatedRequestId і relatedActionId чи має бути заповнено тільки якесь одне поле?

В: Поля, за бажанням користуача, можуть бути заповнені у будь-якій комбінації.

Procedure, lease, П:  З яких причин при оголошені, не зважаючи на передачу з класифікатором CAV , на стейджингу майданчик отримує помилку? 

Image Added

В: Потрібно взяти з  будьякого об'єкту з  https://procedure-staging.prozorro.sale/api/registry/objects/search/byDateModified/2020  класифікатор і  передати дані з ним.

Procedure, lease, П: Чи є нормальним не пов'язаний ні з чим action  https://procedure-staging.prozorro.sale/api/registry/actions/5f7dcaa3d488ef8f846979dc? 

В:  За логікою, ні не нормально, але технічно - так. 

Procedure, lease, П:

Procedure, lease, П: З яких причин  при передачі даних на створення  об'єкту  на  https://procedure-staging.prozorro.sale/api/registry/realEstate майданчик отримує помилку Not Found.
"x-request-id": "01b87658-6f32-43c1-8007-947e5e88527a"

В:  З тієї причина, що передавати потрібно на https://procedure-staging.prozorro.sale/api/registry/objects/realEstate

Procedure, lease, П: Чи може користувач при реєстрації обрати одразу дві ролі (Балансоутримувач та Орендодавцем), щоб потім при створенні обєкту обирати під якою роллю він створює обєкт?

В: Користувач реєструється як користувач, а вже при роботі з певним об’єктом він має обирати хто він: блнсутр, орендд або обидва

Procedure, lease, П: Чи є (чи планується) загальна база Орендодавців та Балансоутримувачів звідки майданчик підтягував би інформацію при створенні нового обєкту по ЄДРПОУ?

В: В майбутньому. наразі  рекомендується робити це на боці майданчика

Procedure, lease, timber, П: Чи може організатор з продажу деревени (це окрема роль згідно вимог по тімберу) бути одночасно і організатором з переліків?

В: В  разі, якщо у нього є і ліс, і майно в оренду - то так

Procedure, lease, timber, П: В разі, якщо майданчик реалізовує мультироль з селектом при створенні об’єкту, то поки не дуже зрозуміло як будуть Орендодавець та Балансоутримувач надсилати один одному Дії, наприклад клопотання?

В: Дії - вони не надсилаються “комусь“, вони асоціюютья з іншою сутністю. Доречі це неправильно,  варто б дати можливість асоціювати дію в тому числі і з кимось.

Procedure, lease, П: Чи не є наступна поведінка помилковою:  Створити об'єкт з документами → при редагуванні передати породній масив → отримати порожній об'єкт без документів? 

В: Ні, така поведінка не є помилкою, передача порожнього масиву затирає існуючі об'єкти

Procedure, lease, П: Питання по продуктивному середовищу:  яку початкову дату використовувати для повної синхронізації xthtp /api/registry/objects/search/byDateModified/{date_modified}?

В: Найпростіший варіант передавати /api/registry/objects/search/byDateModified/2020, це збере всі об'єкти з початку року.