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

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

Зміст:

Огляд

openprocurement.auctions.dgf містить документацію по аукціонах Фонду гарантування вкладів.

Є дві процедури:

  • dgfOtherAssets - продаж майна банків, що ліквідуються.

  • dgfFinancialAssets - продаж права вимоги за кредитними договорами.

Особливості

  • Організатор може передати тільки дату початку аукціону Tender.auctionPeriod.startDate. Всі решта дати будуть обраховані на її основі.

  • Також додатково Організатор має можливість встановити enquiryPeriod.endDate.

  • Якщо enquiryPeriod.endDate не передано, ця дата встановлюється автоматично.

  • Організатор може як зменшувати, так і збільшувати value.amount, guarantee.amount, minimalStep.amount.

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

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

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

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

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

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

  • Обов’язкова кваліфікація учасника (Bid.selfQualified) через гарантійний платіж.

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

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

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

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

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

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

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

Основні задачі

Бізнес логіка

Стан проекту

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

Репозиторій джерельних текстів цього проекту є на GitHub.

Повідомляйте про всі проблеми та поради через issue tracker (реєстрація на GitHub обов’язкова).

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

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

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

0.1

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

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

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

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

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

Auction

Схема

title:

string, multilingual, read-only, editable during enquiryPeriod

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

description:

string, multilingual, editable during enquiryPeriod

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

auctionID:

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

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

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

dgfID:

string, editable during enquiryPeriod

Номер аукціону (або лота) у XLS Фонду Гарантування.

procuringEntity:
 

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

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

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

value:

Value, required, editable during enquiryPeriod

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

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

guarantee:

Guarantee, editable during enquiryPeriod

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

items:

list of Item objects, required, editable during enquiryPeriod

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

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

features:

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

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

documents:

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

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

questions:

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

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

complaints:

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

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

bids:

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

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

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

minNumberOfQualifiedBids:
 

integer, optional

The field that indicates the minimal number of qualified bids. The possible values for the field are 1 or 2.

In case of the field has been remained blank, the workflow will be similar to the auction with 2 bids.

You can also fill in the field, assigning the value “1”. This will show that the only one bidder is needed for the procedure to be successful. Therewith the auction is omitted and that bid turns to a qualified award.

minimalStep:

Value, required, editable during enquiryPeriod

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

  • 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:

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

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

eligibilityCriteria:
 

рядок, лише для читання

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

Це поле багатомовне:

  • За замовчуванням українською мовою - До участі допускаються лише ліцензовані фінансові установи.

  • eligibilityCriteria_ru (російською) - К участию допускаются только лицензированные финансовые учреждения.

  • eligibilityCriteria_en (англійською) - Only licensed financial institutions are eligible to participate.

cancellations:

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

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

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

revisions:

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

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

Organization

Схема

name:

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

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

identifier:

Identifier

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

additionalIdentifiers:
 

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

address:

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

contactPoint:

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

Identifier

Схема

scheme:

рядок

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

id:

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

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

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

legalName:

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

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

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

uri:

uri

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

Address

Схема

streetAddress:

рядок

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

locality:

рядок

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

region:

рядок

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

postalCode:

рядок

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

countryName:

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

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

ContactPoint

Схема

name:

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

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

email:

email

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

telephone:

рядок

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

faxNumber:

рядок

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

url:

URL-адреса

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

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

Item

Схема

id:

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

description:

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

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

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

classification:

Classification

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

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

additionalClassifications:
 

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

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

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

unit:

Unit

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

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:

рядок

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

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

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

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

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

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

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

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

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

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

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

  • virtualDataRoom - Віртуальна кімната для роботи з конфіденційними даними (доступно лише для dgfFinancialAssets процедури, див. Фін. туторіал)

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

  • x_dgfAssetFamiliarization - Asset Familiarization

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

  • x_presentation - Presentation

    Presentation about an asset that is being sold.

  • x_nda - Non-disclosure Agreement (NDA)

    A non-disclosure agreement between a participant and a bank/Deposit Guarantee Fund.

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

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

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

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

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

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

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

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

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

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

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

  • financialLicense - Ліцензія (доступно лише для dgfFinancialAssets процедури, див. Фін. туторіал)

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

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

title:

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

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

description:

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

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

index:

ціле число

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

format:

рядок

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

url:

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

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

datePublished:

рядок, Date

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

dateModified:

рядок, Date

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

language:

рядок

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

documentOf:

рядок

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

  • auction
  • item
relatedItem:

рядок

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

accessDetails:

рядок

Required for x_dgfAssetFamiliarization document.

Bid

Схема

tenderers:

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

date:

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

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

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:

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

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

answer:

рядок

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

questionOf:

рядок

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

  • auction
  • item
relatedItem:

рядок

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

Complaint

Схема

id:

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

author:

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

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

title:

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

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

description:

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

date:

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

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

dateSubmitted:

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

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

dateAnswered:

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

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

dateEscalated:

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

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

dateDecision:

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

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

dateCanceled:

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

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

status:

рядок

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

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

  • claim - вимога

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

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

  • invalid - недійсно

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

  • resolved - вирішено

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

type:

рядок

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

  • claim - вимога

  • complaint - скарга

resolution:

рядок

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

resolutionType:

рядок

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

  • invalid - недійсно

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

  • resolved - вирішено

satisfied:

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

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

decision:

рядок

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

cancellationReason:
 

рядок

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

documents:

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

auctionerAction:
 

рядок

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

auctionerActionDate:
 

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

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

Contract

Схема

id:

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

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

awardID:

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

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

contractID:

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

contractNumber:

рядок

title:

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

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

description:

рядок

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

value:

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

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

items:

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

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

suppliers:

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

status:

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

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

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

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

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

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

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

period:

Period

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

dateSigned:

рядок, Date

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

date:

рядок, Date

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

documents:

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

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

Period

Схема

startDate:

рядок, Date

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

endDate:

рядок, Date

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

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

Date

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

Value

Схема

amount:

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

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

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

currency:

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

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

valueAddedTaxIncluded:
 

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

Revision

Схема

date:

рядок, Date

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

changes:

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

Guarantee

Схема

amount:

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

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

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

currency:

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

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

Cancellation

Схема

id:

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

reason:

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

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

status:

рядок

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

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

active:

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

documents:

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

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

date:

рядок, Date

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

cancellationOf:

рядок

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

  • auction

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

Схема

name:

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

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

identifier:

Identifier

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

additionalIdentifiers:
 

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

address:

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

contactPoint:

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

kind:

рядок

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

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

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

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

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

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

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

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

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

    POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 HTTP/1.0
    Authorization: Basic YnJva2VyOg==
    Content-Length: 415
    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/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=P1G3pRNxZchhK%2FgkOzQoI4eQtwB%2BhjrtHZpWFS4DHIsNZke%2BhlU%2Fckb5vkmRwzqcg96vsSluTsCXIfg4TWd6Bg%3D%3D",
        "format": "application/pdf",
        "documentType": "technicalSpecifications"
      }
    }
    
    
    201 Created
    Content-Type: application/json; charset=UTF-8
    Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/418d8f99150a4b92a57b81cc18cd968a
    
    {
      "data": {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:26.092186+02:00",
        "documentType": "technicalSpecifications",
        "dateModified": "2017-11-30T16:56:26.092222+02:00",
        "id": "418d8f99150a4b92a57b81cc18cd968a"
      }
    }
    
  3. Завантажити документ в document service.

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

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

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

    POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 HTTP/1.0
    Authorization: Basic YnJva2VyOg==
    Content-Length: 415
    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/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=P1G3pRNxZchhK%2FgkOzQoI4eQtwB%2BhjrtHZpWFS4DHIsNZke%2BhlU%2Fckb5vkmRwzqcg96vsSluTsCXIfg4TWd6Bg%3D%3D",
        "format": "application/pdf",
        "documentType": "technicalSpecifications"
      }
    }
    
    
    201 Created
    Content-Type: application/json; charset=UTF-8
    Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/418d8f99150a4b92a57b81cc18cd968a
    
    {
      "data": {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:26.092186+02:00",
        "documentType": "technicalSpecifications",
        "dateModified": "2017-11-30T16:56:26.092222+02:00",
        "id": "418d8f99150a4b92a57b81cc18cd968a"
      }
    }
    

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

Для більш детальної інформації зверніться до секції 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.3/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

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

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

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

POST /api/2.3/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; charset=UTF-8

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

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

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

POST /api/2.3/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; charset=UTF-8

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

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

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

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

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

{
  "data": {
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "procurementMethodDetails": "quick, accelerator=1440",
    "tenderAttempts": 1,
    "procurementMethodType": "dgfOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "dgfID": "219560",
    "auctionPeriod": {
      "startDate": "2017-12-14"
    },
    "items": [
      {
        "classification": {
          "scheme": "CPV",
          "id": "66113000-5",
          "description": "Земельні ділянки"
        },
        "quantity": 5,
        "description": "Земля для військовослужбовців",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        }
      }
    ],
    "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": "м. Київ"
      }
    }
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae

{
  "access": {
    "token": "ccf4d45ff9524ec9ae87f38c43d7b0a3"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-PS-2017-11-30-000001",
    "enquiryPeriod": {
      "startDate": "2017-11-30T16:56:25.617199+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-12-13T23:59:50+02: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": "301d66e275cb4861ba502c1eaafa88ae",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2017-11-30T16:56:25.621767+02:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-11-30T16:56:25.617199+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-12-14T00:00:00+02:00"
    },
    "procurementMethodType": "dgfOtherAssets",
    "dgfID": "219560",
    "date": "2017-11-30T16:56:25.617199+02:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CPV",
          "description": "Земельні ділянки",
          "id": "66113000-5"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "6abd12c929084367ac08d9d9138ccab4",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "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.3/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2037
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2017-09-02T15:56:30.045984"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "dgfOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "dgfID": "219560",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CPV",
          "id": "66113000-5",
          "description": "Земельні ділянки"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "contractPeriod": {
          "startDate": "2017-08-30T15:56:30.043635",
          "endDate": "2017-09-02T15:56:30.043635"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.001
      }
    ],
    "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": "м. Київ"
      }
    }
  }
}


