Туторіал

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

Подивимось як працює точка входу /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: 3066
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-10T00: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-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "quantity": 1
      }
    ],
    "procurementMethodType": "aboveThresholdUA.defense",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "kind": "defense",
      "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/0ef1a1deea644023b37adc3b1d8b274a
{
  "access": {
    "transfer": "f8dd5b28e514413398d521e229cef605",
    "token": "e87d33506acd4c17b37f8d1f2d550f54"
  },
  "data": {
    "procurementMethod": "open",
    "mainProcurementCategory": "services",
    "complaintPeriod": {
      "startDate": "2020-05-26T01:00:05+03:00",
      "endDate": "2020-06-05T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2020-05-26T01:00:05+03:00",
      "clarificationsUntil": "2020-06-06T00:00:00+02:00",
      "endDate": "2020-06-04T00:00:00+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-06-10T01: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 Вінницької міської ради\""
      },
      "kind": "defense",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      },
      "name": "ЗОСШ #10 м.Вінниці"
    },
    "owner": "broker",
    "id": "0ef1a1deea644023b37adc3b1d8b274a",
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-26-000001",
    "dateModified": "2020-05-26T01:00:05+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2020-05-26T01:00:05+03:00",
      "endDate": "2020-06-10T00:00:00+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2020-06-10T00:00:00+02:00"
    },
    "procurementMethodType": "aboveThresholdUA.defense",
    "date": "2020-05-26T01:00:05+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": "6463f3b0c39d454da8ba49f5c1e050d1"
      }
    ],
    "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-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "a1485588dd194c258efdd9df84e636ff",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

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

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

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb 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-15T01:00:00+03:00",
      "endDate": "2020-06-05T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "clarificationsUntil": "2020-06-06T00:00:00+02:00",
      "endDate": "2020-06-04T00:00:00+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-06-10T01: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 Вінницької міської ради\""
      },
      "kind": "defense",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      },
      "name": "ЗОСШ #10 м.Вінниці"
    },
    "owner": "broker",
    "id": "127bd59fdd464def8d1189b954eefcbb",
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-15-000001",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-06-10T00:00:00+02:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2020-06-10T00:00:00+02:00"
    },
    "procurementMethodType": "aboveThresholdUA.defense",
    "date": "2020-05-15T01: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": "ca388d7e9a7b43b1857dd01b677e64be"
      }
    ],
    "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-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "c44dbd3e52ea497088ba82bff063bed9",
        "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-15T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2020-05-15T01%3A00%3A00%2B03%3A00",
    "offset": "2020-05-15T01:00:00+03:00"
  },
  "data": [
    {
      "id": "127bd59fdd464def8d1189b954eefcbb",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

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

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

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb?acc_token=78250e99c9974266933e656d51b30048 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-31T01:00:00+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "mainProcurementCategory": "services",
    "complaintPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-28T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "clarificationsUntil": "2020-05-29T00:00:00+03:00",
      "endDate": "2020-05-27T00:00:00+03:00",
      "invalidationDate": "2020-05-15T01:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-05-31T01: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 Вінницької міської ради\""
      },
      "kind": "defense",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      },
      "name": "ЗОСШ #10 м.Вінниці"
    },
    "owner": "broker",
    "id": "127bd59fdd464def8d1189b954eefcbb",
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-15-000001",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-31T01:00:00+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2020-06-01T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA.defense",
    "date": "2020-05-15T01: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": "ca388d7e9a7b43b1857dd01b677e64be"
      }
    ],
    "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-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "c44dbd3e52ea497088ba82bff063bed9",
        "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-15T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2020-05-15T01%3A00%3A00%2B03%3A00",
    "offset": "2020-05-15T01:00:00+03:00"
  },
  "data": [
    {
      "id": "127bd59fdd464def8d1189b954eefcbb",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb?acc_token=78250e99c9974266933e656d51b30048 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 2 working days",
      "location": "body",
      "name": "data"
    }
  ]
}

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb?acc_token=78250e99c9974266933e656d51b30048 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-23T01:00:01+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-05-02T01:00:00+03:00",
      "endDate": "2020-05-21T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2020-05-02T01:00:00+03:00",
      "clarificationsUntil": "2020-05-22T00:00:00+03:00",
      "endDate": "2020-05-20T00:00:00+03:00",
      "invalidationDate": "2020-05-15T01:00:01+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-05-23T01:00:01+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 Вінницької міської ради\""
      },
      "kind": "defense",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      },
      "name": "ЗОСШ #10 м.Вінниці"
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "dateAnswered": "2020-05-15T01:00:00+03:00",
        "title": "Калорійність",
        "date": "2020-05-15T01:00:00+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "997d92880fb34795ab24da25cdd60c8a",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "id": "127bd59fdd464def8d1189b954eefcbb",
    "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/a9ab51e8a42a44b687a43b3a62414c36?KeyID=a8968c46&Signature=CG2s%2FcG7rQ%252B2B%2F3w%252Bb8QhV4MNX4V85fU5emXeDdqgwNZET10gAlb9WkWSqHinqQSJmJSOd%2FVJL%2FqbQhEuBXTAw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "05b87dabf12244cd94fe2f51636ad002",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6f212629e7e2470f9511a6ad67de57a0?KeyID=a8968c46&Signature=IV6gbyGAfhUQRz20VDT4AFzwKBxGpIra6PUrdwbeEhLU3YaEu0FdfsD%252Btjg06QtC3Mo68QYE2StBDLB0sqGQBQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "af19de0bb1e149869a2fa37596133890",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/9d677673b67647ef8daf56d585b9cb5c?KeyID=a8968c46&Signature=RUklL7sP%252ByI%2Fszpq1HkUN2MPgx%2FxRgra1dhJg6QZiQ5AqY7PUQ7Rpo1EeJMVLiANHdon3HmXll14JLSvmk4IBA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "af19de0bb1e149869a2fa37596133890",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-15-000001",
    "dateModified": "2020-05-15T01:00:01+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2020-05-02T01:00:00+03:00",
      "endDate": "2020-05-23T01:00:01+03:00"
    },
    "auctionPeriod": {
      "startDate": "2020-05-17T01:00:00+03:00",
      "shouldStartAfter": "2020-05-24T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA.defense",
    "date": "2020-05-15T01: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": "ca388d7e9a7b43b1857dd01b677e64be"
      }
    ],
    "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-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "c44dbd3e52ea497088ba82bff063bed9",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

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

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

