Туторіал

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

Подивимось як працює точка входу /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
X-Content-Type-Options: nosniff
{
  "data": [],
  "next_page": {
    "offset": "",
    "path": "/api/2.5/tenders?offset=",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset="
  }
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "f8aae737ac8f4d34a52254e2f3416505",
      "dateModified": "2020-09-08T01:00:00+03:00"
    }
  ],
  "next_page": {
    "offset": "2020-09-08T01:00:00+03:00",
    "path": "/api/2.5/tenders?offset=2020-09-08T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2020-09-08T01%3A00%3A00%2B03%3A00"
  }
}

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

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

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

PATCH /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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-09-24T01:00:00+03:00"
    }
  }
}

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

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

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

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

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "f8aae737ac8f4d34a52254e2f3416505",
      "dateModified": "2020-09-08T01:00:00+03:00"
    }
  ],
  "next_page": {
    "offset": "2020-09-08T01:00:00+03:00",
    "path": "/api/2.5/tenders?offset=2020-09-08T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2020-09-08T01%3A00%3A00%2B03%3A00"
  }
}

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

PATCH /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
X-Content-Type-Options: nosniff
{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "tenderPeriod should be extended by 2 working days"
    }
  ]
}

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

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

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "title": "футляри до державних нагород",
    "documents": [
      {
        "id": "457b8238ff944c5fa11e309e1be667aa",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Notice.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/9156e73e56e04c239988e29df74dbab9?Signature=jspnA%2FfpdkvKDPku3%2F9%2B3jRueikMS%2B4wiIoZfe0nEt6%2BUxUNMcpTEhvTeESV2MeFvQ2c7Muz%2FscX%2FemP5X%2BxAg%3D%3D&KeyID=a8968c46",
        "datePublished": "2020-09-08T01:00:00+03:00",
        "dateModified": "2020-09-08T01:00:00+03:00",
        "author": "tender_owner",
        "documentOf": "tender"
      },
      {
        "id": "e01aac4af6044a00a7f0771a73b1e814",
        "hash": "md5:00000000000000000000000000000000",
        "title": "AwardCriteria.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e814928ca3024c3f953f606398f37f4b?Signature=W%2FiokKH3Cxit5kGrD3Yy2s3oWwfmSMM5Qe1bin3xK6W8%2FODI9LO0YX%2BD9rW6kNQ1lOIwzfPjR9qBNqkThisaBA%3D%3D&KeyID=a8968c46",
        "datePublished": "2020-09-08T01:00:00+03:00",
        "dateModified": "2020-09-08T01:00:00+03:00",
        "author": "tender_owner",
        "documentOf": "tender"
      },
      {
        "id": "e01aac4af6044a00a7f0771a73b1e814",
        "hash": "md5:00000000000000000000000000000000",
        "title": "AwardCriteria-2.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d8e239fa45074edd95ddf73a9fc87683?Signature=XkOGMvL3v45e1K30IAPKb32Uc7Q%2FIzf74O%2F6ZNxwF0eSbRw9RiqGOf%2BhwVO0H0%2FXHpr8xLuM7vu4HBZ944h%2BBA%3D%3D&KeyID=a8968c46",
        "datePublished": "2020-09-08T01:00:00+03:00",
        "dateModified": "2020-09-08T01:00:00+03:00",
        "author": "tender_owner",
        "documentOf": "tender"
      }
    ],
    "date": "2020-09-08T01:00:00+03:00",
    "dateModified": "2020-09-08T01:00:01+03:00",
    "tenderID": "UA-2020-09-08-000001",
    "owner": "broker",
    "mainProcurementCategory": "services",
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "type": "financing",
        "code": "prepayment",
        "percentage": 45.55,
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 0
      },
      {
        "id": "fe7f2ac8b91849d6b47d562eea8f3941",
        "title": "deliveryOfGoods",
        "type": "financing",
        "code": "postpayment",
        "percentage": 54.45,
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 0
      }
    ],
    "procurementMethod": "open",
    "awardCriteria": "lowestCost",
    "submissionMethod": "electronicAuction",
    "value": {
      "amount": 501.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "amount": 35.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "questions": [
      {
        "id": "a20a872aeacd4e4dac5482c2045a52eb",
        "title": "Калорійність",
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "date": "2020-09-08T01:00:00+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "questionOf": "tender",
        "dateAnswered": "2020-09-08T01:00:00+03:00"
      }
    ],
    "guarantee": {
      "amount": 8.0,
      "currency": "USD"
    },
    "enquiryPeriod": {
      "startDate": "2020-08-26T01:00:00+03:00",
      "endDate": "2020-09-11T01:00:01+03:00",
      "clarificationsUntil": "2020-09-16T00:00:00+03:00",
      "invalidationDate": "2020-09-08T01:00:01+03:00"
    },
    "tenderPeriod": {
      "startDate": "2020-08-26T01:00:00+03:00",
      "endDate": "2020-09-16T01:00:01+03:00"
    },
    "auctionPeriod": {
      "startDate": "2020-09-10T01:00:00+03:00",
      "shouldStartAfter": "2020-09-17T00:00:00+03:00"
    },
    "items": [
      {
        "id": "d4e7d24a173e466385ebfcc8c3382523",
        "description": "Послуги шкільних їдалень",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "quantity": 1.0,
        "classification": {
          "description": "Послуги з харчування у школах",
          "scheme": "ДК021",
          "id": "55523100-3"
        },
        "deliveryDate": {
          "startDate": "2020-09-28T00:00:00+02:00",
          "endDate": "2020-10-28T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "status": "active.tendering",
    "procuringEntity": {
      "name": "ЗОСШ #10 м.Вінниці",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "address": {
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21027",
        "countryName": "Україна"
      },
      "kind": "defense",
      "contactPoint": {
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02",
        "url": "http://sch10.edu.vn.ua/"
      }
    },
    "procurementMethodType": "aboveThresholdUA.defense",
    "id": "f8aae737ac8f4d34a52254e2f3416505",
    "next_check": "2020-09-16T01:00:01+03:00",
    "complaintPeriod": {
      "startDate": "2020-08-26T01:00:00+03:00",
      "endDate": "2020-09-14T00:00:00+03:00"
    }
  }
}

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

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

POST /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/documents?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/documents/457b8238ff944c5fa11e309e1be667aa
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "457b8238ff944c5fa11e309e1be667aa",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/9156e73e56e04c239988e29df74dbab9?Signature=jspnA%2FfpdkvKDPku3%2F9%2B3jRueikMS%2B4wiIoZfe0nEt6%2BUxUNMcpTEhvTeESV2MeFvQ2c7Muz%2FscX%2FemP5X%2BxAg%3D%3D&KeyID=a8968c46",
    "datePublished": "2020-09-08T01:00:00+03:00",
    "dateModified": "2020-09-08T01:00:00+03:00",
    "author": "tender_owner",
    "documentOf": "tender"
  }
}

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