422 Unprocessable Entity
Content-Type: application/json; charset=UTF-8

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

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

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

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

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

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


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

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-PS-2017-11-30-000001",
    "enquiryPeriod": {
      "startDate": "2017-11-30T16:56:25.617199+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-12-13T23:59:50+02: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": "301d66e275cb4861ba502c1eaafa88ae",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2017-11-30T16:56:25.621767+02:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-11-30T16:56:25.617199+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-12-14T00:00:00+02:00"
    },
    "procurementMethodType": "dgfOtherAssets",
    "dgfID": "219560",
    "date": "2017-11-30T16:56:25.617199+02:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CPV",
          "description": "Земельні ділянки",
          "id": "66113000-5"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "6abd12c929084367ac08d9d9138ccab4",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

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

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

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


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

{
  "next_page": {
    "path": "/api/2.3/auctions?offset=2017-11-30T16%3A56%3A25.621767%2B02%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions?offset=2017-11-30T16%3A56%3A25.621767%2B02%3A00",
    "offset": "2017-11-30T16:56:25.621767+02:00"
  },
  "data": [
    {
      "id": "301d66e275cb4861ba502c1eaafa88ae",
      "dateModified": "2017-11-30T16:56:25.621767+02:00"
    }
  ]
}

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

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

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

{
  "data": {
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "procurementMethodDetails": "quick, accelerator=1440",
    "tenderAttempts": 1,
    "procurementMethodType": "dgfOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "mode": "test",
    "title_ru": "футляры к государственным наградам",
    "auctionPeriod": {
      "startDate": "2017-12-14T16:56:17.205813"
    },
    "items": [
      {
        "classification": {
          "scheme": "CPV",
          "id": "66113000-5",
          "description": "Земельні ділянки"
        },
        "description": "Земля для військовослужбовців",
        "id": "aff7d0febd8847b78f31662488efd20b",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "title_en": "Cases with state awards",
    "dgfID": "219560"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/057ecdd1ad8f45ea8151e731ac2b30f3

{
  "access": {
    "token": "52d7fbc91420401d908289b3cbfe71e9"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-PS-2017-11-30-000002",
    "enquiryPeriod": {
      "startDate": "2017-11-30T16:56:25.801167+02:00",
      "endDate": "2017-12-14T16:55:24.860531+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-12-14T16:55:24.860531+02:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker",
    "title_en": "[TESTING] Cases with state awards",
    "id": "057ecdd1ad8f45ea8151e731ac2b30f3",
    "title": "[ТЕСТУВАННЯ] футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2017-11-30T16:56:25.805777+02:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-11-30T16:56:25.801167+02:00",
      "endDate": "2017-12-14T16:55:24.860531+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-12-15T00:00:00+02:00"
    },
    "procurementMethodType": "dgfOtherAssets",
    "dgfID": "219560",
    "date": "2017-11-30T16:56:25.801167+02:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "description": "Земля для військовослужбовців",
        "id": "aff7d0febd8847b78f31662488efd20b",
        "classification": {
          "scheme": "CPV",
          "description": "Земельні ділянки",
          "id": "66113000-5"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "mode": "test",
    "title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
    "awardCriteria": "highestCost"
  }
}

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

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

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


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

{
  "next_page": {
    "path": "/api/2.3/auctions?offset=2017-11-30T16%3A56%3A25.621767%2B02%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions?offset=2017-11-30T16%3A56%3A25.621767%2B02%3A00",
    "offset": "2017-11-30T16:56:25.621767+02:00"
  },
  "data": [
    {
      "id": "301d66e275cb4861ba502c1eaafa88ae",
      "dateModified": "2017-11-30T16:56:25.621767+02:00"
    }
  ]
}

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

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

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

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

{
  "data": {
    "tenderPeriod": {
      "endDate": "2017-12-15T16:56:35.944933+02:00"
    }
  }
}


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

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-PS-2017-11-30-000001",
    "enquiryPeriod": {
      "startDate": "2017-11-30T16:56:25.617199+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-12-13T23:59:50+02: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": "301d66e275cb4861ba502c1eaafa88ae",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2017-11-30T16:56:25.621767+02:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-11-30T16:56:25.617199+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-12-14T00:00:00+02:00"
    },
    "procurementMethodType": "dgfOtherAssets",
    "dgfID": "219560",
    "date": "2017-11-30T16:56:25.617199+02:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CPV",
          "description": "Земельні ділянки",
          "id": "66113000-5"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "6abd12c929084367ac08d9d9138ccab4",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

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

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

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


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

{
  "next_page": {
    "path": "/api/2.3/auctions?offset=2017-11-30T16%3A56%3A25.873102%2B02%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions?offset=2017-11-30T16%3A56%3A25.873102%2B02%3A00",
    "offset": "2017-11-30T16:56:25.873102+02:00"
  },
  "data": [
    {
      "id": "301d66e275cb4861ba502c1eaafa88ae",
      "dateModified": "2017-11-30T16:56:25.621767+02:00"
    },
    {
      "id": "dbcc98fdc3f64c6aaabe25f09a2c64d1",
      "dateModified": "2017-11-30T16:56:25.873102+02:00"
    }
  ]
}

Keep in mind, that every time Organizer edits the auction all bids will be switched to invalid status.

Bidders can reactivate their bids.

Organizer can edit procedure only during enquiryPeriod.

When this period ends 403 error will be returned on editing attempt:

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

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 415
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/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=P1G3pRNxZchhK%2FgkOzQoI4eQtwB%2BhjrtHZpWFS4DHIsNZke%2BhlU%2Fckb5vkmRwzqcg96vsSluTsCXIfg4TWd6Bg%3D%3D",
    "format": "application/pdf",
    "documentType": "technicalSpecifications"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/418d8f99150a4b92a57b81cc18cd968a

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.092186+02:00",
    "documentType": "technicalSpecifications",
    "dateModified": "2017-11-30T16:56:26.092222+02:00",
    "id": "418d8f99150a4b92a57b81cc18cd968a"
  }
}

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/418d8f99150a4b92a57b81cc18cd968a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.092186+02:00",
    "previousVersions": [],
    "documentType": "technicalSpecifications",
    "dateModified": "2017-11-30T16:56:26.092222+02:00",
    "id": "418d8f99150a4b92a57b81cc18cd968a"
  }
}

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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/68fe48f4593a4de9844e6548344b2696?KeyID=8473a74a&Signature=20qbIlw9A9vFgmcjaagAfrYpHKp5oWHqcqZEBDuJIq%2FwysuHo4C%2BREnHEOneynezrY%2FoIQoJ8379xY%2BDJId4BQ%3D%3D",
    "title": "AwardCriteria.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/3385ba24fb704db79cb8a70561e023c7

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/68fe48f4593a4de9844e6548344b2696?KeyID=8473a74a&Signature=QZwWxRCYJDGM8BwdJ%252Bh%2FZ7EfjK1tSuHstIWY7Phw8MUeywT2GsNNucpnf2UGZGud5EPLKF1xOz9hX%252BWHtaSeBw%253D%253D",
    "title": "AwardCriteria.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.157156+02:00",
    "dateModified": "2017-11-30T16:56:26.157192+02:00",
    "id": "3385ba24fb704db79cb8a70561e023c7"
  }
}

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.092186+02:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2017-11-30T16:56:26.092222+02:00",
      "id": "418d8f99150a4b92a57b81cc18cd968a"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/68fe48f4593a4de9844e6548344b2696?KeyID=8473a74a&Signature=QZwWxRCYJDGM8BwdJ%252Bh%2FZ7EfjK1tSuHstIWY7Phw8MUeywT2GsNNucpnf2UGZGud5EPLKF1xOz9hX%252BWHtaSeBw%253D%253D",
      "title": "AwardCriteria.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.157156+02:00",
      "dateModified": "2017-11-30T16:56:26.157192+02:00",
      "id": "3385ba24fb704db79cb8a70561e023c7"
    }
  ]
}

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

PUT /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/3385ba24fb704db79cb8a70561e023c7?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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/9840d23dc3194951a561e6b3d959fac0?KeyID=8473a74a&Signature=zV0b0U6S2LivauIlHbmy3NjVsbCTyEtgWFhrVYM3rEVniUg%2FJnfwZc3BruHog0KupIa2qItySihDKH2sVU1UAQ%3D%3D",
    "title": "AwardCriteria-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9840d23dc3194951a561e6b3d959fac0?KeyID=8473a74a&Signature=vJlSrjCYsuQhptjoPNewJOzwmvXFcLc5HA8pIMybY%252B0qd7VYuGlhFpTPnwpMtpFEnblx87Fz%252BXuJ9x%2FBELicCg%253D%253D",
    "title": "AwardCriteria-2.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.157156+02:00",
    "dateModified": "2017-11-30T16:56:26.221784+02:00",
    "id": "3385ba24fb704db79cb8a70561e023c7"
  }
}

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.092186+02:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2017-11-30T16:56:26.092222+02:00",
      "id": "418d8f99150a4b92a57b81cc18cd968a"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9840d23dc3194951a561e6b3d959fac0?KeyID=8473a74a&Signature=vJlSrjCYsuQhptjoPNewJOzwmvXFcLc5HA8pIMybY%252B0qd7VYuGlhFpTPnwpMtpFEnblx87Fz%252BXuJ9x%2FBELicCg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.157156+02:00",
      "dateModified": "2017-11-30T16:56:26.221784+02:00",
      "id": "3385ba24fb704db79cb8a70561e023c7"
    }
  ]
}

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

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

Для того, щоб вказати порядок відображення ілюстрацій, використовується поле index (див. Document). Оскільки ця ілюстрація повинна бути відображена першою, то вказується "index": 1.

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 436
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/2840dd02387746c8882c2087e55b9f14?KeyID=8473a74a&Signature=A72CeRi4%2B8fC9UG9C%2FuvfJdkbzFP52dV0xg%2B7gXZoHp3EF4HjQAR1xdz0W%2F%2BcV902JTBXbJG9ebWHwZiyU2HCg%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/f143cdc5fef246f59d11cd3bc7c72d46

