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

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

Зміст:

Огляд

Ця документація пакету openprocurement.auctions.lease містить інформацію для Учасників системи ПРОЗОРРО.ПРОДАЖІ і покликана розкрити всі аспекти процедури оренди.

Наступні суб’єкти можуть виступати в ролі Організатора:

  • State Property Fund of Ukraine [1];
  • державні підприємтва;

  • органи, уповноважені Верховною Радою Автономної Республіки Крим та органами місцевого самоврядування управляти майном;

  • підприємства, установи та організації.

Для провадження оренди державної власності доступна спеціальна процедура:

  • propertyLease - оренда державної власності.

Особливості

  • Єдине, що Організатор повинен передати - це Auction.auctionPeriod.startDate - приблизну дату початку аукціону - фактичне значення початку Аукціону буде обраховано на основі поточної завантаженості системи.

  • Всі інші дати будуть обраховані автоматично.

  • Необов’язково Організатор може вказати enquiryPeriod.endDate, якщо не вказано - обчислиться автоматично.

  • tenderPeriod має складати щонайменше 7 календарних днів.

  • Необов’язково Організатор може вказати tenderPeriod.endDate - якщо вказано, аукціоне не може початися раніше, ніж за 3 дні потому.

  • Організатор може редагувати аукціон тільки впродовж rectificationPeriod.(збільшувати і зменшувати value.amount, guarantee.amount, minimalStep.amount).

  • Організатор може додавати та редагувати документи аукціону тільки впродовж rectificationPeriod.

  • Кожного разу після редагування аукціону статус всіх ставок перемикається на invalid.

  • Процедура переходить зі статусу draft до active.tendering.

  • Протягом enquiryPeripod учасники можуть задавати питання, подавати пропозиції, завантажувати документи.

  • Організатор може використати будь-який ідентифікатор зі схеми CPVS. Значення PA01-7 додаткового класифікатора CPVS буде встановлено автоматично.

Примітка

Існує кінцевий перелік можливих для оренди об’єктів.

  • Мінімальна бажана кількість учасників за замовчанням дорівнює 2, але існує можливість понизити це значення до 1 учасника;

  • Єдина валюта (value.currency) цієї процедури - гривня (UAH).

  • Аукціон може містити елементи з різних CAV та CAV-PS груп.

  • Обов’язкова кваліфікація учасника відбувається через гарантійний платіж.

  • Єдиним критерієм виявлення переможця є запропонована учасником ціна, за умови, що він задовольняє інші кваліфікаційні критерії Організатора.

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

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

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

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

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

Стан проекту

Наразі, статус цього проекту - бета.

Репозиторій джерельних текстів цього проекту є на `GitHub https://github.com/openprocurement/openprocurement.auctions.lease

Повідомляйте про всі проблеми та поради через `Issue tracker <https://github.com/openprocurement/openprocurement.auctions.lease/issues>`_(реєстрація на GitHub обов’язкова).

API stability

API is relatively stable.

Звіт про зміни

1.1.1-sale

0.1.0

Випущено: не випущено

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

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

Посилання

[1]http://www.spfu.gov.ua

Глосарій

Тендерна Процедура

процес, який включає:

  • lease tender procedure conducted by an Organizer;
  • надання початкових ставок Учасниками (Bidders);

  • аукціон (3 раунди);

  • кваліфікація (авардинг, awarding) - визначення переможця;

  • платіж;

  • підписання договору;

Організатор
lease tender procedure initiator
Мінімальна кількість кваліфікованих ставок [minNumberOfQualifiedBids]
minimum eligible participant number count to consider procedure successful
Дата інвалідації [invalidationDate]

дата останнього редагування Організатором (початкові ставки стають невалідними)

Валідна ставка
a bid whose value is equal to or higher than the value of value.amount + minimalStep
CAV-PS & CPV

основний класифікатор

CPVS (Common Procurement Vocabulary)

додатковий (допоміжний) класифікатор

Життєвий цикл Тендерної Процедури

складається з наступних періодів:

  • tenderPeriod - the time span during which tender bids are being accepted;
  • enquiryPeriod - the time span during which participants can ask questions to clarify the tender terms;
  • rectificationPeriod - the time span during which an Organizer can introduce changes to tender terms;
  • auctionPeriod - the time span of auction itself;
  • verificationPeriod - the time span during which an Organizer identifies a winner;
  • paymentPeriod - the time span during which the Participant (Winner) makes payment;
  • signingPeriod - the time span of the contract uploading and activating;
_images/auction_lifecycle.png

Примітка

  • tenderPeriod має бути щонайменше на 5 днів довшим за rectificationPeriod;

  • as the result of verification process is auction Protocol (confirmed and uploaded by an Organizer);
  • кожен період має свою початкову startDate і кінцеву endDate дати.

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

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

Auction

Схема

title:

рядок, багатомовний, обов’язковий, доступний для редагування впродовж rectificationPeriod

Auction title.

description:

рядок, багатомовний, обов’язковий, доступний для редагування впродовж rectificationPeriod

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

auctionID:

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

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

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

lotIdentifier:

рядок, обов’язковий, доступний для редагування впродовж rectificationPeriod

Номер аукціону (або лота) у паперовій документації.

procuringEntity:
 

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

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

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

value:

Value, обов’язково, доступне для редагування впродовж rectificationPeriod

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

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

guarantee:

Guarantee, optional, editable during rectificationPeriod

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

items:

список об’єктів Item, обов’язково, доступне для редагування впродовж rectificationPeriod

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

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

features:

list of Feature objects

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

documents:

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

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

questions:

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

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

complaints:

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

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

bids:

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

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

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

minNumberOfQualifiedBids:
 

ціле число, не обов’язково

Поле, що вказує на мінімальну кількість кваліфікованих пропозицій. Можливі значення, що можна присвоїти: 1 або 2.

Якщо поле залишилось незаповненим, то порядок дій такий же, як і при наявності двох учасників.

При присвоєнні полю значення “1” пропозиція учасника торгів автоматично стає award’ом, що пройшов етап кваліфікації. Сам же аукціон в такому випадку відсутній. Процедура вважається успішною.

minimalStep:

Value, обов’язково, доступне для редагування впродовж rectificationPeriod

Мінімальний крок аукціону. Правила валідації:

  • amount повинна бути більша за Auction.value.amount

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

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

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.

ContractTerms

Схема

Type:

string, required

The only value for this field is lease.

leaseTerms:

LeaseTerms

The details of how property is to be leased.

LeaseTerms

Схема

leaseDuration:

ISO8601 duration [2] object, required

The time span during which a contracted lease is in place.

taxHolidays:

list of TaxHolidays, optional

The period during which tax concessions are made for some reason.

escalationClauses:
 

list of EscalationClauses, optional

The rules for the way of monthly payment to be changed on a periodic basis.

TaxHolidays

Схема

taxHolidaysDuration:
 

ISO8601 duration [2] object, required

Duration of the period within which a person or company is allowed to pay less than usual (or provide no payment).

conditions:

string, required, multilingual

The details for the way of lease holidays to be held.

value:

Value object, required

The amount to be paid by a contractor within lease holidays.

EscalationClauses

Схема

id:

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

escalationPeriodicity:
 

Time intervals [1], required

Periodicity within which the payment will be increasing considering the inflation rate (for example) on a yearly basis.

escalationStepPercentage:
 

decimal, required

The percentage which indicates the amount of step the monthly payment will be increased/decreased by.

conditions:

string, required, multilingual

The details for the way of monthly payment to be increased/decreased.

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: A description of the property to be leased.

Опис активу / предмету торгів

classification:

Classification

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

Класифікатори, що можуть використовуватись при заведенні закупівлі як основні, - CPV та CAV-PS. Додатково здійснюється валідація введення CAV-PS та CPV з точністю не менше класу.

additionalClassifications:
 

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

Додатковим класифікатором є CPVS. Майно може бути здане в оренду, при передачі значення PA01-7 в полі класифікатора CPVS.

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

unit:

Unit

OpenContracting Description: Description of the unit which the property comes in. Made up of a unit name, and the value of a single unit.

quantity:

ціле число

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

contractPeriod:

Period

Період, що вказує на тривалість дії укладеного договору. СontractPeriod ідентифікує дату початку та завершення договору, підписаного під час проведення торгів з продажу майна (активів) банку. Також, contractPeriod може використовуватись для детермінування часового проміжку дії аренди.

address:

Address

Адреса, де розташований елемент. Класифікатори (CAV-PS) для яких заповнення полів item.address є необов’язковим, знаходяться за посиланням нижче:

CPV

CAV_v2

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:

рядок

Possible values for Auction

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

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

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

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

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

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

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

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

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

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

  • virtualDataRoom - Virtual Data Room

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

  • x_dgfAssetFamiliarization - Asset Familiarization

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

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

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

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

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

Possible values for Award

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

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

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

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

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

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

Possible values for Bid

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

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

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

  • financialLicense - License

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

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

title:

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

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

description:

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

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

index:

ціле число

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

format:

рядок

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

url:

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

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

datePublished:

string, Date

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

dateModified:

string, Date

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

language:

рядок

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

documentOf:

рядок

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

  • auction
  • item
relatedItem:

рядок

ID of related Item.

accessDetails:

рядок

Required for x_dgfAssetFamiliarization document.

Bid

Схема

tenderers:

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

date:

string, Date, auto-generated

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

id:

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

status:

рядок

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

  • draft - чернетка

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

value:

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

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

  • amount повинно бути меншим, ніж Auction.value.amount

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

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

documents:

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

parameters:

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

participationUrl:
 

URL-адреса

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

qualified:

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

eligible:

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

Необхідно для dgfFinancialAssets процедури (продаж права вимоги за кредитними договорами).

Parameter

Схема

code:

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

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

value:

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

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

Award

Схема

id:

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

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

bid_id:

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

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

title:

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

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

description:

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

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

status:

рядок

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

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

  • pending - переможець розглядається кваліфікаційною комісією

  • unsuccessful - кваліфікаційна комісія відмовила переможцю

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

  • cancelled - орган, що розглядає скарги, відмінив результати закупівлі

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:

string, Date, auto-generated

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

answer:

рядок

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

questionOf:

рядок

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

  • auction
  • item
relatedItem:

рядок

ID of related Item.

Complaint

Схема

id:

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

author:

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

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

title:

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

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

