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

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

Зміст:

Огляд

Open Procurement API це єдиний інтерфейс для бази даних Open Procurement, що є основним елементом інфраструктури Open Procurement.

Open Procurement API це REST-ful інтерфейс, що надає програмний доступ до бази даних Tender системи Open Procurement. Він надає URL-адреси для доступу до ресурсів і використовує вбудовані HTTP особливості, щоб отримувати команди та повертати відповіді. Це полегшує спілкування.

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

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

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

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

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

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

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

Стан проекту

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

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

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

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

Загальну інформацію, пояснення та технічні специфікації можна знайти на сайті openprocurement.org.

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

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

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

0.10

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

Нові властивості:

0.8

Випущено: 2015-05-12

Нові властивості:

  • Період зупинки для кожної винагороди окремо

  • Додано новий механізм скасування тендера

0.7

Випущено: 2015-03-13

Нові властивості:

  • Обов’язкове встановлення назви, класифікації та additionalClassifications

  • Додана валідація для однакових cpv груп товарів

  • Дадано завантаження документів закупівлі користувачем аукціону

  • Закриття закупівлі реєстрацією угоди

  • Жорсткий режим для операцій з патчами

  • Відміна активної винагороди

Модифікації:

  • Автентифікований доступ до бази даних couchdb

  • Виправлена аутентифікація методів PUT та PATCH

  • Оптимізовано запити до БД при старті

  • Виправлені поля deliveryLocation

  • Виправлено поле редагування формату в Документах

  • Виправлені обмеження заватаження документів цінової пропозиції

0.6

Випущено: 2014-12-15

Нові властивості:

  • Авторизація токена брокера

  • Авторизація токена дійової особи

  • Додано Item.deliveryLocation

  • Блокування завершення закупівлі через невирішені скарги

  • Перенесення невдалих аукціонів

0.5

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

Нові властивості:

  • Генерація токена дійової особи

  • Додано Item.deliveryAddress

  • Логіка послідовного розгляду визначення переможця

Модифікації:

  • Tender.deliveryDate перенесено до Item.deliveryDate

0.4

Випущено: 2014-12-01

Нові властивості:

  • Подання скарги на визначення переможця

  • Додатки до скарг

  • Відміна закупівлі

  • Видимість авторів питань

Модифікації:

  • Уточнення списку статусів закупівлі

0.3

Випущено: 2014-11-21

Нові властивості:

  • Можливість задавати питання

  • Подача скарги на тендерні умови

  • Можливість відповідати на запитання

  • Публікація вирішення скарги

  • Вичитка запитань та відповідей, скарг та їх рішень

  • Планувальник аукціону

  • Контролер аукціону

Модифікації:

  • Стандарт даних налаштований відповідно до Open Contracting 1.0RC

  • точки входу /bidders/ перейменовані в /bids/

  • властивість modified перейменована в modificationDate

0.2

Випущено: 2014-11-07

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

  • Вичитка документів

  • Відстеження змін

  • Опції: Pretty-print, JSONP

  • Впровадження станів та перемикання станів з урахуванням часу

0.1

Випущено: 2014-10-24

  • Налаштування загальної збірки, тестування, розгортання та ci фреймворка.

  • Створення/модифікація закупівлі

  • Додавання/модифікація/відміна цінової пропозиції

  • Визначення переможця/дискваліфікація цінових пропозицій

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

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

Аутентифікація

Деякі запити API (особливо GET запити лише для читання) не потребують аутентифікації. Інші, ті, які модифікують дані у базі даних, потребують аутентифікації брокера через ключ API. Додатково видаються токени власника, щоб забезпечити кілька ролей дійових осіб при створенні об’єкта.

Ключі API

Ключ API - це ім’я користувача, що буде використовуватись зі схемою базової аутентифікації (див. RFC 2617#section-2).

Токени власника

Отримання токена

Токен видається, коли об’єкт створюється в базі даних:

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

{
  "data": {
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "e214fbd9ed204c9bb42f9e1f628109f8",
        "featureOf": "item"
      },
      {
        "code": "OCDS-123454-YEARS",
        "description": "Кількість років, які організація учасник працює на ринку",
        "title": "Років на ринку",
        "enum": [
          {
            "value": 0.05,
            "title": "До 3 років"
          },
          {
            "value": 0.1,
            "title": "Більше 3 років, менше 5 років"
          },
          {
            "value": 0.15,
            "title": "Більше 5 років"
          }
        ],
        "title_en": "Years trading",
        "featureOf": "tenderer"
      }
    ],
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "enquiryPeriod": {
      "endDate": "2017-08-01T17:36:49.331754"
    },
    "title_en": "Cases with state awards",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "mode": "test",
    "procurementMethodType": "belowThreshold",
    "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": "м. Київ"
      }
    },
    "title_ru": "футляры к государственным наградам",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_ru": "футляры к государственным наградам",
        "id": "e214fbd9ed204c9bb42f9e1f628109f8",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "tenderPeriod": {
      "endDate": "2017-08-08T17:36:49.331754"
    }
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e5d1cd890bd54669972755ca7e8604de

{
  "access": {
    "token": "1a6350b26a094a39adf455ee9a495f6c"
  },
  "data": {
    "procurementMethod": "open",
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "e214fbd9ed204c9bb42f9e1f628109f8",
        "featureOf": "item"
      },
      {
        "code": "OCDS-123454-YEARS",
        "description": "Кількість років, які організація учасник працює на ринку",
        "title": "Років на ринку",
        "enum": [
          {
            "value": 0.05,
            "title": "До 3 років"
          },
          {
            "value": 0.1,
            "title": "Більше 3 років, менше 5 років"
          },
          {
            "value": 0.15,
            "title": "Більше 5 років"
          }
        ],
        "title_en": "Years trading",
        "featureOf": "tenderer"
      }
    ],
    "enquiryPeriod": {
      "startDate": "2017-07-25T17:36:55.784983+03:00",
      "endDate": "2017-08-01T17:36:49.331754+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-08-01T17:36:49.331754+03:00",
    "awardCriteria": "lowestCost",
    "owner": "broker",
    "id": "e5d1cd890bd54669972755ca7e8604de",
    "title": "[ТЕСТУВАННЯ] футляри до державних нагород",
    "tenderID": "UA-2017-07-25-000002",
    "dateModified": "2017-07-25T17:36:55.787215+03:00",
    "status": "active.enquiries",
    "tenderPeriod": {
      "startDate": "2017-08-01T17:36:49.331754+03:00",
      "endDate": "2017-08-08T17:36:49.331754+03:00"
    },
    "procurementMethodType": "belowThreshold",
    "title_en": "[TESTING] Cases with state awards",
    "date": "2017-07-25T17:36:55.785011+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_ru": "футляры к государственным наградам",
        "id": "e214fbd9ed204c9bb42f9e1f628109f8",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.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": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

У відповіді є access разом з token. Це значення можна використати для модифікації об’єктів у “ролі Власника”.

Використання токена

Ви можете передати токен доступу такими способами:

  1. параметр рядка URL запиту acc_token

  2. заголовок HTTP запиту X-Access-Token

  3. access.token в тілі запитів POST/PUT/PATCH

Ось приклад, де токен передається як рядок URL запиту:

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "tenderPeriod": {
      "endDate": "2017-08-09T17:37:05.888957+03:00"
    }
  }
}


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

{
  "data": {
    "procurementMethod": "open",
    "status": "active.enquiries",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-08-01T17:36:49.306344+03:00",
      "endDate": "2017-08-09T17:37:05.888957+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-07-25T17:36:55.659566+03:00",
    "next_check": "2017-08-01T17:36:49.306344+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "enquiryPeriod": {
      "startDate": "2017-07-25T17:36:55.659520+03:00",
      "endDate": "2017-08-01T17:36:49.306344+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-07-25T17:36:55.921421+03:00",
    "id": "f3641d0ba0f042e8b49de06d5c7921af",
    "tenderID": "UA-2017-07-25-000001"
  }
}

Відповіді

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

Коди стану

У будь-якому випадку API повинен повернути Код стану HTTP, що вказуватиме природу помилки (див. внизу), з тілом відповіді у форматі JSON, що міститиме додаткову інформацію.

200

Успіх. Якщо це був запит про інформацію, то вона буде доступна у data полі на верхньому рівні тіла відповіді.

201

Створено. Його інформація доступна у data полі на верхньому рівні тіла відповіді. API URL, де об’єкт можна прочитати, міститься у Location заголовку відповіді.

400

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

401

Несанкційонований доступ. Не було надано дійсного API ключа разом із запитом, тому API не може зв’язати користувача із запитом.

403

Заборонено. API ключ та синтаксис запиту були дійсними, але сервер відмовляється виконати запит. Це може статися, якщо ви пробуєте прочитати або записати об’єкти чи властивості, до яких не маєте доступу.

404

Ресурс не знайдено. Або даний метод та шлях запиту не вказують відому дію для API, або об’єкт, вказаний у запиті, не існує.

409

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

410

Архівовано. Шуканий ресурс не є й не буде доступним.

412

Збій під час обробки попередньої умови. Дивіться розділ Pобота з API в режимі кластеру.

422

Неможливо обробити об’єкт. Цей код стану означає, що сервер розуміє тип змісту об’єкта запиту. Наприклад, ця помилка може статися, якщо тіло запиту JSON містить добре сформовані (тобто синтаксично правильні), але семантично помилкові, інструкції у форматі JSON.

429

Перевищено допустиму частоту запитів. Дивіться розділ Контроль частоти запитів.

500

Помилка сервера. Була проблема зі сторони OpenProcurement.

501
Not Implemented. The server either does not recognize the request method, or it lacks the ability to fulfill the request. Re-check the request consistency.
502
Bad Gateway. The server received an invalid response or backend is not ready to handle requests. Repeat request for repeatable operations or check object data with interval 1-5 min.
503
Service Unavailable. The server is currently unavailable (because it is overloaded or down for maintenance). Generally, this is a temporary state.
504
Gateway Time-out. The server did not receive a timely response. Repeat request for repeatable operations or check object data with interval 1-5 min.
505
HTTP Version Not Supported. The server does not support the HTTP protocol version used in the request. Re-check the request consistency.

Відповідь з повідомленням про успіх

Кожен успішний запит вичитки, створення, оновлення, чи заміни отримує відповідь, що містить data атрибут. Цей data атрибут містить повне представлення JSON об’єкта після операції. Якщо деякі дані були згенеровані у результаті обробки (наприклад, нові ID об’єкта або modified дата), то вони присутні у відповіді.

Запити списку отримують схожі відповіді, але замість одного об’єкта в data атрибуті, JSON відповідь містить колекцію об’єктів.

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

Це відповідь, що описує закупівлю.

HTTP/1.1 200 OK

{
    "data":{
        "id": "64e93250be76435397e8c992ed4214d1",
        "tenderID": "UA-2014-DUS-156",
        "dateModified": "2014-10-27T08:06:58.158Z",
        "procuringEntity": {
            "name": "ДУС"б
            "identifier": {
                "name": "Державне управління справами",
                "scheme": "UA-EDR",
                "uid": "00037256"
            },
            "address": {
                "countryName": "Україна",
                "postalCode": "01220",
                "region": "м. Київ",
                "locality": "м. Київ",
                "streetAddress": "вул. Банкова, 11, корпус 1"
            }
        },
        "value": {
            "amount": 500,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
        },
        "items": [
            {
                "description": "футляри до державних нагород",
                "classification": {
                    "scheme": "CPV",
                    "id": "44617100-9",
                    "description": "Cartons"
                },
                "additionalClassifications": [
                    {
                        "scheme": "ДКПП",
                        "id": "17.21.1",
                        "description": "папір і картон гофровані, паперова й картонна тара"
                    }
                ],
                "quantity": 5,
                "unit": {
                    "name": "item"
                },
                "deliveryDate": {
                    "endDate": "2014-11-20T00:00:00"
                }
            }
        ],
        "clarificationPeriod": {
            "endDate": "2014-10-31T00:00:00"
        },
        "tenderPeriod": {
            "startDate": "2014-11-03T00:00:00",
            "endDate": "2014-11-06T10:00:00"
        },
        "minimalStep": {
            "amount": 35,
            "currency", "UAH",
            "valueAddedTaxIncluded": true
        }
    }
}

Відповідь з повідомленням про помилку

У випадку помилки, тіло відповіді міститиме errors поле на вищому рівні. Воно містить масив як мінімум одного помилкового об’єкта описаного нижче:

location:

Частина запиту спричинює помилку. Можливі значення це header (заголовок) або body (тіло).

name:
  • Конкретна назва заголовку, що спричиняє проблему (у випадку місцярозташування заголовок)

  • Конкретна назва поля, що спричиняє проблему (у випадку місцярозташування тіло)

description:

Докладний (придатний для читання людиною) опис помилки.

Приклад відповіді з повідомленням про помилку

Зразок нижче вказує на неповний запит.

HTTP/1.1 400 Missing input

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "No JSON object could be decoded"
    }
  ]
}

Опції

Крім надання полів та їхніх значень у запиті ви можете ще вказати опції для контролю над тим, як буде оброблятись запит і як буде генеруватись відповідь. Для GET запитів, опції вказуються як URL параметри з префіксом opt_. Для POST чи PUT запитів опції вказуються в тілі, всередині об’єктів опцій вищого рівня (схожих на обє’кт даних). Опція вказана в тілі перевизначає opt_ опцію з URL параметра.

Ці опції можна комбінувати в одному запиті, хоча деякі з них можуть викликати конфлікт у відповіді.

pretty:

?opt_pretty

options: { pretty: true }

Надає відповідь у форматі “pretty”. У випадку з JSON це означає правильне розбиття рядків і відступи для зручності читання. Це займе додатковий час і збільшить розмір відповіді, тому краще буде використовувати цю опцію тільки під час налагоджування (debugging).

jsonp:

?opt_jsonp=myCallback

Повертає відповідь у форматі JSON-P замість простого JSON, щоб дозволити запитам приходити з браузерів і працювати навколо “однакової політики походження (same origin policy).” Функція названа так само як значення параметра opt_jsonp буде викликана з одним аргументом - JavaScript об’єктом, що представляє відповідь.

fields:

?opt_fields=comma,separated,field,list

Список додаткових полів, що міститимуться у відповіді.

Формат дати: ISO 8601

Формат дати ISO 8601.

http://imgs.xkcd.com/comics/iso_8601.png

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

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

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

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

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

    POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
    Authorization: Basic YnJva2VyOg==
    Content-Length: 334
    Content-Type: application/json
    Host: api-sandbox.openprocurement.org
    
    {
      "data": {
        "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=3SoLjvN%2Bubc3yUq7E%2F8z%2FT4nhwBCO%2BYejSIqF2ORk3btE1ug052zZDNQQpi4yyd1rj%2FPX09LiTVm%2BoTVYouoCg%3D%3D",
        "title": "Notice.pdf",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      }
    }
    
    
    201 Created
    Content-Type: application/json; charset=UTF-8
    Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5
    
    {
      "data": {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "Notice.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:56.044656+03:00",
        "id": "8c4f7355fed4463b98eb429237a2e6a5",
        "dateModified": "2017-07-25T17:36:56.044677+03:00"
      }
    }
    
  3. Завантажити документ в document service.

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

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

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

    POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
    Authorization: Basic YnJva2VyOg==
    Content-Length: 334
    Content-Type: application/json
    Host: api-sandbox.openprocurement.org
    
    {
      "data": {
        "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=3SoLjvN%2Bubc3yUq7E%2F8z%2FT4nhwBCO%2BYejSIqF2ORk3btE1ug052zZDNQQpi4yyd1rj%2FPX09LiTVm%2BoTVYouoCg%3D%3D",
        "title": "Notice.pdf",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      }
    }
    
    
    201 Created
    Content-Type: application/json; charset=UTF-8
    Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5
    
    {
      "data": {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "Notice.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:56.044656+03:00",
        "id": "8c4f7355fed4463b98eb429237a2e6a5",
        "dateModified": "2017-07-25T17:36:56.044677+03:00"
      }
    }
    

Туторіал

Розглянемо основні правила

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

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


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

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

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

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

POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: api-sandbox.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.

Задовольнимо вимогу типу вмісту (Content-type):

POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: api-sandbox.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/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2359
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "tenderPeriod": {
      "endDate": "2017-08-08T17:36:49.306344"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "enquiryPeriod": {
      "endDate": "2017-08-01T17:36:49.306344"
    },
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344",
          "endDate": "2017-07-30T17:36:49.306344"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ]
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af

{
  "access": {
    "token": "2ef61fa89e8a451ba4149d2f8e31173b"
  },
  "data": {
    "procurementMethod": "open",
    "status": "active.enquiries",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-08-01T17:36:49.306344+03:00",
      "endDate": "2017-08-08T17:36:49.306344+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-07-25T17:36:55.659566+03:00",
    "next_check": "2017-08-01T17:36:49.306344+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "enquiryPeriod": {
      "startDate": "2017-07-25T17:36:55.659520+03:00",
      "endDate": "2017-08-01T17:36:49.306344+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-07-25T17:36:55.662421+03:00",
    "id": "f3641d0ba0f042e8b49de06d5c7921af",
    "tenderID": "UA-2017-07-25-000001"
  }
}

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

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

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


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

{
  "data": {
    "procurementMethod": "open",
    "status": "active.enquiries",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-08-01T17:36:49.306344+03:00",
      "endDate": "2017-08-08T17:36:49.306344+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-07-25T17:36:55.659566+03:00",
    "next_check": "2017-08-01T17:36:49.306344+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "enquiryPeriod": {
      "startDate": "2017-07-25T17:36:55.659520+03:00",
      "endDate": "2017-08-01T17:36:49.306344+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-07-25T17:36:55.662421+03:00",
    "id": "f3641d0ba0f042e8b49de06d5c7921af",
    "tenderID": "UA-2017-07-25-000001"
  }
}

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

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

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


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

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

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

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

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

{
  "data": {
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "e214fbd9ed204c9bb42f9e1f628109f8",
        "featureOf": "item"
      },
      {
        "code": "OCDS-123454-YEARS",
        "description": "Кількість років, які організація учасник працює на ринку",
        "title": "Років на ринку",
        "enum": [
          {
            "value": 0.05,
            "title": "До 3 років"
          },
          {
            "value": 0.1,
            "title": "Більше 3 років, менше 5 років"
          },
          {
            "value": 0.15,
            "title": "Більше 5 років"
          }
        ],
        "title_en": "Years trading",
        "featureOf": "tenderer"
      }
    ],
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "enquiryPeriod": {
      "endDate": "2017-08-01T17:36:49.331754"
    },
    "title_en": "Cases with state awards",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "mode": "test",
    "procurementMethodType": "belowThreshold",
    "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": "м. Київ"
      }
    },
    "title_ru": "футляры к государственным наградам",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_ru": "футляры к государственным наградам",
        "id": "e214fbd9ed204c9bb42f9e1f628109f8",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "tenderPeriod": {
      "endDate": "2017-08-08T17:36:49.331754"
    }
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e5d1cd890bd54669972755ca7e8604de

{
  "access": {
    "token": "1a6350b26a094a39adf455ee9a495f6c"
  },
  "data": {
    "procurementMethod": "open",
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "e214fbd9ed204c9bb42f9e1f628109f8",
        "featureOf": "item"
      },
      {
        "code": "OCDS-123454-YEARS",
        "description": "Кількість років, які організація учасник працює на ринку",
        "title": "Років на ринку",
        "enum": [
          {
            "value": 0.05,
            "title": "До 3 років"
          },
          {
            "value": 0.1,
            "title": "Більше 3 років, менше 5 років"
          },
          {
            "value": 0.15,
            "title": "Більше 5 років"
          }
        ],
        "title_en": "Years trading",
        "featureOf": "tenderer"
      }
    ],
    "enquiryPeriod": {
      "startDate": "2017-07-25T17:36:55.784983+03:00",
      "endDate": "2017-08-01T17:36:49.331754+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-08-01T17:36:49.331754+03:00",
    "awardCriteria": "lowestCost",
    "owner": "broker",
    "id": "e5d1cd890bd54669972755ca7e8604de",
    "title": "[ТЕСТУВАННЯ] футляри до державних нагород",
    "tenderID": "UA-2017-07-25-000002",
    "dateModified": "2017-07-25T17:36:55.787215+03:00",
    "status": "active.enquiries",
    "tenderPeriod": {
      "startDate": "2017-08-01T17:36:49.331754+03:00",
      "endDate": "2017-08-08T17:36:49.331754+03:00"
    },
    "procurementMethodType": "belowThreshold",
    "title_en": "[TESTING] Cases with state awards",
    "date": "2017-07-25T17:36:55.785011+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_ru": "футляры к государственным наградам",
        "id": "e214fbd9ed204c9bb42f9e1f628109f8",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.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": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

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

Перевіримо, що містить реєстр закупівель:

GET /api/2.3/tenders?mode=__all__ HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "next_page": {
    "path": "/api/2.3/tenders?offset=2017-07-25T17%3A36%3A55.662421%2B03%3A00",
    "uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=2017-07-25T17%3A36%3A55.662421%2B03%3A00",
    "offset": "2017-07-25T17:36:55.662421+03:00"
  },
  "data": [
    {
      "id": "f3641d0ba0f042e8b49de06d5c7921af",
      "dateModified": "2017-07-25T17:36:55.662421+03:00"
    }
  ]
}

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

Модифікація закупівлі

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

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "tenderPeriod": {
      "endDate": "2017-08-09T17:37:05.888957+03:00"
    }
  }
}


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

{
  "data": {
    "procurementMethod": "open",
    "status": "active.enquiries",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-08-01T17:36:49.306344+03:00",
      "endDate": "2017-08-09T17:37:05.888957+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-07-25T17:36:55.659566+03:00",
    "next_check": "2017-08-01T17:36:49.306344+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "enquiryPeriod": {
      "startDate": "2017-07-25T17:36:55.659520+03:00",
      "endDate": "2017-08-01T17:36:49.306344+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-07-25T17:36:55.921421+03:00",
    "id": "f3641d0ba0f042e8b49de06d5c7921af",
    "tenderID": "UA-2017-07-25-000001"
  }
}

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

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

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


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

{
  "next_page": {
    "path": "/api/2.3/tenders?offset=2017-07-25T17%3A36%3A55.824208%2B03%3A00",
    "uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=2017-07-25T17%3A36%3A55.824208%2B03%3A00",
    "offset": "2017-07-25T17:36:55.824208+03:00"
  },
  "data": [
    {
      "id": "f3641d0ba0f042e8b49de06d5c7921af",
      "dateModified": "2017-07-25T17:36:55.662421+03:00"
    },
    {
      "id": "f8802ccce4d9409693ae745ea983c59a",
      "dateModified": "2017-07-25T17:36:55.824208+03:00"
    }
  ]
}

Замовник може встановити забезпечення тендерної пропозиції:

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 57
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "guarantee": {
      "currency": "USD",
      "amount": 8
    }
  }
}


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

{
  "data": {
    "procurementMethod": "open",
    "status": "active.enquiries",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-08-01T17:36:49.306344+03:00",
      "endDate": "2017-08-09T17:37:05.888957+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-07-25T17:36:55.659566+03:00",
    "next_check": "2017-08-01T17:36:49.306344+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "enquiryPeriod": {
      "startDate": "2017-07-25T17:36:55.659520+03:00",
      "endDate": "2017-08-01T17:36:49.306344+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-07-25T17:36:56.017598+03:00",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    },
    "id": "f3641d0ba0f042e8b49de06d5c7921af",
    "tenderID": "UA-2017-07-25-000001"
  }
}

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

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

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 334
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=3SoLjvN%2Bubc3yUq7E%2F8z%2FT4nhwBCO%2BYejSIqF2ORk3btE1ug052zZDNQQpi4yyd1rj%2FPX09LiTVm%2BoTVYouoCg%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:56.044656+03:00",
    "id": "8c4f7355fed4463b98eb429237a2e6a5",
    "dateModified": "2017-07-25T17:36:56.044677+03:00"
  }
}

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

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:56.044656+03:00",
    "previousVersions": [],
    "id": "8c4f7355fed4463b98eb429237a2e6a5",
    "dateModified": "2017-07-25T17:36:56.044677+03:00"
  }
}

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

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 337
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=hL8BrNI7MEEHubwh5Eb%2BCvQZFd29l2lZAEcg8C1V42LlydVZf%2Fk%2BshwSYXfpnzT3q1JAZnAx3CaANvSWhCm%2FAA%3D%3D",
    "title": "AwardCriteria.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/14f948894bcc4ddc9da4d2129b028116

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "AwardCriteria.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=ysTqp33c7XMcniHmMMRwEbzHqlh7u0B1Xody%2F3MDOvWweLLYYutsDvREJ4lJcsnLkpv9HRVECjPJt2vGmv8GBw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:56.140078+03:00",
    "id": "14f948894bcc4ddc9da4d2129b028116",
    "dateModified": "2017-07-25T17:36:56.140097+03:00"
  }
}

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

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description modified",
      "title": "Notice.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:56.044656+03:00",
      "author": "tender_owner",
      "documentType": "technicalSpecifications",
      "id": "8c4f7355fed4463b98eb429237a2e6a5",
      "dateModified": "2017-07-25T17:36:56.044677+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "AwardCriteria.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=ysTqp33c7XMcniHmMMRwEbzHqlh7u0B1Xody%2F3MDOvWweLLYYutsDvREJ4lJcsnLkpv9HRVECjPJt2vGmv8GBw%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:56.140078+03:00",
      "id": "14f948894bcc4ddc9da4d2129b028116",
      "dateModified": "2017-07-25T17:36:56.140097+03:00"
    }
  ]
}

Додамо нове поле documentType з параметром technicalSpecifications до вже завантаженого документа.

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 53
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "documentType": "technicalSpecifications"
  }
}


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:56.044656+03:00",
    "documentType": "technicalSpecifications",
    "id": "8c4f7355fed4463b98eb429237a2e6a5",
    "dateModified": "2017-07-25T17:36:56.044677+03:00"
  }
}

Успіх! Код відповіді 200 OK підтверджує, що поле documentType з параметром technicalSpecifications було додано.

Можна змінити будь-яке поле в документі. Наприклад, description (опис):

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 58
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "description": "document description modified"
  }
}


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description modified",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:56.044656+03:00",
    "author": "tender_owner",
    "documentType": "technicalSpecifications",
    "id": "8c4f7355fed4463b98eb429237a2e6a5",
    "dateModified": "2017-07-25T17:36:56.044677+03:00"
  }
}

Повернено код 200 OK, тобто опис було успішно відредаговано.

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

PUT /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/14f948894bcc4ddc9da4d2129b028116?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 337
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=EC1QzFOXAe%2BawGOy%2FJR3YMrURSrxoUXQMtC%2BIIrTcHlCcL26Uj1%2BSbggyBg1H87VOEn9EBtEgBde0s8zxohcDQ%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",
    "author": "tender_owner",
    "title": "AwardCriteria-2.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=76AeflAK4BuZ734jGky7PBC9Tk3HAmi6UmSE1ElFiy2jLkYGA1%2FMdT7NIF7Hto%2F5PmrqAktZ%2FYovZYW6QptFBg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:56.140078+03:00",
    "id": "14f948894bcc4ddc9da4d2129b028116",
    "dateModified": "2017-07-25T17:36:56.181719+03:00"
  }
}

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

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description modified",
      "title": "Notice.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:56.044656+03:00",
      "author": "tender_owner",
      "documentType": "technicalSpecifications",
      "id": "8c4f7355fed4463b98eb429237a2e6a5",
      "dateModified": "2017-07-25T17:36:56.044677+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "AwardCriteria-2.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=76AeflAK4BuZ734jGky7PBC9Tk3HAmi6UmSE1ElFiy2jLkYGA1%2FMdT7NIF7Hto%2F5PmrqAktZ%2FYovZYW6QptFBg%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:56.140078+03:00",
      "id": "14f948894bcc4ddc9da4d2129b028116",
      "dateModified": "2017-07-25T17:36:56.181719+03:00"
    }
  ]
}

Уточнення

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

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.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.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions/e2e6900f65434252a75741613fe0703b

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

Замовник може на них відповісти:

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions/e2e6900f65434252a75741613fe0703b?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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


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

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "dateAnswered": "2017-07-25T17:36:56.273608+03:00",
    "title": "Калорійність",
    "date": "2017-07-25T17:36:56.229819+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "e2e6900f65434252a75741613fe0703b",
    "questionOf": "tender"
  }
}

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

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "description": "Просимо додати таблицю потрібної калорійності харчування",
      "dateAnswered": "2017-07-25T17:36:56.273608+03:00",
      "title": "Калорійність",
      "date": "2017-07-25T17:36:56.229819+03:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "id": "e2e6900f65434252a75741613fe0703b",
      "questionOf": "tender"
    }
  ]
}

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

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions/e2e6900f65434252a75741613fe0703b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "dateAnswered": "2017-07-25T17:36:56.273608+03:00",
    "title": "Калорійність",
    "date": "2017-07-25T17:36:56.229819+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "e2e6900f65434252a75741613fe0703b",
    "questionOf": "tender"
  }
}

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

Покроковий режим реєстрації

Коли приходить Tender.tenderingPeriod.startDate, Закупівля отримує статус active.tendering, що дозволяє реєстрацію пропозицій.

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

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 757
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "draft",
    "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.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194

{
  "access": {
    "token": "1570f17a0a084e29aad2dc9a600e5589"
  },
  "data": {
    "date": "2017-07-25T17:36:56.363108+03:00",
    "status": "draft",
    "id": "ba18d19f2a3948deb997a7a55dd2f194",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": 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": "м. Вінниця"
        }
      }
    ]
  }
}

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

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194?acc_token=1570f17a0a084e29aad2dc9a600e5589 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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


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

{
  "data": {
    "date": "2017-07-25T17:36:56.363108+03:00",
    "status": "active",
    "id": "ba18d19f2a3948deb997a7a55dd2f194",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": 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": "м. Вінниця"
        }
      }
    ]
  }
}

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

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents?acc_token=1570f17a0a084e29aad2dc9a600e5589 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 332
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/9dbee8d173ea4ce0a507c196ee39bf54?KeyID=459f8ecf&Signature=rZYCyINjYNoMJTwUJ1IQ8jTR%2FXiOIAnsLI2fN%2BsEtG8mxyoYq3RiXCYmE%2BZIsQWV4W6gszc8aC2s7lhV%2FxerBw%3D%3D",
    "title": "Proposal.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents/2d439b94c3de42e28bb10c9d9576fd27

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Proposal.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents/2d439b94c3de42e28bb10c9d9576fd27?download=9dbee8d173ea4ce0a507c196ee39bf54",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:56.467858+03:00",
    "id": "2d439b94c3de42e28bb10c9d9576fd27",
    "dateModified": "2017-07-25T17:36:56.467877+03:00"
  }
}

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

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents?acc_token=1570f17a0a084e29aad2dc9a600e5589 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "Proposal.pdf",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents/2d439b94c3de42e28bb10c9d9576fd27?download=9dbee8d173ea4ce0a507c196ee39bf54",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:56.467858+03:00",
      "id": "2d439b94c3de42e28bb10c9d9576fd27",
      "dateModified": "2017-07-25T17:36:56.467877+03:00"
    }
  ]
}

Пакетний режим реєстрації

У пакетному режимі (batch-mode) є можливість зареєструвати пропозицію одним запитом:

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1365
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "documents": [
      {
        "url": "http://public.docs-sandbox.openprocurement.org/get/331460f91e944a2d83136dee00b94f0f?KeyID=459f8ecf&Signature=TNOpuGEGleAHWS8gmR6mYc9O7e%2BEo2o28db4dVIaESJzcMyQVdTvA9xrfkzNXRGTlP2KUUpib8Bpk3rke2KkDg%3D%3D",
        "title": "Proposal_part1.pdf",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      },
      {
        "url": "http://public.docs-sandbox.openprocurement.org/get/3bfc49d63bd44e9488e1270003e52178?KeyID=459f8ecf&Signature=JXeIpHZQQo57b67ncruZEOHjEFrAtoW3GHrmDN4U2vOySIRAS9Hr5VrFh8BDZyhaYsiXjfqcCFWnxCxcPzdpBw%3D%3D",
        "title": "Proposal_part2.pdf",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      }
    ],
    "value": {
      "amount": 499
    },
    "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.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3