GET /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/documents/457b8238ff944c5fa11e309e1be667aa?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "457b8238ff944c5fa11e309e1be667aa",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/9156e73e56e04c239988e29df74dbab9?Signature=jspnA%2FfpdkvKDPku3%2F9%2B3jRueikMS%2B4wiIoZfe0nEt6%2BUxUNMcpTEhvTeESV2MeFvQ2c7Muz%2FscX%2FemP5X%2BxAg%3D%3D&KeyID=a8968c46",
    "datePublished": "2020-09-08T01:00:00+03:00",
    "dateModified": "2020-09-08T01:00:00+03:00",
    "author": "tender_owner",
    "documentOf": "tender",
    "previousVersions": []
  }
}

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

POST /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/documents?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/documents/e01aac4af6044a00a7f0771a73b1e814
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "e01aac4af6044a00a7f0771a73b1e814",
    "hash": "md5:00000000000000000000000000000000",
    "title": "AwardCriteria.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e814928ca3024c3f953f606398f37f4b?Signature=W%2FiokKH3Cxit5kGrD3Yy2s3oWwfmSMM5Qe1bin3xK6W8%2FODI9LO0YX%2BD9rW6kNQ1lOIwzfPjR9qBNqkThisaBA%3D%3D&KeyID=a8968c46",
    "datePublished": "2020-09-08T01:00:00+03:00",
    "dateModified": "2020-09-08T01:00:00+03:00",
    "author": "tender_owner",
    "documentOf": "tender"
  }
}

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