description:

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

date:

string, Date, auto-generated

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

dateSubmitted:

string, Date, auto-generated

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

dateAnswered:

string, Date, auto-generated

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

dateEscalated:

string, Date, auto-generated

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

dateDecision:

string, Date, auto-generated

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

dateCanceled:

string, Date, auto-generated

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

status:

рядок

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

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

  • claim - вимога

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

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

  • invalid - недійсно

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

  • resolved - вирішено

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

type:

рядок

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

  • claim - вимога

  • complaint - скарга

resolution:

рядок

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

resolutionType:

рядок

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

  • invalid - недійсно

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

  • resolved - вирішено

satisfied:

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

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

decision:

рядок

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

cancellationReason:
 

рядок

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

documents:

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

auctionerAction:
 

рядок

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

auctionerActionDate:
 

string, Date, auto-generated

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

Contract

Схема

id:

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

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

awardID:

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

OpenContracting Description: The Award.id against which this contract is being issued.

contractID:

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

contractNumber:

рядок

title:

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

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

description:

рядок

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

value:

Value object, auto-generated, read-only

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

items:

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

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

suppliers:

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

status:

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

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

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

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

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

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

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

period:

Period

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

dateSigned:

string, Date

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

date:

string, Date

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

documents:

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

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

Period

Схема

startDate:

string, Date

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

endDate:

string, Date

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

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

Date

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

Value

Схема

amount:

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

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

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

currency:

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

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

valueAddedTaxIncluded:
 

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

Revision

Схема

date:

string, Date

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

changes:

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

Guarantee

Схема

amount:

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

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

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

currency:

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

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

Cancellation

Схема

id:

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

reason:

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

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

status:

рядок

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

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

active:

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

documents:

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

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

date:

string, Date

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

cancellationOf:

рядок

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

  • auction

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

Схема

name:

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

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

identifier:

Identifier

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

additionalIdentifiers:
 

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

address:

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

contactPoint:

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

kind:

рядок

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

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

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

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

Завантаження документа

Всі точки входу API для завантаження документів застосовують однакові правила.

Зареєструвати завантаження документа

  1. Зареєструвати завантаження документа.

  2. Додати документ в API:

    POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
    Authorization: Basic YnJva2VyOg==
    Content-Length: 419
    Content-Type: application/json
    Host: api-sandbox.ea.openprocurement.org
    
    {
      "data": {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description",
        "title": "Notice.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=TdmyfoIiQi%2Bj2E%2B54IBcPh3YMjjAxnYE%2BWaiMKNKMdp%2Bl%2B2pLQ%2FXXdax9TBqMlUEU584ld3hjHRmYSQqiuKeDg%3D%3D",
        "format": "application/pdf",
        "documentType": "technicalSpecifications"
      }
    }
    
    
    201 Created
    Content-Type: application/json
    Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/806548dfbbbd4c64a320cd6a2493c942
    X-Content-Type-Options: nosniff
    
    {
      "data": {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:43.962162+03:00",
        "documentType": "technicalSpecifications",
        "dateModified": "2018-07-05T15:44:43.962214+03:00",
        "id": "806548dfbbbd4c64a320cd6a2493c942"
      }
    }
    
  3. Завантажити документ в document service.

Завантажити документ без реєстрації

  1. Завантажити документ без реєстрації.

  2. Додати документ в API:

    POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
    Authorization: Basic YnJva2VyOg==
    Content-Length: 419
    Content-Type: application/json
    Host: api-sandbox.ea.openprocurement.org
    
    {
      "data": {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description",
        "title": "Notice.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=TdmyfoIiQi%2Bj2E%2B54IBcPh3YMjjAxnYE%2BWaiMKNKMdp%2Bl%2B2pLQ%2FXXdax9TBqMlUEU584ld3hjHRmYSQqiuKeDg%3D%3D",
        "format": "application/pdf",
        "documentType": "technicalSpecifications"
      }
    }
    
    
    201 Created
    Content-Type: application/json
    Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/806548dfbbbd4c64a320cd6a2493c942
    X-Content-Type-Options: nosniff
    
    {
      "data": {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:43.962162+03:00",
        "documentType": "technicalSpecifications",
        "dateModified": "2018-07-05T15:44:43.962214+03:00",
        "id": "806548dfbbbd4c64a320cd6a2493c942"
      }
    }
    

Схема роботи кваліфікації

For a more detailed information see Award

digraph G {
    subgraph cluster_1 {
        node [style=filled, color=lightblue];
        edge[style=dotted];
        "pending.waiting" -> cancelled;

        node [style=filled, color=lightgrey];
        edge[style=dashed];
        "pending.verification" -> unsuccessful;
        edge[style=dashed];
        "pending.payment" -> active;
        edge[style=dashed];
        "pending.waiting" -> "pending.verification";
        label = "Awarding Process";
        color=blue
    }
        edge[style=dashed];
        "pending.verification" -> "pending.payment";
        edge[style=dashed];
        active -> unsuccessful;

}

Ролі

Organizer:

пунктирна лінія

Participant:

лінія з крапками

Опис Процедури

  1. Award’и створюються для двох учасників з найвищими валідними ставками.

  2. Award з найвищою валідною ставкою початково отримує статус pending.verification (award для другого учасника - pending.waiting). Процедура входить у фазу verificationPeriod (статус: active.qualification). Після завантаження та підтвердження протоколу Організатором, award потрібно вручну перевести в статус pending.payment. Водночас процедура входить в фазу signingPeriod (статус: active.awarded).

  3. Після отримання платежу, Організатор має перевести award в статус active.Тим самим, для цього award’у створюєьтся контракт у статусі pending і процедура входить в фазу signingPeriod (статус: active.awarded). На цьому етапі Організатор має завантажити документ та переключити котракт в статус active.

  4. Для того, щоб кваліфікувати наступного учасника, Організатор має спочатку перевести попереднього в статус unsuccessful і перевести наступний award в pending.verification.

Примітки

  1. Для того, щоб кваліфікувати учасника та не інвалідувати його ставку, його ставка має бути рівною або більшою за суму початкової ціни аукціону та мінімального кроку аукціону.
    • Якщо дві найвищі ставки не перевищують суму початкової ціни аукціону та мінімального кроку, award’и не сформуються і процедура стане “unsuccessful”.

    • Якщо друга найвища ставка є меншою за суму початкової ціни аукціону та мінімального кроку формуються два award’и, але другий award відразу переходить в статус unsuccessful. Учасник з першою найвищою ставкою, значення якої більше або рівне сумі початкової ціни аукціону та мінімального кроку, проходить процедуру кваліфікації і може виграти аукціон.

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

  3. Другий кваліфікований учасник може дискваліфікувати себе (перевести award в статус cancelled) у будь-який момент перед початком його кваліфікації.

  4. Усі статуси перемикаються автоматично. Дати початку чи кінця періоду не впливають на дії, які можуть бути виконані (завершені).

  5. Якщо Організатор передає значення у поле minNumberOfQualifiedBids: 1 і тільки один учасник підтвердив пропозицію, тоді аукціон буде пропущено і почнеться етап кваліфікації цього учасника.

Статуси

pending.waiting:
 

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

cancelled:

Термінальний статус. Учасник з другою найвищою валідною ставкою вирішив забрати свій гарантійний внесок та не чекати на дискваліфікацію учасника з найвищою ставкою.

pending.verification:
 

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

pending.payment:
 

Очікується оплата. Організатор (ліквідатор) може перевести в статус active шляхом підтвердження оплати.

active:Awaiting for the contract to be signed (uploaded and activated in the system by the organizer).
unsuccessful:Terminal status. The auction was unsuccessful. Can be switched to from any of the previous statuses by the organizer.

Туторіал

Базові правила

Подивимось як працює точка входу /auctions:

GET /api/2.4/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.4/auctions?offset=",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions?offset=",
    "offset": ""
  },
  "data": []
}

При виклику видає пустий набір.

Спробуймо створити новий аукціон:

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: api-sandbox.ea.openprocurement.org


415 Unsupported Media Type
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "status": "error",
  "errors": [
    {
      "description": "Content-Type header should be one of ['application/json']",
      "location": "header",
      "name": "Content-Type"
    }
  ]
}

Помилка вказує, що єдиний прийнятний тип вмісту це application/json.

Задовільнимо вимогу типу вмісту:

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org


422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "status": "error",
  "errors": [
    {
      "description": "Expecting value: line 1 column 1 (char 0)",
      "location": "body",
      "name": "data"
    }
  ]
}

Помилка вказує, що data не знайдено у тілі JSON.

Створення аукціону

PropertyLease procedure has a specific data structure called contractTerms.

The structure must have mandatory fields:

  • type containing the only possible value lease.
  • leaseTerms.

leaseTerms has one mandatory and two optional fields:

  • leaseDuration must contain the duration of the lease specified in ISO8601 duration [1] format.
  • In the taxHolidays field Organizer may optionally specify the tax concessions period, if granted.
  • escalationClauses define the rules for periodic monthly payment changes.

Minimal contractTerms section should look like this:

"contractTerms": {
  "type": "lease",
  "leaseTerms": {
      "leaseDuration": "P10Y",
  }
},

The other specific feature for the propertyLease procedure is an option to set tenderPeriod.endDate.

For some reason Organizer may need to have 3 working days pause between tenderPeriod.endDate and auctionPeriod.startDate.

When tenderPeriod.endDate is passed it must be set exactly 3 working days before auctionPeriod.startDate.

For any other tenderPeriod.endDate ValidationError will be raised:

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2601
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "lotIdentifier": "219560",
    "tenderPeriod": {
      "endDate": "2018-07-26T15:23:39.864267+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "conditions": "conditions description",
            "escalationPeriodicity": "P5M",
            "escalationStepPercentage": 0.1
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-08-05T15:23:39.864267+03:00"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "propertyLease",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "id": "04121000-2",
          "description": "Земельні ділянки"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "contractPeriod": {
          "startDate": "2018-07-08T15:23:39.611994",
          "endDate": "2018-07-11T15:23:39.611994"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.001
      }
    ]
  }
}


422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "status": "error",
  "errors": [
    {
      "description": "The only possible value for tenderPeriod.endDate is 2018-07-31 20:00:00+03:00",
      "location": "body",
      "name": "data"
    }
  ]
}