{
  "access": {
    "token": "22d01413f6604999a61b174fabe6ffe2"
  },
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part1.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3/documents/df9dd9b2c3a94843872c990a919137b7?download=331460f91e944a2d83136dee00b94f0f",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:56.537226+03:00",
        "id": "df9dd9b2c3a94843872c990a919137b7",
        "dateModified": "2017-07-25T17:36:56.537243+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3/documents/89daa7ea804c40febcbc83bed93587ea?download=3bfc49d63bd44e9488e1270003e52178",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:56.537686+03:00",
        "id": "89daa7ea804c40febcbc83bed93587ea",
        "dateModified": "2017-07-25T17:36:56.537703+03:00"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": 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": "м. Львів"
        }
      }
    ],
    "date": "2017-07-25T17:36:56.536644+03:00",
    "id": "bfa4b4a0f47f4270b5f139307e217ec3"
  }
}

Аукціон

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

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


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

{
  "data": {
    "procurementMethod": "open",
    "auctionUrl": "http://auction-sandbox.openprocurement.org/tenders/f3641d0ba0f042e8b49de06d5c7921af",
    "enquiryPeriod": {
      "startDate": "2017-07-11T17:36:49.306344+03:00",
      "endDate": "2017-07-18T17:36:49.306344+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-07-25T18:12:49.306344+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "dateAnswered": "2017-07-25T17:36:56.273608+03:00",
        "title": "Калорійність",
        "date": "2017-07-25T17:36:56.229819+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "e2e6900f65434252a75741613fe0703b",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "id": "f3641d0ba0f042e8b49de06d5c7921af",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    },
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description modified",
        "title": "Notice.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:56.044656+03:00",
        "author": "tender_owner",
        "documentType": "technicalSpecifications",
        "id": "8c4f7355fed4463b98eb429237a2e6a5",
        "dateModified": "2017-07-25T17:36:56.044677+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=ysTqp33c7XMcniHmMMRwEbzHqlh7u0B1Xody%2F3MDOvWweLLYYutsDvREJ4lJcsnLkpv9HRVECjPJt2vGmv8GBw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:56.140078+03:00",
        "id": "14f948894bcc4ddc9da4d2129b028116",
        "dateModified": "2017-07-25T17:36:56.140097+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=76AeflAK4BuZ734jGky7PBC9Tk3HAmi6UmSE1ElFiy2jLkYGA1%2FMdT7NIF7Hto%2F5PmrqAktZ%2FYovZYW6QptFBg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:56.140078+03:00",
        "id": "14f948894bcc4ddc9da4d2129b028116",
        "dateModified": "2017-07-25T17:36:56.181719+03:00"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderID": "UA-2017-07-25-000001",
    "dateModified": "2017-07-25T17:36:56.710634+03:00",
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2017-07-18T17:36:49.306344+03:00",
      "endDate": "2017-07-25T17:36:49.306344+03:00"
    },
    "auctionPeriod": {
      "startDate": "2017-07-25T17:36:49.306344+03:00",
      "shouldStartAfter": "2017-07-26T00:00:00+03:00"
    },
    "procurementMethodType": "belowThreshold",
    "date": "2017-07-25T17:36:55.659566+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

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

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194?acc_token=1570f17a0a084e29aad2dc9a600e5589 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents/2d439b94c3de42e28bb10c9d9576fd27?download=9dbee8d173ea4ce0a507c196ee39bf54",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:56.467858+03:00",
        "id": "2d439b94c3de42e28bb10c9d9576fd27",
        "dateModified": "2017-07-25T17:36:56.467877+03:00"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": 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": "м. Вінниця"
        }
      }
    ],
    "date": "2017-07-25T17:36:56.363108+03:00",
    "id": "ba18d19f2a3948deb997a7a55dd2f194",
    "participationUrl": "http://auction-sandbox.openprocurement.org/tenders/f3641d0ba0f042e8b49de06d5c7921af?key_for_bid=ba18d19f2a3948deb997a7a55dd2f194"
  }
}

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

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3?acc_token=22d01413f6604999a61b174fabe6ffe2 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part1.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3/documents/df9dd9b2c3a94843872c990a919137b7?download=331460f91e944a2d83136dee00b94f0f",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:56.537226+03:00",
        "id": "df9dd9b2c3a94843872c990a919137b7",
        "dateModified": "2017-07-25T17:36:56.537243+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3/documents/89daa7ea804c40febcbc83bed93587ea?download=3bfc49d63bd44e9488e1270003e52178",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:56.537686+03:00",
        "id": "89daa7ea804c40febcbc83bed93587ea",
        "dateModified": "2017-07-25T17:36:56.537703+03:00"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": 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": "м. Львів"
        }
      }
    ],
    "date": "2017-07-25T17:36:56.536644+03:00",
    "id": "bfa4b4a0f47f4270b5f139307e217ec3",
    "participationUrl": "http://auction-sandbox.openprocurement.org/tenders/f3641d0ba0f042e8b49de06d5c7921af?key_for_bid=bfa4b4a0f47f4270b5f139307e217ec3"
  }
}

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

Кваліфікаційна комісія реєструє своє рішення через такий виклик:

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/awards/f81f540a2df94c529cdea7cf197b5038?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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


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

{
  "data": {
    "status": "active",
    "complaintPeriod": {
      "startDate": "2017-07-25T17:36:57.009762+03:00",
      "endDate": "2017-07-27T17:36:57.134318+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "м. Львів",
          "locality": "м. Львів"
        }
      }
    ],
    "bid_id": "bfa4b4a0f47f4270b5f139307e217ec3",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-07-25T17:36:57.138607+03:00",
    "id": "f81f540a2df94c529cdea7cf197b5038"
  }
}

Встановлення вартості угоди

За замовчуванням вартість угоди встановлюється на основі рішення про визначення переможця, але є можливість змінити це значення.

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

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 73
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "contractNumber": "contract #13111",
    "value": {
      "amount": 238
    }
  }
}


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

{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "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": "м. Львів"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-07-25T17:36:57.134377+03:00",
    "awardID": "f81f540a2df94c529cdea7cf197b5038",
    "id": "54a174a38f174fb3802e573a9adc66ef",
    "contractID": "UA-2017-07-25-000001-1"
  }
}

Було повернуто код відповіді 200 OK. Значення змінено успішно.

Встановлення дати підписання угоди

Є можливість встановити дату підписання угоди. Для цього вставте відповідну дату в поле dateSigned.

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

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 60
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "dateSigned": "2017-07-25T17:36:57.724072+03:00"
  }
}


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

{
  "data": {
    "status": "pending",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_first_document.doc",
        "url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:57.534210+03:00",
        "id": "7fbb37c72038487ea8e66c27da3dac2b",
        "dateModified": "2017-07-25T17:36:57.534229+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_second_document.doc",
        "url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=sfBQXr48pj4%2FqodFIsxDFzY%2FIkbD7uMFkmZ%2F95OfLvQvtVbVfV056nR%252BbuchmaYFApJfmspyVFlVWRwNSB6rDA%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:57.643439+03:00",
        "id": "402f10f3b56f47168f47abfd075676c8",
        "dateModified": "2017-07-25T17:36:57.643460+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "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": "м. Львів"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "period": {
      "startDate": "2017-07-25T17:36:49.331754+03:00",
      "endDate": "2018-07-25T17:36:49.331754+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-07-25T17:36:57.724072+03:00",
    "date": "2017-07-25T17:36:57.134377+03:00",
    "awardID": "f81f540a2df94c529cdea7cf197b5038",
    "id": "54a174a38f174fb3802e573a9adc66ef",
    "contractID": "UA-2017-07-25-000001-1"
  }
}

Встановлення терміну дії угоди

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

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 106
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "period": {
      "startDate": "2017-07-25T17:36:49.331754",
      "endDate": "2018-07-25T17:36:49.331754"
    }
  }
}


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

{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "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": "м. Львів"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "period": {
      "startDate": "2017-07-25T17:36:49.331754+03:00",
      "endDate": "2018-07-25T17:36:49.331754+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-07-25T17:36:57.325183+03:00",
    "date": "2017-07-25T17:36:57.134377+03:00",
    "awardID": "f81f540a2df94c529cdea7cf197b5038",
    "id": "54a174a38f174fb3802e573a9adc66ef",
    "contractID": "UA-2017-07-25-000001-1"
  }
}

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

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

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 344
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=i5sHgwSiMfgqUfXlpZdQecZT5mUbIMtSpWhlnZ3UNmBGcYz61cWRSy4t%2FsY1RZjXuKfucViJulmAoeiVnHPFAw%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.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents/7fbb37c72038487ea8e66c27da3dac2b

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_first_document.doc",
    "url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:57.534210+03:00",
    "id": "7fbb37c72038487ea8e66c27da3dac2b",
    "dateModified": "2017-07-25T17:36:57.534229+03:00"
  }
}

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

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

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_first_document.doc",
      "url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:57.534210+03:00",
      "id": "7fbb37c72038487ea8e66c27da3dac2b",
      "dateModified": "2017-07-25T17:36:57.534229+03:00"
    }
  ]
}

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

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 353
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=%2FX5%2FjNT6bkqCZyl19ZVptb61xQbNg%2FY60bSEcwDSAPoGu8Jc0ymikk7DaCAWERcR35gqbAlwk9AO1R%2B%2BUUJaBQ%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.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents/402f10f3b56f47168f47abfd075676c8

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_second_document.doc",
    "url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=sfBQXr48pj4%2FqodFIsxDFzY%2FIkbD7uMFkmZ%2F95OfLvQvtVbVfV056nR%252BbuchmaYFApJfmspyVFlVWRwNSB6rDA%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:57.643439+03:00",
    "id": "402f10f3b56f47168f47abfd075676c8",
    "dateModified": "2017-07-25T17:36:57.643460+03:00"
  }
}

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

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

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_first_document.doc",
      "url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:57.534210+03:00",
      "id": "7fbb37c72038487ea8e66c27da3dac2b",
      "dateModified": "2017-07-25T17:36:57.534229+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_second_document.doc",
      "url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=sfBQXr48pj4%2FqodFIsxDFzY%2FIkbD7uMFkmZ%2F95OfLvQvtVbVfV056nR%252BbuchmaYFApJfmspyVFlVWRwNSB6rDA%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:57.643439+03:00",
      "id": "402f10f3b56f47168f47abfd075676c8",
      "dateModified": "2017-07-25T17:36:57.643460+03:00"
    }
  ]
}

Встановити дату підписання угоди

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

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 60
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "dateSigned": "2017-07-25T17:36:57.724072+03:00"
  }
}


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

{
  "data": {
    "status": "pending",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_first_document.doc",
        "url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:57.534210+03:00",
        "id": "7fbb37c72038487ea8e66c27da3dac2b",
        "dateModified": "2017-07-25T17:36:57.534229+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_second_document.doc",
        "url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=sfBQXr48pj4%2FqodFIsxDFzY%2FIkbD7uMFkmZ%2F95OfLvQvtVbVfV056nR%252BbuchmaYFApJfmspyVFlVWRwNSB6rDA%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:57.643439+03:00",
        "id": "402f10f3b56f47168f47abfd075676c8",
        "dateModified": "2017-07-25T17:36:57.643460+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "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": "м. Львів"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "period": {
      "startDate": "2017-07-25T17:36:49.331754+03:00",
      "endDate": "2018-07-25T17:36:49.331754+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-07-25T17:36:57.724072+03:00",
    "date": "2017-07-25T17:36:57.134377+03:00",
    "awardID": "f81f540a2df94c529cdea7cf197b5038",
    "id": "54a174a38f174fb3802e573a9adc66ef",
    "contractID": "UA-2017-07-25-000001-1"
  }
}

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

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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


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

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_first_document.doc",
        "url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:57.534210+03:00",
        "id": "7fbb37c72038487ea8e66c27da3dac2b",
        "dateModified": "2017-07-25T17:36:57.534229+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_second_document.doc",
        "url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=sfBQXr48pj4%2FqodFIsxDFzY%2FIkbD7uMFkmZ%2F95OfLvQvtVbVfV056nR%252BbuchmaYFApJfmspyVFlVWRwNSB6rDA%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:57.643439+03:00",
        "id": "402f10f3b56f47168f47abfd075676c8",
        "dateModified": "2017-07-25T17:36:57.643460+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "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": "м. Львів"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "period": {
      "startDate": "2017-07-25T17:36:49.331754+03:00",
      "endDate": "2018-07-25T17:36:49.331754+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-07-25T17:36:57.724072+03:00",
    "date": "2017-07-25T17:36:57.901656+03:00",
    "awardID": "f81f540a2df94c529cdea7cf197b5038",
    "id": "54a174a38f174fb3802e573a9adc66ef",
    "contractID": "UA-2017-07-25-000001-1"
  }
}

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

Замовник може скасувати закупівлю у будь-який момент (крім закупівель у кінцевому стані, наприклад, usuccesfull, canceled, complete).

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

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

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

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

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

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

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

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

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873

{
  "data": {
    "date": "2017-07-25T17:36:58.034107+03:00",
    "status": "pending",
    "reason": "cancellation reason",
    "cancellationOf": "tender",
    "id": "8e1908a8ada64ae19ebfa4f2fdd7d873"
  }
}

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

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

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 322
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/0a4e09e6e3ac4591a91431586bfec51b?KeyID=459f8ecf&Signature=QpcrFFfy9aG4sgHieujyWnjL4ZwH8QFQGpF1JBRo05nDMckRIq6cqW6X2FdHmVjcXWV1LvpYdUaquAxmY1OrBg%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873/documents/56d80bbae8ab41e196922d137c87e20d

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/0a4e09e6e3ac4591a91431586bfec51b?KeyID=459f8ecf&Signature=l7LFxrLX0mB5IFVRX8TZccYKe21EcCllwvCWGH7RdEYrzhMaLep8J9Ae2F5VzMj566FeEGIqh6Cy5wzNVWmPDg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:58.123830+03:00",
    "id": "56d80bbae8ab41e196922d137c87e20d",
    "dateModified": "2017-07-25T17:36:58.123851+03:00"
  }
}

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

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873/documents/56d80bbae8ab41e196922d137c87e20d?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 48
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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


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

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/0a4e09e6e3ac4591a91431586bfec51b?KeyID=459f8ecf&Signature=l7LFxrLX0mB5IFVRX8TZccYKe21EcCllwvCWGH7RdEYrzhMaLep8J9Ae2F5VzMj566FeEGIqh6Cy5wzNVWmPDg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:58.123830+03:00",
    "id": "56d80bbae8ab41e196922d137c87e20d",
    "dateModified": "2017-07-25T17:36:58.123851+03:00"
  }
}

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

PUT /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873/documents/56d80bbae8ab41e196922d137c87e20d?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 328
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/d19863828f684b8393cd9907f2bcb84c?KeyID=459f8ecf&Signature=g6c3S5r43owtO3ERE72E0X6gFjUH9IXXqDEYEAjtDEV3qjaZ7OObLssBCsOg2bZ79nq%2FBZ2H9kmdC7ViVhK%2BAQ%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",
    "title": "Notice-2.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/d19863828f684b8393cd9907f2bcb84c?KeyID=459f8ecf&Signature=OQ48HntXEVhqTjhaHm0k7h7hcQ1fjG0otkUT%2F31%252Bz4gToAobjILCREgVN14ja5Pa0Y3t3o%2FMjeDLaI7V77fRCw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:58.123830+03:00",
    "id": "56d80bbae8ab41e196922d137c87e20d",
    "dateModified": "2017-07-25T17:36:58.317900+03:00"
  }
}

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

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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


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

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/0a4e09e6e3ac4591a91431586bfec51b?KeyID=459f8ecf&Signature=l7LFxrLX0mB5IFVRX8TZccYKe21EcCllwvCWGH7RdEYrzhMaLep8J9Ae2F5VzMj566FeEGIqh6Cy5wzNVWmPDg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:58.123830+03:00",
        "id": "56d80bbae8ab41e196922d137c87e20d",
        "dateModified": "2017-07-25T17:36:58.123851+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice-2.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/d19863828f684b8393cd9907f2bcb84c?KeyID=459f8ecf&Signature=OQ48HntXEVhqTjhaHm0k7h7hcQ1fjG0otkUT%2F31%252Bz4gToAobjILCREgVN14ja5Pa0Y3t3o%2FMjeDLaI7V77fRCw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:58.123830+03:00",
        "id": "56d80bbae8ab41e196922d137c87e20d",
        "dateModified": "2017-07-25T17:36:58.317900+03:00"
      }
    ],
    "reason": "cancellation reason",
    "date": "2017-07-25T17:36:58.421729+03:00",
    "cancellationOf": "tender",
    "id": "8e1908a8ada64ae19ebfa4f2fdd7d873"
  }
}

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

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