POST /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/documents?acc_token=78250e99c9974266933e656d51b30048 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/127bd59fdd464def8d1189b954eefcbb/documents/05b87dabf12244cd94fe2f51636ad002
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a9ab51e8a42a44b687a43b3a62414c36?KeyID=a8968c46&Signature=CG2s%2FcG7rQ%252B2B%2F3w%252Bb8QhV4MNX4V85fU5emXeDdqgwNZET10gAlb9WkWSqHinqQSJmJSOd%2FVJL%2FqbQhEuBXTAw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "05b87dabf12244cd94fe2f51636ad002",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/documents/05b87dabf12244cd94fe2f51636ad002?acc_token=78250e99c9974266933e656d51b30048 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/a9ab51e8a42a44b687a43b3a62414c36?KeyID=a8968c46&Signature=CG2s%2FcG7rQ%252B2B%2F3w%252Bb8QhV4MNX4V85fU5emXeDdqgwNZET10gAlb9WkWSqHinqQSJmJSOd%2FVJL%2FqbQhEuBXTAw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "previousVersions": [],
    "id": "05b87dabf12244cd94fe2f51636ad002",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

POST /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/documents?acc_token=78250e99c9974266933e656d51b30048 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/127bd59fdd464def8d1189b954eefcbb/documents/af19de0bb1e149869a2fa37596133890
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "AwardCriteria.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6f212629e7e2470f9511a6ad67de57a0?KeyID=a8968c46&Signature=IV6gbyGAfhUQRz20VDT4AFzwKBxGpIra6PUrdwbeEhLU3YaEu0FdfsD%252Btjg06QtC3Mo68QYE2StBDLB0sqGQBQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "af19de0bb1e149869a2fa37596133890",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/documents?acc_token=78250e99c9974266933e656d51b30048 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/a9ab51e8a42a44b687a43b3a62414c36?KeyID=a8968c46&Signature=CG2s%2FcG7rQ%252B2B%2F3w%252Bb8QhV4MNX4V85fU5emXeDdqgwNZET10gAlb9WkWSqHinqQSJmJSOd%2FVJL%2FqbQhEuBXTAw%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "05b87dabf12244cd94fe2f51636ad002",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "AwardCriteria.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6f212629e7e2470f9511a6ad67de57a0?KeyID=a8968c46&Signature=IV6gbyGAfhUQRz20VDT4AFzwKBxGpIra6PUrdwbeEhLU3YaEu0FdfsD%252Btjg06QtC3Mo68QYE2StBDLB0sqGQBQ%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "af19de0bb1e149869a2fa37596133890",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

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