If tenderPeriod.endDate is not passed it will be calculated automatically as 8PM day before auctionPeriod.startDate.

Створимо аукціон з мінімально допустимим набором даних (тільки параметри обовязкові для заповнення) :

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2514
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "lotIdentifier": "219560",
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "conditions": "conditions description",
            "escalationPeriodicity": "P5M",
            "escalationStepPercentage": 0.1
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-19"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "propertyLease",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "id": "04121000-2",
          "description": "Земельні ділянки"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991",
          "endDate": "2018-07-10T15:44:36.881991"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.001
      }
    ]
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "cdfb5f6d59f74153b70113720adaba2e",
    "token": "686740317fd249638e3ee0420d268ebf"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000001",
    "enquiryPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-18T20:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker",
    "id": "bf6575a30f2c4465ae43e06981df3b5a",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-05T15:44:43.541215+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-19T00:00:00+03:00"
    },
    "procurementMethodType": "propertyLease",
    "date": "2018-07-05T15:44:43.531351+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-13T20:00:00+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "2ca4bc6c445e46459bda9c85019dcd33"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "d235e459369d465da4e7771e6573239b",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "34d79ae5dcdb4eb4b61dba5d6a4000d7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

Успіх! Тепер ми бачимо, що новий об’єкт було створено. Код відповіді 201 та заголовок відповіді Location вказує місцерозташування створеного об’єкта. Тіло відповіді показує інформацію про створений аукціон, його внутрішнє id (яке співпадає з сегментом Location), його офіційне auctionID та dateModified дату, що показує час, коли аукціон востаннє модифікувався. Зверніть увагу на procurementMethodType, а також на те, що аукціон створюється зі статусом active.tendering.

Пам’ятайте, що tenderPeriod має складати щонайменше 7 календарних днів.

Якщо у auctionPeriod.startDate передано некоректну дату, генерується помилка 422 Unprocessable Entity та у JSON відповіді повертається повідомлення “tenderPeriod should be greater than 6 days”.

Встановимо auctionPeriod.startDate у значення now + timedelta(days=6) - у відповідь ми отримаємо помилку ValidationError.

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2536
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "lotIdentifier": "219560",
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "conditions": "conditions description",
            "escalationPeriodicity": "P5M",
            "escalationStepPercentage": 0.1
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-11T15:44:37.150620+03:00"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "propertyLease",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "id": "04121000-2",
          "description": "Земельні ділянки"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991",
          "endDate": "2018-07-10T15:44:36.881991"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.001
      }
    ]
  }
}


422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "status": "error",
  "errors": [
    {
      "description": [
        "tenderPeriod should be greater than 6 days"
      ],
      "location": "body",
      "name": "tenderPeriod"
    }
  ]
}

Organizer can set rectificationPeriod.endDate. The gap between the given date and tenderPeriod.endDate should not be less than 5 working days.

If the gap between rectificationPeriod.endDate provided by Organizer and tenderPeriod.endDate is less than 5 days 422 Unprocessable Entity response will be returned with the error message ‘rectificationPeriod.endDate should be set at least 5 working days earlier than tenderPeriod.endDate.’

If Organizer does not set rectificationPeriod.endDate it will be calculated automatically as tenderPeriod.endDate minus 5 working days.

Використаємо URL створеного об’єкта (заголовок відповіді Location):

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000001",
    "enquiryPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-18T20:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker",
    "id": "bf6575a30f2c4465ae43e06981df3b5a",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-05T15:44:43.541215+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-19T00:00:00+03:00"
    },
    "procurementMethodType": "propertyLease",
    "date": "2018-07-05T15:44:43.531351+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-13T20:00:00+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "2ca4bc6c445e46459bda9c85019dcd33"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "d235e459369d465da4e7771e6573239b",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "34d79ae5dcdb4eb4b61dba5d6a4000d7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

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

Подивимось, що показує список аукціонів:

GET /api/2.4/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.4/auctions?offset=",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions?offset=",
    "offset": ""
  },
  "data": []
}

Ми бачимо внутрішнє id аукціону (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/auctions/) та його dateModified дату.

Попередній аукціон був створений лише з обов’язковими полями. Тепер додамо аукціон з максимально допустимим набором даних при створенні (аукціон повинен бути у статусі created).

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3442
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "lotIdentifier": "219560",
    "description_en": "Cases with state awards",
    "description": "футляри до державних нагород",
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "conditions": "conditions description",
            "escalationPeriodicity": "P5M",
            "escalationStepPercentage": 0.1
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-19"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "propertyLease",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "description_ru": "футляры к государственным наградам",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "title_ru": "футляры к государственным наградам",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "id": "04121000-2",
          "description": "Земельні ділянки"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "description_ru": "футляры к государственным наградам",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991",
          "endDate": "2018-07-10T15:44:36.881991"
        }
      }
    ],
    "title_en": "Cases with state awards"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/995eb51dc28c4aeaa4624b658593b117
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "e7b243a833c841c3baabe436dc79c772",
    "token": "0259f966168e46109b773d77072102db"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000003",
    "enquiryPeriod": {
      "startDate": "2018-07-05T15:44:43.654641+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-18T20:00:00+03:00",
    "awardCriteria": "highestCost",
    "owner": "broker",
    "id": "995eb51dc28c4aeaa4624b658593b117",
    "description": "футляри до державних нагород",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-19T00:00:00+03:00"
    },
    "description_ru": "футляры к государственным наградам",
    "dateModified": "2018-07-05T15:44:43.667419+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-05T15:44:43.654641+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "title_en": "Cases with state awards",
    "procurementMethodType": "propertyLease",
    "description_en": "Cases with state awards",
    "date": "2018-07-05T15:44:43.654641+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-07-05T15:44:43.654641+03:00",
      "endDate": "2018-07-13T20:00:00+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "32138c866af04bc89790cc499745b77a"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "5cc8c1ab568b4390b5c4d3505e13fa20",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "description_ru": "футляры к государственным наградам",
        "id": "c6d02d15489f406ea4214aeec4a3d374",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "title_ru": "футляры к государственным наградам",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

І знову код відповіді 201 Created, заголовок Location і тіло з додатковим id, auctionID, та властивість dateModified.

Перевіримо, що містить реєстр аукціонів:

GET /api/2.4/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.4/auctions?offset=2018-07-05T15%3A44%3A43.541215%2B03%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions?offset=2018-07-05T15%3A44%3A43.541215%2B03%3A00",
    "offset": "2018-07-05T15:44:43.541215+03:00"
  },
  "data": [
    {
      "id": "bf6575a30f2c4465ae43e06981df3b5a",
      "dateModified": "2018-07-05T15:44:43.541215+03:00"
    }
  ]
}

Дійсно, в нас зараз є дві аукціони.

Модифікація аукціону

As it has been mentioned before the propertyLease procedure has a specific data structure called contractTerms.

Organizer can edit or add these optional fields for the structure after auction is created:

"taxHolidays": [
  {
      "taxHolidaysDuration": "P5M",
      "conditions": "conditions description",
      "value": {
        "amount": 100.0,
        "currency": "UAH",
        "valueAddedTaxIncluded": true
      }
  }
],
"escalationClauses": [
  {
      "escalationPeriodicity": "P5M",
      "escalationStepPercentage": 0.55,
      "conditions": "conditions description"
  }
]

Оновимо аукціон шляхом надання йому усіх інших важливих властивостей:

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "tenderPeriod": {
      "endDate": "2018-07-20T15:44:53.747012+03:00"
    }
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000001",
    "enquiryPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-18T20:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker",
    "id": "bf6575a30f2c4465ae43e06981df3b5a",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-05T15:44:43.800011+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-19T00:00:00+03:00"
    },
    "procurementMethodType": "propertyLease",
    "date": "2018-07-05T15:44:43.531351+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-13T20:00:00+03:00",
      "invalidationDate": "2018-07-05T15:44:43.798279+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "2ca4bc6c445e46459bda9c85019dcd33"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "d235e459369d465da4e7771e6573239b",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "34d79ae5dcdb4eb4b61dba5d6a4000d7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

Ми бачимо, що додаткові властивості об’єднані з існуючими даними аукціону. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.

Ще одна перевірка списку відображає нову дату модифікації:

GET /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.4/auctions?offset=2018-07-05T15%3A44%3A43.718803%2B03%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions?offset=2018-07-05T15%3A44%3A43.718803%2B03%3A00",
    "offset": "2018-07-05T15:44:43.718803+03:00"
  },
  "data": [
    {
      "id": "bf6575a30f2c4465ae43e06981df3b5a",
      "dateModified": "2018-07-05T15:44:43.541215+03:00"
    },
    {
      "id": "995eb51dc28c4aeaa4624b658593b117",
      "dateModified": "2018-07-05T15:44:43.667419+03:00"
    },
    {
      "id": "16a15a1f4fc74bc5b37a9e2cb9669a31",
      "dateModified": "2018-07-05T15:44:43.718803+03:00"
    }
  ]
}

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

Після цього учасники можуть наново активувати власні ставки.

Organizer can edit a procedure only during rectificationPeriod.

Після закінчення цього періоду на спробу редагування буде повернуто помилку 403:

Завантаження документації

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

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 419
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=TdmyfoIiQi%2Bj2E%2B54IBcPh3YMjjAxnYE%2BWaiMKNKMdp%2Bl%2B2pLQ%2FXXdax9TBqMlUEU584ld3hjHRmYSQqiuKeDg%3D%3D",
    "format": "application/pdf",
    "documentType": "technicalSpecifications"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/806548dfbbbd4c64a320cd6a2493c942
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:43.962162+03:00",
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-05T15:44:43.962214+03:00",
    "id": "806548dfbbbd4c64a320cd6a2493c942"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/806548dfbbbd4c64a320cd6a2493c942 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:43.962162+03:00",
    "previousVersions": [],
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-05T15:44:43.962214+03:00",
    "id": "806548dfbbbd4c64a320cd6a2493c942"
  }
}

