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

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

Зміст:

Огляд

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

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

  • dgfOtherAssets - оголошення аукціону з продажу майна банків.

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

Особливості

  • Відсутність необхідності вказання періоду уточнень (тут немає окремого статусу active.enquiries), оскільки він накладається на період прийому пропозицій active.tendering.

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

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

  • Єдина дата, яку потрібно надати, це дата початку аукціону Tender.auctionPeriod.startDate. Всі решта дати будуть обраховані на її основі.

  • Організатор не може редагувати суттєвих властивостей процедури, наприклад, Auction.value.

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

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

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

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

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

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

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

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

Стан проекту

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

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

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

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

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

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

0.1

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

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

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

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

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

Auction

Схема

id:

uuid, auto-generated, read-only

Internal id of the procedure.
date:

Date, auto-generated, read-only

The date of the procedure creation/undoing.
owner:

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

The entity (eMall) whom the procedure has been created by.
title:

string, multilingual, required

Can be edited during the rectificationPeriod.

  • Ukrainian by default (required) - Ukrainian title
  • title_en (English) - English title
  • title_ru (Russian) - Russian title

Oprionally can be mentioned in English/Russian.

The name of the auction, displayed in listings.
description:

string, multilingual, required

Can be edited during the rectificationPeriod.

OpenContracting Description: A description of the goods, services to be provided.

  • Ukrainian by default - Ukrainian decription
  • decription_en (English) - English decription
  • decription_ru (Russian) - Russian decription
dgfDecisionID:

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

Can be edited during the rectificationPeriod.

The number of the decision.
dgfDecisionDate:
 

Date, required

Can be edited during the rectificationPeriod.

The date of the decision on the approval of the terms of sale.
procurementMethod:
 

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

Purchase method. The only value is “open”.
auctionID:

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

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

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

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

Can be edited during the rectificationPeriod.

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

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

Тип процедури. Можливі значення:

  • dgfOtherAssets - оголошення аукціону з продажу майна банків.

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

string, optional

Parameter that accelerates auction periods. Set quick, accelerator=1440 as text value for procurementMethodDetails for the time frames to be reduced in 1440 times. This mode will work only in the sandbox.
submissionMethod:
 

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

The given value is electronicAuction.
awardCriteria:

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

Сriterion of a winner selection. The given value is highestCost.
procuringEntity:
 

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

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

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

integer, required

Can be edited during the rectificationPeriod.

The number which represents what time (from 1 up to 8) tender is taking place.
value:

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

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

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

Guarantee, required

Can be edited during the rectificationPeriod. guarantee.amount can not be greater than value.amount.

The assumption of responsibility for payment of performance of some obligation if the liable party fails to perform to expectations.
items:

Array of Item objects, required

Can be edited during the rectificationPeriod (Can editing in 2 ways: each object from the array separately and the entire array together).

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

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

Array of Feature objects

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

Array of Document objects

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

Date, auto-generated, read-only

OpenContracting Description: Date when the auction was last modified
questions:

Array of Question objects

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

Array of Bid objects

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

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

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

Can be edited during the rectificationPeriod. minimalStep.amount can not be greater than value.amount.

Крок аукціону та порядок підвищення ціни. Правила валідації:

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

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

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

Array of Award objects

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

Array of Contract objects

OpenContracting Description: Information on contracts signed as part of a process.
rectificationPeriod:
 

Period, auto-generated, read-only

The time span during which the owner can edit some data within the procedure.
enquiryPeriod:

Period, auto-generated, read-only

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

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

Period, auto-generated, read-only

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

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

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

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

url, auto-generated, read-only

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

Period, auto-generated, read-only

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

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:

Array of Cancellation objects.

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

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

Array of Revision objects, auto-generated

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

integer, auto-generated, read-only

Number of bids submitted within the 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: Опис товарів та послуг, які повинні бути надані.

Стислий опис майна (для процедури dgfOtherAssets) АБО Стислий опис активу та забезпечення (для процедури dgfFinancialAssets).
classification:

Classification

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

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

SchemaProperties

OpenContracting Description: A detailed specification of the fields and data structures to use when publishing contracting data.
additionalClassifications:
 

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

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

The possible additional classifiers are CPVS and koatuu.
unit:

Unit

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

ціле число

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

Address

Адреса місцезнаходження майна (для процедури dgfOtherAssets) АБО Адреса місцезнаходження активу (для процедури dgfFinancialAssets).
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: Назва одиниці виміру

SchemaProperties

Схема

code:

string, required, should match classification.id
version:

string, optional, identifies the scheme version

If not specified, the latest version will be used.
properties:

dictionary, match the version and code used

The detailed description is given here: http://schemas.api-docs.ea.openprocurement.io/en/latest/

Document

Схема

id:

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

рядок

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

  • notice - Auction notice

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

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

    Detailed technical information about goods or services to be provided.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • x_dgfAssetFamiliarization - Asset Familiarization

    Goods examination procedure rules / Asset familiarization procedure in data room. Contains information on where and when a given document can be examined offline.

Можливі значення для 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.

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.verification- очікується завантаження підписаного переможцем протоколу аукціону

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

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

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

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

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

Period

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

Period

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

Period

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

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

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

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

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

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

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

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

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

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

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

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

Period

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

Question

Схема

id:

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

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

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

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

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

рядок

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

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

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

рядок

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

рядок

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

  • auction
  • item
relatedItem:

рядок

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

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: Дата підписання договору. Якщо було декілька підписань, то береться дата останнього підписання.
signingPeriod:

Period

OpenContracting Description: The start and end date for the contract signing.
datePaid:

рядок, Date

OpenContracting Description: The date the contract was paid.
date:

рядок, Date

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

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

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

Prolongation

Schema

id:

UID, auto-generated

OpenContracting Description: The identifier for this prolongation.
dateCreated:

string, auto-generated, Date

OpenContracting Description: The date when Prolongation was created.
decisionID:

string, required

OpenContracting Description: Id of document, that allows prolongation.
status:

string, required

OpenContracting Description: The current status of prolongation.

Possible values are:

  • draft - this prolongation has been proposed, but is not yet in force. It may be awaiting activation.
  • applied - this prolongation has been applied, and is now legally in force.
description:

string, required

OpenContracting Description: Prolongation description. Minimal length - 10 letters.
datePublished:

string, required, Date

OpenContracting Description: Date, when document, that caused this prolongation, came in force.
documents:

List of Document objects

OpenContracting Description: All documents and attachments related to the prolongation, including any notices.
reason:

string, required

OpenContracting Description: Reason, that caused prolongation.

Possible values are:

  • dgfPaymentImpossibility - Prolongation was caused by payment impossibility of buyer.
  • dgfLackOfDocuments - Prolongation was caused by lack of documents.
  • dgfLegalObstacles - Prolongation was caused by some legal obstacles.
  • other - Some other causes.

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.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 409
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/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=8dnERkLYD2IPoGGwxM8T5EEYGGxJ2OW5qIMRC7n1K2CC9QK8Wjd9%2BEqmaBfbfoKw5waUSG2AVMhaNuJ9kX37Dw%3D%3D",
    "format": "application/pdf",
    "documentType": "technicalSpecifications"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/bb517ba5ca544fd7b21eaf894a63afd7
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.649805+03:00",
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-11T15:06:07.649826+03:00",
    "id": "bb517ba5ca544fd7b21eaf894a63afd7"
  }
}

  3. Завантажити документ в document service.

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

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

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

    POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 409
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/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=8dnERkLYD2IPoGGwxM8T5EEYGGxJ2OW5qIMRC7n1K2CC9QK8Wjd9%2BEqmaBfbfoKw5waUSG2AVMhaNuJ9kX37Dw%3D%3D",
    "format": "application/pdf",
    "documentType": "technicalSpecifications"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/bb517ba5ca544fd7b21eaf894a63afd7
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.649805+03:00",
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-11T15:06:07.649826+03:00",
    "id": "bb517ba5ca544fd7b21eaf894a63afd7"
  }
}

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

Для більш детальної інформації зверніться до секції Award

digraph G { subgraph cluster_1 { node [style=filled, color=lightblue]; edge[style=dotted]; "pending.waiting" -> cancelled[label="2nd award only" fontcolor=blue]; node [style=filled, color=lightgrey]; edge[label="***" style=solid]; "pending" -> unsuccessful; edge[label="**" style=dashed]; "pending" -> "acive"; edge[label="*" style=solid]; "pending.waiting" -> "pending"; label = "Awarding Process"; color=blue } }

Умовні Позначення

Світло-сині об’єкти на рисунку відображають статуси лише для award #2

* award for winner is always formed in pending.

** protocol is downloaded and award is switched to active by the organizer.

*** auction protocol was not uploaded and award was not activated

Ролі

Chronograph:

суцільна лінія
Organizer:

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

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

digraph G { subgraph cluster_1 { node [style=filled, color=lightgrey]; edge[label="**" style=solid]; "pending" -> "cancelled"; edge[label="*" style=dashed]; "pending" -> "active" label = "Contract Workflow"; color=blue } }

Умовні Позначення

* document was downloaded to contract. The contract itself was successfully activated by the organizer.

** there was no document uploaded. The organizer din not activate the contract.

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

  1. The award with the highest qualifying bid initially receives a pending status. The procedure enters the verificationPeriod stage, which lasts 0-4 business days. Unless the protocol is uploaded and confirmed by the organizer in 4 business days, the award receives an unsuccessful status. Otherwise, the organizer manually switches the award status to active. Simultaneously, the contract is being created in pending status.
  2. It is then when the qualification procedure enters the signingPeriod stage, which lasts up to 20 business days from the beginning of the highest bidder qualification process. Within this time, the organizer can optionally set the day when the payment has been received. Also the organizer should upload and activate the contract in the system by the end of the signingPeriod in order to successfully finish the qualification procedure. Otherwise - the contract will become cancelled and the qualification of the second highest qualifying bidder will begin given that they have not disqualified themselves by this time.
  3. The second highest qualifying bidder, immediately after the auction ending receives the pending.waiting status, in which by default they agree to wait for the end of the qualification of the highest qualifying bidder to be eligible to go through the qualification process if the highest bidder is disqualified. The only action that they can make is to manually cancel the award decision - withdraw the security deposit and lose the chance to become a winner of the auction. If that is done and the first highest qualifying bidder becomes unsuccessful, the procedure receives the unsuccessful status. Provided that first award gets disqualified while the second has not disqualified themselves, the second award automatically changes its status from pending.waiting to pending, after which they undergo the same qualification procedure as outlined above for the first award.

