Вітаємо на сайті документації по openprocurement.auctions.dutch!

Будь ласка повідомляйте про всі проблеми та поради покращень або через розсилку або через issue tracker.

Зміст:

Огляд

openprocurement.auctions.insider contains documentaion concerning the new type of the Deposit Guarantee Fund auctions.

Використовується процедура dgfInsider, в межах якої оголошуються аукціони з продажу майна банків та прав вимоги за кредитами.

Особливості

  • Аукціон проводиться у три етапи: Голландський аукціон, sealed bid та best bid частини.

  • The only date Organizer has to provide is a preferable day for the auction, the rest will be calculated automatically.
  • Організатор не може редагувати суттєвих властивостей процедури, наприклад, Auction.value.

  • Bidders can enter the auction till the end of the Dutch part (tenderPeriod.endDate = auctionPeriod.startDate + Dutch part duration).
  • There is obligatory participant qualification (Bid.selfQualified) via guarantee payment. It has to be paid till 16:00 of the auction day and submitted by the platform.
  • URL for the bidder’s participation in auction is generated and sent to the platform right after the platform has denoted (bid.qualified: true) and changed bidder’s status to active.
  • Bids with the value mentioned will be rejected.
  • Auction.value поступово знижується на 1% протягом Голландського етапу.

  • Bidder can’t delete his bid within the first part of the auction.
  • The maximum number of steps within the Dutch part is 80.
  • Якщо жоден учкасник не зробить цінової пропозиції під час Голландського аукціону, процедура вважається неуспішною.

  • The minimalStep field is optional (value that will be always automatically set is 0).

Домовленості

API приймає JSON або form-encoded вміст у запитах. Він повертає JSON вміст у всіх свої відповідях, включно з помилками. Підтримується лише UTF-8 кодування і для запитів, і для відповідей.

Всі API POST та PUT запити очікують об’єкт верхнього рівня з єдиним елементом з назвою data. Відповіді з повідомленням про успіх будуть віддзеркалювати цей формат. Елемент data повинен сам бути об’єктом, що містить параметри запиту. Якщо створюється новий аукціон, то це ті поля, які ми хочемо встановити на самому аукціоні.

Якщо запит був успішним, ми отримаємо код відповіді 201, який вказує, що об’єкт був створений. Ця відповідь буде мати data поле на верхньому рівні, яке вміщуватиме повну інформацію про новий аукціон, включно з ID.

Якщо під час запиту виникли труднощі, ми отримаємо інший код стану та JSON, який при поверненні міститиме errors поле на верхньому рівні зі списком проблем. Ми дивимось на першу з них і видруковуємо її повідомлення.

Стан проекту

Статус цього проекту пре-альфа.

The source repository for this project is on GitHub: https://github.com/openprocurement/openprocurement.auctions.insider.

Стабільність API

API є відносно стабільним. Зміни в API обговорюються через Open Procurement API розсилку.

Наступні кроки

Можливо вам буде цікаво прочитати Tutorial.

Стандарт даних

Стандарт даних змодельований згідно Open Contracting Standard з розширеннями в тих областях, які він не покриває.

Auction

Схема

title:

рядок, багатомовний, лише для читання

Номер аукціону у Фонді Гарантування Вкладів.

description:

рядок, багатомовний

Детальний опис аукціону.

auctionID:

рядок, генерується автоматично, лише для читання

Ідентифікатор аукціону, щоб знайти його у “паперовій” документації

OpenContracting Description: Ідентифікатор аукціону AuctionID повинен завжди співпадати з OCID. Його включають, щоб зробити структуру даних більш зручною.

procurementMethodType:
 

рядок, обов’язковий

Auction announcement.

procuringEntity:
 

ProcuringEntity (Організатор), обов’язково

Організатор (організація, що проводить аукціон).

OpenContracting Description: Об’єкт, що управляє закупівлею. Він не обов’язково є покупцем, який платить / використовує закуплені елементи.

tenderAttempts:

ціле число

Число, що вказує на кількість спроб виставлення лоту.

value:

Value, обов’язково

Auction starting price.

OpenContracting Description: Загальна кошторисна вартість закупівлі.