{
  "data": {
    "index": 1,
    "hash": "md5:00000000000000000000000000000000",
    "description": "First illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2840dd02387746c8882c2087e55b9f14?KeyID=8473a74a&Signature=CTN%2FyvXW3%252Bz7lGcIGWXJGAYdUUudzcpWk1%2F9TldffuMmRChRSJJsi%2F%2FHBzjXb%252B0f4DuzUiUbq8bqD%2FP70jlFAQ%253D%253D",
    "title": "first_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.293411+02:00",
    "documentType": "illustration",
    "dateModified": "2017-11-30T16:56:26.293438+02:00",
    "id": "f143cdc5fef246f59d11cd3bc7c72d46"
  }
}

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.092186+02:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2017-11-30T16:56:26.092222+02:00",
      "id": "418d8f99150a4b92a57b81cc18cd968a"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9840d23dc3194951a561e6b3d959fac0?KeyID=8473a74a&Signature=vJlSrjCYsuQhptjoPNewJOzwmvXFcLc5HA8pIMybY%252B0qd7VYuGlhFpTPnwpMtpFEnblx87Fz%252BXuJ9x%2FBELicCg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.157156+02:00",
      "dateModified": "2017-11-30T16:56:26.221784+02:00",
      "id": "3385ba24fb704db79cb8a70561e023c7"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2840dd02387746c8882c2087e55b9f14?KeyID=8473a74a&Signature=CTN%2FyvXW3%252Bz7lGcIGWXJGAYdUUudzcpWk1%2F9TldffuMmRChRSJJsi%2F%2FHBzjXb%252B0f4DuzUiUbq8bqD%2FP70jlFAQ%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.293411+02:00",
      "documentType": "illustration",
      "dateModified": "2017-11-30T16:56:26.293438+02:00",
      "id": "f143cdc5fef246f59d11cd3bc7c72d46"
    }
  ]
}

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 430
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/bfd750de3e7b49b5a991b6cdaf2c208e?KeyID=8473a74a&Signature=vmvWJOCo0jvQ1wr8Czb2%2BrC8ntp51VS0BYxtlXrCiPyKuKv7d7XJoVeAMmw8bH9RE28w1cW8BECbEgScz5ISBQ%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/eb64e2d0457e42c89aed5861301d3d06

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Second illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/bfd750de3e7b49b5a991b6cdaf2c208e?KeyID=8473a74a&Signature=nXLYMy2OkK2aIJDwV6kn7z3BkQD4wMe1ccc9%252BSvKDcUemJGUcmxtcGPn57JUQ6AJznS4IfCvaHVyDo5Aez7pDA%253D%253D",
    "title": "second_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.376954+02:00",
    "documentType": "illustration",
    "dateModified": "2017-11-30T16:56:26.376981+02:00",
    "id": "eb64e2d0457e42c89aed5861301d3d06"
  }
}

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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": "Third illustration description",
    "title": "third_illustration.jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2d40e8da608c4f10b9432671cf47c9aa?KeyID=8473a74a&Signature=BgTF%2BhgcDdTXB%2BMmv4Xfyl0PHorwUgDAKN7GVtlMm%2FoufbQVpM3pO11DN98KuWxwva2DIy73KKNE1hiIa53WBw%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/fdafece528e54fe5a7b38f025be993c3

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Third illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2d40e8da608c4f10b9432671cf47c9aa?KeyID=8473a74a&Signature=AGnUbHWEz4OOa7kxT1%2Fj4Ml7cNOw%252BcsUiDVX9HQhwqAdi4UGtaxWqeAZ2YhsI20lzMp67Fq%252BUo6jPmWdLdWuAQ%253D%253D",
    "title": "third_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.434267+02:00",
    "documentType": "illustration",
    "dateModified": "2017-11-30T16:56:26.434293+02:00",
    "id": "fdafece528e54fe5a7b38f025be993c3"
  }
}

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

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.092186+02:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2017-11-30T16:56:26.092222+02:00",
      "id": "418d8f99150a4b92a57b81cc18cd968a"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9840d23dc3194951a561e6b3d959fac0?KeyID=8473a74a&Signature=vJlSrjCYsuQhptjoPNewJOzwmvXFcLc5HA8pIMybY%252B0qd7VYuGlhFpTPnwpMtpFEnblx87Fz%252BXuJ9x%2FBELicCg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.157156+02:00",
      "dateModified": "2017-11-30T16:56:26.221784+02:00",
      "id": "3385ba24fb704db79cb8a70561e023c7"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2840dd02387746c8882c2087e55b9f14?KeyID=8473a74a&Signature=CTN%2FyvXW3%252Bz7lGcIGWXJGAYdUUudzcpWk1%2F9TldffuMmRChRSJJsi%2F%2FHBzjXb%252B0f4DuzUiUbq8bqD%2FP70jlFAQ%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.293411+02:00",
      "documentType": "illustration",
      "dateModified": "2017-11-30T16:56:26.293438+02:00",
      "id": "f143cdc5fef246f59d11cd3bc7c72d46"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Second illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/bfd750de3e7b49b5a991b6cdaf2c208e?KeyID=8473a74a&Signature=nXLYMy2OkK2aIJDwV6kn7z3BkQD4wMe1ccc9%252BSvKDcUemJGUcmxtcGPn57JUQ6AJznS4IfCvaHVyDo5Aez7pDA%253D%253D",
      "title": "second_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.376954+02:00",
      "documentType": "illustration",
      "dateModified": "2017-11-30T16:56:26.376981+02:00",
      "id": "eb64e2d0457e42c89aed5861301d3d06"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Third illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2d40e8da608c4f10b9432671cf47c9aa?KeyID=8473a74a&Signature=AGnUbHWEz4OOa7kxT1%2Fj4Ml7cNOw%252BcsUiDVX9HQhwqAdi4UGtaxWqeAZ2YhsI20lzMp67Fq%252BUo6jPmWdLdWuAQ%253D%253D",
      "title": "third_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.434267+02:00",
      "documentType": "illustration",
      "dateModified": "2017-11-30T16:56:26.434293+02:00",
      "id": "fdafece528e54fe5a7b38f025be993c3"
    }
  ]
}

Add Asset Familiarization

Organizer can upload asset familiarization document into the created auction.

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/b31139eea309435592a725e115dc90ed

{
  "data": {
    "title": "Familiarization with bank asset",
    "format": "offline/on-site-examination",
    "accessDetails": "Familiar with asset: days, time, address",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.520040+02:00",
    "documentType": "x_dgfAssetFamiliarization",
    "dateModified": "2017-11-30T16:56:26.520067+02:00",
    "id": "b31139eea309435592a725e115dc90ed"
  }
}

We can check whether asset familiarization document is added.

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.092186+02:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2017-11-30T16:56:26.092222+02:00",
      "id": "418d8f99150a4b92a57b81cc18cd968a"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9840d23dc3194951a561e6b3d959fac0?KeyID=8473a74a&Signature=vJlSrjCYsuQhptjoPNewJOzwmvXFcLc5HA8pIMybY%252B0qd7VYuGlhFpTPnwpMtpFEnblx87Fz%252BXuJ9x%2FBELicCg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.157156+02:00",
      "dateModified": "2017-11-30T16:56:26.221784+02:00",
      "id": "3385ba24fb704db79cb8a70561e023c7"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2840dd02387746c8882c2087e55b9f14?KeyID=8473a74a&Signature=CTN%2FyvXW3%252Bz7lGcIGWXJGAYdUUudzcpWk1%2F9TldffuMmRChRSJJsi%2F%2FHBzjXb%252B0f4DuzUiUbq8bqD%2FP70jlFAQ%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.293411+02:00",
      "documentType": "illustration",
      "dateModified": "2017-11-30T16:56:26.293438+02:00",
      "id": "f143cdc5fef246f59d11cd3bc7c72d46"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Second illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/bfd750de3e7b49b5a991b6cdaf2c208e?KeyID=8473a74a&Signature=nXLYMy2OkK2aIJDwV6kn7z3BkQD4wMe1ccc9%252BSvKDcUemJGUcmxtcGPn57JUQ6AJznS4IfCvaHVyDo5Aez7pDA%253D%253D",
      "title": "second_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.376954+02:00",
      "documentType": "illustration",
      "dateModified": "2017-11-30T16:56:26.376981+02:00",
      "id": "eb64e2d0457e42c89aed5861301d3d06"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Third illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2d40e8da608c4f10b9432671cf47c9aa?KeyID=8473a74a&Signature=AGnUbHWEz4OOa7kxT1%2Fj4Ml7cNOw%252BcsUiDVX9HQhwqAdi4UGtaxWqeAZ2YhsI20lzMp67Fq%252BUo6jPmWdLdWuAQ%253D%253D",
      "title": "third_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.434267+02:00",
      "documentType": "illustration",
      "dateModified": "2017-11-30T16:56:26.434293+02:00",
      "id": "fdafece528e54fe5a7b38f025be993c3"
    },
    {
      "title": "Familiarization with bank asset",
      "format": "offline/on-site-examination",
      "accessDetails": "Familiar with asset: days, time, address",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.520040+02:00",
      "documentType": "x_dgfAssetFamiliarization",
      "dateModified": "2017-11-30T16:56:26.520067+02:00",
      "id": "b31139eea309435592a725e115dc90ed"
    }
  ]
}

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

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/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; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/questions/e966c8cdacc14655907b34713b141d18

{
  "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": "2017-11-30T16:56:26.610507+02:00",
    "id": "e966c8cdacc14655907b34713b141d18",
    "questionOf": "tender"
  }
}

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

PATCH /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/questions/e966c8cdacc14655907b34713b141d18?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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; charset=UTF-8

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність",
    "date": "2017-11-30T16:56:26.610507+02:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "e966c8cdacc14655907b34713b141d18",
    "questionOf": "tender"
  }
}

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "description": "Просимо додати таблицю потрібної калорійності харчування",
      "title": "Калорійність",
      "date": "2017-11-30T16:56:26.610507+02:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "id": "e966c8cdacc14655907b34713b141d18",
      "questionOf": "tender"
    }
  ]
}

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/questions/e966c8cdacc14655907b34713b141d18 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність",
    "date": "2017-11-30T16:56:26.610507+02:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "e966c8cdacc14655907b34713b141d18",
    "questionOf": "tender"
  }
}

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

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/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; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/bids/afaa508128da4829b9202fe300965bf4

{
  "access": {
    "token": "a94a2b6627aa46f3bbb83ff885e3beae"
  },
  "data": {
    "status": "draft",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:26.821209+02: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": "afaa508128da4829b9202fe300965bf4"
  }
}

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

PATCH /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/bids/afaa508128da4829b9202fe300965bf4?acc_token=a94a2b6627aa46f3bbb83ff885e3beae 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; charset=UTF-8