GET /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/documents?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "457b8238ff944c5fa11e309e1be667aa",
      "hash": "md5:00000000000000000000000000000000",
      "title": "Notice.pdf",
      "format": "application/pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/9156e73e56e04c239988e29df74dbab9?Signature=jspnA%2FfpdkvKDPku3%2F9%2B3jRueikMS%2B4wiIoZfe0nEt6%2BUxUNMcpTEhvTeESV2MeFvQ2c7Muz%2FscX%2FemP5X%2BxAg%3D%3D&KeyID=a8968c46",
      "datePublished": "2020-09-08T01:00:00+03:00",
      "dateModified": "2020-09-08T01:00:00+03:00",
      "author": "tender_owner",
      "documentOf": "tender"
    },
    {
      "id": "e01aac4af6044a00a7f0771a73b1e814",
      "hash": "md5:00000000000000000000000000000000",
      "title": "AwardCriteria.pdf",
      "format": "application/pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e814928ca3024c3f953f606398f37f4b?Signature=W%2FiokKH3Cxit5kGrD3Yy2s3oWwfmSMM5Qe1bin3xK6W8%2FODI9LO0YX%2BD9rW6kNQ1lOIwzfPjR9qBNqkThisaBA%3D%3D&KeyID=a8968c46",
      "datePublished": "2020-09-08T01:00:00+03:00",
      "dateModified": "2020-09-08T01:00:00+03:00",
      "author": "tender_owner",
      "documentOf": "tender"
    }
  ]
}

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

PUT /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/documents/e01aac4af6044a00a7f0771a73b1e814?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "e01aac4af6044a00a7f0771a73b1e814",
    "hash": "md5:00000000000000000000000000000000",
    "title": "AwardCriteria-2.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d8e239fa45074edd95ddf73a9fc87683?Signature=XkOGMvL3v45e1K30IAPKb32Uc7Q%2FIzf74O%2F6ZNxwF0eSbRw9RiqGOf%2BhwVO0H0%2FXHpr8xLuM7vu4HBZ944h%2BBA%3D%3D&KeyID=a8968c46",
    "datePublished": "2020-09-08T01:00:00+03:00",
    "dateModified": "2020-09-08T01:00:00+03:00",
    "author": "tender_owner",
    "documentOf": "tender"
  }
}

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

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

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "457b8238ff944c5fa11e309e1be667aa",
      "hash": "md5:00000000000000000000000000000000",
      "title": "Notice.pdf",
      "format": "application/pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/9156e73e56e04c239988e29df74dbab9?Signature=jspnA%2FfpdkvKDPku3%2F9%2B3jRueikMS%2B4wiIoZfe0nEt6%2BUxUNMcpTEhvTeESV2MeFvQ2c7Muz%2FscX%2FemP5X%2BxAg%3D%3D&KeyID=a8968c46",
      "datePublished": "2020-09-08T01:00:00+03:00",
      "dateModified": "2020-09-08T01:00:00+03:00",
      "author": "tender_owner",
      "documentOf": "tender"
    },
    {
      "id": "e01aac4af6044a00a7f0771a73b1e814",
      "hash": "md5:00000000000000000000000000000000",
      "title": "AwardCriteria-2.pdf",
      "format": "application/pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d8e239fa45074edd95ddf73a9fc87683?Signature=XkOGMvL3v45e1K30IAPKb32Uc7Q%2FIzf74O%2F6ZNxwF0eSbRw9RiqGOf%2BhwVO0H0%2FXHpr8xLuM7vu4HBZ944h%2BBA%3D%3D&KeyID=a8968c46",
      "datePublished": "2020-09-08T01:00:00+03:00",
      "dateModified": "2020-09-08T01:00:00+03:00",
      "author": "tender_owner",
      "documentOf": "tender"
    }
  ]
}

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

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