guarantee:

Guarantee

Гарантійний внесок

items:

список об’єктів Item, обов’язково

Список містить елементи, що продаються.

OpenContracting Description: Товари та послуги, що будуть закуплені, поділені на спискові елементи, де це можливо. Елементи не повинні дублюватись, замість цього вкажіть кількість 2.

features:

список об’єктів Feature

Властивості аукціону.

documents:

Список об’єктів Document

OpenContracting Description: Всі документи та додатки пов’язані із аукціоном.

questions:

Список об’єктів Question

Питання до організатора procuringEntity і відповіді на них.

complaints:

Список об’єктів Complaint

Скарги на умови аукціону та їх вирішення.

bids:

Список об’єктів Bid

Список усіх пропозицій поданих до аукціону разом із інформацією про учасників аукціону, їхні пропозиції та інша кваліфікаційна документація.

OpenContracting Description: Список усіх компаній, які подали заявки для участі в аукціоні.

awards:

Список об’єктів Award

Всі кваліфікації (дискваліфікації та визначення переможця).

contracts:

Список об’єктів Contract

enquiryPeriod:

Period

Період, коли дозволено задавати питання.

OpenContracting Description: Період, коли можна задати питання (уточнення) та отримати відповіді на них.

tenderPeriod:

Period

Період, коли подаються пропозиції.

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

auctionPeriod:

Period, обов’язково

Період, коли проводиться аукціон. Значення startDate (дата проведення аукціону) повинно бути вказано обов’язково.

auctionUrl:

URL-адреса

Веб-адреса для перегляду аукціону.

awardPeriod:

Period, лише для читання

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

OpenContracting Description: Дата або період, коли очікується визначення переможця.

status:

рядок

active.tendering:
 

Очікування пропозицій (пропозиції)

active.auction:

Період аукціону (аукціон)

active.qualification:
 

Кваліфікація переможця (кваліфікація)

active.awarded:

Пропозиції розглянуто (розглянуто)

unsuccessful:

Аукціон не відбувся (не відбувся)

complete:

Завершений аукціон (завершений)

cancelled:

Відмінений аукціон (відмінений)

Статус аукціону.

cancellations:

Список об’єктів Cancellation.

Містить 1 об’єкт зі статусом active на випадок, якщо аукціон буде відмінено.

Об’єкт Cancellation описує причину скасування аукціону та надає відповідні документи, якщо такі є.

revisions:

Список об’єктів Revision, генерується автоматично, лише для читання

Зміни властивостей об’єктів Auction.

Organization

Схема

name:

рядок, багатомовний

Назва організації.

identifier:

Identifier

Ідентифікатор цієї організації.

additionalIdentifiers:
 

Список об’єктів Identifier

address:

Address, обов’язково

contactPoint:

ContactPoint, обов’язково

Identifier

Схема

scheme:

рядок

OpenContracting Description: Ідентифікатори організації беруться з існуючої схеми ідентифікації. Це поле вказує схему або список кодів, де можна знайти ідентифікатор організації. Це значення повинно братись зі Схеми Ідентифікації Організацій.

id:

рядок, обов’язковий

OpenContracting Description: Ідентифікатор організації у вибраній схемі.

Дозволеними є коди зі спику кодів “Organisation Registration Agency” Стандарту IATI з додаванням коду UA-EDR для організацій, зареєстрованих в Україні (ЄДРПОУ та ІПН).

legalName:

рядок, багатомовний

OpenContracting Description: Легально зареєстрована назва організації.

Повна юридична назва (наприклад - “Надра Банк”).

uri:

uri

OpenContracting Description: URI для ідентифікації організації, наприклад, ті, які надають Open Corporates або інші постачальники URI. Це не для вебсайту організації, його можна надати в полі url в ContactPoint організації.

Address

Схема

streetAddress:

рядок

OpenContracting Description: Вулиця. Наприклад, вул.Хрещатик, 22.

locality:

рядок

OpenContracting Description: Населений пункт. Наприклад, Київ.

region:

рядок

OpenContracting Description: Область. Наприклад, Київська.

postalCode:

рядок

