Туторіал

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

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

GET /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [],
  "next_page": {
    "offset": "",
    "path": "/api/2.5/tenders?offset=",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset="
  }
}

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

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

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
data

Response: 415 Unsupported Media Type
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "status": "error",
  "errors": [
    {
      "location": "header",
      "name": "Content-Type",
      "description": "Content-Type header should be one of ['application/json']"
    }
  ]
}

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

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

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 4
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
data

Response: 422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Expecting value: line 1 column 1 (char 0)"
    }
  ]
}

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

Створення закупівлі

Введемо data атрибут у поданому тілі:

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1876
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "Комп’ютерне обладнання",
    "profile": "655360-30230000-889652-40000777",
    "mainProcurementCategory": "goods",
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "locality": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "items": [
      {
        "description": "Комп’ютерне обладнання",
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6
          }
        },
        "quantity": 5,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "locality": "м. Київ",
          "streetAddress": "вул. Банкова 1"
        }
      }
    ],
    "value": {
      "amount": 22000,
      "currency": "UAH"
    },
    "tenderPeriod": {
      "endDate": "2021-03-30T00:00:00+02:00"
    },
    "procurementMethodType": "priceQuotation",
    "procurementMethod": "selective"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e821f507458c4e99bdd9928981355ffa
X-Content-Type-Options: nosniff
{
  "data": {
    "title": "Комп’ютерне обладнання",
    "date": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "tenderID": "UA-2021-03-16-000001",
    "owner": "broker",
    "mainProcurementCategory": "goods",
    "awardCriteria": "lowestCost",
    "submissionMethod": "electronicAuction",
    "status": "draft",
    "items": [
      {
        "id": "61a6737049384b08876fb0407eda182f",
        "description": "Комп’ютерне обладнання",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ],
    "value": {
      "amount": 22000.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "tenderPeriod": {
      "startDate": "2021-03-16T00:00:00+02:00",
      "endDate": "2021-03-30T00:00:00+02:00"
    },
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "procurementMethod": "selective",
    "procurementMethodType": "priceQuotation",
    "profile": "655360-30230000-889652-40000777",
    "id": "e821f507458c4e99bdd9928981355ffa"
  },
  "access": {
    "token": "c87b58b4160f425b8973621e89008a15",
    "transfer": "c6bbee2535374aad82bcce629cad7d95"
  }
}

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

! Примітка: Користувач отримує access: token: "151a30932ee245e989771be867bc8235" з яким доступні операції ролі Замовника.

Процедура Запиту цінових пропозицій має procurementMethodType: priceQuotation та procurementMethod: selective.

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

GET /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "title": "Комп’ютерне обладнання",
    "date": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "tenderID": "UA-2021-03-16-000001",
    "owner": "broker",
    "mainProcurementCategory": "goods",
    "awardCriteria": "lowestCost",
    "submissionMethod": "electronicAuction",
    "status": "draft",
    "items": [
      {
        "id": "61a6737049384b08876fb0407eda182f",
        "description": "Комп’ютерне обладнання",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ],
    "value": {
      "amount": 22000.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "tenderPeriod": {
      "startDate": "2021-03-16T00:00:00+02:00",
      "endDate": "2021-03-30T00:00:00+02:00"
    },
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "procurementMethod": "selective",
    "procurementMethodType": "priceQuotation",
    "profile": "655360-30230000-889652-40000777",
    "id": "e821f507458c4e99bdd9928981355ffa"
  }
}

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

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

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

PATCH /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa?acc_token=c87b58b4160f425b8973621e89008a15 HTTP/1.0
Authorization: Bearer broker
Content-Length: 68
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "tenderPeriod": {
      "endDate": "2021-03-31T00:00:11+02:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "title": "Комп’ютерне обладнання",
    "date": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:01+02:00",
    "tenderID": "UA-2021-03-16-000001",
    "owner": "broker",
    "mainProcurementCategory": "goods",
    "awardCriteria": "lowestCost",
    "submissionMethod": "electronicAuction",
    "status": "draft",
    "items": [
      {
        "id": "61a6737049384b08876fb0407eda182f",
        "description": "Комп’ютерне обладнання",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ],
    "value": {
      "amount": 22000.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "tenderPeriod": {
      "startDate": "2021-03-16T00:00:00+02:00",
      "endDate": "2021-03-31T00:00:11+02:00"
    },
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "procurementMethod": "selective",
    "procurementMethodType": "priceQuotation",
    "profile": "655360-30230000-889652-40000777",
    "id": "e821f507458c4e99bdd9928981355ffa"
  }
}

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

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

GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "e821f507458c4e99bdd9928981355ffa",
      "dateModified": "2021-03-16T00:00:01+02:00"
    }
  ],
  "next_page": {
    "offset": "2021-03-16T00:00:01+02:00",
    "path": "/api/2.5/tenders?offset=2021-03-16T00%3A00%3A01%2B02%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2021-03-16T00%3A00%3A01%2B02%3A00"
  }
}

Публікація закупівлі

Після створення Замовник публікує процедуру, змінивши статус на draft.publishing, де робот priceQuotationBot запускає перевірку процедури та доповнює процедуру додатковими даними, отриманими з бази даних електронних каталогів ProZorro, включаючи shortListedFirms.

