Туторіал

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

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

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; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/tenders?offset=",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=",
    "offset": ""
  },
  "data": []
}

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

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

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
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; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Content-Type header should be one of ['application/json']",
      "location": "header",
      "name": "Content-Type"
    }
  ]
}

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

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

POST /api/2.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; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "No JSON object could be decoded",
      "location": "body",
      "name": "data"
    }
  ]
}

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

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

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

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3058
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing"
      }
    ],
    "mainProcurementCategory": "services",
    "tenderPeriod": {
      "endDate": "2020-06-01T00:00:00+02:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-21T00:00:00+02:00",
          "endDate": "2020-06-20T00:00:00+02:00"
        },
        "quantity": 1
      }
    ],
    "procurementMethodType": "aboveThresholdUA",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "kind": "special",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "countryName": "Україна",
        "postalCode": "21027",
        "region": "Вінницька область",
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця"
      }
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/437cd309c59b42df958631eac101ab7d
{
  "access": {
    "transfer": "f39c1f0ce0d84b6e981f5dd9dc590773",
    "token": "5f1045de21fe42839e29344c5d1a1e9a"
  },
  "data": {
    "procurementMethod": "open",
    "mainProcurementCategory": "services",
    "complaintPeriod": {
      "startDate": "2020-05-12T01:00:02+03:00",
      "endDate": "2020-05-28T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2020-05-12T01:00:02+03:00",
      "clarificationsUntil": "2020-05-27T00:00:00+02:00",
      "endDate": "2020-05-22T00:00:00+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-06-01T01:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      }
    },
    "owner": "broker",
    "id": "437cd309c59b42df958631eac101ab7d",
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-12-000001",
    "dateModified": "2020-05-12T01:00:02+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2020-05-12T01:00:02+03:00",
      "endDate": "2020-06-01T00:00:00+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2020-06-01T00:00:00+02:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "date": "2020-05-12T01:00:02+03:00",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "822886ff12054577aea1e29a70697f95"
      }
    ],
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-21T00:00:00+02:00",
          "endDate": "2020-06-20T00:00:00+02:00"
        },
        "id": "3d69b844d45c4c54bb368305b995d57d",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

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

Особливість відкритих торгів в тому, що procurementMethodType було змінено з belowThreshold на aboveThresholdUA. Також тут неможливо встановити enquiryPeriod, бо він буде призначений автоматично.

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

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "mainProcurementCategory": "services",
    "complaintPeriod": {
      "startDate": "2020-05-01T01:00:00+03:00",
      "endDate": "2020-05-28T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2020-05-01T01:00:00+03:00",
      "clarificationsUntil": "2020-05-27T00:00:00+02:00",
      "endDate": "2020-05-22T00:00:00+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-06-01T01:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      }
    },
    "owner": "broker",
    "id": "7898ec9992af47ccbc9b8bf1b8539660",
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-01-000001",
    "dateModified": "2020-05-01T01:00:00+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2020-05-01T01:00:00+03:00",
      "endDate": "2020-06-01T00:00:00+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2020-06-01T00:00:00+02:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "date": "2020-05-01T01:00:00+03:00",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "4c193c7458cf4a5482c231727d0a8227"
      }
    ],
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-21T00:00:00+02:00",
          "endDate": "2020-06-20T00:00:00+02:00"
        },
        "id": "f3ba6b452c3b4fd19de53486e6486c87",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

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

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

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; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/tenders?offset=2020-05-01T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2020-05-01T01%3A00%3A00%2B03%3A00",
    "offset": "2020-05-01T01:00:00+03:00"
  },
  "data": [
    {
      "id": "7898ec9992af47ccbc9b8bf1b8539660",
      "dateModified": "2020-05-01T01:00:00+03:00"
    }
  ]
}

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