POST /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/questions HTTP/1.0
Authorization: Bearer broker
Content-Length: 1147
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "author": {
      "address": {
        "countryName": "Україна",
        "locality": "м. Львів",
        "postalCode": "79013",
        "region": "Львівська область",
        "streetAddress": "вул. Островського, 34"
      },
      "contactPoint": {
        "email": "aagt@gmail.com",
        "name": "Андрій Олексюк",
        "telephone": "+380 (322) 91-69-30"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00137226",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Книга»"
    },
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/questions/a20a872aeacd4e4dac5482c2045a52eb
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "a20a872aeacd4e4dac5482c2045a52eb",
    "author": {
      "name": "ДКП «Книга»",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00137226",
        "uri": "http://www.sc.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Островського, 34",
        "locality": "м. Львів",
        "region": "Львівська область",
        "postalCode": "79013",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Андрій Олексюк",
        "email": "aagt@gmail.com",
        "telephone": "+380 (322) 91-69-30"
      }
    },
    "title": "Калорійність",
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "date": "2020-09-08T01:00:00+03:00",
    "questionOf": "tender"
  }
}

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

PATCH /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/questions/a20a872aeacd4e4dac5482c2045a52eb?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "a20a872aeacd4e4dac5482c2045a52eb",
    "title": "Калорійність",
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "date": "2020-09-08T01:00:00+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "questionOf": "tender",
    "dateAnswered": "2020-09-08T01:00:00+03:00"
  }
}

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

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

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

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

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

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

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

POST /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/questions HTTP/1.0
Authorization: Bearer broker
Content-Length: 1147
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "author": {
      "address": {
        "countryName": "Україна",
        "locality": "м. Львів",
        "postalCode": "79013",
        "region": "Львівська область",
        "streetAddress": "вул. Островського, 34"
      },
      "contactPoint": {
        "email": "aagt@gmail.com",
        "name": "Андрій Олексюк",
        "telephone": "+380 (322) 91-69-30"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00137226",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Книга»"
    },
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність"
  }
}

Response: 403 Forbidden
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Can add question only in enquiryPeriod"
    }
  ]
}

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

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

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

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

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

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

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

POST /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/bids/a91aeed6db4a4969982ce37fab972938/documents?acc_token=b6333f0eb61e422e8c473bf9f5ba0127 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
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/bids/a91aeed6db4a4969982ce37fab972938/documents/189fbd0e57174522bb0b44d7be761c1a
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "189fbd0e57174522bb0b44d7be761c1a",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Proposal.pdf",
    "format": "application/pdf",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/bids/a91aeed6db4a4969982ce37fab972938/documents/189fbd0e57174522bb0b44d7be761c1a?download=51a245b8c3624982921701ac24fb6451",
    "datePublished": "2020-09-08T01:00:01+03:00",
    "dateModified": "2020-09-08T01:00:01+03:00",
    "documentOf": "tender"
  }
}

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

GET /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/bids/a91aeed6db4a4969982ce37fab972938/documents?acc_token=b6333f0eb61e422e8c473bf9f5ba0127 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "189fbd0e57174522bb0b44d7be761c1a",
      "hash": "md5:00000000000000000000000000000000",
      "title": "Proposal.pdf",
      "format": "application/pdf",
      "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/bids/a91aeed6db4a4969982ce37fab972938/documents/189fbd0e57174522bb0b44d7be761c1a?download=51a245b8c3624982921701ac24fb6451",
      "datePublished": "2020-09-08T01:00:01+03:00",
      "dateModified": "2020-09-08T01:00:01+03:00",
      "documentOf": "tender"
    }
  ]
}

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

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