PUT /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/documents/af19de0bb1e149869a2fa37596133890?acc_token=78250e99c9974266933e656d51b30048 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/9d677673b67647ef8daf56d585b9cb5c?KeyID=a8968c46&Signature=RUklL7sP%252ByI%2Fszpq1HkUN2MPgx%2FxRgra1dhJg6QZiQ5AqY7PUQ7Rpo1EeJMVLiANHdon3HmXll14JLSvmk4IBA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "af19de0bb1e149869a2fa37596133890",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/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": "Notice.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a9ab51e8a42a44b687a43b3a62414c36?KeyID=a8968c46&Signature=CG2s%2FcG7rQ%252B2B%2F3w%252Bb8QhV4MNX4V85fU5emXeDdqgwNZET10gAlb9WkWSqHinqQSJmJSOd%2FVJL%2FqbQhEuBXTAw%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "05b87dabf12244cd94fe2f51636ad002",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "AwardCriteria-2.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/9d677673b67647ef8daf56d585b9cb5c?KeyID=a8968c46&Signature=RUklL7sP%252ByI%2Fszpq1HkUN2MPgx%2FxRgra1dhJg6QZiQ5AqY7PUQ7Rpo1EeJMVLiANHdon3HmXll14JLSvmk4IBA%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "af19de0bb1e149869a2fa37596133890",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

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

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

POST /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/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/127bd59fdd464def8d1189b954eefcbb/questions/997d92880fb34795ab24da25cdd60c8a
{
  "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-15T01:00:00+03:00",
    "id": "997d92880fb34795ab24da25cdd60c8a",
    "questionOf": "tender"
  }
}

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/questions/997d92880fb34795ab24da25cdd60c8a?acc_token=78250e99c9974266933e656d51b30048 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-15T01:00:00+03:00",
    "title": "Калорійність",
    "date": "2020-05-15T01:00:00+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "997d92880fb34795ab24da25cdd60c8a",
    "questionOf": "tender"
  }
}

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/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-15T01:00:00+03:00",
      "title": "Калорійність",
      "date": "2020-05-15T01:00:00+03:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "id": "997d92880fb34795ab24da25cdd60c8a",
      "questionOf": "tender"
    }
  ]
}

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/questions/997d92880fb34795ab24da25cdd60c8a 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-15T01:00:00+03:00",
    "title": "Калорійність",
    "date": "2020-05-15T01:00:00+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "997d92880fb34795ab24da25cdd60c8a",
    "questionOf": "tender"
  }
}

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

POST /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/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 дозволяє подання пропозицій.

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