Примітки

  1. For the bidder to be qualified and not invalidated, the bid should be in the amount of more or equal to the starting price of the auction + the minimal step of the auction.

    1.1 У випадку коли дві найвищі ставки в аукціоні не перевищують початкової ціни аукціону + мінімальний крок, рішення про кваліфікацію (аварди) не формуються взагалі, а процедура кваліфікації переходить в статус неуспішної (“unsuccessful).

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

  2. The organizer can disqualify the award at any stage of the awarding process up to the moment, when the contract is created in the system.

  3. The second highest qualifying bidder can disqualify themselves at any point in time BEFORE the start of their qualification process.

Статуси

pending.waiting:
 

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

Terminal status.
pending:
Award:Awaiting protocol upload and confirmation by the organizer. The highest valid bidder is able to submit the protocol as well, although it is not sufficient to move to the next status.
Contract:

Очікується підписання/активація контракту (завантажується та активується в системі організатором). Після закінчення періоду підписання (“signingPeriod”), статус “active” стає термінальним.
active:
Award:Auction protocol was downloaded so that the award could be switched to active by the organizer.
Contract:The document was downloaded to contract so that the status of the object could be switched to active by the organizer.
unsuccessful:

Terminal status.

Туторіал

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

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

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


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

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

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

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

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


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

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

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

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

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


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

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

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

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

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

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

{
  "data": {
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-25"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "DGFOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "submissionMethodDetails": "test submissionMethodDetails",
    "dgfDecisionDate": "2016-11-17",
    "dgfID": "219560",
    "dgfDecisionID": "219560",
    "procurementMethodDetails": "quick, accelerator=1440",
    "items": [
      {
        "classification": {
          "scheme": "CAV",
          "id": "06000000-2",
          "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
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "68942dd9b0fb4e9b80b9826ec12e79da",
    "token": "0052e89467e54a799389e87c87910599"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-24T23:59:50+03:00",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "bb1795e42a4243ada1433ddb18b4f06f",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.421619+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:07.421641+03:00",
        "id": "779f993a42c54eadadff72d66788fb23"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:07.423925+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-25T00:00:00+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:07.421282+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "314f1cb8d47a46009b5c9537e8974be6",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

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

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

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


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

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-24T23:59:50+03:00",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "bb1795e42a4243ada1433ddb18b4f06f",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.421619+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:07.421641+03:00",
        "id": "779f993a42c54eadadff72d66788fb23"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:07.423925+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-25T00:00:00+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:07.421282+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "314f1cb8d47a46009b5c9537e8974be6",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "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": "м. Київ"
      }
    }
  }
}

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

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

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


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

{
  "next_page": {
    "path": "/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.164181%2B03%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.164181%2B03%3A00",
    "offset": "2018-07-11T15:06:07.164181+03:00"
  },
  "data": [
    {
      "id": "6287b62b149840a88b47a6fc61cdc4d2",
      "dateModified": "2018-07-11T15:06:07.164181+03:00"
    }
  ]
}

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

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

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

{
  "data": {
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-25"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "DGFOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "submissionMethodDetails": "test submissionMethodDetails",
    "dgfDecisionDate": "2016-11-17",
    "dgfID": "219560",
    "title_ru": "футляры к государственным наградам",
    "dgfDecisionID": "219560",
    "procurementMethodDetails": "quick, accelerator=1440",
    "items": [
      {
        "classification": {
          "scheme": "CAV",
          "id": "06000000-2",
          "description": "Земельні ділянки"
        },
        "description": "Земля для військовослужбовців",
        "id": "4d668ec03a46438baaf85cddd1e70378",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "title_en": "Cases with state awards",
    "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": "м. Київ"
      }
    }
  }
}


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

{
  "access": {
    "transfer": "98dc2fd8c7fc4425b9021a5db91ed497",
    "token": "7145d40df47649258aae10eb7cbe45fe"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000003",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:07.500869+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-24T23:59:50+03:00",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "title_en": "Cases with state awards",
    "id": "2713725bc7144374905f7dbc0182bede",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.501185+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:07.501206+03:00",
        "id": "8ccfb7893cfc474099b81408a9f85e21"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:07.503399+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:07.500869+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-25T00:00:00+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:07.500869+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "description": "Земля для військовослужбовців",
        "id": "4d668ec03a46438baaf85cddd1e70378",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "title_ru": "футляры к государственным наградам",
    "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": "м. Київ"
      }
    }
  }
}

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

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

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


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

{
  "next_page": {
    "path": "/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.423925%2B03%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.423925%2B03%3A00",
    "offset": "2018-07-11T15:06:07.423925+03:00"
  },
  "data": [
    {
      "id": "6287b62b149840a88b47a6fc61cdc4d2",
      "dateModified": "2018-07-11T15:06:07.164181+03:00"
    },
    {
      "id": "bb1795e42a4243ada1433ddb18b4f06f",
      "dateModified": "2018-07-11T15:06:07.423925+03:00"
    }
  ]
}

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

Creating auction from the given lot

Let’s create a procedure considering the lot created before within the registry:

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

{
  "data": {
    "status": "draft",
    "merchandisingObject": "da232f129d5d448f96e62b81b6bb755c",
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-25"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "DGFOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "submissionMethodDetails": "test submissionMethodDetails",
    "dgfDecisionDate": "2016-11-17",
    "dgfID": "219560",
    "dgfDecisionID": "219560",
    "procurementMethodDetails": "quick, accelerator=1440",
    "items": [
      {
        "classification": {
          "scheme": "CAV",
          "id": "06000000-2",
          "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
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/0f514d78026041b8919457f7ae762887
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "eb9215a5bd744ebea47d575256cd0986",
    "token": "395a0e92cc26453a87782b8e1b1a3c3c"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "merchandisingObject": "da232f129d5d448f96e62b81b6bb755c",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:03.936421+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "0f514d78026041b8919457f7ae762887",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:03.936720+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:03.936741+03:00",
        "id": "8ef00a68c36d49e8816401602733a5ae"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-11T15:06:03.938788+03:00",
    "status": "draft",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:03.936421+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "procurementMethodDetails": "quick, accelerator=1440",
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:03.936421+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "597c0fc83beb4f36b74ca596b615f97a",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "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": "м. Київ"
      }
    }
  }
}

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

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "tenderPeriod": {
      "endDate": "2018-07-26T15:06:17.585732+03:00"
    }
  }
}


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

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-24T23:59:50+03:00",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "bb1795e42a4243ada1433ddb18b4f06f",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.421619+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:07.421641+03:00",
        "id": "779f993a42c54eadadff72d66788fb23"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:07.423925+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-25T00:00:00+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:07.421282+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "314f1cb8d47a46009b5c9537e8974be6",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "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": "м. Київ"
      }
    }
  }
}

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

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

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


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

{
  "next_page": {
    "path": "/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.556898%2B03%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.556898%2B03%3A00",
    "offset": "2018-07-11T15:06:07.556898+03:00"
  },
  "data": [
    {
      "id": "6287b62b149840a88b47a6fc61cdc4d2",
      "dateModified": "2018-07-11T15:06:07.164181+03:00"
    },
    {
      "id": "bb1795e42a4243ada1433ddb18b4f06f",
      "dateModified": "2018-07-11T15:06:07.423925+03:00"
    },
    {
      "id": "2713725bc7144374905f7dbc0182bede",
      "dateModified": "2018-07-11T15:06:07.503399+03:00"
    },
    {
      "id": "2079827e0402455fbe0bf27ef188dd7b",
      "dateModified": "2018-07-11T15:06:07.556898+03:00"
    }
  ]
}

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

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 409
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/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=8dnERkLYD2IPoGGwxM8T5EEYGGxJ2OW5qIMRC7n1K2CC9QK8Wjd9%2BEqmaBfbfoKw5waUSG2AVMhaNuJ9kX37Dw%3D%3D",
    "format": "application/pdf",
    "documentType": "technicalSpecifications"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/bb517ba5ca544fd7b21eaf894a63afd7
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.649805+03:00",
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-11T15:06:07.649826+03:00",
    "id": "bb517ba5ca544fd7b21eaf894a63afd7"
  }
}

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/bb517ba5ca544fd7b21eaf894a63afd7 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.649805+03:00",
    "previousVersions": [],
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-11T15:06:07.649826+03:00",
    "id": "bb517ba5ca544fd7b21eaf894a63afd7"
  }
}

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 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/b85f96f321fe44378c76605a075f4f80?KeyID=172d32c8&Signature=fX2WtYTed%2FzWbmhHT9OFfkIxiA%2F%2FPBBxs2ODAvo2ViulEoKQWj9vRcNvCYsD3iRUFlBmoEJP0b5rNcXLWm0LBw%3D%3D",
    "title": "AwardCriteria.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/cf91c283f3b04cb5a76d9368d69c161f
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b85f96f321fe44378c76605a075f4f80?KeyID=172d32c8&Signature=PkSkrOo6heBcy1Yh5exZo2ksJMI%252BZ%252BnflXz065HAzV8GyrYKBR2WKxNwzFVsf3q3DaoDK%252BkDENPI22kcXAmPBg%253D%253D",
    "title": "AwardCriteria.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.703749+03:00",
    "dateModified": "2018-07-11T15:06:07.703770+03:00",
    "id": "cf91c283f3b04cb5a76d9368d69c161f"
  }
}

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

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


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

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.421619+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:07.421641+03:00",
      "id": "779f993a42c54eadadff72d66788fb23"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.649805+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:07.649826+03:00",
      "id": "bb517ba5ca544fd7b21eaf894a63afd7"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b85f96f321fe44378c76605a075f4f80?KeyID=172d32c8&Signature=PkSkrOo6heBcy1Yh5exZo2ksJMI%252BZ%252BnflXz065HAzV8GyrYKBR2WKxNwzFVsf3q3DaoDK%252BkDENPI22kcXAmPBg%253D%253D",
      "title": "AwardCriteria.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.703749+03:00",
      "dateModified": "2018-07-11T15:06:07.703770+03:00",
      "id": "cf91c283f3b04cb5a76d9368d69c161f"
    }
  ]
}

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