PATCH /api/2.5/tenders/fd1a15553b7047a9b514d57529cb5a44?acc_token=aa7d4666148647c0b3533387d2745ca5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 40
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "draft.publishing"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "title": "Комп’ютерне обладнання",
    "date": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "tenderID": "UA-2021-03-16-000001",
    "owner": "broker",
    "mainProcurementCategory": "goods",
    "awardCriteria": "lowestCost",
    "submissionMethod": "electronicAuction",
    "status": "draft.publishing",
    "items": [
      {
        "id": "58875aff79b44134818670145fe82398",
        "description": "Комп’ютерне обладнання",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ],
    "value": {
      "amount": 22000.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "tenderPeriod": {
      "startDate": "2021-03-16T00:00:00+02:00",
      "endDate": "2021-03-30T00:00:00+02:00"
    },
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "procurementMethod": "selective",
    "procurementMethodType": "priceQuotation",
    "profile": "655360-30230000-889652-40000777",
    "noticePublicationDate": "2021-03-16T00:00:00+02:00",
    "id": "fd1a15553b7047a9b514d57529cb5a44"
  }
}

Після успішної валідації priceQuotationBot переводить процедуру в статус: active.tendering

GET /api/2.5/tenders/fd1a15553b7047a9b514d57529cb5a44 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "title": "Комп’ютерне обладнання",
    "date": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "tenderID": "UA-2021-03-16-000001",
    "owner": "broker",
    "mainProcurementCategory": "goods",
    "awardCriteria": "lowestCost",
    "submissionMethod": "electronicAuction",
    "status": "active.tendering",
    "items": [
      {
        "id": "58875aff79b44134818670145fe82398",
        "description": "Комп’ютерне обладнання",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Комп’ютерне обладнанн",
          "scheme": "ДК021",
          "id": "30230000-0"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ],
    "value": {
      "amount": 22000.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "tenderPeriod": {
      "startDate": "2021-03-16T00:00:00+02:00",
      "endDate": "2021-03-30T00:00:00+02:00"
    },
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "procurementMethod": "selective",
    "procurementMethodType": "priceQuotation",
    "profile": "655360-30230000-889652-40000777",
    "shortlistedFirms": [
      {
        "name": "Товариство з обмеженою відповідальністю «Пікселі»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Товариство з обмеженою відповідальністю «Пікселі»"
        },
        "address": {
          "streetAddress": "бул.Дружби Народів, 8",
          "locality": "м.Київ",
          "region": "Київська область",
          "postalCode": "01100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Оксана Піксель",
          "email": "contact@pixel.pix",
          "telephone": "+0671234567"
        },
        "scale": "large",
        "id": "UA-EDR-12345678",
        "status": "active"
      },
      {
        "name": "Товариство з обмеженою відповідальністю «Штекер-Пекер»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "87654321",
          "legalName": "Товариство з обмеженою відповідальністю «Штекер-Пекер»"
        },
        "address": {
          "streetAddress": "вул. Кластерна, 777-К",
          "locality": "м.Тернопіль",
          "region": "Тернопільська область",
          "postalCode": "46000",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Олег Штекер",
          "email": "info@shteker.pek",
          "telephone": "+0951234567"
        },
        "scale": "large",
        "id": "UA-EDR-87654321",
        "status": "active"
      }
    ],
    "criteria": [
      {
        "id": "655360-0001",
        "title": "Діагональ екрану",
        "description": "Діагональ екрану",
        "requirementGroups": [
          {
            "id": "655360-0001-001",
            "description": "Діагональ екрану, не менше 23.8 дюймів",
            "requirements": [
              {
                "id": "655360-0001-001-01",
                "title": "Діагональ екрану",
                "dataType": "number",
                "unit": {
                  "code": "INH",
                  "name": "дюйм"
                },
                "minValue": "23.8"
              }
            ]
          }
        ]
      },
      {
        "id": "655360-0002",
        "title": "Роздільна здатність",
        "description": "Роздільна здатність",
        "requirementGroups": [
          {
            "id": "655360-0002-001",
            "description": "Роздільна здатність - 1920x1080",
            "requirements": [
              {
                "id": "655360-0002-001-01",
                "title": "Роздільна здатність",
                "dataType": "string",
                "expectedValue": "1920x1080"
              }
            ]
          }
        ]
      },
      {
        "id": "655360-0003",
        "title": "Співвідношення сторін",
        "description": "Співвідношення сторін",
        "requirementGroups": [
          {
            "id": "655360-0003-001",
            "description": "Співвідношення сторін",
            "requirements": [
              {
                "id": "655360-0003-001-01",
                "title": "Співвідношення сторін",
                "dataType": "string",
                "expectedValue": "16:9"
              }
            ]
          }
        ]
      },
      {
        "id": "655360-0004",
        "title": "Яскравість дисплея",
        "description": "Яскравість дисплея",
        "requirementGroups": [
          {
            "id": "655360-0004-001",
            "description": "Яскравість дисплея, не менше 250 кд/м²",
            "requirements": [
              {
                "id": "655360-0004-001-01",
                "title": "Яскравість дисплея",
                "dataType": "integer",
                "unit": {
                  "code": "A24",
                  "name": "кд/м²"
                },
                "maxValue": "250"
              }
            ]
          }
        ]
      },
      {
        "id": "655360-0005",
        "title": "Контрастність (статична)",
        "description": "Контрастність (статична)",
        "requirementGroups": [
          {
            "id": "655360-0005-001",
            "description": "Контрастність (статична) - 1000:1",
            "requirements": [
              {
                "id": "655360-0005-001-01",
                "title": "Контрастність (статична)",
                "dataType": "string",
                "expectedValue": "1000:1"
              }
            ]
          },
          {
            "id": "655360-0005-002",
            "description": "Контрастність (статична) - 3000:1",
            "requirements": [
              {
                "id": "655360-0005-002-01",
                "title": "Контрастність (статична)",
                "dataType": "string",
                "expectedValue": "3000:1"
              }
            ]
          }
        ]
      },
      {
        "id": "655360-0006",
        "title": "Кількість портів HDMI",
        "description": "Кількість портів HDMI",
        "requirementGroups": [
          {
            "id": "655360-0006-001",
            "description": "Кількість портів HDMI, не менше 1 шт.",
            "requirements": [
              {
                "id": "655360-0006-001-01",
                "title": "Кількість портів HDMI",
                "dataType": "integer",
                "unit": {
                  "code": "H87",
                  "name": "штук"
                },
                "minValue": "1"
              }
            ]
          }
        ]
      },
      {
        "id": "655360-0007",
        "title": "Кількість портів D-sub",
        "description": "Кількість портів D-sub",
        "requirementGroups": [
          {
            "id": "655360-0007-001",
            "description": "Кількість портів D-sub, не менше 1 шт.",
            "requirements": [
              {
                "id": "655360-0007-001-01",
                "title": "Кількість портів D-sub",
                "dataType": "integer",
                "unit": {
                  "code": "H87",
                  "name": "штук"
                },
                "minValue": "1"
              }
            ]
          }
        ]
      },
      {
        "id": "655360-0008",
        "title": "Кабель для під’єднання",
        "description": "Кабель для під’єднання",
        "requirementGroups": [
          {
            "id": "655360-0008-001",
            "description": "Кабель для під’єднання",
            "requirements": [
              {
                "id": "655360-0008-001-01",
                "title": "Кабель для під’єднання",
                "dataType": "string",
                "expectedValue": "HDMI"
              }
            ]
          }
        ]
      },
      {
        "id": "655360-0009",
        "title": "Гарантія",
        "description": "Строк дії гарантії",
        "requirementGroups": [
          {
            "id": "655360-0009-001",
            "description": "Гарантія, не менше 36 місяців",
            "requirements": [
              {
                "id": "655360-0009-001-01",
                "title": "Гарантія",
                "dataType": "integer",
                "unit": {
                  "code": "MON",
                  "name": "місяців"
                },
                "minValue": "36"
              }
            ]
          }
        ]
      }
    ],
    "noticePublicationDate": "2021-03-16T00:00:00+02:00",
    "id": "fd1a15553b7047a9b514d57529cb5a44",
    "next_check": "2021-03-30T01:00:00+03:00"
  }
}

