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

Мирорр клієнт 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, 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, це збере всі об'єкти з початку року.