Один елемент масиву описує завантажений документ. Ми можемо завантажити більше документів:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 336
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/c62be1575beb463786d360a782b04a07?KeyID=172d32c8&Signature=laHrKHkqys3U5SL%2BkDcmHV17ZerGCFpHrnds%2FOHYIHu1UPHq855BauPd69w46aqvgmmN50wJ9cphwi9TRT3FBw%3D%3D",
    "title": "AwardCriteria.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/1ee1b150bb7c4d4197379afa2e86f40a
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/c62be1575beb463786d360a782b04a07?KeyID=172d32c8&Signature=dq9l6ox%252B9bq5wtran%2FzRS74f6mVwD%252Bmw3iST96fFDO7OkbCnzDM2GeAK%2FbePequlPdkoHeILvxVjDyjauAhdCg%253D%253D",
    "title": "AwardCriteria.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.029815+03:00",
    "dateModified": "2018-07-05T15:44:44.029835+03:00",
    "id": "1ee1b150bb7c4d4197379afa2e86f40a"
  }
}

І знову можна перевірити, що є два завантажених документа.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:43.962162+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-05T15:44:43.962214+03:00",
      "id": "806548dfbbbd4c64a320cd6a2493c942"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/c62be1575beb463786d360a782b04a07?KeyID=172d32c8&Signature=dq9l6ox%252B9bq5wtran%2FzRS74f6mVwD%252Bmw3iST96fFDO7OkbCnzDM2GeAK%2FbePequlPdkoHeILvxVjDyjauAhdCg%253D%253D",
      "title": "AwardCriteria.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.029815+03:00",
      "dateModified": "2018-07-05T15:44:44.029835+03:00",
      "id": "1ee1b150bb7c4d4197379afa2e86f40a"
    }
  ]
}

Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:

PUT /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/1ee1b150bb7c4d4197379afa2e86f40a?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 340
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=mUW9IV0tpvgHdF5RwppGUXfHGhmBxAXx76HSQMIbmjy0cFpgFcMdE5dIz%2B8%2BYHWO1Cz4OExhfcQiKR4qKIT%2FBA%3D%3D",
    "title": "AwardCriteria-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
    "title": "AwardCriteria-2.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.029815+03:00",
    "dateModified": "2018-07-05T15:44:44.085971+03:00",
    "id": "1ee1b150bb7c4d4197379afa2e86f40a"
  }
}

І ми бачимо, що вона перекриває оригінальну версію:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:43.962162+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-05T15:44:43.962214+03:00",
      "id": "806548dfbbbd4c64a320cd6a2493c942"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.029815+03:00",
      "dateModified": "2018-07-05T15:44:44.085971+03:00",
      "id": "1ee1b150bb7c4d4197379afa2e86f40a"
    }
  ]
}

Завантаження ілюстрації

Організатор може завантажити файли з ілюстраціями у створений аукціон. Завантаження повинно відповідати правилам Завантаження документа.

In order to specify illustration display order, index field can be used (for details see Document). Since this illustration should be displayed first, it has "index": 1.

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 428
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "index": 1,
    "hash": "md5:00000000000000000000000000000000",
    "description": "First illustration description",
    "title": "first_illustration.jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=7BS8Nz2Usg5ZsX12Zd442%2BWh89B1vs6tCEc36tApSLyAv7k6xnhVWXsfQj4mIgpPdgA7Ze9CEv1ESDdYtEMOCg%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/031929ac55d141b083d831f16cc9fecd
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 1,
    "hash": "md5:00000000000000000000000000000000",
    "description": "First illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=xuvepRcqmKQPNLtNMz1cmYOE8GiU%252Bf5Eh7Ams09PmLwV3CKbOWuxOxelmmExxWtkYWrdpfF70RJv8b1ltcIzAw%253D%253D",
    "title": "first_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.148863+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-05T15:44:44.148896+03:00",
    "id": "031929ac55d141b083d831f16cc9fecd"
  }
}

Ми можемо перевірити, чи завантажилась ілюстрація.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:43.962162+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-05T15:44:43.962214+03:00",
      "id": "806548dfbbbd4c64a320cd6a2493c942"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.029815+03:00",
      "dateModified": "2018-07-05T15:44:44.085971+03:00",
      "id": "1ee1b150bb7c4d4197379afa2e86f40a"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=xuvepRcqmKQPNLtNMz1cmYOE8GiU%252Bf5Eh7Ams09PmLwV3CKbOWuxOxelmmExxWtkYWrdpfF70RJv8b1ltcIzAw%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.148863+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.148896+03:00",
      "id": "031929ac55d141b083d831f16cc9fecd"
    }
  ]
}

Організатор може завантажити ще одну ілюстрацію. Ця ілюстрація повинна бути відображена другою, тому має параметр "index": 2.

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 432
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Second illustration description",
    "title": "second_illustration.jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cbeaa2c76140f8b37f0af516a23560?KeyID=172d32c8&Signature=n1wwvsam8m3UpY4IJQkadbUiud4rTmawTsi%2Bz6bpWJmeNclML2hDHM2vi9bpUjclY4qMGsWJ6RkLo%2FKWtDFjDg%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/dc25aac992074754a54e622b75ccf552
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Second illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cbeaa2c76140f8b37f0af516a23560?KeyID=172d32c8&Signature=FAkPz4qiw3ChZWW53oZeSn9ukX6GzYrNI4fClQEmgJVhGyjOqjvw0rKs3zgGYAwRg%2FpOC13F%2F6vUYQw2DAhxCw%253D%253D",
    "title": "second_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.217182+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-05T15:44:44.217203+03:00",
    "id": "dc25aac992074754a54e622b75ccf552"
  }
}

Додаємо третю ілюстрацію:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 436
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Third illustration description",
    "title": "third_illustration.jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/7a1640d5df0448cb9042c1410430a809?KeyID=172d32c8&Signature=McsENObOi5%2F%2Fr4VpcyF7Le1idsJxVyhb%2By2w7h%2Bnlrqn5M0VNACab5R5sM1bJtGjY6cnoL8iM2PmC87t%2FYCzDA%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/fbf05d710f3d4c19acd84b0f17017eea
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Third illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/7a1640d5df0448cb9042c1410430a809?KeyID=172d32c8&Signature=iY06XmBxdm5LarAm6R6Z8ggoBnSqJE0dzJ03C9WO70NZ7Yj9nibjk4RfdxC%2FKrvTfCD59I1mxLLXqFYCryXvDA%253D%253D",
    "title": "third_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.264917+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-05T15:44:44.264939+03:00",
    "id": "fbf05d710f3d4c19acd84b0f17017eea"
  }
}

Зверніть увагу, що параметр index третьої ілюстрації такий же як і у другої: "index": 2. У таких випадках спочатку відображатиметься ілюстрація з ранішою датою публікації.

Можемо перевірити, що є три завантажені ілюстрації.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:43.962162+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-05T15:44:43.962214+03:00",
      "id": "806548dfbbbd4c64a320cd6a2493c942"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.029815+03:00",
      "dateModified": "2018-07-05T15:44:44.085971+03:00",
      "id": "1ee1b150bb7c4d4197379afa2e86f40a"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=xuvepRcqmKQPNLtNMz1cmYOE8GiU%252Bf5Eh7Ams09PmLwV3CKbOWuxOxelmmExxWtkYWrdpfF70RJv8b1ltcIzAw%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.148863+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.148896+03:00",
      "id": "031929ac55d141b083d831f16cc9fecd"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Second illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cbeaa2c76140f8b37f0af516a23560?KeyID=172d32c8&Signature=FAkPz4qiw3ChZWW53oZeSn9ukX6GzYrNI4fClQEmgJVhGyjOqjvw0rKs3zgGYAwRg%2FpOC13F%2F6vUYQw2DAhxCw%253D%253D",
      "title": "second_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.217182+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.217203+03:00",
      "id": "dc25aac992074754a54e622b75ccf552"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Third illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/7a1640d5df0448cb9042c1410430a809?KeyID=172d32c8&Signature=iY06XmBxdm5LarAm6R6Z8ggoBnSqJE0dzJ03C9WO70NZ7Yj9nibjk4RfdxC%2FKrvTfCD59I1mxLLXqFYCryXvDA%253D%253D",
      "title": "third_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.264917+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.264939+03:00",
      "id": "fbf05d710f3d4c19acd84b0f17017eea"
    }
  ]
}

Add Asset Familiarization

Organizer can upload asset familiarization document into the created auction.

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 160
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "title": "Familiarization with bank asset",
    "accessDetails": "Familiar with asset: days, time, address",
    "documentType": "x_dgfAssetFamiliarization"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/f322908bc35041ca898fddc2f640e5d1
X-Content-Type-Options: nosniff

{
  "data": {
    "title": "Familiarization with bank asset",
    "format": "offline/on-site-examination",
    "accessDetails": "Familiar with asset: days, time, address",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.337012+03:00",
    "documentType": "x_dgfAssetFamiliarization",
    "dateModified": "2018-07-05T15:44:44.337032+03:00",
    "id": "f322908bc35041ca898fddc2f640e5d1"
  }
}

We can check whether asset familiarization document is added.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:43.962162+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-05T15:44:43.962214+03:00",
      "id": "806548dfbbbd4c64a320cd6a2493c942"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.029815+03:00",
      "dateModified": "2018-07-05T15:44:44.085971+03:00",
      "id": "1ee1b150bb7c4d4197379afa2e86f40a"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=xuvepRcqmKQPNLtNMz1cmYOE8GiU%252Bf5Eh7Ams09PmLwV3CKbOWuxOxelmmExxWtkYWrdpfF70RJv8b1ltcIzAw%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.148863+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.148896+03:00",
      "id": "031929ac55d141b083d831f16cc9fecd"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Second illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cbeaa2c76140f8b37f0af516a23560?KeyID=172d32c8&Signature=FAkPz4qiw3ChZWW53oZeSn9ukX6GzYrNI4fClQEmgJVhGyjOqjvw0rKs3zgGYAwRg%2FpOC13F%2F6vUYQw2DAhxCw%253D%253D",
      "title": "second_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.217182+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.217203+03:00",
      "id": "dc25aac992074754a54e622b75ccf552"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Third illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/7a1640d5df0448cb9042c1410430a809?KeyID=172d32c8&Signature=iY06XmBxdm5LarAm6R6Z8ggoBnSqJE0dzJ03C9WO70NZ7Yj9nibjk4RfdxC%2FKrvTfCD59I1mxLLXqFYCryXvDA%253D%253D",
      "title": "third_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.264917+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.264939+03:00",
      "id": "fbf05d710f3d4c19acd84b0f17017eea"
    },
    {
      "title": "Familiarization with bank asset",
      "format": "offline/on-site-examination",
      "accessDetails": "Familiar with asset: days, time, address",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.337012+03:00",
      "documentType": "x_dgfAssetFamiliarization",
      "dateModified": "2018-07-05T15:44:44.337032+03:00",
      "id": "f322908bc35041ca898fddc2f640e5d1"
    }
  ]
}