Tender

Схема

title:

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

Назва тендера, яка відображається у списках. Можна включити такі елементи:

  • код закупівлі (у системі управління організації-замовника)

  • періодичність закупівлі (щороку, щокварталу, і т.д.)

  • елемент, що закуповується

  • інша інформація

description:

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

Детальний опис закупівлі

tenderID:

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

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

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

procuringEntity:
 

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

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

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

value:

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

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

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

guarantee:

Guarantee

Забезпечення тендерної пропозиції

date:

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

items:

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

Список, який містить елемент, що закуповується.

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

features:

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

Властивості закупівлі.

documents:

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

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

questions:

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

Питання до замовника procuringEntity і відповіді на них.

complaints:

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

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

bids:

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

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

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

minimalStep:

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

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

  • Значення amount повинно бути меншим за Tender.value.amount

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

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

awards:

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

Усі кваліфікації (дискваліфікації та переможці).

contracts:

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

enquiryPeriod:

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

Період, коли дозволено задавати питання. Повинна бути вказана хоча б endDate дата.

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

tenderPeriod:

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

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

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

auctionPeriod:

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

Період, коли проводиться аукціон.

auctionUrl:

URL-адреса

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

awardPeriod:

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

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

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

status:

рядок

active.enquiries:
 

Період уточнень (уточнення)

active.tendering:
 

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

active.auction:

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

active.qualification:
 

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

active.awarded:

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

unsuccessful:

Закупівля не відбулась (не відбулась)

complete:

Завершена закупівля (завершена)

cancelled:

Відмінена закупівля (відмінена)

Статус Закупівлі.

lots:

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

Містить всі лоти закупівлі.

cancellations:

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

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

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

funders:

List of Organization objects.

Optional field.

The funder is an entity providing money or finance for contracting process.

revisions:

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

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

Важливо

Дати закупівлі повинні бути послідовними:

  • Поточний час

  • enquiryPeriod.startDate
  • enquiryPeriod.endDate
  • tenderPeriod.startDate
  • tenderPeriod.endDate

Organization

Схема

name:

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

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

identifier:

Identifier

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

additionalIdentifiers:
 

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

address:

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

contactPoint:

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

Identifier

Схема

scheme:

рядок

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

id:

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

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

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

legalName:

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

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

uri:

uri

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

Address

Схема

streetAddress:

рядок

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

locality:

рядок

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

region:

рядок

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

postalCode:

рядок

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

countryName:

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

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

ContactPoint

Схема

name:

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

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

email:

email

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

telephone:

рядок

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

faxNumber:

рядок

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

url:

url

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

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

Item

Схема

id:

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

description:

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

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

classification:

Classification

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

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

additionalClassifications:
 

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

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

Обов’язково мати хоча б один елемент з ДКПП у стрічці scheme.

unit:

Unit

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

quantity:

ціле число

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

deliveryDate:

Period

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

deliveryAddress:
 

Address

Адреса місця, куди елемент повинен бути доставлений.

deliveryLocation:
 

словник

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

latitude:

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

longitude:

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

elevation:

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

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

relatedLot:

рядок

ID пов’язаного Lot.

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:

рядок

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

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

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

  • biddingDocuments - Документи закупівлі

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

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

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

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

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

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

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

  • eligibilityCriteria - Критерії прийнятності

    Докладні документи про критерії відбору.

  • shortlistedFirms - Фірми у короткому списку

  • riskProvisions - Положення для управління ризиками та зобов’язаннями

  • billOfQuantity - Кошторис

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

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

  • conflictOfInterest - Виявлені конфлікти інтересів

  • debarments - Відмова у допуску до закупівлі

  • contractProforma - Проект договору

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

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

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

  • evaluationReports - Звіт про оцінку

    Звіт про оцінку пропозицій і застосування критеріїв оцінки, у тому числі, обґрунтування рішення про визначення переможця.

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

  • complaints - Скарги та рішення

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

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

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

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

  • contractArrangements - Заходи для припинення договору

  • contractSchedule - Розклад та етапи

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

  • contractGuarantees - Забезпечення тендерних пропозицій

  • subContract - Субпідряд

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

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

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

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

title:

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

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

description:

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

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

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:

рядок

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

  • tender
  • item
  • lot
relatedItem:

рядок

ID пов’язаних Lot або Item.

Lot

Схема

id:

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

title:

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

Назва лота закупівлі.

description:

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

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

value:

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

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

guarantee:

Guarantee

Забезпечення тендерної пропозиції

date:

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

minimalStep:

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

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

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

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

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

auctionPeriod:

Period, доступно лише для читання

Період проведення аукціону.

auctionUrl:

URL-адреса

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

status:

рядок

active:

Активний лот закупівлі (активний)

unsuccessful:

Неуспішний лот закупівлі (не відбувся)

complete:

Завершено лот закупівлі (завершено)

cancelled:

Скасовано лот закупівлі (скасовано)

Статус лота.

Bid

Схема

tenderers:

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

date:

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

id:

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

status:

рядок

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

  • draft
  • active
value:

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

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

  • Значення amount повинно бути меншим за Tender.value.amout

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

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

documents:

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

parameters:

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

lotValues:

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

participationUrl:
 

URL-адреса

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

Parameter

Схема

code:

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

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

value:

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

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

LotValue

Схема

value:

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

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

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

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

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

relatedLot:

рядок

ID пов’язаного Lot.

date:

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

participationUrl:
 

URL-адреса

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

Award

Схема

id:

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

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

bid_id:

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

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

title:

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

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

description:

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

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

status:

рядок

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

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

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

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

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

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

date:

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

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

value:

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

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

suppliers:

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

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

items:

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

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

documents:

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

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

complaints:

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

complaintPeriod:
 

Period

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

lotID:

рядок

ID пов’язаного Lot.

Question

Схема

id:

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

author:

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

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

title:

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

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

description:

рядок

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

date:

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

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

dateAnswered:

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

Дата, коли було надано відповідь.

answer:

рядок

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

questionOf:

рядок

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

  • tender
  • item
  • lot
relatedItem:

рядок

ID пов’язаних Lot або Item.

Complaint

Схема

id:

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

author:

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

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

title:

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

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

description:

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

date:

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

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

dateSubmitted:

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

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

dateAnswered:

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

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

dateEscalated:

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

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

dateDecision:

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

День прийняття рішення по вимозі.

dateCanceled:

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

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

status:

рядок

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

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

  • claim - вимога

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

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

  • invalid - недійсно

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

  • resolved - вирішено

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

type:

рядок

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

  • claim - вимога

  • complaint - скарга

resolution:

рядок

Рішення замовника.

resolutionType:

рядок

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

  • invalid - недійсно

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

  • resolved - вирішено

satisfied:

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

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

decision:

рядок

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

cancellationReason:
 

рядок

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

documents:

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

relatedLot:

рядок

Ідентифікатор пов’язаного Lot-а.

tendererAction:

рядок

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

tendererActionDate:
 

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

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

Contract

Схема

id:

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

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

awardID:

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

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

contractID:

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

contractNumber:

рядок

title:

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

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

description:

рядок

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

value:

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

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

items:

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

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

suppliers:

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

status:

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

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

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

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

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

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

period:

Period

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

dateSigned:

рядок, Date

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

date:

рядок, Date

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

documents:

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

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

Period

Схема

startDate:

рядок, Date

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

endDate:

рядок, Date

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

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

Date

Дата/час у Формат дати: ISO 8601.

Value

Схема

amount:

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

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

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

currency:

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

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

valueAddedTaxIncluded:
 

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

Revision

Схема

date:

рядок, Date

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

changes:

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

Guarantee

Схема

amount:

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

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

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

currency:

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

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

Cancellation

Схема

id:

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

reason:

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

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

status:

рядок

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

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

active:

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

documents:

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

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

date:

рядок, Date

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

cancellationOf:

рядок

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

  • tender - закупівля

  • lot - лот

relatedLot:

рядок

ID пов’язаного Lot.

Feature

Схема

code:

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

Код нецінового критерію.

featureOf:

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

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

  • tenderer - учасник закупівлі

  • lot
  • item
relatedItem:

рядок

ID пов’язаного Item або Lot (якщо значення featureOf дорівнює item або lot).

title:

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

Назва критерію.

description:

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

Опис критерію.

enum:

список

Список значень:

value:

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

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

title:

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

Назва значення.

description:

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

Опис значення.

ProcuringEntity

Схема

name:

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

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

identifier:

Identifier

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

additionalIdentifiers:
 

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

address:

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

contactPoint:

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

kind:

рядок

Тип замовника

Можливі значення:
  • general - Замовник (загальний)

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

  • defense - Замовник, що здійснює закупівлі для потреб оборони

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

Отримання інформації про закупівлі

Отримати список всіх закупівель

GET /tenders HTTP/1.1
HTTP/1.1 200 OK

Сортування

Повернені закупівлі просортовані за датою модифікації.

Обмежити кількість Закупівель, що повертаються

Ви можете контролювати кількість data записів потоку даних закупівлі (розмір пакета) за допомогою параметра limit. Якщо він не вказаний, то дані будуть повернені пакетами по 100 елементів.

Пакети

Відповідь містить елемент next_page з такими властивостями:

offset:

Це параметр, який ви повинні додати до вихідного запиту, щоб отримати наступну сторінку.

path:

Це частина шляху URL-адреси з вихідними параметрами та доданим/заміненим offset параметром вище.

uri:

Повна версія URL-адреси для наступної сторінки.

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

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

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

Безпечна частота запитів на синхронізацію це раз в 5 хвилин.

Прочитати інформацію про окремі закупівлі

GET /tenders/64e93250be76435397e8c992ed4214d1 HTTP/1.1
HTTP/1.1 200 OK

Прочитати список документів закупівлі

GET /tenders/64e93250be76435397e8c992ed4214d1/documents HTTP/1.1
HTTP/1.1 200 OK

Приклад запиту:

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description modified",
      "title": "Notice.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:56.044656+03:00",
      "author": "tender_owner",
      "documentType": "technicalSpecifications",
      "id": "8c4f7355fed4463b98eb429237a2e6a5",
      "dateModified": "2017-07-25T17:36:56.044677+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "AwardCriteria.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=ysTqp33c7XMcniHmMMRwEbzHqlh7u0B1Xody%2F3MDOvWweLLYYutsDvREJ4lJcsnLkpv9HRVECjPJt2vGmv8GBw%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:56.140078+03:00",
      "id": "14f948894bcc4ddc9da4d2129b028116",
      "dateModified": "2017-07-25T17:36:56.140097+03:00"
    }
  ]
}

Прочитати документ закупівлі

Документ можна отримати за допомогою запиту url-адреси з відповіді на запит списку документів у data[*].url. URL для скачування безпечно надавати кінцевому користувачу.

Операції для організації-замовника закупівлі

Реєстрація Закупівлі

Реєстрація Закупівлі складається зі створення початкового запису та завантаження документації.

Cтворення початкового запису Закупівлі

При реєстрації закупівлі у базі даних потрібно надати всі основні деталі закупівлі (окрім двійкових документів) в тілі запиту.

POST /tenders HTTP/1.1

Отримана відповідь міститиме URL створеної закупівлі у заголовку відповіді Location та у data.id тіла.

HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1

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

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

POST /tenders/64e93250be76435397e8c992ed4214d1/documents HTTP/1.1

Отримана відповідь міститиме URL створеної закупівлі у заголовку відповіді Location та у data.id тіла.

HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/documents/6a7d13bd8ec449e08882aeb92180d938

Приклад запиту:

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 334
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=3SoLjvN%2Bubc3yUq7E%2F8z%2FT4nhwBCO%2BYejSIqF2ORk3btE1ug052zZDNQQpi4yyd1rj%2FPX09LiTVm%2BoTVYouoCg%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:56.044656+03:00",
    "id": "8c4f7355fed4463b98eb429237a2e6a5",
    "dateModified": "2017-07-25T17:36:56.044677+03:00"
  }
}

Зміна Закупівлі

Замовник закупівлі може змінити і початковий запис, і відповідну документацію.

Зміна початкового запису Закупівлі

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

PATCH /tenders/64e93250be76435397e8c992ed4214d1 HTTP/1.1
HTTP/1.1 200 OK

Зміна існуючих документів

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

PUT /tenders/64e93250be76435397e8c992ed4214d1/documents/6a7d13bd8ec449e08882aeb92180d938 HTTP/1.1
HTTP/1.1 200 OK

Приклад запиту:

PUT /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/14f948894bcc4ddc9da4d2129b028116?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 337
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=EC1QzFOXAe%2BawGOy%2FJR3YMrURSrxoUXQMtC%2BIIrTcHlCcL26Uj1%2BSbggyBg1H87VOEn9EBtEgBde0s8zxohcDQ%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",
    "author": "tender_owner",
    "title": "AwardCriteria-2.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=76AeflAK4BuZ734jGky7PBC9Tk3HAmi6UmSE1ElFiy2jLkYGA1%2FMdT7NIF7Hto%2F5PmrqAktZ%2FYovZYW6QptFBg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:56.140078+03:00",
    "id": "14f948894bcc4ddc9da4d2129b028116",
    "dateModified": "2017-07-25T17:36:56.181719+03:00"
  }
}

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

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

Операції для учасників закупівлі

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

POST /tenders/64e93250be76435397e8c992ed4214d1/bids/ HTTP/1.1
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607

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

POST /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607/documents HTTP/1.1
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607/documents/bd2e4c64179445cab93987fff3d58d23

Оновлення пропозиції

PATCH /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607 HTTP/1.1
HTTP/1.1 200 OK

Оновлення документів пропозиції

PUT /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607/documents/bd2e4c64179445cab93987fff3d58d23 HTTP/1.1
HTTP/1.1 200 Created

{
    "data": {
        ...
        "id": "ddd45992f1c545b9b03302205962265b",
        ...
        "url": ".../tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607/documents/bd2e4c64179445cab93987fff3d58d23?download=7d56370415484488bbb621b8cea6315b"
    }
}

Відміна пропозиції

DELETE /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607 HTTP/1.1
HTTP/1.1 200 OK

Список пропозицій

Після закінчення аукціону можна отримати повну інформацію про пропозиції та учасників, які їх подали:

GET /api/0/tenders/6f73bf0f7f734f459f7e37e3787054a0/bids HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{
    "data": [
        {
            "date": "2014-12-16T04:44:23.569815+02:00",
            "documents": [
                {
                    "dateModified": "2014-12-16T04:44:25.010930+02:00",
                    "datePublished": "2014-12-16T04:44:25.010885+02:00",
                    "format": "text/plain",
                    "id": "ff001412c60c4164a0f57101e4eaf8aa",
                    "title": "Proposal.pdf",
                    "url": "http://api-sandbox.openprocurement.org/api/0/tenders/6f73bf0f7f734f459f7e37e3787054a0/bids/f7fc1212f9f140bba5c4e3cd4f2b62d9/documents/ff001412c60c4164a0f57101e4eaf8aa?download=4f45bbd414104cd78faf620208efd824"
                }
            ],
            "id": "f7fc1212f9f140bba5c4e3cd4f2b62d9",
            "tenderers": [
                {
                    "address": {
                        "countryName": "Україна",
                        "locality": "м. Вінниця",
                        "postalCode": "21100",
                        "region": "м. Вінниця",
                        "streetAddress": "вул. Островського, 33"
                    },
                    "contactPoint": {
                        "email": "soleksuk@gmail.com",
                        "name": "Сергій Олексюк",
                        "telephone": "+380 (432) 21-69-30"
                    },
                    "identifier": {
                        "id": "13313462",
                        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
                        "scheme": "UA-EDR",
                        "uri": "http://sch10.edu.vn.ua/"
                    },
                    "name": "ДКП «Школяр»"
                }
            ],
            "value": {
                "amount": 475000.0,
                "currency": "UAH",
                "valueAddedTaxIncluded": true
            }
        },
        {
            "date": "2014-12-16T04:44:26.973605+02:00",
            "id": "25261352d2d042ff8639f65b68e95e9f",
            "tenderers": [
                {
                    "address": {
                        "countryName": "Україна",
                        "locality": "м. Вінниця",
                        "postalCode": "21018",
                        "region": "м. Вінниця",
                        "streetAddress": "вул. Юності, 30"
                    },
                    "contactPoint": {
                        "email": "alla.myhailova@i.ua",
                        "name": "Алла Михайлова",
                        "telephone": "+380 (432) 460-665"
                    },
                    "identifier": {
                        "id": "13306232",
                        "legalName": "Державне комунальне підприємство громадського харчування «Меридіан»",
                        "scheme": "UA-EDR",
                        "uri": "http://sch10.edu.vn.ua/"
                    },
                    "name": "ДКП «Меридіан»"
                }
            ],
            "value": {
                "amount": 480000.0,
                "currency": "UAH",
                "valueAddedTaxIncluded": true
            }
        },
        {
            "date": "2014-12-16T04:44:27.976478+02:00",
            "id": "7ec725815ef448a9b857129024395638",
            "tenderers": [
                {
                    "address": {
                        "countryName": "Україна",
                        "locality": "м. Вінниця",
                        "postalCode": "21018",
                        "region": "м. Вінниця",
                        "streetAddress": "вул. Юності, 30"
                    },
                    "contactPoint": {
                        "email": "alla.myhailova@i.ua",
                        "name": "Алла Михайлова",
                        "telephone": "+380 (432) 460-665"
                    },
                    "identifier": {
                        "id": "13306232",
                        "legalName": "Державне комунальне підприємство громадського харчування «Меридіан»",
                        "scheme": "UA-EDR",
                        "uri": "http://sch10.edu.vn.ua/"
                    },
                    "name": "ДКП «Меридіан2»"
                }
            ],
            "value": {
                "amount": 482000.0,
                "currency": "UAH",
                "valueAddedTaxIncluded": true
            }
        }
    ]
}

Вичитка пропозиції

Окрему пропозицію можна прочитати за її id:

GET /api/0/tenders/6f73bf0f7f734f459f7e37e3787054a0/bids/f7fc1212f9f140bba5c4e3cd4f2b62d9 HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{
    "data": {
        "date": "2014-12-16T04:44:23.569815+02:00",
        "documents": [
            {
                "dateModified": "2014-12-16T04:44:25.010930+02:00",
                "datePublished": "2014-12-16T04:44:25.010885+02:00",
                "format": "text/plain",
                "id": "ff001412c60c4164a0f57101e4eaf8aa",
                "title": "Proposal.pdf",
                "url": "http://api-sandbox.openprocurement.org/api/0/tenders/6f73bf0f7f734f459f7e37e3787054a0/bids/f7fc1212f9f140bba5c4e3cd4f2b62d9/documents/ff001412c60c4164a0f57101e4eaf8aa?download=4f45bbd414104cd78faf620208efd824"
            }
        ],
        "id": "f7fc1212f9f140bba5c4e3cd4f2b62d9",
        "tenderers": [
            {
                "address": {
                    "countryName": "Україна",
                    "locality": "м. Вінниця",
                    "postalCode": "21100",
                    "region": "м. Вінниця",
                    "streetAddress": "вул. Островського, 33"
                },
                "contactPoint": {
                    "email": "soleksuk@gmail.com",
                    "name": "Сергій Олексюк",
                    "telephone": "+380 (432) 21-69-30"
                },
                "identifier": {
                    "id": "13313462",
                    "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
                    "scheme": "UA-EDR",
                    "uri": "http://sch10.edu.vn.ua/"
                },
                "name": "ДКП «Школяр»"
            }
        ],
        "value": {
            "amount": 475000.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
        }
    }
}

Закупівлі за принципом найбільш економічно вигідної пропозиції

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

Більш детальну інформацію шукайте на сторінці Нецінові показники.

Feature (критерій) - структура даних, частина Tender. Закупівля Tender може мати багато критеріїв Feature, пов’язаних з нею. Критерій може бути пов’язаний з учасником, лотом чи окремим товаром/послугою, що закуповується. Критерії ідентифікуються за допомогою кодів, що є унікальними в межах тендера.

[
      {
          "code":"ee3e24bc17234a41bd3e3a04cc28e9c6",
          "featureOf":"tenderer",
          "title":"Термін оплати",
          "description":"Умови відстрочки платежу після поставки товару",
          "enum":[
              {
                  "value":0.15,
                  "title":"180 днів та більше"
              },
              {
                  "value":0.1,
                  "title":"90-179 днів",
              },
              {
                  "value":0.05,
                  "title":"30-89 днів"
              },
              {
                  "value":0,
                  "title":"Менше 30 днів"
              }
          ]
      },
      {
          "code":"48cfd91612c04125ab406374d7cc8d93",
          "featureOf":"item",
          "relatedItem":"edd0032574bf4402877ad5f362df225a",
          "title":"Сорт",
          "description":"Сорт продукції",
          "enum":[
              {
                  "value":0.05,
                  "title":"Вищий"
              },
              {
                  "value":0.01,
                  "title":"Перший",
              },
              {
                  "value":0,
                  "title":"Другий"
              }
          ]
      }
]

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

[
         {
             "code":"ee3e24bc17234a41bd3e3a04cc28e9c6",
             "value":0.1
         },
         {
             "code":"48cfd91612c04125ab406374d7cc8d93",
             "value":0.05
         }
]

Оголошення закупівлі з неціновими критеріями

Features (критерії) можуть бути встановлені для Tender майже тим самим способом, що і Items - за допомогою POST запиту.

POST /tenders HTTP/1.1

{"data": {
  ...
  "features": [...],
  ...
}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1

Зміна критеріїв

Якщо є необхідність змінити критерій, можна надіслати PATCH запит, що замінить Tender.features новим набором:

PATCH /tenders HTTP/1.1

{"data": {
  "features": [...]
}
HTTP/1.1 200 OK

Видалення критеріїв

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

PATCH /tenders HTTP/1.1

{"data": {
  "features": []
}
HTTP/1.1 200 OK

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

Те саме стосується і цінових пропозицій Bid - Параметри пропозиції можуть бути створені POST запитом, а потім модифіковані PATCH запитами (більше в Операції для учасників закупівлі).

POST /tenders/64e93250be76435397e8c992ed4214d1/bids HTTP/1.1

{"data": {
  ...
  "parameters": [...],
  ...
}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/bid/4879d3f8ee2443169b5fbbc9f89fa607

Кваліфікація у закупівлі з неціновими критеріями

Під час аукціону учасник може подавати свою цінову пропозицію і бачити приведену ціну своєї пропозиції проти приведених цін пропозицій інших учасників. Рангування в аукціоні відбувається за приведеними цінами, в яких береться до уваги і цінова пропозиція, і інші нецінові критерії (Bid.parameters).

Багатолотові закупівлі

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

Більш детальну інформацію шукайте на сторінці Багатолотові закупівлі.

{
  "lots": [
    {
      "id": "7d774fbf1e86420484c7d1a005cc283f",
      "title": "Lot #1: Kyiv stationey",
      "description": "Items for Kyiv office",
      "value": {"currency": "UAH", "amount": 8000.0, "valueAddedTaxIncluded": true},
      "minimalStep": {"currency": "UAH", "amount": 30.0, "valueAddedTaxIncluded": true},
      "status": "active"
    }, {
      "id": "563ef5d999f34d36a5a0e4e4d91d7be1",
      "title": "Lot #1: Lviv stationey",
      "description": "Items for Lviv office",
      "value": {"currency": "UAH", "amount": 9000.0, "valueAddedTaxIncluded": true},
      "minimalStep": {"currency": "UAH", "amount": 35.0, "valueAddedTaxIncluded": true},
      "status": "active"
    }
  ]
}

Багатолотова закупівля може мати документацію для процедури в цілому, окремо для лота та окремо для елемента.

{
  "documents": [
    {
      "format": "application/msword",
      "url": "...",
      "title": "kyiv-specs.doc",
      "datePublished": "2015-10-27T14:01:16.155803+02:00",
      "dateModified": "2015-10-27T14:01:16.155844+02:00",
      "id": "9491647572294c2bb20bf28f16d14dd8",
      "documentOf": "lot",
      "relateLot": "7d774fbf1e86420484c7d1a005cc283f"
    }
  ]
}

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

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

{
  "lotValues": [
    {
      "value": {"currency": "UAH", "amount": 7750.0, "valueAddedTaxIncluded": true},
      "reatedLot": "7d774fbf1e86420484c7d1a005cc283f",
      "date": "2015-11-01T12:43:12.482645+02:00"
    }, {
      "value": {"currency": "UAH", "amount": 8125.0, "valueAddedTaxIncluded": true},
      "reatedLot": "563ef5d999f34d36a5a0e4e4d91d7be1",
      "date": "2015-11-01T12:43:12.482645+02:00"
    }
  ],
  "..."
}

Кожен документ, вкладений до Bid, може стосуватись процедури в цілому, окремого лота або окремого елемента.

Кожен лот має окремий аукціон та процес визначення переможця.

Кожен лот можна скасувати окремо, не впливаючи на інші лоти.

Оголошення багатолотової закупівлі

Багатолотова закупівля створюється в декілька кроків. Спочатку потрібно створити закупівлю з декількома елементами.

POST /tenders HTTP/1.1

{"data": {
   "items":[
      {"description": "", ... },
      {"description": "", ... }
     ],
   ...
  }}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1

{"data": {
  "items":[
      {"id": "c25264295db0463ba533fd380756cff1", "description": "", ... },
      {"id": "f94aa51e2af944e08e02a4063121f93c", "description": "", ... }
    ],
  ...
  },
  ...
}

Потім потрібно додати всі лоти окремими запитами.

POST /tenders/64e93250be76435397e8c992ed4214d1/lots HTTP/1.1

{"data": {..}}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/lots/7d774fbf1e86420484c7d1a005cc283f

Другий лот:

POST /tenders/64e93250be76435397e8c992ed4214d1/lots HTTP/1.1

{"data": {..}}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/lots/563ef5d999f34d36a5a0e4e4d91d7be1

Елементи повинні бути розподілені по лотах.

PATCH /tenders/64e93250be76435397e8c992ed4214d1 HTTP/1.1

{"data": {
  "items":[
      {"id": "c25264295db0463ba533fd380756cff1", "relatedLot": "7d774fbf1e86420484c7d1a005cc283f"},
      {"id": "f94aa51e2af944e08e02a4063121f93c", "relatedLot": "563ef5d999f34d36a5a0e4e4d91d7be1"}
    ],
  ...
  },
  ...
}

Подання пропозицій у багатолотовій закупівлі

Цінова пропозиція повинна мати властивість lotValues, що складається з декількох об’єктів LotValue. Кожен з них повинен посилатись на лот, до якого подана пропозиція, через властивість relatedLot.

POST /tenders/64e93250be76435397e8c992ed4214d1/bids HTTP/1.1

{"data": {
  "lotValues": [
    {
      "value": {"currency": "UAH", "amount": 7750.0, "valueAddedTaxIncluded": true},
      "reatedLot": "7d774fbf1e86420484c7d1a005cc283f",
      "date": "2015-11-01T12:43:12.482645+02:00"
    }, {
      "value": {"currency": "UAH", "amount": 8125.0, "valueAddedTaxIncluded": true},
      "reatedLot": "563ef5d999f34d36a5a0e4e4d91d7be1",
      "date": "2015-11-01T12:43:12.482645+02:00"
    }
  ],
  ...
}}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/bids/ae836da01ef749e494427dc591d36062

URL-адреси для участі в аукціоні будуть доступні для кожного з поданих лотів.

Кваліфікація у багатолотових закупівлях

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

GET /tenders/64e93250be76435397e8c992ed4214d1/awards HTTP/1.1
HTTP/1.1 200 OK

{"data": [
    {
        "status": "pending",
        "bid_id": "ae836da01ef749e494427dc591d36062",
        "value": {"currency": "UAH", "amount": 7750.0, "valueAddedTaxIncluded": true},
        "id": "c3179dd8609340a7ba9e5fe91762f564",
        "lotId": "7d774fbf1e86420484c7d1a005cc283f",
        "..."
    }, {
        "status": "pending",
        "bid_id": "ae836da01ef749e494427dc591d36062",
        "value": {"currency": "UAH", "amount": 8125.0, "valueAddedTaxIncluded": true},
        "id": "c99e30174b10418bac026a77d41288d7",
        "lotId": "563ef5d999f34d36a5a0e4e4d91d7be1",
        "..."
    }
  ]
}

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

Операції кваліфікації

Коли закінчується аукціон, розпочинається процес оцінки. Закупівля отримує статус active.qualification. Після того, як результати подаються у Центральну базу даних, реєструється рішення про перемогу учасника аукціону.

Перегляд результатів оцінки

Результати аукціону, що оцінюються, можна дізнатись запитом на отримання списків усіх доступних винагород:

GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

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

Визначення переможця (винагорода) має статус pending, якщо замовнику потрібно перевірити документи пов’язані з пропозицією кандидата.

Дискваліфікація

Протокол рішення Кваліфікаційного комітету повинен бути завантажений у вигляді документа до рішення. Пізніше його статус повинен бути змінений або на active (якщо його прийнято), або на unsuccessful (якщо відмовлено).

POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/documents?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 337
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=XeHObf%2F36dBstK6OOXGbrtZgI7VnysX79jIYHJFHxhq1sksc3cMVgcCfFY5nt4wR3V1Mn8LLhGuKaqZaxvpHDQ%3D%3D",
    "title": "Unsuccessful_Reason.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/documents/0ac19aedb5d2407598d91aa963d6a027

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Unsuccessful_Reason.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=PbVLwL3AMNy7I%2FnhEANHhLSNoOKKay2pvYsHnbBXD%252BBZM60nIqXTk3UDDN6TsctsZ2k0TtSk0XEwlEoFdbKRAQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:52.098854+03:00",
    "id": "0ac19aedb5d2407598d91aa963d6a027",
    "dateModified": "2017-07-25T17:36:52.098871+03:00"
  }
}

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

PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "unsuccessful"
  }
}


200 OK
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/4983c533470d473aa5769ba399849cb0

{
  "data": {
    "status": "unsuccessful",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "Unsuccessful_Reason.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=PbVLwL3AMNy7I%2FnhEANHhLSNoOKKay2pvYsHnbBXD%252BBZM60nIqXTk3UDDN6TsctsZ2k0TtSk0XEwlEoFdbKRAQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:52.098854+03:00",
        "id": "0ac19aedb5d2407598d91aa963d6a027",
        "dateModified": "2017-07-25T17:36:52.098871+03:00"
      }
    ],
    "complaintPeriod": {
      "startDate": "2017-07-25T17:36:51.988435+03:00",
      "endDate": "2017-07-27T17:36:52.185900+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "bid_id": "ee786a6e8a7d470196a751273f064e78",
    "value": {
      "currency": "UAH",
      "amount": 450.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-07-25T17:36:52.191749+03:00",
    "id": "aec061c3b3234a9981a292ae161d2ece"
  }
}

Зверніть увагу, що після відмови визначеному переможцю наступна пропозиція у просортованому за ціновими пропозиціями списку стає претендентом на перемогу. Для зручності, ви можете використати заголовок Location з попередньої відповіді, що вказує на “pending” стан оцінки, що ще триває.