{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:26.821209+02: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": "afaa508128da4829b9202fe300965bf4"
  }
}

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/bids/afaa508128da4829b9202fe300965bf4/documents?acc_token=a94a2b6627aa46f3bbb83ff885e3beae 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/4accad3bd17a4f0baa9f6a8ea96397f7?KeyID=8473a74a&Signature=F1ZZ8oz1qK%2B51JWibcyBu4pKvQcdApeIzqnBqPAbC9cdvKzLWXgVTNPak47HJv4BsbUhFSa9j9qb7pQ6mMOsBg%3D%3D",
    "title": "Proposal.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/bids/afaa508128da4829b9202fe300965bf4/documents/3bd15f6db7764b7e9651fdf15dde6316

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/bids/afaa508128da4829b9202fe300965bf4/documents/3bd15f6db7764b7e9651fdf15dde6316?download=4accad3bd17a4f0baa9f6a8ea96397f7",
    "title": "Proposal.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.994147+02:00",
    "dateModified": "2017-11-30T16:56:26.994175+02:00",
    "id": "3bd15f6db7764b7e9651fdf15dde6316"
  }
}

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/bids/afaa508128da4829b9202fe300965bf4/documents?acc_token=a94a2b6627aa46f3bbb83ff885e3beae HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/bids/afaa508128da4829b9202fe300965bf4/documents/3bd15f6db7764b7e9651fdf15dde6316?download=4accad3bd17a4f0baa9f6a8ea96397f7",
      "title": "Proposal.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.994147+02:00",
      "dateModified": "2017-11-30T16:56:26.994175+02:00",
      "id": "3bd15f6db7764b7e9651fdf15dde6316"
    }
  ]
}

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/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; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/bids/0d76a3f619044106b9bcdc0e57e93dad

{
  "access": {
    "token": "73842c515600468a8829fea44817fce1"
  },
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:27.113380+02: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": "0d76a3f619044106b9bcdc0e57e93dad"
  }
}

Аукціон

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

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


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

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-PS-2017-11-30-000001",
    "auctionUrl": "http://auction-sandbox.openprocurement.org/auctions/301d66e275cb4861ba502c1eaafa88ae",
    "enquiryPeriod": {
      "startDate": "2017-11-23T16:56:17.202736+02:00",
      "endDate": "2017-11-30T16:56:17.202736+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-11-30T17:40:17.202736+02: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": "2017-11-30T16:56:26.610507+02:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "e966c8cdacc14655907b34713b141d18",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "id": "301d66e275cb4861ba502c1eaafa88ae",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:26.092186+02:00",
        "documentType": "technicalSpecifications",
        "dateModified": "2017-11-30T16:56:26.092222+02:00",
        "id": "418d8f99150a4b92a57b81cc18cd968a"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/68fe48f4593a4de9844e6548344b2696?KeyID=8473a74a&Signature=QZwWxRCYJDGM8BwdJ%252Bh%2FZ7EfjK1tSuHstIWY7Phw8MUeywT2GsNNucpnf2UGZGud5EPLKF1xOz9hX%252BWHtaSeBw%253D%253D",
        "title": "AwardCriteria.pdf",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:26.157156+02:00",
        "dateModified": "2017-11-30T16:56:26.157192+02:00",
        "id": "3385ba24fb704db79cb8a70561e023c7"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9840d23dc3194951a561e6b3d959fac0?KeyID=8473a74a&Signature=vJlSrjCYsuQhptjoPNewJOzwmvXFcLc5HA8pIMybY%252B0qd7VYuGlhFpTPnwpMtpFEnblx87Fz%252BXuJ9x%2FBELicCg%253D%253D",
        "title": "AwardCriteria-2.pdf",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:26.157156+02:00",
        "dateModified": "2017-11-30T16:56:26.221784+02:00",
        "id": "3385ba24fb704db79cb8a70561e023c7"
      },
      {
        "index": 1,
        "hash": "md5:00000000000000000000000000000000",
        "description": "First illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2840dd02387746c8882c2087e55b9f14?KeyID=8473a74a&Signature=CTN%2FyvXW3%252Bz7lGcIGWXJGAYdUUudzcpWk1%2F9TldffuMmRChRSJJsi%2F%2FHBzjXb%252B0f4DuzUiUbq8bqD%2FP70jlFAQ%253D%253D",
        "title": "first_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:26.293411+02:00",
        "documentType": "illustration",
        "dateModified": "2017-11-30T16:56:26.293438+02:00",
        "id": "f143cdc5fef246f59d11cd3bc7c72d46"
      },
      {
        "index": 2,
        "hash": "md5:00000000000000000000000000000000",
        "description": "Second illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/bfd750de3e7b49b5a991b6cdaf2c208e?KeyID=8473a74a&Signature=nXLYMy2OkK2aIJDwV6kn7z3BkQD4wMe1ccc9%252BSvKDcUemJGUcmxtcGPn57JUQ6AJznS4IfCvaHVyDo5Aez7pDA%253D%253D",
        "title": "second_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:26.376954+02:00",
        "documentType": "illustration",
        "dateModified": "2017-11-30T16:56:26.376981+02:00",
        "id": "eb64e2d0457e42c89aed5861301d3d06"
      },
      {
        "index": 2,
        "hash": "md5:00000000000000000000000000000000",
        "description": "Third illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2d40e8da608c4f10b9432671cf47c9aa?KeyID=8473a74a&Signature=AGnUbHWEz4OOa7kxT1%2Fj4Ml7cNOw%252BcsUiDVX9HQhwqAdi4UGtaxWqeAZ2YhsI20lzMp67Fq%252BUo6jPmWdLdWuAQ%253D%253D",
        "title": "third_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:26.434267+02:00",
        "documentType": "illustration",
        "dateModified": "2017-11-30T16:56:26.434293+02:00",
        "id": "fdafece528e54fe5a7b38f025be993c3"
      },
      {
        "title": "Familiarization with bank asset",
        "format": "offline/on-site-examination",
        "accessDetails": "Familiar with asset: days, time, address",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:26.520040+02:00",
        "documentType": "x_dgfAssetFamiliarization",
        "dateModified": "2017-11-30T16:56:26.520067+02:00",
        "id": "b31139eea309435592a725e115dc90ed"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2017-11-30T16:56:27.371645+02:00",
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2017-11-23T16:56:17.202736+02:00",
      "endDate": "2017-11-30T16:56:17.202736+02:00"
    },
    "auctionPeriod": {
      "startDate": "2017-11-30T16:56:17.202736+02:00",
      "shouldStartAfter": "2017-12-01T00:00:00+02:00"
    },
    "procurementMethodType": "dgfOtherAssets",
    "dgfID": "219560",
    "date": "2017-11-30T16:56:25.617199+02:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CPV",
          "description": "Земельні ділянки",
          "id": "66113000-5"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "6abd12c929084367ac08d9d9138ccab4",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/bids/afaa508128da4829b9202fe300965bf4?acc_token=a94a2b6627aa46f3bbb83ff885e3beae HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/bids/afaa508128da4829b9202fe300965bf4/documents/3bd15f6db7764b7e9651fdf15dde6316?download=4accad3bd17a4f0baa9f6a8ea96397f7",
        "title": "Proposal.pdf",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:26.994147+02:00",
        "dateModified": "2017-11-30T16:56:26.994175+02:00",
        "id": "3bd15f6db7764b7e9651fdf15dde6316"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:26.821209+02: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": "afaa508128da4829b9202fe300965bf4",
    "participationUrl": "http://auction-sandbox.openprocurement.org/auctions/301d66e275cb4861ba502c1eaafa88ae?key_for_bid=afaa508128da4829b9202fe300965bf4"
  }
}

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/bids/0d76a3f619044106b9bcdc0e57e93dad?acc_token=73842c515600468a8829fea44817fce1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:27.113380+02: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": "0d76a3f619044106b9bcdc0e57e93dad",
    "participationUrl": "http://auction-sandbox.openprocurement.org/auctions/301d66e275cb4861ba502c1eaafa88ae?key_for_bid=0d76a3f619044106b9bcdc0e57e93dad"
  }
}

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

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

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "status": "pending.verification",
      "paymentPeriod": {
        "startDate": "2017-11-30T16:56:27.695166+02:00",
        "endDate": "2017-11-30T17:16:29.509749+02:00"
      },
      "verificationPeriod": {
        "startDate": "2017-11-30T16:56:27.695166+02:00",
        "endDate": "2017-11-30T16:59:30.218082+02:00"
      },
      "signingPeriod": {
        "startDate": "2017-11-30T16:56:27.695166+02:00",
        "endDate": "2017-11-30T17:16:29.509749+02: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": "2017-11-30T16:56:27.695166+02:00"
      },
      "bid_id": "0d76a3f619044106b9bcdc0e57e93dad",
      "value": {
        "currency": "UAH",
        "amount": 501.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2017-11-30T16:56:27.695166+02:00",
      "id": "add0cbb7aa114e7cb6f5e127071f8b53"
    },
    {
      "status": "pending.waiting",
      "complaintPeriod": {
        "startDate": "2017-11-30T16:56:27.695166+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.695166+02:00",
      "id": "14f4c1774be847098f247565c4871574"
    }
  ]
}

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

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/awards/add0cbb7aa114e7cb6f5e127071f8b53/documents?acc_token=73842c515600468a8829fea44817fce1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 385
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/326d29c8df4744149f6082d061e6492e?KeyID=8473a74a&Signature=4cNJZ9v3X0JCIiaW9cFX2nbH10INN6%2B%2FLVLrM4p%2FwQQo%2FBU2JD1ryXuz6r6SxP7hcfQpgAtoL%2F2WB5QRENZvCA%3D%3D",
    "title": "SignedAuctionProtocol.pdf",
    "format": "application/pdf",
    "hash": "md5:00000000000000000000000000000000",
    "documentType": "auctionProtocol"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/awards/add0cbb7aa114e7cb6f5e127071f8b53/documents/de5b4f4f5aa04ef6a16606d1152b061a

{
  "data": {
    "dateModified": "2017-11-30T16:56:28.083997+02:00",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/326d29c8df4744149f6082d061e6492e?KeyID=8473a74a&Signature=W07o9qqLEOV3dvjZZVzBFeolqx4QEUoFCZPnHeu4xyBsP7NJma%252BZINjCbfVSmXeRHYiAnDikplownjV%2FJE%252B6BQ%253D%253D",
    "author": "bid_owner",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:28.083969+02:00",
    "documentType": "auctionProtocol",
    "title": "SignedAuctionProtocol.pdf",
    "id": "de5b4f4f5aa04ef6a16606d1152b061a"
  }
}
POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/awards/add0cbb7aa114e7cb6f5e127071f8b53/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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/79f7d75e9ff34c1d94289241ebd04a46?KeyID=8473a74a&Signature=Dw9ofeROBRO2k0vLPta83X2j28ym58QAiJ%2BKEtgsCkgGnY7vD6%2BBo%2Bdk29rxKjuVbQ%2FCyfdPWZKW8wFk8qCfAg%3D%3D",
    "title": "SignedAuctionProtocol.pdf",
    "format": "application/pdf",
    "hash": "md5:00000000000000000000000000000000",
    "documentType": "auctionProtocol"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/awards/add0cbb7aa114e7cb6f5e127071f8b53/documents/edc7c486de494ac3bdcc0b456d006e4a