Уточнення (питання)

Коли закупівля має статус active.tendering, зацікавлені сторони можуть задавати питання:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "author": {
      "contactPoint": {
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "00137226",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "countryName": "Україна",
        "postalCode": "21100",
        "region": "м. Вінниця",
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця"
      }
    },
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/questions/7a8ea78f01b9408b9c4700de5409f22c
X-Content-Type-Options: nosniff

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "uri": "http://sch10.edu.vn.ua/",
        "id": "00137226"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "date": "2018-07-05T15:44:44.418932+03:00",
    "id": "7a8ea78f01b9408b9c4700de5409f22c",
    "questionOf": "tender"
  }
}

Організатор може на них відповісти:

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/questions/7a8ea78f01b9408b9c4700de5409f22c?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність",
    "date": "2018-07-05T15:44:44.418932+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "7a8ea78f01b9408b9c4700de5409f22c",
    "questionOf": "tender"
  }
}

Можна отримати список запитань:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "description": "Просимо додати таблицю потрібної калорійності харчування",
      "title": "Калорійність",
      "date": "2018-07-05T15:44:44.418932+03:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "id": "7a8ea78f01b9408b9c4700de5409f22c",
      "questionOf": "tender"
    }
  ]
}

або окрему відповідь:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/questions/7a8ea78f01b9408b9c4700de5409f22c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність",
    "date": "2018-07-05T15:44:44.418932+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "7a8ea78f01b9408b9c4700de5409f22c",
    "questionOf": "tender"
  }
}

Реєстрація пропозиції

Учасник може зареєструвати пропозицію у статусі draft (чернетка):

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 776
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "draft",
    "qualified": true,
    "value": {
      "amount": 500
    },
    "tenderers": [
      {
        "contactPoint": {
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ]
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a
X-Content-Type-Options: nosniff

{
  "access": {
    "token": "3d0951140fc2460d89bb86cf5134b2a2"
  },
  "data": {
    "status": "draft",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:44.764641+03:00",
    "qualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "owner": "broker",
    "id": "192d6412b08e4743b9cf6d267538c72a"
  }
}

І активувати пропозицію:

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a?acc_token=3d0951140fc2460d89bb86cf5134b2a2 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "active"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:44.764641+03:00",
    "qualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "owner": "broker",
    "id": "192d6412b08e4743b9cf6d267538c72a"
  }
}

І завантажити документ пропозиції:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents?acc_token=3d0951140fc2460d89bb86cf5134b2a2 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 329
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9133e028fcaa49c2a1a0a6f8ab88e680?KeyID=172d32c8&Signature=Q4dARTmLBpleWWIFhe6dJ5XBHi6c8Kvrg0Wq8RJ2s24OGHFMBz1dQp1SuswbNTBJBuozFBQN%2FX3ckDjg9NANAg%3D%3D",
    "title": "Proposal.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents/e6c52d6a2e19412a80e7f82233a891b3
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents/e6c52d6a2e19412a80e7f82233a891b3?download=9133e028fcaa49c2a1a0a6f8ab88e680",
    "title": "Proposal.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.918925+03:00",
    "dateModified": "2018-07-05T15:44:44.918952+03:00",
    "id": "e6c52d6a2e19412a80e7f82233a891b3"
  }
}

Можна перевірити завантажені документи:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents?acc_token=3d0951140fc2460d89bb86cf5134b2a2 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents/e6c52d6a2e19412a80e7f82233a891b3?download=9133e028fcaa49c2a1a0a6f8ab88e680",
      "title": "Proposal.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.918925+03:00",
      "dateModified": "2018-07-05T15:44:44.918952+03:00",
      "id": "e6c52d6a2e19412a80e7f82233a891b3"
    }
  ]
}

Для найкращого результату (найбільшої економії) аукціон повинен мати багато зареєстрованих учасників.

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 723
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "qualified": true,
    "value": {
      "amount": 501
    },
    "tenderers": [
      {
        "contactPoint": {
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "countryName": "Україна",
          "postalCode": "79013",
          "region": "м. Львів",
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів"
        }
      }
    ]
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/19d92b47538f4bcfb7d087eaabb84afa
X-Content-Type-Options: nosniff

{
  "access": {
    "token": "beb5b717e1644629b197f91fc2473d2a"
  },
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:45.018848+03:00",
    "qualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "м. Львів",
          "locality": "м. Львів"
        }
      }
    ],
    "owner": "broker",
    "id": "19d92b47538f4bcfb7d087eaabb84afa"
  }
}

Аукціон

Після того, як аукціон заплановано, будь-хто може його відвідати для перегляду. Аукціон можна подивитись за допомогою Auction.auctionUrl:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000001",
    "auctionUrl": "http://auction-sandbox.openprocurement.org/auctions/bf6575a30f2c4465ae43e06981df3b5a",
    "enquiryPeriod": {
      "startDate": "2018-06-28T15:44:36.881991+03:00",
      "endDate": "2018-07-05T15:44:36.881991+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-05T16:28:36.881991+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "title": "Калорійність",
        "date": "2018-07-05T15:44:44.418932+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "7a8ea78f01b9408b9c4700de5409f22c",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "id": "bf6575a30f2c4465ae43e06981df3b5a",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:43.962162+03:00",
        "documentType": "technicalSpecifications",
        "dateModified": "2018-07-05T15:44:43.962214+03:00",
        "id": "806548dfbbbd4c64a320cd6a2493c942"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/c62be1575beb463786d360a782b04a07?KeyID=172d32c8&Signature=dq9l6ox%252B9bq5wtran%2FzRS74f6mVwD%252Bmw3iST96fFDO7OkbCnzDM2GeAK%2FbePequlPdkoHeILvxVjDyjauAhdCg%253D%253D",
        "title": "AwardCriteria.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.029815+03:00",
        "dateModified": "2018-07-05T15:44:44.029835+03:00",
        "id": "1ee1b150bb7c4d4197379afa2e86f40a"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
        "title": "AwardCriteria-2.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.029815+03:00",
        "dateModified": "2018-07-05T15:44:44.085971+03:00",
        "id": "1ee1b150bb7c4d4197379afa2e86f40a"
      },
      {
        "index": 1,
        "hash": "md5:00000000000000000000000000000000",
        "description": "First illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=xuvepRcqmKQPNLtNMz1cmYOE8GiU%252Bf5Eh7Ams09PmLwV3CKbOWuxOxelmmExxWtkYWrdpfF70RJv8b1ltcIzAw%253D%253D",
        "title": "first_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.148863+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-05T15:44:44.148896+03:00",
        "id": "031929ac55d141b083d831f16cc9fecd"
      },
      {
        "index": 2,
        "hash": "md5:00000000000000000000000000000000",
        "description": "Second illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cbeaa2c76140f8b37f0af516a23560?KeyID=172d32c8&Signature=FAkPz4qiw3ChZWW53oZeSn9ukX6GzYrNI4fClQEmgJVhGyjOqjvw0rKs3zgGYAwRg%2FpOC13F%2F6vUYQw2DAhxCw%253D%253D",
        "title": "second_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.217182+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-05T15:44:44.217203+03:00",
        "id": "dc25aac992074754a54e622b75ccf552"
      },
      {
        "index": 2,
        "hash": "md5:00000000000000000000000000000000",
        "description": "Third illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/7a1640d5df0448cb9042c1410430a809?KeyID=172d32c8&Signature=iY06XmBxdm5LarAm6R6Z8ggoBnSqJE0dzJ03C9WO70NZ7Yj9nibjk4RfdxC%2FKrvTfCD59I1mxLLXqFYCryXvDA%253D%253D",
        "title": "third_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.264917+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-05T15:44:44.264939+03:00",
        "id": "fbf05d710f3d4c19acd84b0f17017eea"
      },
      {
        "title": "Familiarization with bank asset",
        "format": "offline/on-site-examination",
        "accessDetails": "Familiar with asset: days, time, address",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.337012+03:00",
        "documentType": "x_dgfAssetFamiliarization",
        "dateModified": "2018-07-05T15:44:44.337032+03:00",
        "id": "f322908bc35041ca898fddc2f640e5d1"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-05T15:44:45.260150+03:00",
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2018-06-28T15:44:36.881991+03:00",
      "endDate": "2018-07-05T15:44:36.881991+03:00"
    },
    "auctionPeriod": {
      "startDate": "2018-07-05T15:44:36.881991+03:00",
      "shouldStartAfter": "2018-07-06T00:00:00+03:00"
    },
    "procurementMethodType": "propertyLease",
    "date": "2018-07-05T15:44:43.531351+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-06-28T15:44:36.881991+03:00",
      "endDate": "2018-06-29T15:44:36.881991+03:00",
      "invalidationDate": "2018-07-05T15:44:44.337161+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "2ca4bc6c445e46459bda9c85019dcd33"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "d235e459369d465da4e7771e6573239b",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "34d79ae5dcdb4eb4b61dba5d6a4000d7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

Учасники можуть дізнатись свої URL-адреси для участі через свої пропозиції:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a?acc_token=3d0951140fc2460d89bb86cf5134b2a2 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents/e6c52d6a2e19412a80e7f82233a891b3?download=9133e028fcaa49c2a1a0a6f8ab88e680",
        "title": "Proposal.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.918925+03:00",
        "dateModified": "2018-07-05T15:44:44.918952+03:00",
        "id": "e6c52d6a2e19412a80e7f82233a891b3"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:44.764641+03:00",
    "qualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "owner": "broker",
    "id": "192d6412b08e4743b9cf6d267538c72a",
    "participationUrl": "http://auction-sandbox.openprocurement.org/auctions/bf6575a30f2c4465ae43e06981df3b5a?key_for_bid=192d6412b08e4743b9cf6d267538c72a"
  }
}