Редагування закупівлі

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 68
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "tenderPeriod": {
      "endDate": "2020-05-16T01:00:10+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "mainProcurementCategory": "services",
    "complaintPeriod": {
      "startDate": "2020-05-01T01:00:00+03:00",
      "endDate": "2020-05-12T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2020-05-01T01:00:00+03:00",
      "clarificationsUntil": "2020-05-13T00:00:00+03:00",
      "endDate": "2020-05-06T01:00:10+03:00",
      "invalidationDate": "2020-05-01T01:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-05-16T01:00:10+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      }
    },
    "owner": "broker",
    "id": "7898ec9992af47ccbc9b8bf1b8539660",
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-01-000001",
    "dateModified": "2020-05-01T01:00:00+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2020-05-01T01:00:00+03:00",
      "endDate": "2020-05-16T01:00:10+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2020-05-17T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "date": "2020-05-01T01:00:00+03:00",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "4c193c7458cf4a5482c231727d0a8227"
      }
    ],
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-21T00:00:00+02:00",
          "endDate": "2020-06-20T00:00:00+02:00"
        },
        "id": "f3ba6b452c3b4fd19de53486e6486c87",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість 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; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/tenders?offset=2020-05-01T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2020-05-01T01%3A00%3A00%2B03%3A00",
    "offset": "2020-05-01T01:00:00+03:00"
  },
  "data": [
    {
      "id": "7898ec9992af47ccbc9b8bf1b8539660",
      "dateModified": "2020-05-01T01:00:00+03:00"
    }
  ]
}

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 38
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "value": {
      "amount": 501.0
    }
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "tenderPeriod should be extended by 7 days",
      "location": "body",
      "name": "data"
    }
  ]
}

Ось чому потрібно продовжити період подання пропозицій на 7 днів.

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 113
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "tenderPeriod": {
      "endDate": "2020-05-09T01:00:00+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 501
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "mainProcurementCategory": "services",
    "complaintPeriod": {
      "startDate": "2020-04-16T01:00:00+03:00",
      "endDate": "2020-05-05T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2020-04-16T01:00:00+03:00",
      "clarificationsUntil": "2020-05-06T00:00:00+03:00",
      "endDate": "2020-04-29T01:00:00+03:00",
      "invalidationDate": "2020-05-01T01:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-05-09T01:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      }
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "dateAnswered": "2020-05-01T01:00:00+03:00",
        "title": "Калорійність",
        "date": "2020-05-01T01:00:00+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "65f9591952ca461c89bdf888ef0d7f44",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "id": "7898ec9992af47ccbc9b8bf1b8539660",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    },
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "Notice.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/bfe9d05197064e0caf1b9178ba3b19f7?KeyID=a8968c46&Signature=q7dHMPmo%252BwBgRqTS7s7M6D38HE5qd8HPcJBly0nwdSCcknibQ8v48ZJu2A%2FbtOPZKqYAlDLk5oeITbfXJS2uDQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-01T01:00:00+03:00",
        "id": "3e0b35bddfa8460e8200e77639626402",
        "dateModified": "2020-05-01T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a594f87230384f29a6d77357eed08400?KeyID=a8968c46&Signature=TcG6NlAsHdOTBYPptu9qOcyTyfhZeSuLepYugjSaTvQ3El0PBrBQUi4qv7yli%2F4M2Vlme4np%2Fh72srBxE8z3Bg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-01T01:00:00+03:00",
        "id": "d99769cf61814c1199e7396aae8442b0",
        "dateModified": "2020-05-01T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/aa9b0bcf747d4ce380a60d3e734d8dcf?KeyID=a8968c46&Signature=VWGvq5XmwUlms4DuqHBysWCMrtHyTOkMHQCRkjQUvkIvOhtpyf%2FwSolqonW%252BopP4Gdpw1Kalfm%2FqrZoQKavbCA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-01T01:00:00+03:00",
        "id": "d99769cf61814c1199e7396aae8442b0",
        "dateModified": "2020-05-01T01:00:00+03:00"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-01-000001",
    "dateModified": "2020-05-01T01:00:00+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2020-04-16T01:00:00+03:00",
      "endDate": "2020-05-09T01:00:00+03:00"
    },
    "auctionPeriod": {
      "startDate": "2020-05-03T01:00:00+03:00",
      "shouldStartAfter": "2020-05-10T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "date": "2020-05-01T01:00:00+03:00",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "4c193c7458cf4a5482c231727d0a8227"
      }
    ],
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-21T00:00:00+02:00",
          "endDate": "2020-06-20T00:00:00+02:00"
        },
        "id": "f3ba6b452c3b4fd19de53486e6486c87",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 57
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "guarantee": {
      "currency": "USD",
      "amount": 8
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "mainProcurementCategory": "services",
    "complaintPeriod": {
      "startDate": "2020-05-01T01:00:00+03:00",
      "endDate": "2020-05-12T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2020-05-01T01:00:00+03:00",
      "clarificationsUntil": "2020-05-13T00:00:00+03:00",
      "endDate": "2020-05-06T01:00:10+03:00",
      "invalidationDate": "2020-05-01T01:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-05-16T01:00:10+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      }
    },
    "owner": "broker",
    "id": "7898ec9992af47ccbc9b8bf1b8539660",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    },
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-01-000001",
    "dateModified": "2020-05-01T01:00:00+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2020-05-01T01:00:00+03:00",
      "endDate": "2020-05-16T01:00:10+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2020-05-17T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "date": "2020-05-01T01:00:00+03:00",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "4c193c7458cf4a5482c231727d0a8227"
      }
    ],
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-21T00:00:00+02:00",
          "endDate": "2020-06-20T00:00:00+02:00"
        },
        "id": "f3ba6b452c3b4fd19de53486e6486c87",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

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

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

