Туторіал¶
Розглянемо основні правила¶
Подивимось як працює точка входу /contracts:
GET /api/2.5/contracts HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-09-01T01:00:00+03:00",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
],
"next_page": {
"offset": 1693519200.0,
"path": "/api/2.5/contracts?offset=1693519200.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=1693519200.0"
}
}
При виклику видає пустий набір.
Перенесенням договору із системи закупівель займається автоматизований процес.
Створення договору¶
Нехай у нас відбулась закупівля і є переможець. Після вибору перможця автоматично створюється контракт в закупівлі з обмеженим набором полів(id, awardID, status, date) та в системі договорів з повним набором полів(EContract) у статусі pending
.
Майданчики (брокери) не мають можливості створювати договори в системі договорів.
Отримання договору¶
Договір в системі закупівель
GET /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/contracts/0df8cf97d5cb4ba98a7355f981e0afd2 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0df8cf97d5cb4ba98a7355f981e0afd2",
"status": "pending",
"awardID": "c220713cbd024586b6382ef97a852dc7",
"date": "2023-09-01T01:00:00+03:00"
}
}
Ідентифікатор `id` договору однаковий в системах закупівель та договорів.
Спробуємо доступитись до URL створеного об’єкта:
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"owner": "broker",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"contractTemplateUri": "templates/contracts/test.html",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"bid_owner": "broker",
"status": "pending",
"dateCreated": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Отримання доступу¶
ЗАСТЕРЕЖЕННЯ: Наразі цей метод є застарілим(пізніше буде видаленим), ви можете проводити всі дії над договором використовуючи tender_token
.
Для того, щоб отримати права для майбутнього редагування договору, необхідно використати таку в’юшку PATCH: /contracts/{id}/credentials?acc_token={tender_token}
з API ключем майданчика, де була згенерована закупівля.
В PATCH: /contracts/{id}/credentials?acc_token={tender_token}
:
id
- це ідентифікатор договору,tender_token
- це токен закупівлі (використовується для генерування токена договору).
У відповіді буде access.token
для договору, який буде використовуватись для модифікації договору.
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/credentials?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 0
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2024-08-31T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
},
"access": {
"token": "84ff84eadc46497bbc8eae97c3dacdf0",
"transfer": "17dc1fcad66b41d5882c4699f481a977"
}
}
Переглянемо договори.
GET /api/2.5/contracts HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-09-01T01:00:00+03:00",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
],
"next_page": {
"offset": 1693519200.0,
"path": "/api/2.5/contracts?offset=1693519200.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=1693519200.0"
}
}
Ми бачимо внутрішнє id договору (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/contracts/) та його dateModified дату.
Редагування чернетки договору¶
Встановлення вартості угоди¶
За замовчуванням вартість угоди встановлюється на основі рішення про визначення переможця, але є можливість змінити це значення.
Якщо ви хочете знизити вартість угоди, ви можете встановити нове значення для поля amount.
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 238,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Було повернуто код відповіді 200 OK. Значення змінено успішно.
Встановлення ціни за одиницю¶
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1364
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
200 OK відповіддь повертається з успішно створеною структурою item.unit.value.
Item.unit.value.currency та Item.unit.value.valueAddedTaxIncluded створюються, використовуючи інформацію з contract.value(якщо існує), в іншому випадку з tender.value
Встановлення дати підписання угоди¶
Є можливість встановити дату підписання угоди. Для цього вставте відповідну дату в поле dateSigned.
Якщо ви не встановите дату підписання, то вона буде згенерована автоматично під час реєстрації угоди.
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"dateSigned": "2023-09-01T01:00:00+03:00"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"dateSigned": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Встановлення терміну дії угоди¶
Встановлення терміну дії угоди необов’язкове, але, якщо є необхідність, ви можете встановити відповідну дату початку startDate та кінця endDate терміну дії.
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2024-08-31T01:00:00+03:00"
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2024-08-31T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Завантаження документації по угоді¶
Документи пов’язані з угодою можна завантажувати лише до укладання угоди. Спробуємо додати такий документ:
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 340
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_first_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=fcU8fQotbTE1nxHUmBfCgrwjfNjcDiJJA89ynym%2FRoye5cKevbbMvWzJadlyW1KJlrIEimpkzWeEDVhj85zUBA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
Переглянемо список завантажених документів:
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
]
}
Тепер спробуємо додати ще один документ щодо укладанням угоди:
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 351
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_second_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=y%2Bc%2FV%2BSIqnf36NvLLrimQyaWUtCCEZEgtEl%2FsALE5XH5bqEoXwnwNhAkhsKg1JfVY9%2BEwvXxHKhaD5p%2BZBhCBw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=x6tzZwzV4d5DGLeiqvD%2Bm0EdAUGgzUmYnoQ4AjImnxjQRU49JnE3aq50UHtPUVvIRfF5JSrLqmyF3tssHOT%2BCA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що ще один документ було додано.
Тепер переглянемо знову усі документи пов’язані із укладанням угоди:
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=x6tzZwzV4d5DGLeiqvD%2Bm0EdAUGgzUmYnoQ4AjImnxjQRU49JnE3aq50UHtPUVvIRfF5JSrLqmyF3tssHOT%2BCA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
]
}
Скасування угоди¶
Існує два способи скасування угоди:
- Зміна стаусу award з active на cancelled
- Зміна статусу угоди з «pending» to «cancelled» (цей метод працює, коли це не останній активний договір)
Відміна угоди через award¶
Все що потрібно, це змінити статус award на cancelled
PATCH /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/awards/c220713cbd024586b6382ef97a852dc7?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/awards/a3771b096c9644c5ba09fe6f9c9cb091
{
"data": {
"id": "c220713cbd024586b6382ef97a852dc7",
"status": "cancelled",
"date": "2023-09-01T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "5324d8e7db1c4a3baf5456140f128229"
}
}
Угода у системі зкупівлі автомтично перейде до cancelled
GET /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/contracts/0df8cf97d5cb4ba98a7355f981e0afd2 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0df8cf97d5cb4ba98a7355f981e0afd2",
"status": "cancelled",
"awardID": "c220713cbd024586b6382ef97a852dc7",
"date": "2023-09-01T01:00:00+03:00"
}
}
Угода у системі договорів також автоматично перейде до cancelled
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2024-08-31T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "cancelled",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"date": "2023-09-01T01:00:00+03:00",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Відміна через зміну договору¶
Якщо ви спробуєте змінити статус останньої угоди з pending
на cancelled
ви отримаєте помилку:
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Can't update contract status"
}
]
}
Реєстрація угоди¶
Перед тим як зареєструвати угоду,потрібно замовнику та постачальнику заповнити інформацію підписанта. При спробі активувати угоду без даної інформації, буде отримана помилка:
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "signerInfo field for buyer and suppliers is required for contract in `active` status"
}
]
}
Замовник заповнює інформацію підписанта використовуючи contract_token
чи tender_token
:
PUT /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/buyer/signer_info?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 354
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
Постачальник заповнює інформацію підписанта використовуючи bid_token
:
PUT /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/suppliers/signer_info?acc_token=31267088715c49d384894418a74fb4b6 HTTP/1.0
Authorization: Bearer broker
Content-Length: 354
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
Після всіх цих дій, ви можете зареєструвати угоду
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2024-08-31T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"date": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Після активації угоди, угода у системі закупівель автоматично перейде у active і закупівля у статус complete:
GET /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"mainProcurementCategory": "goods",
"title": "Комп’ютерне обладнання",
"procurementMethodDetails": "quick, accelerator=1440",
"procurementMethodType": "priceQuotation",
"procurementMethod": "selective",
"awardCriteria": "lowestCost",
"status": "complete",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 2500,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"endDate": "2023-09-01T00:59:00+03:00",
"startDate": "2023-09-01T00:50:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"kind": "general"
},
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "e232a0b37a0041cdb58916e9550102c8",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "f23eb66e67f74ead9d79edc0b42e71c0",
"description": "Форма випуску",
"requirements": [
{
"id": "e6f9be7a505143948d92a687c03d24b5",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "58e197cbf866429196799d8e290a783c",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "f5c97b40f7914db1975cfe728ebd0ca4",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "d8cce89c0dcb4748828ccf2a141554bb",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "108107e8f8a04ed8884e899d96007806",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "dc1f3f74ad8146fd9703b7582e3de385",
"description": "Форма випуску",
"requirements": [
{
"id": "f9d6ad9094d746ffb048ec5d42fb4f9e",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"contractTemplateUri": "templates/contracts/test.html",
"tenderID": "UA-2023-09-01-000001-a",
"owner": "broker",
"date": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"shortlistedFirms": [
{
"address": {
"countryName": "Україна",
"locality": "м.Київ",
"postalCode": "01100",
"region": "Київська область",
"streetAddress": "бул.Дружби Народів, 8"
},
"contactPoint": {
"email": "contact@pixel.pix",
"name": "Оксана Піксель",
"telephone": "+0671234567"
},
"id": "UA-EDR-12345678",
"identifier": {
"id": "00037256",
"legalName": "Товариство з обмеженою відповідальністю «Пікселі»",
"scheme": "UA-EDR"
},
"name": "Товариство з обмеженою відповідальністю «Пікселі»",
"scale": "large",
"status": "active"
},
{
"address": {
"countryName": "Україна",
"locality": "м.Тернопіль",
"postalCode": "46000",
"region": "Тернопільська область",
"streetAddress": "вул. Кластерна, 777-К"
},
"contactPoint": {
"email": "info@shteker.pek",
"name": "Олег Штекер",
"telephone": "+0951234567"
},
"id": "UA-EDR-87654321",
"identifier": {
"id": "87654321",
"legalName": "Товариство з обмеженою відповідальністю «Штекер-Пекер»",
"scheme": "UA-EDR"
},
"name": "Товариство з обмеженою відповідальністю «Штекер-Пекер»",
"scale": "large",
"status": "active"
}
],
"auctionPeriod": {
"startDate": "2023-09-11T01:00:00+03:00"
},
"bids": [
{
"id": "5324d8e7db1c4a3baf5456140f128229",
"date": "2023-09-01T01:00:00+03:00",
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "585ff3cc25684deba52def8cbabef863",
"requirement": {
"id": "e6f9be7a505143948d92a687c03d24b5"
},
"value": "Розчин для інфузій"
},
{
"id": "3a792c49a8cd4188aee2e87af1b8f25d",
"requirement": {
"id": "d8cce89c0dcb4748828ccf2a141554bb"
},
"value": 5
},
{
"id": "315577b4a97c46b5836595e9dafb424a",
"requirement": {
"id": "f9d6ad9094d746ffb048ec5d42fb4f9e"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "active"
}
],
"awardPeriod": {
"startDate": "2023-09-01T01:00:00+03:00"
},
"awards": [
{
"id": "c220713cbd024586b6382ef97a852dc7",
"status": "active",
"date": "2023-09-01T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "5324d8e7db1c4a3baf5456140f128229"
},
{
"id": "a3771b096c9644c5ba09fe6f9c9cb091",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "5324d8e7db1c4a3baf5456140f128229"
}
],
"contracts": [
{
"id": "0df8cf97d5cb4ba98a7355f981e0afd2",
"status": "active",
"awardID": "c220713cbd024586b6382ef97a852dc7",
"date": "2023-09-01T01:00:00+03:00"
}
],
"id": "26fe592e6eb4454fb91865f39117fe4b"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
}
}
Редагування зреєстрованого договору¶
Внесення змін до істотних умов договору можливі у випадках, описаних частиною четвертою статті 36 Закону України “Про публічні закупівлі”.
Істотні умови договору можуть бути змінені поданням нового об’єкта Change в котейнер Contract.changes.
Всі зміни change обробляються точкою входу (endpoint) /contracts/{id}/changes.
Подання зміни¶
Додамо нову зміну change до договору:
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/changes?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 267
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
]
}
}
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00"
}
}
Зверніть увагу на те, що ви можете надати більше ніж одне значення для поля rationaleTypes
.
Ви можете переглянути зміну change:
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/changes/b9887678ba3c448b977467c0fe3ada31 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00"
}
}
Зміну change можна модифікувати доки вона має статус pending
.
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/changes/b9887678ba3c448b977467c0fe3ada31?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 255
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00"
}
}
Завантаження документа зміни¶
Документ можна додати доки зміна change має статус pending
.
Документ додається в два етапи:
- ви повинні завантажити документ
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 333
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_changes.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=mFBbg4SYLP%2BQk4Cn6xwFtFp2XKpLLLIQmIqKvBsiciOF6nuiH7Gw9Wmk0IsPpNVvMLNn21PDO0c5XMfjxxX5Dw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=cG1JU%2F1r%2B2jlQbXxJsq3HCYzzTi9mderkkqPwomMk34J6oAJ%2B7GRNC3kUgPO3zskbNjKkMkhiaJY2PmkUlOkBA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
- ви повинні задати властивості документа:
"documentOf": "change"
та"relatedItem": "{change.id}"
, щоб «прив’язати» завантажений документ до зміни change:
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 85
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentOf": "change",
"relatedItem": "b9887678ba3c448b977467c0fe3ada31"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=cG1JU%2F1r%2B2jlQbXxJsq3HCYzzTi9mderkkqPwomMk34J6oAJ%2B7GRNC3kUgPO3zskbNjKkMkhiaJY2PmkUlOkBA%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
Оновлення властивостей зміни¶
Тепер ви можете оновити властивості договору, що стосуються зміни.
Ви можете встановити нові значення для полів amount та amountNet керуючись наступними правилами:
valueAddedTaxIncluded | Validation |
true | Amount should be greater than amountNet and differ by no more than 20% |
false | Amount and amountNet should be equal |
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 148
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 438,
"amountNet": 430
},
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2023-10-01T01:00:00+03:00"
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2023-10-01T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"date": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.
Поля, які можна модифікувати: title, description, status, value.amount, value.amountNet, period, items, amountPaid.amount, amountPaid.amountNet, terminationDetails.
Дивіться приклади зміни елемента (items) нижче. Ви можете:
- оновити елемент (items):
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1363
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 2,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2023-10-01T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"date": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Застосування зміни¶
Зміна change застосовується при переключенні в статус active
.
Щоб застосувати статус active
потрібно встановити поле dateSigned.
ПІсля цього модифікувати зміну change вже не можна.
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/changes/b9887678ba3c448b977467c0fe3ada31?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 73
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"dateSigned": "2023-09-01T01:00:00+03:00"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-09-01T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-09-01T01:00:00+03:00"
}
}
Валідація поля dateSigned:
- для першої зміни change договору дата повинна бути після contract.dateSigned;
- для всіх наступних змін change договору дата повинна бути після попередньої дати change.dateSigned.
Ви можете переглянути всі зміни:
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/changes HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-09-01T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-09-01T01:00:00+03:00"
}
]
}
Всі зміни присутні при перегляді контракту.
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2023-10-01T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"date": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-09-01T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-09-01T01:00:00+03:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Завантаження документації¶
Замовник може завантажити PDF файл у створений договір. Завантаження повинно відбуватись згідно правил Завантаження документів.
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 324
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc4cd1ee0c1d481d806feb638548e63b?Signature=bnjqiaGHrMcDhc5nxcKQAB7BmArrmXPmJQhahGGze6DVP39jk4gkNyTnhDnnDVbZFeTaNvrNF2rZGp%2Bx%2BBoLDg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/93f808adc3a84ee9b750119a797ed776
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc4cd1ee0c1d481d806feb638548e63b?Signature=C4ypZjunX6e74XGpYj6RLaNEEy%2BfU2mJomhLN9kphQzrRlcRhDIasEB3GcRqbctnAHP%2FjeTcdCVvVOzP2N4zCg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "93f808adc3a84ee9b750119a797ed776",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=x6tzZwzV4d5DGLeiqvD%2Bm0EdAUGgzUmYnoQ4AjImnxjQRU49JnE3aq50UHtPUVvIRfF5JSrLqmyF3tssHOT%2BCA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=cG1JU%2F1r%2B2jlQbXxJsq3HCYzzTi9mderkkqPwomMk34J6oAJ%2B7GRNC3kUgPO3zskbNjKkMkhiaJY2PmkUlOkBA%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc4cd1ee0c1d481d806feb638548e63b?Signature=C4ypZjunX6e74XGpYj6RLaNEEy%2BfU2mJomhLN9kphQzrRlcRhDIasEB3GcRqbctnAHP%2FjeTcdCVvVOzP2N4zCg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "93f808adc3a84ee9b750119a797ed776",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
]
}
І знову можна перевірити, що є два завантажених документа.
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 342
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_additional_docs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/277f219d159f45e1a11923c8b637d463?Signature=VgL3ykVviPI8bAuDmSwq5ViKMXnEfl0hg3JoFdsMGGWxqX9OMdhV6O2XqEatVTRggQhpT1%2BM%2BTWfKpl6%2BrdPBw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/e3a0c2f53a544b8f8f300200e400f460
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/277f219d159f45e1a11923c8b637d463?Signature=EnWBAbSpO74ppQPPbWr9QNTYM%2Fyee5mRc0iwX3fdwZkdZhmNY0oLP6uLF4v9XyU4ouyIjcTdltumSlUyu4%2B4Bg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "e3a0c2f53a544b8f8f300200e400f460",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
PUT /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/e3a0c2f53a544b8f8f300200e400f460?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 336
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_additional_docs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c2fbdf60afd54cf3acdc89af698f87d2?Signature=juo4JvJjP1B3TgmfhUaFNRnKeufTb15Tcc6ecSZ1DYPMGLeG8hfQbgo2h1bRygiwiWmepBWtvuz5z5GqC7bTAw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c2fbdf60afd54cf3acdc89af698f87d2?Signature=kkWFx7aNWwgD%2F3KSmjbnzA%2BYzH4PvTJL1XRiDauwDPCQRsMHTfnUXxTygRpeggxjBENLuks5YIdiYyxxv6yBDg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/e3a0c2f53a544b8f8f300200e400f460?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c2fbdf60afd54cf3acdc89af698f87d2?Signature=kkWFx7aNWwgD%2F3KSmjbnzA%2BYzH4PvTJL1XRiDauwDPCQRsMHTfnUXxTygRpeggxjBENLuks5YIdiYyxxv6yBDg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"previousVersions": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/277f219d159f45e1a11923c8b637d463?Signature=EnWBAbSpO74ppQPPbWr9QNTYM%2Fyee5mRc0iwX3fdwZkdZhmNY0oLP6uLF4v9XyU4ouyIjcTdltumSlUyu4%2B4Bg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "e3a0c2f53a544b8f8f300200e400f460",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
]
}
}
Завершення договору¶
Перед завершенням договору необхідно встановити значення поля amountPaid
(незалежно від того успішний договір чи ні). Договір можна завершити переключенням у статус terminated
. Виконаємо ці дії єдиним запитом:
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 114
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "terminated",
"amountPaid": {
"amount": 430,
"amountNet": 420,
"valueAddedTaxIncluded": true
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2023-10-01T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"date": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-09-01T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-08-31T22:00:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "93f808adc3a84ee9b750119a797ed776",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/93f808adc3a84ee9b750119a797ed776?download=cc4cd1ee0c1d481d806feb638548e63b",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/e3a0c2f53a544b8f8f300200e400f460?download=277f219d159f45e1a11923c8b637d463",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/e3a0c2f53a544b8f8f300200e400f460?download=c2fbdf60afd54cf3acdc89af698f87d2",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"amountPaid": {
"amount": 430.0,
"currency": "UAH",
"amountNet": 420.0,
"valueAddedTaxIncluded": true
},
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"status": "terminated",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Зверніть увагу, що ви можете встановлювати/змінювати значення amountPaid.amount
, amountPaid.amountNet
, amountPaid.valueAddedTaxIncluded
. А значення поля amountPaid.currency
генеруються з поля Contract.value
.
Якщо договір неуспішний, то потрібно вказати причини його припинення terminationDetails
.
Після цього додання змін до договору не дозволяється.