Туторіал
Розглянемо основні правила
Подивимось як працює точка входу /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"
}
}
При виклику видає пустий набір.
Перенесенням договору із системи закупівель займається автоматизований процес.
Створення договору
Нехай у нас відбулась закупівля і вона є в статусі complete. Після цього договір, створений в системі закупівель, потрапляє в систему договорів.
Майданчики (брокери) не мають можливості створювати договори в системі договорів.
Отримання договору
Договір в системі закупівель
Request
GET /api/2.5/tenders/08c193123f36498c8a6f8adaacdee277/contracts/e07c2e4ee19e43c5bce75b127566b232 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": "e07c2e4ee19e43c5bce75b127566b232",
"awardID": "06ea2a70534d48e6b815a0fca2cbc82c",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "active",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 490.0
},
"items": [
{
"id": "b2c802b290d4452da2961ba7ca9b8601",
"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-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "c7dc122e31f943c9b0ec3c7e201fec8a",
"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-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:01+02:00",
"dateSigned": "2023-01-01T00:00:01+02:00"
}
}
Ідентифікатор `id` договору однаковий в системах закупівель та договорів.
Спробуємо доступитись до URL створеного об’єкта:
Request
GET /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "06ea2a70534d48e6b815a0fca2cbc82c",
"contractID": "UA-2023-01-01-000001-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 490.0
},
"items": [
{
"id": "b2c802b290d4452da2961ba7ca9b8601",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "c7dc122e31f943c9b0ec3c7e201fec8a",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"owner": "broker",
"tender_id": "08c193123f36498c8a6f8adaacdee277",
"status": "active",
"dateSigned": "2023-01-01T00:00:01+02:00",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"dateCreated": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"id": "e07c2e4ee19e43c5bce75b127566b232"
}
}
Отримання доступу
Для того, щоб отримати права для майбутнього редагування договору, необхідно використати таку в’юшку 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/e07c2e4ee19e43c5bce75b127566b232/credentials?acc_token=3742e7d6faa4445e9d8e06782736444e HTTP/1.0
Authorization: Bearer broker
Content-Length: 0
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "06ea2a70534d48e6b815a0fca2cbc82c",
"contractID": "UA-2023-01-01-000001-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 490.0
},
"items": [
{
"id": "b2c802b290d4452da2961ba7ca9b8601",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "c7dc122e31f943c9b0ec3c7e201fec8a",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"owner": "broker",
"tender_id": "08c193123f36498c8a6f8adaacdee277",
"status": "active",
"dateSigned": "2023-01-01T00:00:01+02:00",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"dateCreated": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"id": "e07c2e4ee19e43c5bce75b127566b232"
},
"access": {
"token": "272c844263d14805a5db20c61f187eca",
"transfer": "a82d4a39d7b04c93ac16283ea2a2be3d"
}
}
Переглянемо договори.
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-01-01T00:00:01+02:00",
"id": "e07c2e4ee19e43c5bce75b127566b232"
}
],
"next_page": {
"offset": 1672524001.0,
"path": "/api/2.5/contracts?offset=1672524001.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=1672524001.0"
}
}
Ми бачимо внутрішнє id договору (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/contracts/) та його dateModified дату.
Редагування договору
Внесення змін до істотних умов договору можливі у випадках, описаних частиною четвертою статті 36 Закону України “Про публічні закупівлі”.
Істотні умови договору можуть бути змінені поданням нового об’єкта Change в котейнер Contract.changes.
Всі зміни change обробляються точкою входу (endpoint) /contracts/{id}/changes.
Подання зміни
Додамо нову зміну change до договору:
Request
POST /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/changes?acc_token=272c844263d14805a5db20c61f187eca HTTP/1.0
Authorization: Bearer broker
Content-Length: 267
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "9e4c33ab6b874b4fbee83206aaa9b507",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00"
}
}
Зверніть увагу на те, що ви можете надати більше ніж одне значення для поля rationaleTypes.
Ви можете переглянути зміну change:
Request
GET /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/changes/9e4c33ab6b874b4fbee83206aaa9b507 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": "9e4c33ab6b874b4fbee83206aaa9b507",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00"
}
}
Зміну change можна модифікувати доки вона має статус pending.
Request
PATCH /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/changes/9e4c33ab6b874b4fbee83206aaa9b507?acc_token=272c844263d14805a5db20c61f187eca HTTP/1.0
Authorization: Bearer broker
Content-Length: 255
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "9e4c33ab6b874b4fbee83206aaa9b507",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00"
}
}
Завантаження документа зміни
Документ можна додати доки зміна change має статус pending.
Документ додається в два етапи:
ви повинні завантажити документ
Request
POST /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents?acc_token=272c844263d14805a5db20c61f187eca HTTP/1.0
Authorization: Bearer broker
Content-Length: 331
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/0d99c24f1f224e35ae9a11b101f38e20?Signature=BRGDeri7Q8t8DU3AdjZG6kbAIMzD13bxyYUCLpntZeSZAJ5VOQNP5mDDFLwJFjevwRslbeAk8D9osSOn3a6JDA%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/e07c2e4ee19e43c5bce75b127566b232/documents/278f118019164051b58206db16c8ccc3
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0d99c24f1f224e35ae9a11b101f38e20?Signature=frmPNGoQqoxxO6DV2U9E%2F6UlY988%2Bq%2BUeV3Bi%2FxPKhoA4%2FXFO60iLCQJeGwqnD7hxsQzuV4jUS08Nwfj%2BrhOAw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "278f118019164051b58206db16c8ccc3",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
}
ви повинні задати властивості документа:
"documentOf": "change"та"relatedItem": "{change.id}", щоб «прив’язати» завантажений документ до зміни change:
Request
PATCH /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/278f118019164051b58206db16c8ccc3?acc_token=272c844263d14805a5db20c61f187eca HTTP/1.0
Authorization: Bearer broker
Content-Length: 85
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentOf": "change",
"relatedItem": "9e4c33ab6b874b4fbee83206aaa9b507"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"relatedItem": "9e4c33ab6b874b4fbee83206aaa9b507",
"id": "278f118019164051b58206db16c8ccc3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0d99c24f1f224e35ae9a11b101f38e20?Signature=frmPNGoQqoxxO6DV2U9E%2F6UlY988%2Bq%2BUeV3Bi%2FxPKhoA4%2FXFO60iLCQJeGwqnD7hxsQzuV4jUS08Nwfj%2BrhOAw%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
}
Оновлення властивостей зміни
Тепер ви можете оновити властивості договору, що стосуються зміни.
Ви можете встановити нові значення для полів amount та amountNet керуючись наступними правилами:
valueAddedTaxIncluded |
Validation |
true |
Amount should be greater than amountNet and differ by no more than 20% |
false |
Amount and amountNet should be equal |
Request
PATCH /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232?acc_token=272c844263d14805a5db20c61f187eca 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-01-01T00:00:01+02:00",
"endDate": "2023-01-31T00:00:01+02:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "06ea2a70534d48e6b815a0fca2cbc82c",
"contractID": "UA-2023-01-01-000001-a-1",
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-01-31T00:00:01+02:00"
},
"dateSigned": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"dateCreated": "2023-01-01T00:00:01+02:00",
"items": [
{
"id": "b2c802b290d4452da2961ba7ca9b8601",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "c7dc122e31f943c9b0ec3c7e201fec8a",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"tender_id": "08c193123f36498c8a6f8adaacdee277",
"owner": "broker",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "9e4c33ab6b874b4fbee83206aaa9b507",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00"
}
],
"documents": [
{
"relatedItem": "9e4c33ab6b874b4fbee83206aaa9b507",
"id": "278f118019164051b58206db16c8ccc3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/278f118019164051b58206db16c8ccc3?download=0d99c24f1f224e35ae9a11b101f38e20",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"id": "e07c2e4ee19e43c5bce75b127566b232"
}
}
Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.
Поля, які можна модифікувати: title, description, status, value.amount, value.amountNet, period, items, amountPaid.amount, amountPaid.amountТуе, terminationDetails.
Дивіться приклади зміни елемента (items) нижче. Ви можете:
оновити елемент (items):
Request
PATCH /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232?acc_token=272c844263d14805a5db20c61f187eca HTTP/1.0
Authorization: Bearer broker
Content-Length: 2427
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "b2c802b290d4452da2961ba7ca9b8601",
"description": "футляри до державних нагород",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 2,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "c7dc122e31f943c9b0ec3c7e201fec8a",
"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-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "06ea2a70534d48e6b815a0fca2cbc82c",
"contractID": "UA-2023-01-01-000001-a-1",
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-01-31T00:00:01+02:00"
},
"dateSigned": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"dateCreated": "2023-01-01T00:00:01+02:00",
"items": [
{
"id": "b2c802b290d4452da2961ba7ca9b8601",
"description": "футляри до державних нагород",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "c7dc122e31f943c9b0ec3c7e201fec8a",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"tender_id": "08c193123f36498c8a6f8adaacdee277",
"owner": "broker",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "9e4c33ab6b874b4fbee83206aaa9b507",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00"
}
],
"documents": [
{
"relatedItem": "9e4c33ab6b874b4fbee83206aaa9b507",
"id": "278f118019164051b58206db16c8ccc3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/278f118019164051b58206db16c8ccc3?download=0d99c24f1f224e35ae9a11b101f38e20",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"id": "e07c2e4ee19e43c5bce75b127566b232"
}
}
Застосування зміни
Зміна change застосовується при переключенні в статус active.
Щоб застосувати статус active потрібно встановити поле dateSigned.
ПІсля цього модифікувати зміну change вже не можна.
Request
PATCH /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/changes/9e4c33ab6b874b4fbee83206aaa9b507?acc_token=272c844263d14805a5db20c61f187eca 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-01-01T00:00:01+02:00"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00",
"id": "9e4c33ab6b874b4fbee83206aaa9b507",
"status": "active",
"date": "2023-01-01T00:00:01+02:00"
}
}
Валідація поля dateSigned:
для першої зміни change договору дата повинна бути після contract.dateSigned;
для всіх наступних змін change договору дата повинна бути після попередньої дати change.dateSigned.
Ви можете переглянути всі зміни:
Request
GET /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/changes HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00",
"id": "9e4c33ab6b874b4fbee83206aaa9b507",
"status": "active",
"date": "2023-01-01T00:00:01+02:00"
}
]
}
Всі зміни присутні при перегляді контракту.
Request
GET /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232 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": "06ea2a70534d48e6b815a0fca2cbc82c",
"contractID": "UA-2023-01-01-000001-a-1",
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-01-31T00:00:01+02:00"
},
"dateSigned": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"dateCreated": "2023-01-01T00:00:01+02:00",
"items": [
{
"id": "b2c802b290d4452da2961ba7ca9b8601",
"description": "футляри до державних нагород",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "c7dc122e31f943c9b0ec3c7e201fec8a",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"tender_id": "08c193123f36498c8a6f8adaacdee277",
"owner": "broker",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00",
"id": "9e4c33ab6b874b4fbee83206aaa9b507",
"status": "active",
"date": "2023-01-01T00:00:01+02:00"
}
],
"documents": [
{
"relatedItem": "9e4c33ab6b874b4fbee83206aaa9b507",
"id": "278f118019164051b58206db16c8ccc3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/278f118019164051b58206db16c8ccc3?download=0d99c24f1f224e35ae9a11b101f38e20",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"id": "e07c2e4ee19e43c5bce75b127566b232"
}
}
Завантаження документації
Замовник може завантажити PDF файл у створений договір. Завантаження повинно відбуватись згідно правил Завантаження документів.
Request
POST /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents?acc_token=272c844263d14805a5db20c61f187eca HTTP/1.0
Authorization: Bearer broker
Content-Length: 322
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e13edfd2b47b4517b2c666fd6b7c3196?Signature=YDlJ9n4HdHHLgMhCGFqk0foOvdQn3HIwSXXS%2Fln0kj9Bo3ntj6kdXwSwIwffSJSycGHKeI8dmViS9sZQ1HwUAw%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/e07c2e4ee19e43c5bce75b127566b232/documents/df57c2ebdf514c04a00d4bcf03af6b06
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e13edfd2b47b4517b2c666fd6b7c3196?Signature=IYfzAIAKvHzmmhP7RsgXgW0YWTYEblqVeDFlOlJIub5upZTOhnVFjLlHy54NP9A%2BVXa4dkw91bvR0nCCqIaQBg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "df57c2ebdf514c04a00d4bcf03af6b06",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
Request
GET /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents?acc_token=272c844263d14805a5db20c61f187eca HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"relatedItem": "9e4c33ab6b874b4fbee83206aaa9b507",
"id": "278f118019164051b58206db16c8ccc3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0d99c24f1f224e35ae9a11b101f38e20?Signature=frmPNGoQqoxxO6DV2U9E%2F6UlY988%2Bq%2BUeV3Bi%2FxPKhoA4%2FXFO60iLCQJeGwqnD7hxsQzuV4jUS08Nwfj%2BrhOAw%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e13edfd2b47b4517b2c666fd6b7c3196?Signature=IYfzAIAKvHzmmhP7RsgXgW0YWTYEblqVeDFlOlJIub5upZTOhnVFjLlHy54NP9A%2BVXa4dkw91bvR0nCCqIaQBg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "df57c2ebdf514c04a00d4bcf03af6b06",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
]
}
І знову можна перевірити, що є два завантажених документа.
Request
POST /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents?acc_token=272c844263d14805a5db20c61f187eca HTTP/1.0
Authorization: Bearer broker
Content-Length: 338
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/621afd2fea2e451ea7e9a1f1477026f1?Signature=wz5jWWnxgZruWntGzXN8hZ0Jeo1kypuumxSX6meuw46NI%2Fm6xLy6MTlGGNANBrp70OY199WtfiqPlvieCfBCCg%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/e07c2e4ee19e43c5bce75b127566b232/documents/07193403e1d8413d85fd4c6e3927f388
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/621afd2fea2e451ea7e9a1f1477026f1?Signature=WyayoKqVaq3XFMI5pQDqrVIoENeDKjOy6aeOUJl5X37YjF0HR3z4ClC0l1yS0FGSH1vuMBdr1zItM9%2BvTlTpCw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "07193403e1d8413d85fd4c6e3927f388",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
Request
PUT /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/07193403e1d8413d85fd4c6e3927f388?acc_token=272c844263d14805a5db20c61f187eca HTTP/1.0
Authorization: Bearer broker
Content-Length: 340
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/add37452a76c4d0c8d0a94b0bdcc9d60?Signature=xmf6K9TQPgkuD7V0Cb9cj40tlmn9wS3eZv0Fyo2Di89rhH7bbXM%2FEEjMiCNorWd3%2FJlNK83LktF4O1R050AFAg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "07193403e1d8413d85fd4c6e3927f388",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/add37452a76c4d0c8d0a94b0bdcc9d60?Signature=oH1nWqinLpNoS94ZQ1k9CL%2BODC6HsfwYQaZRtnjr0kYQxoViP69dcPLp1nzR6UwSLS8cqx1YFhVjnJXvB2JWCw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
Request
GET /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/07193403e1d8413d85fd4c6e3927f388?acc_token=272c844263d14805a5db20c61f187eca 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": "07193403e1d8413d85fd4c6e3927f388",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/add37452a76c4d0c8d0a94b0bdcc9d60?Signature=oH1nWqinLpNoS94ZQ1k9CL%2BODC6HsfwYQaZRtnjr0kYQxoViP69dcPLp1nzR6UwSLS8cqx1YFhVjnJXvB2JWCw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"previousVersions": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/621afd2fea2e451ea7e9a1f1477026f1?Signature=WyayoKqVaq3XFMI5pQDqrVIoENeDKjOy6aeOUJl5X37YjF0HR3z4ClC0l1yS0FGSH1vuMBdr1zItM9%2BvTlTpCw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "07193403e1d8413d85fd4c6e3927f388",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
]
}
}
Завершення договору
Перед завершенням договору необхідно встановити значення поля amountPaid (незалежно від того успішний договір чи ні). Договір можна завершити переключенням у статус terminated. Виконаємо ці дії єдиним запитом:
Request
PATCH /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232?acc_token=272c844263d14805a5db20c61f187eca HTTP/1.0
Authorization: Bearer broker
Content-Length: 114
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "terminated",
"amountPaid": {
"amount": 430,
"amountNet": 420,
"valueAddedTaxIncluded": true
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "06ea2a70534d48e6b815a0fca2cbc82c",
"contractID": "UA-2023-01-01-000001-a-1",
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-01-31T00:00:01+02:00"
},
"dateSigned": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"dateCreated": "2023-01-01T00:00:01+02:00",
"items": [
{
"id": "b2c802b290d4452da2961ba7ca9b8601",
"description": "футляри до державних нагород",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "c7dc122e31f943c9b0ec3c7e201fec8a",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"tender_id": "08c193123f36498c8a6f8adaacdee277",
"owner": "broker",
"status": "terminated",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00",
"id": "9e4c33ab6b874b4fbee83206aaa9b507",
"status": "active",
"date": "2022-12-31T22:00:01"
}
],
"documents": [
{
"relatedItem": "9e4c33ab6b874b4fbee83206aaa9b507",
"id": "278f118019164051b58206db16c8ccc3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/278f118019164051b58206db16c8ccc3?download=0d99c24f1f224e35ae9a11b101f38e20",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"id": "df57c2ebdf514c04a00d4bcf03af6b06",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/df57c2ebdf514c04a00d4bcf03af6b06?download=e13edfd2b47b4517b2c666fd6b7c3196",
"documentOf": "contract",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"id": "07193403e1d8413d85fd4c6e3927f388",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/07193403e1d8413d85fd4c6e3927f388?download=621afd2fea2e451ea7e9a1f1477026f1",
"documentOf": "contract",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"id": "07193403e1d8413d85fd4c6e3927f388",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/07193403e1d8413d85fd4c6e3927f388?download=add37452a76c4d0c8d0a94b0bdcc9d60",
"documentOf": "contract",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
],
"amountPaid": {
"amount": 430.0,
"currency": "UAH",
"amountNet": 420.0,
"valueAddedTaxIncluded": true
},
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"id": "e07c2e4ee19e43c5bce75b127566b232"
}
}
Зверніть увагу, що ви можете встановлювати/змінювати значення amountPaid.amount, amountPaid.amountNet, amountPaid.valueAddedTaxIncluded. А значення поля amountPaid.currency генеруються з поля Contract.value.
Якщо договір неуспішний, то потрібно вказати причини його припинення terminationDetails.
Після цього додання змін до договору не дозволяється.