Туторіал
Розглянемо основні правила
Подивимось як працює точка входу /contracts:
Request
GET /api/2.5/contracts HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
],
"next_page": {
"offset": 1696888800.0,
"path": "/api/2.5/contracts?offset=1696888800.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=1696888800.0"
}
}
При виклику видає пустий набір.
Перенесенням договору із системи закупівель займається автоматизований процес.
Створення договору
Нехай у нас відбулась закупівля і є переможець. Після вибору перможця автоматично створюється контракт в закупівлі з обмеженим набором полів(id, awardID, status, date) та в системі договорів з повним набором полів(EContract) у статусі pending.
Майданчики (брокери) не мають можливості створювати договори в системі договорів.
Отримання договору
Договір в системі закупівель
Request
GET /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/contracts/eb4343b446004f47aa2ec7f6e542f196 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "eb4343b446004f47aa2ec7f6e542f196",
"status": "pending",
"awardID": "c220713cbd024586b6382ef97a852dc7",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
}
}
}
Ідентифікатор `id` договору однаковий в системах закупівель та договорів.
Спробуємо доступитись до URL створеного об’єкта:
Request
GET /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"owner": "broker",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"bid_owner": "broker",
"status": "pending",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
}
Отримання доступу
ЗАСТЕРЕЖЕННЯ: Наразі цей метод є застарілим(пізніше буде видаленим), ви можете проводити всі дії над договором використовуючи tender_token.
Для того, щоб отримати права для майбутнього редагування договору, необхідно використати таку в’юшку PATCH: /contracts/{id}/credentials?acc_token={tender_token} з API ключем майданчика, де була згенерована закупівля.
В PATCH: /contracts/{id}/credentials?acc_token={tender_token}:
id- це ідентифікатор договору,tender_token- це токен закупівлі (використовується для генерування токена договору).
У відповіді буде access.token для договору, який буде використовуватись для модифікації договору.
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/credentials?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 0
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"dateSigned": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"bid_owner": "broker",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"id": "eb4343b446004f47aa2ec7f6e542f196"
},
"access": {
"token": "84ff84eadc46497bbc8eae97c3dacdf0",
"transfer": "17dc1fcad66b41d5882c4699f481a977"
}
}
Переглянемо договори.
Request
GET /api/2.5/contracts HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
],
"next_page": {
"offset": 1696888800.0,
"path": "/api/2.5/contracts?offset=1696888800.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=1696888800.0"
}
}
Ми бачимо внутрішнє id договору (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/contracts/) та його dateModified дату.
Редагування чернетки договору
Встановлення вартості угоди
За замовчуванням вартість угоди встановлюється на основі рішення про визначення переможця, але є можливість змінити це значення.
Якщо ви хочете знизити вартість угоди, ви можете встановити нове значення для поля amount.
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 238,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"bid_owner": "broker",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
}
Було повернуто код відповіді 200 OK. Значення змінено успішно.
Для value у esco договорах ви можете лише змінити поля amountNet та valueAddedTaxIncluded:
Request
PATCH /api/2.5/contracts/bcc9f2201d99405fb451b20abc231e58?acc_token=871fba7d0f2840d48ed2394d778a5004 HTTP/1.0
Authorization: Bearer broker
Content-Length: 404
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"contractNumber": "contract#1",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 9430.27,
"amountPerformance": 864.98,
"yearlyPaymentsPercentage": 0.9,
"annualCostsReduction": [
500,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000,
1000
],
"contractDuration": {
"years": 10,
"days": 74
},
"amountNet": 9429.27
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "fdea30bde1d34c4eb16d5f7aa03bf22a",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract#1",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "28db6af763c74fceaedc98e147fed6cb",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "ЗОСШ #10 м.Вінниці",
"name_en": "School #10 of Vinnytsia",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "6109d472d8f34975a00dd5709cff36a1",
"description": "Послуги шкільних їдалень",
"description_en": "Services in school canteens",
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "f1e2dd652ddf4a4296acc94e78be41e0",
"description": "Послуги шкільних їдалень",
"description_en": "Services in school canteens",
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"value": {
"amount": 9430.27,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 9429.27,
"amountPerformance": 864.98,
"yearlyPaymentsPercentage": 0.9,
"annualCostsReduction": [
500.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0,
1000.0
],
"contractDuration": {
"years": 10,
"days": 74
}
},
"bid_owner": "broker",
"id": "bcc9f2201d99405fb451b20abc231e58"
}
}
Встановлення ціни за одиницю
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 2586
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 12,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"bid_owner": "broker",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
}
200 OK відповіддь повертається з успішно створеною структурою item.unit.value.
Item.unit.value.currency та Item.unit.value.valueAddedTaxIncluded створюються, використовуючи інформацію з contract.value(якщо існує), в іншому випадку з tender.value
Встановлення дати підписання угоди
Є можливість встановити дату підписання угоди. Для цього вставте відповідну дату в поле dateSigned.
Якщо ви не встановите дату підписання, то вона буде згенерована автоматично під час реєстрації угоди.
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"dateSigned": "2023-10-10T01:00:00+03:00"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"dateSigned": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"bid_owner": "broker",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
}
Встановлення терміну дії угоди
Встановлення терміну дії угоди необов’язкове, але, якщо є необхідність, ви можете встановити відповідну дату початку startDate та кінця endDate терміну дії.
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"dateSigned": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"bid_owner": "broker",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
}
Завантаження документації по угоді
Документи пов’язані з угодою можна завантажувати лише до укладання угоди. Спробуємо додати такий документ:
Request
POST /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 340
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_first_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=fcU8fQotbTE1nxHUmBfCgrwjfNjcDiJJA89ynym%2FRoye5cKevbbMvWzJadlyW1KJlrIEimpkzWeEDVhj85zUBA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/0042d18dfb254f4a8a0c166f1e980196
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
Переглянемо список завантажених документів:
Request
GET /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
Тепер спробуємо додати ще один документ щодо укладанням угоди:
Request
POST /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 351
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_second_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=y%2Bc%2FV%2BSIqnf36NvLLrimQyaWUtCCEZEgtEl%2FsALE5XH5bqEoXwnwNhAkhsKg1JfVY9%2BEwvXxHKhaD5p%2BZBhCBw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/9202cd64da8f42a5942c68dc14bf534a
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=x6tzZwzV4d5DGLeiqvD%2Bm0EdAUGgzUmYnoQ4AjImnxjQRU49JnE3aq50UHtPUVvIRfF5JSrLqmyF3tssHOT%2BCA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що ще один документ було додано.
Тепер переглянемо знову усі документи пов’язані із укладанням угоди:
Request
GET /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=x6tzZwzV4d5DGLeiqvD%2Bm0EdAUGgzUmYnoQ4AjImnxjQRU49JnE3aq50UHtPUVvIRfF5JSrLqmyF3tssHOT%2BCA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
Скасування угоди
Існує два способи скасування угоди:
Зміна стаусу award з active на cancelled
Зміна статусу угоди з «pending» to «cancelled» (цей метод працює, коли це не останній активний договір)
Відміна угоди через award
Все що потрібно, це змінити статус award на cancelled
Request
PATCH /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/awards/c220713cbd024586b6382ef97a852dc7?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/awards/a3771b096c9644c5ba09fe6f9c9cb091
{
"data": {
"id": "c220713cbd024586b6382ef97a852dc7",
"status": "cancelled",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "5324d8e7db1c4a3baf5456140f128229"
}
}
Угода у системі зкупівлі автомтично перейде до cancelled
Request
GET /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/contracts/eb4343b446004f47aa2ec7f6e542f196 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "eb4343b446004f47aa2ec7f6e542f196",
"status": "cancelled",
"awardID": "c220713cbd024586b6382ef97a852dc7",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
}
}
}
Угода у системі договорів також автоматично перейде до cancelled
Request
GET /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"dateSigned": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"status": "cancelled",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"bid_owner": "broker",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"date": "2023-10-10T01:00:00+03:00",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
}
Відміна через зміну договору
Якщо ви спробуєте змінити статус останньої угоди з pending на cancelled ви отримаєте помилку:
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Can't update contract status"
}
]
}
Реєстрація угоди
Перед тим як зареєструвати угоду,потрібно замовнику та постачальнику заповнити інформацію підписанта. При спробі активувати угоду без даної інформації, буде отримана помилка:
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "signerInfo field for buyer and suppliers is required for contract in `active` status"
}
]
}
Замовник заповнює інформацію підписанта використовуючи contract_token чи tender_token:
Request
PUT /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/buyer/signer_info?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 359
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
Постачальник заповнює інформацію підписанта використовуючи bid_token:
Request
PUT /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/suppliers/signer_info?acc_token=31267088715c49d384894418a74fb4b6 HTTP/1.0
Authorization: Bearer broker
Content-Length: 359
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
Інформацію підписанта можна оновоити використовуючи той самий спосіб:
Request
PUT /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/buyer/signer_info?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 359
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "234234234234234",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
Після всіх цих дій, ви можете зареєструвати угоду
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"dateSigned": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"bid_owner": "broker",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
}
Після активації угоди, угода у системі закупівель автоматично перейде у active і закупівля у статус complete:
Request
GET /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"title": "Комп’ютерне обладнання",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "complete",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 5000,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"endDate": "2023-10-09T01:00:00+03:00",
"startDate": "2023-09-30T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"kind": "general"
},
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"profile": "655360-30230000-889652-40000777"
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "e232a0b37a0041cdb58916e9550102c8",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "f23eb66e67f74ead9d79edc0b42e71c0",
"description": "Форма випуску",
"requirements": [
{
"id": "e6f9be7a505143948d92a687c03d24b5",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "58e197cbf866429196799d8e290a783c",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "f5c97b40f7914db1975cfe728ebd0ca4",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "d8cce89c0dcb4748828ccf2a141554bb",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "108107e8f8a04ed8884e899d96007806",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "dc1f3f74ad8146fd9703b7582e3de385",
"description": "Форма випуску",
"requirements": [
{
"id": "f9d6ad9094d746ffb048ec5d42fb4f9e",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"shortlistedFirms": [
{
"address": {
"countryName": "Україна",
"locality": "м.Київ",
"postalCode": "01100",
"region": "Київська область",
"streetAddress": "бул.Дружби Народів, 8"
},
"contactPoint": {
"email": "contact@pixel.pix",
"name": "Оксана Піксель",
"telephone": "+0671234567"
},
"id": "UA-EDR-12345678",
"identifier": {
"id": "00037256",
"legalName": "Товариство з обмеженою відповідальністю «Пікселі»",
"scheme": "UA-EDR"
},
"name": "Товариство з обмеженою відповідальністю «Пікселі»",
"scale": "large",
"status": "active"
},
{
"address": {
"countryName": "Україна",
"locality": "м.Тернопіль",
"postalCode": "46000",
"region": "Тернопільська область",
"streetAddress": "вул. Кластерна, 777-К"
},
"contactPoint": {
"email": "info@shteker.pek",
"name": "Олег Штекер",
"telephone": "+0951234567"
},
"id": "UA-EDR-87654321",
"identifier": {
"id": "87654321",
"legalName": "Товариство з обмеженою відповідальністю «Штекер-Пекер»",
"scheme": "UA-EDR"
},
"name": "Товариство з обмеженою відповідальністю «Штекер-Пекер»",
"scale": "large",
"status": "active"
}
],
"auctionPeriod": {
"startDate": "2023-10-20T01:00:00+03:00"
},
"bids": [
{
"id": "5324d8e7db1c4a3baf5456140f128229",
"date": "2023-10-10T01:00:00+03:00",
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "585ff3cc25684deba52def8cbabef863",
"requirement": {
"id": "e6f9be7a505143948d92a687c03d24b5"
},
"value": "Розчин для інфузій"
},
{
"id": "3a792c49a8cd4188aee2e87af1b8f25d",
"requirement": {
"id": "d8cce89c0dcb4748828ccf2a141554bb"
},
"value": 5
},
{
"id": "315577b4a97c46b5836595e9dafb424a",
"requirement": {
"id": "f9d6ad9094d746ffb048ec5d42fb4f9e"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "active"
}
],
"awardPeriod": {
"startDate": "2023-10-10T01:00:00+03:00"
},
"awards": [
{
"id": "c220713cbd024586b6382ef97a852dc7",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "5324d8e7db1c4a3baf5456140f128229"
},
{
"id": "a3771b096c9644c5ba09fe6f9c9cb091",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "5324d8e7db1c4a3baf5456140f128229"
}
],
"contracts": [
{
"id": "eb4343b446004f47aa2ec7f6e542f196",
"status": "active",
"awardID": "c220713cbd024586b6382ef97a852dc7",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
}
}
],
"id": "26fe592e6eb4454fb91865f39117fe4b"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true
}
}
Редагування зреєстрованого договору
Внесення змін до істотних умов договору можливі у випадках, описаних частиною четвертою статті 36 Закону України “Про публічні закупівлі”.
Істотні умови договору можуть бути змінені поданням нового об’єкта Change в котейнер Contract.changes.
Всі зміни change обробляються точкою входу (endpoint) /contracts/{id}/changes.
Подання зміни
Додамо нову зміну change до договору:
Request
POST /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/changes?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 267
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
}
Зверніть увагу на те, що ви можете надати більше ніж одне значення для поля rationaleTypes.
Ви можете переглянути зміну change:
Request
GET /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/changes/b9887678ba3c448b977467c0fe3ada31 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
}
Зміну change можна модифікувати доки вона має статус pending.
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/changes/b9887678ba3c448b977467c0fe3ada31?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 255
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
}
Завантаження документа зміни
Документ можна додати доки зміна change має статус pending.
Документ додається в два етапи:
ви повинні завантажити документ
Request
POST /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 333
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_changes.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=mFBbg4SYLP%2BQk4Cn6xwFtFp2XKpLLLIQmIqKvBsiciOF6nuiH7Gw9Wmk0IsPpNVvMLNn21PDO0c5XMfjxxX5Dw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/32ec55c6c6144f7a8fceea1ed68a5290
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=cG1JU%2F1r%2B2jlQbXxJsq3HCYzzTi9mderkkqPwomMk34J6oAJ%2B7GRNC3kUgPO3zskbNjKkMkhiaJY2PmkUlOkBA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
ви повинні задати властивості документа:
"documentOf": "change"та"relatedItem": "{change.id}", щоб «прив’язати» завантажений документ до зміни change:
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/32ec55c6c6144f7a8fceea1ed68a5290?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 85
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentOf": "change",
"relatedItem": "b9887678ba3c448b977467c0fe3ada31"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=cG1JU%2F1r%2B2jlQbXxJsq3HCYzzTi9mderkkqPwomMk34J6oAJ%2B7GRNC3kUgPO3zskbNjKkMkhiaJY2PmkUlOkBA%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Оновлення властивостей зміни
Тепер ви можете оновити властивості договору, що стосуються зміни.
Ви можете встановити нові значення для полів amount та amountNet керуючись наступними правилами:
valueAddedTaxIncluded |
Validation |
true |
Amount should be greater than amountNet and differ by no more than 20% |
false |
Amount and amountNet should be equal |
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 148
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 438,
"amountNet": 430
},
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"dateSigned": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"bid_owner": "broker",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
}
Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.
Поля, які можна модифікувати: title, description, status, value.amount, value.amountNet, period, items, amountPaid.amount, amountPaid.amountNet, terminationDetails.
Дивіться приклади зміни елемента (items) нижче. Ви можете:
оновити елемент (items):
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 2585
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 2,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"dateSigned": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"bid_owner": "broker",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
}
Застосування зміни
Зміна change застосовується при переключенні в статус active.
Щоб застосувати статус active потрібно встановити поле dateSigned.
ПІсля цього модифікувати зміну change вже не можна.
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/changes/b9887678ba3c448b977467c0fe3ada31?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 73
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"dateSigned": "2023-10-10T01:00:00+03:00"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-10-10T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-10-10T01:00:00+03:00"
}
}
Валідація поля dateSigned:
для першої зміни change договору дата повинна бути після contract.dateSigned;
для всіх наступних змін change договору дата повинна бути після попередньої дати change.dateSigned.
Ви можете переглянути всі зміни:
Request
GET /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/changes HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-10-10T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-10-10T01:00:00+03:00"
}
]
}
Всі зміни присутні при перегляді контракту.
Request
GET /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"dateSigned": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-10-10T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"bid_owner": "broker",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
}
Завантаження документації
Замовник може завантажити PDF файл у створений договір. Завантаження повинно відбуватись згідно правил Завантаження документів.
Request
POST /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 324
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc4cd1ee0c1d481d806feb638548e63b?Signature=bnjqiaGHrMcDhc5nxcKQAB7BmArrmXPmJQhahGGze6DVP39jk4gkNyTnhDnnDVbZFeTaNvrNF2rZGp%2Bx%2BBoLDg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/93f808adc3a84ee9b750119a797ed776
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc4cd1ee0c1d481d806feb638548e63b?Signature=C4ypZjunX6e74XGpYj6RLaNEEy%2BfU2mJomhLN9kphQzrRlcRhDIasEB3GcRqbctnAHP%2FjeTcdCVvVOzP2N4zCg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "93f808adc3a84ee9b750119a797ed776",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
Request
GET /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=x6tzZwzV4d5DGLeiqvD%2Bm0EdAUGgzUmYnoQ4AjImnxjQRU49JnE3aq50UHtPUVvIRfF5JSrLqmyF3tssHOT%2BCA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=cG1JU%2F1r%2B2jlQbXxJsq3HCYzzTi9mderkkqPwomMk34J6oAJ%2B7GRNC3kUgPO3zskbNjKkMkhiaJY2PmkUlOkBA%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc4cd1ee0c1d481d806feb638548e63b?Signature=C4ypZjunX6e74XGpYj6RLaNEEy%2BfU2mJomhLN9kphQzrRlcRhDIasEB3GcRqbctnAHP%2FjeTcdCVvVOzP2N4zCg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "93f808adc3a84ee9b750119a797ed776",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
І знову можна перевірити, що є два завантажених документа.
Request
POST /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 342
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_additional_docs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/277f219d159f45e1a11923c8b637d463?Signature=VgL3ykVviPI8bAuDmSwq5ViKMXnEfl0hg3JoFdsMGGWxqX9OMdhV6O2XqEatVTRggQhpT1%2BM%2BTWfKpl6%2BrdPBw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/e3a0c2f53a544b8f8f300200e400f460
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/277f219d159f45e1a11923c8b637d463?Signature=EnWBAbSpO74ppQPPbWr9QNTYM%2Fyee5mRc0iwX3fdwZkdZhmNY0oLP6uLF4v9XyU4ouyIjcTdltumSlUyu4%2B4Bg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "e3a0c2f53a544b8f8f300200e400f460",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
Request
PUT /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/e3a0c2f53a544b8f8f300200e400f460?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 336
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_additional_docs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c2fbdf60afd54cf3acdc89af698f87d2?Signature=juo4JvJjP1B3TgmfhUaFNRnKeufTb15Tcc6ecSZ1DYPMGLeG8hfQbgo2h1bRygiwiWmepBWtvuz5z5GqC7bTAw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c2fbdf60afd54cf3acdc89af698f87d2?Signature=kkWFx7aNWwgD%2F3KSmjbnzA%2BYzH4PvTJL1XRiDauwDPCQRsMHTfnUXxTygRpeggxjBENLuks5YIdiYyxxv6yBDg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
Request
GET /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/e3a0c2f53a544b8f8f300200e400f460?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c2fbdf60afd54cf3acdc89af698f87d2?Signature=kkWFx7aNWwgD%2F3KSmjbnzA%2BYzH4PvTJL1XRiDauwDPCQRsMHTfnUXxTygRpeggxjBENLuks5YIdiYyxxv6yBDg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"previousVersions": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/277f219d159f45e1a11923c8b637d463?Signature=EnWBAbSpO74ppQPPbWr9QNTYM%2Fyee5mRc0iwX3fdwZkdZhmNY0oLP6uLF4v9XyU4ouyIjcTdltumSlUyu4%2B4Bg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "e3a0c2f53a544b8f8f300200e400f460",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
}
Завершення договору
Перед завершенням договору необхідно встановити значення поля amountPaid (незалежно від того успішний договір чи ні). Договір можна завершити переключенням у статус terminated. Виконаємо ці дії єдиним запитом:
Request
PATCH /api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 114
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "terminated",
"amountPaid": {
"amount": 430,
"amountNet": 420,
"valueAddedTaxIncluded": true
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-10-10-000001-a-1",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"dateSigned": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-10-10T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-10-09T22:00:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "93f808adc3a84ee9b750119a797ed776",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/93f808adc3a84ee9b750119a797ed776?download=cc4cd1ee0c1d481d806feb638548e63b",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/e3a0c2f53a544b8f8f300200e400f460?download=277f219d159f45e1a11923c8b637d463",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/eb4343b446004f47aa2ec7f6e542f196/documents/e3a0c2f53a544b8f8f300200e400f460?download=c2fbdf60afd54cf3acdc89af698f87d2",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"amountPaid": {
"amount": 430.0,
"currency": "UAH",
"amountNet": 420.0,
"valueAddedTaxIncluded": true
},
"status": "terminated",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"items": [
{
"id": "d7ba05ad129d4380b139d363df055ec0",
"description": "Комп’ютерне обладнання",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
},
{
"id": "98b99c56dacf48728e1a069205bdf6c2",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
}
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"bid_owner": "broker",
"id": "eb4343b446004f47aa2ec7f6e542f196"
}
}
Зверніть увагу, що ви можете встановлювати/змінювати значення amountPaid.amount, amountPaid.amountNet, amountPaid.valueAddedTaxIncluded. А значення поля amountPaid.currency генеруються з поля Contract.value.
Якщо договір неуспішний, то потрібно вказати причини його припинення terminationDetails.
Після цього додання змін до договору не дозволяється.
Агреговані контракти
Створення агрегованих контрактів
Для кожного об’єктку buyer в тендері система створює окремий contract відповідно, в той момент коли award стає активним.
Створюємо тендер з декількома buyers, кожен item повинен бути прив’язаний до відповідного buyer, використовючи поле relatedBuyer:
Request
POST /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 6211
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"value": {
"amount": 500,
"currency": "UAH"
},
"minimalStep": {
"amount": 15,
"currency": "UAH"
},
"items": [
{
"description": "телевізори",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"relatedBuyer": "11111111111111111111111111111111"
},
{
"description": "портфелі",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"relatedBuyer": "22222222222222222222222222222222"
},
{
"description": "портфелі",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"relatedBuyer": "22222222222222222222222222222222"
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T01:00:00+03:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T01:00:00+03:00"
},
"procurementMethodType": "belowThreshold",
"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
}
],
"buyers": [
{
"id": "11111111111111111111111111111111",
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
}
},
{
"id": "22222222222222222222222222222222",
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037254",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
}
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/aa38d9c00da04374aa49bfa7d8f5dfd3
{
"data": {
"mainProcurementCategory": "goods",
"buyers": [
{
"id": "11111111111111111111111111111111",
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
}
},
{
"id": "22222222222222222222222222222222",
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037254",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
}
}
],
"title": "футляри до державних нагород",
"status": "draft",
"awardCriteria": "lowestCost",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-10-17T01:00:00+03:00",
"endDate": "2023-10-24T01:00:00+03:00"
},
"items": [
{
"id": "3829ed01fa9545e7b491f51dc52ca27d",
"description": "телевізори",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "11111111111111111111111111111111"
},
{
"id": "6233be6bfc2444c7ac22442d442fd437",
"description": "портфелі",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
},
{
"id": "8d3aaa96a57d4fcfb2b5e84fade75a38",
"description": "портфелі",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "99d7613ecdb040b886d4ca13c2d072eb",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procurementMethodType": "belowThreshold",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"kind": "general"
},
"enquiryPeriod": {
"endDate": "2023-10-17T01:00:00+03:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-19T00:00:00+03:00"
},
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "aa38d9c00da04374aa49bfa7d8f5dfd3"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false
},
"access": {
"token": "a950d4fa594a427fb3522f4d2a04c760",
"transfer": "d52aec678df7420fa3db7c7ca9ac7e22"
}
}
Йдемо далі, як зазвичай, активуємо авард
Request
PATCH /api/2.5/tenders/8d1c8bffbc1e4d5f91296f831bc586d0/awards/5eef47a33ded457095af6fea3ef83910?acc_token=b9bebb3cf8bf462b85cfe5c8d42c74a5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "5eef47a33ded457095af6fea3ef83910",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "80ede575285f4617bccc77f12e6de696",
"complaintPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-13T00:00:00+03:00"
}
}
}
Після активації аварду система створює таку кількість об’єктів contracts, що відповідає кількості buyers в тендері
Request
GET /api/2.5/tenders/aa38d9c00da04374aa49bfa7d8f5dfd3/contracts HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "baaae20021a74befa8c02cc7142fc2b9",
"status": "pending",
"awardID": "e6251e8157ce420e8d9efa7161cdf649",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0
}
},
{
"id": "3529ba7acee240c4b5e2df74a10d18f7",
"status": "pending",
"awardID": "e6251e8157ce420e8d9efa7161cdf649",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0
}
}
]
}
Оновлюємо Amount.Value для кожного контракту, враховуючи суму добутків Unit.Value на Quantity для кожного item в контракті:
Request
PATCH /api/2.5/contracts/b012ef6406db4551936e6b0005aa2cef?acc_token=b9bebb3cf8bf462b85cfe5c8d42c74a5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 100,
"amountNet": 95
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"buyerID": "11111111111111111111111111111111",
"awardID": "5eef47a33ded457095af6fea3ef83910",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "8d1c8bffbc1e4d5f91296f831bc586d0",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "4f4759ac513e4071bcc01efc9740e53a",
"description": "телевізори",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "11111111111111111111111111111111",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
}
],
"value": {
"amount": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 95.0
},
"bid_owner": "broker",
"id": "b012ef6406db4551936e6b0005aa2cef"
}
}
Request
PATCH /api/2.5/contracts/e10f210fba404f15a6d1228023fd9fc1?acc_token=b9bebb3cf8bf462b85cfe5c8d42c74a5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 54
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 200,
"amountNet": 190
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"buyerID": "22222222222222222222222222222222",
"awardID": "5eef47a33ded457095af6fea3ef83910",
"contractID": "UA-2023-10-10-000001-a-2",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "8d1c8bffbc1e4d5f91296f831bc586d0",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037254",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "1f8e2bae0cef4600ac58608fd25b28e6",
"description": "портфелі",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "22222222222222222222222222222222",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
},
{
"id": "bfa63d8c3ad04d5f804f40d24b2dc4c1",
"description": "портфелі",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "22222222222222222222222222222222",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
}
],
"value": {
"amount": 200.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 190.0
},
"bid_owner": "broker",
"id": "e10f210fba404f15a6d1228023fd9fc1"
}
}
Ви можете активувати або термінувати кожен контракт як зазвичай. Якщо відсутні контракти в стутусі pending та хоча б один котракт знаходиться в статусі active, тендер переходить в статус complete
При скасуванні аварду всі контракти відповідного awardID переходять в статус cancelled.
Відміна агрегованих контрактів
Контракт може бути відмінений:
Request
PATCH /api/2.5/contracts/baaae20021a74befa8c02cc7142fc2b9?acc_token=a950d4fa594a427fb3522f4d2a04c760 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"buyerID": "11111111111111111111111111111111",
"awardID": "e6251e8157ce420e8d9efa7161cdf649",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tender_id": "aa38d9c00da04374aa49bfa7d8f5dfd3",
"owner": "broker",
"status": "cancelled",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "3829ed01fa9545e7b491f51dc52ca27d",
"description": "телевізори",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "11111111111111111111111111111111",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
}
],
"value": {
"amount": 0.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0.0
},
"bid_owner": "broker",
"date": "2023-10-10T01:00:01+03:00",
"id": "baaae20021a74befa8c02cc7142fc2b9"
}
}
За винятком коли котракт є останнім невідміненим контрактом:
Request
PATCH /api/2.5/contracts/3529ba7acee240c4b5e2df74a10d18f7?acc_token=a950d4fa594a427fb3522f4d2a04c760 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Can't update contract status from pending to cancelled for last not cancelled contract. Cancel award instead."
}
]
}
В цьому випадку повинен бути відмінений відповідний авард:
Request
PATCH /api/2.5/tenders/8d1c8bffbc1e4d5f91296f831bc586d0/awards/5eef47a33ded457095af6fea3ef83910?acc_token=b9bebb3cf8bf462b85cfe5c8d42c74a5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "5eef47a33ded457095af6fea3ef83910",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "80ede575285f4617bccc77f12e6de696",
"complaintPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-13T00:00:00+03:00"
}
}
}
Перевіримо що всі контракти відмінені:
Request
GET /api/2.5/contracts?opt_fields=status HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-10-10T01:00:01+03:00",
"status": "cancelled",
"id": "baaae20021a74befa8c02cc7142fc2b9"
},
{
"status": "cancelled",
"dateModified": "2023-10-10T01:00:01+03:00",
"id": "3529ba7acee240c4b5e2df74a10d18f7"
}
],
"next_page": {
"offset": 1696888801.0,
"path": "/api/2.5/contracts?opt_fields=status&offset=1696888801.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?opt_fields=status&offset=1696888801.0"
}
}