GET /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/bids/a91aeed6db4a4969982ce37fab972938?acc_token=b6333f0eb61e422e8c473bf9f5ba0127 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "a91aeed6db4a4969982ce37fab972938",
    "status": "invalid"
  }
}

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

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

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

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

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

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

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

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

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

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

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

Аукціон

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

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

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "title": "футляри до державних нагород",
    "documents": [
      {
        "id": "457b8238ff944c5fa11e309e1be667aa",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Notice.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/9156e73e56e04c239988e29df74dbab9?Signature=jspnA%2FfpdkvKDPku3%2F9%2B3jRueikMS%2B4wiIoZfe0nEt6%2BUxUNMcpTEhvTeESV2MeFvQ2c7Muz%2FscX%2FemP5X%2BxAg%3D%3D&KeyID=a8968c46",
        "datePublished": "2020-09-08T01:00:00+03:00",
        "dateModified": "2020-09-08T01:00:00+03:00",
        "author": "tender_owner",
        "documentOf": "tender"
      },
      {
        "id": "e01aac4af6044a00a7f0771a73b1e814",
        "hash": "md5:00000000000000000000000000000000",
        "title": "AwardCriteria.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e814928ca3024c3f953f606398f37f4b?Signature=W%2FiokKH3Cxit5kGrD3Yy2s3oWwfmSMM5Qe1bin3xK6W8%2FODI9LO0YX%2BD9rW6kNQ1lOIwzfPjR9qBNqkThisaBA%3D%3D&KeyID=a8968c46",
        "datePublished": "2020-09-08T01:00:00+03:00",
        "dateModified": "2020-09-08T01:00:00+03:00",
        "author": "tender_owner",
        "documentOf": "tender"
      },
      {
        "id": "e01aac4af6044a00a7f0771a73b1e814",
        "hash": "md5:00000000000000000000000000000000",
        "title": "AwardCriteria-2.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d8e239fa45074edd95ddf73a9fc87683?Signature=XkOGMvL3v45e1K30IAPKb32Uc7Q%2FIzf74O%2F6ZNxwF0eSbRw9RiqGOf%2BhwVO0H0%2FXHpr8xLuM7vu4HBZ944h%2BBA%3D%3D&KeyID=a8968c46",
        "datePublished": "2020-09-08T01:00:00+03:00",
        "dateModified": "2020-09-08T01:00:00+03:00",
        "author": "tender_owner",
        "documentOf": "tender"
      }
    ],
    "date": "2020-09-08T01:00:00+03:00",
    "dateModified": "2020-09-08T01:00:01+03:00",
    "tenderID": "UA-2020-09-08-000001",
    "owner": "broker",
    "mainProcurementCategory": "services",
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "type": "financing",
        "code": "prepayment",
        "percentage": 45.55,
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 0
      },
      {
        "id": "fe7f2ac8b91849d6b47d562eea8f3941",
        "title": "deliveryOfGoods",
        "type": "financing",
        "code": "postpayment",
        "percentage": 54.45,
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 0
      }
    ],
    "procurementMethod": "open",
    "awardCriteria": "lowestCost",
    "submissionMethod": "electronicAuction",
    "value": {
      "amount": 501.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "amount": 35.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "questions": [
      {
        "id": "a20a872aeacd4e4dac5482c2045a52eb",
        "title": "Калорійність",
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "date": "2020-09-08T01:00:00+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "questionOf": "tender",
        "dateAnswered": "2020-09-08T01:00:00+03:00"
      }
    ],
    "auctionUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/f8aae737ac8f4d34a52254e2f3416505",
    "guarantee": {
      "amount": 8.0,
      "currency": "USD"
    },
    "enquiryPeriod": {
      "startDate": "2020-08-23T01:00:01+03:00",
      "endDate": "2020-09-03T01:00:01+03:00",
      "clarificationsUntil": "2020-09-08T00:00:00+03:00",
      "invalidationDate": "2020-09-08T01:00:01+03:00"
    },
    "tenderPeriod": {
      "startDate": "2020-08-23T01:00:01+03:00",
      "endDate": "2020-09-08T01:00:01+03:00"
    },
    "auctionPeriod": {
      "startDate": "2020-09-08T01:00:01+03:00",
      "shouldStartAfter": "2020-09-09T00:00:00+03:00"
    },
    "items": [
      {
        "id": "d4e7d24a173e466385ebfcc8c3382523",
        "description": "Послуги шкільних їдалень",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "quantity": 1.0,
        "classification": {
          "description": "Послуги з харчування у школах",
          "scheme": "ДК021",
          "id": "55523100-3"
        },
        "deliveryDate": {
          "startDate": "2020-09-28T00:00:00+02:00",
          "endDate": "2020-10-28T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "status": "active.auction",
    "procuringEntity": {
      "name": "ЗОСШ #10 м.Вінниці",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "address": {
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21027",
        "countryName": "Україна"
      },
      "kind": "defense",
      "contactPoint": {
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02",
        "url": "http://sch10.edu.vn.ua/"
      }
    },
    "procurementMethodType": "aboveThresholdUA.defense",
    "id": "f8aae737ac8f4d34a52254e2f3416505",
    "next_check": "2020-09-08T01:36:01+03:00",
    "complaintPeriod": {
      "startDate": "2020-08-23T01:00:01+03:00",
      "endDate": "2020-09-04T00:00:00+03:00"
    }
  }
}

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

GET /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/bids/a91aeed6db4a4969982ce37fab972938?acc_token=b6333f0eb61e422e8c473bf9f5ba0127 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

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

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

GET /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/bids/c014d12517fb42d689cd9b200fe56668?acc_token=833c7cf4dfb34873b1acf90aeaacbda4 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

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

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

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

PATCH /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/awards/8cfafe75d00f49778d2a98e8379247b9?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "8cfafe75d00f49778d2a98e8379247b9",
    "status": "active",
    "date": "2020-09-08T01:00:01+03:00",
    "value": {
      "amount": 499.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "suppliers": [
      {
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30"
        },
        "scale": "sme"
      }
    ],
    "bid_id": "c014d12517fb42d689cd9b200fe56668",
    "complaintPeriod": {
      "startDate": "2020-09-08T01:00:01+03:00",
      "endDate": "2020-09-15T00:00:00+03:00"
    },
    "qualified": true,
    "eligible": true
  }
}

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

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

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