POST /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/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,
    "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": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "Вінницька область",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "selfQualified": true,
    "value": {
      "amount": 500
    },
    "subcontractingDetails": "ДКП «Орфей», Україна"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/bids/a97583e039614cc4b45231194304b231
{
  "access": {
    "transfer": "d5756578a82f48fba71a9186e94a15de",
    "token": "d2f6e6c8a7a54d2cb138ef2ef5de765a"
  },
  "data": {
    "status": "active",
    "selfEligible": true,
    "id": "a97583e039614cc4b45231194304b231",
    "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-15T01:00:01+03:00",
    "selfQualified": true
  }
}

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

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

POST /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/bids/a97583e039614cc4b45231194304b231/documents?acc_token=d2f6e6c8a7a54d2cb138ef2ef5de765a 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/127bd59fdd464def8d1189b954eefcbb/bids/a97583e039614cc4b45231194304b231/documents/c6096921d1ff45269d9b15a2b6013423
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Proposal.pdf",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/bids/a97583e039614cc4b45231194304b231/documents/c6096921d1ff45269d9b15a2b6013423?download=e57e684075ba45b286a6d9239862fef5",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:01+03:00",
    "id": "c6096921d1ff45269d9b15a2b6013423",
    "dateModified": "2020-05-15T01:00:01+03:00"
  }
}

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/bids/a97583e039614cc4b45231194304b231/documents?acc_token=d2f6e6c8a7a54d2cb138ef2ef5de765a 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/127bd59fdd464def8d1189b954eefcbb/bids/a97583e039614cc4b45231194304b231/documents/c6096921d1ff45269d9b15a2b6013423?download=e57e684075ba45b286a6d9239862fef5",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:01+03:00",
      "id": "c6096921d1ff45269d9b15a2b6013423",
      "dateModified": "2020-05-15T01:00:01+03:00"
    }
  ]
}

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

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/bids/a97583e039614cc4b45231194304b231?acc_token=d2f6e6c8a7a54d2cb138ef2ef5de765a 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": "a97583e039614cc4b45231194304b231"
  }
}

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

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/bids/a97583e039614cc4b45231194304b231?acc_token=d2f6e6c8a7a54d2cb138ef2ef5de765a 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/127bd59fdd464def8d1189b954eefcbb/bids/a97583e039614cc4b45231194304b231/documents/c6096921d1ff45269d9b15a2b6013423?download=e57e684075ba45b286a6d9239862fef5",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "id": "c6096921d1ff45269d9b15a2b6013423",
        "dateModified": "2020-05-15T01:00:01+03:00"
      }
    ],
    "selfEligible": true,
    "id": "a97583e039614cc4b45231194304b231",
    "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-15T01:00:01+03:00",
    "selfQualified": true
  }
}

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

POST /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/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/127bd59fdd464def8d1189b954eefcbb/bids/844a8e0cf0f14d1bb310d7046066f966
{
  "access": {
    "transfer": "f349d3fec1284796be806de9b698acd6",
    "token": "bbf4baf749f54990802f4c33f55e7fae"
  },
  "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-15T01:00:01+03:00",
    "id": "844a8e0cf0f14d1bb310d7046066f966"
  }
}

Зверніть увагу!

Якщо немає жодного учасника, то закупівля оголошується неуспішною - unsuccessful.

Якщо є лише один учасник, то процедура переходить у статус active.qualification (див. підтвердження кваліфікації).

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

