Туторіал
Розглянемо основні правила
Подивимось як працює точка входу /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": [],
"next_page": {
"offset": "",
"path": "/api/2.5/contracts",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts"
}
}
При виклику видає пустий набір.
Перенесення договору із системи закупівель відбувається автоматично.Обставини за яких вібувається перенесення, описані нижче.
Створення договору
Нехай у нас відбулась закупівля і є переможець. Після вибору перможця автоматично створюється контракт в закупівлі з обмеженим набором полів(id, awardID, status, date, value) та в системі договорів з повним набором полів(EContract) у статусі pending.
Майданчики (брокери) не мають можливості створювати договори в системі договорів.
Договір створюється з додатковими полями:
contractTemplateName - копіюється з закупівлі, якщо вона встановлена (більше про це в Надання проекту договору)
Договір PQ створюється з додатковими полями:
attributes - формується з вимог та відповідей на виомги у закупівлі
Отримання договору
Договір в системі закупівель
Request
GET /api/2.5/tenders/1acc9cfa6eed4eeea6d8b801bcf4aa98/contracts/78fd8d7877d74b0dbc9c605462545e1c 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": "78fd8d7877d74b0dbc9c605462545e1c",
"status": "pending",
"awardID": "0c30221d374647faae3dff142532b976",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
}
}
}
Ідентифікатор `id` договору однаковий в системах закупівель та договорів.
Спробуємо доступитись до URL створеного об’єкта:
Request
GET /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "0c30221d374647faae3dff142532b976",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"contractTemplateName": "00000000.0002.01",
"status": "pending",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Отримання доступу
ЗАСТЕРЕЖЕННЯ: Наразі цей метод є застарілим(пізніше буде видаленим), ви можете проводити всі дії над договором використовуючи 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/78fd8d7877d74b0dbc9c605462545e1c/credentials?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "0c30221d374647faae3dff142532b976",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"contractTemplateName": "00000000.0002.01",
"status": "pending",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
},
"access": {
"token": "ba3e8e401092463584f16160ce261f98",
"transfer": "5816347e2464460c852bd649bef8de5e"
}
}
Переглянемо договори.
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": "78fd8d7877d74b0dbc9c605462545e1c"
}
],
"next_page": {
"offset": "1696888800.0.1.f9f768d0faee0847eefffbf52378bea6",
"path": "/api/2.5/contracts?offset=1696888800.0.1.f9f768d0faee0847eefffbf52378bea6",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=1696888800.0.1.f9f768d0faee0847eefffbf52378bea6"
}
}
Ми бачимо внутрішнє id договору (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/contracts/) та його dateModified дату.
Редагування чернетки договору
Коли договір у статусі pending замовник може змінити такі поля:
title
description
status
items
value
contractNumber
dateSigned
period
implementation
Встановлення вартості договору
За замовчуванням вартість договору встановлюється на основі рішення про визначення переможця, але є можливість змінити це значення.
Якщо ви хочете знизити вартість договору, ви можете встановити нове значення для поля amount або amountNet (для всіх процедур окрім esco).
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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": "0c30221d374647faae3dff142532b976",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Було повернуто код відповіді 200 OK. Значення змінено успішно.
Встановлення ціни за одиницю
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 12,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "0c30221d374647faae3dff142532b976",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
200 OK відповіддь повертається з успішно створеною структурою item.unit.value.
Item.unit.value.currency має відповідати значенню contract.value.currency. Item.unit.value.valueAddedTaxIncluded має бути False.
Встановлення дати підписання договору
Є можливість встановити дату підписання договору. Для цього вставте відповідну дату в поле dateSigned.
Якщо ви не встановите дату підписання, то вона буде згенерована автоматично під час реєстрації договору.
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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": "0c30221d374647faae3dff142532b976",
"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",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Встановлення терміну дії договору
Встановлення терміну дії договору необов’язкове, але, якщо є необхідність, ви можете встановити відповідну дату початку startDate та кінця endDate терміну дії.
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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": "0c30221d374647faae3dff142532b976",
"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",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"owner": "broker",
"status": "pending",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Завантаження документації по договору
Документи пов’язані з договором можна завантажувати лише до контракту у статусі pending чи active. Спробуємо додати такий документ:
Request
POST /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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/3ef4769b01194c3fb9b85667d21a1307?Signature=alYGlD2G7te8QYpzmUVDauwxpWBFKMtCRdiesch53QHtduDhE3vUadOwjDo%2BCbbhdWMVsTJ7nXe5%2FAInEk4iAQ%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/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ef4769b01194c3fb9b85667d21a1307?Signature=XNfN9287glUx98JoNYH%2Bne8dovYn47EntsAtHWHxtjFnovk%2FoG3koXt4fR7W6PG9Z24BoGB8Opg9%2Fu3TJN4TAQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"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/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ef4769b01194c3fb9b85667d21a1307?Signature=XNfN9287glUx98JoNYH%2Bne8dovYn47EntsAtHWHxtjFnovk%2FoG3koXt4fR7W6PG9Z24BoGB8Opg9%2Fu3TJN4TAQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
Тепер спробуємо додати ще один документ щодо укладанням договору:
Request
POST /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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/fc53e793a7ae423e9d0b454a353d6e3e?Signature=QcI4C0zdNzsb8dSegN%2Ft5%2B0w7gpy6wld0nJYy8Co3siTzz2j%2BoPgPjAJjOGfQrB33%2BRToXIb%2F8i1oAY4Tk%2BABA%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/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fc53e793a7ae423e9d0b454a353d6e3e?Signature=pVHG1VDCQuzW7OsW0Qsglecdr1%2FxzfKAxMfnQFFhH7%2B1T%2BlKG9UwLceeVCuywd5Z17w2wYQqFB3fOcyzOaZ0DQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"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/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ef4769b01194c3fb9b85667d21a1307?Signature=XNfN9287glUx98JoNYH%2Bne8dovYn47EntsAtHWHxtjFnovk%2FoG3koXt4fR7W6PG9Z24BoGB8Opg9%2Fu3TJN4TAQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fc53e793a7ae423e9d0b454a353d6e3e?Signature=pVHG1VDCQuzW7OsW0Qsglecdr1%2FxzfKAxMfnQFFhH7%2B1T%2BlKG9UwLceeVCuywd5Z17w2wYQqFB3fOcyzOaZ0DQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"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/1acc9cfa6eed4eeea6d8b801bcf4aa98/awards/0c30221d374647faae3dff142532b976?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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/1acc9cfa6eed4eeea6d8b801bcf4aa98/awards/2c31244c27874e13b5e97bdab8a6b7e0
{
"data": {
"id": "0c30221d374647faae3dff142532b976",
"status": "cancelled",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"bid_id": "5e818bcf21be4d18a84f29d3c85326f7",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "1c04209a75564f6c9800996eff78af44",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/19490ea9427f4458b9607cd94d20b5e3?Signature=yCoELtqowpqESVTm03OLr9Gm%2B9kkSxZUiUcpD3rkM7e6gsTbJJd0t1YVxjXL3eWFweY%2B0Ocl48YHMi6cJCJPDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"qualified": true
}
}
Договір у системі закупівель автомтично перейде до cancelled
Request
GET /api/2.5/tenders/1acc9cfa6eed4eeea6d8b801bcf4aa98/contracts/78fd8d7877d74b0dbc9c605462545e1c 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": "78fd8d7877d74b0dbc9c605462545e1c",
"status": "cancelled",
"awardID": "0c30221d374647faae3dff142532b976",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
}
}
}
Договір у системі договорів також автоматично перейде до cancelled
Request
GET /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c 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": "0c30221d374647faae3dff142532b976",
"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",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"owner": "broker",
"status": "cancelled",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"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": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Відміна через зміну договору
Якщо ви спробуєте змінити статус договору з pending на cancelled ви отримаєте помилку:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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"
}
]
}
Активація договору
Якщо у закупівлі встановлено contractTemplateName (більше про це в Надання проекту договору), то це значення буде використано як contractTemplateName для договору. Якщо contractTemplateName встановлено для договору, то для його активації потрібна інформація про підписантів. Розглянемо закупівлю з встановленим contractTemplateName:
Request
GET /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c 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": "0c30221d374647faae3dff142532b976",
"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",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 18,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"owner": "broker",
"status": "pending",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"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": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
При спробі активувати договір без заповненої інформації підписанта, буде отримана помилка:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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": "contractNumber is required for contract in `active` status"
}
]
}
Замовник заповнює інформацію підписанта використовуючи contract_token чи tender_token:
Request
PUT /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/buyer/signer_info?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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
null
Постачальник заповнює інформацію підписанта використовуючи bid_token, для limited процедури цей запит виконує замовник використовуючи contract_token чи tender_token:
Request
PUT /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/suppliers/signer_info?acc_token=fa9c9d9f37b94e2fa1a6b6c9053b5cdc HTTP/1.0
Authorization: Bearer broker
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
null
Інформацію підписанта можна оновоити використовуючи той самий спосіб:
Request
PUT /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/buyer/signer_info?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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/78fd8d7877d74b0dbc9c605462545e1c?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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": "contractNumber is required for contract in `active` status"
}
]
}
Після того, як було додано інформацію про підписантів та інші обов’язкові поля, ви можете зареєструвати договір:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"contractNumber": "contract #13111"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "0c30221d374647faae3dff142532b976",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract #13111",
"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",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 18.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"documents": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Після активації договору, договір у системі закупівель автоматично перейде у active і закупівля у статус complete:
Request
GET /api/2.5/tenders/1acc9cfa6eed4eeea6d8b801bcf4aa98 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",
"contractTemplateName": "00000000.0002.01",
"title": "Комп’ютерне обладнання",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "complete",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"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-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"kind": "general"
},
"items": [
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"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": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
},
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"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": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
}
],
"criteria": [
{
"id": "9ce0865e159048a59f1c1b1435d4f004",
"description": "Форма випуску",
"source": "tenderer",
"relatesTo": "item",
"relatedItem": "5b122642e8964f00a1535be1d2b2270a",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
},
"title": "Форма випуску",
"legislation": [
{
"version": "2020-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19"
},
"type": "NATIONAL_LEGISLATION"
}
],
"requirementGroups": [
{
"id": "32d539dbe3f74fa39d04334ce50f0a5e",
"description": "Форма випуску",
"requirements": [
{
"id": "8f32908e97044dce93d980372b9a8f17",
"title": "Форма випуску",
"dataType": "string",
"status": "active",
"expectedValues": [
"Розчин для інфузій"
],
"expectedMinItems": 1,
"datePublished": "2023-10-10T01:00:00+03:00"
},
{
"id": "87011a4e43ad41c2897843cbb97cf82d",
"title": "Доза діючої речовини",
"dataType": "integer",
"status": "active",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5,
"datePublished": "2023-10-10T01:00:00+03:00"
},
{
"id": "052a50262a064abe80cdd6005b1794e9",
"title": "Форма випуску 1",
"dataType": "string",
"status": "active",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 1,
"expectedMaxItems": 3,
"datePublished": "2023-10-10T01:00:00+03:00"
}
]
}
]
}
],
"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",
"auctionPeriod": {
"startDate": "2023-10-20T01:00:00+03:00"
},
"bids": [
{
"id": "5e818bcf21be4d18a84f29d3c85326f7",
"date": "2023-10-10T01:00:00+03:00",
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "8f32908e97044dce93d980372b9a8f17",
"title": "Форма випуску"
},
"values": [
"Розчин для інфузій"
],
"id": "eb529a29bf9f40afb4cbb6eac3a05909",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "87011a4e43ad41c2897843cbb97cf82d",
"title": "Доза діючої речовини"
},
"value": 5,
"id": "9fbee8839d1443ce8c411170f3ff8e64",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "052a50262a064abe80cdd6005b1794e9",
"title": "Форма випуску 1"
},
"values": [
"Відповідь1",
"Відповідь2"
],
"id": "2057cf7fb70d4373a9ffb2f2b469d640",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
}
],
"status": "active",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 10.0
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
],
"submissionDate": "2023-10-10T01:00:00+03:00",
"initialValue": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"awardPeriod": {
"startDate": "2023-10-10T01:00:00+03:00"
},
"awards": [
{
"id": "0c30221d374647faae3dff142532b976",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"bid_id": "5e818bcf21be4d18a84f29d3c85326f7",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "1c04209a75564f6c9800996eff78af44",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/19490ea9427f4458b9607cd94d20b5e3?Signature=yCoELtqowpqESVTm03OLr9Gm%2B9kkSxZUiUcpD3rkM7e6gsTbJJd0t1YVxjXL3eWFweY%2B0Ocl48YHMi6cJCJPDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"qualified": true
},
{
"id": "2c31244c27874e13b5e97bdab8a6b7e0",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"bid_id": "5e818bcf21be4d18a84f29d3c85326f7",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-18T00:00:00+03:00"
}
}
],
"contracts": [
{
"id": "78fd8d7877d74b0dbc9c605462545e1c",
"status": "active",
"awardID": "0c30221d374647faae3dff142532b976",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
}
}
],
"id": "1acc9cfa6eed4eeea6d8b801bcf4aa98"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 0,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Редагування зареєстрованого договору
Внесення змін до істотних умов договору можливі у випадках, описаних частиною четвертою статті 36 Закону України “Про публічні закупівлі”.
Істотні умови договору можуть бути змінені поданням нового об’єкта Change в котейнер Contract.changes.
Всі зміни change обробляються точкою входу (endpoint) /contracts/{id}/changes.
Подання зміни
Додамо нову зміну change до договору:
Request
POST /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/changes?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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": "68c208e991674fcfb5853d81817fd6e9",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
}
Зверніть увагу на те, що ви можете надати більше ніж одне значення для поля rationaleTypes.
Ви можете переглянути зміну change:
Request
GET /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/changes/68c208e991674fcfb5853d81817fd6e9 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": "68c208e991674fcfb5853d81817fd6e9",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
}
Зміну change можна модифікувати доки вона має статус pending.
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/changes/68c208e991674fcfb5853d81817fd6e9?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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": "68c208e991674fcfb5853d81817fd6e9",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
}
Завантаження документа зміни
Документ можна додати доки зміна change має статус pending.
Документ додається в два етапи:
ви повинні завантажити документ
Request
POST /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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/8951da71589746199cc3c8345d51fe37?Signature=JzikcIXL71sjvVRTa1TTU0jFJz8Bk%2BR8C6J4i7rTY6Wxt3eJE6bxsA5Rl98Ilcdc23lfJ5hvw4CboS1OrZdBCQ%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/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8951da71589746199cc3c8345d51fe37?Signature=Eh6fL9ydZXf0LJtuYMxpGuv%2FXHFQXYwZm%2B8DvyXhiFKzbCN6MaGp5L%2B8E8onS82JHdVQMGE0KmXixTr7DS5lBQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"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/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentOf": "change",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8951da71589746199cc3c8345d51fe37?Signature=Eh6fL9ydZXf0LJtuYMxpGuv%2FXHFQXYwZm%2B8DvyXhiFKzbCN6MaGp5L%2B8E8onS82JHdVQMGE0KmXixTr7DS5lBQ%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% (але Amount та amountNet можуть бути рівними) |
false |
Amount and amountNet should be equal |
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 240,
"amountNet": 200
},
"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": "0c30221d374647faae3dff142532b976",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract #13111",
"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",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 18.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3?download=8951da71589746199cc3c8345d51fe37",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"value": {
"amount": 240.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 200.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.
Поля, які можна модифікувати: title, description, status, value.amount, value.amountNet, period, items, amountPaid.amount, amountPaid.amountNet, terminationDetails.
Дивіться приклади зміни елемента (items) нижче. Ви можете:
оновити елемент (items):
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 20,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "0c30221d374647faae3dff142532b976",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract #13111",
"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",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 20.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3?download=8951da71589746199cc3c8345d51fe37",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"value": {
"amount": 240.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 200.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Застосування зміни
Зміна change застосовується при переключенні в статус active.
Щоб застосувати статус active потрібно встановити поле dateSigned.
Після цього модифікувати зміну change вже не можна.
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/changes/68c208e991674fcfb5853d81817fd6e9?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"dateSigned": "2023-10-10T01:00:00+03:00"
}
}
Валідація поля dateSigned:
для першої зміни change договору дата повинна бути після contract.dateSigned;
для всіх наступних змін change договору дата повинна бути після попередньої дати change.dateSigned.
Ви можете переглянути всі зміни:
Request
GET /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/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"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"dateSigned": "2023-10-10T01:00:00+03:00"
}
]
}
Всі зміни присутні при перегляді контракту.
Request
GET /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c 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": "0c30221d374647faae3dff142532b976",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract #13111",
"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",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 20.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"dateSigned": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3?download=8951da71589746199cc3c8345d51fe37",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"value": {
"amount": 240.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 200.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Завантаження документації
Замовник може завантажити PDF файл у створений договір. Завантаження повинно відбуватись згідно правил Завантаження документів.
Request
POST /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d2dfb81496b645a9ad5080512e3c40f4?Signature=hpjTZhVhbq2MrC%2FX6EKUXeWJrFZBNTd5NlN4bZuWSI3KU8z6axhA3l14BxuW8%2FiNK86MwBhaKBzY78XcbZkJBQ%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/78fd8d7877d74b0dbc9c605462545e1c/documents/6a8a54759fce4d3fa3d2bec918423646
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d2dfb81496b645a9ad5080512e3c40f4?Signature=IHNzhEfMRmx22zABcPM6Zp4H1R396AMEglrbLvpoS12nE5caPCSmtg15%2FdPJH%2FM9EZpiVS9BwsAgvvPDKSl7CA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "6a8a54759fce4d3fa3d2bec918423646",
"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/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ef4769b01194c3fb9b85667d21a1307?Signature=XNfN9287glUx98JoNYH%2Bne8dovYn47EntsAtHWHxtjFnovk%2FoG3koXt4fR7W6PG9Z24BoGB8Opg9%2Fu3TJN4TAQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fc53e793a7ae423e9d0b454a353d6e3e?Signature=pVHG1VDCQuzW7OsW0Qsglecdr1%2FxzfKAxMfnQFFhH7%2B1T%2BlKG9UwLceeVCuywd5Z17w2wYQqFB3fOcyzOaZ0DQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8951da71589746199cc3c8345d51fe37?Signature=Eh6fL9ydZXf0LJtuYMxpGuv%2FXHFQXYwZm%2B8DvyXhiFKzbCN6MaGp5L%2B8E8onS82JHdVQMGE0KmXixTr7DS5lBQ%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d2dfb81496b645a9ad5080512e3c40f4?Signature=IHNzhEfMRmx22zABcPM6Zp4H1R396AMEglrbLvpoS12nE5caPCSmtg15%2FdPJH%2FM9EZpiVS9BwsAgvvPDKSl7CA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "6a8a54759fce4d3fa3d2bec918423646",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
І знову можна перевірити, що є два завантажених документа.
Request
POST /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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/ef2fb5872c82422ca7d0ece4f4a3e8ed?Signature=%2BvzOYKZNkTfFJt61jxCUm9XQ0hyi6Of8RquzLHmqHBCcqnV%2BfLntiPcbLQGahp4FDpjaYOYPzt0HOoyWsuj7Cg%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/78fd8d7877d74b0dbc9c605462545e1c/documents/8ebfb8c02bac4da99c4c82a17c10d8f8
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ef2fb5872c82422ca7d0ece4f4a3e8ed?Signature=I8gJNoDiXD6FQ7BeRWhIrPoEI9fuGvOVZ7TdmhrsxYLNoArvD6V39NiH79jqI0YTHQApHrbvnGq1Z9dYnDHzDA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
Request
PUT /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/8ebfb8c02bac4da99c4c82a17c10d8f8?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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/a9311975ab314480acfbb59c2e09b9a8?Signature=TSm%2Fw%2Bzt758HDLOe7W8OXqCY756K%2B5hSYeYBkrQAaNCaO9SX%2Fh3ToWDwvLHOKfPMxJPsOkLWq6Guu116hWtMCg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a9311975ab314480acfbb59c2e09b9a8?Signature=eLLNv1wdCAVGGf7H9Hwp21H7crlhV%2B%2Fq4mOML4yjIThwAfk7XkkajH0O39kI9meZU68FWK6qokxpJAhZxRBCCw%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/78fd8d7877d74b0dbc9c605462545e1c/documents/8ebfb8c02bac4da99c4c82a17c10d8f8?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a9311975ab314480acfbb59c2e09b9a8?Signature=eLLNv1wdCAVGGf7H9Hwp21H7crlhV%2B%2Fq4mOML4yjIThwAfk7XkkajH0O39kI9meZU68FWK6qokxpJAhZxRBCCw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"previousVersions": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ef2fb5872c82422ca7d0ece4f4a3e8ed?Signature=I8gJNoDiXD6FQ7BeRWhIrPoEI9fuGvOVZ7TdmhrsxYLNoArvD6V39NiH79jqI0YTHQApHrbvnGq1Z9dYnDHzDA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
}
Завершення договору
Перед завершенням договору необхідно встановити значення поля amountPaid (незалежно від того успішний договір чи ні). Договір можна завершити переключенням у статус terminated. Виконаємо ці дії єдиним запитом:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "terminated",
"amountPaid": {
"amount": 240,
"amountNet": 200,
"valueAddedTaxIncluded": true
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "0c30221d374647faae3dff142532b976",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract #13111",
"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",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 20.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "1acc9cfa6eed4eeea6d8b801bcf4aa98",
"owner": "broker",
"status": "terminated",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "active",
"date": "2023-10-09T22:00:00",
"dateSigned": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3?download=8951da71589746199cc3c8345d51fe37",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "6a8a54759fce4d3fa3d2bec918423646",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/6a8a54759fce4d3fa3d2bec918423646?download=d2dfb81496b645a9ad5080512e3c40f4",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/8ebfb8c02bac4da99c4c82a17c10d8f8?download=ef2fb5872c82422ca7d0ece4f4a3e8ed",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/8ebfb8c02bac4da99c4c82a17c10d8f8?download=a9311975ab314480acfbb59c2e09b9a8",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"amountPaid": {
"amount": 240.0,
"currency": "UAH",
"amountNet": 200.0,
"valueAddedTaxIncluded": true
},
"value": {
"amount": 240.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 200.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Зверніть увагу, що ви можете встановлювати/змінювати значення 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-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"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": 1,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45
}
],
"contractTemplateName": "00000000.0002.01",
"buyers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
},
"id": "11111111111111111111111111111111"
},
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037254",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
},
"id": "22222222222222222222222222222222"
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f3167a9af8a5408e9c9bf06a20c342af
{
"data": {
"mainProcurementCategory": "goods",
"buyers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"id": "11111111111111111111111111111111",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037254",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"id": "22222222222222222222222222222222",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"title": "футляри до державних нагород",
"status": "draft",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T01:00:00+03:00",
"endDate": "2023-10-24T01:00:00+03:00"
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "36a0ebd2e0384832b07998384bee5afa",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "belowThreshold",
"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"
},
"items": [
{
"id": "fe66d188f34747d5951b6beccec3e6d6",
"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": "b5d9b537b9504cd593f910631e6bdddf",
"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": "2d1b0babcc54478fba1a16d7f3720bd9",
"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"
}
],
"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": "f3167a9af8a5408e9c9bf06a20c342af"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false
},
"access": {
"token": "7ad226ebe2cc4033acb03c7c28304fda",
"transfer": "d4e4422202554bd2985b9af404661a90"
}
}
Йдемо далі, як зазвичай, активуємо авард
Request
PATCH /api/2.5/tenders/a2a81b5e37bf4a689b8300d5a9447a11/awards/8facda3d30224909895aa678c5ecbdac?acc_token=bd752c98d89446f193f57dcd79983c09 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "8facda3d30224909895aa678c5ecbdac",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"bid_id": "4e7b81b085a44b5da48c147911cdbcaa",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "eb1c69ba603f4aa49eb7748457bfe653",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9510b53f5dd74081b27efe3ab282827a?Signature=moE%2BdidrjsIRZCl20pGYWsIxkuqGVj1s9t06NnjCxPGmg0L38%2FFmWUu4vMdhQIEetzu9wDwRyTduzZlZFdeqCQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-18T00:00:00+03:00"
},
"qualified": true,
"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/f3167a9af8a5408e9c9bf06a20c342af/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": "790377c1e17d4a10956295b8430efb4a",
"status": "pending",
"awardID": "35d712ce71d44d0581150ef3f9cbfa3f",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0
}
},
{
"id": "ccced68340f74973894bcfbbac2d355b",
"status": "pending",
"awardID": "35d712ce71d44d0581150ef3f9cbfa3f",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000001-a-2",
"value": {
"amount": 0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0
}
}
]
}
Оновлюємо Amount.Value для кожного контракту, враховуючи суму добутків Unit.Value на Quantity для кожного item в контракті:
Request
PATCH /api/2.5/contracts/bf2f401c12e7476986fd5008fd191ee3?acc_token=bd752c98d89446f193f57dcd79983c09 HTTP/1.0
Authorization: Bearer broker
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": "8facda3d30224909895aa678c5ecbdac",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "dff9002cefc14fb087138d205bdb6aab",
"description": "телевізори",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "11111111111111111111111111111111"
}
],
"tender_id": "a2a81b5e37bf4a689b8300d5a9447a11",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 95.0
},
"id": "bf2f401c12e7476986fd5008fd191ee3"
},
"config": {
"restricted": false
}
}
Request
PATCH /api/2.5/contracts/66570cc698414ed6a3d9f41e21430ffd?acc_token=bd752c98d89446f193f57dcd79983c09 HTTP/1.0
Authorization: Bearer broker
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": "8facda3d30224909895aa678c5ecbdac",
"contractID": "UA-2023-10-10-000001-a-2",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "904d401d470746dea36321c947700fc2",
"description": "портфелі",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "22222222222222222222222222222222"
},
{
"id": "4b4f9ec479ce4edd9721fec1f323568c",
"description": "портфелі",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "22222222222222222222222222222222"
}
],
"tender_id": "a2a81b5e37bf4a689b8300d5a9447a11",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037254",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 200.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 190.0
},
"id": "66570cc698414ed6a3d9f41e21430ffd"
},
"config": {
"restricted": false
}
}
Ви можете активувати або термінувати кожен контракт як зазвичай. Якщо відсутні контракти в стутусі pending та хоча б один котракт знаходиться в статусі active, тендер переходить в статус complete
При скасуванні аварду всі контракти відповідного awardID переходять в статус cancelled.
Відміна агрегованих контрактів
Контракт може бути відмінений:
Request
PATCH /api/2.5/contracts/790377c1e17d4a10956295b8430efb4a?acc_token=7ad226ebe2cc4033acb03c7c28304fda HTTP/1.0
Authorization: Bearer broker
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": "35d712ce71d44d0581150ef3f9cbfa3f",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "fe66d188f34747d5951b6beccec3e6d6",
"description": "телевізори",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "11111111111111111111111111111111"
}
],
"tender_id": "f3167a9af8a5408e9c9bf06a20c342af",
"owner": "broker",
"status": "cancelled",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 0.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0.0
},
"date": "2023-10-10T01:00:01+03:00",
"id": "790377c1e17d4a10956295b8430efb4a"
},
"config": {
"restricted": false
}
}
За винятком коли котракт є останнім невідміненим контрактом:
Request
PATCH /api/2.5/contracts/ccced68340f74973894bcfbbac2d355b?acc_token=7ad226ebe2cc4033acb03c7c28304fda HTTP/1.0
Authorization: Bearer broker
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/1acc9cfa6eed4eeea6d8b801bcf4aa98/awards/0c30221d374647faae3dff142532b976?acc_token=2a616f20d95648cd87d33fdc9357fc4e HTTP/1.0
Authorization: Bearer broker
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/1acc9cfa6eed4eeea6d8b801bcf4aa98/awards/2c31244c27874e13b5e97bdab8a6b7e0
{
"data": {
"id": "0c30221d374647faae3dff142532b976",
"status": "cancelled",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"bid_id": "5e818bcf21be4d18a84f29d3c85326f7",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "1c04209a75564f6c9800996eff78af44",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/19490ea9427f4458b9607cd94d20b5e3?Signature=yCoELtqowpqESVTm03OLr9Gm%2B9kkSxZUiUcpD3rkM7e6gsTbJJd0t1YVxjXL3eWFweY%2B0Ocl48YHMi6cJCJPDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"qualified": true
}
}
Перевіримо що всі контракти відмінені:
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": "790377c1e17d4a10956295b8430efb4a"
},
{
"status": "cancelled",
"dateModified": "2023-10-10T01:00:01+03:00",
"id": "ccced68340f74973894bcfbbac2d355b"
}
],
"next_page": {
"offset": "1696888801.0.2.69b1d97d9650b9547b86af9bf51c65ad",
"path": "/api/2.5/contracts?opt_fields=status&offset=1696888801.0.2.69b1d97d9650b9547b86af9bf51c65ad",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?opt_fields=status&offset=1696888801.0.2.69b1d97d9650b9547b86af9bf51c65ad"
}
}