Винагорода (визначення переможця з ціллю підписання договору)

Завантаження протоколу:

POST /tenders/64e93250be76435397e8c992ed4214d1/awards/{}/documents HTTP/1.1

Підтвердження визначення переможця:

PATCH /tenders/64e93250be76435397e8c992ed4214d1/awards/{} HTTP/1.1

{
    "data":{
        "status": "active"
    }
}
HTTP/1.1 200 OK

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

Скасування активної винагороди

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

Коли стадія Визначення переможця активна

GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/4983c533470d473aa5769ba399849cb0 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": {
    "status": "active",
    "complaintPeriod": {
      "startDate": "2017-07-25T17:36:52.186270+03:00",
      "endDate": "2017-07-27T17:36:52.318837+03:00"
    },
    "suppliers": [
      {
        "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": "м. Київ"
        }
      }
    ],
    "bid_id": "39481e7f97894915832b3b882afdade4",
    "value": {
      "currency": "UAH",
      "amount": 469.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-07-25T17:36:52.324371+03:00",
    "id": "4983c533470d473aa5769ba399849cb0"
  }
}

Є необхідність її скасувати

PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/4983c533470d473aa5769ba399849cb0?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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


200 OK
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/3ff474e4f3a843fba101c561e5cffb14

{
  "data": {
    "status": "cancelled",
    "complaintPeriod": {
      "startDate": "2017-07-25T17:36:52.186270+03:00",
      "endDate": "2017-07-25T17:36:52.456668+03:00"
    },
    "suppliers": [
      {
        "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": "м. Київ"
        }
      }
    ],
    "bid_id": "39481e7f97894915832b3b882afdade4",
    "value": {
      "currency": "UAH",
      "amount": 469.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-07-25T17:36:52.463690+03:00",
    "id": "4983c533470d473aa5769ba399849cb0"
  }
}

Зверніть увагу, що повернуто заголовок Location, який допомогає в пошуку “свіжої” винагороди, яка, швидше за все, і є предметом дискваліфікації:

POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/3ff474e4f3a843fba101c561e5cffb14/documents?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 341
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/6bd74e04745d4eeb99b4806f1dae82c9?KeyID=1a1ebb61&Signature=LAgDr%2B6y5LMCNb6bB7UPlkjL7JhiesqZ5QFPxZCHsPpJX5xpFFyc%2FYBKfYPhiDlHGcR6l9ObYpar4lpbkJ%2BBDw%3D%3D",
    "title": "Cancellation_Reason.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/3ff474e4f3a843fba101c561e5cffb14/documents/6eec6788a5cb494589a9f3cab1661d99

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Cancellation_Reason.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/6bd74e04745d4eeb99b4806f1dae82c9?KeyID=1a1ebb61&Signature=qtr%252BRVTvbXo%2F%252BEsVgsfE%2Ff385WPW6pMjiTja4cwoCt2koVF19VA6%2FiSzHzcY5JvG7UmUl04wQa%2FBZSAmUVTcBw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:52.594571+03:00",
    "id": "6eec6788a5cb494589a9f3cab1661d99",
    "dateModified": "2017-07-25T17:36:52.594591+03:00"
  }
}
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/3ff474e4f3a843fba101c561e5cffb14?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "unsuccessful"
  }
}


200 OK
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/29402437b6c54e97a49bf9179e11fe08

{
  "data": {
    "status": "unsuccessful",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "Cancellation_Reason.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/6bd74e04745d4eeb99b4806f1dae82c9?KeyID=1a1ebb61&Signature=qtr%252BRVTvbXo%2F%252BEsVgsfE%2Ff385WPW6pMjiTja4cwoCt2koVF19VA6%2FiSzHzcY5JvG7UmUl04wQa%2FBZSAmUVTcBw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:52.594571+03:00",
        "id": "6eec6788a5cb494589a9f3cab1661d99",
        "dateModified": "2017-07-25T17:36:52.594591+03:00"
      }
    ],
    "complaintPeriod": {
      "startDate": "2017-07-25T17:36:52.457048+03:00",
      "endDate": "2017-07-27T17:36:52.718103+03:00"
    },
    "suppliers": [
      {
        "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": "м. Київ"
        }
      }
    ],
    "bid_id": "39481e7f97894915832b3b882afdade4",
    "value": {
      "currency": "UAH",
      "amount": 469.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-07-25T17:36:52.726245+03:00",
    "id": "3ff474e4f3a843fba101c561e5cffb14"
  }
}

У випадку, якщо є інша пропозиція для кваліфікації, у відповіді буде заголовок Location, що вказуватиме на відповідну винагороду.

Вплив задовільненої скарги

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

Рішення кваліфікаційної комісії замовника про дискваліфікацію можна відмінити у таких випадках:

  • подана вимога на цю дискваліфікацію (статус вимоги claim);

  • надана відповідь по вимозі (статус вимоги answered);

  • скарга очікує розгляду органом оскарження (статус скарги pending);

  • скарга задовільнена, тобто є позитивне рішення органу оскарження (статус скарги resolved).

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

GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "status": "unsuccessful",
      "documents": [
        {
          "hash": "md5:00000000000000000000000000000000",
          "author": "tender_owner",
          "title": "Unsuccessful_Reason.pdf",
          "url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=PbVLwL3AMNy7I%2FnhEANHhLSNoOKKay2pvYsHnbBXD%252BBZM60nIqXTk3UDDN6TsctsZ2k0TtSk0XEwlEoFdbKRAQ%253D%253D",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2017-07-25T17:36:52.098854+03:00",
          "id": "0ac19aedb5d2407598d91aa963d6a027",
          "dateModified": "2017-07-25T17:36:52.098871+03:00"
        }
      ],
      "complaintPeriod": {
        "startDate": "2017-07-25T17:36:51.988435+03:00",
        "endDate": "2017-07-27T17:36:52.185900+03:00"
      },
      "suppliers": [
        {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137256",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        }
      ],
      "bid_id": "ee786a6e8a7d470196a751273f064e78",
      "value": {
        "currency": "UAH",
        "amount": 450.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2017-07-25T17:36:52.191749+03:00",
      "complaints": [
        {
          "status": "resolved",
          "documents": [
            {
              "hash": "md5:00000000000000000000000000000000",
              "author": "complaint_owner",
              "title": "Complaint_Attachement.pdf",
              "url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
              "format": "application/pdf",
              "documentOf": "tender",
              "datePublished": "2017-07-25T17:36:53.000914+03:00",
              "id": "96ad4bc79c704f6eb094b83bf2ca817a",
              "dateModified": "2017-07-25T17:36:53.000946+03:00"
            }
          ],
          "description": "complaint description",
          "author": {
            "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": "м. Вінниця"
            }
          },
          "resolutionType": "resolved",
          "type": "claim",
          "title": "complaint title",
          "satisfied": true,
          "tendererAction": "Виправлено неконкурентні умови",
          "dateAnswered": "2017-07-25T17:36:53.465653+03:00",
          "tendererActionDate": "2017-07-25T17:36:53.465668+03:00",
          "dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
          "complaintID": "UA-2017-07-25-000001.5",
          "date": "2017-07-25T17:36:53.605801+03:00",
          "resolution": "Виправлено неконкурентні умови",
          "id": "fc1eef6ef50d4656b981aae8bb181467"
        },
        {
          "status": "resolved",
          "description": "complaint description",
          "title": "complaint title",
          "resolutionType": "resolved",
          "type": "claim",
          "author": {
            "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": "м. Вінниця"
            }
          },
          "satisfied": false,
          "dateAnswered": "2017-07-25T17:36:53.730015+03:00",
          "dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
          "complaintID": "UA-2017-07-25-000001.6",
          "date": "2017-07-25T17:36:53.871088+03:00",
          "resolution": "Виправлено неконкурентні умови",
          "id": "d9f8daa198f44112b4ec51a00598d823"
        },
        {
          "status": "resolved",
          "description": "complaint description",
          "title": "complaint title",
          "resolutionType": "resolved",
          "type": "claim",
          "author": {
            "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": "м. Вінниця"
            }
          },
          "satisfied": false,
          "dateAnswered": "2017-07-25T17:36:54.133250+03:00",
          "dateSubmitted": "2017-07-25T17:36:53.993166+03:00",
          "complaintID": "UA-2017-07-25-000001.7",
          "date": "2017-07-25T17:36:54.279826+03:00",
          "resolution": "Виправлено неконкурентні умови",
          "id": "52fd0b0be7a84115824d49a5f5b915a2"
        },
        {
          "status": "resolved",
          "description": "complaint description",
          "title": "complaint title",
          "resolutionType": "resolved",
          "type": "claim",
          "author": {
            "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": "м. Вінниця"
            }
          },
          "satisfied": false,
          "dateAnswered": "2017-07-25T17:36:54.570422+03:00",
          "dateSubmitted": "2017-07-25T17:36:54.418211+03:00",
          "complaintID": "UA-2017-07-25-000001.8",
          "date": "2017-07-25T17:36:54.762393+03:00",
          "resolution": "Виправлено неконкурентні умови",
          "id": "2d1216c07c35480ea9dbc1d5e537c84b"
        }
      ],
      "id": "aec061c3b3234a9981a292ae161d2ece"
    },
    {
      "status": "cancelled",
      "complaintPeriod": {
        "startDate": "2017-07-25T17:36:52.186270+03:00",
        "endDate": "2017-07-25T17:36:52.456668+03:00"
      },
      "suppliers": [
        {
          "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": "м. Київ"
          }
        }
      ],
      "bid_id": "39481e7f97894915832b3b882afdade4",
      "value": {
        "currency": "UAH",
        "amount": 469.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2017-07-25T17:36:52.463690+03:00",
      "id": "4983c533470d473aa5769ba399849cb0"
    },
    {
      "status": "unsuccessful",
      "documents": [
        {
          "hash": "md5:00000000000000000000000000000000",
          "author": "tender_owner",
          "title": "Cancellation_Reason.pdf",
          "url": "http://public.docs-sandbox.openprocurement.org/get/6bd74e04745d4eeb99b4806f1dae82c9?KeyID=1a1ebb61&Signature=qtr%252BRVTvbXo%2F%252BEsVgsfE%2Ff385WPW6pMjiTja4cwoCt2koVF19VA6%2FiSzHzcY5JvG7UmUl04wQa%2FBZSAmUVTcBw%253D%253D",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2017-07-25T17:36:52.594571+03:00",
          "id": "6eec6788a5cb494589a9f3cab1661d99",
          "dateModified": "2017-07-25T17:36:52.594591+03:00"
        }
      ],
      "complaintPeriod": {
        "startDate": "2017-07-25T17:36:52.457048+03:00",
        "endDate": "2017-07-27T17:36:52.718103+03:00"
      },
      "suppliers": [
        {
          "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": "м. Київ"
          }
        }
      ],
      "bid_id": "39481e7f97894915832b3b882afdade4",
      "value": {
        "currency": "UAH",
        "amount": 469.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2017-07-25T17:36:52.726245+03:00",
      "id": "3ff474e4f3a843fba101c561e5cffb14"
    },
    {
      "status": "pending",
      "complaintPeriod": {
        "startDate": "2017-07-25T17:36:52.718479+03:00"
      },
      "suppliers": [
        {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137256",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        }
      ],
      "bid_id": "784c395f01c84791abb1f43f6360f9b0",
      "value": {
        "currency": "UAH",
        "amount": 475.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2017-07-25T17:36:52.718469+03:00",
      "id": "29402437b6c54e97a49bf9179e11fe08"
    }
  ]
}
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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


200 OK
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/4bf169f2d26d4e0698cf83c1d8f47c8b