Дивіться на Bid.participationUrl у відповіді. Схожу, але іншу, URL-адресу можна отримати для інших учасників.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/19d92b47538f4bcfb7d087eaabb84afa?acc_token=beb5b717e1644629b197f91fc2473d2a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:45.018848+03:00",
    "qualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "м. Львів",
          "locality": "м. Львів"
        }
      }
    ],
    "owner": "broker",
    "id": "19d92b47538f4bcfb7d087eaabb84afa",
    "participationUrl": "http://auction-sandbox.openprocurement.org/auctions/bf6575a30f2c4465ae43e06981df3b5a?key_for_bid=19d92b47538f4bcfb7d087eaabb84afa"
  }
}

Кваліфікація

Після аукціону створюються awards:
  • перший кандидат (учасник, який поставив найвищу ставку на аукціоні) - спочатку перебуває у статусі pending.verification і очікує, поки Організатор завантажить протокол аукціону.

  • інші кандидати.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "status": "pending.verification",
      "paymentPeriod": {
        "startDate": "2018-07-05T15:44:45.557459+03:00",
        "endDate": "2018-08-02T18:00:00.557459+03:00"
      },
      "verificationPeriod": {
        "startDate": "2018-07-05T15:44:45.557459+03:00",
        "endDate": "2018-07-13T18:00:00.557459+03:00"
      },
      "signingPeriod": {
        "startDate": "2018-07-05T15:44:45.557459+03:00",
        "endDate": "2018-08-02T18:00:00.557459+03:00"
      },
      "suppliers": [
        {
          "contactPoint": {
            "email": "aagt@gmail.com",
            "telephone": "+380 (322) 91-69-30",
            "name": "Андрій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137226",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "ДКП «Книга»",
          "address": {
            "postalCode": "79013",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 34",
            "region": "м. Львів",
            "locality": "м. Львів"
          }
        }
      ],
      "complaintPeriod": {
        "startDate": "2018-07-05T15:44:45.557459+03:00"
      },
      "bid_id": "19d92b47538f4bcfb7d087eaabb84afa",
      "value": {
        "currency": "UAH",
        "amount": 501.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2018-07-05T15:44:45.557459+03:00",
      "id": "c525bd6997924149a071ab0d845875f0"
    },
    {
      "status": "pending.waiting",
      "complaintPeriod": {
        "startDate": "2018-07-05T15:44:45.557459+03:00"
      },
      "suppliers": [
        {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137256",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        }
      ],
      "bid_id": "192d6412b08e4743b9cf6d267538c72a",
      "value": {
        "currency": "UAH",
        "amount": 500.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2018-07-05T15:44:45.557459+03:00",
      "id": "94df6a7fba0e49749ed3009cf0d1feae"
    }
  ]
}

Підтвердження кваліфікації

Організатор має завантажити та підтвердити протокол аукціону auctionProtocol і додати його в award протягом 6 робочих днів після початку періоду кваліфікації. Кандидат має можливість завантажити протокол, але це є необов’язковим і недостатнім для переходу в наступний статус. Для того, щоб перевести award в наступний статус, Організатор має змінити його вручну.

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0/documents?acc_token=beb5b717e1644629b197f91fc2473d2a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 381
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/634b8812abec4bed88f99fae0b19e0ed?KeyID=172d32c8&Signature=9LMgK3YF%2FnTHNIZGC%2BdtMshvNq86dJ5RFSX1avQ9JshoQaivycbp1mfmzjpInHaG4j%2BkgktNOZHvicqnBBKrBg%3D%3D",
    "title": "SignedAuctionProtocol.pdf",
    "format": "application/pdf",
    "hash": "md5:00000000000000000000000000000000",
    "documentType": "auctionProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0/documents/045ca245f33740a7a0e0d3cea8dc7b4e
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "bid_owner",
    "title": "SignedAuctionProtocol.pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/634b8812abec4bed88f99fae0b19e0ed?KeyID=172d32c8&Signature=AM16nchbBzt03Ga62R68itoWzRR1XZean6QW6kjlgzA7kwBza3Nm%252BfNpS0P%252BgyngKTjIu5Rq3KE7jjhkYiaWCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:46.033757+03:00",
    "documentType": "auctionProtocol",
    "dateModified": "2018-07-05T15:44:46.033778+03:00",
    "id": "045ca245f33740a7a0e0d3cea8dc7b4e"
  }
}
POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 383
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/87da15a07f5e4809a4b4a2ab9c16bae1?KeyID=172d32c8&Signature=K%2BU2mnmfTeZYdv2HODx3bhN6l7o%2FPtK1qBhl742tiTFXpp42l%2BeP8yg37kxBDgZ3jAqhCWQIPgfS%2BfHwK5ZYCQ%3D%3D",
    "title": "SignedAuctionProtocol.pdf",
    "format": "application/pdf",
    "hash": "md5:00000000000000000000000000000000",
    "documentType": "auctionProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0/documents/850eff6be8de4f70922aa99415eec581
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "auction_owner",
    "title": "SignedAuctionProtocol.pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/87da15a07f5e4809a4b4a2ab9c16bae1?KeyID=172d32c8&Signature=12lOdsrwdSYqiYe%252BaDBYs444ZR61xmz2cuUwu6T6zEOWS3cBWSbgY%2FqEy5dlgw7PVR9npNInMuvdgSucfh8%252BDA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:46.170042+03:00",
    "documentType": "auctionProtocol",
    "dateModified": "2018-07-05T15:44:46.170096+03:00",
    "id": "850eff6be8de4f70922aa99415eec581"
  }
}

Обов’язком Організатора є завантаження та затвердження протоколу при тому, що award не перейде в статус ‘pending.payment’ автоматично.

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 39
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "pending.payment"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "pending.payment",
    "paymentPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-08-02T18:00:00.557459+03:00"
    },
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "bid_owner",
        "title": "SignedAuctionProtocol.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/634b8812abec4bed88f99fae0b19e0ed?KeyID=172d32c8&Signature=AM16nchbBzt03Ga62R68itoWzRR1XZean6QW6kjlgzA7kwBza3Nm%252BfNpS0P%252BgyngKTjIu5Rq3KE7jjhkYiaWCQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:46.033757+03:00",
        "documentType": "auctionProtocol",
        "dateModified": "2018-07-05T15:44:46.033778+03:00",
        "id": "045ca245f33740a7a0e0d3cea8dc7b4e"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "auction_owner",
        "title": "SignedAuctionProtocol.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/87da15a07f5e4809a4b4a2ab9c16bae1?KeyID=172d32c8&Signature=12lOdsrwdSYqiYe%252BaDBYs444ZR61xmz2cuUwu6T6zEOWS3cBWSbgY%2FqEy5dlgw7PVR9npNInMuvdgSucfh8%252BDA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:46.170042+03:00",
        "documentType": "auctionProtocol",
        "dateModified": "2018-07-05T15:44:46.170096+03:00",
        "id": "850eff6be8de4f70922aa99415eec581"
      }
    ],
    "verificationPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-07-05T15:44:46.310338+03:00"
    },
    "complaintPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "м. Львів",
          "locality": "м. Львів"
        }
      }
    ],
    "signingPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-08-02T18:00:00.557459+03:00"
    },
    "bid_id": "19d92b47538f4bcfb7d087eaabb84afa",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:46.317584+03:00",
    "id": "c525bd6997924149a071ab0d845875f0"
  }
}

Протягом 20 робочих днів після оголошення учасника кандидатом він/вона має провести оплату й Організатор має підтвердити оплату. Коли платіж отримано, Організатор може перевести award в статус active, але ця дія не є обов’язковою.

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "active"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "paymentPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-07-05T15:44:46.426889+03:00"
    },
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "bid_owner",
        "title": "SignedAuctionProtocol.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/634b8812abec4bed88f99fae0b19e0ed?KeyID=172d32c8&Signature=AM16nchbBzt03Ga62R68itoWzRR1XZean6QW6kjlgzA7kwBza3Nm%252BfNpS0P%252BgyngKTjIu5Rq3KE7jjhkYiaWCQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:46.033757+03:00",
        "documentType": "auctionProtocol",
        "dateModified": "2018-07-05T15:44:46.033778+03:00",
        "id": "045ca245f33740a7a0e0d3cea8dc7b4e"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "auction_owner",
        "title": "SignedAuctionProtocol.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/87da15a07f5e4809a4b4a2ab9c16bae1?KeyID=172d32c8&Signature=12lOdsrwdSYqiYe%252BaDBYs444ZR61xmz2cuUwu6T6zEOWS3cBWSbgY%2FqEy5dlgw7PVR9npNInMuvdgSucfh8%252BDA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:46.170042+03:00",
        "documentType": "auctionProtocol",
        "dateModified": "2018-07-05T15:44:46.170096+03:00",
        "id": "850eff6be8de4f70922aa99415eec581"
      }
    ],
    "verificationPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-07-05T15:44:46.310338+03:00"
    },
    "complaintPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-07-05T15:44:46.426889+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "м. Львів",
          "locality": "м. Львів"
        }
      }
    ],
    "signingPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-08-02T18:00:00.557459+03:00"
    },
    "bid_id": "19d92b47538f4bcfb7d087eaabb84afa",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:46.433858+03:00",
    "id": "c525bd6997924149a071ab0d845875f0"
  }
}

Дискваліфікація кандидата

У випадаку ручної дискваліфікації, Організатор має завантажити документ з причинами:

POST /api/2.3/auctions/9ccb1169681a4b9a814a70faa17b1d96/awards/d8337e5253024539ad07414008d58913/documents?acc_token=ebb7d8c3a9bb49628b630721b2ff2fee HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 386
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b4b306e1106b4bfa9c94727106b0bf6e?KeyID=abd28e21&Signature=ri55p6U9BbZIaDsRALjXGihRUGfb7%2BDQJPiv7GjLpfOQRqR2xUQ%2B3gYD8sgnQGJXevhGM6B877t0lFe%2BuqZXDw%3D%3D",
    "title": "Disqualified_reason.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "description": "Disqualification reason",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/9ccb1169681a4b9a814a70faa17b1d96/awards/d8337e5253024539ad07414008d58913/documents/79ac5290dfb94bd0bedeebbf92201e14