In case if procedure do not pass validation due to invalid options, it will be switched to status: draft.unsuccessful by the priceQuotationBot.

GET /api/2.5/tenders/8d1f0584d486402eb0130ea74254c804 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "title": "Комп’ютерне обладнання",
    "date": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "tenderID": "UA-2021-03-16-000002",
    "owner": "broker",
    "mainProcurementCategory": "goods",
    "awardCriteria": "lowestCost",
    "submissionMethod": "electronicAuction",
    "status": "draft.unsuccessful",
    "items": [
      {
        "id": "8362da99fda44bcfa6516e34c6cd86b6",
        "description": "Комп’ютерне обладнання",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ],
    "value": {
      "amount": 22000.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "tenderPeriod": {
      "startDate": "2021-03-16T00:00:00+02:00",
      "endDate": "2021-03-30T00:00:00+02:00"
    },
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "procurementMethod": "selective",
    "procurementMethodType": "priceQuotation",
    "profile": "655360-30230000-889652-40000777bad_profile",
    "id": "8d1f0584d486402eb0130ea74254c804"
  }
}

Подача пропозицій

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

Статус закупівлі active.tendering дозволяє подання пропозицій.

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

POST /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 1523
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "tenderers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "01220",
          "region": "м. Київ",
          "locality": "м. Київ",
          "streetAddress": "вул. Банкова, 11, корпус 1"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "value": {
      "amount": 469,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "requirementResponses": [
      {
        "value": "23.8",
        "requirement": {
          "id": "655360-0001-001-01"
        }
      },
      {
        "value": "1920x1080",
        "requirement": {
          "id": "655360-0002-001-01"
        }
      },
      {
        "value": "16:9",
        "requirement": {
          "id": "655360-0003-001-01"
        }
      },
      {
        "value": 250,
        "requirement": {
          "id": "655360-0004-001-01"
        }
      },
      {
        "value": "1000:1",
        "requirement": {
          "id": "655360-0005-001-01"
        }
      },
      {
        "value": 1,
        "requirement": {
          "id": "655360-0006-001-01"
        }
      },
      {
        "value": 1,
        "requirement": {
          "id": "655360-0007-001-01"
        }
      },
      {
        "value": "HDMI",
        "requirement": {
          "id": "655360-0008-001-01"
        }
      },
      {
        "value": 36,
        "requirement": {
          "id": "655360-0009-001-01"
        }
      }
    ],
    "status": "draft"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/bids/29415ac0f0d54c9d9b7b4db698534302
X-Content-Type-Options: nosniff
{
  "data": {
    "tenderers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "date": "2021-03-16T00:00:01+02:00",
    "id": "29415ac0f0d54c9d9b7b4db698534302",
    "status": "draft",
    "value": {
      "amount": 469.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "requirementResponses": [
      {
        "id": "42a37c28db48487b9087887d1de9f565",
        "requirement": {
          "id": "655360-0001-001-01"
        },
        "value": "23.8"
      },
      {
        "id": "65416ef63bb9439b9633bc48f0e3d92a",
        "requirement": {
          "id": "655360-0002-001-01"
        },
        "value": "1920x1080"
      },
      {
        "id": "7b66650890ca46508873f93d32baa3b6",
        "requirement": {
          "id": "655360-0003-001-01"
        },
        "value": "16:9"
      },
      {
        "id": "aab0baa58eec462eb29e0c498f986f66",
        "requirement": {
          "id": "655360-0004-001-01"
        },
        "value": "250"
      },
      {
        "id": "c5d81c755bd649f99103701d4ac2af11",
        "requirement": {
          "id": "655360-0005-001-01"
        },
        "value": "1000:1"
      },
      {
        "id": "4cafe402e83c43aa89c477f760d00907",
        "requirement": {
          "id": "655360-0006-001-01"
        },
        "value": "1"
      },
      {
        "id": "826a01de04c3489da77a770ce8bdabd5",
        "requirement": {
          "id": "655360-0007-001-01"
        },
        "value": "1"
      },
      {
        "id": "cb2a26252cc545bfa45db902b929b171",
        "requirement": {
          "id": "655360-0008-001-01"
        },
        "value": "HDMI"
      },
      {
        "id": "a3b4c8e5ba15493aaf9816ecedc236f6",
        "requirement": {
          "id": "655360-0009-001-01"
        },
        "value": "36"
      }
    ]
  },
  "access": {
    "token": "7e91cc260b8d4c7fbd12afe11ee24975",
    "transfer": "d7be0156d7894abeb6b94a2bef338233"
  }
}

! Примітка: Користувач отримує access: token: "151a30932ee245e989771be867bc8235" з яким доступні операції ролі Постачальника.

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

PATCH /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/bids/29415ac0f0d54c9d9b7b4db698534302?acc_token=7e91cc260b8d4c7fbd12afe11ee24975 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "tenderers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "date": "2021-03-16T00:00:01+02:00",
    "id": "29415ac0f0d54c9d9b7b4db698534302",
    "status": "active",
    "value": {
      "amount": 459.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "requirementResponses": [
      {
        "id": "42a37c28db48487b9087887d1de9f565",
        "requirement": {
          "id": "655360-0001-001-01"
        },
        "value": "23.8"
      },
      {
        "id": "65416ef63bb9439b9633bc48f0e3d92a",
        "requirement": {
          "id": "655360-0002-001-01"
        },
        "value": "1920x1080"
      },
      {
        "id": "7b66650890ca46508873f93d32baa3b6",
        "requirement": {
          "id": "655360-0003-001-01"
        },
        "value": "16:9"
      },
      {
        "id": "aab0baa58eec462eb29e0c498f986f66",
        "requirement": {
          "id": "655360-0004-001-01"
        },
        "value": "250"
      },
      {
        "id": "c5d81c755bd649f99103701d4ac2af11",
        "requirement": {
          "id": "655360-0005-001-01"
        },
        "value": "1000:1"
      },
      {
        "id": "4cafe402e83c43aa89c477f760d00907",
        "requirement": {
          "id": "655360-0006-001-01"
        },
        "value": "1"
      },
      {
        "id": "826a01de04c3489da77a770ce8bdabd5",
        "requirement": {
          "id": "655360-0007-001-01"
        },
        "value": "1"
      },
      {
        "id": "cb2a26252cc545bfa45db902b929b171",
        "requirement": {
          "id": "655360-0008-001-01"
        },
        "value": "HDMI"
      },
      {
        "id": "a3b4c8e5ba15493aaf9816ecedc236f6",
        "requirement": {
          "id": "655360-0009-001-01"
        },
        "value": "36"
      }
    ]
  }
}

Модифікація пропозиції

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

PATCH /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/bids/29415ac0f0d54c9d9b7b4db698534302?acc_token=7e91cc260b8d4c7fbd12afe11ee24975 HTTP/1.0
Authorization: Bearer broker
Content-Length: 36
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "value": {
      "amount": 459
    }
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "tenderers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "date": "2021-03-16T00:00:01+02:00",
    "id": "29415ac0f0d54c9d9b7b4db698534302",
    "status": "draft",
    "value": {
      "amount": 459.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "requirementResponses": [
      {
        "id": "42a37c28db48487b9087887d1de9f565",
        "requirement": {
          "id": "655360-0001-001-01"
        },
        "value": "23.8"
      },
      {
        "id": "65416ef63bb9439b9633bc48f0e3d92a",
        "requirement": {
          "id": "655360-0002-001-01"
        },
        "value": "1920x1080"
      },
      {
        "id": "7b66650890ca46508873f93d32baa3b6",
        "requirement": {
          "id": "655360-0003-001-01"
        },
        "value": "16:9"
      },
      {
        "id": "aab0baa58eec462eb29e0c498f986f66",
        "requirement": {
          "id": "655360-0004-001-01"
        },
        "value": "250"
      },
      {
        "id": "c5d81c755bd649f99103701d4ac2af11",
        "requirement": {
          "id": "655360-0005-001-01"
        },
        "value": "1000:1"
      },
      {
        "id": "4cafe402e83c43aa89c477f760d00907",
        "requirement": {
          "id": "655360-0006-001-01"
        },
        "value": "1"
      },
      {
        "id": "826a01de04c3489da77a770ce8bdabd5",
        "requirement": {
          "id": "655360-0007-001-01"
        },
        "value": "1"
      },
      {
        "id": "cb2a26252cc545bfa45db902b929b171",
        "requirement": {
          "id": "655360-0008-001-01"
        },
        "value": "HDMI"
      },
      {
        "id": "a3b4c8e5ba15493aaf9816ecedc236f6",
        "requirement": {
          "id": "655360-0009-001-01"
        },
        "value": "36"
      }
    ]
  }
}