Аукціон

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb 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-29T01:00:01+03:00",
      "endDate": "2020-05-13T00:00:00+03:00"
    },
    "auctionUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/127bd59fdd464def8d1189b954eefcbb",
    "enquiryPeriod": {
      "startDate": "2020-04-29T01:00:01+03:00",
      "clarificationsUntil": "2020-05-14T00:00:00+03:00",
      "endDate": "2020-05-12T00:00:00+03:00",
      "invalidationDate": "2020-05-15T01:00:01+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-05-15T01:36:01+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 Вінницької міської ради\""
      },
      "kind": "defense",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      },
      "name": "ЗОСШ #10 м.Вінниці"
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "dateAnswered": "2020-05-15T01:00:00+03:00",
        "title": "Калорійність",
        "date": "2020-05-15T01:00:00+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "997d92880fb34795ab24da25cdd60c8a",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "id": "127bd59fdd464def8d1189b954eefcbb",
    "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/a9ab51e8a42a44b687a43b3a62414c36?KeyID=a8968c46&Signature=CG2s%2FcG7rQ%252B2B%2F3w%252Bb8QhV4MNX4V85fU5emXeDdqgwNZET10gAlb9WkWSqHinqQSJmJSOd%2FVJL%2FqbQhEuBXTAw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "05b87dabf12244cd94fe2f51636ad002",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6f212629e7e2470f9511a6ad67de57a0?KeyID=a8968c46&Signature=IV6gbyGAfhUQRz20VDT4AFzwKBxGpIra6PUrdwbeEhLU3YaEu0FdfsD%252Btjg06QtC3Mo68QYE2StBDLB0sqGQBQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "af19de0bb1e149869a2fa37596133890",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/9d677673b67647ef8daf56d585b9cb5c?KeyID=a8968c46&Signature=RUklL7sP%252ByI%2Fszpq1HkUN2MPgx%2FxRgra1dhJg6QZiQ5AqY7PUQ7Rpo1EeJMVLiANHdon3HmXll14JLSvmk4IBA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "af19de0bb1e149869a2fa37596133890",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-15-000001",
    "dateModified": "2020-05-15T01:00:01+03:00",
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2020-04-29T01:00:01+03:00",
      "endDate": "2020-05-15T01:00:01+03:00"
    },
    "auctionPeriod": {
      "startDate": "2020-05-15T01:00:01+03:00",
      "shouldStartAfter": "2020-05-16T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA.defense",
    "date": "2020-05-15T01: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": "ca388d7e9a7b43b1857dd01b677e64be"
      }
    ],
    "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-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "c44dbd3e52ea497088ba82bff063bed9",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/bids/a97583e039614cc4b45231194304b231?acc_token=d2f6e6c8a7a54d2cb138ef2ef5de765a 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/127bd59fdd464def8d1189b954eefcbb/bids/a97583e039614cc4b45231194304b231/documents/c6096921d1ff45269d9b15a2b6013423?download=e57e684075ba45b286a6d9239862fef5",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "id": "c6096921d1ff45269d9b15a2b6013423",
        "dateModified": "2020-05-15T01:00:01+03:00"
      }
    ],
    "selfEligible": true,
    "id": "a97583e039614cc4b45231194304b231",
    "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-15T01:00:01+03:00",
    "selfQualified": true,
    "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/127bd59fdd464def8d1189b954eefcbb?key_for_bid=a97583e039614cc4b45231194304b231"
  }
}

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/bids/844a8e0cf0f14d1bb310d7046066f966?acc_token=bbf4baf749f54990802f4c33f55e7fae 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": "844a8e0cf0f14d1bb310d7046066f966",
    "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-15T01:00:01+03:00",
    "selfQualified": true,
    "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/127bd59fdd464def8d1189b954eefcbb?key_for_bid=844a8e0cf0f14d1bb310d7046066f966"
  }
}

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

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/awards/ec709adbc2d14d43a6f8ff74f02b43a6?acc_token=78250e99c9974266933e656d51b30048 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-15T01:00:01+03:00",
      "endDate": "2020-05-22T00:00:00+03:00"
    },
    "bid_id": "844a8e0cf0f14d1bb310d7046066f966",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "qualified": true,
    "date": "2020-05-15T01:00:01+03:00",
    "id": "ec709adbc2d14d43a6f8ff74f02b43a6"
  }
}

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

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

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/contracts/815bd06a9ab34af69743fc32a8451cc6?acc_token=78250e99c9974266933e656d51b30048 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-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "c44dbd3e52ea497088ba82bff063bed9",
        "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-15T01:00:01+03:00",
    "awardID": "ec709adbc2d14d43a6f8ff74f02b43a6",
    "id": "815bd06a9ab34af69743fc32a8451cc6",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

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

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

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

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/contracts/815bd06a9ab34af69743fc32a8451cc6?acc_token=78250e99c9974266933e656d51b30048 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-15T01:00:03+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-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "c44dbd3e52ea497088ba82bff063bed9",
        "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-15T01:00:03+03:00",
    "date": "2020-05-15T01:00:01+03:00",
    "awardID": "ec709adbc2d14d43a6f8ff74f02b43a6",
    "id": "815bd06a9ab34af69743fc32a8451cc6",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

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

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/contracts/815bd06a9ab34af69743fc32a8451cc6?acc_token=78250e99c9974266933e656d51b30048 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-15T01:00:03+03:00",
      "endDate": "2021-05-15T01:00:03+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-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "c44dbd3e52ea497088ba82bff063bed9",
        "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-15T01:00:03+03:00",
      "endDate": "2021-05-15T01:00:03+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2020-05-15T01:00:03+03:00",
    "date": "2020-05-15T01:00:01+03:00",
    "awardID": "ec709adbc2d14d43a6f8ff74f02b43a6",
    "id": "815bd06a9ab34af69743fc32a8451cc6",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

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

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

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