PUT /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/cf91c283f3b04cb5a76d9368d69c161f?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 342
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=8eDrypjKBIx1ehurKjEe%2B1ww%2FONYm2AC1P1%2BDdaEeaBUKtK9TlcGlD059rgFQvW3GYOLIcz4n%2Bx6zDaEdHO1Bg%3D%3D",
    "title": "AwardCriteria-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
    "title": "AwardCriteria-2.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.703749+03:00",
    "dateModified": "2018-07-11T15:06:07.765929+03:00",
    "id": "cf91c283f3b04cb5a76d9368d69c161f"
  }
}

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

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


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

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.421619+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:07.421641+03:00",
      "id": "779f993a42c54eadadff72d66788fb23"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.649805+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:07.649826+03:00",
      "id": "bb517ba5ca544fd7b21eaf894a63afd7"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.703749+03:00",
      "dateModified": "2018-07-11T15:06:07.765929+03:00",
      "id": "cf91c283f3b04cb5a76d9368d69c161f"
    }
  ]
}

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

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

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 432
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/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=44NDlwGUSjchl%2F1E9rd8cJIkXYeL%2FbHuVYTGAW8qTMiKBcATXGrfJC3TFdBElOlF%2FLmzbRZmQOGj3UmUjE7dBg%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/dbe0ca0c582b422d84c59a2aa93eb948
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 1,
    "hash": "md5:00000000000000000000000000000000",
    "description": "First illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=UPMVnKZTzNNA9AxDywJSZbpPjStBGoee80QWYvawEzzQnVYTxYuijJO8UMScqwMcbt5qrdjYn5jyfUyhvZzkDA%253D%253D",
    "title": "first_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.828825+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-11T15:06:07.828844+03:00",
    "id": "dbe0ca0c582b422d84c59a2aa93eb948"
  }
}

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

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


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

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.421619+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:07.421641+03:00",
      "id": "779f993a42c54eadadff72d66788fb23"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.649805+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:07.649826+03:00",
      "id": "bb517ba5ca544fd7b21eaf894a63afd7"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.703749+03:00",
      "dateModified": "2018-07-11T15:06:07.765929+03:00",
      "id": "cf91c283f3b04cb5a76d9368d69c161f"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=UPMVnKZTzNNA9AxDywJSZbpPjStBGoee80QWYvawEzzQnVYTxYuijJO8UMScqwMcbt5qrdjYn5jyfUyhvZzkDA%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.828825+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.828844+03:00",
      "id": "dbe0ca0c582b422d84c59a2aa93eb948"
    }
  ]
}

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 428
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/240fe6c71e5a4291a3c9e39fbfeb460e?KeyID=172d32c8&Signature=aiaYSVot6s3YWRq8zdCetQDBq2FwrP1LstPmGw6EcG5s4bTvKFYjg0EnTewJ7KV14YbTt8DHzOhiPpb0hJirAA%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/402f115c7eb445c3a42eb624d2b45e17
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Second illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/240fe6c71e5a4291a3c9e39fbfeb460e?KeyID=172d32c8&Signature=k8V7cIG6xo5fopPWo%252B%2Fl3mxaliitImmqxRxKPbsJATjwe8Fde63J7%252BzgghykfYCTn9QwuMx1aVg1G6iNu7PNDg%253D%253D",
    "title": "second_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.897398+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-11T15:06:07.897419+03:00",
    "id": "402f115c7eb445c3a42eb624d2b45e17"
  }
}

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 442
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/e401fae3f2004d11ac67e9b444eb6d09?KeyID=172d32c8&Signature=Mxs%2F2%2B03GvbmBy%2FZePxtBa8qVpaWmWJ1t%2FyuYSRbQTb%2Fm2Pw%2BvhOGL3n%2B2jOpvRdAroJNQHk5OFyYBI3q%2FMvAw%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/feae4575ced24c718bae0f05d904c810
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Third illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/e401fae3f2004d11ac67e9b444eb6d09?KeyID=172d32c8&Signature=h7%2FVgGCvrQZMhz5xn6tYcxZ809Rxn25ohwJIoTihWblO8DCl2FHeJwFkHE3ZGUZeHBWCQ8ANi5eQEUiyd78qAg%253D%253D",
    "title": "third_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.952905+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-11T15:06:07.952925+03:00",
    "id": "feae4575ced24c718bae0f05d904c810"
  }
}

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

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

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


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

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.421619+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:07.421641+03:00",
      "id": "779f993a42c54eadadff72d66788fb23"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.649805+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:07.649826+03:00",
      "id": "bb517ba5ca544fd7b21eaf894a63afd7"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.703749+03:00",
      "dateModified": "2018-07-11T15:06:07.765929+03:00",
      "id": "cf91c283f3b04cb5a76d9368d69c161f"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=UPMVnKZTzNNA9AxDywJSZbpPjStBGoee80QWYvawEzzQnVYTxYuijJO8UMScqwMcbt5qrdjYn5jyfUyhvZzkDA%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.828825+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.828844+03:00",
      "id": "dbe0ca0c582b422d84c59a2aa93eb948"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Second illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/240fe6c71e5a4291a3c9e39fbfeb460e?KeyID=172d32c8&Signature=k8V7cIG6xo5fopPWo%252B%2Fl3mxaliitImmqxRxKPbsJATjwe8Fde63J7%252BzgghykfYCTn9QwuMx1aVg1G6iNu7PNDg%253D%253D",
      "title": "second_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.897398+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.897419+03:00",
      "id": "402f115c7eb445c3a42eb624d2b45e17"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Third illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/e401fae3f2004d11ac67e9b444eb6d09?KeyID=172d32c8&Signature=h7%2FVgGCvrQZMhz5xn6tYcxZ809Rxn25ohwJIoTihWblO8DCl2FHeJwFkHE3ZGUZeHBWCQ8ANi5eQEUiyd78qAg%253D%253D",
      "title": "third_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.952905+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.952925+03:00",
      "id": "feae4575ced24c718bae0f05d904c810"
    }
  ]
}

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

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

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

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


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/questions/a19723c4af2948e48995d4888b25e4a6
X-Content-Type-Options: nosniff

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "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": "м. Вінниця"
      }
    },
    "title": "Калорійність",
    "date": "2018-07-11T15:06:08.106325+03:00",
    "id": "a19723c4af2948e48995d4888b25e4a6",
    "questionOf": "tender"
  }
}

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/questions/a19723c4af2948e48995d4888b25e4a6?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


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

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

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

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


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

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

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/questions/a19723c4af2948e48995d4888b25e4a6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

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

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

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

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

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


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a
X-Content-Type-Options: nosniff

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

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a?acc_token=035a14661c204ad9a32c92d733351401 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


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

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

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a/documents?acc_token=035a14661c204ad9a32c92d733351401 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/c3462446d3094ed599f5980902c2f5dd?KeyID=172d32c8&Signature=ZNCG2Ohe0r0LHYHaGTQ4QWbcGRY39%2BgS0MsqzxHy9MwZM7p65GFqsaKNcRVUX1HxpTWHCoJTJk84l90WOgwKCQ%3D%3D",
    "title": "Proposal.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a/documents/b15abb588cf541c9b6fbd705a42d5790
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a/documents/b15abb588cf541c9b6fbd705a42d5790?download=c3462446d3094ed599f5980902c2f5dd",
    "title": "Proposal.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:08.403731+03:00",
    "dateModified": "2018-07-11T15:06:08.403752+03:00",
    "id": "b15abb588cf541c9b6fbd705a42d5790"
  }
}

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a/documents?acc_token=035a14661c204ad9a32c92d733351401 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a/documents/b15abb588cf541c9b6fbd705a42d5790?download=c3462446d3094ed599f5980902c2f5dd",
      "title": "Proposal.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:08.403731+03:00",
      "dateModified": "2018-07-11T15:06:08.403752+03:00",
      "id": "b15abb588cf541c9b6fbd705a42d5790"
    }
  ]
}

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

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

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


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/e17d3f64fe214a6b846c885cdf2aaa9b
X-Content-Type-Options: nosniff

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