Завантаження пропозиції

Потім учасник повинен завантажити документ(и) пропозиції:

POST /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/bids/29415ac0f0d54c9d9b7b4db698534302/documents?acc_token=7e91cc260b8d4c7fbd12afe11ee24975 HTTP/1.0
Authorization: Bearer broker
Content-Length: 328
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "Proposal.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6ef1648bde044fe4acda3a1e4a7bfb5b?Signature=aaG5hBDNIAC6ztLcIBGosbAUBasEzMgy6nWRnxtiYM%2F%2B4QXBFQL%2FEdq%2BmLtu47iQSqn3qcEz6B4VYjccPBicCg%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/bids/29415ac0f0d54c9d9b7b4db698534302/documents/f9e48772753847cbb8486625c7e5fc1d
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "f9e48772753847cbb8486625c7e5fc1d",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Proposal.pdf",
    "format": "application/pdf",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/bids/29415ac0f0d54c9d9b7b4db698534302/documents/f9e48772753847cbb8486625c7e5fc1d?download=6ef1648bde044fe4acda3a1e4a7bfb5b",
    "datePublished": "2021-03-16T00:00:01+02:00",
    "dateModified": "2021-03-16T00:00:01+02:00",
    "documentOf": "tender"
  }
}

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

GET /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/bids/29415ac0f0d54c9d9b7b4db698534302/documents?acc_token=7e91cc260b8d4c7fbd12afe11ee24975 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "f9e48772753847cbb8486625c7e5fc1d",
      "hash": "md5:00000000000000000000000000000000",
      "title": "Proposal.pdf",
      "format": "application/pdf",
      "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/bids/29415ac0f0d54c9d9b7b4db698534302/documents/f9e48772753847cbb8486625c7e5fc1d?download=6ef1648bde044fe4acda3a1e4a7bfb5b",
      "datePublished": "2021-03-16T00:00:01+02:00",
      "dateModified": "2021-03-16T00:00:01+02:00",
      "documentOf": "tender"
    }
  ]
}

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

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