POST /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/documents?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 142
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Notice.pdf"
Content-Type: application/pdf

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/documents/3e0b35bddfa8460e8200e77639626402
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/bfe9d05197064e0caf1b9178ba3b19f7?KeyID=a8968c46&Signature=q7dHMPmo%252BwBgRqTS7s7M6D38HE5qd8HPcJBly0nwdSCcknibQ8v48ZJu2A%2FbtOPZKqYAlDLk5oeITbfXJS2uDQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-01T01:00:00+03:00",
    "id": "3e0b35bddfa8460e8200e77639626402",
    "dateModified": "2020-05-01T01:00:00+03:00"
  }
}

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

GET /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/documents/3e0b35bddfa8460e8200e77639626402?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/bfe9d05197064e0caf1b9178ba3b19f7?KeyID=a8968c46&Signature=q7dHMPmo%252BwBgRqTS7s7M6D38HE5qd8HPcJBly0nwdSCcknibQ8v48ZJu2A%2FbtOPZKqYAlDLk5oeITbfXJS2uDQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-01T01:00:00+03:00",
    "previousVersions": [],
    "id": "3e0b35bddfa8460e8200e77639626402",
    "dateModified": "2020-05-01T01:00:00+03:00"
  }
}

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

POST /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/documents?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 149
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="AwardCriteria.pdf"
Content-Type: application/pdf

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/documents/d99769cf61814c1199e7396aae8442b0
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "AwardCriteria.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a594f87230384f29a6d77357eed08400?KeyID=a8968c46&Signature=TcG6NlAsHdOTBYPptu9qOcyTyfhZeSuLepYugjSaTvQ3El0PBrBQUi4qv7yli%2F4M2Vlme4np%2Fh72srBxE8z3Bg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-01T01:00:00+03:00",
    "id": "d99769cf61814c1199e7396aae8442b0",
    "dateModified": "2020-05-01T01:00:00+03:00"
  }
}

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

GET /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/documents?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "AwardCriteria.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a594f87230384f29a6d77357eed08400?KeyID=a8968c46&Signature=TcG6NlAsHdOTBYPptu9qOcyTyfhZeSuLepYugjSaTvQ3El0PBrBQUi4qv7yli%2F4M2Vlme4np%2Fh72srBxE8z3Bg%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-01T01:00:00+03:00",
      "id": "d99769cf61814c1199e7396aae8442b0",
      "dateModified": "2020-05-01T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "Notice.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/bfe9d05197064e0caf1b9178ba3b19f7?KeyID=a8968c46&Signature=q7dHMPmo%252BwBgRqTS7s7M6D38HE5qd8HPcJBly0nwdSCcknibQ8v48ZJu2A%2FbtOPZKqYAlDLk5oeITbfXJS2uDQ%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-01T01:00:00+03:00",
      "id": "3e0b35bddfa8460e8200e77639626402",
      "dateModified": "2020-05-01T01:00:00+03:00"
    }
  ]
}

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

PUT /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/documents/d99769cf61814c1199e7396aae8442b0?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 152
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="AwardCriteria-2.pdf"
Content-Type: application/pdf

content2
-----BOUNDARY--