{
  "data": {
    "status": "cancelled",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "Unsuccessful_Reason.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=PbVLwL3AMNy7I%2FnhEANHhLSNoOKKay2pvYsHnbBXD%252BBZM60nIqXTk3UDDN6TsctsZ2k0TtSk0XEwlEoFdbKRAQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:52.098854+03:00",
        "id": "0ac19aedb5d2407598d91aa963d6a027",
        "dateModified": "2017-07-25T17:36:52.098871+03:00"
      }
    ],
    "complaintPeriod": {
      "startDate": "2017-07-25T17:36:51.988435+03:00",
      "endDate": "2017-07-25T17:36:55.073733+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "bid_id": "ee786a6e8a7d470196a751273f064e78",
    "value": {
      "currency": "UAH",
      "amount": 450.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-07-25T17:36:55.083321+03:00",
    "complaints": [
      {
        "status": "resolved",
        "documents": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "author": "complaint_owner",
            "title": "Complaint_Attachement.pdf",
            "url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-07-25T17:36:53.000914+03:00",
            "id": "96ad4bc79c704f6eb094b83bf2ca817a",
            "dateModified": "2017-07-25T17:36:53.000946+03:00"
          }
        ],
        "description": "complaint description",
        "author": {
          "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": "м. Вінниця"
          }
        },
        "resolutionType": "resolved",
        "type": "claim",
        "title": "complaint title",
        "satisfied": true,
        "tendererAction": "Виправлено неконкурентні умови",
        "dateAnswered": "2017-07-25T17:36:53.465653+03:00",
        "tendererActionDate": "2017-07-25T17:36:53.465668+03:00",
        "dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
        "complaintID": "UA-2017-07-25-000001.5",
        "date": "2017-07-25T17:36:53.605801+03:00",
        "resolution": "Виправлено неконкурентні умови",
        "id": "fc1eef6ef50d4656b981aae8bb181467"
      },
      {
        "status": "resolved",
        "description": "complaint description",
        "title": "complaint title",
        "resolutionType": "resolved",
        "type": "claim",
        "author": {
          "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": "м. Вінниця"
          }
        },
        "satisfied": false,
        "dateAnswered": "2017-07-25T17:36:53.730015+03:00",
        "dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
        "complaintID": "UA-2017-07-25-000001.6",
        "date": "2017-07-25T17:36:53.871088+03:00",
        "resolution": "Виправлено неконкурентні умови",
        "id": "d9f8daa198f44112b4ec51a00598d823"
      },
      {
        "status": "resolved",
        "description": "complaint description",
        "title": "complaint title",
        "resolutionType": "resolved",
        "type": "claim",
        "author": {
          "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": "м. Вінниця"
          }
        },
        "satisfied": false,
        "dateAnswered": "2017-07-25T17:36:54.133250+03:00",
        "dateSubmitted": "2017-07-25T17:36:53.993166+03:00",
        "complaintID": "UA-2017-07-25-000001.7",
        "date": "2017-07-25T17:36:54.279826+03:00",
        "resolution": "Виправлено неконкурентні умови",
        "id": "52fd0b0be7a84115824d49a5f5b915a2"
      },
      {
        "status": "resolved",
        "description": "complaint description",
        "title": "complaint title",
        "resolutionType": "resolved",
        "type": "claim",
        "author": {
          "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": "м. Вінниця"
          }
        },
        "satisfied": false,
        "dateAnswered": "2017-07-25T17:36:54.570422+03:00",
        "dateSubmitted": "2017-07-25T17:36:54.418211+03:00",
        "complaintID": "UA-2017-07-25-000001.8",
        "date": "2017-07-25T17:36:54.762393+03:00",
        "resolution": "Виправлено неконкурентні умови",
        "id": "2d1216c07c35480ea9dbc1d5e537c84b"
      }
    ],
    "id": "aec061c3b3234a9981a292ae161d2ece"
  }
}
GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "status": "cancelled",
      "documents": [
        {
          "hash": "md5:00000000000000000000000000000000",
          "author": "tender_owner",
          "title": "Unsuccessful_Reason.pdf",
          "url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=PbVLwL3AMNy7I%2FnhEANHhLSNoOKKay2pvYsHnbBXD%252BBZM60nIqXTk3UDDN6TsctsZ2k0TtSk0XEwlEoFdbKRAQ%253D%253D",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2017-07-25T17:36:52.098854+03:00",
          "id": "0ac19aedb5d2407598d91aa963d6a027",
          "dateModified": "2017-07-25T17:36:52.098871+03:00"
        }
      ],
      "complaintPeriod": {
        "startDate": "2017-07-25T17:36:51.988435+03:00",
        "endDate": "2017-07-25T17:36:55.073733+03:00"
      },
      "suppliers": [
        {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137256",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        }
      ],
      "bid_id": "ee786a6e8a7d470196a751273f064e78",
      "value": {
        "currency": "UAH",
        "amount": 450.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2017-07-25T17:36:55.083321+03:00",
      "complaints": [
        {
          "status": "resolved",
          "documents": [
            {
              "hash": "md5:00000000000000000000000000000000",
              "author": "complaint_owner",
              "title": "Complaint_Attachement.pdf",
              "url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
              "format": "application/pdf",
              "documentOf": "tender",
              "datePublished": "2017-07-25T17:36:53.000914+03:00",
              "id": "96ad4bc79c704f6eb094b83bf2ca817a",
              "dateModified": "2017-07-25T17:36:53.000946+03:00"
            }
          ],
          "description": "complaint description",
          "author": {
            "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": "м. Вінниця"
            }
          },
          "resolutionType": "resolved",
          "type": "claim",
          "title": "complaint title",
          "satisfied": true,
          "tendererAction": "Виправлено неконкурентні умови",
          "dateAnswered": "2017-07-25T17:36:53.465653+03:00",
          "tendererActionDate": "2017-07-25T17:36:53.465668+03:00",
          "dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
          "complaintID": "UA-2017-07-25-000001.5",
          "date": "2017-07-25T17:36:53.605801+03:00",
          "resolution": "Виправлено неконкурентні умови",
          "id": "fc1eef6ef50d4656b981aae8bb181467"
        },
        {
          "status": "resolved",
          "description": "complaint description",
          "title": "complaint title",
          "resolutionType": "resolved",
          "type": "claim",
          "author": {
            "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": "м. Вінниця"
            }
          },
          "satisfied": false,
          "dateAnswered": "2017-07-25T17:36:53.730015+03:00",
          "dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
          "complaintID": "UA-2017-07-25-000001.6",
          "date": "2017-07-25T17:36:53.871088+03:00",
          "resolution": "Виправлено неконкурентні умови",
          "id": "d9f8daa198f44112b4ec51a00598d823"
        },
        {
          "status": "resolved",
          "description": "complaint description",
          "title": "complaint title",
          "resolutionType": "resolved",
          "type": "claim",
          "author": {
            "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": "м. Вінниця"
            }
          },
          "satisfied": false,
          "dateAnswered": "2017-07-25T17:36:54.133250+03:00",
          "dateSubmitted": "2017-07-25T17:36:53.993166+03:00",
          "complaintID": "UA-2017-07-25-000001.7",
          "date": "2017-07-25T17:36:54.279826+03:00",
          "resolution": "Виправлено неконкурентні умови",
          "id": "52fd0b0be7a84115824d49a5f5b915a2"
        },
        {
          "status": "resolved",
          "description": "complaint description",
          "title": "complaint title",
          "resolutionType": "resolved",
          "type": "claim",
          "author": {
            "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": "м. Вінниця"
            }
          },
          "satisfied": false,
          "dateAnswered": "2017-07-25T17:36:54.570422+03:00",
          "dateSubmitted": "2017-07-25T17:36:54.418211+03:00",
          "complaintID": "UA-2017-07-25-000001.8",
          "date": "2017-07-25T17:36:54.762393+03:00",
          "resolution": "Виправлено неконкурентні умови",
          "id": "2d1216c07c35480ea9dbc1d5e537c84b"
        }
      ],
      "id": "aec061c3b3234a9981a292ae161d2ece"
    },
    {
      "status": "cancelled",
      "complaintPeriod": {
        "startDate": "2017-07-25T17:36:52.186270+03:00",
        "endDate": "2017-07-25T17:36:55.073733+03:00"
      },
      "suppliers": [
        {
          "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": "м. Київ"
          }
        }
      ],
      "bid_id": "39481e7f97894915832b3b882afdade4",
      "value": {
        "currency": "UAH",
        "amount": 469.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2017-07-25T17:36:52.463690+03:00",
      "id": "4983c533470d473aa5769ba399849cb0"
    },
    {
      "status": "cancelled",
      "documents": [
        {
          "hash": "md5:00000000000000000000000000000000",
          "author": "tender_owner",
          "title": "Cancellation_Reason.pdf",
          "url": "http://public.docs-sandbox.openprocurement.org/get/6bd74e04745d4eeb99b4806f1dae82c9?KeyID=1a1ebb61&Signature=qtr%252BRVTvbXo%2F%252BEsVgsfE%2Ff385WPW6pMjiTja4cwoCt2koVF19VA6%2FiSzHzcY5JvG7UmUl04wQa%2FBZSAmUVTcBw%253D%253D",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2017-07-25T17:36:52.594571+03:00",
          "id": "6eec6788a5cb494589a9f3cab1661d99",
          "dateModified": "2017-07-25T17:36:52.594591+03:00"
        }
      ],
      "complaintPeriod": {
        "startDate": "2017-07-25T17:36:52.457048+03:00",
        "endDate": "2017-07-25T17:36:55.073733+03:00"
      },
      "suppliers": [
        {
          "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": "м. Київ"
          }
        }
      ],
      "bid_id": "39481e7f97894915832b3b882afdade4",
      "value": {
        "currency": "UAH",
        "amount": 469.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2017-07-25T17:36:55.083321+03:00",
      "id": "3ff474e4f3a843fba101c561e5cffb14"
    },
    {
      "status": "cancelled",
      "complaintPeriod": {
        "startDate": "2017-07-25T17:36:52.718479+03:00",
        "endDate": "2017-07-25T17:36:55.073733+03:00"
      },
      "suppliers": [
        {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137256",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        }
      ],
      "bid_id": "784c395f01c84791abb1f43f6360f9b0",
      "value": {
        "currency": "UAH",
        "amount": 475.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2017-07-25T17:36:55.083321+03:00",
      "id": "29402437b6c54e97a49bf9179e11fe08"
    },
    {
      "status": "pending",
      "complaintPeriod": {
        "startDate": "2017-07-25T17:36:55.074225+03:00"
      },
      "suppliers": [
        {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137256",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        }
      ],
      "bid_id": "ee786a6e8a7d470196a751273f064e78",
      "value": {
        "currency": "UAH",
        "amount": 450.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2017-07-25T17:36:55.074214+03:00",
      "id": "4bf169f2d26d4e0698cf83c1d8f47c8b"
    }
  ]
}

Питання замовнику

Як подати питання

Будь-хто (але не анонімно) може задати питання:

POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.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.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions/e2e6900f65434252a75741613fe0703b

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

Як прочитати питання

До закінчення аукціону особистість автора питання не розкривається:

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "description": "Просимо додати таблицю потрібної калорійності харчування",
      "dateAnswered": "2017-07-25T17:36:56.273608+03:00",
      "title": "Калорійність",
      "date": "2017-07-25T17:36:56.229819+03:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "id": "e2e6900f65434252a75741613fe0703b",
      "questionOf": "tender"
    }
  ]
}

Відповіді

Як надати відповідь

Замовник закупівлі може відповісти на питання:

PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions/e2e6900f65434252a75741613fe0703b?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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


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

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "dateAnswered": "2017-07-25T17:36:56.273608+03:00",
    "title": "Калорійність",
    "date": "2017-07-25T17:36:56.229819+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "e2e6900f65434252a75741613fe0703b",
    "questionOf": "tender"
  }
}

Схема роботи оскаржень

Більш детальну інформацію шукайте на сторінці Оскарження.

Вимоги/Скарги на умови закупівлі

Отримання інформації про звернення/скарги

Отримання інформації про вимоги/скарги на умови закупівлі

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

GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints HTTP/1.0
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "status": "claim",
      "documents": [
        {
          "hash": "md5:00000000000000000000000000000000",
          "author": "complaint_owner",
          "title": "Complaint_Attachement.pdf",
          "url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2017-07-25T17:36:50.767640+03:00",
          "id": "8ebcc96606e941bc89d601c3d11270d1",
          "dateModified": "2017-07-25T17:36:50.767661+03:00"
        }
      ],
      "description": "complaint description",
      "title": "complaint title",
      "dateSubmitted": "2017-07-25T17:36:50.813612+03:00",
      "complaintID": "UA-2017-07-25-000001.1",
      "date": "2017-07-25T17:36:50.815647+03:00",
      "type": "claim",
      "id": "3b36519c7e994663a75935a29c0ddbcf"
    },
    {
      "status": "claim",
      "description": "complaint description",
      "title": "complaint title",
      "dateSubmitted": "2017-07-25T17:36:50.854956+03:00",
      "complaintID": "UA-2017-07-25-000001.2",
      "date": "2017-07-25T17:36:50.854942+03:00",
      "type": "claim",
      "id": "3382f6727fc94edc947ff016fcedad11"
    }
  ]
}

Або перевірити окрему скаргу чи вимогу:

GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf HTTP/1.0
Host: api-sandbox.openprocurement.org


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

{
  "data": {
    "status": "claim",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:50.767640+03:00",
        "id": "8ebcc96606e941bc89d601c3d11270d1",
        "dateModified": "2017-07-25T17:36:50.767661+03:00"
      }
    ],
    "description": "complaint description",
    "title": "complaint title",
    "dateSubmitted": "2017-07-25T17:36:50.813612+03:00",
    "complaintID": "UA-2017-07-25-000001.1",
    "date": "2017-07-25T17:36:50.815647+03:00",
    "type": "claim",
    "id": "3b36519c7e994663a75935a29c0ddbcf"
  }
}

Подання вимоги

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

Подання вимоги про виправлення умов закупівлі (з документами)

Спочатку створимо вимогу:

POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 775
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "title": "complaint title",
    "description": "complaint description",
    "author": {
      "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.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf

{
  "access": {
    "token": "6c52536fdb1b4e0a83ce6b486d2cfd0c"
  },
  "data": {
    "status": "draft",
    "description": "complaint description",
    "title": "complaint title",
    "author": {
      "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": "м. Вінниця"
      }
    },
    "complaintID": "UA-2017-07-25-000001.1",
    "date": "2017-07-25T17:36:50.723953+03:00",
    "type": "claim",
    "id": "3b36519c7e994663a75935a29c0ddbcf"
  }
}

Потім завантажте документи:

POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf/documents?acc_token=6c52536fdb1b4e0a83ce6b486d2cfd0c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 341
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=FiD0BzQgpK6kcZJ5gTBrEkKGKg5QNTNvt3gt%2Fcjbjt5mbmz5BG7l8wTSIKTC4%2Bh2HXjF3WQ7pnRjOwL42gRlBA%3D%3D",
    "title": "Complaint_Attachement.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf/documents/8ebcc96606e941bc89d601c3d11270d1

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "complaint_owner",
    "title": "Complaint_Attachement.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:50.767640+03:00",
    "id": "8ebcc96606e941bc89d601c3d11270d1",
    "dateModified": "2017-07-25T17:36:50.767661+03:00"
  }
}

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

PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf?acc_token=6c52536fdb1b4e0a83ce6b486d2cfd0c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 29
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "claim"
  }
}


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

{
  "data": {
    "status": "claim",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:50.767640+03:00",
        "id": "8ebcc96606e941bc89d601c3d11270d1",
        "dateModified": "2017-07-25T17:36:50.767661+03:00"
      }
    ],
    "description": "complaint description",
    "title": "complaint title",
    "dateSubmitted": "2017-07-25T17:36:50.813612+03:00",
    "complaintID": "UA-2017-07-25-000001.1",
    "date": "2017-07-25T17:36:50.815647+03:00",
    "type": "claim",
    "id": "3b36519c7e994663a75935a29c0ddbcf"
  }
}
Подання вимоги про виправлення умов закупівлі (без документів)

Ви можете подати скаргу, що не потребує додаткових документів:

POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 794
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "claim",
    "title": "complaint title",
    "description": "complaint description",
    "author": {
      "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.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3382f6727fc94edc947ff016fcedad11

{
  "access": {
    "token": "463edbad1cd743ad842e367ec778d835"
  },
  "data": {
    "status": "claim",
    "description": "complaint description",
    "title": "complaint title",
    "author": {
      "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": "м. Вінниця"
      }
    },
    "dateSubmitted": "2017-07-25T17:36:50.854956+03:00",
    "complaintID": "UA-2017-07-25-000001.2",
    "date": "2017-07-25T17:36:50.854942+03:00",
    "type": "claim",
    "id": "3382f6727fc94edc947ff016fcedad11"
  }
}

Відповідь на вимогу

Відповідь на вирішену вимогу
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 442
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "answered",
    "resolutionType": "resolved",
    "tendererAction": "Виправлено неконкурентні умови",
    "resolution": "Виправлено неконкурентні умови"
  }
}


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

{
  "data": {
    "status": "answered",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:50.767640+03:00",
        "id": "8ebcc96606e941bc89d601c3d11270d1",
        "dateModified": "2017-07-25T17:36:50.767661+03:00"
      }
    ],
    "description": "complaint description",
    "title": "complaint title",
    "resolutionType": "resolved",
    "type": "claim",
    "tendererAction": "Виправлено неконкурентні умови",
    "dateAnswered": "2017-07-25T17:36:50.937282+03:00",
    "tendererActionDate": "2017-07-25T17:36:50.937311+03:00",
    "dateSubmitted": "2017-07-25T17:36:50.813612+03:00",
    "complaintID": "UA-2017-07-25-000001.1",
    "date": "2017-07-25T17:36:50.939736+03:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "3b36519c7e994663a75935a29c0ddbcf"
  }
}

Задовільнена вимога

Рішення про задовільнення вимоги
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf?acc_token=6c52536fdb1b4e0a83ce6b486d2cfd0c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 51
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "resolved",
    "satisfied": true
  }
}


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

{
  "data": {
    "status": "resolved",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:50.767640+03:00",
        "id": "8ebcc96606e941bc89d601c3d11270d1",
        "dateModified": "2017-07-25T17:36:50.767661+03:00"
      }
    ],
    "description": "complaint description",
    "title": "complaint title",
    "resolutionType": "resolved",
    "type": "claim",
    "satisfied": true,
    "tendererAction": "Виправлено неконкурентні умови",
    "dateAnswered": "2017-07-25T17:36:50.937282+03:00",
    "tendererActionDate": "2017-07-25T17:36:50.937311+03:00",
    "dateSubmitted": "2017-07-25T17:36:50.813612+03:00",
    "complaintID": "UA-2017-07-25-000001.1",
    "date": "2017-07-25T17:36:50.991383+03:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "3b36519c7e994663a75935a29c0ddbcf"
  }
}
Незгода з рішенням
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3382f6727fc94edc947ff016fcedad11?acc_token=463edbad1cd743ad842e367ec778d835 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 52
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "resolved",
    "satisfied": false
  }
}


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

{
  "data": {
    "status": "resolved",
    "description": "complaint description",
    "title": "complaint title",
    "resolutionType": "resolved",
    "type": "claim",
    "satisfied": false,
    "dateAnswered": "2017-07-25T17:36:51.045464+03:00",
    "dateSubmitted": "2017-07-25T17:36:50.854956+03:00",
    "complaintID": "UA-2017-07-25-000001.2",
    "date": "2017-07-25T17:36:51.100829+03:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "3382f6727fc94edc947ff016fcedad11"
  }
}

Вимоги/Скарги на визначення переможця

Отримання інформації про звернення/скарги

Отримання інформації про вимоги/скарги на визначення переможця

Ви можете отримати список всіх вимог/скарг на визначення переможця:

GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints HTTP/1.0
Host: api-sandbox.openprocurement.org


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