GET /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/awards HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "50caa882244f4300aed60835d798a6a1",
      "status": "pending",
      "date": "2021-03-16T00:00:01+02:00",
      "value": {
        "amount": 459.0,
        "currency": "UAH",
        "valueAddedTaxIncluded": true
      },
      "suppliers": [
        {
          "name": "Державне управління справами",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00037256",
            "uri": "http://www.dus.gov.ua/"
          },
          "address": {
            "streetAddress": "вул. Банкова, 11, корпус 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "01220",
            "countryName": "Україна"
          },
          "contactPoint": {
            "name": "Державне управління справами",
            "telephone": "+0440000000"
          },
          "scale": "micro"
        }
      ],
      "items": [
        {
          "id": "61a6737049384b08876fb0407eda182f",
          "description": "Комп’ютерне обладнання",
          "unit": {
            "name": "штук",
            "value": {
              "amount": 6.0,
              "currency": "UAH",
              "valueAddedTaxIncluded": true
            },
            "code": "H87"
          },
          "quantity": 5.0,
          "deliveryDate": {
            "startDate": "2021-03-18T00:00:00+02:00",
            "endDate": "2021-03-21T00:00:00+02:00"
          },
          "deliveryAddress": {
            "streetAddress": "вул. Банкова 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "79000",
            "countryName": "Україна"
          },
          "classification": {
            "description": "Комп’ютерне обладнанн",
            "scheme": "ДК021",
            "id": "30230000-0"
          }
        }
      ],
      "bid_id": "29415ac0f0d54c9d9b7b4db698534302"
    },
    {
      "id": "2457dbf1f0fa43daaf6148695865ce39",
      "status": "pending",
      "date": "2021-03-16T00:00:01+02:00",
      "value": {
        "amount": 479.0,
        "currency": "UAH",
        "valueAddedTaxIncluded": true
      },
      "suppliers": [
        {
          "name": "Державне управління справами",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00037256",
            "uri": "http://www.dus.gov.ua/"
          },
          "address": {
            "streetAddress": "вул. Банкова, 11, корпус 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "01220",
            "countryName": "Україна"
          },
          "contactPoint": {
            "name": "Державне управління справами",
            "telephone": "+0440000000"
          },
          "scale": "micro"
        }
      ],
      "items": [
        {
          "id": "61a6737049384b08876fb0407eda182f",
          "description": "Комп’ютерне обладнання",
          "unit": {
            "name": "штук",
            "value": {
              "amount": 6.0,
              "currency": "UAH",
              "valueAddedTaxIncluded": true
            },
            "code": "H87"
          },
          "quantity": 5.0,
          "deliveryDate": {
            "startDate": "2021-03-18T00:00:00+02:00",
            "endDate": "2021-03-21T00:00:00+02:00"
          },
          "deliveryAddress": {
            "streetAddress": "вул. Банкова 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "79000",
            "countryName": "Україна"
          },
          "classification": {
            "description": "Комп’ютерне обладнанн",
            "scheme": "ДК021",
            "id": "30230000-0"
          }
        }
      ],
      "bid_id": "4f6256946cb844bc899c4570307f502a"
    }
  ]
}