{
  "data": {
    "dateModified": "2017-11-30T16:56:28.217417+02:00",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/79f7d75e9ff34c1d94289241ebd04a46?KeyID=8473a74a&Signature=ZZf5dIDTAFetGGoNyGHK0TaTX%2FMo%2FTcKq%2FTatSSpuIZleTjJFvbciSiMq9MNq3mZGWRdK%2FYKfT0lkoOKYooXDA%253D%253D",
    "author": "auction_owner",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:28.217384+02:00",
    "documentType": "auctionProtocol",
    "title": "SignedAuctionProtocol.pdf",
    "id": "edc7c486de494ac3bdcc0b456d006e4a"
  }
}

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

PATCH /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/awards/add0cbb7aa114e7cb6f5e127071f8b53?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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; charset=UTF-8

{
  "data": {
    "status": "pending.payment",
    "paymentPeriod": {
      "startDate": "2017-11-30T16:56:27.695166+02:00",
      "endDate": "2017-11-30T17:16:29.509749+02:00"
    },
    "documents": [
      {
        "dateModified": "2017-11-30T16:56:28.083997+02:00",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/326d29c8df4744149f6082d061e6492e?KeyID=8473a74a&Signature=W07o9qqLEOV3dvjZZVzBFeolqx4QEUoFCZPnHeu4xyBsP7NJma%252BZINjCbfVSmXeRHYiAnDikplownjV%2FJE%252B6BQ%253D%253D",
        "author": "bid_owner",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:28.083969+02:00",
        "documentType": "auctionProtocol",
        "title": "SignedAuctionProtocol.pdf",
        "id": "de5b4f4f5aa04ef6a16606d1152b061a"
      },
      {
        "dateModified": "2017-11-30T16:56:28.217417+02:00",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/79f7d75e9ff34c1d94289241ebd04a46?KeyID=8473a74a&Signature=ZZf5dIDTAFetGGoNyGHK0TaTX%2FMo%2FTcKq%2FTatSSpuIZleTjJFvbciSiMq9MNq3mZGWRdK%2FYKfT0lkoOKYooXDA%253D%253D",
        "author": "auction_owner",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:28.217384+02:00",
        "documentType": "auctionProtocol",
        "title": "SignedAuctionProtocol.pdf",
        "id": "edc7c486de494ac3bdcc0b456d006e4a"
      }
    ],
    "verificationPeriod": {
      "startDate": "2017-11-30T16:56:27.695166+02:00",
      "endDate": "2017-11-30T16:56:28.375177+02:00"
    },
    "complaintPeriod": {
      "startDate": "2017-11-30T16:56:27.695166+02: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": "2017-11-30T16:56:27.695166+02:00",
      "endDate": "2017-11-30T17:16:29.509749+02:00"
    },
    "bid_id": "0d76a3f619044106b9bcdc0e57e93dad",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:28.382166+02:00",
    "id": "add0cbb7aa114e7cb6f5e127071f8b53"
  }
}

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

PATCH /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/awards/add0cbb7aa114e7cb6f5e127071f8b53?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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; charset=UTF-8

{
  "data": {
    "status": "active",
    "paymentPeriod": {
      "startDate": "2017-11-30T16:56:27.695166+02:00",
      "endDate": "2017-11-30T16:56:28.528529+02:00"
    },
    "documents": [
      {
        "dateModified": "2017-11-30T16:56:28.083997+02:00",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/326d29c8df4744149f6082d061e6492e?KeyID=8473a74a&Signature=W07o9qqLEOV3dvjZZVzBFeolqx4QEUoFCZPnHeu4xyBsP7NJma%252BZINjCbfVSmXeRHYiAnDikplownjV%2FJE%252B6BQ%253D%253D",
        "author": "bid_owner",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:28.083969+02:00",
        "documentType": "auctionProtocol",
        "title": "SignedAuctionProtocol.pdf",
        "id": "de5b4f4f5aa04ef6a16606d1152b061a"
      },
      {
        "dateModified": "2017-11-30T16:56:28.217417+02:00",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/79f7d75e9ff34c1d94289241ebd04a46?KeyID=8473a74a&Signature=ZZf5dIDTAFetGGoNyGHK0TaTX%2FMo%2FTcKq%2FTatSSpuIZleTjJFvbciSiMq9MNq3mZGWRdK%2FYKfT0lkoOKYooXDA%253D%253D",
        "author": "auction_owner",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:28.217384+02:00",
        "documentType": "auctionProtocol",
        "title": "SignedAuctionProtocol.pdf",
        "id": "edc7c486de494ac3bdcc0b456d006e4a"
      }
    ],
    "verificationPeriod": {
      "startDate": "2017-11-30T16:56:27.695166+02:00",
      "endDate": "2017-11-30T16:56:28.375177+02:00"
    },
    "complaintPeriod": {
      "startDate": "2017-11-30T16:56:27.695166+02:00",
      "endDate": "2017-11-30T16:56:28.528529+02: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": "2017-11-30T16:56:27.695166+02:00",
      "endDate": "2017-11-30T17:16:29.509749+02:00"
    },
    "bid_id": "0d76a3f619044106b9bcdc0e57e93dad",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:28.536946+02:00",
    "id": "add0cbb7aa114e7cb6f5e127071f8b53"
  }
}

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

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

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 робочих днів після того, як став кандидатом, новий кандидат має підтвердити кваліфікацію за допомогою кроків, описаних вище (Кваліфікація).

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

The rest of the candidates can refuse to wait for the disqualification of the first candidate:

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.3/auctions/301d66e275cb4861ba502c1eaafa88ae/contracts/ada81c2080f143a387863faae3db1f81/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 357
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/5bd3f7a02ff44727b232621207f1b851?KeyID=8473a74a&Signature=Ndscn5Uq%2Bs%2BeHLny6kCKT3nDq1M6MVzfBivwV%2FXJduW%2B5%2FpdvbQHPew9U9II8HSPns9p2S7vEM3CtUBL91%2B2Dg%3D%3D",
    "title": "contract_first_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/contracts/ada81c2080f143a387863faae3db1f81/documents/1702fe06543e4c10b6f0bcb0aa694e8c

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/5bd3f7a02ff44727b232621207f1b851?KeyID=8473a74a&Signature=JQHt0PL4w47AD3VLzHc10HkPeKF1%252BHLSabNSU66N7xOOgzeZ5ABgvszpMW%252Bf1dAvGCTqIVBaD2EYUV1iUuYZAQ%253D%253D",
    "title": "contract_first_document.doc",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:28.913379+02:00",
    "dateModified": "2017-11-30T16:56:28.913410+02:00",
    "id": "1702fe06543e4c10b6f0bcb0aa694e8c"
  }
}

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

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/contracts/ada81c2080f143a387863faae3db1f81/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/5bd3f7a02ff44727b232621207f1b851?KeyID=8473a74a&Signature=JQHt0PL4w47AD3VLzHc10HkPeKF1%252BHLSabNSU66N7xOOgzeZ5ABgvszpMW%252Bf1dAvGCTqIVBaD2EYUV1iUuYZAQ%253D%253D",
      "title": "contract_first_document.doc",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:28.913379+02:00",
      "dateModified": "2017-11-30T16:56:28.913410+02:00",
      "id": "1702fe06543e4c10b6f0bcb0aa694e8c"
    }
  ]
}

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/contracts/ada81c2080f143a387863faae3db1f81/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 350
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/4d1df678191e499cbb764244f4469b22?KeyID=8473a74a&Signature=PIMLosfRw8Ru4sWIwgpHMjPorBzBQnIcamxeDNhK7vK%2F9dLDNtYYRfBrrEqaWzmb%2Bq5jApq1Pn2mUSQcS6pgAg%3D%3D",
    "title": "contract_second_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/contracts/ada81c2080f143a387863faae3db1f81/documents/5c42650d4e074aae85732d8655eec1b7

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/4d1df678191e499cbb764244f4469b22?KeyID=8473a74a&Signature=jAmAX7MaWviKJdsUEYM2RR8oXbt8vNobcDP6zqadHWj%252BoQKkUnjVwDry6HmSExDU7DJCqVN9ReLo4mMzNmibBQ%253D%253D",
    "title": "contract_second_document.doc",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:29.118456+02:00",
    "dateModified": "2017-11-30T16:56:29.118484+02:00",
    "id": "5c42650d4e074aae85732d8655eec1b7"
  }
}

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

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/contracts/ada81c2080f143a387863faae3db1f81/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/5bd3f7a02ff44727b232621207f1b851?KeyID=8473a74a&Signature=JQHt0PL4w47AD3VLzHc10HkPeKF1%252BHLSabNSU66N7xOOgzeZ5ABgvszpMW%252Bf1dAvGCTqIVBaD2EYUV1iUuYZAQ%253D%253D",
      "title": "contract_first_document.doc",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:28.913379+02:00",
      "dateModified": "2017-11-30T16:56:28.913410+02:00",
      "id": "1702fe06543e4c10b6f0bcb0aa694e8c"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/4d1df678191e499cbb764244f4469b22?KeyID=8473a74a&Signature=jAmAX7MaWviKJdsUEYM2RR8oXbt8vNobcDP6zqadHWj%252BoQKkUnjVwDry6HmSExDU7DJCqVN9ReLo4mMzNmibBQ%253D%253D",
      "title": "contract_second_document.doc",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:29.118456+02:00",
      "dateModified": "2017-11-30T16:56:29.118484+02:00",
      "id": "5c42650d4e074aae85732d8655eec1b7"
    }
  ]
}

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

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