{
  "data": [
    {
      "status": "claim",
      "documents": [
        {
          "hash": "md5:00000000000000000000000000000000",
          "author": "complaint_owner",
          "title": "Complaint_Attachement.pdf",
          "url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2017-07-25T17:36:53.000914+03:00",
          "id": "96ad4bc79c704f6eb094b83bf2ca817a",
          "dateModified": "2017-07-25T17:36:53.000946+03:00"
        }
      ],
      "description": "complaint description",
      "title": "complaint title",
      "author": {
        "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": "м. Вінниця"
        }
      },
      "dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
      "complaintID": "UA-2017-07-25-000001.5",
      "date": "2017-07-25T17:36:53.132891+03:00",
      "type": "claim",
      "id": "fc1eef6ef50d4656b981aae8bb181467"
    },
    {
      "status": "claim",
      "description": "complaint description",
      "title": "complaint title",
      "author": {
        "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": "м. Вінниця"
        }
      },
      "dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
      "complaintID": "UA-2017-07-25-000001.6",
      "date": "2017-07-25T17:36:53.245100+03:00",
      "type": "claim",
      "id": "d9f8daa198f44112b4ec51a00598d823"
    }
  ]
}

Або перевірити окрему скаргу чи вимогу:

GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467 HTTP/1.0
Host: api-sandbox.openprocurement.org


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

{
  "data": {
    "status": "claim",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:53.000914+03:00",
        "id": "96ad4bc79c704f6eb094b83bf2ca817a",
        "dateModified": "2017-07-25T17:36:53.000946+03:00"
      }
    ],
    "description": "complaint description",
    "title": "complaint title",
    "author": {
      "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": "м. Вінниця"
      }
    },
    "dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
    "complaintID": "UA-2017-07-25-000001.5",
    "date": "2017-07-25T17:36:53.132891+03:00",
    "type": "claim",
    "id": "fc1eef6ef50d4656b981aae8bb181467"
  }
}

Подання вимоги

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

Подання вимоги про виправлення визначення переможця (з документами)

Спочатку створимо вимогу. В запиті потрібно передати токен доступу одного з учасників, який вже подав пропозицію.

POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints?acc_token=86ff28dee48646b58ef3021c532d26fc HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 775
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "title": "complaint title",
    "description": "complaint description",
    "author": {
      "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.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467

{
  "access": {
    "token": "3df7c9a8797747c0b56aa8ac54c8ac87"
  },
  "data": {
    "status": "draft",
    "description": "complaint description",
    "title": "complaint title",
    "author": {
      "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": "м. Вінниця"
      }
    },
    "complaintID": "UA-2017-07-25-000001.5",
    "date": "2017-07-25T17:36:52.885993+03:00",
    "type": "claim",
    "id": "fc1eef6ef50d4656b981aae8bb181467"
  }
}

Потім завантажте документи:

POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467/documents?acc_token=3df7c9a8797747c0b56aa8ac54c8ac87 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 337
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=i93IbrYeyRrJKcx5js73FlDkfqcsaOgcNT5Zjv9onXJPVdiT8q71zqjBW2CtSrF0VEcBanwp5TK3n71Y6twXCA%3D%3D",
    "title": "Complaint_Attachement.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467/documents/96ad4bc79c704f6eb094b83bf2ca817a

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "complaint_owner",
    "title": "Complaint_Attachement.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-07-25T17:36:53.000914+03:00",
    "id": "96ad4bc79c704f6eb094b83bf2ca817a",
    "dateModified": "2017-07-25T17:36:53.000946+03:00"
  }
}

Подамо вимогу про виправлення рішення по визначенню переможця:

PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467?acc_token=3df7c9a8797747c0b56aa8ac54c8ac87 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 29
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "claim"
  }
}


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

{
  "data": {
    "status": "claim",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:53.000914+03:00",
        "id": "96ad4bc79c704f6eb094b83bf2ca817a",
        "dateModified": "2017-07-25T17:36:53.000946+03:00"
      }
    ],
    "description": "complaint description",
    "title": "complaint title",
    "author": {
      "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": "м. Вінниця"
      }
    },
    "dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
    "complaintID": "UA-2017-07-25-000001.5",
    "date": "2017-07-25T17:36:53.132891+03:00",
    "type": "claim",
    "id": "fc1eef6ef50d4656b981aae8bb181467"
  }
}
Подання вимоги про виправлення визначення переможця (без документів)

Ви можете подати скаргу, що не потребує додаткових документів:

POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints?acc_token=86ff28dee48646b58ef3021c532d26fc HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 794
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "claim",
    "title": "complaint title",
    "description": "complaint description",
    "author": {
      "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.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/d9f8daa198f44112b4ec51a00598d823

{
  "access": {
    "token": "3dbf343519cf4f26a01caf880b2d6536"
  },
  "data": {
    "status": "claim",
    "description": "complaint description",
    "title": "complaint title",
    "author": {
      "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": "м. Вінниця"
      }
    },
    "dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
    "complaintID": "UA-2017-07-25-000001.6",
    "date": "2017-07-25T17:36:53.245100+03:00",
    "type": "claim",
    "id": "d9f8daa198f44112b4ec51a00598d823"
  }
}

Відповідь на вимогу

Відповідь на вирішену вимогу
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 442
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "answered",
    "resolutionType": "resolved",
    "tendererAction": "Виправлено неконкурентні умови",
    "resolution": "Виправлено неконкурентні умови"
  }
}


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

{
  "data": {
    "status": "answered",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:53.000914+03:00",
        "id": "96ad4bc79c704f6eb094b83bf2ca817a",
        "dateModified": "2017-07-25T17:36:53.000946+03:00"
      }
    ],
    "description": "complaint description",
    "author": {
      "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": "м. Вінниця"
      }
    },
    "resolutionType": "resolved",
    "type": "claim",
    "title": "complaint title",
    "tendererAction": "Виправлено неконкурентні умови",
    "dateAnswered": "2017-07-25T17:36:53.465653+03:00",
    "tendererActionDate": "2017-07-25T17:36:53.465668+03:00",
    "dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
    "complaintID": "UA-2017-07-25-000001.5",
    "date": "2017-07-25T17:36:53.471855+03:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "fc1eef6ef50d4656b981aae8bb181467"
  }
}

Задовільнена вимога

Рішення про задовільнення вимоги
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467?acc_token=3df7c9a8797747c0b56aa8ac54c8ac87 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 51
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "resolved",
    "satisfied": true
  }
}


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

{
  "data": {
    "status": "resolved",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-07-25T17:36:53.000914+03:00",
        "id": "96ad4bc79c704f6eb094b83bf2ca817a",
        "dateModified": "2017-07-25T17:36:53.000946+03:00"
      }
    ],
    "description": "complaint description",
    "author": {
      "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": "м. Вінниця"
      }
    },
    "resolutionType": "resolved",
    "type": "claim",
    "title": "complaint title",
    "satisfied": true,
    "tendererAction": "Виправлено неконкурентні умови",
    "dateAnswered": "2017-07-25T17:36:53.465653+03:00",
    "tendererActionDate": "2017-07-25T17:36:53.465668+03:00",
    "dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
    "complaintID": "UA-2017-07-25-000001.5",
    "date": "2017-07-25T17:36:53.605801+03:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "fc1eef6ef50d4656b981aae8bb181467"
  }
}
Незгода з рішенням
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/d9f8daa198f44112b4ec51a00598d823?acc_token=3dbf343519cf4f26a01caf880b2d6536 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 52
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "resolved",
    "satisfied": false
  }
}


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

{
  "data": {
    "status": "resolved",
    "description": "complaint description",
    "title": "complaint title",
    "resolutionType": "resolved",
    "type": "claim",
    "author": {
      "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": "м. Вінниця"
      }
    },
    "satisfied": false,
    "dateAnswered": "2017-07-25T17:36:53.730015+03:00",
    "dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
    "complaintID": "UA-2017-07-25-000001.6",
    "date": "2017-07-25T17:36:53.871088+03:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "d9f8daa198f44112b4ec51a00598d823"
  }
}

Схема роботи

digraph G {
    claim -> answered;
    edge[style=dashed];
    draft -> claim;
    answered -> resolved;
    {draft,claim,answered} -> cancelled;
    edge[label="3d" style=dotted];
    answered -> {resolved, invalid, declined};
    edge[label="complete" style=dotted];
    claim -> ignored;
    edge[label="auto" style=dotted];
    pending -> ignored;
    pending -> {resolved, invalid, declined};
}

Ролі

Complainant:

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

Procuring entity:
 

звичайна лінія

Chronograph:

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

Статуси

draft:

Початковий статус

На цьому етапі скаржник може подати вимогу, завантажити документи, відкликати вимогу та подати її знову.

claim:

Замовник може завантажити документи та відповісти на вимогу.

Скаржник може відкликати вимогу.

answered:

Скаржник може відкликати вимогу, завантажити документи, згодитись або не згодитись з вирішенням.

pending:

Орган оскарження може завантажувати документи та розглядати скарги.

Скаржник може відкликати вимогу.

invalid:

Кінцевий статус

Вимогу визнано недійсною.

declined:

Кінцевий статус

Вимогу визнано відхиленою.

resolved:

Кінцевий статус

Вимогу визнано вирішеною.

cancelled:

Кінцевий статус

Вимогу відкликано скаржником.

ignored:

Кінцевий статус

Замовник залишив вимогу без відповіді.

Рекомендації для роботи

Контроль частоти запитів

На “агресивні” IP адреси може бути накладено обмеження на швидкість, з якою сервери ЦБД опрацьовують запити. У відповідь на запити, які прийшли швидше ніж дозволено, ЦБД відповідає з кодом статусу 429.

Очікується, що на такий код відповіді ПЗ майданчика буде реагувати таким чином: буде повторювати запити, які повернулися з таким кодом помилки, збільшуючи затримку між окремими запитами, що посилаються на ЦБД, доти доки запити не почнуть вдаватися (2xx/3xx відповіді).

Така поведінка серверів ЦБД необхідна, щоб рівномірніше розподіляти ресурси серверів між майданчиками.

Робота з API в режимі кластеру

Дані синхронізуються на кластері з декількох серверів. Для узгодження між окремими запитами до ЦБД важливо, щоб клієнт працював завжди з одним сервером. Тому обов’язково використовувати реп’яшок (сookie) при подачі POST/PUT/PATCH/DELETE запитів. Реп’яшки (сookies) забезпечують прив’язку до сервера. Такий реп’яшок можна отримати через GET запит, а тоді використовувати його в POST/PUT/PATCH/DELETE.

Якщо під час операцій сервер запитаний реп’яшком недоступний або впав, клієнт отримає 412 код стану запиту і новий реп’яшок. Запит потрібно повторити з використанням нового реп’яшка.

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

Механізм створення двофазного коміта

Двофазний коміт пропонує механізм, завдяки якому в ЦБД будуть опубліковані тільки ті закупівлі, над якими майданчик має контроль і змогу самостійно скасувати їх дублікати.

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

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

Відсилання однофазного запиту на створення закупівлі (POST /tenders), за “старим” механізмом, після якого закупівля створюється одразу в статусі active.enquiries:

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

{
  "data": {
    "tenderPeriod": {
      "endDate": "2017-08-08T17:36:49.306344"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "enquiryPeriod": {
      "endDate": "2017-08-01T17:36:49.306344"
    },
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344",
          "endDate": "2017-07-30T17:36:49.306344"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ]
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af

{
  "access": {
    "token": "2ef61fa89e8a451ba4149d2f8e31173b"
  },
  "data": {
    "procurementMethod": "open",
    "status": "active.enquiries",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-08-01T17:36:49.306344+03:00",
      "endDate": "2017-08-08T17:36:49.306344+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "4ee2b0431a064e0eb155eeb650bdfdd0",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-07-25T17:36:55.659566+03:00",
    "next_check": "2017-08-01T17:36:49.306344+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "enquiryPeriod": {
      "startDate": "2017-07-25T17:36:55.659520+03:00",
      "endDate": "2017-08-01T17:36:49.306344+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-07-25T17:36:55.662421+03:00",
    "id": "f3641d0ba0f042e8b49de06d5c7921af",
    "tenderID": "UA-2017-07-25-000001"
  }
}

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

Закупівля стає доступною після успішного та послідовного виконання двох наступних запитів:

  1. Створення закупівлі у статусі draft.

  2. Переведення закупівлі в статус active.enquiries окремим запитом (публікація).

Створення закупівлі

При запиті POST /tenders передається закупівля зі статусом draft. В результаті виконання запиту віддається acc_token для подальшого управління закупівлею.

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

{
  "data": {
    "status": "draft",
    "tenderPeriod": {
      "endDate": "2017-08-08T17:36:49.306344"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "enquiryPeriod": {
      "endDate": "2017-08-01T17:36:49.306344"
    },
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344",
          "endDate": "2017-07-30T17:36:49.306344"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ]
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e66dcc48a19e498984e3e5e51131ad68

{
  "access": {
    "token": "75424b9a8c2842d0a9c24e477ccef649"
  },
  "data": {
    "procurementMethod": "open",
    "status": "draft",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-08-01T17:36:49.306344+03:00",
      "endDate": "2017-08-08T17:36:49.306344+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "3e25bda8806e4d27a03dc5f9e4805f5e",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-07-25T17:36:50.226421+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "enquiryPeriod": {
      "startDate": "2017-07-25T17:36:50.226395+03:00",
      "endDate": "2017-08-01T17:36:49.306344+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-07-25T17:36:50.228135+03:00",
    "id": "e66dcc48a19e498984e3e5e51131ad68",
    "tenderID": "UA-2017-07-25-000001"
  }
}

Закупівля зі статусом draft “невидима” в переліку GET /tenders. Її, зокрема, не помічає хронограф і не перемикає статуси.

Публікування закупівлі

Запит PATCH /tenders/{id}?acc_token=... {“data”:{“status”:”active.enquiries”}} змінює статус закупівлі (згідно із запитом) і, відповідно, цим публікує її (“візуалізує” її в переліку GET /tenders).

PATCH /api/2.3/tenders/e66dcc48a19e498984e3e5e51131ad68?acc_token=75424b9a8c2842d0a9c24e477ccef649 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 40
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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


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

{
  "data": {
    "procurementMethod": "open",
    "status": "active.enquiries",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-08-01T17:36:49.306344+03:00",
      "endDate": "2017-08-08T17:36:49.306344+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-27T17:36:49.306344+03:00",
          "endDate": "2017-07-30T17:36:49.306344+03:00"
        },
        "id": "3e25bda8806e4d27a03dc5f9e4805f5e",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-07-25T17:36:50.255342+03:00",
    "next_check": "2017-08-01T17:36:49.306344+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "enquiryPeriod": {
      "startDate": "2017-07-25T17:36:50.226395+03:00",
      "endDate": "2017-08-01T17:36:49.306344+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-07-25T17:36:50.255342+03:00",
    "id": "e66dcc48a19e498984e3e5e51131ad68",
    "tenderID": "UA-2017-07-25-000001"
  }
}

Всі закупівлі, які були створені в ЦБД, але не опубліковані, не будуть відображатись на майданчику і, відповідно, не будуть призводити до їх оголошення.

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

Новий механізм доступний паралельно зі “старим”. “Старий”, імовірно, буде вимкнено в одному з наступних release-ів.

Робота з помилками

У випадку неуспішності запиту та/або 5xx помилки, перевірте модифікований об’єкт (закупівлю, пропозицію, контракт і т.п.), оскільки 5xx помилка не обов’язково означає, що запит не відбувся. Варто повторювати запит з певним інтервалом, доки він не пройде успішно.

Детальніший опис помилок та рекомендацій щодо дій при їх виникненні описаний у розділі Коди стану.

Ось приклад помилки неправильно сформованого запиту. Ця помилка вказує, що data не знайдено у тілі JSON.

POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: api-sandbox.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"
    }
  ]
}

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

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

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

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

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

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

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

Додаткові опції

Опція no-auction

Встановлення цієї опції: встановити значення quick(mode:no-auction) для параметра submissionMethodDetails.

Опція no-auction дозволяє провести закупівлю, “вилучивши” етап аукціону. Це означає, що етап active.auction буде завершений по результатах вхідних пропозицій; аукціон взагалі проводитись не буде, тобто по посиланню auctionURL побачити аукціон буде неможливо.

Опція fast-forward

Встановлення цієї опції: встановити значення quick(mode:fast-forward) для параметра submissionMethodDetails.

Опція fast-forward дозволяє провести закупівлю, “пропустивши” етап аукціону. Це означає, що етап active.auction буде завершений по результатах вхідних пропозицій; хоча посилання auctionURL буде створено і буде можливість переглянути по ньому аукціон.

API Довідник

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