OpenContracting Description: Поштовий індекс, Наприклад, 78043.

countryName:

рядок, багатомовний, обов’язковий

OpenContracting Description: Назва країни. Наприклад, Україна.

ContactPoint

Схема

name:

рядок, багатомовний, обов’язковий

OpenContracting Description: Ім’я контактної особи, назва відділу чи контактного пункту для листування, що стосується цього процесу укладання договору.

email:

email

OpenContracting Description: Адреса електронної пошти контактної особи/пункту.

telephone:

рядок

OpenContracting Description: Номер телефону контактної особи/пункту. Повинен включати міжнародний телефонний код.

faxNumber:

рядок

OpenContracting Description: Номер факсу контактної особи/пункту. Повинен включати міжнародний телефонний код.

url:

URL-адреса

OpenContracting Description: Веб адреса контактної особи/пункту.

Повинне бути заповнене хоча б одне з полів: або email, або telephone.

Item

Схема

id:

рядок, генерується автоматично

description:

рядок, багатомовний, обов’язковий

OpenContracting Description: Опис товарів та послуг, які повинні бути надані.

classification:

Classification

OpenContracting Description: Початкова класифікація елемента. Дивіться у itemClassificationScheme, щоб визначити бажані списки класифікації.

Класифікація classification.scheme обов’язково повинна бути CPV. classification.id повинно бути дійсним CPV кодом.

additionalClassifications:
 

Список об’єктів Classification

OpenContracting Description: Масив додаткових класифікацій для елемента. Дивіться у список кодів itemClassificationScheme, щоб використати поширені варіанти в OCDS. Також можна використовувати для представлення кодів з внутрішньої схеми класифікації.

Один з можливих додаткових класифікаторів - CPVS.

unit:

Unit

OpenContracting Description: Опис одиниці виміру товару, наприклад, години, кілограми. Складається з назви одиниці та значення однієї одиниці.

quantity:

ціле число

OpenContracting Description: Кількість необхідних одиниць.

address:

Address

Адреса місцезнаходження майна АБО Адреса місцезнаходження активу.

location:

словник

Географічні координати місця розташування. Складається з таких компонентів:

latitude:

рядок, обов’язковий

longitude:

рядок, обов’язковий

elevation:

рядок, не обов’язково, переважно не використовується

Параметр location зазвичай має вищий пріоритет ніж address, якщо вони обидва вказані.

Classification

Схема

scheme:

рядок

OpenContracting Description: Класифікація повинна бути взята з існуючої схеми або списку кодів. Це поле використовується, щоб вказати схему/список кодів, з яких буде братись класифікація. Для класифікацій лінійних елементів це значення повинно представляти відому Схему Класифікації Елементів, де це можливо.

id:

рядок

OpenContracting Description: Код класифікації взятий з вибраної схеми.

description:

рядок

OpenContracting Description: Текстовий опис або назва коду.

uri:

uri

OpenContracting Description: URI для ідентифікації коду. Якщо індивідуальні URI не доступні для елементів у схемі ідентифікації, це значення треба залишити пустим.

Unit

Схема

code:

рядок, обов’язковий

Код одиниці виміру в UN/CEFACT Recommendation 20.

name:

рядок

OpenContracting Description: Назва одиниці виміру

Document

Схема

id:

рядок, генерується автоматично

documentType:

рядок

Можливі значення для Auction

  • notice - Повідомлення про аукціон

    Офіційне повідомлення, що містить деталі аукціону. Це може бути посилання на документ, веб-сторінку, чи на офіційний бюлетень, де розміщено повідомлення.

  • technicalSpecifications - Технічні специфікації

    Детальна технічна інформація про товари або послуги, що повинні бути надані.

  • evaluationCriteria - Критерії оцінки

    Інформація про те, як будуть оцінюватись пропозиції.

  • clarifications - Пояснення до питань заданих учасниками

    Включає відповіді на питання, підняті на передтендерних конференціях.

  • bidders - Інформація про учасників

    Інформація про учасників, їхні документи для перевірки та будь-які процесуальні пільги, на які вони можуть претендувати.

  • virtualDataRoom - Віртуальна кімната для роботи з конфіденційними даними

  • illustration - Ілюстрації

  • x_dgfPublicAssetCertificate - Публічний Паспорт Активу

    Інформація про аукціон. Це гіперпосилання на Публічний Паспорт Активу.

  • x_presentation - Презентація

    Презентація активу виставленого на продаж.

  • x_nda - Договір про нерозголошення (NDA)

    Договір про нерозголошення між учасником та банком/Фондом Гарантування Вкладів.

  • x_dgfPlatformLegalDetails - Юридична Інформація Майданчиків

    Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків.

  • x_dgfAssetFamiliarization - Asset Familiarization

    Порядок ознайомлення з майном / Порядок ознайомлення з активом у кімнаті даних. Містить інформацію про те де і коли певний документ можна переглянути вживу.

