Вітаємо на сайті документації по 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.
Аукціон може містити елементи з різних CAV груп.
Домовленості¶
API приймає JSON або form-encoded вміст у запитах. Він повертає JSON вміст у всіх свої відповідях, включно з помилками. Підтримується лише UTF-8 кодування і для запитів, і для відповідей.
Всі API POST та PUT запити очікують об’єкт верхнього рівня з єдиним елементом з назвою data. Відповіді з повідомленням про успіх будуть віддзеркалювати цей формат. Елемент data повинен сам бути об’єктом, що містить параметри запиту. Якщо створюється новий аукціон, то це ті поля, які ми хочемо встановити на самому аукціоні.
Якщо запит був успішним, ми отримаємо код відповіді 201, який вказує, що об’єкт був створений. Ця відповідь буде мати data поле на верхньому рівні, яке вміщуватиме повну інформацію про новий аукціон, включно з ID.
Якщо під час запиту виникли труднощі, ми отримаємо інший код стану та JSON, який при поверненні міститиме errors поле на верхньому рівні зі списком проблем. Ми дивимось на першу з них і видруковуємо її повідомлення.
Основні задачі¶
Бізнес логіка¶
Стан проекту¶
Статус цього проекту - перед-альфа
Репозиторій джерельних текстів цього проекту є на GitHub.
Повідомляйте про всі проблеми та поради через issue tracker (реєстрація на GitHub обов’язкова).
Стабільність API¶
API є дуже нестабільним. Хоча точки входу API будуть відносно стабільними, формати обміну даними будуть часно змінюватись. Зміни в API обговорюються через Open Procurement API розсилку.
Стандарт даних¶
Стандарт даних змодельований згідно Open Contracting Standard з розширеннями в тих областях, які він не покриває.
Auction¶
Схема¶
| title: | рядок, багатомовний, лише для читання Номер аукціону у Фонді Гарантування Вкладів. |
||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| description: | рядок, багатомовний Детальний опис аукціону. |
||||||||||||||||||
| auctionID: | рядок, генерується автоматично, лише для читання Ідентифікатор аукціону, щоб знайти його у “паперовій” документації OpenContracting Description: Ідентифікатор аукціону AuctionID повинен завжди співпадати з OCID. Його включають, щоб зробити структуру даних більш зручною. |
||||||||||||||||||
| dgfID: | рядок, обов’язковий Номер аукціону (або лота) у XLS Фонду Гарантування. |
||||||||||||||||||
| procurementMethodType: | |||||||||||||||||||
рядок, обов’язковий Тип процедури. Можливі значення:
|
|||||||||||||||||||
| tenderAttempts: | integer The number which represents whether the tender is taking place for the first, second, third, or fourth time |
||||||||||||||||||
| procuringEntity: | |||||||||||||||||||
ProcuringEntity (Організатор), обов’язково Організатор (організація, що проводить аукціон). OpenContracting Description: Об’єкт, що управляє закупівлею. Він не обов’язково є покупцем, який платить / використовує закуплені елементи. |
|||||||||||||||||||
| value: | Value, обов’язково Початкова ціна аукціону. Пропозиції, що нижчі за OpenContracting Description: Загальна кошторисна вартість закупівлі. |
||||||||||||||||||
| guarantee: |
Гарантійний внесок |
||||||||||||||||||
| items: | список об’єктів Item, обов’язково Список містить елементи, що продаються. OpenContracting Description: Товари та послуги, що будуть закуплені, поділені на спискові елементи, де це можливо. Елементи не повинні дублюватись, замість цього вкажіть кількість 2. |
||||||||||||||||||
| features: | список об’єктів Feature Властивості аукціону. |
||||||||||||||||||
| documents: | Список об’єктів Document OpenContracting Description: Всі документи та додатки пов’язані із аукціоном. |
||||||||||||||||||
| questions: | Список об’єктів Question Питання до організатора |
||||||||||||||||||
| complaints: | Список об’єктів Complaint Скарги на умови аукціону та їх вирішення. |
||||||||||||||||||
| bids: | Список об’єктів Bid Список усіх пропозицій поданих до аукціону разом із інформацією про учасників аукціону, їхні пропозиції та інша кваліфікаційна документація. OpenContracting Description: Список усіх компаній, які подали заявки для участі в аукціоні. |
||||||||||||||||||
| minimalStep: | Value, обов’язково Крок аукціону та порядок підвищення ціни. Правила валідації:
|
||||||||||||||||||
| awards: | Список об’єктів Award Всі кваліфікації (дискваліфікації та визначення переможця). |
||||||||||||||||||
| contracts: | Список об’єктів Contract |
||||||||||||||||||
| enquiryPeriod: |
Період, коли дозволено задавати питання. OpenContracting Description: Період, коли можна задати питання (уточнення) та отримати відповіді на них. |
||||||||||||||||||
| tenderPeriod: |
Період, коли подаються пропозиції. OpenContracting Description: Період, коли аукціон відкритий для подачі пропозицій. Кінцева дата - це дата, коли перестають прийматись пропозиції. |
||||||||||||||||||
| auctionPeriod: | Period, обов’язково Період, коли проводиться аукціон. Значення startDate (дата проведення аукціону) повинно бути вказано обов’язково. |
||||||||||||||||||
| auctionUrl: | URL-адреса Веб-адреса для перегляду аукціону. |
||||||||||||||||||
| awardPeriod: | Period, лише для читання Період, коли відбувається визначення переможця. OpenContracting Description: Дата або період, коли очікується визначення переможця. |
||||||||||||||||||
| status: | рядок
Статус аукціону. |
||||||||||||||||||
| eligibilityCriteria: | |||||||||||||||||||
рядок, лише для читання Обов’язково для dgfFinancialAssets процедури (продаж права вимоги за кредитними договорами). Це поле багатомовне:
|
|||||||||||||||||||
| cancellations: | Список об’єктів Cancellation. Містить 1 об’єкт зі статусом active на випадок, якщо аукціон буде відмінено. Об’єкт Cancellation описує причину скасування аукціону та надає відповідні документи, якщо такі є. |
|---|---|
| revisions: | Список об’єктів Revision, генерується автоматично, лише для читання Зміни властивостей об’єктів Auction. |
| dgfDecisionDate: | |
|
Дата рішення виконавчої дирекції ФГВФО / Комітету з питань організації продажу активів, про затвердження умов продажу. |
|
| dgfDecisionID: | рядок Номер рішення виконавчої дирекції ФГВФО / Комітету з питань організації продажу активів, про затвердження умов продажу. |
Organization¶
Схема¶
| name: | рядок, багатомовний Назва організації. |
|---|---|
| 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: | OpenContracting Description: Адреса електронної пошти контактної особи/пункту. |
| telephone: | рядок OpenContracting Description: Номер телефону контактної особи/пункту. Повинен включати міжнародний телефонний код. |
| faxNumber: | рядок OpenContracting Description: Номер факсу контактної особи/пункту. Повинен включати міжнародний телефонний код. |
| url: | URL-адреса OpenContracting Description: Веб адреса контактної особи/пункту. |
Повинне бути заповнене хоча б одне з полів: або email, або telephone.
Item¶
Схема¶
| id: | рядок, генерується автоматично |
||||||
|---|---|---|---|---|---|---|---|
| description: | рядок, багатомовний, обов’язковий OpenContracting Description: Опис товарів та послуг, які повинні бути надані. Стислий опис майна (для процедури |
||||||
| classification: |
OpenContracting Description: Початкова класифікація елемента. Дивіться у itemClassificationScheme, щоб визначити бажані списки класифікації, включно з CAV та GSIN. Класифікація classification.scheme обов’язково повинна бути CAV. classification.id повинно бути дійсним CAV кодом. |
||||||
| additionalClassifications: | |||||||
Список об’єктів Classification OpenContracting Description: Масив додаткових класифікацій для елемента. Дивіться у список кодів itemClassificationScheme, щоб використати поширені варіанти в OCDS. Також можна використовувати для представлення кодів з внутрішньої схеми класифікації. Обов’язково мати хоча б один елемент з ДКПП у стрічці scheme. |
|||||||
| unit: |
OpenContracting Description: Опис одиниці виміру товару, наприклад, години, кілограми. Складається з назви одиниці та значення однієї одиниці. |
||||||
| quantity: | ціле число OpenContracting Description: Кількість необхідних одиниць. |
||||||
| address: |
Адреса місцезнаходження майна (для процедури |
||||||
| location: | словник Географічні координати місця розташування. Складається з таких компонентів:
Параметр location зазвичай має вищий пріоритет ніж address, якщо вони обидва вказані. |
||||||
Classification¶
Схема¶
| scheme: | рядок OpenContracting Description: Класифікація повинна бути взята з існуючої схеми або списку кодів. Це поле використовується, щоб вказати схему/список кодів, з яких буде братись класифікація. Для класифікацій лінійних елементів це значення повинно представляти відому Схему Класифікації Елементів, де це можливо. |
|---|---|
| id: | рядок OpenContracting Description: Код класифікації взятий з вибраної схеми. |
| description: | рядок OpenContracting Description: Текстовий опис або назва коду. |
| uri: | uri OpenContracting Description: URI для ідентифікації коду. Якщо індивідуальні URI не доступні для елементів у схемі ідентифікації, це значення треба залишити пустим. |
Unit¶
Схема¶
| code: | рядок, обов’язковий Код одиниці виміру в UN/CEFACT Recommendation 20. |
|---|---|
| name: | рядок OpenContracting Description: Назва одиниці виміру |
Document¶
Схема¶
| id: | рядок, генерується автоматично |
|---|---|
| documentType: | рядок Можливі значення для Auction
Можливі значення для Award
Можливі значення для Contract
Можливі значення для Bid
|
| 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: | рядок Можливі значення:
|
| relatedItem: | рядок Ідентифікатор пов’язаних об’єктів Item. |
|---|
| accessDetails: | рядок Required for x_dgfAssetFamiliarization document. |
|---|
Bid¶
Схема¶
| tenderers: | Список об’єктів Organization |
|---|---|
| date: | рядок, Date, генерується автоматично Дата подачі пропозиції. |
| id: | UID, генерується автоматично |
| status: | рядок Можливі значення:
|
| value: | Value, обов’язково Правила валідації:
|
| 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. Можливі значення:
|
| verificationPeriod: | |
|
Період завантаження (переможцем аукціону) і верифікації (банком) протоколу аукціону |
|
| paymentPeriod: |
Період наданий переможцю аукціону для здійснення оплати |
| signingPeriod: |
Період очікування активації контракту (банком) |
| date: | рядок, Date, генерується автоматично, лише для читання OpenContracting Description: Дата рішення про підписання договору. |
| value: | О’єкт Value, генерується автоматично, лише для читання OpenContracting Description: Загальна вартість згідно цього рішення. |
| suppliers: | Список об’єктів Organization, генерується автоматично, лише для читання OpenContracting Description: Постачальники, що були визнані переможцями згідно цього рішення. |
| items: | Список об’єктів Item, генерується автоматично, лише для читання OpenContracting Description: Товари та послуги, що розглядались цим рішенням, поділені на окремі рядки, де це можливо. Елементи не повинні бути продубльовані, а повинні мати вказану кількість. |
| documents: | Список об’єктів Document OpenContracting Description: Усі документи та додатки пов’язані з рішенням, включно з будь-якими повідомленнями. |
| complaints: | Список об’єктів Complaint |
| complaintPeriod: | |
|
Період часу, під час якого можна подавати скарги. |
|
Question¶
Схема¶
| id: | UID, генерується автоматично |
|---|---|
| author: | Organization, обов’язково Хто задає питання (contactPoint - людина, identification - організація, яку ця людина представляє). |
| title: | рядок, обов’язковий Назва запитання. |
| description: | рядок Опис запитання. |
| date: | рядок, Date, генерується автоматично Дата публікації. |
| answer: | рядок Відповідь на задане питання. |
| questionOf: | рядок Можливі значення:
|
| relatedItem: | рядок Ідентифікатор пов’язаних об’єктів Item. |
|---|
Complaint¶
Схема¶
| id: | UID, генерується автоматично |
|---|---|
| author: | Organization, обов’язково Організація, яка подає скаргу (contactPoint - людина, identification - організація, яку ця людина представляє). |
| title: | рядок, обов’язковий Заголовок скарги. |
| description: | Опис запитання. |
| date: | рядок, Date, генерується автоматично Дата подання. |
| dateSubmitted: | рядок, Date, генерується автоматично Дата, коли вимога була подана. |
| dateAnswered: | рядок, Date, генерується автоматично Дата, коли організатор відповів на вимогу. |
| dateEscalated: | рядок, Date, генерується автоматично Дата ескалації (перетворення вимоги на скаргу). |
| dateDecision: | рядок, Date, генерується автоматично День прийняття рішення по скарзі. |
| dateCanceled: | рядок, Date, генерується автоматично Дата відхилення. |
| status: | рядок Можливі значення:
|
| type: | рядок Можливі значення типу:
|
| resolution: | рядок Рішення організатора. |
| resolutionType: | рядок Можливі значення типу вирішення:
|
| satisfied: | булеве значення Вимога задовільнена? |
| decision: | рядок Рішення органу оскарження. |
| cancellationReason: | |
рядок Причини відхилення. |
|
| documents: | Список об’єктів Document |
| auctionerAction: | |
|---|---|
рядок Дія учасника. |
|
| auctionerActionDate: | |
рядок, Date, генерується автоматично Дата дії учасника. |
|
Contract¶
Схема¶
| id: | UID, генерується автоматично OpenContracting Description: Ідентифікатор цього договору. |
|---|---|
| awardID: | рядок, обов’язковий OpenContracting Description: Award.id вказує на рішення, згідно якого видається договір. |
| contractID: | рядок, генерується автоматично, лише для читання |
| contractNumber: | рядок |
| title: | рядок, обов’язковий OpenContracting Description: Назва договору |
| description: | рядок OpenContracting Description: Опис договору |
| value: | Об’єкт Value, генерується автоматично, лише для читання OpenContracting Description: Загальна вартість договору. |
| items: | Список об’єктів Item, генерується автоматично, лише для читання OpenContracting Description: Товари, послуги та інші нематеріальні результати у цій угоді. Зверніть увагу: Якщо список співпадає з визначенням переможця award, то його не потрібно повторювати. |
| suppliers: | Список об’єктів Organization, генерується автоматично, лише для читання |
| status: | рядок, обов’язковий OpenContracting Description: Поточний статус договору. Можливі значення:
|
| period: |
OpenContracting Description: Дата початку та завершення договору. |
| dateSigned: | рядок, Date OpenContracting Description: Дата підписання договору. Якщо було декілька підписань, то береться дата останнього підписання. |
| date: | рядок, Date Дата, коли договір був змінений або активований. |
| documents: | Список об’єктів Document OpenContracting Description: Усі документи та додатки пов’язані з договором, включно з будь-якими повідомленнями. |
Period¶
Date¶
Дата/час у Date Format: ISO 8601.
Value¶
Схема¶
| amount: | float, обов’язково OpenContracting Description: Кількість як число. Повинно бути додатнім. |
|---|---|
| currency: | рядок, обов’язковий OpenContracting Description: Валюта у трибуквенному форматі ISO 4217. |
| valueAddedTaxIncluded: | |
булеве значення, обов’язково |
|
Guarantee¶
Схема¶
| amount: | float, обов’язково OpenContracting Description: Кількість як число. Повинно бути додатнім. |
|---|---|
| currency: | рядок, обов’язковий, за замовчуванням = UAH OpenContracting Description: Валюта у трибуквенному форматі ISO 4217. |
Cancellation¶
Схема¶
| id: | UID, генерується автоматично |
||||
|---|---|---|---|---|---|
| reason: | рядок, багатомовний, обов’язковий Причина, з якої скасовується аукціон. |
||||
| status: | рядок
|
||||
| documents: | Список об’єктів Document Супровідна документація скасування: Протокол рішення Аукціонного комітету організатора про скасування аукціону. |
||||
| date: | рядок, Date Дата скасування |
||||
| cancellationOf: | рядок Можливі значення:
|
ProcuringEntity (Організатор)¶
Схема¶
| name: | рядок, багатомовний OpenContracting Description: Назва організації. |
|---|---|
| identifier: |
OpenContracting Description: Ідентифікатор цієї організації. |
| additionalIdentifiers: | |
Список об’єктів Identifier |
|
| address: | Address, обов’язково |
| contactPoint: | ContactPoint, обов’язково |
| kind: | рядок Тип організатора
|
Завантаження документа¶
Всі точки входу API для завантаження документів застосовують однакові правила.
Зареєструвати завантаження документа¶
Додати документ в API:
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0 Authorization: Basic YnJva2VyOg== Content-Length: 411 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/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=x2gHJad2pwHjJ3WInHiyYd4jv7rQ3EdghsPyk6QSGvCnzPTwwotm3Ija2Wgc6GviXJG0q%2F0dYUh%2FrjwgqBIPCA%3D%3D", "format": "application/pdf", "documentType": "technicalSpecifications" } } 201 Created Content-Type: application/json; charset=UTF-8 Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/d24959c19c6544039ba215721fc188d7 { "data": { "hash": "md5:00000000000000000000000000000000", "description": "document description", "format": "application/pdf", "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D", "title": "Notice.pdf", "documentOf": "tender", "datePublished": "2017-02-01T13:22:20.587044+02:00", "documentType": "technicalSpecifications", "dateModified": "2017-02-01T13:22:20.587093+02:00", "id": "d24959c19c6544039ba215721fc188d7" } }
Завантажити документ без реєстрації¶
Додати документ в API:
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0 Authorization: Basic YnJva2VyOg== Content-Length: 411 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/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=x2gHJad2pwHjJ3WInHiyYd4jv7rQ3EdghsPyk6QSGvCnzPTwwotm3Ija2Wgc6GviXJG0q%2F0dYUh%2FrjwgqBIPCA%3D%3D", "format": "application/pdf", "documentType": "technicalSpecifications" } } 201 Created Content-Type: application/json; charset=UTF-8 Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/d24959c19c6544039ba215721fc188d7 { "data": { "hash": "md5:00000000000000000000000000000000", "description": "document description", "format": "application/pdf", "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D", "title": "Notice.pdf", "documentOf": "tender", "datePublished": "2017-02-01T13:22:20.587044+02:00", "documentType": "technicalSpecifications", "dateModified": "2017-02-01T13:22:20.587093+02:00", "id": "d24959c19c6544039ba215721fc188d7" } }
![digraph G {
subgraph cluster_0 {
label = "award #2";
node [style=filled];
edge[style=dashed];
"pending.waiting" -> cancel;
color=blue
}
subgraph cluster_1 {
node [style=filled];
edge[label=" 3d"];
"pending.verification" -> unsuccessful;
edge[label="5d**"];
active -> unsuccessful;
edge[label=" 3d*"];
"pending.verification" -> "pending.payment";
edge[label="*" style=dashed];
"pending.verification" -> "pending.payment"
label = "award #1";
color=blue
}
edge[style=dashed];
active -> unsuccessful;
edge[label="***"];
"pending.waiting" -> "pending.verification";
edge[label="7d" style=solid];
"pending.payment" -> unsuccessful;
edge[label="*" style=dashed];
"pending.verification" -> unsuccessful;
edge[style=dashed];
"pending.payment" -> active;
}](_images/graphviz-ff09bba3d113fdc29a6ee0d7207c50ad3d17d977.png)
Туторіал¶
Базові правила¶
Подивимось як працює точка входу /auctions:
GET /api/2.3/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"next_page": {
"path": "/api/2.3/auctions?offset=",
"uri": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions?offset=",
"offset": ""
},
"data": []
}
При виклику видає пустий набір.
Спробуймо створити новий аукціон:
POST /api/2.3/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: api-sandbox.ea.openprocurement.org
415 Unsupported Media Type
Content-Type: application/json; charset=UTF-8
{
"status": "error",
"errors": [
{
"description": "Content-Type header should be one of ['application/json']",
"location": "header",
"name": "Content-Type"
}
]
}
Помилка вказує, що єдиний прийнятний тип вмісту це application/json.
Задовільнимо вимогу типу вмісту:
POST /api/2.3/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
422 Unprocessable Entity
Content-Type: application/json; charset=UTF-8
{
"status": "error",
"errors": [
{
"description": "No JSON object could be decoded",
"location": "body",
"name": "data"
}
]
}
Помилка вказує, що data не знайдено у тілі JSON.
Створення аукціону¶
Створимо аукціон з мінімально допустимим набором даних (тільки параметри обовязкові для заповнення) :
POST /api/2.3/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2149
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"auctionPeriod": {
"startDate": "2017-02-15"
},
"tenderAttempts": 1,
"procurementMethodType": "dgfOtherAssets",
"value": {
"currency": "UAH",
"amount": 100
},
"dgfDecisionDate": "2016-11-17",
"dgfID": "219560",
"dgfDecisionID": "219560",
"procurementMethodDetails": "quick, accelerator=1440",
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"id": "04114000-0",
"description": "Земельні ділянки"
},
"address": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"schema_properties": {
"code": "04114000-0",
"version": "latest",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
}
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a
{
"access": {
"token": "2ac7aaf0d5b2429e9024f281f75c0eaf"
},
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2017-02-01-000001",
"enquiryPeriod": {
"startDate": "2017-02-01T13:22:19.998859+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"submissionMethod": "electronicAuction",
"dgfDecisionDate": "2016-11-17",
"next_check": "2017-02-14T23:59:50+02:00",
"awardCriteria": "highestCost",
"dgfDecisionID": "219560",
"owner": "broker",
"id": "56c507ca68744c5f964933955043072a",
"documents": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:19.999323+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:19.999372+02:00",
"id": "3136ee8064c24ef4ab8555d430927ebd"
}
],
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2017-02-01T13:22:20.014795+02:00",
"status": "active.tendering",
"tenderPeriod": {
"startDate": "2017-02-01T13:22:19.998859+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"auctionPeriod": {
"shouldStartAfter": "2017-02-15T00:00:00+02:00"
},
"procurementMethodType": "dgfOtherAssets",
"dgfID": "219560",
"date": "2017-02-01T13:22:19.998859+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "04114000-0"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"schema_properties": {
"code": "041",
"version": "001",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"id": "fde9635b26524ed3b0265e1e00842537",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.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.3/auctions/56c507ca68744c5f964933955043072a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2017-02-01-000001",
"enquiryPeriod": {
"startDate": "2017-02-01T13:22:19.998859+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"submissionMethod": "electronicAuction",
"dgfDecisionDate": "2016-11-17",
"next_check": "2017-02-14T23:59:50+02:00",
"awardCriteria": "highestCost",
"dgfDecisionID": "219560",
"owner": "broker",
"id": "56c507ca68744c5f964933955043072a",
"documents": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:19.999323+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:19.999372+02:00",
"id": "3136ee8064c24ef4ab8555d430927ebd"
}
],
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2017-02-01T13:22:20.014795+02:00",
"status": "active.tendering",
"tenderPeriod": {
"startDate": "2017-02-01T13:22:19.998859+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"auctionPeriod": {
"shouldStartAfter": "2017-02-15T00:00:00+02:00"
},
"procurementMethodType": "dgfOtherAssets",
"dgfID": "219560",
"date": "2017-02-01T13:22:19.998859+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "04114000-0"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"schema_properties": {
"code": "041",
"version": "001",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"id": "fde9635b26524ed3b0265e1e00842537",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.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.3/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"next_page": {
"path": "/api/2.3/auctions?offset=2017-02-01T13%3A22%3A20.014795%2B02%3A00",
"uri": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions?offset=2017-02-01T13%3A22%3A20.014795%2B02%3A00",
"offset": "2017-02-01T13:22:20.014795+02:00"
},
"data": [
{
"id": "56c507ca68744c5f964933955043072a",
"dateModified": "2017-02-01T13:22:20.014795+02:00"
}
]
}
Ми бачимо внутрішнє id аукціону (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/auctions/) та його dateModified дату.
Попередній аукціон був створений лише з обов’язковими полями. Тепер додамо аукціон з максимально допустимим набором даних при створенні (аукціон повинен бути у статусі created).
POST /api/2.3/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2057
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"auctionPeriod": {
"startDate": "2017-02-15"
},
"tenderAttempts": 1,
"procurementMethodType": "dgfOtherAssets",
"value": {
"currency": "UAH",
"amount": 100
},
"dgfDecisionDate": "2016-11-17",
"dgfID": "219560",
"title_ru": "футляры к государственным наградам",
"dgfDecisionID": "219560",
"procurementMethodDetails": "quick, accelerator=1440",
"items": [
{
"classification": {
"scheme": "CAV",
"id": "06000000-2",
"description": "Земельні ділянки"
},
"description": "Земля для військовослужбовців",
"id": "c95af629836646d893797c15e98220ec",
"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; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/2c90eade223c430ba33ddeaddf251a12
{
"access": {
"token": "a606164cd80f4d60926af34741ab7143"
},
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2017-02-01-000002",
"enquiryPeriod": {
"startDate": "2017-02-01T13:22:20.213837+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"submissionMethod": "electronicAuction",
"dgfDecisionDate": "2016-11-17",
"next_check": "2017-02-14T23:59:50+02:00",
"awardCriteria": "highestCost",
"dgfDecisionID": "219560",
"owner": "broker",
"title_en": "Cases with state awards",
"id": "2c90eade223c430ba33ddeaddf251a12",
"documents": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.214262+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:20.214306+02:00",
"id": "86662dc6c80d4959afedfe3f46e96b2c"
}
],
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2017-02-01T13:22:20.218943+02:00",
"status": "active.tendering",
"tenderPeriod": {
"startDate": "2017-02-01T13:22:20.213837+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"auctionPeriod": {
"shouldStartAfter": "2017-02-15T00:00:00+02:00"
},
"procurementMethodType": "dgfOtherAssets",
"dgfID": "219560",
"date": "2017-02-01T13:22:20.213837+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"unit": {
"code": "44617100-9",
"name": "item"
},
"description": "Земля для військовослужбовців",
"id": "c95af629836646d893797c15e98220ec",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "06000000-2"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"title_ru": "футляры к государственным наградам",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
}
}
І знову код відповіді 201 Created, заголовок Location і тіло з додатковим id, auctionID, та властивість dateModified.
Перевіримо, що містить реєстр аукціонів:
GET /api/2.3/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"next_page": {
"path": "/api/2.3/auctions?offset=2017-02-01T13%3A22%3A20.014795%2B02%3A00",
"uri": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions?offset=2017-02-01T13%3A22%3A20.014795%2B02%3A00",
"offset": "2017-02-01T13:22:20.014795+02:00"
},
"data": [
{
"id": "56c507ca68744c5f964933955043072a",
"dateModified": "2017-02-01T13:22:20.014795+02:00"
}
]
}
Дійсно, в нас зараз є дві аукціони.
Модифікація аукціону¶
Оновимо аукціон шляхом надання йому усіх інших важливих властивостей:
PATCH /api/2.3/auctions/56c507ca68744c5f964933955043072a?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"tenderPeriod": {
"endDate": "2017-02-16T13:22:30.399678+02:00"
}
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2017-02-01-000001",
"enquiryPeriod": {
"startDate": "2017-02-01T13:22:19.998859+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"submissionMethod": "electronicAuction",
"dgfDecisionDate": "2016-11-17",
"next_check": "2017-02-14T23:59:50+02:00",
"awardCriteria": "highestCost",
"dgfDecisionID": "219560",
"owner": "broker",
"id": "56c507ca68744c5f964933955043072a",
"documents": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:19.999323+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:19.999372+02:00",
"id": "3136ee8064c24ef4ab8555d430927ebd"
}
],
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2017-02-01T13:22:20.014795+02:00",
"status": "active.tendering",
"tenderPeriod": {
"startDate": "2017-02-01T13:22:19.998859+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"auctionPeriod": {
"shouldStartAfter": "2017-02-15T00:00:00+02:00"
},
"procurementMethodType": "dgfOtherAssets",
"dgfID": "219560",
"date": "2017-02-01T13:22:19.998859+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "04114000-0"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"schema_properties": {
"code": "041",
"version": "001",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"id": "fde9635b26524ed3b0265e1e00842537",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.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.3/auctions?opt_pretty=1 HTTP/1.0
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"next_page": {
"path": "/api/2.3/auctions?offset=2017-02-01T13%3A22%3A20.311070%2B02%3A00",
"uri": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions?offset=2017-02-01T13%3A22%3A20.311070%2B02%3A00",
"offset": "2017-02-01T13:22:20.311070+02:00"
},
"data": [
{
"id": "56c507ca68744c5f964933955043072a",
"dateModified": "2017-02-01T13:22:20.014795+02:00"
},
{
"id": "2c90eade223c430ba33ddeaddf251a12",
"dateModified": "2017-02-01T13:22:20.218943+02:00"
},
{
"id": "d58c81b7689545f181174fb906a463d4",
"dateModified": "2017-02-01T13:22:20.311070+02:00"
}
]
}
Завантаження документації¶
Замовник може завантажити PDF файл у створений аукціон. Завантаження повинно відбуватись згідно правил Завантаження документа.
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 411
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/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=x2gHJad2pwHjJ3WInHiyYd4jv7rQ3EdghsPyk6QSGvCnzPTwwotm3Ija2Wgc6GviXJG0q%2F0dYUh%2FrjwgqBIPCA%3D%3D",
"format": "application/pdf",
"documentType": "technicalSpecifications"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/d24959c19c6544039ba215721fc188d7
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"description": "document description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.587044+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:20.587093+02:00",
"id": "d24959c19c6544039ba215721fc188d7"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/d24959c19c6544039ba215721fc188d7 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"description": "document description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.587044+02:00",
"previousVersions": [],
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:20.587093+02:00",
"id": "d24959c19c6544039ba215721fc188d7"
}
}
Один елемент масиву описує завантажений документ. Ми можемо завантажити більше документів:
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf 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/d1d90e7c594b4260b35870a5b2b603f2?KeyID=8f3407b6&Signature=8Tc7GO947tfWwzbzqDnbv4qaJ80%2BulBO2%2BT9%2BfGPIjdK%2BPU6OZ6fLVQp5UEMdhcUZKL7DeVHbpCNnB7iQRJNBA%3D%3D",
"title": "AwardCriteria.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/91240c87090242658d9158df422f0656
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/d1d90e7c594b4260b35870a5b2b603f2?KeyID=8f3407b6&Signature=J3TzjvObtQLKCmaT74CL%252B9iPiHxhikgMt2e2XfdkebIfPHsJmf%252BCqBW6KJ3mkULAHnOxYr6r81R2eQCD1EDLCQ%253D%253D",
"title": "AwardCriteria.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.734187+02:00",
"dateModified": "2017-02-01T13:22:20.734286+02:00",
"id": "91240c87090242658d9158df422f0656"
}
}
І знову можна перевірити, що є два завантажених документа.
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:19.999323+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:19.999372+02:00",
"id": "3136ee8064c24ef4ab8555d430927ebd"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.587044+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:20.587093+02:00",
"id": "d24959c19c6544039ba215721fc188d7"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/d1d90e7c594b4260b35870a5b2b603f2?KeyID=8f3407b6&Signature=J3TzjvObtQLKCmaT74CL%252B9iPiHxhikgMt2e2XfdkebIfPHsJmf%252BCqBW6KJ3mkULAHnOxYr6r81R2eQCD1EDLCQ%253D%253D",
"title": "AwardCriteria.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.734187+02:00",
"dateModified": "2017-02-01T13:22:20.734286+02:00",
"id": "91240c87090242658d9158df422f0656"
}
]
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
PUT /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/91240c87090242658d9158df422f0656?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf 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/72309f80c9c34b5bb4333834f1512188?KeyID=8f3407b6&Signature=zpAtP67VnpW%2FW4s96FDBtnSURZjHW3eutg5lS6NH7GyGzbys2vV%2BpOR4D%2BjdpmCnKhrhIP1waSOnprgbNF20DA%3D%3D",
"title": "AwardCriteria-2.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/72309f80c9c34b5bb4333834f1512188?KeyID=8f3407b6&Signature=g4SOcSX5%252BTz3HyoRG6Wanx2r2rYAQTBVH3WV8YJjY13WWQXIc%252BEHHuehiaCWFFq5TXCcpdcRdKvNzYwsHr4hDQ%253D%253D",
"title": "AwardCriteria-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.734187+02:00",
"dateModified": "2017-02-01T13:22:21.110477+02:00",
"id": "91240c87090242658d9158df422f0656"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:19.999323+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:19.999372+02:00",
"id": "3136ee8064c24ef4ab8555d430927ebd"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.587044+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:20.587093+02:00",
"id": "d24959c19c6544039ba215721fc188d7"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/72309f80c9c34b5bb4333834f1512188?KeyID=8f3407b6&Signature=g4SOcSX5%252BTz3HyoRG6Wanx2r2rYAQTBVH3WV8YJjY13WWQXIc%252BEHHuehiaCWFFq5TXCcpdcRdKvNzYwsHr4hDQ%253D%253D",
"title": "AwardCriteria-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.734187+02:00",
"dateModified": "2017-02-01T13:22:21.110477+02:00",
"id": "91240c87090242658d9158df422f0656"
}
]
}
Завантаження ілюстрації¶
Організатор може завантажити файли з ілюстраціями у створений аукціон. Завантаження повинно відповідати правилам Завантаження документа.
Для того, щоб вказати порядок відображення ілюстрацій, використовується поле index (див. Document). Оскільки ця ілюстрація повинна бути відображена першою, то вказується "index": 1.
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 430
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/706d73b92a65446199d1d0573963d601?KeyID=8f3407b6&Signature=KjHBSwz4JyFIRkvYmubAy0GZI2SHGsP1OtuXs56fmgnxov1RMk6Fxtj0LQzl1VpF8lg%2BzN5N%2FW8ypFmnr4QwDg%3D%3D",
"format": "image/jpeg",
"documentType": "illustration"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/e7803c183b6e4ec9a45529d5b5896b21
{
"data": {
"index": 1,
"hash": "md5:00000000000000000000000000000000",
"description": "First illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/706d73b92a65446199d1d0573963d601?KeyID=8f3407b6&Signature=AUG0Ux1M3qgW8e1mtYzVaHy55h1MSBWrP9V%2Fy9SbMmwnzRYTSU3f0FP%2FuW%2FmGCpZhDj4zfyx6Dh6bfp8ByQcAw%253D%253D",
"title": "first_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.233533+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.233582+02:00",
"id": "e7803c183b6e4ec9a45529d5b5896b21"
}
}
Ми можемо перевірити, чи завантажилась ілюстрація.
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:19.999323+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:19.999372+02:00",
"id": "3136ee8064c24ef4ab8555d430927ebd"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.587044+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:20.587093+02:00",
"id": "d24959c19c6544039ba215721fc188d7"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/72309f80c9c34b5bb4333834f1512188?KeyID=8f3407b6&Signature=g4SOcSX5%252BTz3HyoRG6Wanx2r2rYAQTBVH3WV8YJjY13WWQXIc%252BEHHuehiaCWFFq5TXCcpdcRdKvNzYwsHr4hDQ%253D%253D",
"title": "AwardCriteria-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.734187+02:00",
"dateModified": "2017-02-01T13:22:21.110477+02:00",
"id": "91240c87090242658d9158df422f0656"
},
{
"index": 1,
"hash": "md5:00000000000000000000000000000000",
"description": "First illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/706d73b92a65446199d1d0573963d601?KeyID=8f3407b6&Signature=AUG0Ux1M3qgW8e1mtYzVaHy55h1MSBWrP9V%2Fy9SbMmwnzRYTSU3f0FP%2FuW%2FmGCpZhDj4zfyx6Dh6bfp8ByQcAw%253D%253D",
"title": "first_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.233533+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.233582+02:00",
"id": "e7803c183b6e4ec9a45529d5b5896b21"
}
]
}
Організатор може завантажити ще одну ілюстрацію. Ця ілюстрація повинна бути відображена другою, тому має параметр "index": 2.
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 430
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Second illustration description",
"title": "second_illustration.jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/a5a96dd0cc6242f684a5ae7536838594?KeyID=8f3407b6&Signature=8%2FlcbzDABnNmIT0CyyXIuS73OLSsXSQym9Wg4IZxNDxnPtAVTGkBOAGn2AEwL4t0ZIwPMc2PUCpCwU7mwvPjDA%3D%3D",
"format": "image/jpeg",
"documentType": "illustration"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/b954ae21ee9e422da03d1b3511c619e5
{
"data": {
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Second illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/a5a96dd0cc6242f684a5ae7536838594?KeyID=8f3407b6&Signature=P66c7p7scu1I%2FrwS54p1o4TERQ%252BMhQOvWsegllG9S6OYkqh3oZI9CuRKHKETsG8pnh6xB9jP3QpfCHA0ihuYAA%253D%253D",
"title": "second_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.382379+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.382428+02:00",
"id": "b954ae21ee9e422da03d1b3511c619e5"
}
}
Додаємо третю ілюстрацію:
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 432
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Third illustration description",
"title": "third_illustration.jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/113b840ceb314f7e9755898dd04ca7a8?KeyID=8f3407b6&Signature=EkAj%2BeR6uirMFKEjwyYNB55CezxVgv3PdAgq4JGybaCKTkAFrPM5C%2BawGW3XMFEC9eByl4BBLcyYf6h8%2BVUEBQ%3D%3D",
"format": "image/jpeg",
"documentType": "illustration"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/b7aeede0898a4fe294c15f145a7c0dac
{
"data": {
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Third illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/113b840ceb314f7e9755898dd04ca7a8?KeyID=8f3407b6&Signature=BBEUcPxmB3wdQoG4I9xkkTXI7d2n8A5B7KjWzgD%2FG9CliAd%252BaL8Mf6TnQGOFJUBYGRDTHJuhSxoI%252BRWl0Qw%252BBQ%253D%253D",
"title": "third_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.485198+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.485248+02:00",
"id": "b7aeede0898a4fe294c15f145a7c0dac"
}
}
Зверніть увагу, що параметр index третьої ілюстрації такий же як і у другої: "index": 2. У таких випадках спочатку відображатиметься ілюстрація з ранішою датою публікації.
Можемо перевірити, що є три завантажені ілюстрації.
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:19.999323+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:19.999372+02:00",
"id": "3136ee8064c24ef4ab8555d430927ebd"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.587044+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:20.587093+02:00",
"id": "d24959c19c6544039ba215721fc188d7"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/72309f80c9c34b5bb4333834f1512188?KeyID=8f3407b6&Signature=g4SOcSX5%252BTz3HyoRG6Wanx2r2rYAQTBVH3WV8YJjY13WWQXIc%252BEHHuehiaCWFFq5TXCcpdcRdKvNzYwsHr4hDQ%253D%253D",
"title": "AwardCriteria-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.734187+02:00",
"dateModified": "2017-02-01T13:22:21.110477+02:00",
"id": "91240c87090242658d9158df422f0656"
},
{
"index": 1,
"hash": "md5:00000000000000000000000000000000",
"description": "First illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/706d73b92a65446199d1d0573963d601?KeyID=8f3407b6&Signature=AUG0Ux1M3qgW8e1mtYzVaHy55h1MSBWrP9V%2Fy9SbMmwnzRYTSU3f0FP%2FuW%2FmGCpZhDj4zfyx6Dh6bfp8ByQcAw%253D%253D",
"title": "first_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.233533+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.233582+02:00",
"id": "e7803c183b6e4ec9a45529d5b5896b21"
},
{
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Second illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/a5a96dd0cc6242f684a5ae7536838594?KeyID=8f3407b6&Signature=P66c7p7scu1I%2FrwS54p1o4TERQ%252BMhQOvWsegllG9S6OYkqh3oZI9CuRKHKETsG8pnh6xB9jP3QpfCHA0ihuYAA%253D%253D",
"title": "second_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.382379+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.382428+02:00",
"id": "b954ae21ee9e422da03d1b3511c619e5"
},
{
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Third illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/113b840ceb314f7e9755898dd04ca7a8?KeyID=8f3407b6&Signature=BBEUcPxmB3wdQoG4I9xkkTXI7d2n8A5B7KjWzgD%2FG9CliAd%252BaL8Mf6TnQGOFJUBYGRDTHJuhSxoI%252BRWl0Qw%252BBQ%253D%253D",
"title": "third_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.485198+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.485248+02:00",
"id": "b7aeede0898a4fe294c15f145a7c0dac"
}
]
}
Add Asset Familiarization¶
Organizer can upload asset familiarization document into the created auction.
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 160
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"title": "Familiarization with bank asset",
"accessDetails": "Familiar with asset: days, time, address",
"documentType": "x_dgfAssetFamiliarization"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/dfe2a9dac42c4c01a81744873cfb4c1e
{
"data": {
"title": "Familiarization with bank asset",
"format": "offline/on-site-examination",
"accessDetails": "Familiar with asset: days, time, address",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.648077+02:00",
"documentType": "x_dgfAssetFamiliarization",
"dateModified": "2017-02-01T13:22:21.648133+02:00",
"id": "dfe2a9dac42c4c01a81744873cfb4c1e"
}
}
We can check whether asset familiarization document is added.
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:19.999323+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:19.999372+02:00",
"id": "3136ee8064c24ef4ab8555d430927ebd"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.587044+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:20.587093+02:00",
"id": "d24959c19c6544039ba215721fc188d7"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/72309f80c9c34b5bb4333834f1512188?KeyID=8f3407b6&Signature=g4SOcSX5%252BTz3HyoRG6Wanx2r2rYAQTBVH3WV8YJjY13WWQXIc%252BEHHuehiaCWFFq5TXCcpdcRdKvNzYwsHr4hDQ%253D%253D",
"title": "AwardCriteria-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.734187+02:00",
"dateModified": "2017-02-01T13:22:21.110477+02:00",
"id": "91240c87090242658d9158df422f0656"
},
{
"index": 1,
"hash": "md5:00000000000000000000000000000000",
"description": "First illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/706d73b92a65446199d1d0573963d601?KeyID=8f3407b6&Signature=AUG0Ux1M3qgW8e1mtYzVaHy55h1MSBWrP9V%2Fy9SbMmwnzRYTSU3f0FP%2FuW%2FmGCpZhDj4zfyx6Dh6bfp8ByQcAw%253D%253D",
"title": "first_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.233533+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.233582+02:00",
"id": "e7803c183b6e4ec9a45529d5b5896b21"
},
{
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Second illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/a5a96dd0cc6242f684a5ae7536838594?KeyID=8f3407b6&Signature=P66c7p7scu1I%2FrwS54p1o4TERQ%252BMhQOvWsegllG9S6OYkqh3oZI9CuRKHKETsG8pnh6xB9jP3QpfCHA0ihuYAA%253D%253D",
"title": "second_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.382379+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.382428+02:00",
"id": "b954ae21ee9e422da03d1b3511c619e5"
},
{
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Third illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/113b840ceb314f7e9755898dd04ca7a8?KeyID=8f3407b6&Signature=BBEUcPxmB3wdQoG4I9xkkTXI7d2n8A5B7KjWzgD%2FG9CliAd%252BaL8Mf6TnQGOFJUBYGRDTHJuhSxoI%252BRWl0Qw%252BBQ%253D%253D",
"title": "third_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.485198+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.485248+02:00",
"id": "b7aeede0898a4fe294c15f145a7c0dac"
},
{
"title": "Familiarization with bank asset",
"format": "offline/on-site-examination",
"accessDetails": "Familiar with asset: days, time, address",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.648077+02:00",
"documentType": "x_dgfAssetFamiliarization",
"dateModified": "2017-02-01T13:22:21.648133+02:00",
"id": "dfe2a9dac42c4c01a81744873cfb4c1e"
}
]
}
Уточнення (питання)¶
Коли закупівля має статус active.tendering, зацікавлені сторони можуть задавати питання:
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"author": {
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137226",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
},
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/questions/5140218e67ee45368ac64d44b5423cf0
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://sch10.edu.vn.ua/",
"id": "00137226"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"date": "2017-02-01T13:22:21.776002+02:00",
"id": "5140218e67ee45368ac64d44b5423cf0",
"questionOf": "tender"
}
}
Організатор може на них відповісти:
PATCH /api/2.3/auctions/56c507ca68744c5f964933955043072a/questions/5140218e67ee45368ac64d44b5423cf0?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність",
"date": "2017-02-01T13:22:21.776002+02:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "5140218e67ee45368ac64d44b5423cf0",
"questionOf": "tender"
}
}
Можна отримати список запитань:
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність",
"date": "2017-02-01T13:22:21.776002+02:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "5140218e67ee45368ac64d44b5423cf0",
"questionOf": "tender"
}
]
}
або окрему відповідь:
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/questions/5140218e67ee45368ac64d44b5423cf0 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність",
"date": "2017-02-01T13:22:21.776002+02:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "5140218e67ee45368ac64d44b5423cf0",
"questionOf": "tender"
}
}
Реєстрація пропозиції¶
Учасник може зареєструвати пропозицію у статусі draft (чернетка):
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 776
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "draft",
"qualified": true,
"value": {
"amount": 500
},
"tenderers": [
{
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
]
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/bids/8af88dae2b8744f1964b33be121adceb
{
"access": {
"token": "1c771b87f5b24056bfb40604c915d221"
},
"data": {
"status": "draft",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:22.035157+02:00",
"qualified": true,
"tenderers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"owner": "broker",
"id": "8af88dae2b8744f1964b33be121adceb"
}
}
І активувати пропозицію:
PATCH /api/2.3/auctions/56c507ca68744c5f964933955043072a/bids/8af88dae2b8744f1964b33be121adceb?acc_token=1c771b87f5b24056bfb40604c915d221 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:22.035157+02:00",
"qualified": true,
"tenderers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"owner": "broker",
"id": "8af88dae2b8744f1964b33be121adceb"
}
}
І завантажити документ пропозиції:
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/bids/8af88dae2b8744f1964b33be121adceb/documents?acc_token=1c771b87f5b24056bfb40604c915d221 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 335
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/4c0b3a7326704ca7b04c8121ea5d1465?KeyID=8f3407b6&Signature=n7gZin2O1b3BLrnOCn2430JWYxB6GASIg%2FfQrMb%2Fn%2FZzmHU52hXvDDokerDv%2FQ1lXzOtAHnDZBB8LR0i64K4BA%3D%3D",
"title": "Proposal.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/bids/8af88dae2b8744f1964b33be121adceb/documents/a66a1c16b74d46f9a3c5c6b7cb8aecfc
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/bids/8af88dae2b8744f1964b33be121adceb/documents/a66a1c16b74d46f9a3c5c6b7cb8aecfc?download=4c0b3a7326704ca7b04c8121ea5d1465",
"title": "Proposal.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:22.223385+02:00",
"dateModified": "2017-02-01T13:22:22.223412+02:00",
"id": "a66a1c16b74d46f9a3c5c6b7cb8aecfc"
}
}
Можна перевірити завантажені документи:
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/bids/8af88dae2b8744f1964b33be121adceb/documents?acc_token=1c771b87f5b24056bfb40604c915d221 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/bids/8af88dae2b8744f1964b33be121adceb/documents/a66a1c16b74d46f9a3c5c6b7cb8aecfc?download=4c0b3a7326704ca7b04c8121ea5d1465",
"title": "Proposal.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:22.223385+02:00",
"dateModified": "2017-02-01T13:22:22.223412+02:00",
"id": "a66a1c16b74d46f9a3c5c6b7cb8aecfc"
}
]
}
Для найкращого результату (найбільшої економії) аукціон повинен мати багато зареєстрованих учасників.
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 723
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"qualified": true,
"value": {
"amount": 501
},
"tenderers": [
{
"contactPoint": {
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк",
"email": "aagt@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"countryName": "Україна",
"postalCode": "79013",
"region": "м. Львів",
"streetAddress": "вул. Островського, 34",
"locality": "м. Львів"
}
}
]
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/bids/6c8100e4637f46a1b09e66a9ab06862d
{
"access": {
"token": "8c502f3c6f0a49d38da11b8b0b45f0dd"
},
"data": {
"status": "active",
"value": {
"currency": "UAH",
"amount": 501.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:22.345395+02:00",
"qualified": true,
"tenderers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"owner": "broker",
"id": "6c8100e4637f46a1b09e66a9ab06862d"
}
}
Аукціон¶
Після того, як аукціон заплановано, будь-хто може його відвідати для перегляду. Аукціон можна подивитись за допомогою Auction.auctionUrl:
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2017-02-01-000001",
"auctionUrl": "http://auction-sandbox.openprocurement.org/auctions/56c507ca68744c5f964933955043072a",
"enquiryPeriod": {
"startDate": "2017-01-25T13:22:08.968733+02:00",
"endDate": "2017-02-01T13:22:08.968733+02:00"
},
"submissionMethod": "electronicAuction",
"dgfDecisionDate": "2016-11-17",
"next_check": "2017-02-01T14:06:08.968733+02:00",
"awardCriteria": "highestCost",
"questions": [
{
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність",
"date": "2017-02-01T13:22:21.776002+02:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "5140218e67ee45368ac64d44b5423cf0",
"questionOf": "tender"
}
],
"dgfDecisionID": "219560",
"owner": "broker",
"id": "56c507ca68744c5f964933955043072a",
"documents": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:19.999323+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:19.999372+02:00",
"id": "3136ee8064c24ef4ab8555d430927ebd"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.587044+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:20.587093+02:00",
"id": "d24959c19c6544039ba215721fc188d7"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/d1d90e7c594b4260b35870a5b2b603f2?KeyID=8f3407b6&Signature=J3TzjvObtQLKCmaT74CL%252B9iPiHxhikgMt2e2XfdkebIfPHsJmf%252BCqBW6KJ3mkULAHnOxYr6r81R2eQCD1EDLCQ%253D%253D",
"title": "AwardCriteria.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.734187+02:00",
"dateModified": "2017-02-01T13:22:20.734286+02:00",
"id": "91240c87090242658d9158df422f0656"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/72309f80c9c34b5bb4333834f1512188?KeyID=8f3407b6&Signature=g4SOcSX5%252BTz3HyoRG6Wanx2r2rYAQTBVH3WV8YJjY13WWQXIc%252BEHHuehiaCWFFq5TXCcpdcRdKvNzYwsHr4hDQ%253D%253D",
"title": "AwardCriteria-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.734187+02:00",
"dateModified": "2017-02-01T13:22:21.110477+02:00",
"id": "91240c87090242658d9158df422f0656"
},
{
"index": 1,
"hash": "md5:00000000000000000000000000000000",
"description": "First illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/706d73b92a65446199d1d0573963d601?KeyID=8f3407b6&Signature=AUG0Ux1M3qgW8e1mtYzVaHy55h1MSBWrP9V%2Fy9SbMmwnzRYTSU3f0FP%2FuW%2FmGCpZhDj4zfyx6Dh6bfp8ByQcAw%253D%253D",
"title": "first_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.233533+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.233582+02:00",
"id": "e7803c183b6e4ec9a45529d5b5896b21"
},
{
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Second illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/a5a96dd0cc6242f684a5ae7536838594?KeyID=8f3407b6&Signature=P66c7p7scu1I%2FrwS54p1o4TERQ%252BMhQOvWsegllG9S6OYkqh3oZI9CuRKHKETsG8pnh6xB9jP3QpfCHA0ihuYAA%253D%253D",
"title": "second_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.382379+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.382428+02:00",
"id": "b954ae21ee9e422da03d1b3511c619e5"
},
{
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Third illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/113b840ceb314f7e9755898dd04ca7a8?KeyID=8f3407b6&Signature=BBEUcPxmB3wdQoG4I9xkkTXI7d2n8A5B7KjWzgD%2FG9CliAd%252BaL8Mf6TnQGOFJUBYGRDTHJuhSxoI%252BRWl0Qw%252BBQ%253D%253D",
"title": "third_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.485198+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.485248+02:00",
"id": "b7aeede0898a4fe294c15f145a7c0dac"
},
{
"title": "Familiarization with bank asset",
"format": "offline/on-site-examination",
"accessDetails": "Familiar with asset: days, time, address",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.648077+02:00",
"documentType": "x_dgfAssetFamiliarization",
"dateModified": "2017-02-01T13:22:21.648133+02:00",
"id": "dfe2a9dac42c4c01a81744873cfb4c1e"
}
],
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2017-02-01T13:22:22.621445+02:00",
"status": "active.auction",
"tenderPeriod": {
"startDate": "2017-01-25T13:22:08.968733+02:00",
"endDate": "2017-02-01T13:22:08.968733+02:00"
},
"auctionPeriod": {
"startDate": "2017-02-01T13:22:08.968733+02:00",
"shouldStartAfter": "2017-02-02T00:00:00+02:00"
},
"procurementMethodType": "dgfOtherAssets",
"dgfID": "219560",
"date": "2017-02-01T13:22:19.998859+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "04114000-0"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"schema_properties": {
"code": "041",
"version": "001",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"id": "fde9635b26524ed3b0265e1e00842537",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.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.3/auctions/56c507ca68744c5f964933955043072a/bids/8af88dae2b8744f1964b33be121adceb?acc_token=1c771b87f5b24056bfb40604c915d221 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/bids/8af88dae2b8744f1964b33be121adceb/documents/a66a1c16b74d46f9a3c5c6b7cb8aecfc?download=4c0b3a7326704ca7b04c8121ea5d1465",
"title": "Proposal.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:22.223385+02:00",
"dateModified": "2017-02-01T13:22:22.223412+02:00",
"id": "a66a1c16b74d46f9a3c5c6b7cb8aecfc"
}
],
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:22.035157+02:00",
"qualified": true,
"tenderers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"owner": "broker",
"id": "8af88dae2b8744f1964b33be121adceb",
"participationUrl": "http://auction-sandbox.openprocurement.org/auctions/56c507ca68744c5f964933955043072a?key_for_bid=8af88dae2b8744f1964b33be121adceb"
}
}
Дивіться на Bid.participationUrl у відповіді. Схожу, але іншу, URL-адресу можна отримати для інших учасників.
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/bids/6c8100e4637f46a1b09e66a9ab06862d?acc_token=8c502f3c6f0a49d38da11b8b0b45f0dd HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"value": {
"currency": "UAH",
"amount": 501.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:22.345395+02:00",
"qualified": true,
"tenderers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"owner": "broker",
"id": "6c8100e4637f46a1b09e66a9ab06862d",
"participationUrl": "http://auction-sandbox.openprocurement.org/auctions/56c507ca68744c5f964933955043072a?key_for_bid=6c8100e4637f46a1b09e66a9ab06862d"
}
}
Кваліфікація¶
- Після конкурентних торгів, створюються два ‘протоколи розгляду’:
для першого кандидата (учасник з найвищою ставкою в аукціоні) - має статус `pending.verification`і очікує завантаження протоколу аукціону;
для другого кандидата (учасник з другою найбільшою ставкою в аукціоні).
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"status": "pending.verification",
"verificationPeriod": {
"startDate": "2017-02-01T13:22:22.921644+02:00",
"endDate": "2017-02-01T13:25:22.921644+02:00"
},
"complaintPeriod": {
"startDate": "2017-02-01T13:22:22.921644+02:00"
},
"suppliers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"bid_id": "6c8100e4637f46a1b09e66a9ab06862d",
"value": {
"currency": "UAH",
"amount": 501.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:22.921644+02:00",
"id": "f3dbae5e702846c19b22e6dec43dd0c5"
},
{
"status": "pending.waiting",
"complaintPeriod": {
"startDate": "2017-02-01T13:22:22.921644+02:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"bid_id": "8af88dae2b8744f1964b33be121adceb",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:22.921644+02:00",
"id": "9fe9dd8be6dc47879ddbc9227d501ff4"
}
]
}
Підтвердження кваліфікації¶
Кандидат (учасник з найбільшою ставкою в аукціоні) повинен підписати протокол аукціону ‘auctionProtocol” і прикріпити його до свого профілю кандидата протягом 3-х робочих днів після набуття статусу кандидата. Якщо протокол аукціону не завантажено до початку ‘verificationPeriod’ то ‘award’ автоматично переводиться в статус ‘unsuccessful’.
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/awards/f3dbae5e702846c19b22e6dec43dd0c5/documents?acc_token=8c502f3c6f0a49d38da11b8b0b45f0dd HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 381
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/8b261ebc3f1f482eb17af126443e491e?KeyID=8f3407b6&Signature=%2BTOPRpIHewlQ2kZPVT7iDmGsJS2ypvMrYWwTMGlr7Y%2BHZ081TRJtwNYC4j3UwojvJJ1AZvX47%2FVRRiLUPUQ8Aw%3D%3D",
"title": "SignedAuctionProtocol.pdf",
"format": "application/pdf",
"hash": "md5:00000000000000000000000000000000",
"documentType": "auctionProtocol"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/awards/f3dbae5e702846c19b22e6dec43dd0c5/documents/68e15bd59d6440b389540c080dfa1ba5
{
"data": {
"dateModified": "2017-02-01T13:22:23.284596+02:00",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/8b261ebc3f1f482eb17af126443e491e?KeyID=8f3407b6&Signature=8NIYFG%252BJDjG8zNxLixGBc9x4on7EO5WCxKAK5wMJL8xf%2FPi58uPb%2Fj07Od9%252BwvU%2FU081XfBliE8O%2F4EKVHI7DA%253D%253D",
"author": "bid_owner",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:23.284568+02:00",
"documentType": "auctionProtocol",
"title": "SignedAuctionProtocol.pdf",
"id": "68e15bd59d6440b389540c080dfa1ba5"
}
}
Організатор повинен перевірити правильність протоколу аукціону, в протилежному випадку це буде автоматично зроблено системою по закінченню verificationPeriod
PATCH /api/2.3/auctions/56c507ca68744c5f964933955043072a/awards/f3dbae5e702846c19b22e6dec43dd0c5?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 39
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "pending.payment"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending.payment",
"paymentPeriod": {
"startDate": "2017-02-01T13:22:23.408804+02:00",
"endDate": "2017-02-01T13:29:23.408804+02:00"
},
"documents": [
{
"dateModified": "2017-02-01T13:22:23.284596+02:00",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/8b261ebc3f1f482eb17af126443e491e?KeyID=8f3407b6&Signature=8NIYFG%252BJDjG8zNxLixGBc9x4on7EO5WCxKAK5wMJL8xf%2FPi58uPb%2Fj07Od9%252BwvU%2FU081XfBliE8O%2F4EKVHI7DA%253D%253D",
"author": "bid_owner",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:23.284568+02:00",
"documentType": "auctionProtocol",
"title": "SignedAuctionProtocol.pdf",
"id": "68e15bd59d6440b389540c080dfa1ba5"
}
],
"verificationPeriod": {
"startDate": "2017-02-01T13:22:22.921644+02:00",
"endDate": "2017-02-01T13:22:23.408804+02:00"
},
"complaintPeriod": {
"startDate": "2017-02-01T13:22:22.921644+02:00"
},
"suppliers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"bid_id": "6c8100e4637f46a1b09e66a9ab06862d",
"value": {
"currency": "UAH",
"amount": 501.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:23.419729+02:00",
"id": "f3dbae5e702846c19b22e6dec43dd0c5"
}
}
Цей кандидат протягом 10 робочих днів після того, як став кандидатом повинен надати оплату, а організатор повинен підтвердити цей платіж:
PATCH /api/2.3/auctions/56c507ca68744c5f964933955043072a/awards/f3dbae5e702846c19b22e6dec43dd0c5?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"paymentPeriod": {
"startDate": "2017-02-01T13:22:23.408804+02:00",
"endDate": "2017-02-01T13:22:23.552087+02:00"
},
"documents": [
{
"dateModified": "2017-02-01T13:22:23.284596+02:00",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/8b261ebc3f1f482eb17af126443e491e?KeyID=8f3407b6&Signature=8NIYFG%252BJDjG8zNxLixGBc9x4on7EO5WCxKAK5wMJL8xf%2FPi58uPb%2Fj07Od9%252BwvU%2FU081XfBliE8O%2F4EKVHI7DA%253D%253D",
"author": "bid_owner",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:23.284568+02:00",
"documentType": "auctionProtocol",
"title": "SignedAuctionProtocol.pdf",
"id": "68e15bd59d6440b389540c080dfa1ba5"
}
],
"verificationPeriod": {
"startDate": "2017-02-01T13:22:22.921644+02:00",
"endDate": "2017-02-01T13:22:23.408804+02:00"
},
"complaintPeriod": {
"startDate": "2017-02-01T13:22:22.921644+02:00",
"endDate": "2017-02-01T13:22:23.552087+02:00"
},
"suppliers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"signingPeriod": {
"startDate": "2017-02-01T13:22:23.552087+02:00",
"endDate": "2017-02-01T13:27:23.552087+02:00"
},
"bid_id": "6c8100e4637f46a1b09e66a9ab06862d",
"value": {
"currency": "UAH",
"amount": 501.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:23.564731+02:00",
"id": "f3dbae5e702846c19b22e6dec43dd0c5"
}
}
Дискваліфікація кандидата¶
Якщо кандидат не підписує протокол аукціону на протязі 3-х робочих днів з моменту отримання статусу кандидата, або не проводить оплату протягом 10 робочих днів з моменту набуття статусу кандидата, або не укладає договору на базі результатів виграного аукціону протягом 15 робочих днів з моменту набуття статусу кандидата, то організатор дискваліфікує першого кандидата та надає статус кандидата учаснику з наступною найбільшою ставкою (другий по списку). Організатор повинен завантажити файл, що містить причину дискваліфікації першого по списку учасника:
POST /api/2.3/auctions/ed8ca274ce4e4fa5866ee44ef7532b1a/awards/48362ddbfe824ffa8a2120c973dba606/documents?acc_token=6bfaf230f39946a189db2c4059cd06d0 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 384
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/21c823c5a0ec4697bd6a5cc3b0122d32?KeyID=bdf7219a&Signature=qV1df3BuuAD5vTWHu536aGAucATmBq4bL3fyRFbnSqVECd9nS0jkc52%2FxmX%2Bh9duebnCfIzsB7Q4N2DomnYcCA%3D%3D",
"title": "Disqualified_reason.pdf",
"hash": "md5:00000000000000000000000000000000",
"description": "Disqualification reason",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/ed8ca274ce4e4fa5866ee44ef7532b1a/awards/48362ddbfe824ffa8a2120c973dba606/documents/c79442dc5cd647038d3f533365252eee
{
"data": {
"dateModified": "2017-02-01T13:22:16.483255+02:00",
"hash": "md5:00000000000000000000000000000000",
"description": "Disqualification reason",
"author": "auction_owner",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/21c823c5a0ec4697bd6a5cc3b0122d32?KeyID=bdf7219a&Signature=LLkfr6Wttje6APz8XmHc2fdF42p2me6VnudCe%252Bgmf68TAhdhbTO2re3Ynqg9H9nOr9Y7UGSXMZ3htHSg3kdnDg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:16.483227+02:00",
"title": "Disqualified_reason.pdf",
"id": "c79442dc5cd647038d3f533365252eee"
}
}
Та дискваліфікувати кандидата:
PATCH /api/2.3/auctions/ed8ca274ce4e4fa5866ee44ef7532b1a/awards/48362ddbfe824ffa8a2120c973dba606?acc_token=6bfaf230f39946a189db2c4059cd06d0 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 146
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "unsuccessful",
"description": "Candidate didn’t sign the auction protocol in 3 business days",
"title": "Disqualified"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "unsuccessful",
"documents": [
{
"dateModified": "2017-02-01T13:22:16.343232+02:00",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/2d9c39c4461e46248f9a664396b69492?KeyID=bdf7219a&Signature=GoVcuaS%252BgNcVjKprg0I%252BKmDYFoMfIzim%2F7fNlZ%252BmFkduQtB6PrqRTlbYbOm66zZE5pDSOOjlOhc3VMC5%252Br7mBw%253D%253D",
"author": "bid_owner",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:16.343205+02:00",
"documentType": "auctionProtocol",
"title": "auction_protocol.pdf",
"id": "9713fd6de895463780be80a9ae3f431f"
},
{
"dateModified": "2017-02-01T13:22:16.483255+02:00",
"hash": "md5:00000000000000000000000000000000",
"description": "Disqualification reason",
"author": "auction_owner",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/21c823c5a0ec4697bd6a5cc3b0122d32?KeyID=bdf7219a&Signature=LLkfr6Wttje6APz8XmHc2fdF42p2me6VnudCe%252Bgmf68TAhdhbTO2re3Ynqg9H9nOr9Y7UGSXMZ3htHSg3kdnDg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:16.483227+02:00",
"title": "Disqualified_reason.pdf",
"id": "c79442dc5cd647038d3f533365252eee"
}
],
"verificationPeriod": {
"startDate": "2017-02-01T13:22:16.205551+02:00",
"endDate": "2017-02-01T13:22:16.618487+02:00"
},
"description": "Candidate didn’t sign the auction protocol in 3 business days",
"title": "Disqualified",
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"complaintPeriod": {
"startDate": "2017-02-01T13:22:15.773890+02:00",
"endDate": "2017-02-01T13:22:16.618487+02:00"
},
"bid_id": "000e593d3fee415dacd0f41d4a94a4b9",
"value": {
"currency": "UAH",
"amount": 475.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:16.630113+02:00",
"id": "48362ddbfe824ffa8a2120c973dba606"
}
}
Новий кандидат протягом 15 робочих днів після того, як став кандидатом, повинен підтвердити кваліфікацію кроками описаними вище (Кваліфікація).
Відмова очікування іншим учасником¶
Другий кандидат (учасник з другою найбільшою ставкою в аукціоні) може відмовитись очікувати дискваліфікації першого по списку кандидата:
PATCH /api/2.3/auctions/56c507ca68744c5f964933955043072a/awards/9fe9dd8be6dc47879ddbc9227d501ff4?acc_token=1c771b87f5b24056bfb40604c915d221 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "cancelled"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "cancelled",
"complaintPeriod": {
"startDate": "2017-02-01T13:22:22.921644+02:00",
"endDate": "2017-02-01T13:22:23.130365+02:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"bid_id": "8af88dae2b8744f1964b33be121adceb",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:23.139179+02:00",
"id": "9fe9dd8be6dc47879ddbc9227d501ff4"
}
}
Підписання угоди¶
Кандидат має 15 робочих днів після того, як став кандидатом, щоб укласти угоду на основі результатів електронного аукціону.
Завантаження документів щодо укладання угоди¶
Спробуємо завантажити документ пов’язаний з угодою:
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/contracts/74844048b04d486bb439a33f52ced316/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 351
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/24b7b178fa7c4e1289d352a91b4ae887?KeyID=8f3407b6&Signature=UR5MgIRS12jV7Wa%2F%2B4rzgrYQiEj099ZRTySLoQN0uYiPTDmDXcAoZDJNIyIMqp7sHNDRpgTZ1g4ModEJTAF%2FDA%3D%3D",
"title": "contract_first_document.doc",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/contracts/74844048b04d486bb439a33f52ced316/documents/4e6266504c8a4dd4919ae168a3c448ed
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/24b7b178fa7c4e1289d352a91b4ae887?KeyID=8f3407b6&Signature=YGEyKJ0MXFhzhVal0kw2kWK6zL2Y%2F3tdAFNwaC3fwKR4Gff5B1TJwyAeR3AncWmEHmTZuawhzGi9MAsMC4mADg%253D%253D",
"title": "contract_first_document.doc",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:23.908010+02:00",
"dateModified": "2017-02-01T13:22:23.908037+02:00",
"id": "4e6266504c8a4dd4919ae168a3c448ed"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ додано.
Переглянемо список завантажених документів:
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/contracts/74844048b04d486bb439a33f52ced316/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/24b7b178fa7c4e1289d352a91b4ae887?KeyID=8f3407b6&Signature=YGEyKJ0MXFhzhVal0kw2kWK6zL2Y%2F3tdAFNwaC3fwKR4Gff5B1TJwyAeR3AncWmEHmTZuawhzGi9MAsMC4mADg%253D%253D",
"title": "contract_first_document.doc",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:23.908010+02:00",
"dateModified": "2017-02-01T13:22:23.908037+02:00",
"id": "4e6266504c8a4dd4919ae168a3c448ed"
}
]
}
Тепер спробуємо додати ще один документ щодо укладанням угоди:
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/contracts/74844048b04d486bb439a33f52ced316/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf 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/492ca1a62537484f917a59164bfb40e5?KeyID=8f3407b6&Signature=LAUSLUlOyh6ht%2BP8EL2eC1wk5pA9P06AGDAjvK574Z8WajhM4CameV95MiVa07y4KrMVgl5eqFiWcdLvy%2BMsBA%3D%3D",
"title": "contract_second_document.doc",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/contracts/74844048b04d486bb439a33f52ced316/documents/19c069b1851a42bcb8176222ce5ab8ec
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/492ca1a62537484f917a59164bfb40e5?KeyID=8f3407b6&Signature=PKV7TOUzgAT%2FyyTwNmLz3W3i5%252B%2FDl9t707K9jNlG3ZvnZRl1i31WFmYlLXd0Yze6kfWs8hyNjF5wwYyEO9uGCw%253D%253D",
"title": "contract_second_document.doc",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:24.114143+02:00",
"dateModified": "2017-02-01T13:22:24.114170+02:00",
"id": "19c069b1851a42bcb8176222ce5ab8ec"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що ще один документ було додано.
Тепер переглянемо знову усі документи пов’язані із укладанням угоди:
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/contracts/74844048b04d486bb439a33f52ced316/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/24b7b178fa7c4e1289d352a91b4ae887?KeyID=8f3407b6&Signature=YGEyKJ0MXFhzhVal0kw2kWK6zL2Y%2F3tdAFNwaC3fwKR4Gff5B1TJwyAeR3AncWmEHmTZuawhzGi9MAsMC4mADg%253D%253D",
"title": "contract_first_document.doc",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:23.908010+02:00",
"dateModified": "2017-02-01T13:22:23.908037+02:00",
"id": "4e6266504c8a4dd4919ae168a3c448ed"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/492ca1a62537484f917a59164bfb40e5?KeyID=8f3407b6&Signature=PKV7TOUzgAT%2FyyTwNmLz3W3i5%252B%2FDl9t707K9jNlG3ZvnZRl1i31WFmYlLXd0Yze6kfWs8hyNjF5wwYyEO9uGCw%253D%253D",
"title": "contract_second_document.doc",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:24.114143+02:00",
"dateModified": "2017-02-01T13:22:24.114170+02:00",
"id": "19c069b1851a42bcb8176222ce5ab8ec"
}
]
}
Реєстрація угоди¶
Є можливість встановити дату підписання договору. Якщо дата не встановлена, то вона буде згенерована під час реєстрації угоди. Ви можете зареєструвати угоду:
PATCH /api/2.3/auctions/56c507ca68744c5f964933955043072a/contracts/74844048b04d486bb439a33f52ced316?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 80
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "active",
"dateSigned": "2017-02-01T13:22:24.262464+02:00"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/24b7b178fa7c4e1289d352a91b4ae887?KeyID=8f3407b6&Signature=YGEyKJ0MXFhzhVal0kw2kWK6zL2Y%2F3tdAFNwaC3fwKR4Gff5B1TJwyAeR3AncWmEHmTZuawhzGi9MAsMC4mADg%253D%253D",
"title": "contract_first_document.doc",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:23.908010+02:00",
"dateModified": "2017-02-01T13:22:23.908037+02:00",
"id": "4e6266504c8a4dd4919ae168a3c448ed"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/492ca1a62537484f917a59164bfb40e5?KeyID=8f3407b6&Signature=PKV7TOUzgAT%2FyyTwNmLz3W3i5%252B%2FDl9t707K9jNlG3ZvnZRl1i31WFmYlLXd0Yze6kfWs8hyNjF5wwYyEO9uGCw%253D%253D",
"title": "contract_second_document.doc",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:24.114143+02:00",
"dateModified": "2017-02-01T13:22:24.114170+02:00",
"id": "19c069b1851a42bcb8176222ce5ab8ec"
}
],
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "04114000-0"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"schema_properties": {
"code": "041",
"version": "001",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"id": "fde9635b26524ed3b0265e1e00842537",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"suppliers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"period": {
"startDate": "2017-02-01T13:22:08.972077+02:00",
"endDate": "2018-02-01T13:22:08.972077+02:00"
},
"value": {
"currency": "UAH",
"amount": 501.0,
"valueAddedTaxIncluded": true
},
"dateSigned": "2017-02-01T13:22:24.262464+02:00",
"date": "2017-02-01T13:22:24.351661+02:00",
"awardID": "f3dbae5e702846c19b22e6dec43dd0c5",
"id": "74844048b04d486bb439a33f52ced316",
"contractID": "UA-EA-2017-02-01-000001-1"
}
}
Скасування закупівлі¶
Організатор може скасувати аукціон у будь-який момент (крім аукціонів у кінцевому стані, наприклад, usuccesfull, canceled, complete).
Для цього потрібно виконати наступні кроки:
Приготуйте запит на скасування.
Наповніть його протоколом про причини скасування.
Скасуйте закупівлю через подані причини
Запит на скасування, який не пройшов активації (3-й крок), не матиме сили, тобто, для скасування закупівлі буде обов’язковим не тільки створити заявку, але і активувати її.
Див. структуру запиту Cancellation для більш детальної інформації.
Формування запиту на скасування¶
Ви повинні передати змінні reason, status у стані pending. id генерується автоматично і повертається у додатковому заголовку відповіді Location:
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/cancellations?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"reason": "cancellation reason"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/cancellations/769c51f88c934e6eadc6085428a997ee
{
"data": {
"date": "2017-02-01T13:22:24.571218+02:00",
"status": "pending",
"reason": "cancellation reason",
"cancellationOf": "tender",
"id": "769c51f88c934e6eadc6085428a997ee"
}
}
Наповнення протоколом та іншою супровідною документацією¶
Завантаження вмісту файлу:
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/cancellations/769c51f88c934e6eadc6085428a997ee/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf 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/410a39e7889c4d4c9e33424a88bcb798?KeyID=8f3407b6&Signature=CxeRUp9cQ8%2Buc23d06frn4ph8BNN7vupAPvakcpGbqlmY%2F78miVzL20Or2uLmd066%2BcCbcKQhBhCM6hANpuXDA%3D%3D",
"title": "Notice.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/cancellations/769c51f88c934e6eadc6085428a997ee/documents/bee06398225f48f58539f70d1a8f5500
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/410a39e7889c4d4c9e33424a88bcb798?KeyID=8f3407b6&Signature=APBY0%2FPcMXN6NCxobhMXkHzB00X1f5zZWNw65nx86nJqoQD1jZuEV1yD%2FY%2FgXZEoLwM9hrEcxTvg9%2FYz1Q4uBA%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:24.723823+02:00",
"dateModified": "2017-02-01T13:22:24.723848+02:00",
"id": "bee06398225f48f58539f70d1a8f5500"
}
}
Зміна опису документа та інших властивостей:
PATCH /api/2.3/auctions/56c507ca68744c5f964933955043072a/cancellations/769c51f88c934e6eadc6085428a997ee/documents/bee06398225f48f58539f70d1a8f5500?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 48
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"description": "Changed description"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"description": "Changed description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/410a39e7889c4d4c9e33424a88bcb798?KeyID=8f3407b6&Signature=APBY0%2FPcMXN6NCxobhMXkHzB00X1f5zZWNw65nx86nJqoQD1jZuEV1yD%2FY%2FgXZEoLwM9hrEcxTvg9%2FYz1Q4uBA%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:24.723823+02:00",
"dateModified": "2017-02-01T13:22:24.723848+02:00",
"id": "bee06398225f48f58539f70d1a8f5500"
}
}
Завантаження нової версії документа:
PUT /api/2.3/auctions/56c507ca68744c5f964933955043072a/cancellations/769c51f88c934e6eadc6085428a997ee/documents/bee06398225f48f58539f70d1a8f5500?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf 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/a9dbb50f3a0a46bd87c4270c790a5f0c?KeyID=8f3407b6&Signature=CJ%2BPLq8EkgPAuxA6YTrBUY3xTxJbgNZlZ3ETba0LKhnIIWLZ%2FG78xnBj1J2tXACieajOgZL669aIJI5m2sHVCg%3D%3D",
"title": "Notice-2.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"description": "Changed description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/a9dbb50f3a0a46bd87c4270c790a5f0c?KeyID=8f3407b6&Signature=AblWlPtdKmPP1t%2FwUcD9jUhtJz1aH97CcQEY5nccpPS1XP8RyN3Iz%2FzqLl56pRTcwXHI5SZxF1BxvExnJibGDQ%253D%253D",
"title": "Notice-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:24.723823+02:00",
"dateModified": "2017-02-01T13:22:25.042479+02:00",
"id": "bee06398225f48f58539f70d1a8f5500"
}
}
Активація запиту та скасування аукціону¶
PATCH /api/2.3/auctions/56c507ca68744c5f964933955043072a/cancellations/769c51f88c934e6eadc6085428a997ee?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"description": "Changed description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/410a39e7889c4d4c9e33424a88bcb798?KeyID=8f3407b6&Signature=APBY0%2FPcMXN6NCxobhMXkHzB00X1f5zZWNw65nx86nJqoQD1jZuEV1yD%2FY%2FgXZEoLwM9hrEcxTvg9%2FYz1Q4uBA%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:24.723823+02:00",
"dateModified": "2017-02-01T13:22:24.723848+02:00",
"id": "bee06398225f48f58539f70d1a8f5500"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "Changed description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/a9dbb50f3a0a46bd87c4270c790a5f0c?KeyID=8f3407b6&Signature=AblWlPtdKmPP1t%2FwUcD9jUhtJz1aH97CcQEY5nccpPS1XP8RyN3Iz%2FzqLl56pRTcwXHI5SZxF1BxvExnJibGDQ%253D%253D",
"title": "Notice-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:24.723823+02:00",
"dateModified": "2017-02-01T13:22:25.042479+02:00",
"id": "bee06398225f48f58539f70d1a8f5500"
}
],
"reason": "cancellation reason",
"date": "2017-02-01T13:22:25.212899+02:00",
"cancellationOf": "tender",
"id": "769c51f88c934e6eadc6085428a997ee"
}
}
Фін. туторіал¶
Туторіал для процедури dgfFinancialAssets - продаж права вимоги за кредитними договорами.
Створення аукціону¶
Створимо аукціон з мінімально допустимим (обовязковим для заповнення) набором даних:
POST /api/2.3/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2153
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"auctionPeriod": {
"startDate": "2017-02-15"
},
"tenderAttempts": 1,
"procurementMethodType": "dgfFinancialAssets",
"value": {
"currency": "UAH",
"amount": 100
},
"dgfDecisionDate": "2016-11-17",
"dgfID": "219560",
"dgfDecisionID": "219560",
"procurementMethodDetails": "quick, accelerator=1440",
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"id": "04114000-0",
"description": "Земельні ділянки"
},
"address": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"schema_properties": {
"code": "04114000-0",
"version": "latest",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
}
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311
{
"access": {
"token": "f55e1d84bebf44d899324ea2db4fc671"
},
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2017-02-01-000001",
"enquiryPeriod": {
"startDate": "2017-02-01T13:22:17.671396+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"submissionMethod": "electronicAuction",
"dgfDecisionDate": "2016-11-17",
"next_check": "2017-02-14T23:59:50+02:00",
"awardCriteria": "highestCost",
"dgfDecisionID": "219560",
"owner": "broker",
"id": "7c4b1c5e9c624bffa4feb0d69248e311",
"eligibilityCriteria_ru": "К участию допускаются только лицензированные финансовые учреждения.",
"documents": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.671887+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:17.671930+02:00",
"id": "e62b5688a9a0478191b1eb8dad288ed7"
}
],
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"eligibilityCriteria_en": "Only licensed financial institutions are eligible to participate.",
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2017-02-01T13:22:17.678754+02:00",
"status": "active.tendering",
"eligibilityCriteria": "До участі допускаються лише ліцензовані фінансові установи.",
"tenderPeriod": {
"startDate": "2017-02-01T13:22:17.671396+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"auctionPeriod": {
"shouldStartAfter": "2017-02-15T00:00:00+02:00"
},
"procurementMethodType": "dgfFinancialAssets",
"dgfID": "219560",
"date": "2017-02-01T13:22:17.671396+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "04114000-0"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"schema_properties": {
"code": "041",
"version": "001",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"id": "2f21a2129dd14629984fca9013b16424",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.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.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2017-02-01-000001",
"enquiryPeriod": {
"startDate": "2017-02-01T13:22:17.671396+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"submissionMethod": "electronicAuction",
"dgfDecisionDate": "2016-11-17",
"next_check": "2017-02-14T23:59:50+02:00",
"awardCriteria": "highestCost",
"dgfDecisionID": "219560",
"owner": "broker",
"id": "7c4b1c5e9c624bffa4feb0d69248e311",
"eligibilityCriteria_ru": "К участию допускаются только лицензированные финансовые учреждения.",
"documents": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.671887+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:17.671930+02:00",
"id": "e62b5688a9a0478191b1eb8dad288ed7"
}
],
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"eligibilityCriteria_en": "Only licensed financial institutions are eligible to participate.",
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2017-02-01T13:22:17.678754+02:00",
"status": "active.tendering",
"eligibilityCriteria": "До участі допускаються лише ліцензовані фінансові установи.",
"tenderPeriod": {
"startDate": "2017-02-01T13:22:17.671396+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"auctionPeriod": {
"shouldStartAfter": "2017-02-15T00:00:00+02:00"
},
"procurementMethodType": "dgfFinancialAssets",
"dgfID": "219560",
"date": "2017-02-01T13:22:17.671396+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "04114000-0"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"schema_properties": {
"code": "041",
"version": "001",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"id": "2f21a2129dd14629984fca9013b16424",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.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.3/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"next_page": {
"path": "/api/2.3/auctions?offset=2017-02-01T13%3A22%3A17.678754%2B02%3A00",
"uri": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions?offset=2017-02-01T13%3A22%3A17.678754%2B02%3A00",
"offset": "2017-02-01T13:22:17.678754+02:00"
},
"data": [
{
"id": "7c4b1c5e9c624bffa4feb0d69248e311",
"dateModified": "2017-02-01T13:22:17.678754+02:00"
}
]
}
Ми бачимо внутрішнє id аукціону (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/auctions/) та його dateModified дату.
Завантаження документації¶
Замовник може завантажити PDF файл у створений аукціон. Завантаження повинно відбуватись згідно правил Завантаження документа.
POST /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/documents?acc_token=f55e1d84bebf44d899324ea2db4fc671 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/168e34b56cb646ee8450e9cdbb5cb84d?KeyID=0678eb99&Signature=vVuRrETPye43761R9aH3d292RkpPVoksqyKtCriafJqN%2BdxSJt5vPLhN8QvK15iFQRwtyMPakI8eAisG28HNBQ%3D%3D",
"format": "application/pdf",
"documentType": "technicalSpecifications"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/documents/7697dfe7bbb142dda6ce306d70e75a9b
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"description": "technical specification",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/168e34b56cb646ee8450e9cdbb5cb84d?KeyID=0678eb99&Signature=lI8kxzS7AsjFS5O2fO0gdQshCcNwUxgrWmSwD7Csyak%2Fr44YOJGgrfTwPvDJdpEhNQM8JBFJTDLcIQ%2FmIvFWCA%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.868599+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:17.868627+02:00",
"id": "7697dfe7bbb142dda6ce306d70e75a9b"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
GET /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/documents/7697dfe7bbb142dda6ce306d70e75a9b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"description": "technical specification",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/168e34b56cb646ee8450e9cdbb5cb84d?KeyID=0678eb99&Signature=lI8kxzS7AsjFS5O2fO0gdQshCcNwUxgrWmSwD7Csyak%2Fr44YOJGgrfTwPvDJdpEhNQM8JBFJTDLcIQ%2FmIvFWCA%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.868599+02:00",
"previousVersions": [],
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:17.868627+02:00",
"id": "7697dfe7bbb142dda6ce306d70e75a9b"
}
}
Один елемент масиву описує завантажений документ. Ми можемо завантажити більше документів:
POST /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/documents?acc_token=f55e1d84bebf44d899324ea2db4fc671 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/009c7d69a186420a9fa8f1962b57caab?KeyID=0678eb99&Signature=dy7J4hyQCb7FoACWexnKBPSnEpUgUHzuv2WbPjs75s1JBo7W61IyXNeN4tYvk2SStRFexpxvoLIA7S8%2Fq6cQAA%3D%3D",
"title": "AwardCriteria.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/documents/3319fcecf8fd4ea28ad6c13841d54844
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/009c7d69a186420a9fa8f1962b57caab?KeyID=0678eb99&Signature=l3l%252BSorSU9fYTnJKMLNLhxmk5Tav7WB9w%252BKo1YcBBOvEe1cnla6I%2F3jWJvKhF4b%2FEtLcyP9k4QUzL9mIzyU6Dw%253D%253D",
"title": "AwardCriteria.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.960618+02:00",
"dateModified": "2017-02-01T13:22:17.960672+02:00",
"id": "3319fcecf8fd4ea28ad6c13841d54844"
}
}
І знову можна перевірити, що є два завантажених документа.
GET /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.671887+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:17.671930+02:00",
"id": "e62b5688a9a0478191b1eb8dad288ed7"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "technical specification",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/168e34b56cb646ee8450e9cdbb5cb84d?KeyID=0678eb99&Signature=lI8kxzS7AsjFS5O2fO0gdQshCcNwUxgrWmSwD7Csyak%2Fr44YOJGgrfTwPvDJdpEhNQM8JBFJTDLcIQ%2FmIvFWCA%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.868599+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:17.868627+02:00",
"id": "7697dfe7bbb142dda6ce306d70e75a9b"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/009c7d69a186420a9fa8f1962b57caab?KeyID=0678eb99&Signature=l3l%252BSorSU9fYTnJKMLNLhxmk5Tav7WB9w%252BKo1YcBBOvEe1cnla6I%2F3jWJvKhF4b%2FEtLcyP9k4QUzL9mIzyU6Dw%253D%253D",
"title": "AwardCriteria.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.960618+02:00",
"dateModified": "2017-02-01T13:22:17.960672+02:00",
"id": "3319fcecf8fd4ea28ad6c13841d54844"
}
]
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
PUT /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/documents/3319fcecf8fd4ea28ad6c13841d54844?acc_token=f55e1d84bebf44d899324ea2db4fc671 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/34db0d062e654d9fa8a09a5799297509?KeyID=0678eb99&Signature=8NCrfYqEL%2FF1nzEWh6%2Bs0Rvx2FeZ0VZ6mQWpUIOJpfuCpO3EtkfQOSSvBZLLUuc2uptvKYoqoeTCjL0QxAbsBQ%3D%3D",
"title": "AwardCriteria-2.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/34db0d062e654d9fa8a09a5799297509?KeyID=0678eb99&Signature=XVVJU7VMAmqUketT67dq5O1cAWPWELe%252BvLaiCWX7psdiDCanYyfWlUt1e9sKmsR5FNmV5wzQCu5B1QNErDPnAA%253D%253D",
"title": "AwardCriteria-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.960618+02:00",
"dateModified": "2017-02-01T13:22:18.037356+02:00",
"id": "3319fcecf8fd4ea28ad6c13841d54844"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
GET /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.671887+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:17.671930+02:00",
"id": "e62b5688a9a0478191b1eb8dad288ed7"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "technical specification",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/168e34b56cb646ee8450e9cdbb5cb84d?KeyID=0678eb99&Signature=lI8kxzS7AsjFS5O2fO0gdQshCcNwUxgrWmSwD7Csyak%2Fr44YOJGgrfTwPvDJdpEhNQM8JBFJTDLcIQ%2FmIvFWCA%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.868599+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:17.868627+02:00",
"id": "7697dfe7bbb142dda6ce306d70e75a9b"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/34db0d062e654d9fa8a09a5799297509?KeyID=0678eb99&Signature=XVVJU7VMAmqUketT67dq5O1cAWPWELe%252BvLaiCWX7psdiDCanYyfWlUt1e9sKmsR5FNmV5wzQCu5B1QNErDPnAA%253D%253D",
"title": "AwardCriteria-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:17.960618+02:00",
"dateModified": "2017-02-01T13:22:18.037356+02:00",
"id": "3319fcecf8fd4ea28ad6c13841d54844"
}
]
}
Завантаження ілюстрації¶
Організатор може завантажити файли з ілюстраціями у створений аукціон. Завантаження повинно відповідати правилам Завантаження документа.
Для того, щоб вказати порядок відображення ілюстрацій, використовується поле index (див. Document). Оскільки ця ілюстрація повинна бути відображена першою, то вказується "index": 1
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 430
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/706d73b92a65446199d1d0573963d601?KeyID=8f3407b6&Signature=KjHBSwz4JyFIRkvYmubAy0GZI2SHGsP1OtuXs56fmgnxov1RMk6Fxtj0LQzl1VpF8lg%2BzN5N%2FW8ypFmnr4QwDg%3D%3D",
"format": "image/jpeg",
"documentType": "illustration"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/e7803c183b6e4ec9a45529d5b5896b21
{
"data": {
"index": 1,
"hash": "md5:00000000000000000000000000000000",
"description": "First illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/706d73b92a65446199d1d0573963d601?KeyID=8f3407b6&Signature=AUG0Ux1M3qgW8e1mtYzVaHy55h1MSBWrP9V%2Fy9SbMmwnzRYTSU3f0FP%2FuW%2FmGCpZhDj4zfyx6Dh6bfp8ByQcAw%253D%253D",
"title": "first_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.233533+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.233582+02:00",
"id": "e7803c183b6e4ec9a45529d5b5896b21"
}
}
Ми можемо перевірити, чи завантажилась ілюстрація.
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:19.999323+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:19.999372+02:00",
"id": "3136ee8064c24ef4ab8555d430927ebd"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.587044+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:20.587093+02:00",
"id": "d24959c19c6544039ba215721fc188d7"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/72309f80c9c34b5bb4333834f1512188?KeyID=8f3407b6&Signature=g4SOcSX5%252BTz3HyoRG6Wanx2r2rYAQTBVH3WV8YJjY13WWQXIc%252BEHHuehiaCWFFq5TXCcpdcRdKvNzYwsHr4hDQ%253D%253D",
"title": "AwardCriteria-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.734187+02:00",
"dateModified": "2017-02-01T13:22:21.110477+02:00",
"id": "91240c87090242658d9158df422f0656"
},
{
"index": 1,
"hash": "md5:00000000000000000000000000000000",
"description": "First illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/706d73b92a65446199d1d0573963d601?KeyID=8f3407b6&Signature=AUG0Ux1M3qgW8e1mtYzVaHy55h1MSBWrP9V%2Fy9SbMmwnzRYTSU3f0FP%2FuW%2FmGCpZhDj4zfyx6Dh6bfp8ByQcAw%253D%253D",
"title": "first_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.233533+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.233582+02:00",
"id": "e7803c183b6e4ec9a45529d5b5896b21"
}
]
}
Організатор може завантажити ще одну ілюстрацію. Ця ілюстрація повинна бути відображена другою, тому має параметр "index": 2.
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 430
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Second illustration description",
"title": "second_illustration.jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/a5a96dd0cc6242f684a5ae7536838594?KeyID=8f3407b6&Signature=8%2FlcbzDABnNmIT0CyyXIuS73OLSsXSQym9Wg4IZxNDxnPtAVTGkBOAGn2AEwL4t0ZIwPMc2PUCpCwU7mwvPjDA%3D%3D",
"format": "image/jpeg",
"documentType": "illustration"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/b954ae21ee9e422da03d1b3511c619e5
{
"data": {
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Second illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/a5a96dd0cc6242f684a5ae7536838594?KeyID=8f3407b6&Signature=P66c7p7scu1I%2FrwS54p1o4TERQ%252BMhQOvWsegllG9S6OYkqh3oZI9CuRKHKETsG8pnh6xB9jP3QpfCHA0ihuYAA%253D%253D",
"title": "second_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.382379+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.382428+02:00",
"id": "b954ae21ee9e422da03d1b3511c619e5"
}
}
Додаємо третю ілюстрацію:
POST /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents?acc_token=2ac7aaf0d5b2429e9024f281f75c0eaf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 432
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Third illustration description",
"title": "third_illustration.jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/113b840ceb314f7e9755898dd04ca7a8?KeyID=8f3407b6&Signature=EkAj%2BeR6uirMFKEjwyYNB55CezxVgv3PdAgq4JGybaCKTkAFrPM5C%2BawGW3XMFEC9eByl4BBLcyYf6h8%2BVUEBQ%3D%3D",
"format": "image/jpeg",
"documentType": "illustration"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/56c507ca68744c5f964933955043072a/documents/b7aeede0898a4fe294c15f145a7c0dac
{
"data": {
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Third illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/113b840ceb314f7e9755898dd04ca7a8?KeyID=8f3407b6&Signature=BBEUcPxmB3wdQoG4I9xkkTXI7d2n8A5B7KjWzgD%2FG9CliAd%252BaL8Mf6TnQGOFJUBYGRDTHJuhSxoI%252BRWl0Qw%252BBQ%253D%253D",
"title": "third_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.485198+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.485248+02:00",
"id": "b7aeede0898a4fe294c15f145a7c0dac"
}
}
Зверніть увагу, що параметр index третьої ілюстрації такий же як і у другої: "index": 2. У таких випадках спочатку відображатиметься ілюстрація з ранішою датою публікації.
Можемо перевірити, що є три завантажені ілюстрації.
GET /api/2.3/auctions/56c507ca68744c5f964933955043072a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:19.999323+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:19.999372+02:00",
"id": "3136ee8064c24ef4ab8555d430927ebd"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4f48d70db344310bf2a407d6f6dea95?KeyID=8f3407b6&Signature=xCrpwggqDZU87cDDCGMXMrX2rqIp3XcKD5%2FWi0t01noV%2FaZhV1xeZmzjAzlrLy5SQPcc%252BWv4sI9gN664KXnQBw%253D%253D",
"title": "Notice.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.587044+02:00",
"documentType": "technicalSpecifications",
"dateModified": "2017-02-01T13:22:20.587093+02:00",
"id": "d24959c19c6544039ba215721fc188d7"
},
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/72309f80c9c34b5bb4333834f1512188?KeyID=8f3407b6&Signature=g4SOcSX5%252BTz3HyoRG6Wanx2r2rYAQTBVH3WV8YJjY13WWQXIc%252BEHHuehiaCWFFq5TXCcpdcRdKvNzYwsHr4hDQ%253D%253D",
"title": "AwardCriteria-2.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:20.734187+02:00",
"dateModified": "2017-02-01T13:22:21.110477+02:00",
"id": "91240c87090242658d9158df422f0656"
},
{
"index": 1,
"hash": "md5:00000000000000000000000000000000",
"description": "First illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/706d73b92a65446199d1d0573963d601?KeyID=8f3407b6&Signature=AUG0Ux1M3qgW8e1mtYzVaHy55h1MSBWrP9V%2Fy9SbMmwnzRYTSU3f0FP%2FuW%2FmGCpZhDj4zfyx6Dh6bfp8ByQcAw%253D%253D",
"title": "first_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.233533+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.233582+02:00",
"id": "e7803c183b6e4ec9a45529d5b5896b21"
},
{
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Second illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/a5a96dd0cc6242f684a5ae7536838594?KeyID=8f3407b6&Signature=P66c7p7scu1I%2FrwS54p1o4TERQ%252BMhQOvWsegllG9S6OYkqh3oZI9CuRKHKETsG8pnh6xB9jP3QpfCHA0ihuYAA%253D%253D",
"title": "second_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.382379+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.382428+02:00",
"id": "b954ae21ee9e422da03d1b3511c619e5"
},
{
"index": 2,
"hash": "md5:00000000000000000000000000000000",
"description": "Third illustration description",
"format": "image/jpeg",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/113b840ceb314f7e9755898dd04ca7a8?KeyID=8f3407b6&Signature=BBEUcPxmB3wdQoG4I9xkkTXI7d2n8A5B7KjWzgD%2FG9CliAd%252BaL8Mf6TnQGOFJUBYGRDTHJuhSxoI%252BRWl0Qw%252BBQ%253D%253D",
"title": "third_illustration.jpeg",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:21.485198+02:00",
"documentType": "illustration",
"dateModified": "2017-02-01T13:22:21.485248+02:00",
"id": "b7aeede0898a4fe294c15f145a7c0dac"
}
]
}
Додавання віртуальної кімнати для роботи з конфіденційними даними¶
Організатор може додати URL-адресу віртуальної кімнати для роботи з конфіденційними даними:
POST /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/documents?acc_token=f55e1d84bebf44d899324ea2db4fc671 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 127
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"url": "http://virtial-data-room.com/id_of_room",
"title": "VDR for auction lot",
"documentType": "virtualDataRoom"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/documents/ff638211c2684fb8a5559ba9526f1436
{
"data": {
"title": "VDR for auction lot",
"url": "http://virtial-data-room.com/id_of_room",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:18.201012+02:00",
"documentType": "virtualDataRoom",
"dateModified": "2017-02-01T13:22:18.201059+02:00",
"id": "ff638211c2684fb8a5559ba9526f1436"
}
}
Реєстрація пропозиції¶
Учасник може зареєструвати пропозицію у статусі draft (чернетка). Учасник повинен вказати значення UA-FIN для параметра additionalIdentifiers.
POST /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1004
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"qualified": true,
"tenderers": [
{
"additionalIdentifiers": [
{
"scheme": "UA-FIN",
"id": "А01 457213"
}
],
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
}
],
"value": {
"currency": "UAH",
"amount": 469,
"valueAddedTaxIncluded": true
},
"eligible": true
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/bids/b331976164ee46689810aef6cdbe0adb
{
"access": {
"token": "e420d635d98a4b3dbef4334200c4ac2a"
},
"data": {
"status": "active",
"eligible": true,
"value": {
"currency": "UAH",
"amount": 469.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:18.306627+02:00",
"qualified": true,
"tenderers": [
{
"additionalIdentifiers": [
{
"scheme": "UA-FIN",
"id": "А01 457213"
}
],
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"owner": "broker",
"id": "b331976164ee46689810aef6cdbe0adb"
}
}
І активувати пропозицію:
PATCH /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/bids/b331976164ee46689810aef6cdbe0adb?acc_token=e420d635d98a4b3dbef4334200c4ac2a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
null
І завантажити ліцензію (вказавши documentType: financialLicense):
POST /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/bids/b331976164ee46689810aef6cdbe0adb/documents?acc_token=e420d635d98a4b3dbef4334200c4ac2a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 377
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/e8f72cbf21d84123a1d236ea60dcc72c?KeyID=0678eb99&Signature=Cixr144BgRI23%2B7%2F5H5euNQromUKsKPmaMlqnCMRTvpCfb1EfpdfbsjINE%2F8k0bw4TzHOWMOh0AX3PnIyqzhBA%3D%3D",
"title": "FinancialLicense.pdf",
"format": "application/pdf",
"hash": "md5:00000000000000000000000000000000",
"documentType": "financialLicense"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/bids/b331976164ee46689810aef6cdbe0adb/documents/5dd7b270cd8c4f51b9a016ea6b6528d8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/bids/b331976164ee46689810aef6cdbe0adb/documents/5dd7b270cd8c4f51b9a016ea6b6528d8?download=e8f72cbf21d84123a1d236ea60dcc72c",
"title": "FinancialLicense.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:18.501453+02:00",
"documentType": "financialLicense",
"dateModified": "2017-02-01T13:22:18.501509+02:00",
"id": "5dd7b270cd8c4f51b9a016ea6b6528d8"
}
}
Можна перевірити завантажені документи:
GET /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/bids/b331976164ee46689810aef6cdbe0adb/documents?acc_token=e420d635d98a4b3dbef4334200c4ac2a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/bids/b331976164ee46689810aef6cdbe0adb/documents/5dd7b270cd8c4f51b9a016ea6b6528d8?download=e8f72cbf21d84123a1d236ea60dcc72c",
"title": "FinancialLicense.pdf",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:18.501453+02:00",
"documentType": "financialLicense",
"dateModified": "2017-02-01T13:22:18.501509+02:00",
"id": "5dd7b270cd8c4f51b9a016ea6b6528d8"
}
]
}
Для найкращого результату (найбільшої економії) аукціон повинен мати багато зареєстрованих учасників.
POST /api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1004
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"qualified": true,
"tenderers": [
{
"additionalIdentifiers": [
{
"scheme": "UA-FIN",
"id": "А01 457213"
}
],
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
}
],
"value": {
"currency": "UAH",
"amount": 479,
"valueAddedTaxIncluded": true
},
"eligible": true
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/7c4b1c5e9c624bffa4feb0d69248e311/bids/d5c5d779f21f481a977e9a93b0671d2e
{
"access": {
"token": "ddf921471f8a485e8db4feeb94393158"
},
"data": {
"status": "active",
"eligible": true,
"value": {
"currency": "UAH",
"amount": 479.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-01T13:22:18.671130+02:00",
"qualified": true,
"tenderers": [
{
"additionalIdentifiers": [
{
"scheme": "UA-FIN",
"id": "А01 457213"
}
],
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"owner": "broker",
"id": "d5c5d779f21f481a977e9a93b0671d2e"
}
}
Двофазний коміт¶
Створення закупівлі за допомогою двофазного коміта¶
Створимо аукціон у статусі draft:
POST /api/2.3/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2168
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "draft",
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"auctionPeriod": {
"startDate": "2017-02-15"
},
"tenderAttempts": 1,
"procurementMethodType": "dgfOtherAssets",
"value": {
"currency": "UAH",
"amount": 100
},
"dgfDecisionDate": "2016-11-17",
"dgfID": "219560",
"dgfDecisionID": "219560",
"procurementMethodDetails": "quick, accelerator=1440",
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"id": "04114000-0",
"description": "Земельні ділянки"
},
"address": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"schema_properties": {
"code": "04114000-0",
"version": "latest",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
}
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/f7be6c0b987146118d6505733a3e438c
{
"access": {
"token": "ee2b8301dccc492b93769179dbcbcd37"
},
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2017-02-01-000001",
"enquiryPeriod": {
"startDate": "2017-02-01T13:22:11.463782+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"submissionMethod": "electronicAuction",
"dgfDecisionDate": "2016-11-17",
"awardCriteria": "highestCost",
"dgfDecisionID": "219560",
"owner": "broker",
"id": "f7be6c0b987146118d6505733a3e438c",
"documents": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:11.464263+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:11.464309+02:00",
"id": "db319013c1844deeb18e076568c6ba37"
}
],
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"dateModified": "2017-02-01T13:22:11.476680+02:00",
"status": "draft",
"tenderPeriod": {
"startDate": "2017-02-01T13:22:11.463782+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"procurementMethodDetails": "quick, accelerator=1440",
"procurementMethodType": "dgfOtherAssets",
"dgfID": "219560",
"date": "2017-02-01T13:22:11.463782+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "04114000-0"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"schema_properties": {
"code": "041",
"version": "001",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"id": "5c656e483fa043e7b16a1f53d6ce7941",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.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.3/auctions/f7be6c0b987146118d6505733a3e438c?acc_token=ee2b8301dccc492b93769179dbcbcd37 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 40
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "active.tendering"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2017-02-01-000001",
"enquiryPeriod": {
"startDate": "2017-02-01T13:22:11.463782+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"submissionMethod": "electronicAuction",
"dgfDecisionDate": "2016-11-17",
"next_check": "2017-02-14T23:59:50+02:00",
"awardCriteria": "highestCost",
"dgfDecisionID": "219560",
"owner": "broker",
"id": "f7be6c0b987146118d6505733a3e438c",
"documents": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:11.464263+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:11.464309+02:00",
"id": "db319013c1844deeb18e076568c6ba37"
}
],
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2017-02-01T13:22:11.611343+02:00",
"status": "active.tendering",
"tenderPeriod": {
"startDate": "2017-02-01T13:22:11.463782+02:00",
"endDate": "2017-02-14T23:59:50+02:00"
},
"auctionPeriod": {
"shouldStartAfter": "2017-02-15T00:00:00+02:00"
},
"procurementMethodType": "dgfOtherAssets",
"dgfID": "219560",
"date": "2017-02-01T13:22:11.611343+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "04114000-0"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"schema_properties": {
"code": "041",
"version": "001",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"id": "5c656e483fa043e7b16a1f53d6ce7941",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.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.3/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2217
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"auctionPeriod": {
"startDate": "2017-02-01T13:27:08.972077"
},
"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": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"id": "04114000-0",
"description": "Земельні ділянки"
},
"address": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"schema_properties": {
"code": "04114000-0",
"version": "latest",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"dgfID": "219560"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/8e134cdc759c442ca83739b1e3791687
{
"access": {
"token": "0c42fdce54904a138f58dc8ade8e6fc8"
},
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2017-02-01-000001",
"enquiryPeriod": {
"startDate": "2017-02-01T13:22:13.142630+02:00",
"endDate": "2017-02-01T13:26:25.340846+02:00"
},
"submissionMethod": "electronicAuction",
"dgfDecisionDate": "2016-11-17",
"next_check": "2017-02-01T13:26:25.340846+02:00",
"awardCriteria": "highestCost",
"dgfDecisionID": "219560",
"owner": "broker",
"title_en": "[TESTING] ",
"id": "8e134cdc759c442ca83739b1e3791687",
"documents": [
{
"title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
"url": "http://torgi.fg.gov.ua/prozorrosale",
"documentOf": "tender",
"datePublished": "2017-02-01T13:22:13.143127+02:00",
"documentType": "x_dgfPlatformLegalDetails",
"dateModified": "2017-02-01T13:22:13.143178+02:00",
"id": "780ff2dec79a40b5aaf0e716593d51e6"
}
],
"title": "[ТЕСТУВАННЯ] футляри до державних нагород",
"tenderAttempts": 1,
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2017-02-01T13:22:13.148117+02:00",
"status": "active.tendering",
"tenderPeriod": {
"startDate": "2017-02-01T13:22:13.142630+02:00",
"endDate": "2017-02-01T13:26:25.340846+02:00"
},
"auctionPeriod": {
"shouldStartAfter": "2017-02-01T13:26:25.340846+02:00"
},
"procurementMethodType": "dgfOtherAssets",
"dgfID": "219560",
"date": "2017-02-01T13:22:13.142630+02:00",
"submissionMethodDetails": "quick",
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "04114000-0"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"schema_properties": {
"code": "041",
"version": "001",
"properties": {
"number_of_rooms": 4,
"total_area": 4
}
},
"id": "f4d475fffaf14c018586fd3ffe49fc3a",
"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": "[ТЕСТИРОВАНИЕ] ",
"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": "м. Київ"
}
}
}
}
Синхронізація¶
При звичайній синхронізації аукціонів через /auctions тестових тендерів “не видно”.
Щоб отримати тестові аукціони, треба робити синхронізацію наступним чином через /auctions?mode=test.
Якщо синхронізуватися через /auctions?mode=all, то будуть віддаватися всі аукціони.
Режим аукціону можна встановити тільки при створенні аукціона і не можна його змінити потім.