Response: 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.prozorro.gov.ua/get/aa9b0bcf747d4ce380a60d3e734d8dcf?KeyID=a8968c46&Signature=VWGvq5XmwUlms4DuqHBysWCMrtHyTOkMHQCRkjQUvkIvOhtpyf%2FwSolqonW%252BopP4Gdpw1Kalfm%2FqrZoQKavbCA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-01T01:00:00+03:00",
    "id": "d99769cf61814c1199e7396aae8442b0",
    "dateModified": "2020-05-01T01:00:00+03:00"
  }
}

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

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

Response: 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.prozorro.gov.ua/get/aa9b0bcf747d4ce380a60d3e734d8dcf?KeyID=a8968c46&Signature=VWGvq5XmwUlms4DuqHBysWCMrtHyTOkMHQCRkjQUvkIvOhtpyf%2FwSolqonW%252BopP4Gdpw1Kalfm%2FqrZoQKavbCA%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-01T01:00:00+03:00",
      "id": "d99769cf61814c1199e7396aae8442b0",
      "dateModified": "2020-05-01T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "Notice.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/bfe9d05197064e0caf1b9178ba3b19f7?KeyID=a8968c46&Signature=q7dHMPmo%252BwBgRqTS7s7M6D38HE5qd8HPcJBly0nwdSCcknibQ8v48ZJu2A%2FbtOPZKqYAlDLk5oeITbfXJS2uDQ%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-01T01:00:00+03:00",
      "id": "3e0b35bddfa8460e8200e77639626402",
      "dateModified": "2020-05-01T01:00:00+03:00"
    }
  ]
}

Уточнення і запитання

Якщо закупівля має статус active.tendering та дата завершення періоду подання пропозицій Tender.enqueryPeriod.endDate ще не прийшла , то зацікавлені учасники можуть задавати питання чи просити уточнень умов закупівлі:

POST /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/questions HTTP/1.0
Authorization: Bearer broker
Content-Length: 1147
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "author": {
      "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": {
        "countryName": "Україна",
        "postalCode": "79013",
        "region": "Львівська область",
        "streetAddress": "вул. Островського, 34",
        "locality": "м. Львів"
      }
    },
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/questions/65f9591952ca461c89bdf888ef0d7f44
{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "author": {
      "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": "м. Львів"
      }
    },
    "title": "Калорійність",
    "date": "2020-05-01T01:00:00+03:00",
    "id": "65f9591952ca461c89bdf888ef0d7f44",
    "questionOf": "tender"
  }
}

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/questions/65f9591952ca461c89bdf888ef0d7f44?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 162
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "dateAnswered": "2020-05-01T01:00:00+03:00",
    "title": "Калорійність",
    "date": "2020-05-01T01:00:00+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "65f9591952ca461c89bdf888ef0d7f44",
    "questionOf": "tender"
  }
}

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

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "description": "Просимо додати таблицю потрібної калорійності харчування",
      "dateAnswered": "2020-05-01T01:00:00+03:00",
      "title": "Калорійність",
      "date": "2020-05-01T01:00:00+03:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "id": "65f9591952ca461c89bdf888ef0d7f44",
      "questionOf": "tender"
    }
  ]
}

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

GET /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/questions/65f9591952ca461c89bdf888ef0d7f44 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "dateAnswered": "2020-05-01T01:00:00+03:00",
    "title": "Калорійність",
    "date": "2020-05-01T01:00:00+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "65f9591952ca461c89bdf888ef0d7f44",
    "questionOf": "tender"
  }
}

Запитання можна задавати лише протягом періоду уточнень Tender.enqueryPeriod.

POST /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/questions HTTP/1.0
Authorization: Bearer broker
Content-Length: 1147
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "author": {
      "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": {
        "countryName": "Україна",
        "postalCode": "79013",
        "region": "Львівська область",
        "streetAddress": "вул. Островського, 34",
        "locality": "м. Львів"
      }
    },
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність"
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Can add question only in enquiryPeriod",
      "location": "body",
      "name": "data"
    }
  ]
}

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

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

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

POST /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 982
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "selfEligible": true,
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "selfQualified": true,
    "value": {
      "amount": 500
    },
    "tenderers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "name": "Сергій Олексюк",
          "telephone": "+380 (432) 21-69-30"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "Вінницька область",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab
{
  "access": {
    "transfer": "cc966f284bd94f9f8cf9d333d3f742c0",
    "token": "209d79fd54db4c518400dd7525b7be77"
  },
  "data": {
    "status": "active",
    "selfEligible": true,
    "id": "9d3968fda7eb41c0a97e5273a1d682ab",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "tenderers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "date": "2020-05-01T01:00:00+03:00",
    "selfQualified": true
  }
}

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab?acc_token=209d79fd54db4c518400dd7525b7be77 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; charset=UTF-8
null

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

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