Можливі значення для Award

  • winningBid - Пропозиція, що перемогла

Можливі значення для Contract

  • notice - Повідомлення про договір

    Офіційне повідомлення, що містить деталі закупівлі. Це може бути посилання на документ, веб-сторінку, чи на офіційний бюлетень, де розміщено повідомлення.

  • contractSigned - Підписаний договір

  • contractAnnexe - Додатки до договору

Можливі значення для Bid

  • commercialProposal - Цінова пропозиція

  • qualificationDocuments - Документи, що підтверджують кваліфікацію

  • eligibilityDocuments - Документи, що підтверджують відповідність (в тому числі, відповідність вимогам ст. 17)

  • financialLicense - Ліцензія

  • auctionProtocol - Протокол торгів

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

title:

рядок, багатомовний

OpenContracting Description: Назва документа.

description:

рядок, багатомовний

OpenContracting Description: Короткий опис документа. Якщо документ не буде доступний онлайн, то поле опису можна використати для вказання способу отримання копії документа.

index:

ціле число

Пареметр сортування (порядку відображення), що використовується для ілюстрацій. Чим менше число, тим вище ілюстрація буде при сортуванні. Якщо параметр не зазначений, то ілюстрація відображатиметься останньою. Якщо дві ілюстрації мають однакове значення параметру, то порядок сортування буде залежати від дати публікації.

format:

рядок

OpenContracting Description: Формат документа зі списку кодів IANA Media Types, з одним додатковим значенням ‘offline/print’, що буде використовуватись, коли запис цього документа використовується для опису офлайнової публікації документа.

url:

рядок, генерується автоматично

OpenContracting Description: Пряме посилання на документ чи додаток.

datePublished:

рядок, Date

OpenContracting Description: Дата, коли документ був опублікований вперше.

dateModified:

рядок, Date

OpenContracting Description: Дата, коли документ був змінений востаннє.

language:

рядок

OpenContracting Description: Вказує мову документа, використовуючи або двоцифровий код ISO 639-1, або розширений BCP47 language tags.

documentOf:

рядок

Можливі значення:

  • auction
  • item
relatedItem:

рядок

Ідентифікатор пов’язаних об’єктів Item.

Bid

Схема

tenderers:

Список об’єктів Organization

date:

рядок, Date, генерується автоматично

Дата подачі пропозиції.

id:

UID, генерується автоматично

status:

рядок

Можливі значення:

  • draft - чернетка

  • active - активна ставка

value:

Value, обов’язково

Правила валідації:

  • currency повинно або бути відсутнім, або відповідати Auction.value.currency

  • Значення valueAddedTaxIncluded повинно бути або відсутнім, або співпадати з Auction.value.valueAddedTaxIncluded

documents:

Список об’єктів Document

parameters:

Список об’єктів Parameter

participationUrl:
 

URL-адреса

Веб-адреса для участі в аукціоні.

qualified:

булеве значення, обов’язково

Parameter

Схема

code:

рядок, обов’язковий

Код критерію.

value:

float, обов’язково

Значення критерію.

Award

Схема

id:

рядок, генерується автоматично, лише для читання

OpenContracting Description: Ідентифікатор цього рішення.

bid_id:

рядок, генерується автоматично, лише для читання

ID пропозиції, що виграла закупівлю

title:

рядок, багатомовний

OpenContracting Description: Назва рішення.

description:

рядок, багатомовний

OpenContracting Description: Опис рішення.

status:

рядок

OpenContracting Description: Поточний статус рішення, взятий зі списку кодів awardStatus.

Можливі значення:

  • pending.verification- очікується завантаження підписаного переможцем протоколу аукціону

  • pending.payment - очікується оплата

  • unsuccessful - учасника дискваліфікував кваліфікаційний комітет (банк)

  • active - аукціон виграв учасник з пропозицією bid_id

  • pending.waiting - другий по списку учасник очікує дискваліфікації першого по списку учасника торгів

  • cancelled - другий по списку учасник вирішив не чекати на дискваліфікацію першого по списку учасника

verificationPeriod:
 

Period

Період завантаження (переможцем аукціону) і верифікації (банком) протоколу аукціону

paymentPeriod:

Period

Період наданий переможцю аукціону для здійснення оплати

signingPeriod:

Period

Період очікування активації контракту (банком)

date:

рядок, Date, генерується автоматично, лише для читання

OpenContracting Description: Дата рішення про підписання договору.

value:

О’єкт Value, генерується автоматично, лише для читання

OpenContracting Description: Загальна вартість згідно цього рішення.

suppliers:

Список об’єктів Organization, генерується автоматично, лише для читання

OpenContracting Description: Постачальники, що були визнані переможцями згідно цього рішення.

items:

Список об’єктів Item, генерується автоматично, лише для читання

OpenContracting Description: Товари та послуги, що розглядались цим рішенням, поділені на окремі рядки, де це можливо. Елементи не повинні бути продубльовані, а повинні мати вказану кількість.

documents:

Список об’єктів Document

OpenContracting Description: Усі документи та додатки пов’язані з рішенням, включно з будь-якими повідомленнями.

complaints:

Список об’єктів Complaint

complaintPeriod:
 

Period

Період часу, під час якого можна подавати скарги.

Question

Схема

id:

UID, генерується автоматично

author:

Organization, обов’язково

Хто задає питання (contactPoint - людина, identification - організація, яку ця людина представляє).

title:

рядок, обов’язковий

Назва запитання.

description:

рядок

Опис запитання.

date:

рядок, Date, генерується автоматично

Дата публікації.

answer:

рядок

Відповідь на задане питання.

questionOf:

рядок

Можливі значення:

  • auction
  • item
relatedItem:

рядок

Ідентифікатор пов’язаних об’єктів Item.

Complaint

Схема

id:

UID, генерується автоматично

author:

Organization, обов’язково

Організація, яка подає скаргу (contactPoint - людина, identification - організація, яку ця людина представляє).

title:

рядок, обов’язковий

Заголовок скарги.

description:

Опис запитання.

date:

рядок, Date, генерується автоматично

Дата подання.

dateSubmitted:

рядок, Date, генерується автоматично

Дата, коли вимога була подана.

dateAnswered:

рядок, Date, генерується автоматично

Дата, коли організатор відповів на вимогу.

dateEscalated:

рядок, Date, генерується автоматично

Дата ескалації (перетворення вимоги на скаргу).

dateDecision:

рядок, Date, генерується автоматично

День прийняття рішення по скарзі.

dateCanceled:

рядок, Date, генерується автоматично

Дата відхилення.

status:

рядок

Можливі значення:

  • draft - чорновик, початковий етап

  • claim - вимога

  • answered - дано відповідь

  • pending - не вирішено, ще обробляється

  • invalid - недійсно

  • declined - відхилено

  • resolved - вирішено

  • cancelled - скасовано

type:

рядок

Можливі значення типу:

  • claim - вимога

  • complaint - скарга

resolution:

рядок

Рішення організатора.

resolutionType:

рядок

Можливі значення типу вирішення:

  • invalid - недійсно

  • declined - відхилено

  • resolved - вирішено

satisfied:

булеве значення

Вимога задовільнена?

decision:

рядок

Рішення органу оскарження.

cancellationReason:
 

рядок

Причини відхилення.

documents:

Список об’єктів Document

auctionerAction:
 

рядок

Дія учасника.

auctionerActionDate:
 

рядок, Date, генерується автоматично