PATCH /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/contracts/f190bafc3826498f9de5daa525e5e68b?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "f190bafc3826498f9de5daa525e5e68b",
    "contractID": "UA-2020-09-08-000001-1",
    "status": "pending",
    "suppliers": [
      {
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30"
        },
        "scale": "sme"
      }
    ],
    "date": "2020-09-08T01:00:01+03:00",
    "value": {
      "amount": 238.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 230.0
    },
    "awardID": "8cfafe75d00f49778d2a98e8379247b9",
    "items": [
      {
        "id": "d4e7d24a173e466385ebfcc8c3382523",
        "description": "Послуги шкільних їдалень",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "quantity": 1.0,
        "classification": {
          "description": "Послуги з харчування у школах",
          "scheme": "ДК021",
          "id": "55523100-3"
        },
        "deliveryDate": {
          "startDate": "2020-09-28T00:00:00+02:00",
          "endDate": "2020-10-28T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ]
  }
}

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

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

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

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

PATCH /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/contracts/f190bafc3826498f9de5daa525e5e68b?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "dateSigned": "2020-09-08T01:00:03+03:00"
  }
}

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

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

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

PATCH /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/contracts/f190bafc3826498f9de5daa525e5e68b?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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-09-08T01:00:03+03:00",
      "endDate": "2021-09-08T01:00:03+03:00"
    }
  }
}

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

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

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

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