POST /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab/documents?acc_token=209d79fd54db4c518400dd7525b7be77 HTTP/1.0
Authorization: Bearer broker
Content-Length: 144
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Proposal.pdf"
Content-Type: application/pdf

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab/documents/42ff9ef81bd34593b55504cebd975ffb
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Proposal.pdf",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab/documents/42ff9ef81bd34593b55504cebd975ffb?download=d26aaff06c9446618472802e7db9b75b",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-01T01:00:00+03:00",
    "id": "42ff9ef81bd34593b55504cebd975ffb",
    "dateModified": "2020-05-01T01:00:00+03:00"
  }
}

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

GET /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab/documents?acc_token=209d79fd54db4c518400dd7525b7be77 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "Proposal.pdf",
      "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab/documents/42ff9ef81bd34593b55504cebd975ffb?download=d26aaff06c9446618472802e7db9b75b",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-01T01:00:00+03:00",
      "id": "42ff9ef81bd34593b55504cebd975ffb",
      "dateModified": "2020-05-01T01:00:00+03:00"
    }
  ]
}

Пропозиція стає недійсною

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

GET /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab?acc_token=209d79fd54db4c518400dd7525b7be77 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "invalid",
    "id": "9d3968fda7eb41c0a97e5273a1d682ab"
  }
}

Підтвердження пропозиції

Учасник повинен підтвердити свою пропозицію:

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab?acc_token=209d79fd54db4c518400dd7525b7be77 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; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab/documents/42ff9ef81bd34593b55504cebd975ffb?download=d26aaff06c9446618472802e7db9b75b",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-01T01:00:00+03:00",
        "id": "42ff9ef81bd34593b55504cebd975ffb",
        "dateModified": "2020-05-01T01:00:00+03:00"
      }
    ],
    "selfEligible": true,
    "id": "9d3968fda7eb41c0a97e5273a1d682ab",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "tenderers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "date": "2020-05-01T01:00:00+03:00",
    "selfQualified": true
  }
}

Для того, щоб процедура відкритих торгів відбулась, необхідно хоча б два учасника, тобто хоча б дві пропозиції повинні бути зареєстровані до початку аукціону:

POST /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 824
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "selfEligible": true,
    "selfQualified": true,
    "value": {
      "amount": 499
    },
    "tenderers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "79013",
          "region": "Львівська область",
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів"
        }
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/74cd11740bab485cac5b0bb55ab266f6
{
  "access": {
    "transfer": "7833f5ce12584933b4f5be14567aa303",
    "token": "3bfe36dbfc044463bcb4611c9bf51d4e"
  },
  "data": {
    "status": "active",
    "selfEligible": true,
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "selfQualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "date": "2020-05-01T01:00:00+03:00",
    "id": "74cd11740bab485cac5b0bb55ab266f6"
  }
}