Аукціон

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

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


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

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "auctionUrl": "http://auction-sandbox.openprocurement.org/auctions/bb1795e42a4243ada1433ddb18b4f06f",
    "enquiryPeriod": {
      "startDate": "2018-07-04T15:06:01.997072+03:00",
      "endDate": "2018-07-11T15:06:01.997072+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-11T15:50:01.997072+03:00",
    "awardCriteria": "highestCost",
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "title": "Калорійність",
        "date": "2018-07-11T15:06:08.106325+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "a19723c4af2948e48995d4888b25e4a6",
        "questionOf": "tender"
      }
    ],
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "bb1795e42a4243ada1433ddb18b4f06f",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.421619+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:07.421641+03:00",
        "id": "779f993a42c54eadadff72d66788fb23"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.649805+03:00",
        "documentType": "technicalSpecifications",
        "dateModified": "2018-07-11T15:06:07.649826+03:00",
        "id": "bb517ba5ca544fd7b21eaf894a63afd7"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b85f96f321fe44378c76605a075f4f80?KeyID=172d32c8&Signature=PkSkrOo6heBcy1Yh5exZo2ksJMI%252BZ%252BnflXz065HAzV8GyrYKBR2WKxNwzFVsf3q3DaoDK%252BkDENPI22kcXAmPBg%253D%253D",
        "title": "AwardCriteria.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.703749+03:00",
        "dateModified": "2018-07-11T15:06:07.703770+03:00",
        "id": "cf91c283f3b04cb5a76d9368d69c161f"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
        "title": "AwardCriteria-2.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.703749+03:00",
        "dateModified": "2018-07-11T15:06:07.765929+03:00",
        "id": "cf91c283f3b04cb5a76d9368d69c161f"
      },
      {
        "index": 1,
        "hash": "md5:00000000000000000000000000000000",
        "description": "First illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=UPMVnKZTzNNA9AxDywJSZbpPjStBGoee80QWYvawEzzQnVYTxYuijJO8UMScqwMcbt5qrdjYn5jyfUyhvZzkDA%253D%253D",
        "title": "first_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.828825+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-11T15:06:07.828844+03:00",
        "id": "dbe0ca0c582b422d84c59a2aa93eb948"
      },
      {
        "index": 2,
        "hash": "md5:00000000000000000000000000000000",
        "description": "Second illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/240fe6c71e5a4291a3c9e39fbfeb460e?KeyID=172d32c8&Signature=k8V7cIG6xo5fopPWo%252B%2Fl3mxaliitImmqxRxKPbsJATjwe8Fde63J7%252BzgghykfYCTn9QwuMx1aVg1G6iNu7PNDg%253D%253D",
        "title": "second_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.897398+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-11T15:06:07.897419+03:00",
        "id": "402f115c7eb445c3a42eb624d2b45e17"
      },
      {
        "index": 2,
        "hash": "md5:00000000000000000000000000000000",
        "description": "Third illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/e401fae3f2004d11ac67e9b444eb6d09?KeyID=172d32c8&Signature=h7%2FVgGCvrQZMhz5xn6tYcxZ809Rxn25ohwJIoTihWblO8DCl2FHeJwFkHE3ZGUZeHBWCQ8ANi5eQEUiyd78qAg%253D%253D",
        "title": "third_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.952905+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-11T15:06:07.952925+03:00",
        "id": "feae4575ced24c718bae0f05d904c810"
      },
      {
        "title": "Familiarization with bank asset",
        "format": "offline/on-site-examination",
        "accessDetails": "Familiar with asset: days, time, address",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:08.031929+03:00",
        "documentType": "x_dgfAssetFamiliarization",
        "dateModified": "2018-07-11T15:06:08.031952+03:00",
        "id": "af860bef04d8419191bd242fbfbd4fc6"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:08.724401+03:00",
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2018-07-04T15:06:01.997072+03:00",
      "endDate": "2018-07-11T15:06:01.997072+03:00"
    },
    "auctionPeriod": {
      "startDate": "2018-07-11T15:06:01.997072+03:00",
      "shouldStartAfter": "2018-07-12T00:00:00+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:07.421282+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "314f1cb8d47a46009b5c9537e8974be6",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "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": "м. Київ"
      }
    }
  }
}

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a?acc_token=035a14661c204ad9a32c92d733351401 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

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

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/e17d3f64fe214a6b846c885cdf2aaa9b?acc_token=5477e8a5a5c34db7a482e95104a740e8 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

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

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

After the competitive auction two awards are created: * for the first candidate (a participant that has submitted the highest valid bid at the auction) - initially has a pending status and awaits auction protocol to be uploaded by the organizer; * for the second candidate (a participant that has submitted the second highest valid bid at the auction)- initially has a pending.waiting status.

Існує ще два сценарії, що можуть мати місце після закінчення аукціону:
  • If the two highest bidders have invalid bids (lower than auction starting price + minimal step), the awards will not be created at all, and the qualification procedure will automatically receive the unsuccessful status.
  • If the second highest bidder has a bid that is less than the starting price + minimal step, two awards are created, with one of them receiving a pending.verification status and undergoing the qualification procedure, and the other (with an invalid bid) automatically becoming unsuccessful.
GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "status": "pending",
      "verificationPeriod": {
        "startDate": "2018-07-11T15:06:09.034064+03:00",
        "endDate": "2018-07-11T15:10:16.111147+03:00"
      },
      "signingPeriod": {
        "startDate": "2018-07-11T15:06:09.034064+03:00",
        "endDate": "2018-07-11T15:26:15.444480+03:00"
      },
      "suppliers": [
        {
          "contactPoint": {
            "email": "aagt@gmail.com",
            "telephone": "+380 (322) 91-69-30",
            "name": "Андрій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137226",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "ДКП «Книга»",
          "address": {
            "postalCode": "79013",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 34",
            "region": "м. Львів",
            "locality": "м. Львів"
          }
        }
      ],
      "complaintPeriod": {
        "startDate": "2018-07-11T15:06:09.034064+03:00"
      },
      "bid_id": "e17d3f64fe214a6b846c885cdf2aaa9b",
      "value": {
        "currency": "UAH",
        "amount": 501.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2018-07-11T15:06:09.034064+03:00",
      "id": "3d052a44e86147129b0b01e3cbec1c14"
    },
    {
      "status": "pending.waiting",
      "complaintPeriod": {
        "startDate": "2018-07-11T15:06:09.034064+03:00"
      },
      "suppliers": [
        {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137256",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        }
      ],
      "bid_id": "33e956525782481880696efc0dc83b4a",
      "value": {
        "currency": "UAH",
        "amount": 500.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2018-07-11T15:06:09.034064+03:00",
      "id": "f0b67608db9b41f6bef95fc82a62f7c1"
    }
  ]
}

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

The organizer must upload and confirm the auction protocol auctionProtocol and add it to the award within 4 business days after the start of the qualification procedure. The candidate still has a possibility to upload the protocol, but it is neither mandatory, nor sufficient to move to the next status. If the auction protocol has not been uploaded before the end of verificationPeriod, the award is automatically transferred to the unsuccessful status.

It is the organizer’s duty to upload and confirm the protocol, as well as to switch the award to active status.

Otherwise, the award will automatically become unsuccessful”

Contract prolongation

Organizer can prolong contract signing period by creating a prolongation object:

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 172
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "decisionID": "ZM-937-99-92",
    "reason": "other",
    "documents": [],
    "description": "Prolongation description",
    "datePublished": "2018-07-11T15:06:02.303212+03:00"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "draft",
    "decisionID": "ZM-937-99-92",
    "description": "Prolongation description",
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "reason": "other",
    "datePublished": "2018-07-11T15:06:02.303212+03:00",
    "id": "22c7acbefec94ec6b8c4b1ad6807a078"
  }
}

For the object to be prolonged the next data has to be included:

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 440
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "title": "ProlongationDocument.doc",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=iBGMtFVPcxjwLQS%2B1XymFi9uNV2G1hWEFRtJ%2BYXylcEIRiYyQ9fy8ZI%2B%2FbX%2F%2FUNHwTbywemLWThl9ijrtjUjCA%3D%3D",
    "format": "application/pdf",
    "documentType": "prolongationProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078/documents/60bfda57b0844971a14ac7dabd950f4e
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=O%2FzNlUmCYhxxyhquaaU61uu7KTePQJsk93f9n0mu63TPpO4J%2Fc0DPjukind8shAJcOSAf7tTgB8NT1zPbPXyDw%253D%253D",
    "title": "ProlongationDocument.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:10.305330+03:00",
    "documentType": "prolongationProtocol",
    "dateModified": "2018-07-11T15:06:10.305361+03:00",
    "id": "60bfda57b0844971a14ac7dabd950f4e"
  }
}

Created prolongation has status “draft” by default, so there is a need to active it:

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "applied"
  }
}


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

{
  "data": {
    "status": "applied",
    "decisionID": "ZM-937-99-92",
    "description": "Prolongation description",
    "datePublished": "2018-07-11T15:06:02.303212+03:00",
    "reason": "other",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "content_with_prolongation_data",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=O%2FzNlUmCYhxxyhquaaU61uu7KTePQJsk93f9n0mu63TPpO4J%2Fc0DPjukind8shAJcOSAf7tTgB8NT1zPbPXyDw%253D%253D",
        "title": "ProlongationDocument.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:10.305330+03:00",
        "documentType": "prolongationProtocol",
        "dateModified": "2018-07-11T15:06:10.305361+03:00",
        "id": "60bfda57b0844971a14ac7dabd950f4e"
      }
    ],
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "id": "22c7acbefec94ec6b8c4b1ad6807a078"
  }
}

When a contract has been prolongated for first time, a short prolongation period (42 business days) is applied. It’s also possible to apply a long-term (132 business days) prolongation: just create new Prolongation for the already prolongated Contract, and apply it.

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 179
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "decisionID": "ZM-937-99-92-2",
    "reason": "other",
    "documents": [],
    "description": "Long prolongation description",
    "datePublished": "2018-07-11T15:06:02.303227+03:00"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "draft",
    "decisionID": "ZM-937-99-92-2",
    "description": "Long prolongation description",
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "reason": "other",
    "datePublished": "2018-07-11T15:06:02.303227+03:00",
    "id": "eb7e1d4d47c041c0882cd91c00952c65"
  }
}

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 436
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "title": "LongProlongationDocument.doc",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=H7WL7UZ1K6NrB9XB4DIHHdHFcwYLL%2F6M8HqBzoZX8jgTJQBx8z6aPv2xyyaCYm%2F3q08eNLwtb44fL65Rm9QmBw%3D%3D",
    "format": "application/pdf",
    "documentType": "prolongationProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65/documents/4e70262362014335b439cd227e5de663
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=g7WWF%2FKSpXzPjRxD2wpet8scNkNCRE%2FNxccqW7Shk4CqmN1i%252Blig00sv80Kuvl0EXTBk3UBjI2umKuFZ8jL7CQ%253D%253D",
    "title": "LongProlongationDocument.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:10.675174+03:00",
    "documentType": "prolongationProtocol",
    "dateModified": "2018-07-11T15:06:10.675194+03:00",
    "id": "4e70262362014335b439cd227e5de663"
  }
}

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "applied"
  }
}


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

{
  "data": {
    "status": "applied",
    "decisionID": "ZM-937-99-92-2",
    "description": "Long prolongation description",
    "datePublished": "2018-07-11T15:06:02.303227+03:00",
    "reason": "other",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "content_with_prolongation_data",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=g7WWF%2FKSpXzPjRxD2wpet8scNkNCRE%2FNxccqW7Shk4CqmN1i%252Blig00sv80Kuvl0EXTBk3UBjI2umKuFZ8jL7CQ%253D%253D",
        "title": "LongProlongationDocument.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:10.675174+03:00",
        "documentType": "prolongationProtocol",
        "dateModified": "2018-07-11T15:06:10.675194+03:00",
        "id": "4e70262362014335b439cd227e5de663"
      }
    ],
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "id": "eb7e1d4d47c041c0882cd91c00952c65"
  }
}

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

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