Дата дії учасника.

Contract

Схема

id:

UID, генерується автоматично

OpenContracting Description: Ідентифікатор цього договору.

awardID:

рядок, обов’язковий

OpenContracting Description: Award.id вказує на рішення, згідно якого видається договір.

contractID:

рядок, генерується автоматично, лише для читання

contractNumber:

рядок

title:

рядок, обов’язковий

OpenContracting Description: Назва договору

description:

рядок

OpenContracting Description: Опис договору

value:

Об’єкт Value, генерується автоматично, лише для читання

OpenContracting Description: Загальна вартість договору.

items:

Список об’єктів Item, генерується автоматично, лише для читання

OpenContracting Description: Товари, послуги та інші нематеріальні результати у цій угоді. Зверніть увагу: Якщо список співпадає з визначенням переможця award, то його не потрібно повторювати.

suppliers:

Список об’єктів Organization, генерується автоматично, лише для читання

status:

рядок, обов’язковий

OpenContracting Description: Поточний статус договору.

Можливі значення:

  • pending - цей договір запропоновано, але він ще не діє. Можливо очікується його підписання.

  • active - цей договір підписаний всіма учасниками, і зараз діє на законних підставах.

  • cancelled - цей договір було скасовано до підписання.

  • terminated - цей договір був підписаний та діяв, але вже завершився. Це може бути пов’язано з виконанням договору, або з достроковим припиненням через якусь незавершеність.

period:

Period

OpenContracting Description: Дата початку та завершення договору.

dateSigned:

рядок, Date

OpenContracting Description: Дата підписання договору. Якщо було декілька підписань, то береться дата останнього підписання.

date:

рядок, Date

Дата, коли договір був змінений або активований.

documents:

Список об’єктів Document

OpenContracting Description: Усі документи та додатки пов’язані з договором, включно з будь-якими повідомленнями.

Period

Схема

startDate:

рядок, Date

OpenContracting Description: Початкова дата періоду.

endDate:

рядок, Date

OpenContracting Description: Кінцева дата періоду.

Значення startDate завжди повинно йти перед endDate.

Date

Дата/час у Date Format: ISO 8601.

Value

Схема

amount:

float, обов’язково

OpenContracting Description: Кількість як число.

Повинно бути додатнім.

currency:

рядок, обов’язковий

OpenContracting Description: Валюта у трибуквенному форматі ISO 4217.

valueAddedTaxIncluded:
 

булеве значення, обов’язково

Revision

Схема

date:

рядок, Date

Дата, коли зміни були записані.

changes:

Список об’єктів Change

Guarantee

Схема

amount:

float, обов’язково

OpenContracting Description: Кількість як число.

Повинно бути додатнім.

currency:

рядок, обов’язковий, за замовчуванням = UAH

OpenContracting Description: Валюта у трибуквенному форматі ISO 4217.

Cancellation

Схема

id:

UID, генерується автоматично

reason:

рядок, багатомовний, обов’язковий

Причина, з якої скасовується аукціон.

status:

рядок

Можливі значення:
pending:

За замовчуванням. Запит оформляється.

active:

Скасування активоване.

documents:

Список об’єктів Document

Супровідна документація скасування: Протокол рішення Аукціонного комітету організатора про скасування аукціону.

date:

рядок, Date

Дата скасування

cancellationOf:

рядок

Можливі значення:

  • auction

ProcuringEntity (Організатор)

Схема

name:

рядок, багатомовний

OpenContracting Description: Назва організації.

identifier:

Identifier

OpenContracting Description: Ідентифікатор цієї організації.

additionalIdentifiers:
 

Список об’єктів Identifier

address:

Address, обов’язково

contactPoint:

ContactPoint, обов’язково

kind:

рядок

Тип організатора

Можливі значення:
  • general - Організатор (загальний)

  • special - Організатор, що здійснює діяльність в окремих сферах господарювання

  • other - Юридичні особи, які не є організаторами в розумінні Закону, але є державними, комунальними, казенними підприємствами, господарськими товариствами чи об’єднаннями підприємств, у яких державна чи комунальна частка складає 50 і більше відсотків

Індекси та таблиці