POST /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/contracts/815bd06a9ab34af69743fc32a8451cc6/documents?acc_token=78250e99c9974266933e656d51b30048 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/127bd59fdd464def8d1189b954eefcbb/contracts/815bd06a9ab34af69743fc32a8451cc6/documents/33e8d9794e2c407da7f7ca540d792e9a
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a82d35a9b3f5416b8275051b6a1f6393?KeyID=a8968c46&Signature=f8nAQauBv23xEUZzy4QK6E%252B%2F2VBbxW86dJ4TAJUAswGeK7DY%2FWBVxTZxMiX8CrZ7SMI9W0%252BBnqzr0lEb%2FcKPBA%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:03+03:00",
    "id": "33e8d9794e2c407da7f7ca540d792e9a",
    "dateModified": "2020-05-15T01:00:03+03:00"
  }
}

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

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

GET /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/contracts/815bd06a9ab34af69743fc32a8451cc6?acc_token=78250e99c9974266933e656d51b30048 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/a82d35a9b3f5416b8275051b6a1f6393?KeyID=a8968c46&Signature=f8nAQauBv23xEUZzy4QK6E%252B%2F2VBbxW86dJ4TAJUAswGeK7DY%2FWBVxTZxMiX8CrZ7SMI9W0%252BBnqzr0lEb%2FcKPBA%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:03+03:00",
        "id": "33e8d9794e2c407da7f7ca540d792e9a",
        "dateModified": "2020-05-15T01:00:03+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-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "c44dbd3e52ea497088ba82bff063bed9",
        "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-15T01:00:03+03:00",
      "endDate": "2021-05-15T01:00:03+03:00"
    },
    "dateSigned": "2020-05-15T01:00:03+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:01+03:00",
    "awardID": "ec709adbc2d14d43a6f8ff74f02b43a6",
    "id": "815bd06a9ab34af69743fc32a8451cc6",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

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

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

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

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

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

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

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

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

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

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

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

POST /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/cancellations?acc_token=78250e99c9974266933e656d51b30048 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; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/cancellations/104ab67eaa9e4bd1a1af508433066884
{
  "data": {
    "status": "draft",
    "reason": "cancellation reason",
    "reasonType": "noDemand",
    "date": "2020-05-15T01:00:03+03:00",
    "cancellationOf": "tender",
    "id": "104ab67eaa9e4bd1a1af508433066884"
  }
}

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/cancellations/104ab67eaa9e4bd1a1af508433066884?acc_token=78250e99c9974266933e656d51b30048 HTTP/1.0
Authorization: Bearer broker
Content-Length: 37
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reasonType": "unFixable"
  }
}

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

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

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

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