Аукціон

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

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "mainProcurementCategory": "services",
    "complaintPeriod": {
      "startDate": "2020-04-15T01:00:00+03:00",
      "endDate": "2020-04-27T00:00:00+03:00"
    },
    "auctionUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/7898ec9992af47ccbc9b8bf1b8539660",
    "enquiryPeriod": {
      "startDate": "2020-04-15T01:00:00+03:00",
      "clarificationsUntil": "2020-04-25T00:00:00+03:00",
      "endDate": "2020-04-21T01:00:00+03:00",
      "invalidationDate": "2020-05-01T01:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-05-01T01:36:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      }
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "dateAnswered": "2020-05-01T01:00:00+03:00",
        "title": "Калорійність",
        "date": "2020-05-01T01:00:00+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "65f9591952ca461c89bdf888ef0d7f44",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "id": "7898ec9992af47ccbc9b8bf1b8539660",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    },
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "Notice.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/bfe9d05197064e0caf1b9178ba3b19f7?KeyID=a8968c46&Signature=q7dHMPmo%252BwBgRqTS7s7M6D38HE5qd8HPcJBly0nwdSCcknibQ8v48ZJu2A%2FbtOPZKqYAlDLk5oeITbfXJS2uDQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-01T01:00:00+03:00",
        "id": "3e0b35bddfa8460e8200e77639626402",
        "dateModified": "2020-05-01T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a594f87230384f29a6d77357eed08400?KeyID=a8968c46&Signature=TcG6NlAsHdOTBYPptu9qOcyTyfhZeSuLepYugjSaTvQ3El0PBrBQUi4qv7yli%2F4M2Vlme4np%2Fh72srBxE8z3Bg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-01T01:00:00+03:00",
        "id": "d99769cf61814c1199e7396aae8442b0",
        "dateModified": "2020-05-01T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/aa9b0bcf747d4ce380a60d3e734d8dcf?KeyID=a8968c46&Signature=VWGvq5XmwUlms4DuqHBysWCMrtHyTOkMHQCRkjQUvkIvOhtpyf%2FwSolqonW%252BopP4Gdpw1Kalfm%2FqrZoQKavbCA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-01T01:00:00+03:00",
        "id": "d99769cf61814c1199e7396aae8442b0",
        "dateModified": "2020-05-01T01:00:00+03:00"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-01-000001",
    "dateModified": "2020-05-01T01:00:00+03:00",
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2020-04-15T01:00:00+03:00",
      "endDate": "2020-05-01T01:00:00+03:00"
    },
    "auctionPeriod": {
      "startDate": "2020-05-01T01:00:00+03:00",
      "shouldStartAfter": "2020-05-02T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "date": "2020-05-01T01:00:00+03:00",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "4c193c7458cf4a5482c231727d0a8227"
      }
    ],
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-21T00:00:00+02:00",
          "endDate": "2020-06-20T00:00:00+02:00"
        },
        "id": "f3ba6b452c3b4fd19de53486e6486c87",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

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

GET /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab?acc_token=209d79fd54db4c518400dd7525b7be77 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/9d3968fda7eb41c0a97e5273a1d682ab/documents/42ff9ef81bd34593b55504cebd975ffb?download=d26aaff06c9446618472802e7db9b75b",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-01T01:00:00+03:00",
        "id": "42ff9ef81bd34593b55504cebd975ffb",
        "dateModified": "2020-05-01T01:00:00+03:00"
      }
    ],
    "selfEligible": true,
    "id": "9d3968fda7eb41c0a97e5273a1d682ab",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "tenderers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "date": "2020-05-01T01:00:00+03:00",
    "selfQualified": true,
    "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/7898ec9992af47ccbc9b8bf1b8539660?key_for_bid=9d3968fda7eb41c0a97e5273a1d682ab"
  }
}

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

GET /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/74cd11740bab485cac5b0bb55ab266f6?acc_token=3bfe36dbfc044463bcb4611c9bf51d4e HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "selfEligible": true,
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "id": "74cd11740bab485cac5b0bb55ab266f6",
    "tenderers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "date": "2020-05-01T01:00:00+03:00",
    "selfQualified": true,
    "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/7898ec9992af47ccbc9b8bf1b8539660?key_for_bid=74cd11740bab485cac5b0bb55ab266f6"
  }
}

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

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/awards/742c6507f29f4b5fa26b642d0f57f58c?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 67
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active",
    "qualified": true,
    "eligible": true
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "eligible": true,
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "complaintPeriod": {
      "startDate": "2020-05-01T01:00:00+03:00",
      "endDate": "2020-05-12T00:00:00+03:00"
    },
    "bid_id": "74cd11740bab485cac5b0bb55ab266f6",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "qualified": true,
    "date": "2020-05-01T01:00:00+03:00",
    "id": "742c6507f29f4b5fa26b642d0f57f58c"
  }
}

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

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

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/contracts/852bf41b6c8542d28bc7364f67533023?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 54
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "value": {
      "amount": 238,
      "amountNet": 230
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-21T00:00:00+02:00",
          "endDate": "2020-06-20T00:00:00+02:00"
        },
        "id": "f3ba6b452c3b4fd19de53486e6486c87",
        "quantity": 1.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-01T01:00:00+03:00",
    "awardID": "742c6507f29f4b5fa26b642d0f57f58c",
    "id": "852bf41b6c8542d28bc7364f67533023",
    "contractID": "UA-2020-05-01-000001-1"
  }
}

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

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

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

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/contracts/852bf41b6c8542d28bc7364f67533023?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "dateSigned": "2020-05-01T01:00:01+03:00"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-21T00:00:00+02:00",
          "endDate": "2020-06-20T00:00:00+02:00"
        },
        "id": "f3ba6b452c3b4fd19de53486e6486c87",
        "quantity": 1.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "date": "2020-05-01T01:00:00+03:00",
    "awardID": "742c6507f29f4b5fa26b642d0f57f58c",
    "id": "852bf41b6c8542d28bc7364f67533023",
    "contractID": "UA-2020-05-01-000001-1"
  }
}

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

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/contracts/852bf41b6c8542d28bc7364f67533023?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "period": {
      "startDate": "2020-05-01T01:00:01+03:00",
      "endDate": "2021-05-01T01:00:01+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-21T00:00:00+02:00",
          "endDate": "2020-06-20T00:00:00+02:00"
        },
        "id": "f3ba6b452c3b4fd19de53486e6486c87",
        "quantity": 1.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "period": {
      "startDate": "2020-05-01T01:00:01+03:00",
      "endDate": "2021-05-01T01:00:01+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "date": "2020-05-01T01:00:00+03:00",
    "awardID": "742c6507f29f4b5fa26b642d0f57f58c",
    "id": "852bf41b6c8542d28bc7364f67533023",
    "contractID": "UA-2020-05-01-000001-1"
  }
}

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

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

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