PATCH /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/contracts/ada81c2080f143a387863faae3db1f81?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 80
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "active",
    "dateSigned": "2017-11-30T16:56:29.280738+02:00"
  }
}


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

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/5bd3f7a02ff44727b232621207f1b851?KeyID=8473a74a&Signature=JQHt0PL4w47AD3VLzHc10HkPeKF1%252BHLSabNSU66N7xOOgzeZ5ABgvszpMW%252Bf1dAvGCTqIVBaD2EYUV1iUuYZAQ%253D%253D",
        "title": "contract_first_document.doc",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:28.913379+02:00",
        "dateModified": "2017-11-30T16:56:28.913410+02:00",
        "id": "1702fe06543e4c10b6f0bcb0aa694e8c"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/4d1df678191e499cbb764244f4469b22?KeyID=8473a74a&Signature=jAmAX7MaWviKJdsUEYM2RR8oXbt8vNobcDP6zqadHWj%252BoQKkUnjVwDry6HmSExDU7DJCqVN9ReLo4mMzNmibBQ%253D%253D",
        "title": "contract_second_document.doc",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:29.118456+02:00",
        "dateModified": "2017-11-30T16:56:29.118484+02:00",
        "id": "5c42650d4e074aae85732d8655eec1b7"
      }
    ],
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CPV",
          "description": "Земельні ділянки",
          "id": "66113000-5"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "6abd12c929084367ac08d9d9138ccab4",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "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": "2017-11-30T16:56:17.205813+02:00",
      "endDate": "2018-11-30T16:56:17.205813+02:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-11-30T16:56:29.280738+02:00",
    "date": "2017-11-30T16:56:29.382454+02:00",
    "awardID": "add0cbb7aa114e7cb6f5e127071f8b53",
    "id": "ada81c2080f143a387863faae3db1f81",
    "contractID": "UA-PS-2017-11-30-000001-1"
  }
}

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

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

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

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

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

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

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

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

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

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/cancellations?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/cancellations/3fd26d96a4454abf9a875bef110dba4e

{
  "data": {
    "date": "2017-11-30T16:56:29.616244+02:00",
    "status": "pending",
    "reason": "cancellation reason",
    "cancellationOf": "tender",
    "id": "3fd26d96a4454abf9a875bef110dba4e"
  }
}

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

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/cancellations/3fd26d96a4454abf9a875bef110dba4e/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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/02dd9977d20e4b409d307bc67ee6ca36?KeyID=8473a74a&Signature=WhL6NTgs5mjvzOHNCCeQke4w1%2F7zXZ7lFpc59uvGIzXOAJPb8fwjWqupDk86%2Frroe1%2B77jX624%2Bo6ZLSkbCADw%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/cancellations/3fd26d96a4454abf9a875bef110dba4e/documents/6aebbc98305a4847830bdc40863a4d6b

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/02dd9977d20e4b409d307bc67ee6ca36?KeyID=8473a74a&Signature=5WtHn%252BXf4U2eKnBY5mwdZNifHaf%2FMoApsRroJSOzQBI%252BdJ5ZwCkP%252BTZmjkZ%2FDOh1M4U5JY7u1MJE8%252Bp7YQOSBw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:29.945693+02:00",
    "dateModified": "2017-11-30T16:56:29.945720+02:00",
    "id": "6aebbc98305a4847830bdc40863a4d6b"
  }
}

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

PATCH /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/cancellations/3fd26d96a4454abf9a875bef110dba4e/documents/6aebbc98305a4847830bdc40863a4d6b?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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; charset=UTF-8

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/02dd9977d20e4b409d307bc67ee6ca36?KeyID=8473a74a&Signature=5WtHn%252BXf4U2eKnBY5mwdZNifHaf%2FMoApsRroJSOzQBI%252BdJ5ZwCkP%252BTZmjkZ%2FDOh1M4U5JY7u1MJE8%252Bp7YQOSBw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:29.945693+02:00",
    "dateModified": "2017-11-30T16:56:29.945720+02:00",
    "id": "6aebbc98305a4847830bdc40863a4d6b"
  }
}

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

PUT /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/cancellations/3fd26d96a4454abf9a875bef110dba4e/documents/6aebbc98305a4847830bdc40863a4d6b?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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/1981cae19a6d4577bf343cf0b7d813f5?KeyID=8473a74a&Signature=8gW%2BOhgmZJCtbnvWqrJA%2Bigktxl1Ze93F9aM6jRFkTFNYgGjSTv7UcmiLAzKivOQlJDM0rAk5VD9ORurYDjDCw%3D%3D",
    "title": "Notice-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1981cae19a6d4577bf343cf0b7d813f5?KeyID=8473a74a&Signature=6PDYxf6GgOgkJuoH%2FR4qtBFHx%2FEcXKpV9NJ0lWVPu7IBKLdQ8%252ByiK5kIQk5YZ9aebaDik0e4JNDdJihcZVA%252BBg%253D%253D",
    "title": "Notice-2.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:29.945693+02:00",
    "dateModified": "2017-11-30T16:56:30.284752+02:00",
    "id": "6aebbc98305a4847830bdc40863a4d6b"
  }
}

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

PATCH /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/cancellations/3fd26d96a4454abf9a875bef110dba4e?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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; charset=UTF-8

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/02dd9977d20e4b409d307bc67ee6ca36?KeyID=8473a74a&Signature=5WtHn%252BXf4U2eKnBY5mwdZNifHaf%2FMoApsRroJSOzQBI%252BdJ5ZwCkP%252BTZmjkZ%2FDOh1M4U5JY7u1MJE8%252Bp7YQOSBw%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:29.945693+02:00",
        "dateModified": "2017-11-30T16:56:29.945720+02:00",
        "id": "6aebbc98305a4847830bdc40863a4d6b"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1981cae19a6d4577bf343cf0b7d813f5?KeyID=8473a74a&Signature=6PDYxf6GgOgkJuoH%2FR4qtBFHx%2FEcXKpV9NJ0lWVPu7IBKLdQ8%252ByiK5kIQk5YZ9aebaDik0e4JNDdJihcZVA%252BBg%253D%253D",
        "title": "Notice-2.pdf",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:29.945693+02:00",
        "dateModified": "2017-11-30T16:56:30.284752+02:00",
        "id": "6aebbc98305a4847830bdc40863a4d6b"
      }
    ],
    "reason": "cancellation reason",
    "date": "2017-11-30T16:56:30.483484+02:00",
    "cancellationOf": "tender",
    "id": "3fd26d96a4454abf9a875bef110dba4e"
  }
}

Фін. туторіал

Туторіал для процедури dgfFinancialAssets - продаж права вимоги за кредитними договорами.

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

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

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

{
  "data": {
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "procurementMethodDetails": "quick, accelerator=1440",
    "tenderAttempts": 1,
    "procurementMethodType": "dgfFinancialAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "dgfID": "219560",
    "auctionPeriod": {
      "startDate": "2017-12-14"
    },
    "items": [
      {
        "classification": {
          "scheme": "CPV",
          "id": "66113000-5",
          "description": "Земельні ділянки"
        },
        "quantity": 5,
        "description": "Земля для військовослужбовців",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        }
      }
    ],
    "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": "м. Київ"
      }
    }
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28

{
  "access": {
    "token": "6c03609dd6844e42bc1318fddf20c937"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-PS-2017-11-30-000001",
    "enquiryPeriod": {
      "startDate": "2017-11-30T16:56:23.942831+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-12-13T23:59:50+02: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": "73e1598288054eb98e8153ee9e69bb28",
    "eligibilityCriteria_ru": "К участию допускаются только лицензированные финансовые учреждения.",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "eligibilityCriteria_en": "Only licensed financial institutions are eligible to participate.",
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2017-11-30T16:56:23.946137+02:00",
    "status": "active.tendering",
    "eligibilityCriteria": "До участі допускаються лише ліцензовані фінансові установи.",
    "tenderPeriod": {
      "startDate": "2017-11-30T16:56:23.942831+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-12-14T00:00:00+02:00"
    },
    "procurementMethodType": "dgfFinancialAssets",
    "dgfID": "219560",
    "date": "2017-11-30T16:56:23.942831+02:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CPV",
          "description": "Земельні ділянки",
          "id": "66113000-5"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "e16351a78632484e8756b1dea38e6201",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

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

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

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


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

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-PS-2017-11-30-000001",
    "enquiryPeriod": {
      "startDate": "2017-11-30T16:56:23.942831+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-12-13T23:59:50+02: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": "73e1598288054eb98e8153ee9e69bb28",
    "eligibilityCriteria_ru": "К участию допускаются только лицензированные финансовые учреждения.",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "eligibilityCriteria_en": "Only licensed financial institutions are eligible to participate.",
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2017-11-30T16:56:23.946137+02:00",
    "status": "active.tendering",
    "eligibilityCriteria": "До участі допускаються лише ліцензовані фінансові установи.",
    "tenderPeriod": {
      "startDate": "2017-11-30T16:56:23.942831+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-12-14T00:00:00+02:00"
    },
    "procurementMethodType": "dgfFinancialAssets",
    "dgfID": "219560",
    "date": "2017-11-30T16:56:23.942831+02:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CPV",
          "description": "Земельні ділянки",
          "id": "66113000-5"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "e16351a78632484e8756b1dea38e6201",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

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

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

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


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

{
  "next_page": {
    "path": "/api/2.3/auctions?offset=2017-11-30T16%3A56%3A23.946137%2B02%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions?offset=2017-11-30T16%3A56%3A23.946137%2B02%3A00",
    "offset": "2017-11-30T16:56:23.946137+02:00"
  },
  "data": [
    {
      "id": "73e1598288054eb98e8153ee9e69bb28",
      "dateModified": "2017-11-30T16:56:23.946137+02:00"
    }
  ]
}

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

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

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

POST /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/documents?acc_token=6c03609dd6844e42bc1318fddf20c937 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 412
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "technical specification",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1b63ae48aa3e4caf99aac3455888c7d6?KeyID=c822be4a&Signature=QCihV3O02wIHwqfKrwHkYdZ4jtSlChjb8EKFrnRDwr6fv1qdAOmQ7Id6vM0vCWQaWvv4%2FPpEwTE4DYGWUECgAQ%3D%3D",
    "format": "application/pdf",
    "documentType": "technicalSpecifications"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/documents/74e4e4b7624d420b8448a6220e0a86cf

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "technical specification",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1b63ae48aa3e4caf99aac3455888c7d6?KeyID=c822be4a&Signature=Cqo%2Fl%2FHX9fy29aZ4TPnu9LB6ZtHdt6tquLKAJIGPLchoAf4OTMDnRAqLTeQK8rW9jgzFQ6I9HGfJtUP8i3gKDA%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:24.108881+02:00",
    "documentType": "technicalSpecifications",
    "dateModified": "2017-11-30T16:56:24.108911+02:00",
    "id": "74e4e4b7624d420b8448a6220e0a86cf"
  }
}

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

GET /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/documents/74e4e4b7624d420b8448a6220e0a86cf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "technical specification",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1b63ae48aa3e4caf99aac3455888c7d6?KeyID=c822be4a&Signature=Cqo%2Fl%2FHX9fy29aZ4TPnu9LB6ZtHdt6tquLKAJIGPLchoAf4OTMDnRAqLTeQK8rW9jgzFQ6I9HGfJtUP8i3gKDA%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:24.108881+02:00",
    "previousVersions": [],
    "documentType": "technicalSpecifications",
    "dateModified": "2017-11-30T16:56:24.108911+02:00",
    "id": "74e4e4b7624d420b8448a6220e0a86cf"
  }
}

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