POST /api/2.5/auctions/d703c42df3b9428c91119666efc96d32/awards/1af9e5d03c144172a542e0a9b736f5ff/documents?acc_token=a2774a39522b480fb72b3b6f8d291c96 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 394
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a792e87740b44405b4ab9341659886af?KeyID=172d32c8&Signature=WJZUGD%2FrehJ%2FHMc2FF88pjA%2FbN%2FQvM8hd5fX%2FKXQr0NAOeD2WItWk2FSokhKqovJmOa954%2BzDTha7h%2Bfpn19BQ%3D%3D",
    "title": "Disqualified_reason.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "description": "Disqualification reason",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/d703c42df3b9428c91119666efc96d32/awards/1af9e5d03c144172a542e0a9b736f5ff/documents/aed404c5e956422f90d00d8f255b4198
X-Content-Type-Options: nosniff

{
  "data": {
    "dateModified": "2018-07-11T15:06:06.085849+03:00",
    "hash": "md5:00000000000000000000000000000000",
    "description": "Disqualification reason",
    "author": "auction_owner",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a792e87740b44405b4ab9341659886af?KeyID=172d32c8&Signature=DXm2Ng5SUJpzDB0RA6H3TScf122R9VY7fRBS4JkzO1FYghCTcKxSngm0YcI%252BVrCyXFTwEKmFHFqSv3wRpn3tCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:06.085830+03:00",
    "title": "Disqualified_reason.pdf",
    "id": "aed404c5e956422f90d00d8f255b4198"
  }
}

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

PATCH /api/2.5/auctions/d703c42df3b9428c91119666efc96d32/awards/1af9e5d03c144172a542e0a9b736f5ff?acc_token=a2774a39522b480fb72b3b6f8d291c96 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
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "unsuccessful",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "bid_owner",
        "title": "auction_protocol.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/0e9d83c40bda4ee686b1ee770f4ae29d?KeyID=172d32c8&Signature=KF2%2F0siIuSjSWeLo4w1mQYg4aXF9E996sRRLaLZQyMpPSVReZ69CQ%2F1k43228sZWTwytyB3JVPnA%2FlmZvNYGBw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:05.985154+03:00",
        "documentType": "auctionProtocol",
        "dateModified": "2018-07-11T15:06:05.985173+03:00",
        "id": "d5f65b961f574b25acf9cbfa7a6ccf95"
      },
      {
        "dateModified": "2018-07-11T15:06:06.085849+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "description": "Disqualification reason",
        "author": "auction_owner",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a792e87740b44405b4ab9341659886af?KeyID=172d32c8&Signature=DXm2Ng5SUJpzDB0RA6H3TScf122R9VY7fRBS4JkzO1FYghCTcKxSngm0YcI%252BVrCyXFTwEKmFHFqSv3wRpn3tCQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:06.085830+03:00",
        "title": "Disqualified_reason.pdf",
        "id": "aed404c5e956422f90d00d8f255b4198"
      }
    ],
    "verificationPeriod": {
      "startDate": "2018-07-11T15:06:05.868405+03:00",
      "endDate": "2018-07-11T15:06:06.195718+03: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": "2018-07-11T15:06:05.564780+03:00",
      "endDate": "2018-07-11T15:06:06.195718+03:00"
    },
    "bid_id": "7decb4064e5846949180ea56c86da1c0",
    "value": {
      "currency": "UAH",
      "amount": 475.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:06.204752+03:00",
    "id": "1af9e5d03c144172a542e0a9b736f5ff",
    "signingPeriod": {
      "startDate": "2018-07-11T15:06:05.868405+03:00",
      "endDate": "2018-07-11T15:26:12.281599+03:00"
    }
  }
}

Within 20 business days since becoming candidate a new candidate must confirm qualification with steps described above (Кваліфікація).

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

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/awards/f0b67608db9b41f6bef95fc82a62f7c1?acc_token=035a14661c204ad9a32c92d733351401 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
X-Content-Type-Options: nosniff

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

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

The candidate has 20 business days after becoming a candidate to conclude a contract with the bank based on the results of electronic auction.

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

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 345
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/46cb517bd7684c1a9779bc6c6b61aa3b?KeyID=172d32c8&Signature=obA0anF8xK3cwzh7atz0SLsB9v9i7qTz08XHuJ0oYnsui4uYlKDN3YdI8BCQ5MltDGz4AHsb39J71XMQO09sAQ%3D%3D",
    "title": "contract_first_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents/ed5631e083de4bb78654b925d57868b5
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/46cb517bd7684c1a9779bc6c6b61aa3b?KeyID=172d32c8&Signature=XvKnw4LjI6hr76DvKNP0ErxWYsLQfH2zRLwnDcs056LoQkSA92m2ch1bsVlfVzGADUyXv4zaoFuwEJMtnVN%252BCQ%253D%253D",
    "title": "contract_first_document.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:09.858414+03:00",
    "dateModified": "2018-07-11T15:06:09.858435+03:00",
    "id": "ed5631e083de4bb78654b925d57868b5"
  }
}

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

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/46cb517bd7684c1a9779bc6c6b61aa3b?KeyID=172d32c8&Signature=XvKnw4LjI6hr76DvKNP0ErxWYsLQfH2zRLwnDcs056LoQkSA92m2ch1bsVlfVzGADUyXv4zaoFuwEJMtnVN%252BCQ%253D%253D",
      "title": "contract_first_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:09.858414+03:00",
      "dateModified": "2018-07-11T15:06:09.858435+03:00",
      "id": "ed5631e083de4bb78654b925d57868b5"
    }
  ]
}

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents?acc_token=0052e89467e54a799389e87c87910599 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/91892b0c6fed455bb136447fb6f9e03c?KeyID=172d32c8&Signature=oSIvQw4xaTFtxOjnX1C4fWJYZiGQ7INXf9VH1C496FsjWMZAA6UwLGpvhnOX6tW1DQ%2BmoQTpSi5wvI%2FuOGhFDw%3D%3D",
    "title": "contract_second_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents/bf57bef28c0548d7aac002e48b85d4a1
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/91892b0c6fed455bb136447fb6f9e03c?KeyID=172d32c8&Signature=LNrfV4IvqjUYzlQKQB6degrvA%2FNfGIS%2FgbgbF09lzg26JZ%2FGx8kh7iwpJ7R%2Fxu5YB51EVq%2F5j7GaC2thrQXbDA%253D%253D",
    "title": "contract_second_document.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:10.026475+03:00",
    "dateModified": "2018-07-11T15:06:10.026498+03:00",
    "id": "bf57bef28c0548d7aac002e48b85d4a1"
  }
}

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

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/46cb517bd7684c1a9779bc6c6b61aa3b?KeyID=172d32c8&Signature=XvKnw4LjI6hr76DvKNP0ErxWYsLQfH2zRLwnDcs056LoQkSA92m2ch1bsVlfVzGADUyXv4zaoFuwEJMtnVN%252BCQ%253D%253D",
      "title": "contract_first_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:09.858414+03:00",
      "dateModified": "2018-07-11T15:06:09.858435+03:00",
      "id": "ed5631e083de4bb78654b925d57868b5"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/91892b0c6fed455bb136447fb6f9e03c?KeyID=172d32c8&Signature=LNrfV4IvqjUYzlQKQB6degrvA%2FNfGIS%2FgbgbF09lzg26JZ%2FGx8kh7iwpJ7R%2Fxu5YB51EVq%2F5j7GaC2thrQXbDA%253D%253D",
      "title": "contract_second_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:10.026475+03:00",
      "dateModified": "2018-07-11T15:06:10.026498+03:00",
      "id": "bf57bef28c0548d7aac002e48b85d4a1"
    }
  ]
}

Contract prolongation

Organizer can prolongate contract signing period by creating prolongation

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 172
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "decisionID": "ZM-937-99-92",
    "reason": "other",
    "documents": [],
    "description": "Prolongation description",
    "datePublished": "2018-07-11T15:06:02.303212+03:00"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "draft",
    "decisionID": "ZM-937-99-92",
    "description": "Prolongation description",
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "reason": "other",
    "datePublished": "2018-07-11T15:06:02.303212+03:00",
    "id": "22c7acbefec94ec6b8c4b1ad6807a078"
  }
}

Prolongation must have documents attached to be prepared for activation

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 440
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "title": "ProlongationDocument.doc",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=iBGMtFVPcxjwLQS%2B1XymFi9uNV2G1hWEFRtJ%2BYXylcEIRiYyQ9fy8ZI%2B%2FbX%2F%2FUNHwTbywemLWThl9ijrtjUjCA%3D%3D",
    "format": "application/pdf",
    "documentType": "prolongationProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078/documents/60bfda57b0844971a14ac7dabd950f4e
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=O%2FzNlUmCYhxxyhquaaU61uu7KTePQJsk93f9n0mu63TPpO4J%2Fc0DPjukind8shAJcOSAf7tTgB8NT1zPbPXyDw%253D%253D",
    "title": "ProlongationDocument.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:10.305330+03:00",
    "documentType": "prolongationProtocol",
    "dateModified": "2018-07-11T15:06:10.305361+03:00",
    "id": "60bfda57b0844971a14ac7dabd950f4e"
  }
}

Created prolongation has status “draft” by default, so there is a need to set status to “applied” to make it active.

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "applied"
  }
}


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

{
  "data": {
    "status": "applied",
    "decisionID": "ZM-937-99-92",
    "description": "Prolongation description",
    "datePublished": "2018-07-11T15:06:02.303212+03:00",
    "reason": "other",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "content_with_prolongation_data",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=O%2FzNlUmCYhxxyhquaaU61uu7KTePQJsk93f9n0mu63TPpO4J%2Fc0DPjukind8shAJcOSAf7tTgB8NT1zPbPXyDw%253D%253D",
        "title": "ProlongationDocument.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:10.305330+03:00",
        "documentType": "prolongationProtocol",
        "dateModified": "2018-07-11T15:06:10.305361+03:00",
        "id": "60bfda57b0844971a14ac7dabd950f4e"
      }
    ],
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "id": "22c7acbefec94ec6b8c4b1ad6807a078"
  }
}