POST /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/contracts/852bf41b6c8542d28bc7364f67533023/documents?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 156
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract_document.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/contracts/852bf41b6c8542d28bc7364f67533023/documents/661c8a26e1424effa4b93edfe940c20b
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e9cc7a88b5ec4596802e0ac5ecf5b0b6?KeyID=a8968c46&Signature=NniKkDk7XD5cuUFN%2FzgzsnbT2%2FzcTeFkY6wCqeCGTYn2j4jhpUEadS%252BlB6OdOW7cUIGuph431CC%252BLhx6D9pKCw%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2020-05-01T01:00:01+03:00",
    "id": "661c8a26e1424effa4b93edfe940c20b",
    "dateModified": "2020-05-01T01:00:01+03:00"
  }
}

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

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

GET /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/contracts/852bf41b6c8542d28bc7364f67533023?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e9cc7a88b5ec4596802e0ac5ecf5b0b6?KeyID=a8968c46&Signature=NniKkDk7XD5cuUFN%2FzgzsnbT2%2FzcTeFkY6wCqeCGTYn2j4jhpUEadS%252BlB6OdOW7cUIGuph431CC%252BLhx6D9pKCw%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "661c8a26e1424effa4b93edfe940c20b",
        "dateModified": "2020-05-01T01:00:01+03:00"
      }
    ],
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-21T00:00:00+02:00",
          "endDate": "2020-06-20T00:00:00+02:00"
        },
        "id": "f3ba6b452c3b4fd19de53486e6486c87",
        "quantity": 1.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "period": {
      "startDate": "2020-05-01T01:00:01+03:00",
      "endDate": "2021-05-01T01:00:01+03:00"
    },
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-01T01:00:00+03:00",
    "awardID": "742c6507f29f4b5fa26b642d0f57f58c",
    "id": "852bf41b6c8542d28bc7364f67533023",
    "contractID": "UA-2020-05-01-000001-1"
  }
}

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

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

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

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

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

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

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

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

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

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

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

POST /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/cancellations?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 70
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reason": "cancellation reason",
    "reasonType": "unFixable"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/cancellations/c7fb36d745c44f4ca4779bd0fee9fe03
{
  "data": {
    "status": "draft",
    "reason": "cancellation reason",
    "reasonType": "unFixable",
    "date": "2020-05-01T01:00:01+03:00",
    "cancellationOf": "tender",
    "id": "c7fb36d745c44f4ca4779bd0fee9fe03"
  }
}

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/cancellations/c7fb36d745c44f4ca4779bd0fee9fe03?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 40
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reasonType": "forceMajeure"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "draft",
    "reason": "cancellation reason",
    "reasonType": "forceMajeure",
    "date": "2020-05-01T01:00:01+03:00",
    "cancellationOf": "tender",
    "id": "c7fb36d745c44f4ca4779bd0fee9fe03"
  }
}

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

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

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