POST /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/documents?acc_token=6c03609dd6844e42bc1318fddf20c937 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 338
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b0a0c1a4b083475caaa4c8fb08d18781?KeyID=c822be4a&Signature=eUjEvPipgCDUg2CRW0uqyy%2Br5C7MNpbTp26C83J4cy7H84gzepDYr%2BfNWkPzjpTqZfg%2BIfTNVj86hY07Z9mcBA%3D%3D",
    "title": "AwardCriteria.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/documents/55dc8e33c47948eab4e7b327bede3959

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b0a0c1a4b083475caaa4c8fb08d18781?KeyID=c822be4a&Signature=xnYvodjAvZu8pjdlyQ4kdlC62x%252BEi2JnnuWKvRdNbne9KWdXVWSlqM%252BeGrGuJ4%252BS2e9qmZRCg9vHJvc1iz%252BMAA%253D%253D",
    "title": "AwardCriteria.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:24.174808+02:00",
    "dateModified": "2017-11-30T16:56:24.174838+02:00",
    "id": "55dc8e33c47948eab4e7b327bede3959"
  }
}

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

GET /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "technical specification",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1b63ae48aa3e4caf99aac3455888c7d6?KeyID=c822be4a&Signature=Cqo%2Fl%2FHX9fy29aZ4TPnu9LB6ZtHdt6tquLKAJIGPLchoAf4OTMDnRAqLTeQK8rW9jgzFQ6I9HGfJtUP8i3gKDA%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:24.108881+02:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2017-11-30T16:56:24.108911+02:00",
      "id": "74e4e4b7624d420b8448a6220e0a86cf"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b0a0c1a4b083475caaa4c8fb08d18781?KeyID=c822be4a&Signature=xnYvodjAvZu8pjdlyQ4kdlC62x%252BEi2JnnuWKvRdNbne9KWdXVWSlqM%252BeGrGuJ4%252BS2e9qmZRCg9vHJvc1iz%252BMAA%253D%253D",
      "title": "AwardCriteria.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:24.174808+02:00",
      "dateModified": "2017-11-30T16:56:24.174838+02:00",
      "id": "55dc8e33c47948eab4e7b327bede3959"
    }
  ]
}

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

PUT /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/documents/55dc8e33c47948eab4e7b327bede3959?acc_token=6c03609dd6844e42bc1318fddf20c937 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/3efb323d6d6a42c9817ec011d6c8898f?KeyID=c822be4a&Signature=ihcWFQ7J6n6ycnrnh0RJKYBGr3PXLL4%2Fu39OMCUhkdXcrv9CY%2FXcFty3b%2BqTiMV6ODEMR7zAyub4CwZXgyoYBA%3D%3D",
    "title": "AwardCriteria-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/3efb323d6d6a42c9817ec011d6c8898f?KeyID=c822be4a&Signature=oMIup%252BjcxK%2FooCGXGpptyKCu1slmnk3T1I8XhOKPQXsKAD3R3zPyoDvYbF%252B47ZdbzNJ8m9v3TNQdsbseMlv7CA%253D%253D",
    "title": "AwardCriteria-2.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:24.174808+02:00",
    "dateModified": "2017-11-30T16:56:24.243244+02:00",
    "id": "55dc8e33c47948eab4e7b327bede3959"
  }
}

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

GET /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "technical specification",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1b63ae48aa3e4caf99aac3455888c7d6?KeyID=c822be4a&Signature=Cqo%2Fl%2FHX9fy29aZ4TPnu9LB6ZtHdt6tquLKAJIGPLchoAf4OTMDnRAqLTeQK8rW9jgzFQ6I9HGfJtUP8i3gKDA%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:24.108881+02:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2017-11-30T16:56:24.108911+02:00",
      "id": "74e4e4b7624d420b8448a6220e0a86cf"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/3efb323d6d6a42c9817ec011d6c8898f?KeyID=c822be4a&Signature=oMIup%252BjcxK%2FooCGXGpptyKCu1slmnk3T1I8XhOKPQXsKAD3R3zPyoDvYbF%252B47ZdbzNJ8m9v3TNQdsbseMlv7CA%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:24.174808+02:00",
      "dateModified": "2017-11-30T16:56:24.243244+02:00",
      "id": "55dc8e33c47948eab4e7b327bede3959"
    }
  ]
}

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

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

Для того, щоб вказати порядок відображення ілюстрацій, використовується поле index (див. Document). Оскільки ця ілюстрація повинна бути відображена першою, то вказується "index": 1

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 436
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/2840dd02387746c8882c2087e55b9f14?KeyID=8473a74a&Signature=A72CeRi4%2B8fC9UG9C%2FuvfJdkbzFP52dV0xg%2B7gXZoHp3EF4HjQAR1xdz0W%2F%2BcV902JTBXbJG9ebWHwZiyU2HCg%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/f143cdc5fef246f59d11cd3bc7c72d46

{
  "data": {
    "index": 1,
    "hash": "md5:00000000000000000000000000000000",
    "description": "First illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2840dd02387746c8882c2087e55b9f14?KeyID=8473a74a&Signature=CTN%2FyvXW3%252Bz7lGcIGWXJGAYdUUudzcpWk1%2F9TldffuMmRChRSJJsi%2F%2FHBzjXb%252B0f4DuzUiUbq8bqD%2FP70jlFAQ%253D%253D",
    "title": "first_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.293411+02:00",
    "documentType": "illustration",
    "dateModified": "2017-11-30T16:56:26.293438+02:00",
    "id": "f143cdc5fef246f59d11cd3bc7c72d46"
  }
}

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.092186+02:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2017-11-30T16:56:26.092222+02:00",
      "id": "418d8f99150a4b92a57b81cc18cd968a"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9840d23dc3194951a561e6b3d959fac0?KeyID=8473a74a&Signature=vJlSrjCYsuQhptjoPNewJOzwmvXFcLc5HA8pIMybY%252B0qd7VYuGlhFpTPnwpMtpFEnblx87Fz%252BXuJ9x%2FBELicCg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.157156+02:00",
      "dateModified": "2017-11-30T16:56:26.221784+02:00",
      "id": "3385ba24fb704db79cb8a70561e023c7"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2840dd02387746c8882c2087e55b9f14?KeyID=8473a74a&Signature=CTN%2FyvXW3%252Bz7lGcIGWXJGAYdUUudzcpWk1%2F9TldffuMmRChRSJJsi%2F%2FHBzjXb%252B0f4DuzUiUbq8bqD%2FP70jlFAQ%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.293411+02:00",
      "documentType": "illustration",
      "dateModified": "2017-11-30T16:56:26.293438+02:00",
      "id": "f143cdc5fef246f59d11cd3bc7c72d46"
    }
  ]
}

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 430
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/bfd750de3e7b49b5a991b6cdaf2c208e?KeyID=8473a74a&Signature=vmvWJOCo0jvQ1wr8Czb2%2BrC8ntp51VS0BYxtlXrCiPyKuKv7d7XJoVeAMmw8bH9RE28w1cW8BECbEgScz5ISBQ%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/eb64e2d0457e42c89aed5861301d3d06

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Second illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/bfd750de3e7b49b5a991b6cdaf2c208e?KeyID=8473a74a&Signature=nXLYMy2OkK2aIJDwV6kn7z3BkQD4wMe1ccc9%252BSvKDcUemJGUcmxtcGPn57JUQ6AJznS4IfCvaHVyDo5Aez7pDA%253D%253D",
    "title": "second_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.376954+02:00",
    "documentType": "illustration",
    "dateModified": "2017-11-30T16:56:26.376981+02:00",
    "id": "eb64e2d0457e42c89aed5861301d3d06"
  }
}

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

POST /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents?acc_token=ccf4d45ff9524ec9ae87f38c43d7b0a3 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": "Third illustration description",
    "title": "third_illustration.jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2d40e8da608c4f10b9432671cf47c9aa?KeyID=8473a74a&Signature=BgTF%2BhgcDdTXB%2BMmv4Xfyl0PHorwUgDAKN7GVtlMm%2FoufbQVpM3pO11DN98KuWxwva2DIy73KKNE1hiIa53WBw%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents/fdafece528e54fe5a7b38f025be993c3

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Third illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2d40e8da608c4f10b9432671cf47c9aa?KeyID=8473a74a&Signature=AGnUbHWEz4OOa7kxT1%2Fj4Ml7cNOw%252BcsUiDVX9HQhwqAdi4UGtaxWqeAZ2YhsI20lzMp67Fq%252BUo6jPmWdLdWuAQ%253D%253D",
    "title": "third_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:26.434267+02:00",
    "documentType": "illustration",
    "dateModified": "2017-11-30T16:56:26.434293+02:00",
    "id": "fdafece528e54fe5a7b38f025be993c3"
  }
}

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

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