POST /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/contracts/f190bafc3826498f9de5daa525e5e68b/documents?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/contracts/f190bafc3826498f9de5daa525e5e68b/documents/feed2076a94a48e1810496af9b9e403e
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "feed2076a94a48e1810496af9b9e403e",
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_document.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8a968439bb234638b1981f50cddf8d1e?Signature=0w9B%2FeG%2FHzuWRPG6%2BF3P6%2BSk%2F67N0H4rGoVK%2FQrb7Xz30H%2BzHFPcMOjT7VeksJlGE30PJky1rOuiN5TGoihZCw%3D%3D&KeyID=a8968c46",
    "datePublished": "2020-09-08T01:00:03+03:00",
    "dateModified": "2020-09-08T01:00:03+03:00",
    "documentOf": "tender"
  }
}

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

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

GET /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/contracts/f190bafc3826498f9de5daa525e5e68b?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "f190bafc3826498f9de5daa525e5e68b",
    "contractID": "UA-2020-09-08-000001-1",
    "status": "pending",
    "period": {
      "startDate": "2020-09-08T01:00:03+03:00",
      "endDate": "2021-09-08T01:00:03+03:00"
    },
    "dateSigned": "2020-09-08T01:00:03+03:00",
    "suppliers": [
      {
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30"
        },
        "scale": "sme"
      }
    ],
    "date": "2020-09-08T01:00:01+03:00",
    "value": {
      "amount": 238.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 230.0
    },
    "awardID": "8cfafe75d00f49778d2a98e8379247b9",
    "documents": [
      {
        "id": "feed2076a94a48e1810496af9b9e403e",
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_document.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8a968439bb234638b1981f50cddf8d1e?Signature=0w9B%2FeG%2FHzuWRPG6%2BF3P6%2BSk%2F67N0H4rGoVK%2FQrb7Xz30H%2BzHFPcMOjT7VeksJlGE30PJky1rOuiN5TGoihZCw%3D%3D&KeyID=a8968c46",
        "datePublished": "2020-09-08T01:00:03+03:00",
        "dateModified": "2020-09-08T01:00:03+03:00",
        "documentOf": "tender"
      }
    ],
    "items": [
      {
        "id": "d4e7d24a173e466385ebfcc8c3382523",
        "description": "Послуги шкільних їдалень",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "quantity": 1.0,
        "classification": {
          "description": "Послуги з харчування у школах",
          "scheme": "ДК021",
          "id": "55523100-3"
        },
        "deliveryDate": {
          "startDate": "2020-09-28T00:00:00+02:00",
          "endDate": "2020-10-28T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ]
  }
}

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

Замовник може скасувати закупівлю у будь-який момент (крім закупівель у статусі 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/f8aae737ac8f4d34a52254e2f3416505/cancellations?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc HTTP/1.0
Authorization: Bearer broker
Content-Length: 69
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reason": "cancellation reason",
    "reasonType": "noDemand"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/cancellations/24bd18d29a2448ebbfc89a32adaa370d
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "24bd18d29a2448ebbfc89a32adaa370d",
    "reason": "cancellation reason",
    "date": "2020-09-08T01:00:03+03:00",
    "cancellationOf": "tender",
    "reasonType": "noDemand",
    "status": "draft"
  }
}

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

PATCH /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/cancellations/24bd18d29a2448ebbfc89a32adaa370d?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "24bd18d29a2448ebbfc89a32adaa370d",
    "reason": "cancellation reason",
    "date": "2020-09-08T01:00:03+03:00",
    "status": "draft",
    "cancellationOf": "tender",
    "reasonType": "unFixable"
  }
}

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

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

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