POST /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/cancellations/c7fb36d745c44f4ca4779bd0fee9fe03/documents?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 142
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Notice.pdf"
Content-Type: application/pdf

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/cancellations/c7fb36d745c44f4ca4779bd0fee9fe03/documents/2feef28b6ec545889fa03c078fe66c16
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/2e3ce0ad16934372beca9ade6b745cbe?KeyID=a8968c46&Signature=fT1wzEKos%2Fkh9%2FnKZ3ZK9OFGe29g1WlvGfD%252BhQCphK71OV%2FwTYZ8UZMW5bEbiaK4oMhN1tx%2FdIzLfbdIeq4WAw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-01T01:00:01+03:00",
    "id": "2feef28b6ec545889fa03c078fe66c16",
    "dateModified": "2020-05-01T01:00:01+03:00"
  }
}

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/cancellations/c7fb36d745c44f4ca4779bd0fee9fe03/documents/2feef28b6ec545889fa03c078fe66c16?acc_token=62607c36ce4a4d64961ecc0d0a21540e 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; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/2e3ce0ad16934372beca9ade6b745cbe?KeyID=a8968c46&Signature=fT1wzEKos%2Fkh9%2FnKZ3ZK9OFGe29g1WlvGfD%252BhQCphK71OV%2FwTYZ8UZMW5bEbiaK4oMhN1tx%2FdIzLfbdIeq4WAw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-01T01:00:01+03:00",
    "id": "2feef28b6ec545889fa03c078fe66c16",
    "dateModified": "2020-05-01T01:00:01+03:00"
  }
}

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

PUT /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/cancellations/c7fb36d745c44f4ca4779bd0fee9fe03/documents/2feef28b6ec545889fa03c078fe66c16?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 145
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Notice-2.pdf"
Content-Type: application/pdf

content2
-----BOUNDARY--


Response: 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.prozorro.gov.ua/get/471b8bd548264f75b627d3234ba1b379?KeyID=a8968c46&Signature=drx19S4KzlVXSpihOP30VcIMk3%2FDXuzvcLf7asTyatKOG8aNqUaZtHsTrbFMrzt%252Bg16%252BbJskLh3McEqras3bDQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-01T01:00:01+03:00",
    "id": "2feef28b6ec545889fa03c078fe66c16",
    "dateModified": "2020-05-01T01:00:01+03:00"
  }
}

Проходження періоду оскарження

Для того щоб перейти до періоду оскарження потрібно змінити стаутс скасування з draft на pending.

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/cancellations/c7fb36d745c44f4ca4779bd0fee9fe03?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Content-Length: 31
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "pending"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/2e3ce0ad16934372beca9ade6b745cbe?KeyID=a8968c46&Signature=fT1wzEKos%2Fkh9%2FnKZ3ZK9OFGe29g1WlvGfD%252BhQCphK71OV%2FwTYZ8UZMW5bEbiaK4oMhN1tx%2FdIzLfbdIeq4WAw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "2feef28b6ec545889fa03c078fe66c16",
        "dateModified": "2020-05-01T01:00:01+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/471b8bd548264f75b627d3234ba1b379?KeyID=a8968c46&Signature=drx19S4KzlVXSpihOP30VcIMk3%2FDXuzvcLf7asTyatKOG8aNqUaZtHsTrbFMrzt%252Bg16%252BbJskLh3McEqras3bDQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "2feef28b6ec545889fa03c078fe66c16",
        "dateModified": "2020-05-01T01:00:01+03:00"
      }
    ],
    "complaintPeriod": {
      "startDate": "2020-05-01T01:00:01+03:00",
      "endDate": "2020-05-12T00:00:00+03:00"
    },
    "reason": "cancellation reason",
    "reasonType": "forceMajeure",
    "date": "2020-05-01T01:00:01+03:00",
    "cancellationOf": "tender",
    "id": "c7fb36d745c44f4ca4779bd0fee9fe03"
  }
}

Коли скасування закупівлі в статусі pending замовнику зобороняються всі дії по закупівлі.

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

Якщо період оскарження(триває 10 днів) скінчився та не було ніяких скарг на скасування закупівлі або скарги були скасовані, то скасування автоматично зміює статус на active