Постачальник-переможець може підтвердити award змінивши його статус на active. Система очікуватиме підтвердження від постачальника-переможця в межах двох робочих днів.

PATCH /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/awards/2457dbf1f0fa43daaf6148695865ce39?acc_token=3a9b10d6d5544c5ab63ca47f59595980 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "2457dbf1f0fa43daaf6148695865ce39",
    "status": "active",
    "date": "2021-03-16T00:00:01+02:00",
    "value": {
      "amount": 479.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "items": [
      {
        "id": "61a6737049384b08876fb0407eda182f",
        "description": "Комп’ютерне обладнання",
        "unit": {
          "name": "штук",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "H87"
        },
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Комп’ютерне обладнанн",
          "scheme": "ДК021",
          "id": "30230000-0"
        }
      }
    ],
    "bid_id": "4f6256946cb844bc899c4570307f502a"
  }
}

Замовник може відмінити award після підтвердження змінивши його статус на cancelled у випадку якщо постачальник-переможець відмовляється підписувати контракт.

PATCH /api/2.5/tenders/db4fb6143a5f45b6953e8f010ed8064e/awards/763e8aa953f246728f00ff21743bd1dd?acc_token=151a30932ee245e989771be867bc8235 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "cancelled"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/db4fb6143a5f45b6953e8f010ed8064e/awards/e9d20fa47d934470b845028e492a8945
{
  "data": {
    "status": "cancelled",
    "items": [
      {
        "description": "Комп’ютерне обладнання",
        "classification": {
          "scheme": "ДК021",
          "description": "Комп’ютерне обладнанн",
          "id": "30230000-0"
        },
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "1f2cf1221e8f42f7af3cce0e941e14b5",
        "unit": {
          "code": "H87",
          "name": "штук"
        },
        "quantity": 1.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "bid_id": "5d821fdb36364bf59cada4ece712e18c",
    "value": {
      "currency": "UAH",
      "amount": 479.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:01+03:00",
    "id": "763e8aa953f246728f00ff21743bd1dd"
  }
}

Після відміни award, система створює другий award для цієї пропозиції у статусі pending з доступом лише Замовника. Замовник може перевести другий авард у статус unsuccessful з можливістю завантажувати супровідну документацію.

Постачальник-переможець може відмовитись від award змінивши його статус на unsuccessful.

PATCH /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/awards/50caa882244f4300aed60835d798a6a1?acc_token=7e91cc260b8d4c7fbd12afe11ee24975 HTTP/1.0
Authorization: Bearer broker
Content-Length: 36
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "unsuccessful"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "50caa882244f4300aed60835d798a6a1",
    "status": "unsuccessful",
    "date": "2021-03-16T00:00:01+02:00",
    "value": {
      "amount": 459.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "items": [
      {
        "id": "61a6737049384b08876fb0407eda182f",
        "description": "Комп’ютерне обладнання",
        "unit": {
          "name": "штук",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "H87"
        },
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Комп’ютерне обладнанн",
          "scheme": "ДК021",
          "id": "30230000-0"
        }
      }
    ],
    "bid_id": "29415ac0f0d54c9d9b7b4db698534302"
  }
}

Award буде наданий до наступної пропозиції з найбільш економічно вигідною ціною, у наступних випадках:

  1. Постачальник-переможець не підтвердив award в межах двох робочих днів.
  2. Постачальник-переможець відмовився від award.

! Примітка: У випадку переходу award останньої пропозиції у статус unsuccessful або якщо award був скаcовний Замовником процедура набуде кінцевий статус: `unsuccessful`.

Налаштування угоди

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

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

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

PATCH /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/contracts/5d8bb2b40e5f43d18d5541a2297fa3c7?acc_token=c87b58b4160f425b8973621e89008a15 HTTP/1.0
Authorization: Bearer broker
Content-Length: 91
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "contractNumber": "contract #13111",
    "value": {
      "amount": 238,
      "amountNet": 230
    }
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "5d8bb2b40e5f43d18d5541a2297fa3c7",
    "contractID": "UA-2021-03-16-000001-1",
    "contractNumber": "contract #13111",
    "status": "pending",
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "date": "2021-03-16T00:00:01+02:00",
    "value": {
      "amount": 238.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 230.0
    },
    "awardID": "2457dbf1f0fa43daaf6148695865ce39",
    "items": [
      {
        "id": "61a6737049384b08876fb0407eda182f",
        "description": "Комп’ютерне обладнання",
        "classification": {
          "description": "Комп’ютерне обладнанн",
          "scheme": "ДК021",
          "id": "30230000-0"
        },
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "unit": {
          "name": "штук",
          "code": "H87",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ]
  }
}

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

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

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

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

PATCH /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/contracts/5d8bb2b40e5f43d18d5541a2297fa3c7?acc_token=c87b58b4160f425b8973621e89008a15 HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "dateSigned": "2021-03-16T00:00:03+02:00"
  }
}

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

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

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