POST /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/cancellations/104ab67eaa9e4bd1a1af508433066884/documents?acc_token=78250e99c9974266933e656d51b30048 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/127bd59fdd464def8d1189b954eefcbb/cancellations/104ab67eaa9e4bd1a1af508433066884/documents/a07c11ed15064e1bad53c031eaad847c
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0b520ba17040480fb0d9f4572701ba10?KeyID=a8968c46&Signature=T12%252Bd9JlVXgxhvf7gDlyPdF74M1rd26%2F%2FGgOV2D39QPu5aAmqn7SArN5Jl%2FyBrsP9iL%2FKtwINi%2FcdMXULvT2Aw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:03+03:00",
    "id": "a07c11ed15064e1bad53c031eaad847c",
    "dateModified": "2020-05-15T01:00:03+03:00"
  }
}

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/cancellations/104ab67eaa9e4bd1a1af508433066884/documents/a07c11ed15064e1bad53c031eaad847c?acc_token=78250e99c9974266933e656d51b30048 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/0b520ba17040480fb0d9f4572701ba10?KeyID=a8968c46&Signature=T12%252Bd9JlVXgxhvf7gDlyPdF74M1rd26%2F%2FGgOV2D39QPu5aAmqn7SArN5Jl%2FyBrsP9iL%2FKtwINi%2FcdMXULvT2Aw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:03+03:00",
    "id": "a07c11ed15064e1bad53c031eaad847c",
    "dateModified": "2020-05-15T01:00:03+03:00"
  }
}

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

PUT /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/cancellations/104ab67eaa9e4bd1a1af508433066884/documents/a07c11ed15064e1bad53c031eaad847c?acc_token=78250e99c9974266933e656d51b30048 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/a11172b2f6cb4d20990628db4d49bf11?KeyID=a8968c46&Signature=g9DyNouyxNzS83OdEWcgKYeO9ZI8s6wDDIEcuCGlS3M5uybfcTIuM5lNetAMBwn4kIUGEWIdNLFsPiMPnf2kDg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:03+03:00",
    "id": "a07c11ed15064e1bad53c031eaad847c",
    "dateModified": "2020-05-15T01:00:03+03:00"
  }
}

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

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

PATCH /api/2.5/tenders/127bd59fdd464def8d1189b954eefcbb/cancellations/104ab67eaa9e4bd1a1af508433066884?acc_token=78250e99c9974266933e656d51b30048 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/0b520ba17040480fb0d9f4572701ba10?KeyID=a8968c46&Signature=T12%252Bd9JlVXgxhvf7gDlyPdF74M1rd26%2F%2FGgOV2D39QPu5aAmqn7SArN5Jl%2FyBrsP9iL%2FKtwINi%2FcdMXULvT2Aw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:03+03:00",
        "id": "a07c11ed15064e1bad53c031eaad847c",
        "dateModified": "2020-05-15T01:00:03+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a11172b2f6cb4d20990628db4d49bf11?KeyID=a8968c46&Signature=g9DyNouyxNzS83OdEWcgKYeO9ZI8s6wDDIEcuCGlS3M5uybfcTIuM5lNetAMBwn4kIUGEWIdNLFsPiMPnf2kDg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:03+03:00",
        "id": "a07c11ed15064e1bad53c031eaad847c",
        "dateModified": "2020-05-15T01:00:03+03:00"
      }
    ],
    "complaintPeriod": {
      "startDate": "2020-05-15T01:00:03+03:00",
      "endDate": "2020-05-26T00:00:00+03:00"
    },
    "reason": "cancellation reason",
    "reasonType": "unFixable",
    "date": "2020-05-15T01:00:03+03:00",
    "cancellationOf": "tender",
    "id": "104ab67eaa9e4bd1a1af508433066884"
  }
}

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

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

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