Туторіал¶
Розглянемо основні правила¶
Подивимось як працює точка входу /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/59190c68cfa14b0595a6e1395c43a06b/contracts/38da025ae53f4e0d8fa4474bb5923d12 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": "38da025ae53f4e0d8fa4474bb5923d12",
"awardID": "ce59dcbd1325456cbd1d1632ef5cfb09",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "active",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 490.0
},
"items": [
{
"id": "27d065dad2f843fcaa08ce47d150ff58",
"description": "футляри до державних нагород",
"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"
},
"quantity": 5.0,
"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": "ebbe3cdc3877415898b85d6b8bd0e6d1",
"description": "футляри до державних нагород",
"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"
},
"quantity": 5.0,
"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/38da025ae53f4e0d8fa4474bb5923d12 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "ce59dcbd1325456cbd1d1632ef5cfb09",
"contractID": "UA-2023-01-01-000001-a-1",
"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": "27d065dad2f843fcaa08ce47d150ff58",
"description": "футляри до державних нагород",
"quantity": 5.0,
"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": "Україна"
},
"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"
}
},
{
"id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
"description": "футляри до державних нагород",
"quantity": 5.0,
"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": "Україна"
},
"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"
}
}
],
"tender_id": "59190c68cfa14b0595a6e1395c43a06b",
"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"
}
}
],
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 490.0
},
"id": "38da025ae53f4e0d8fa4474bb5923d12"
}
}
Отримання доступу¶
Для того, щоб отримати права для майбутнього редагування договору, необхідно використати таку в’юшку 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/38da025ae53f4e0d8fa4474bb5923d12/credentials?acc_token=630976cee1134f91b7c0be7bd287d383 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": "ce59dcbd1325456cbd1d1632ef5cfb09",
"contractID": "UA-2023-01-01-000001-a-1",
"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": "27d065dad2f843fcaa08ce47d150ff58",
"description": "футляри до державних нагород",
"quantity": 5.0,
"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": "Україна"
},
"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"
}
},
{
"id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
"description": "футляри до державних нагород",
"quantity": 5.0,
"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": "Україна"
},
"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"
}
}
],
"tender_id": "59190c68cfa14b0595a6e1395c43a06b",
"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"
}
}
],
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 490.0
},
"id": "38da025ae53f4e0d8fa4474bb5923d12"
},
"access": {
"token": "a0e030a63cbe4390a164f7dee4f37dc9",
"transfer": "153b6181be8f4e1bafe830d5f61b5c21"
}
}
Переглянемо договори.
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": "38da025ae53f4e0d8fa4474bb5923d12"
}
],
"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/38da025ae53f4e0d8fa4474bb5923d12/changes?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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": {
"id": "9b42f245308547cc9d4f760dda1dc15c",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00",
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
]
}
}
Зверніть увагу на те, що ви можете надати більше ніж одне значення для поля rationaleTypes.
Ви можете переглянути зміну change:
Request
GET /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/changes/9b42f245308547cc9d4f760dda1dc15c 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": "9b42f245308547cc9d4f760dda1dc15c",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00",
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
]
}
}
Зміну change можна модифікувати доки вона має статус pending.
Request
PATCH /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/changes/9b42f245308547cc9d4f760dda1dc15c?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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": {
"id": "9b42f245308547cc9d4f760dda1dc15c",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
]
}
}
Завантаження документа зміни¶
Документ можна додати доки зміна change має статус pending.
Документ додається в два етапи:
- ви повинні завантажити документ
Request
POST /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Content-Length: 339
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/f63818a2a95e4f2ab5e07260dfe16911?Signature=zs%2FqPiheOiDm1x6q43ctYZNYrwUm6reLF%2F09Ls5WtBbmnb4g%2B09oOdRoLAvJAPEUPlxqg%2FR87F4bF2GB5pQnCA%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/38da025ae53f4e0d8fa4474bb5923d12/documents/1c4e25349f5a4506a469810d1e65ab7a
{
"data": {
"id": "1c4e25349f5a4506a469810d1e65ab7a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"documentOf": "contract"
}
}
- ви повинні задати властивості документа:
"documentOf": "change"та"relatedItem": "{change.id}", щоб «прив’язати» завантажений документ до зміни change:
Request
PATCH /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents/1c4e25349f5a4506a469810d1e65ab7a?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Content-Length: 85
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentOf": "change",
"relatedItem": "9b42f245308547cc9d4f760dda1dc15c"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "1c4e25349f5a4506a469810d1e65ab7a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
"documentOf": "change"
}
}
Оновлення властивостей зміни¶
Тепер ви можете оновити властивості договору, що стосуються зміни.
Ви можете встановити нові значення для полів 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/38da025ae53f4e0d8fa4474bb5923d12?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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": "ce59dcbd1325456cbd1d1632ef5cfb09",
"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": "27d065dad2f843fcaa08ce47d150ff58",
"description": "футляри до державних нагород",
"quantity": 5.0,
"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": "Україна"
},
"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"
}
},
{
"id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
"description": "футляри до державних нагород",
"quantity": 5.0,
"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": "Україна"
},
"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"
}
}
],
"tender_id": "59190c68cfa14b0595a6e1395c43a06b",
"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"
}
}
],
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"changes": [
{
"id": "9b42f245308547cc9d4f760dda1dc15c",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
]
}
],
"documents": [
{
"id": "1c4e25349f5a4506a469810d1e65ab7a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
"documentOf": "change"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"id": "38da025ae53f4e0d8fa4474bb5923d12"
}
}
Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.
Поля, які можна модифікувати: title, description, status, value.amount, value.amountNet, period, items, amountPaid.amount, amountPaid.amountТуе, terminationDetails.
Дивіться приклади зміни елемента (items) нижче. Ви можете:
- оновити елемент (items):
Request
PATCH /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Content-Length: 2427
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "27d065dad2f843fcaa08ce47d150ff58",
"description": "футляри до державних нагород",
"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"
},
"quantity": 2,
"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": "ebbe3cdc3877415898b85d6b8bd0e6d1",
"description": "футляри до державних нагород",
"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"
},
"quantity": 5.0,
"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": "ce59dcbd1325456cbd1d1632ef5cfb09",
"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": "27d065dad2f843fcaa08ce47d150ff58",
"description": "футляри до державних нагород",
"quantity": 2.0,
"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": "Україна"
},
"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"
}
},
{
"id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
"description": "футляри до державних нагород",
"quantity": 5.0,
"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": "Україна"
},
"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"
}
}
],
"tender_id": "59190c68cfa14b0595a6e1395c43a06b",
"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"
}
}
],
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"changes": [
{
"id": "9b42f245308547cc9d4f760dda1dc15c",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
]
}
],
"documents": [
{
"id": "1c4e25349f5a4506a469810d1e65ab7a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
"documentOf": "change"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"id": "38da025ae53f4e0d8fa4474bb5923d12"
}
}
Застосування зміни¶
Зміна change застосовується при переключенні в статус active.
Щоб застосувати статус active потрібно встановити поле dateSigned.
ПІсля цього модифікувати зміну change вже не можна.
Request
PATCH /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/changes/9b42f245308547cc9d4f760dda1dc15c?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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": {
"id": "9b42f245308547cc9d4f760dda1dc15c",
"status": "active",
"date": "2023-01-01T00:00:01+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00"
}
}
Валідація поля dateSigned:
- для першої зміни change договору дата повинна бути після contract.dateSigned;
- для всіх наступних змін change договору дата повинна бути після попередньої дати change.dateSigned.
Ви можете переглянути всі зміни:
Request
GET /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/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": [
{
"id": "9b42f245308547cc9d4f760dda1dc15c",
"status": "active",
"date": "2023-01-01T00:00:01+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00"
}
]
}
Всі зміни присутні при перегляді контракту.
Request
GET /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12 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": "ce59dcbd1325456cbd1d1632ef5cfb09",
"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": "27d065dad2f843fcaa08ce47d150ff58",
"description": "футляри до державних нагород",
"quantity": 2.0,
"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": "Україна"
},
"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"
}
},
{
"id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
"description": "футляри до державних нагород",
"quantity": 5.0,
"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": "Україна"
},
"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"
}
}
],
"tender_id": "59190c68cfa14b0595a6e1395c43a06b",
"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"
}
}
],
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"changes": [
{
"id": "9b42f245308547cc9d4f760dda1dc15c",
"status": "active",
"date": "2023-01-01T00:00:01+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00"
}
],
"documents": [
{
"id": "1c4e25349f5a4506a469810d1e65ab7a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
"documentOf": "change"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"id": "38da025ae53f4e0d8fa4474bb5923d12"
}
}
Завантаження документації¶
Замовник може завантажити PDF файл у створений договір. Завантаження повинно відбуватись згідно правил Завантаження документів.
Request
POST /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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/6b559700bb5245049bdee88a6b887e04?Signature=iK5BqT8DBd6EmNJwkh%2B8qZNfPGVub8YGuJM58munUZv4jm%2FLDGxFutNvGIGQKCjXhK0SYc3KvLR0fDdWGOlIDA%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/38da025ae53f4e0d8fa4474bb5923d12/documents/94cc85afb51346ab95e007a303753924
{
"data": {
"id": "94cc85afb51346ab95e007a303753924",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b559700bb5245049bdee88a6b887e04?Signature=V%2FKGkbsShKDpTJYKPSWbL3h72mRJO%2F6uOi8x6DX1AJxypK7%2FopQidX%2BYz%2BddFJG4BR1KqDCgwBsNe4Xz0kwgBA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"documentOf": "contract"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
Request
GET /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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": "1c4e25349f5a4506a469810d1e65ab7a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
"documentOf": "change"
},
{
"id": "94cc85afb51346ab95e007a303753924",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b559700bb5245049bdee88a6b887e04?Signature=V%2FKGkbsShKDpTJYKPSWbL3h72mRJO%2F6uOi8x6DX1AJxypK7%2FopQidX%2BYz%2BddFJG4BR1KqDCgwBsNe4Xz0kwgBA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"documentOf": "contract"
}
]
}
І знову можна перевірити, що є два завантажених документа.
Request
POST /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Content-Length: 344
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/bdd3fb01fd5543dcb7c49a037c335baf?Signature=yor3BJmbDFsR%2FF3sKWKVbFvIKRxGyk4%2Bq4%2FUYYLNax8qJSzr0JueHukHNruZ4dqs6ooC44CFb%2BIKZW86XsSjDQ%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/38da025ae53f4e0d8fa4474bb5923d12/documents/1b01c96d4c284ceebf9b115101b31fa0
{
"data": {
"id": "1b01c96d4c284ceebf9b115101b31fa0",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/bdd3fb01fd5543dcb7c49a037c335baf?Signature=UWVFw1k3kphG%2BaNjhh5PLf5%2B3QJiv%2FRICggmV01tLe47AT5l0xsRv%2Bn4pmBQNBQ%2BelTVOkDPRsg%2BjZlc4UQUBw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"documentOf": "contract"
}
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
Request
PUT /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents/1b01c96d4c284ceebf9b115101b31fa0?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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/3dc187c0d95d4d9aaf3954aed82eb6fe?Signature=0P7pQiY6OJUKRXb%2FZ8d6xfKTohAvlySDm8MPE3mWp7eMxSRXKIvLYlsNrQSOvKAyk0v%2BIhGmq8bWNtJmNupBBA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "1b01c96d4c284ceebf9b115101b31fa0",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3dc187c0d95d4d9aaf3954aed82eb6fe?Signature=hZosigHskiVw%2BVRXxgwRiq8GV8IEJk0s9GHzLWchLg4iuHpeBb2bUIvJRORVEc8CWfGyK9MN0r4fWsF2fnU1Dw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"documentOf": "contract"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
Request
GET /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents/1b01c96d4c284ceebf9b115101b31fa0?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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": "1b01c96d4c284ceebf9b115101b31fa0",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3dc187c0d95d4d9aaf3954aed82eb6fe?Signature=hZosigHskiVw%2BVRXxgwRiq8GV8IEJk0s9GHzLWchLg4iuHpeBb2bUIvJRORVEc8CWfGyK9MN0r4fWsF2fnU1Dw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"documentOf": "contract",
"previousVersions": [
{
"id": "1b01c96d4c284ceebf9b115101b31fa0",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/bdd3fb01fd5543dcb7c49a037c335baf?Signature=UWVFw1k3kphG%2BaNjhh5PLf5%2B3QJiv%2FRICggmV01tLe47AT5l0xsRv%2Bn4pmBQNBQ%2BelTVOkDPRsg%2BjZlc4UQUBw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"documentOf": "contract"
}
]
}
}
Завершення договору¶
Перед завершенням договору необхідно встановити значення поля amountPaid (незалежно від того успішний договір чи ні). Договір можна завершити переключенням у статус terminated. Виконаємо ці дії єдиним запитом:
Request
PATCH /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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": "ce59dcbd1325456cbd1d1632ef5cfb09",
"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": "27d065dad2f843fcaa08ce47d150ff58",
"description": "футляри до державних нагород",
"quantity": 2.0,
"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": "Україна"
},
"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"
}
},
{
"id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
"description": "футляри до державних нагород",
"quantity": 5.0,
"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": "Україна"
},
"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"
}
}
],
"tender_id": "59190c68cfa14b0595a6e1395c43a06b",
"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"
}
}
],
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"changes": [
{
"id": "9b42f245308547cc9d4f760dda1dc15c",
"status": "active",
"date": "2023-01-01T00:00:01+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00"
}
],
"documents": [
{
"id": "1c4e25349f5a4506a469810d1e65ab7a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
"documentOf": "change"
},
{
"id": "94cc85afb51346ab95e007a303753924",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b559700bb5245049bdee88a6b887e04?Signature=V%2FKGkbsShKDpTJYKPSWbL3h72mRJO%2F6uOi8x6DX1AJxypK7%2FopQidX%2BYz%2BddFJG4BR1KqDCgwBsNe4Xz0kwgBA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"documentOf": "contract"
},
{
"id": "1b01c96d4c284ceebf9b115101b31fa0",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/bdd3fb01fd5543dcb7c49a037c335baf?Signature=UWVFw1k3kphG%2BaNjhh5PLf5%2B3QJiv%2FRICggmV01tLe47AT5l0xsRv%2Bn4pmBQNBQ%2BelTVOkDPRsg%2BjZlc4UQUBw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"documentOf": "contract"
},
{
"id": "1b01c96d4c284ceebf9b115101b31fa0",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3dc187c0d95d4d9aaf3954aed82eb6fe?Signature=hZosigHskiVw%2BVRXxgwRiq8GV8IEJk0s9GHzLWchLg4iuHpeBb2bUIvJRORVEc8CWfGyK9MN0r4fWsF2fnU1Dw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"documentOf": "contract"
}
],
"amountPaid": {
"amount": 430.0,
"currency": "UAH",
"amountNet": 420.0,
"valueAddedTaxIncluded": true
},
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"id": "38da025ae53f4e0d8fa4474bb5923d12"
}
}
Зверніть увагу, що ви можете встановлювати/змінювати значення amountPaid.amount, amountPaid.amountNet, amountPaid.valueAddedTaxIncluded. А значення поля amountPaid.currency генеруються з поля Contract.value.
Якщо договір неуспішний, то потрібно вказати причини його припинення terminationDetails.
Після цього додання змін до договору не дозволяється.