{
  "data": {
    "dateModified": "2017-11-30T16:56:22.626178+02:00",
    "hash": "md5:00000000000000000000000000000000",
    "description": "Disqualification reason",
    "author": "auction_owner",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b4b306e1106b4bfa9c94727106b0bf6e?KeyID=abd28e21&Signature=KwbVPZXVni%252B%2FUN0hhgWEjKSV8ZFB4hmlD%252BfYQrN7Iwd6WEv7elzrwbEzDIV97WLu%252BNJPOKJgmFrN1Gpkrx6xDA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:22.626152+02:00",
    "title": "Disqualified_reason.pdf",
    "id": "79ac5290dfb94bd0bedeebbf92201e14"
  }
}

Та дискваліфікувати кандидата:

PATCH /api/2.3/auctions/9ccb1169681a4b9a814a70faa17b1d96/awards/d8337e5253024539ad07414008d58913?acc_token=ebb7d8c3a9bb49628b630721b2ff2fee HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 146
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "unsuccessful",
    "description": "Candidate didn’t sign the auction protocol in 3 business days",
    "title": "Disqualified"
  }
}


200 OK
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/9ccb1169681a4b9a814a70faa17b1d96/awards/00fb536c33254038ae8034d3e10a6ee8

{
  "data": {
    "status": "unsuccessful",
    "paymentPeriod": {
      "startDate": "2017-11-30T16:56:22.318120+02:00",
      "endDate": "2017-11-30T16:56:22.787355+02:00"
    },
    "documents": [
      {
        "dateModified": "2017-11-30T16:56:22.492463+02:00",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/c93c3c57873e4c39b205730e7168c9a7?KeyID=abd28e21&Signature=h5sEpdO0WwgNvLznoP73EevycNuLkysJ5fCrl5di6ZItM2rmLGrMYQSN6Lxu%252BdT9VNI1SXrim1MLa9%2F050blAw%253D%253D",
        "author": "bid_owner",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:22.492435+02:00",
        "documentType": "auctionProtocol",
        "title": "auction_protocol.pdf",
        "id": "4fee5118ccf84458833fb9f9bcc0e09e"
      },
      {
        "dateModified": "2017-11-30T16:56:22.626178+02:00",
        "hash": "md5:00000000000000000000000000000000",
        "description": "Disqualification reason",
        "author": "auction_owner",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b4b306e1106b4bfa9c94727106b0bf6e?KeyID=abd28e21&Signature=KwbVPZXVni%252B%2FUN0hhgWEjKSV8ZFB4hmlD%252BfYQrN7Iwd6WEv7elzrwbEzDIV97WLu%252BNJPOKJgmFrN1Gpkrx6xDA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:22.626152+02:00",
        "title": "Disqualified_reason.pdf",
        "id": "79ac5290dfb94bd0bedeebbf92201e14"
      }
    ],
    "verificationPeriod": {
      "startDate": "2017-11-30T16:56:22.318120+02:00",
      "endDate": "2017-11-30T16:56:22.787355+02:00"
    },
    "description": "Candidate didn’t sign the auction protocol in 3 business days",
    "title": "Disqualified",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "complaintPeriod": {
      "startDate": "2017-11-30T16:56:21.878582+02:00",
      "endDate": "2017-11-30T16:56:22.787355+02:00"
    },
    "bid_id": "0bf6b005db2a4069898facc0892d3701",
    "value": {
      "currency": "UAH",
      "amount": 475.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:22.796624+02:00",
    "id": "d8337e5253024539ad07414008d58913",
    "signingPeriod": {
      "startDate": "2017-11-30T16:56:22.318120+02:00",
      "endDate": "2017-11-30T16:56:22.787355+02:00"
    }
  }
}

Через 20 робочих днів після того, як став кандидатом, новий кандидат має підтвердити кваліфікацію за допомогою кроків, описаних вище (Кваліфікація).

Відмова очікування іншого учасника

Решта кандидатів можуть відомовитись чекати на дискваліфікацію першого кандидата:

PATCH /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/awards/14f4c1774be847098f247565c4871574?acc_token=a94a2b6627aa46f3bbb83ff885e3beae HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "cancelled"
  }
}


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": {
    "status": "cancelled",
    "complaintPeriod": {
      "startDate": "2017-11-30T16:56:27.695166+02:00",
      "endDate": "2017-11-30T16:56:27.920508+02:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "bid_id": "afaa508128da4829b9202fe300965bf4",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:27.927179+02:00",
    "id": "14f4c1774be847098f247565c4871574"
  }
}

Підписання угоди

The candidate has 20 business days after becoming a candidate to conclude a contract with the bank based on the results of electronic auction. When the organizer confirms that the payment has been received, the award may be switched to the active status, while the procedure moves to the status signingPeriod. Within this stage the organizer should upload and activate the contract in the system.

Завантаження документів щодо укладання угоди

Спробуємо завантажити документ пов’язаний з угодою:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 351
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9b917efd600c445fad8457fd30f5cc5b?KeyID=172d32c8&Signature=4CcD6OI2rjqfEBygj%2BOhQTtr5TX4kFEtbM7W7Aq0LHcKfRU2DlBffBtG%2BsmrmBWC2SJosEt1dlExN%2BuzX5lwAg%3D%3D",
    "title": "contract_first_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents/962a2dccfd3248178dba9a291dfae225
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9b917efd600c445fad8457fd30f5cc5b?KeyID=172d32c8&Signature=d4SD5yjKKpZpExDc%2Fngc5rgeUSnIs1YOHk1gBD%2F0ndHMuBDR5t0PKoezrR7km0HjeOBcStVCrTJsOUoxoAerDA%253D%253D",
    "title": "contract_first_document.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:46.883617+03:00",
    "dateModified": "2018-07-05T15:44:46.883639+03:00",
    "id": "962a2dccfd3248178dba9a291dfae225"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ додано.

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

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9b917efd600c445fad8457fd30f5cc5b?KeyID=172d32c8&Signature=d4SD5yjKKpZpExDc%2Fngc5rgeUSnIs1YOHk1gBD%2F0ndHMuBDR5t0PKoezrR7km0HjeOBcStVCrTJsOUoxoAerDA%253D%253D",
      "title": "contract_first_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:46.883617+03:00",
      "dateModified": "2018-07-05T15:44:46.883639+03:00",
      "id": "962a2dccfd3248178dba9a291dfae225"
    }
  ]
}

Тепер спробуємо додати ще один документ щодо укладанням угоди:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 352
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/969aa13f4a1c435ab43c7b427af92ab3?KeyID=172d32c8&Signature=Fm5eXcIK3Pn6%2F5o7xtk%2Fb67sfaVNXUYwZQ5KwoxsPbZMzFUOPC0x1Kp5%2FcLbk5YIfoAD5oCUDUgb81x6HvpgDg%3D%3D",
    "title": "contract_second_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents/7ddd64f00176447f9efe57751f7361fe
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/969aa13f4a1c435ab43c7b427af92ab3?KeyID=172d32c8&Signature=0iJX1gukI8TnCgWs%2FyLb%2FB%2F7%252BKDkJPwE0sJP7On10lxJ4oMN0jcmu7yPIVq1PhTZzNOyjOmgB24pfQnDjtT9CQ%253D%253D",
    "title": "contract_second_document.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:47.054363+03:00",
    "dateModified": "2018-07-05T15:44:47.054390+03:00",
    "id": "7ddd64f00176447f9efe57751f7361fe"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що ще один документ було додано.

Тепер переглянемо знову усі документи пов’язані із укладанням угоди:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9b917efd600c445fad8457fd30f5cc5b?KeyID=172d32c8&Signature=d4SD5yjKKpZpExDc%2Fngc5rgeUSnIs1YOHk1gBD%2F0ndHMuBDR5t0PKoezrR7km0HjeOBcStVCrTJsOUoxoAerDA%253D%253D",
      "title": "contract_first_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:46.883617+03:00",
      "dateModified": "2018-07-05T15:44:46.883639+03:00",
      "id": "962a2dccfd3248178dba9a291dfae225"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/969aa13f4a1c435ab43c7b427af92ab3?KeyID=172d32c8&Signature=0iJX1gukI8TnCgWs%2FyLb%2FB%2F7%252BKDkJPwE0sJP7On10lxJ4oMN0jcmu7yPIVq1PhTZzNOyjOmgB24pfQnDjtT9CQ%253D%253D",
      "title": "contract_second_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:47.054363+03:00",
      "dateModified": "2018-07-05T15:44:47.054390+03:00",
      "id": "7ddd64f00176447f9efe57751f7361fe"
    }
  ]
}

Реєстрація угоди

Є можливість встановити дату підписання договору. Якщо дата не встановлена, то вона буде згенерована під час реєстрації угоди. Ви можете зареєструвати угоду:

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 80
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "active",
    "dateSigned": "2018-07-05T15:44:47.244215+03:00"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9b917efd600c445fad8457fd30f5cc5b?KeyID=172d32c8&Signature=d4SD5yjKKpZpExDc%2Fngc5rgeUSnIs1YOHk1gBD%2F0ndHMuBDR5t0PKoezrR7km0HjeOBcStVCrTJsOUoxoAerDA%253D%253D",
        "title": "contract_first_document.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:46.883617+03:00",
        "dateModified": "2018-07-05T15:44:46.883639+03:00",
        "id": "962a2dccfd3248178dba9a291dfae225"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/969aa13f4a1c435ab43c7b427af92ab3?KeyID=172d32c8&Signature=0iJX1gukI8TnCgWs%2FyLb%2FB%2F7%252BKDkJPwE0sJP7On10lxJ4oMN0jcmu7yPIVq1PhTZzNOyjOmgB24pfQnDjtT9CQ%253D%253D",
        "title": "contract_second_document.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:47.054363+03:00",
        "dateModified": "2018-07-05T15:44:47.054390+03:00",
        "id": "7ddd64f00176447f9efe57751f7361fe"
      }
    ],
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "34d79ae5dcdb4eb4b61dba5d6a4000d7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "м. Львів",
          "locality": "м. Львів"
        }
      }
    ],
    "period": {
      "startDate": "2018-07-05T15:44:37.150620+03:00",
      "endDate": "2019-07-05T15:44:37.150620+03:00"
    },
    "dateSigned": "2018-07-05T15:44:47.244215+03:00",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:47.325639+03:00",
    "awardID": "c525bd6997924149a071ab0d845875f0",
    "id": "bf54ce84c6e6418382f49614f55d0101",
    "contractID": "UA-EA-2018-07-05-000001-1"
  }
}

Скасування закупівлі

Організатор може скасувати аукціон будь-коли (крім тих випадків, коли аукціон перебуває в термінальному статусі, наприклад, unsuccesfull, canceled, complete).