When a contract has been prolongated for first time, a short prolongation period applies. It is equal to 42 working days. It’s also possible to apply long-term (132 days) prolongation: just create new Prolongation for the already prolongated Contract, and apply it.

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 179
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "decisionID": "ZM-937-99-92-2",
    "reason": "other",
    "documents": [],
    "description": "Long prolongation description",
    "datePublished": "2018-07-11T15:06:02.303227+03:00"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "draft",
    "decisionID": "ZM-937-99-92-2",
    "description": "Long prolongation description",
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "reason": "other",
    "datePublished": "2018-07-11T15:06:02.303227+03:00",
    "id": "eb7e1d4d47c041c0882cd91c00952c65"
  }
}

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 436
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "title": "LongProlongationDocument.doc",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=H7WL7UZ1K6NrB9XB4DIHHdHFcwYLL%2F6M8HqBzoZX8jgTJQBx8z6aPv2xyyaCYm%2F3q08eNLwtb44fL65Rm9QmBw%3D%3D",
    "format": "application/pdf",
    "documentType": "prolongationProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65/documents/4e70262362014335b439cd227e5de663
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=g7WWF%2FKSpXzPjRxD2wpet8scNkNCRE%2FNxccqW7Shk4CqmN1i%252Blig00sv80Kuvl0EXTBk3UBjI2umKuFZ8jL7CQ%253D%253D",
    "title": "LongProlongationDocument.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:10.675174+03:00",
    "documentType": "prolongationProtocol",
    "dateModified": "2018-07-11T15:06:10.675194+03:00",
    "id": "4e70262362014335b439cd227e5de663"
  }
}

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "applied"
  }
}


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

{
  "data": {
    "status": "applied",
    "decisionID": "ZM-937-99-92-2",
    "description": "Long prolongation description",
    "datePublished": "2018-07-11T15:06:02.303227+03:00",
    "reason": "other",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "content_with_prolongation_data",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=g7WWF%2FKSpXzPjRxD2wpet8scNkNCRE%2FNxccqW7Shk4CqmN1i%252Blig00sv80Kuvl0EXTBk3UBjI2umKuFZ8jL7CQ%253D%253D",
        "title": "LongProlongationDocument.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:10.675174+03:00",
        "documentType": "prolongationProtocol",
        "dateModified": "2018-07-11T15:06:10.675194+03:00",
        "id": "4e70262362014335b439cd227e5de663"
      }
    ],
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "id": "eb7e1d4d47c041c0882cd91c00952c65"
  }
}

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

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 80
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "active",
    "dateSigned": "2018-07-11T15:06:10.900112+03:00"
  }
}


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

{
  "data": {
    "status": "active",
    "prolongations": [
      {
        "status": "applied",
        "decisionID": "ZM-937-99-92",
        "description": "Prolongation description",
        "datePublished": "2018-07-11T15:06:02.303212+03:00",
        "reason": "other",
        "documents": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "description": "content_with_prolongation_data",
            "format": "application/pdf",
            "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=O%2FzNlUmCYhxxyhquaaU61uu7KTePQJsk93f9n0mu63TPpO4J%2Fc0DPjukind8shAJcOSAf7tTgB8NT1zPbPXyDw%253D%253D",
            "title": "ProlongationDocument.doc",
            "documentOf": "tender",
            "datePublished": "2018-07-11T15:06:10.305330+03:00",
            "documentType": "prolongationProtocol",
            "dateModified": "2018-07-11T15:06:10.305361+03:00",
            "id": "60bfda57b0844971a14ac7dabd950f4e"
          }
        ],
        "dateCreated": "2018-07-11T15:06:01.969656+03:00",
        "id": "22c7acbefec94ec6b8c4b1ad6807a078"
      },
      {
        "status": "applied",
        "decisionID": "ZM-937-99-92-2",
        "description": "Long prolongation description",
        "datePublished": "2018-07-11T15:06:02.303227+03:00",
        "reason": "other",
        "documents": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "description": "content_with_prolongation_data",
            "format": "application/pdf",
            "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=g7WWF%2FKSpXzPjRxD2wpet8scNkNCRE%2FNxccqW7Shk4CqmN1i%252Blig00sv80Kuvl0EXTBk3UBjI2umKuFZ8jL7CQ%253D%253D",
            "title": "LongProlongationDocument.doc",
            "documentOf": "tender",
            "datePublished": "2018-07-11T15:06:10.675174+03:00",
            "documentType": "prolongationProtocol",
            "dateModified": "2018-07-11T15:06:10.675194+03:00",
            "id": "4e70262362014335b439cd227e5de663"
          }
        ],
        "dateCreated": "2018-07-11T15:06:01.969656+03:00",
        "id": "eb7e1d4d47c041c0882cd91c00952c65"
      }
    ],
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/46cb517bd7684c1a9779bc6c6b61aa3b?KeyID=172d32c8&Signature=XvKnw4LjI6hr76DvKNP0ErxWYsLQfH2zRLwnDcs056LoQkSA92m2ch1bsVlfVzGADUyXv4zaoFuwEJMtnVN%252BCQ%253D%253D",
        "title": "contract_first_document.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:09.858414+03:00",
        "dateModified": "2018-07-11T15:06:09.858435+03:00",
        "id": "ed5631e083de4bb78654b925d57868b5"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/91892b0c6fed455bb136447fb6f9e03c?KeyID=172d32c8&Signature=LNrfV4IvqjUYzlQKQB6degrvA%2FNfGIS%2FgbgbF09lzg26JZ%2FGx8kh7iwpJ7R%2Fxu5YB51EVq%2F5j7GaC2thrQXbDA%253D%253D",
        "title": "contract_second_document.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:10.026475+03:00",
        "dateModified": "2018-07-11T15:06:10.026498+03:00",
        "id": "bf57bef28c0548d7aac002e48b85d4a1"
      }
    ],
    "signingPeriod": {
      "startDate": "2018-07-11T15:06:09.034064+03:00",
      "endDate": "2018-07-11T17:18:16.277790+03:00"
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "314f1cb8d47a46009b5c9537e8974be6",
        "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": "2018-07-11T15:06:02.303178+03:00",
      "endDate": "2019-07-11T15:06:02.303178+03:00"
    },
    "dateSigned": "2018-07-11T15:06:10.900112+03:00",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:10.997720+03:00",
    "awardID": "3d052a44e86147129b0b01e3cbec1c14",
    "id": "538cb657fbe54c93973e858feffa3dec",
    "contractID": "UA-EA-2018-07-11-000002-1"
  }
}

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

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

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

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

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

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

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

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

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

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c
X-Content-Type-Options: nosniff

{
  "data": {
    "date": "2018-07-11T15:06:11.226624+03:00",
    "status": "pending",
    "reason": "cancellation reason",
    "cancellationOf": "tender",
    "id": "8d13337163de4a51b8caad7efab95a9c"
  }
}

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

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c/documents?acc_token=0052e89467e54a799389e87c87910599 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/118a47764259485dbae4a2f0dfdcf557?KeyID=172d32c8&Signature=%2Fj1rim2kHN5gKzTvpi5jE%2BfTFPpjHI4knANQ8y1FOR1saL8y71%2FjwULEOsHC1bqG7ncpba3CXB0zOFte7BN0BQ%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c/documents/dd88f21f3fe049d1a769423cecefb3d2
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/118a47764259485dbae4a2f0dfdcf557?KeyID=172d32c8&Signature=ph2AmQzrfCHKMX0naRz1v0Vyxvy4rYfslqOzoXaVXs7mr9v1%2FubZMtr0ev5BR6IFOr5TZju1tE1HMiqMGcfLBw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:11.358918+03:00",
    "dateModified": "2018-07-11T15:06:11.358938+03:00",
    "id": "dd88f21f3fe049d1a769423cecefb3d2"
  }
}

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c/documents/dd88f21f3fe049d1a769423cecefb3d2?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 48
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/118a47764259485dbae4a2f0dfdcf557?KeyID=172d32c8&Signature=ph2AmQzrfCHKMX0naRz1v0Vyxvy4rYfslqOzoXaVXs7mr9v1%2FubZMtr0ev5BR6IFOr5TZju1tE1HMiqMGcfLBw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:11.358918+03:00",
    "dateModified": "2018-07-11T15:06:11.358938+03:00",
    "id": "dd88f21f3fe049d1a769423cecefb3d2"
  }
}

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

PUT /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c/documents/dd88f21f3fe049d1a769423cecefb3d2?acc_token=0052e89467e54a799389e87c87910599 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/a07fc742725b4d368494f4e2acd5c446?KeyID=172d32c8&Signature=tZ1R7cquRGVWzK8FixEZdZ882pPynH5tcuPMNBOCfHcwnXY8WcsxnQiwIdH%2BassrCOekTqalUVZXHEPeiY46CQ%3D%3D",
    "title": "Notice-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a07fc742725b4d368494f4e2acd5c446?KeyID=172d32c8&Signature=w2R5JkOzRaWcwNBhCcnzZyBWCq23J09QvRckHrhhbtYNKhjVXgIHnfc%252BTPeo0fROyF2XEYxEgLk5SpdUWRKTBA%253D%253D",
    "title": "Notice-2.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:11.358918+03:00",
    "dateModified": "2018-07-11T15:06:11.640471+03:00",
    "id": "dd88f21f3fe049d1a769423cecefb3d2"
  }
}

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


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

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/118a47764259485dbae4a2f0dfdcf557?KeyID=172d32c8&Signature=ph2AmQzrfCHKMX0naRz1v0Vyxvy4rYfslqOzoXaVXs7mr9v1%2FubZMtr0ev5BR6IFOr5TZju1tE1HMiqMGcfLBw%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:11.358918+03:00",
        "dateModified": "2018-07-11T15:06:11.358938+03:00",
        "id": "dd88f21f3fe049d1a769423cecefb3d2"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a07fc742725b4d368494f4e2acd5c446?KeyID=172d32c8&Signature=w2R5JkOzRaWcwNBhCcnzZyBWCq23J09QvRckHrhhbtYNKhjVXgIHnfc%252BTPeo0fROyF2XEYxEgLk5SpdUWRKTBA%253D%253D",
        "title": "Notice-2.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:11.358918+03:00",
        "dateModified": "2018-07-11T15:06:11.640471+03:00",
        "id": "dd88f21f3fe049d1a769423cecefb3d2"
      }
    ],
    "reason": "cancellation reason",
    "date": "2018-07-11T15:06:11.804922+03:00",
    "cancellationOf": "tender",
    "id": "8d13337163de4a51b8caad7efab95a9c"
  }
}

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

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

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

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

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