PATCH /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/contracts/5d8bb2b40e5f43d18d5541a2297fa3c7?acc_token=c87b58b4160f425b8973621e89008a15 HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "period": {
      "startDate": "2021-03-16T00:00:03+02:00",
      "endDate": "2022-03-16T00:00:03+02:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "5d8bb2b40e5f43d18d5541a2297fa3c7",
    "contractID": "UA-2021-03-16-000001-1",
    "contractNumber": "contract #13111",
    "status": "pending",
    "period": {
      "startDate": "2021-03-16T00:00:03+02:00",
      "endDate": "2022-03-16T00:00:03+02:00"
    },
    "dateSigned": "2021-03-16T00:00:03+02:00",
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "date": "2021-03-16T00:00:01+02:00",
    "value": {
      "amount": 238.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 230.0
    },
    "awardID": "2457dbf1f0fa43daaf6148695865ce39",
    "items": [
      {
        "id": "61a6737049384b08876fb0407eda182f",
        "description": "Комп’ютерне обладнання",
        "classification": {
          "description": "Комп’ютерне обладнанн",
          "scheme": "ДК021",
          "id": "30230000-0"
        },
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "unit": {
          "name": "штук",
          "code": "H87",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ]
  }
}

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

Ви можете завантажити документи угоди для процедури Запиту цінових пропозицій.

Завантажимо документ угоди:

POST /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/contracts/5d8bb2b40e5f43d18d5541a2297fa3c7/documents?acc_token=c87b58b4160f425b8973621e89008a15 HTTP/1.0
Authorization: Bearer broker
Content-Length: 342
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "contract_first_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/960b479e1b2b4495a032df428e5d3ebf?Signature=IMFQiFnGpyfFEVo5VKembwNYLgG5XZw0ZjpPFXFU2OxFWjTC4y4EphqmtjXF%2B%2FPGidydMeUkizUEMwF8BG4iDA%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/contracts/5d8bb2b40e5f43d18d5541a2297fa3c7/documents/58630a9dee574cedba85e5d5983775ff
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "58630a9dee574cedba85e5d5983775ff",
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_first_document.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/960b479e1b2b4495a032df428e5d3ebf?Signature=tpwVsdEVJkXH8DdrT99YRB8Fyyu2HmLh065tDRBZ%2BMMgjFWYRDY0R%2FQ6vWjjT%2FHWctDBe%2BI%2FO5cGrA8%2B08E1Bw%3D%3D&KeyID=a8968c46",
    "datePublished": "2021-03-16T00:00:03+02:00",
    "dateModified": "2021-03-16T00:00:03+02:00",
    "documentOf": "tender"
  }
}

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

Подивимось на список документів пов’язаних з угодою:

GET /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/contracts/5d8bb2b40e5f43d18d5541a2297fa3c7/documents HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "58630a9dee574cedba85e5d5983775ff",
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_first_document.doc",
      "format": "application/msword",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/960b479e1b2b4495a032df428e5d3ebf?Signature=tpwVsdEVJkXH8DdrT99YRB8Fyyu2HmLh065tDRBZ%2BMMgjFWYRDY0R%2FQ6vWjjT%2FHWctDBe%2BI%2FO5cGrA8%2B08E1Bw%3D%3D&KeyID=a8968c46",
      "datePublished": "2021-03-16T00:00:03+02:00",
      "dateModified": "2021-03-16T00:00:03+02:00",
      "documentOf": "tender"
    }
  ]
}

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

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

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

  1. Приготуйте запит на скасування.
  2. Наповніть його протоколом про причини скасування.
  3. Скасуйте закупівлю через подані причини.

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

Для відміни скасування закупівлі, вам потрібно оновити статус скасування до unsuccessful з draft чи pending

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

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

Ви повинні передати змінні reason та reasonType, status у стані draft.

При скасуванні, замовник має визначити один з чотирьох типів reasonType: noDemand, unFixable, forceMajeure aбо expensesCut.

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

POST /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/cancellations?acc_token=c87b58b4160f425b8973621e89008a15 HTTP/1.0
Authorization: Bearer broker
Content-Length: 69
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reason": "cancellation reason",
    "reasonType": "noDemand"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/cancellations/0ba60a6120604826bc9b170d0949cd4d
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "0ba60a6120604826bc9b170d0949cd4d",
    "reason": "cancellation reason",
    "date": "2021-03-16T00:00:03+02:00",
    "status": "draft",
    "cancellationOf": "tender",
    "reasonType": "noDemand"
  }
}

Ви можете виправити тип на будь-який що вказаний вище.