Для цього потрібно виконати наступні кроки:

  1. Приготуйте запит на скасування.

  2. Наповніть його протоколом про причини скасування.

  3. Скасуйте закупівлю через подані причини

Запит на скасування, який не пройшов активації (3-й крок), не матиме сили, тобто, для скасування закупівлі буде обов’язковим не тільки створити заявку, але і активувати її.

Див. структуру запиту Cancellation для більш детальної інформації.

Формування запиту на скасування

Ви повинні передати змінні reason, status у стані pending. id генерується автоматично і повертається у додатковому заголовку відповіді Location:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "reason": "cancellation reason"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e
X-Content-Type-Options: nosniff

{
  "data": {
    "date": "2018-07-05T15:44:47.497188+03:00",
    "status": "pending",
    "reason": "cancellation reason",
    "cancellationOf": "tender",
    "id": "85e3350a80ab47548c6933c01fe8b85e"
  }
}

Наповнення протоколом та іншою супровідною документацією

Завантаження вмісту файлу:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 333
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/ff97e1247a614c048b4fb5527ea5b9f1?KeyID=172d32c8&Signature=ttHuFDrv1a%2BAJElzbJM3%2FWjwTf0GnmMZ9GJCsjtZLT%2BOimzTmi0duq%2BcJdsRM0T91kxSEo2yk2DF70hl6WuJAw%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e/documents/c4eb9970b6694811bb16c782ca84b967
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/ff97e1247a614c048b4fb5527ea5b9f1?KeyID=172d32c8&Signature=YkZ8ZOqiheBFefmKSj56cJdeq7CD4OaAzCaSiQn13dny%2FeYiS9ls2WqVvIX5qAV4DUgoej8pUUr5oI4L8DD8Cw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:47.635718+03:00",
    "dateModified": "2018-07-05T15:44:47.635740+03:00",
    "id": "c4eb9970b6694811bb16c782ca84b967"
  }
}

Зміна опису документа та інших властивостей:

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e/documents/c4eb9970b6694811bb16c782ca84b967?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 48
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "description": "Changed description"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/ff97e1247a614c048b4fb5527ea5b9f1?KeyID=172d32c8&Signature=YkZ8ZOqiheBFefmKSj56cJdeq7CD4OaAzCaSiQn13dny%2FeYiS9ls2WqVvIX5qAV4DUgoej8pUUr5oI4L8DD8Cw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:47.635718+03:00",
    "dateModified": "2018-07-05T15:44:47.635740+03:00",
    "id": "c4eb9970b6694811bb16c782ca84b967"
  }
}

Завантаження нової версії документа:

PUT /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e/documents/c4eb9970b6694811bb16c782ca84b967?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 331
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a9c682c7a1247409b01e5df7baa67e6?KeyID=172d32c8&Signature=GKgfs1Zu%2BpJm4hfO83c21wmQAvJo5mpcat7769QW1ZCddLq8MtAuqogldtj8P%2F0YubAilfzrvvwVUfjSCuGLBA%3D%3D",
    "title": "Notice-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a9c682c7a1247409b01e5df7baa67e6?KeyID=172d32c8&Signature=QMKBUG9URxfQnxjPVz00I7zJwZljZ2HV%2F5hh9uYg4cg7kmVCpvWKIQ%252Bf1bPSuVgzflIci5Z93BnbFGI7jXVhAg%253D%253D",
    "title": "Notice-2.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:47.635718+03:00",
    "dateModified": "2018-07-05T15:44:47.965256+03:00",
    "id": "c4eb9970b6694811bb16c782ca84b967"
  }
}

Активація запиту та скасування аукціону

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "active"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/ff97e1247a614c048b4fb5527ea5b9f1?KeyID=172d32c8&Signature=YkZ8ZOqiheBFefmKSj56cJdeq7CD4OaAzCaSiQn13dny%2FeYiS9ls2WqVvIX5qAV4DUgoej8pUUr5oI4L8DD8Cw%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:47.635718+03:00",
        "dateModified": "2018-07-05T15:44:47.635740+03:00",
        "id": "c4eb9970b6694811bb16c782ca84b967"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a9c682c7a1247409b01e5df7baa67e6?KeyID=172d32c8&Signature=QMKBUG9URxfQnxjPVz00I7zJwZljZ2HV%2F5hh9uYg4cg7kmVCpvWKIQ%252Bf1bPSuVgzflIci5Z93BnbFGI7jXVhAg%253D%253D",
        "title": "Notice-2.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:47.635718+03:00",
        "dateModified": "2018-07-05T15:44:47.965256+03:00",
        "id": "c4eb9970b6694811bb16c782ca84b967"
      }
    ],
    "reason": "cancellation reason",
    "date": "2018-07-05T15:44:48.136682+03:00",
    "cancellationOf": "tender",
    "id": "85e3350a80ab47548c6933c01fe8b85e"
  }
}

Двофазний коміт

Створення закупівлі за допомогою двофазного коміта

Створимо аукціон у статусі draft:

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2533
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "draft",
    "lotIdentifier": "219560",
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "conditions": "conditions description",
            "escalationPeriodicity": "P5M",
            "escalationStepPercentage": 0.1
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-19"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "propertyLease",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "id": "04121000-2",
          "description": "Земельні ділянки"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991",
          "endDate": "2018-07-10T15:44:36.881991"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.001
      }
    ]
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/ebc61cd1b78d417997d967283cdb2b3d
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "ac6c665a7a9a43d08df55e17386b3ddb",
    "token": "3b1440659d9e444dbb274a8b875e4152"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000001",
    "rectificationPeriod": {
      "startDate": "2018-07-05T15:44:39.495574+03:00",
      "endDate": "2018-07-13T20:00:00+03:00"
    },
    "tenderPeriod": {
      "startDate": "2018-07-05T15:44:39.495574+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "79ddb6409d8e4319901d7ad507607908"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "ca5a84973c38413a985e8cf36d496d2d",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "enquiryPeriod": {
      "startDate": "2018-07-05T15:44:39.495574+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "propertyLease",
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "owner": "broker",
    "lotIdentifier": "219560",
    "status": "draft",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "f94b10c6ace540dd946701ddc06d63fc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "date": "2018-07-05T15:44:39.495574+03:00",
    "dateModified": "2018-07-05T15:44:39.505312+03:00",
    "id": "ebc61cd1b78d417997d967283cdb2b3d",
    "awardCriteria": "highestCost"
  }
}

Переключимо у статус active.tendering:

PATCH /api/2.4/auctions/ebc61cd1b78d417997d967283cdb2b3d?acc_token=3b1440659d9e444dbb274a8b875e4152 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 40
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "active.tendering"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000001",
    "enquiryPeriod": {
      "startDate": "2018-07-05T15:44:39.495574+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-18T20:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker",
    "id": "ebc61cd1b78d417997d967283cdb2b3d",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-05T15:44:39.553766+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-05T15:44:39.495574+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-19T00:00:00+03:00"
    },
    "procurementMethodType": "propertyLease",
    "date": "2018-07-05T15:44:39.553766+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-07-05T15:44:39.495574+03:00",
      "endDate": "2018-07-13T20:00:00+03:00",
      "invalidationDate": "2018-07-05T15:44:39.551607+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "79ddb6409d8e4319901d7ad507607908"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "ca5a84973c38413a985e8cf36d496d2d",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "f94b10c6ace540dd946701ddc06d63fc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

Режим прискорення в пісочниці

Якщо хочете почати експериментувати з аукціонами, використовуйте режим прискорення. Також рекомендуємо починати заголовок таких аукціонів з “ТЕСТУВАННЯ”.

Для зменшення термінів і забезпечення можливості тестування dgfOtherAssets процедури на пісочниці доступний режим прискорення.

Щоб увімкнути режим прискорення вам потрібно:
  • додати додатковий параметр mode зі значенням test;

  • встановити текстове значення quick, accelerator=1440 параметру procurementMethodDetails. Цей параметр пришвидшить проходження періодів аукціону. Число 1440 показує, що часові обмеження та терміни скорочуються в 1440 раз.

  • встановити значення quick для параметра submissionMethodDetails. Цей параметр працює тільки з mode зі значенням test і пришвидшує дату початку аукціону.

Даний механізм діє лише на пісочниці.

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2552
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "lotIdentifier": "219560",
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "conditions": "conditions description",
            "escalationPeriodicity": "P5M",
            "escalationStepPercentage": 0.1
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-17T15:44:37.150620+03:00"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "propertyLease",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "id": "04121000-2",
          "description": "Земельні ділянки"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991",
          "endDate": "2018-07-10T15:44:36.881991"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.001
      }
    ],
    "mode": "test"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/6ea97f1e851943f8bfd174381fc1deb3
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "2b94cb50e1144370af11c7a8fa287075",
    "token": "706b59321ec64d57964a2f21fde4f5de"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000001",
    "enquiryPeriod": {
      "startDate": "2018-07-05T15:44:40.361611+03:00",
      "endDate": "2018-07-16T20:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-16T20:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker",
    "title_en": "[TESTING] ",
    "id": "6ea97f1e851943f8bfd174381fc1deb3",
    "title": "[ТЕСТУВАННЯ] футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-05T15:44:40.372647+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-05T15:44:40.361611+03:00",
      "endDate": "2018-07-16T20:00:00+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-17T00:00:00+03:00"
    },
    "procurementMethodType": "propertyLease",
    "date": "2018-07-05T15:44:40.361611+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-07-05T15:44:40.361611+03:00",
      "endDate": "2018-07-11T20:00:00+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "8e7b12ee3c444f46af72606c4d10b2ab"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "abb5892c185c4994bf7f5404310f9337",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "74682b00914943b6a8c1145e455e9d75",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "mode": "test",
    "title_ru": "[ТЕСТИРОВАНИЕ] ",
    "awardCriteria": "highestCost"
  }
}

Синхронізація

  • При звичайній синхронізації аукціонів через /auctions тестових тендерів “не видно”.

  • Щоб отримати тестові аукціони, треба робити синхронізацію наступним чином через /auctions?mode=test.

  • Якщо синхронізуватися через /auctions?mode=all, то будуть віддаватися всі аукціони.

  • Режим аукціону можна встановити тільки при створенні аукціона і не можна його змінити потім.

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