{
  "data": {
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-25"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "DGFFinancialAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "submissionMethodDetails": "test submissionMethodDetails",
    "dgfDecisionDate": "2016-11-17",
    "dgfID": "219560",
    "dgfDecisionID": "219560",
    "procurementMethodDetails": "quick, accelerator=1440",
    "items": [
      {
        "classification": {
          "scheme": "CAV",
          "id": "06000000-2",
          "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
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "676389c2fd3d4fdb8ac067141b935f20",
    "token": "db0b1dca507d466cb1b74576d5e23c52"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:06.538858+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-24T23:59:50+03:00",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "1bd0478dee5b4b0581e2d1bf7f47fa51",
    "eligibilityCriteria_ru": "Участником электронного аукциона, предметом продажи на которых являются права требования по кредитным договорам и договорам обеспечения, не может быть пользователь, являющийся заёмщиком (должником относительно банка) и\\или поручителем (имущественным поручителем) по таким кредитным договорам и/или договорам обеспечения.",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:06.539174+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:06.539196+03:00",
        "id": "556fede524934437bb9007bb38802230"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "eligibilityCriteria_en": "The user, who is the borrower (the debtor of the bank) and/or guarantor (property guarantor) for loan agreements and/or collateral agreements, cannot be the bidder of the electronic auction, where the items for sale are the claim rights on such loan agreements and collateral agreements.",
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:06.541629+03:00",
    "status": "active.tendering",
    "eligibilityCriteria": "Учасником електронного аукціону, предметом продажу на яких є права вимоги за кредитними договорами та договорами забезпечення, не може бути користувач, який є позичальником (боржником відносно банку) та/або поручителем (майновим поручителем) за такими кредитними договорами та/або договорами забезпечення.",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:06.538858+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-25T00:00:00+03:00"
    },
    "procurementMethodType": "DGFFinancialAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:06.538858+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "edca5775bbe6417b8afd6b794a9ff190",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

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

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

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


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

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:06.538858+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-24T23:59:50+03:00",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "1bd0478dee5b4b0581e2d1bf7f47fa51",
    "eligibilityCriteria_ru": "Участником электронного аукциона, предметом продажи на которых являются права требования по кредитным договорам и договорам обеспечения, не может быть пользователь, являющийся заёмщиком (должником относительно банка) и\\или поручителем (имущественным поручителем) по таким кредитным договорам и/или договорам обеспечения.",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:06.539174+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:06.539196+03:00",
        "id": "556fede524934437bb9007bb38802230"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "eligibilityCriteria_en": "The user, who is the borrower (the debtor of the bank) and/or guarantor (property guarantor) for loan agreements and/or collateral agreements, cannot be the bidder of the electronic auction, where the items for sale are the claim rights on such loan agreements and collateral agreements.",
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:06.541629+03:00",
    "status": "active.tendering",
    "eligibilityCriteria": "Учасником електронного аукціону, предметом продажу на яких є права вимоги за кредитними договорами та договорами забезпечення, не може бути користувач, який є позичальником (боржником відносно банку) та/або поручителем (майновим поручителем) за такими кредитними договорами та/або договорами забезпечення.",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:06.538858+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-25T00:00:00+03:00"
    },
    "procurementMethodType": "DGFFinancialAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:06.538858+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "edca5775bbe6417b8afd6b794a9ff190",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "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": "м. Київ"
      }
    }
  }
}

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

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

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


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

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

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

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

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

POST /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/documents?acc_token=db0b1dca507d466cb1b74576d5e23c52 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/1ac184ba38634610bcb878b445308360?KeyID=172d32c8&Signature=6HYDkcJljNBrdRxhZwgKmJyVXEbnBS6g7VEqkjTea8fwekXxvNwHPkLR1cc2tJusq%2FK1tew5D9bx6xRZ9CXFDA%3D%3D",
    "format": "application/pdf",
    "documentType": "technicalSpecifications"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/documents/943764a2ec944dea859f242236e32975
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "technical specification",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ac184ba38634610bcb878b445308360?KeyID=172d32c8&Signature=2Y%2FPNHdAQL0vHdV0Z%252BTfDTJiA8OMu8ER04jVygL4RdYIFbhgiHdKpKPT%2F7RkAJltTu8XQjZtfJOY2X0D5fZEAQ%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:06.609510+03:00",
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-11T15:06:06.609531+03:00",
    "id": "943764a2ec944dea859f242236e32975"
  }
}

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

GET /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/documents/943764a2ec944dea859f242236e32975 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "technical specification",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ac184ba38634610bcb878b445308360?KeyID=172d32c8&Signature=2Y%2FPNHdAQL0vHdV0Z%252BTfDTJiA8OMu8ER04jVygL4RdYIFbhgiHdKpKPT%2F7RkAJltTu8XQjZtfJOY2X0D5fZEAQ%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:06.609510+03:00",
    "previousVersions": [],
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-11T15:06:06.609531+03:00",
    "id": "943764a2ec944dea859f242236e32975"
  }
}

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

POST /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/documents?acc_token=db0b1dca507d466cb1b74576d5e23c52 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 334
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/documents/6d5fced0129d424294cbd1e43f503120
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f2b13729f22c4cd9b2280cdcd5f3191f?KeyID=172d32c8&Signature=8OyAfdntjoU%252BLXpBecddhIHcqQtLw3wU9BERrJhUef5uwjNYmUa5gFzQAUYntmcaeHdEXb2LzcBNrI5KhMP%252BAA%253D%253D",
    "title": "AwardCriteria.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:06.664005+03:00",
    "dateModified": "2018-07-11T15:06:06.664026+03:00",
    "id": "6d5fced0129d424294cbd1e43f503120"
  }
}

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

GET /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:06.539174+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:06.539196+03:00",
      "id": "556fede524934437bb9007bb38802230"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "technical specification",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ac184ba38634610bcb878b445308360?KeyID=172d32c8&Signature=2Y%2FPNHdAQL0vHdV0Z%252BTfDTJiA8OMu8ER04jVygL4RdYIFbhgiHdKpKPT%2F7RkAJltTu8XQjZtfJOY2X0D5fZEAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:06.609510+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:06.609531+03:00",
      "id": "943764a2ec944dea859f242236e32975"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f2b13729f22c4cd9b2280cdcd5f3191f?KeyID=172d32c8&Signature=8OyAfdntjoU%252BLXpBecddhIHcqQtLw3wU9BERrJhUef5uwjNYmUa5gFzQAUYntmcaeHdEXb2LzcBNrI5KhMP%252BAA%253D%253D",
      "title": "AwardCriteria.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:06.664005+03:00",
      "dateModified": "2018-07-11T15:06:06.664026+03:00",
      "id": "6d5fced0129d424294cbd1e43f503120"
    }
  ]
}

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

PUT /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/documents/6d5fced0129d424294cbd1e43f503120?acc_token=db0b1dca507d466cb1b74576d5e23c52 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/99bc7df92cae458bb04ecad685229969?KeyID=172d32c8&Signature=dhhoE%2BvO%2FjEWopydn97f2T4RWqExHa1hz29WQWKsooWjHR%2BdQ7SK4gYKOo0cd1ihSMgmJDBC3d1bR17l6IefDQ%3D%3D",
    "title": "AwardCriteria-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/99bc7df92cae458bb04ecad685229969?KeyID=172d32c8&Signature=pjM1Q5R59JDAuSlrirE%2FHkIkAQP84sjdKsM1Cy1HHfNdFNVI0G29wgNvyYpyhtZfJMvNMUOurSaJoaA20ip%2FBQ%253D%253D",
    "title": "AwardCriteria-2.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:06.664005+03:00",
    "dateModified": "2018-07-11T15:06:06.721944+03:00",
    "id": "6d5fced0129d424294cbd1e43f503120"
  }
}

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