PATCH /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/cancellations/0ba60a6120604826bc9b170d0949cd4d?acc_token=c87b58b4160f425b8973621e89008a15 HTTP/1.0
Authorization: Bearer broker
Content-Length: 39
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reasonType": "expensesCut"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "0ba60a6120604826bc9b170d0949cd4d",
    "reason": "cancellation reason",
    "date": "2021-03-16T00:00:03+02:00",
    "status": "draft",
    "cancellationOf": "tender",
    "reasonType": "expensesCut"
  }
}

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

Цей крок обов’язковий. Без документів ви не можете оновити статус закупівлі.

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

POST /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/cancellations/0ba60a6120604826bc9b170d0949cd4d/documents?acc_token=c87b58b4160f425b8973621e89008a15 HTTP/1.0
Authorization: Bearer broker
Content-Length: 320
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/219ef1582e4b49b3b23087cafba5d07c?Signature=VzL8BlOz22syuy7hbvwWYjplq30aVz3JgXKzbXFX0bV870cKTIwjXFJP1UM34FP%2Bi7ihYhuJGMh8YngXRR3VBw%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/cancellations/0ba60a6120604826bc9b170d0949cd4d/documents/205cc90c9da944499f541b2219b6ec36
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "205cc90c9da944499f541b2219b6ec36",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/219ef1582e4b49b3b23087cafba5d07c?Signature=kJ55wI63AZMIr0sMJchkTVr%2FM9T5EODsWUsOOWq2eWXWui89t7ReNXawLKahDm4dyq%2BpCfQ7VeE1jSLrTZ20Bg%3D%3D&KeyID=a8968c46",
    "datePublished": "2021-03-16T00:00:03+02:00",
    "dateModified": "2021-03-16T00:00:03+02:00",
    "documentOf": "tender"
  }
}

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

PATCH /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/cancellations/0ba60a6120604826bc9b170d0949cd4d/documents/205cc90c9da944499f541b2219b6ec36?acc_token=c87b58b4160f425b8973621e89008a15 HTTP/1.0
Authorization: Bearer broker
Content-Length: 48
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "description": "Changed description"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "205cc90c9da944499f541b2219b6ec36",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/219ef1582e4b49b3b23087cafba5d07c?Signature=kJ55wI63AZMIr0sMJchkTVr%2FM9T5EODsWUsOOWq2eWXWui89t7ReNXawLKahDm4dyq%2BpCfQ7VeE1jSLrTZ20Bg%3D%3D&KeyID=a8968c46",
    "datePublished": "2021-03-16T00:00:03+02:00",
    "dateModified": "2021-03-16T00:00:03+02:00",
    "documentOf": "tender"
  }
}

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

PUT /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/cancellations/0ba60a6120604826bc9b170d0949cd4d/documents/205cc90c9da944499f541b2219b6ec36?acc_token=c87b58b4160f425b8973621e89008a15 HTTP/1.0
Authorization: Bearer broker
Content-Length: 324
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "Notice-2.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/da826e19829843aab44cb0acfa34523c?Signature=WWRkgcVAiZFJ18H1EfHrJDRZEdU4Lah3ArNZjouff47trE%2FCPhLX%2Bh0cP1Wz102KmU2WLh5tp4DYXAtqTeoCCQ%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "205cc90c9da944499f541b2219b6ec36",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice-2.pdf",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/da826e19829843aab44cb0acfa34523c?Signature=B0D4Oyy5MvzbxkGQzYoSoC7k%2BAukyd2sdrrh%2FtOc0jB6b4kNdvfe%2BrfPFDNHeA6JcPQHcJYkm3x%2BBbjKS2%2FhCg%3D%3D&KeyID=a8968c46",
    "datePublished": "2021-03-16T00:00:03+02:00",
    "dateModified": "2021-03-16T00:00:03+02:00",
    "documentOf": "tender"
  }
}

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

PATCH /api/2.5/tenders/e821f507458c4e99bdd9928981355ffa/cancellations/0ba60a6120604826bc9b170d0949cd4d?acc_token=c87b58b4160f425b8973621e89008a15 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "0ba60a6120604826bc9b170d0949cd4d",
    "reason": "cancellation reason",
    "date": "2021-03-16T00:00:03+02:00",
    "status": "active",
    "documents": [
      {
        "id": "205cc90c9da944499f541b2219b6ec36",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Notice.pdf",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/219ef1582e4b49b3b23087cafba5d07c?Signature=kJ55wI63AZMIr0sMJchkTVr%2FM9T5EODsWUsOOWq2eWXWui89t7ReNXawLKahDm4dyq%2BpCfQ7VeE1jSLrTZ20Bg%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:03+02:00",
        "dateModified": "2021-03-16T00:00:03+02:00",
        "documentOf": "tender"
      },
      {
        "id": "205cc90c9da944499f541b2219b6ec36",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Notice-2.pdf",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/da826e19829843aab44cb0acfa34523c?Signature=B0D4Oyy5MvzbxkGQzYoSoC7k%2BAukyd2sdrrh%2FtOc0jB6b4kNdvfe%2BrfPFDNHeA6JcPQHcJYkm3x%2BBbjKS2%2FhCg%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:03+02:00",
        "dateModified": "2021-03-16T00:00:03+02:00",
        "documentOf": "tender"
      }
    ],
    "cancellationOf": "tender",
    "reasonType": "expensesCut"
  }
}