GET /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/323a56de45c243bb88a568c652d9ca2b?KeyID=8473a74a&Signature=u52VVOil6Bd6RED8Jt8wIJv2ioBCOV5meDxqcLgCksUxsJeTTj2aL5xHGYGjnsDBb0N6NohsEHBoxR5WaFE8Cw%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.092186+02:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2017-11-30T16:56:26.092222+02:00",
      "id": "418d8f99150a4b92a57b81cc18cd968a"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9840d23dc3194951a561e6b3d959fac0?KeyID=8473a74a&Signature=vJlSrjCYsuQhptjoPNewJOzwmvXFcLc5HA8pIMybY%252B0qd7VYuGlhFpTPnwpMtpFEnblx87Fz%252BXuJ9x%2FBELicCg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.157156+02:00",
      "dateModified": "2017-11-30T16:56:26.221784+02:00",
      "id": "3385ba24fb704db79cb8a70561e023c7"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2840dd02387746c8882c2087e55b9f14?KeyID=8473a74a&Signature=CTN%2FyvXW3%252Bz7lGcIGWXJGAYdUUudzcpWk1%2F9TldffuMmRChRSJJsi%2F%2FHBzjXb%252B0f4DuzUiUbq8bqD%2FP70jlFAQ%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.293411+02:00",
      "documentType": "illustration",
      "dateModified": "2017-11-30T16:56:26.293438+02:00",
      "id": "f143cdc5fef246f59d11cd3bc7c72d46"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Second illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/bfd750de3e7b49b5a991b6cdaf2c208e?KeyID=8473a74a&Signature=nXLYMy2OkK2aIJDwV6kn7z3BkQD4wMe1ccc9%252BSvKDcUemJGUcmxtcGPn57JUQ6AJznS4IfCvaHVyDo5Aez7pDA%253D%253D",
      "title": "second_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.376954+02:00",
      "documentType": "illustration",
      "dateModified": "2017-11-30T16:56:26.376981+02:00",
      "id": "eb64e2d0457e42c89aed5861301d3d06"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Third illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2d40e8da608c4f10b9432671cf47c9aa?KeyID=8473a74a&Signature=AGnUbHWEz4OOa7kxT1%2Fj4Ml7cNOw%252BcsUiDVX9HQhwqAdi4UGtaxWqeAZ2YhsI20lzMp67Fq%252BUo6jPmWdLdWuAQ%253D%253D",
      "title": "third_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:26.434267+02:00",
      "documentType": "illustration",
      "dateModified": "2017-11-30T16:56:26.434293+02:00",
      "id": "fdafece528e54fe5a7b38f025be993c3"
    }
  ]
}

Додавання віртуальної кімнати для роботи з конфіденційними даними

Організатор може додати URL-адресу віртуальної кімнати для роботи з конфіденційними даними:

POST /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/documents?acc_token=6c03609dd6844e42bc1318fddf20c937 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 127
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://virtial-data-room.com/id_of_room",
    "title": "VDR for auction lot",
    "documentType": "virtualDataRoom"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/documents/4e24994ddc1c4c72b24b992f8826acf4

{
  "data": {
    "title": "VDR for auction lot",
    "url": "http://virtial-data-room.com/id_of_room",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:24.313920+02:00",
    "documentType": "virtualDataRoom",
    "dateModified": "2017-11-30T16:56:24.313948+02:00",
    "id": "4e24994ddc1c4c72b24b992f8826acf4"
  }
}

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

Учасник може зареєструвати пропозицію у статусі draft (чернетка). Учасник повинен вказати значення UA-FIN для параметра additionalIdentifiers.

POST /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1004
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "qualified": true,
    "tenderers": [
      {
        "additionalIdentifiers": [
          {
            "scheme": "UA-FIN",
            "id": "А01 457213"
          }
        ],
        "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": "м. Київ"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 469,
      "valueAddedTaxIncluded": true
    },
    "eligible": true
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/bids/c7a52fb296b143cc87728f74b2585fca

{
  "access": {
    "token": "b6c5e3c4087848a08703ae24889033a7"
  },
  "data": {
    "status": "active",
    "eligible": true,
    "value": {
      "currency": "UAH",
      "amount": 469.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:24.381299+02:00",
    "qualified": true,
    "tenderers": [
      {
        "additionalIdentifiers": [
          {
            "scheme": "UA-FIN",
            "id": "А01 457213"
          }
        ],
        "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": "c7a52fb296b143cc87728f74b2585fca"
  }
}

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

PATCH /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/bids/c7a52fb296b143cc87728f74b2585fca?acc_token=b6c5e3c4087848a08703ae24889033a7 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; charset=UTF-8

null

І завантажити ліцензію (вказавши documentType: financialLicense):

POST /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/bids/c7a52fb296b143cc87728f74b2585fca/documents?acc_token=b6c5e3c4087848a08703ae24889033a7 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/9d26f2842ae149228d379eb98961e054?KeyID=c822be4a&Signature=GihlzLpKCv%2Fv86BLw%2Fn8wAMDJhbuncQkvQpe68VIyD15Z0MfPipOfda9ENxJNDZ3ygf%2B%2F8%2Fv6AypQlORVmLoDw%3D%3D",
    "title": "FinancialLicense.pdf",
    "format": "application/pdf",
    "hash": "md5:00000000000000000000000000000000",
    "documentType": "financialLicense"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/bids/c7a52fb296b143cc87728f74b2585fca/documents/523bf2858a644c37bb188b696ae1ee65

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/bids/c7a52fb296b143cc87728f74b2585fca/documents/523bf2858a644c37bb188b696ae1ee65?download=9d26f2842ae149228d379eb98961e054",
    "title": "FinancialLicense.pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:24.486255+02:00",
    "documentType": "financialLicense",
    "dateModified": "2017-11-30T16:56:24.486283+02:00",
    "id": "523bf2858a644c37bb188b696ae1ee65"
  }
}

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

GET /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/bids/c7a52fb296b143cc87728f74b2585fca/documents?acc_token=b6c5e3c4087848a08703ae24889033a7 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/bids/c7a52fb296b143cc87728f74b2585fca/documents/523bf2858a644c37bb188b696ae1ee65?download=9d26f2842ae149228d379eb98961e054",
      "title": "FinancialLicense.pdf",
      "documentOf": "tender",
      "datePublished": "2017-11-30T16:56:24.486255+02:00",
      "documentType": "financialLicense",
      "dateModified": "2017-11-30T16:56:24.486283+02:00",
      "id": "523bf2858a644c37bb188b696ae1ee65"
    }
  ]
}

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

POST /api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1004
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "qualified": true,
    "tenderers": [
      {
        "additionalIdentifiers": [
          {
            "scheme": "UA-FIN",
            "id": "А01 457213"
          }
        ],
        "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": "м. Київ"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 479,
      "valueAddedTaxIncluded": true
    },
    "eligible": true
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/73e1598288054eb98e8153ee9e69bb28/bids/afc000ac87e642d8b70141957772cdb8

{
  "access": {
    "token": "47bbd4a1e6f9460b94cea52301caca48"
  },
  "data": {
    "status": "active",
    "eligible": true,
    "value": {
      "currency": "UAH",
      "amount": 479.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:24.588843+02:00",
    "qualified": true,
    "tenderers": [
      {
        "additionalIdentifiers": [
          {
            "scheme": "UA-FIN",
            "id": "А01 457213"
          }
        ],
        "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": "afc000ac87e642d8b70141957772cdb8"
  }
}

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

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

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

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

{
  "data": {
    "status": "draft",
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "procurementMethodDetails": "quick, accelerator=1440",
    "tenderAttempts": 1,
    "procurementMethodType": "dgfOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "dgfID": "219560",
    "auctionPeriod": {
      "startDate": "2017-12-14"
    },
    "items": [
      {
        "classification": {
          "scheme": "CPV",
          "id": "66113000-5",
          "description": "Земельні ділянки"
        },
        "quantity": 5,
        "description": "Земля для військовослужбовців",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        }
      }
    ],
    "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": "м. Київ"
      }
    }
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/58ad76271332425694531cbfe1aa6723

{
  "access": {
    "token": "a3781f686544479b9060df012b8db196"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-PS-2017-11-30-000001",
    "tenderPeriod": {
      "startDate": "2017-11-30T16:56:19.163266+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "procurementMethodDetails": "quick, accelerator=1440",
    "tenderAttempts": 1,
    "procurementMethodType": "dgfOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-11-30T16:56:19.163266+02:00",
    "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": "м. Київ"
      }
    },
    "dgfID": "219560",
    "enquiryPeriod": {
      "startDate": "2017-11-30T16:56:19.163266+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "owner": "broker",
    "dateModified": "2017-11-30T16:56:19.166771+02:00",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CPV",
          "description": "Земельні ділянки",
          "id": "66113000-5"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "c2fb6cf42caf4621b4bcac1deff95286",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "id": "58ad76271332425694531cbfe1aa6723",
    "awardCriteria": "highestCost"
  }
}

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

PATCH /api/2.3/auctions/58ad76271332425694531cbfe1aa6723?acc_token=a3781f686544479b9060df012b8db196 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; charset=UTF-8

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-PS-2017-11-30-000001",
    "enquiryPeriod": {
      "startDate": "2017-11-30T16:56:19.163266+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-12-13T23:59:50+02: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": "58ad76271332425694531cbfe1aa6723",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2017-11-30T16:56:19.212525+02:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-11-30T16:56:19.163266+02:00",
      "endDate": "2017-12-13T23:59:50+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-12-14T00:00:00+02:00"
    },
    "procurementMethodType": "dgfOtherAssets",
    "dgfID": "219560",
    "date": "2017-11-30T16:56:19.212525+02:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CPV",
          "description": "Земельні ділянки",
          "id": "66113000-5"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "c2fb6cf42caf4621b4bcac1deff95286",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "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.3/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2036
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "procurementMethodDetails": "quick, accelerator=1440",
    "tenderAttempts": 1,
    "procurementMethodType": "dgfOtherAssets",
    "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": "м. Київ"
      }
    },
    "submissionMethodDetails": "quick",
    "mode": "test",
    "auctionPeriod": {
      "startDate": "2017-11-30T17:01:17.205813"
    },
    "items": [
      {
        "classification": {
          "scheme": "CPV",
          "id": "66113000-5",
          "description": "Земельні ділянки"
        },
        "quantity": 5,
        "description": "Земля для військовослужбовців",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        }
      }
    ],
    "dgfID": "219560"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/731dc3a4c39a4e0fa97816efac9797d4

{
  "access": {
    "token": "0a74311e81c84f619214161e9a0dd1ef"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-PS-2017-11-30-000001",
    "enquiryPeriod": {
      "startDate": "2017-11-30T16:56:20.188830+02:00",
      "endDate": "2017-11-30T17:00:24.652197+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-11-30T17:00:24.652197+02: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": "731dc3a4c39a4e0fa97816efac9797d4",
    "title": "[ТЕСТУВАННЯ] футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2017-11-30T16:56:20.192610+02:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-11-30T16:56:20.188830+02:00",
      "endDate": "2017-11-30T17:00:24.652197+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-11-30T17:00:24.652197+02:00"
    },
    "procurementMethodType": "dgfOtherAssets",
    "dgfID": "219560",
    "date": "2017-11-30T16:56:20.188830+02:00",
    "submissionMethodDetails": "quick",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CPV",
          "description": "Земельні ділянки",
          "id": "66113000-5"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "27e42212d979407a84f6ff1a6ed55e4e",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "mode": "test",
    "title_ru": "[ТЕСТИРОВАНИЕ] ",
    "awardCriteria": "highestCost"
  }
}

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

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

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

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

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

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