POST /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/cancellations/24bd18d29a2448ebbfc89a32adaa370d/documents?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/cancellations/24bd18d29a2448ebbfc89a32adaa370d/documents/332419989e6547d49b7b0b01d0625755
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "332419989e6547d49b7b0b01d0625755",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a85b7007b8e74e829fbb881e3473d149?Signature=bUQLwJDRs09pdak3ZRuKMcgDqOutj6kKLab3ngZeWU0devDuMrtFR29Tvjaz3jr%2F9pS4aBa1qkHmQnOP7PHfAw%3D%3D&KeyID=a8968c46",
    "datePublished": "2020-09-08T01:00:03+03:00",
    "dateModified": "2020-09-08T01:00:03+03:00",
    "documentOf": "tender"
  }
}

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

PATCH /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/cancellations/24bd18d29a2448ebbfc89a32adaa370d/documents/332419989e6547d49b7b0b01d0625755?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc HTTP/1.0
Authorization: Bearer broker
Content-Length: 48
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "description": "Changed description"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "332419989e6547d49b7b0b01d0625755",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a85b7007b8e74e829fbb881e3473d149?Signature=bUQLwJDRs09pdak3ZRuKMcgDqOutj6kKLab3ngZeWU0devDuMrtFR29Tvjaz3jr%2F9pS4aBa1qkHmQnOP7PHfAw%3D%3D&KeyID=a8968c46",
    "datePublished": "2020-09-08T01:00:03+03:00",
    "dateModified": "2020-09-08T01:00:03+03:00",
    "documentOf": "tender"
  }
}

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

PUT /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/cancellations/24bd18d29a2448ebbfc89a32adaa370d/documents/332419989e6547d49b7b0b01d0625755?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "332419989e6547d49b7b0b01d0625755",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice-2.pdf",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3c306eff55f04e039a988137656ce16c?Signature=JoarpStERdtl28foRFD0h4aKU5LSGtP2TWh29niRCJhT%2F5butoclxbebK9ylbMdOtXqxfvDoQ0Emj%2B7ULmhtBQ%3D%3D&KeyID=a8968c46",
    "datePublished": "2020-09-08T01:00:03+03:00",
    "dateModified": "2020-09-08T01:00:03+03:00",
    "documentOf": "tender"
  }
}

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

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

PATCH /api/2.5/tenders/f8aae737ac8f4d34a52254e2f3416505/cancellations/24bd18d29a2448ebbfc89a32adaa370d?acc_token=38dfa7b7e6ef4691b199e71e4247e9dc 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
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "24bd18d29a2448ebbfc89a32adaa370d",
    "reason": "cancellation reason",
    "date": "2020-09-08T01:00:03+03:00",
    "status": "pending",
    "documents": [
      {
        "id": "332419989e6547d49b7b0b01d0625755",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Notice.pdf",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a85b7007b8e74e829fbb881e3473d149?Signature=bUQLwJDRs09pdak3ZRuKMcgDqOutj6kKLab3ngZeWU0devDuMrtFR29Tvjaz3jr%2F9pS4aBa1qkHmQnOP7PHfAw%3D%3D&KeyID=a8968c46",
        "datePublished": "2020-09-08T01:00:03+03:00",
        "dateModified": "2020-09-08T01:00:03+03:00",
        "documentOf": "tender"
      },
      {
        "id": "332419989e6547d49b7b0b01d0625755",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Notice-2.pdf",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3c306eff55f04e039a988137656ce16c?Signature=JoarpStERdtl28foRFD0h4aKU5LSGtP2TWh29niRCJhT%2F5butoclxbebK9ylbMdOtXqxfvDoQ0Emj%2B7ULmhtBQ%3D%3D&KeyID=a8968c46",
        "datePublished": "2020-09-08T01:00:03+03:00",
        "dateModified": "2020-09-08T01:00:03+03:00",
        "documentOf": "tender"
      }
    ],
    "cancellationOf": "tender",
    "reasonType": "unFixable",
    "complaintPeriod": {
      "startDate": "2020-09-08T01:00:03+03:00",
      "endDate": "2020-09-19T00:00:00+03:00"
    }
  }
}

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

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

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