GET /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:06.539174+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:06.539196+03:00",
      "id": "556fede524934437bb9007bb38802230"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "technical specification",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ac184ba38634610bcb878b445308360?KeyID=172d32c8&Signature=2Y%2FPNHdAQL0vHdV0Z%252BTfDTJiA8OMu8ER04jVygL4RdYIFbhgiHdKpKPT%2F7RkAJltTu8XQjZtfJOY2X0D5fZEAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:06.609510+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:06.609531+03:00",
      "id": "943764a2ec944dea859f242236e32975"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/99bc7df92cae458bb04ecad685229969?KeyID=172d32c8&Signature=pjM1Q5R59JDAuSlrirE%2FHkIkAQP84sjdKsM1Cy1HHfNdFNVI0G29wgNvyYpyhtZfJMvNMUOurSaJoaA20ip%2FBQ%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:06.664005+03:00",
      "dateModified": "2018-07-11T15:06:06.721944+03:00",
      "id": "6d5fced0129d424294cbd1e43f503120"
    }
  ]
}

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

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

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 432
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/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=44NDlwGUSjchl%2F1E9rd8cJIkXYeL%2FbHuVYTGAW8qTMiKBcATXGrfJC3TFdBElOlF%2FLmzbRZmQOGj3UmUjE7dBg%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/dbe0ca0c582b422d84c59a2aa93eb948
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 1,
    "hash": "md5:00000000000000000000000000000000",
    "description": "First illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=UPMVnKZTzNNA9AxDywJSZbpPjStBGoee80QWYvawEzzQnVYTxYuijJO8UMScqwMcbt5qrdjYn5jyfUyhvZzkDA%253D%253D",
    "title": "first_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.828825+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-11T15:06:07.828844+03:00",
    "id": "dbe0ca0c582b422d84c59a2aa93eb948"
  }
}

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

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


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

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.421619+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:07.421641+03:00",
      "id": "779f993a42c54eadadff72d66788fb23"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.649805+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:07.649826+03:00",
      "id": "bb517ba5ca544fd7b21eaf894a63afd7"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.703749+03:00",
      "dateModified": "2018-07-11T15:06:07.765929+03:00",
      "id": "cf91c283f3b04cb5a76d9368d69c161f"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=UPMVnKZTzNNA9AxDywJSZbpPjStBGoee80QWYvawEzzQnVYTxYuijJO8UMScqwMcbt5qrdjYn5jyfUyhvZzkDA%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.828825+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.828844+03:00",
      "id": "dbe0ca0c582b422d84c59a2aa93eb948"
    }
  ]
}

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 428
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/240fe6c71e5a4291a3c9e39fbfeb460e?KeyID=172d32c8&Signature=aiaYSVot6s3YWRq8zdCetQDBq2FwrP1LstPmGw6EcG5s4bTvKFYjg0EnTewJ7KV14YbTt8DHzOhiPpb0hJirAA%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/402f115c7eb445c3a42eb624d2b45e17
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Second illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/240fe6c71e5a4291a3c9e39fbfeb460e?KeyID=172d32c8&Signature=k8V7cIG6xo5fopPWo%252B%2Fl3mxaliitImmqxRxKPbsJATjwe8Fde63J7%252BzgghykfYCTn9QwuMx1aVg1G6iNu7PNDg%253D%253D",
    "title": "second_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.897398+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-11T15:06:07.897419+03:00",
    "id": "402f115c7eb445c3a42eb624d2b45e17"
  }
}

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 442
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/e401fae3f2004d11ac67e9b444eb6d09?KeyID=172d32c8&Signature=Mxs%2F2%2B03GvbmBy%2FZePxtBa8qVpaWmWJ1t%2FyuYSRbQTb%2Fm2Pw%2BvhOGL3n%2B2jOpvRdAroJNQHk5OFyYBI3q%2FMvAw%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/feae4575ced24c718bae0f05d904c810
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Third illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/e401fae3f2004d11ac67e9b444eb6d09?KeyID=172d32c8&Signature=h7%2FVgGCvrQZMhz5xn6tYcxZ809Rxn25ohwJIoTihWblO8DCl2FHeJwFkHE3ZGUZeHBWCQ8ANi5eQEUiyd78qAg%253D%253D",
    "title": "third_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.952905+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-11T15:06:07.952925+03:00",
    "id": "feae4575ced24c718bae0f05d904c810"
  }
}

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

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

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


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

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.421619+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:07.421641+03:00",
      "id": "779f993a42c54eadadff72d66788fb23"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.649805+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:07.649826+03:00",
      "id": "bb517ba5ca544fd7b21eaf894a63afd7"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.703749+03:00",
      "dateModified": "2018-07-11T15:06:07.765929+03:00",
      "id": "cf91c283f3b04cb5a76d9368d69c161f"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=UPMVnKZTzNNA9AxDywJSZbpPjStBGoee80QWYvawEzzQnVYTxYuijJO8UMScqwMcbt5qrdjYn5jyfUyhvZzkDA%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.828825+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.828844+03:00",
      "id": "dbe0ca0c582b422d84c59a2aa93eb948"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Second illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/240fe6c71e5a4291a3c9e39fbfeb460e?KeyID=172d32c8&Signature=k8V7cIG6xo5fopPWo%252B%2Fl3mxaliitImmqxRxKPbsJATjwe8Fde63J7%252BzgghykfYCTn9QwuMx1aVg1G6iNu7PNDg%253D%253D",
      "title": "second_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.897398+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.897419+03:00",
      "id": "402f115c7eb445c3a42eb624d2b45e17"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Third illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/e401fae3f2004d11ac67e9b444eb6d09?KeyID=172d32c8&Signature=h7%2FVgGCvrQZMhz5xn6tYcxZ809Rxn25ohwJIoTihWblO8DCl2FHeJwFkHE3ZGUZeHBWCQ8ANi5eQEUiyd78qAg%253D%253D",
      "title": "third_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.952905+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.952925+03:00",
      "id": "feae4575ced24c718bae0f05d904c810"
    }
  ]
}

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

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

POST /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/documents?acc_token=db0b1dca507d466cb1b74576d5e23c52 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
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/documents/b128b0fce67a4338b3879ae6278c9d06
X-Content-Type-Options: nosniff

{
  "data": {
    "title": "VDR for auction lot",
    "url": "http://virtial-data-room.com/id_of_room",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:06.780364+03:00",
    "documentType": "virtualDataRoom",
    "dateModified": "2018-07-11T15:06:06.780384+03:00",
    "id": "b128b0fce67a4338b3879ae6278c9d06"
  }
}

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

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

POST /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/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
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/bids/2f94ff64e9854aeb8083c26bf5a85ab0
X-Content-Type-Options: nosniff

{
  "access": {
    "token": "de594836f1544ab69b444235f3f05693"
  },
  "data": {
    "status": "active",
    "eligible": true,
    "value": {
      "currency": "UAH",
      "amount": 469.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:06.831455+03: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": "2f94ff64e9854aeb8083c26bf5a85ab0"
  }
}

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

PATCH /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/bids/2f94ff64e9854aeb8083c26bf5a85ab0?acc_token=de594836f1544ab69b444235f3f05693 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


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

null

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

POST /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/bids/2f94ff64e9854aeb8083c26bf5a85ab0/documents?acc_token=de594836f1544ab69b444235f3f05693 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 379
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/69a1f0170b6d46008059817aa7972bca?KeyID=172d32c8&Signature=61mkM%2Bdv2upZuuuZHz7UjAjoZZmsZTKLmik0PQ56C50uqsaTSp7afctEv%2FsbUCboQ%2B9T6R%2B1S6IYzYY7oQCsBQ%3D%3D",
    "title": "FinancialLicense.pdf",
    "format": "application/pdf",
    "hash": "md5:00000000000000000000000000000000",
    "documentType": "financialLicense"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/bids/2f94ff64e9854aeb8083c26bf5a85ab0/documents/fd33a0a111634641bb733b0467fd4337
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/bids/2f94ff64e9854aeb8083c26bf5a85ab0/documents/fd33a0a111634641bb733b0467fd4337?download=69a1f0170b6d46008059817aa7972bca",
    "title": "FinancialLicense.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:06.919296+03:00",
    "documentType": "financialLicense",
    "dateModified": "2018-07-11T15:06:06.919314+03:00",
    "id": "fd33a0a111634641bb733b0467fd4337"
  }
}

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

GET /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/bids/2f94ff64e9854aeb8083c26bf5a85ab0/documents?acc_token=de594836f1544ab69b444235f3f05693 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/bids/2f94ff64e9854aeb8083c26bf5a85ab0/documents/fd33a0a111634641bb733b0467fd4337?download=69a1f0170b6d46008059817aa7972bca",
      "title": "FinancialLicense.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:06.919296+03:00",
      "documentType": "financialLicense",
      "dateModified": "2018-07-11T15:06:06.919314+03:00",
      "id": "fd33a0a111634641bb733b0467fd4337"
    }
  ]
}

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

POST /api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/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
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/1bd0478dee5b4b0581e2d1bf7f47fa51/bids/d9bb731980a14b76872e07b506803203
X-Content-Type-Options: nosniff

{
  "access": {
    "token": "b657058be68c4b73871152fef26a96ed"
  },
  "data": {
    "status": "active",
    "eligible": true,
    "value": {
      "currency": "UAH",
      "amount": 479.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:07.011228+03: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": "d9bb731980a14b76872e07b506803203"
  }
}

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

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

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

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

{
  "data": {
    "status": "draft",
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-25"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "DGFOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "submissionMethodDetails": "test submissionMethodDetails",
    "dgfDecisionDate": "2016-11-17",
    "dgfID": "219560",
    "dgfDecisionID": "219560",
    "procurementMethodDetails": "quick, accelerator=1440",
    "items": [
      {
        "classification": {
          "scheme": "CAV",
          "id": "06000000-2",
          "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
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/0bdbbd8123854d20a2546494635ac16e
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "38a1fca1ffd34b99af75b6cc984a16a1",
    "token": "080510b507e64c099c9d8674c2686941"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:04.272464+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "0bdbbd8123854d20a2546494635ac16e",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:04.272937+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:04.272970+03:00",
        "id": "d36b463c1b4c44f58d8269e1978fdeb3"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-11T15:06:04.276341+03:00",
    "status": "draft",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:04.272464+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "procurementMethodDetails": "quick, accelerator=1440",
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:04.272464+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "e1c679a7305f4472bb93dc175ea66a27",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "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": "м. Київ"
      }
    }
  }
}

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

PATCH /api/2.5/auctions/0bdbbd8123854d20a2546494635ac16e?acc_token=080510b507e64c099c9d8674c2686941 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 40
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


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

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:04.272464+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-24T23:59:50+03:00",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "0bdbbd8123854d20a2546494635ac16e",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:04.272937+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:04.272970+03:00",
        "id": "d36b463c1b4c44f58d8269e1978fdeb3"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:04.318402+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:04.272464+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-25T00:00:00+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:04.318402+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "e1c679a7305f4472bb93dc175ea66a27",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "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": "м. Київ"
      }
    }
  }
}

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

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

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

Щоб увімкнути режим прискорення вам потрібно:

  • додати додатковий параметр mode зі значенням test;

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

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

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

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

{
  "data": {
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-11T15:11:02.303178"
    },
    "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",
    "dgfDecisionDate": "2016-11-17",
    "mode": "test",
    "dgfDecisionID": "219560",
    "procurementMethodDetails": "quick, accelerator=1440",
    "items": [
      {
        "classification": {
          "scheme": "CAV",
          "id": "06000000-2",
          "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
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/797cf4dd34e04e929cdb889049f2b693
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "b95ce8b0eafb47c988cd6fce5cdc8588",
    "token": "923d6d6f771649ad9fd7609138778833"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:04.630759+03:00",
      "endDate": "2018-07-11T15:10:14.343245+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-11T15:10:14.343245+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dgfDecisionID": "219560",
    "owner": "broker",
    "title_en": "[TESTING] ",
    "id": "797cf4dd34e04e929cdb889049f2b693",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:04.631073+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:04.631095+03:00",
        "id": "8ca456ee511141158b3634d1f5447912"
      }
    ],
    "title": "[ТЕСТУВАННЯ] футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:04.633363+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:04.630759+03:00",
      "endDate": "2018-07-11T15:10:14.343245+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-11T15:10:14.343245+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:04.630759+03:00",
    "submissionMethodDetails": "quick",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "74fd2ae528af418fa56629aea6d8a908",
        "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, то будуть віддаватися всі аукціони.

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

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