Туторіал¶
Базові правила¶
Подивимось як працює точка входу /agreements:
Request
GET /api/2.5/agreements 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/agreements",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements"
}
}
При виклику видає пустий набір.
Угода автоматично переноситься з модуля тендера.
Створення угоди¶
Припустимо, що ми провели тендер, який зараз є в статусі complete. Після завершення тендера, угода, яка була створена в модулі тендера, переноситься у модуль угод автоматично.
Майданчики (eMalls) не можуть створити угоди в модулі угод.
Отримання угоди¶
Угода в модулі тендера
Request
GET /api/2.5/tenders/932b9b683eab4ce4a7eb7f1ecfd2164f/agreements/b7536ab0fbe34a1dafa73fe7943ff79c 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": "b7536ab0fbe34a1dafa73fe7943ff79c",
"items": [
{
"id": "b0a774dcb2784648b6f81791b294a6be",
"description": "футляри до державних нагород",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "item",
"code": "KGM"
},
"quantity": 5.0,
"relatedLot": "04651361e47848abb6eda21e59c8b4a1",
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Cases for state awards"
}
],
"agreementID": "UA-2023-01-01-000001-a-e75ece1cddb64807825e058d729510f61",
"date": "2023-01-01T00:00:00+02:00",
"contracts": [
{
"id": "3f790a2fc7c647a7be968a10e669e9fa",
"suppliers": [
{
"contactPoint": {
"name_en": "State administration",
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"legalName_en": "dus.gov.ua",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
},
"scale": "micro"
}
],
"awardID": "f99be86681de4f368037738d6af12903",
"bidID": "78290ccc2a114830a97e8f2c510bacaf",
"date": "2023-01-01T00:00:00+02:00",
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 93
}
}
],
"status": "active"
},
{
"id": "142288b4ac5447c088ae5c55bed1f9fc",
"suppliers": [
{
"contactPoint": {
"name_en": "State administration",
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"legalName_en": "dus.gov.ua",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
},
"scale": "micro"
}
],
"awardID": "e5e6c374e9db46c2bf634056b03768db",
"bidID": "be6885d5a2ec4336a11ed73370239ed6",
"date": "2023-01-01T00:00:00+02:00",
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 93
}
}
],
"status": "active"
},
{
"id": "bd325edc619c4f61b067e07529a08461",
"suppliers": [
{
"contactPoint": {
"name_en": "State administration",
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"legalName_en": "dus.gov.ua",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
},
"scale": "micro"
}
],
"awardID": "ea7c848eefbb4037a273456dd333ce1a",
"bidID": "593a5fc959d64463b40f460fe47f30cb",
"date": "2023-01-01T00:00:00+02:00",
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 93
}
}
],
"status": "active"
}
],
"status": "active"
}
}
Ідентифікатор угоди є тим самим і в модулі тендера, і в модулі угод.
Звернемося до URL-адреси створеного об’єкта в модулі угод:
Request
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-01-01-000001-a-e75ece1cddb64807825e058d729510f61",
"status": "active",
"dateModified": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"contracts": [
{
"id": "3f790a2fc7c647a7be968a10e669e9fa",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 93
}
}
],
"awardID": "f99be86681de4f368037738d6af12903",
"bidID": "78290ccc2a114830a97e8f2c510bacaf",
"date": "2023-01-01T00:00:00+02:00"
},
{
"id": "142288b4ac5447c088ae5c55bed1f9fc",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 93
}
}
],
"awardID": "e5e6c374e9db46c2bf634056b03768db",
"bidID": "be6885d5a2ec4336a11ed73370239ed6",
"date": "2023-01-01T00:00:00+02:00"
},
{
"id": "bd325edc619c4f61b067e07529a08461",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 93
}
}
],
"awardID": "ea7c848eefbb4037a273456dd333ce1a",
"bidID": "593a5fc959d64463b40f460fe47f30cb",
"date": "2023-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "b0a774dcb2784648b6f81791b294a6be",
"description": "футляри до державних нагород",
"quantity": 5.0,
"relatedLot": "04651361e47848abb6eda21e59c8b4a1",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"description_en": "Cases for state awards",
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"procuringEntity": {
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"availableLanguage": "uk"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"tender_id": "932b9b683eab4ce4a7eb7f1ecfd2164f",
"id": "b7536ab0fbe34a1dafa73fe7943ff79c",
"numberOfContracts": 3
}
}
Отримання доступу¶
Для того, щоб отримати права для редагування угоди в майбутньому, вам потрібно виконати PATCH: /agreements/{id}/credentials?acc_token={tender_token} з ключами майданчика до API, яким був згенерований тендер.
У PATCH: /agreements/{id}/credentials?acc_token={tender_token}:
id- ідентифікатор угоди,tender_token- це токен тендера (використовується для генерації токена угоди).
Відповідь міститиме access.token для угоди, який можна використовувати для майбутнього редагування угоди.
Request
PATCH /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/credentials?acc_token=a18638e282aa4cea9dc55539facd8107 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": {
"agreementID": "UA-2023-01-01-000001-a-e75ece1cddb64807825e058d729510f61",
"status": "active",
"dateModified": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"contracts": [
{
"id": "3f790a2fc7c647a7be968a10e669e9fa",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 93
}
}
],
"awardID": "f99be86681de4f368037738d6af12903",
"bidID": "78290ccc2a114830a97e8f2c510bacaf",
"date": "2023-01-01T00:00:00+02:00"
},
{
"id": "142288b4ac5447c088ae5c55bed1f9fc",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 93
}
}
],
"awardID": "e5e6c374e9db46c2bf634056b03768db",
"bidID": "be6885d5a2ec4336a11ed73370239ed6",
"date": "2023-01-01T00:00:00+02:00"
},
{
"id": "bd325edc619c4f61b067e07529a08461",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 93
}
}
],
"awardID": "ea7c848eefbb4037a273456dd333ce1a",
"bidID": "593a5fc959d64463b40f460fe47f30cb",
"date": "2023-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "b0a774dcb2784648b6f81791b294a6be",
"description": "футляри до державних нагород",
"quantity": 5.0,
"relatedLot": "04651361e47848abb6eda21e59c8b4a1",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"description_en": "Cases for state awards",
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"procuringEntity": {
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"availableLanguage": "uk"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"tender_id": "932b9b683eab4ce4a7eb7f1ecfd2164f",
"id": "b7536ab0fbe34a1dafa73fe7943ff79c",
"numberOfContracts": 3
},
"access": {
"token": "2308192c93e846339ff07b8a89dfaff0",
"transfer": "24101c50b89b4134b582064b653471c2"
}
}
Подивимось на угоди.
Request
GET /api/2.5/agreements 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:00+02:00",
"id": "b7536ab0fbe34a1dafa73fe7943ff79c"
}
],
"next_page": {
"offset": 1672524000.0,
"path": "/api/2.5/agreements?offset=1672524000.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?offset=1672524000.0"
}
}
Бачимо внутрішні id угоди, який може бути використаний для побудови повної URL-адреси за допомогою додавання http://api-sandbox.openprocurement.org/api/0/agreements/, а також дату dateModified.
Редагування угоди¶
Основні умови договору можуть бути модифіковані поданням нових об’єктів change у контейнер Agreement.changes. Change може бути таких типів: ChangeTaxRate in cfaua, ChangeItemPriceVariation in cfaua, ChangePartyWithdrawal in cfaua або ChangeThirdParty in cfaua
Усі об’єкти changes обробляються точкою входу /agreement/{id}/changes.
Подання зміни¶
Додамо новий change до угоди:
Request
POST /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/changes?acc_token=2308192c93e846339ff07b8a89dfaff0 HTTP/1.0
Authorization: Bearer broker
Content-Length: 244
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "Опис причини змін егріменту",
"rationale_en": "Agreement change cause",
"rationaleType": "taxRate"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"id": "021c093dc15d4e078ce3061ae63cd514",
"status": "pending",
"date": "2023-01-01T00:00:00+02:00",
"rationale": "Опис причини змін егріменту",
"rationale_en": "Agreement change cause",
"rationaleType": "taxRate"
}
}
Візьміть до уваги, потрібно заповнити обов’язкове поле rationaleType.
Подивимось на change:
Request
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/changes/021c093dc15d4e078ce3061ae63cd514 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": "021c093dc15d4e078ce3061ae63cd514",
"status": "pending",
"date": "2023-01-01T00:00:00+02:00",
"rationale": "Опис причини змін егріменту",
"rationale_en": "Agreement change cause",
"rationaleType": "taxRate"
}
}
Change може бути модифікований, поки об’єкт в статусі pending:
Request
PATCH /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/changes/021c093dc15d4e078ce3061ae63cd514?acc_token=2308192c93e846339ff07b8a89dfaff0 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": "021c093dc15d4e078ce3061ae63cd514",
"status": "pending",
"date": "2023-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"rationaleType": "taxRate"
}
}
Завантаження документів до змін¶
Документ може бути доданий тільки тоді, коли change в статусі pending.
Документи додаються в два етапи:
- завантажте документ
Request
POST /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents?acc_token=2308192c93e846339ff07b8a89dfaff0 HTTP/1.0
Authorization: Bearer broker
Content-Length: 156
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="agreement_changes.doc"
Content-Type: application/msword
content
-----BOUNDARY--
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/dc3a00e2a21e45259890216f6c0e543b
{
"data": {
"id": "dc3a00e2a21e45259890216f6c0e543b",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d11ca4c1fd0b4a2f80bd5e74a6da52d2?Signature=kWWQwE4OnCp4g4ZgykRjc4TcDN87gzj7Uo6bqsdHa64HQJ9h%2FxubjfysczaJV9zLLsSE3u81A8ODWWhM3jNXAQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"documentOf": "agreement"
}
}
- налаштуйте властивості документу
"documentOf": "change"і"relatedItem": "{change.id}"для того, щоб підв’язати заватажений документ до об’єкту change:
Request
PATCH /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/dc3a00e2a21e45259890216f6c0e543b?acc_token=2308192c93e846339ff07b8a89dfaff0 HTTP/1.0
Authorization: Bearer broker
Content-Length: 85
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentOf": "change",
"relatedItem": "021c093dc15d4e078ce3061ae63cd514"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "dc3a00e2a21e45259890216f6c0e543b",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d11ca4c1fd0b4a2f80bd5e74a6da52d2?Signature=kWWQwE4OnCp4g4ZgykRjc4TcDN87gzj7Uo6bqsdHa64HQJ9h%2FxubjfysczaJV9zLLsSE3u81A8ODWWhM3jNXAQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"relatedItem": "021c093dc15d4e078ce3061ae63cd514",
"documentOf": "change"
}
}
Оновлення властивостей угоди¶
Тепер можете оновити властивості угоди, які належать зміні.
Request
PATCH /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/changes/021c093dc15d4e078ce3061ae63cd514?acc_token=2308192c93e846339ff07b8a89dfaff0 HTTP/1.0
Authorization: Bearer broker
Content-Length: 95
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "021c093dc15d4e078ce3061ae63cd514",
"status": "pending",
"date": "2023-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
}
Є можливість змінювати кожен factor в modifications у випадку декількох Item.
Попередній перегляд угоди¶
Також, поки change в статусі pending, можна бачити угоду, оскільки зміни будуть застосовані. Необхідно використати GET: /agreements/{id}/preview?acc_token={agreement_token}.
Request
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/preview?acc_token=2308192c93e846339ff07b8a89dfaff0 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-01-01-000001-a-e75ece1cddb64807825e058d729510f61",
"status": "active",
"dateModified": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"changes": [
{
"id": "021c093dc15d4e078ce3061ae63cd514",
"status": "pending",
"date": "2023-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
],
"documents": [
{
"id": "dc3a00e2a21e45259890216f6c0e543b",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d11ca4c1fd0b4a2f80bd5e74a6da52d2?Signature=kWWQwE4OnCp4g4ZgykRjc4TcDN87gzj7Uo6bqsdHa64HQJ9h%2FxubjfysczaJV9zLLsSE3u81A8ODWWhM3jNXAQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"relatedItem": "021c093dc15d4e078ce3061ae63cd514",
"documentOf": "change"
}
],
"contracts": [
{
"id": "3f790a2fc7c647a7be968a10e669e9fa",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 14.93
}
}
],
"awardID": "f99be86681de4f368037738d6af12903",
"bidID": "78290ccc2a114830a97e8f2c510bacaf",
"date": "2023-01-01T00:00:00+02:00"
},
{
"id": "142288b4ac5447c088ae5c55bed1f9fc",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 14.93
}
}
],
"awardID": "e5e6c374e9db46c2bf634056b03768db",
"bidID": "be6885d5a2ec4336a11ed73370239ed6",
"date": "2023-01-01T00:00:00+02:00"
},
{
"id": "bd325edc619c4f61b067e07529a08461",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 14.93
}
}
],
"awardID": "ea7c848eefbb4037a273456dd333ce1a",
"bidID": "593a5fc959d64463b40f460fe47f30cb",
"date": "2023-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "b0a774dcb2784648b6f81791b294a6be",
"description": "футляри до державних нагород",
"quantity": 5.0,
"relatedLot": "04651361e47848abb6eda21e59c8b4a1",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"description_en": "Cases for state awards",
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"procuringEntity": {
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"availableLanguage": "uk"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"tender_id": "932b9b683eab4ce4a7eb7f1ecfd2164f",
"id": "b7536ab0fbe34a1dafa73fe7943ff79c",
"numberOfContracts": 3
}
}
Як бачимо, value.amount на unitPrices об’єкту contracts змінюється після прийняття змін. Тож, якщо ці зміни - це те, що вам потрібно, то ви можете подати об’єкт change.
Застосування зміни¶
Change може бути застосована після переходу в статус active.
Для того, щоб застосувати статус active, має бути налаштоване поле dateSigned.
Після цього change не можна більше модифікувати.
Request
PATCH /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/changes/021c093dc15d4e078ce3061ae63cd514?acc_token=2308192c93e846339ff07b8a89dfaff0 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:00+02:00"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "021c093dc15d4e078ce3061ae63cd514",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2023-01-01T00:00:00+02:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
}
Валідація поля dateSigned:
- для першої change в угоді, дата повинна бути після agreement.dateSigned;
- для всіх наступних об’єктів change, дата повинна бути після попередньої change.dateSigned.
Подивимось на всі зміни:
Request
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/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": "021c093dc15d4e078ce3061ae63cd514",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2023-01-01T00:00:00+02:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
]
}
Всі зміни також перераховані у view угоди.
Request
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-01-01-000001-a-e75ece1cddb64807825e058d729510f61",
"status": "active",
"dateModified": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"changes": [
{
"id": "021c093dc15d4e078ce3061ae63cd514",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2023-01-01T00:00:00+02:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
],
"documents": [
{
"id": "dc3a00e2a21e45259890216f6c0e543b",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d11ca4c1fd0b4a2f80bd5e74a6da52d2?Signature=kWWQwE4OnCp4g4ZgykRjc4TcDN87gzj7Uo6bqsdHa64HQJ9h%2FxubjfysczaJV9zLLsSE3u81A8ODWWhM3jNXAQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"relatedItem": "021c093dc15d4e078ce3061ae63cd514",
"documentOf": "change"
}
],
"contracts": [
{
"id": "3f790a2fc7c647a7be968a10e669e9fa",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 14.93
}
}
],
"awardID": "f99be86681de4f368037738d6af12903",
"bidID": "78290ccc2a114830a97e8f2c510bacaf",
"date": "2023-01-01T00:00:00+02:00"
},
{
"id": "142288b4ac5447c088ae5c55bed1f9fc",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 14.93
}
}
],
"awardID": "e5e6c374e9db46c2bf634056b03768db",
"bidID": "be6885d5a2ec4336a11ed73370239ed6",
"date": "2023-01-01T00:00:00+02:00"
},
{
"id": "bd325edc619c4f61b067e07529a08461",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 14.93
}
}
],
"awardID": "ea7c848eefbb4037a273456dd333ce1a",
"bidID": "593a5fc959d64463b40f460fe47f30cb",
"date": "2023-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "b0a774dcb2784648b6f81791b294a6be",
"description": "футляри до державних нагород",
"quantity": 5.0,
"relatedLot": "04651361e47848abb6eda21e59c8b4a1",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"description_en": "Cases for state awards",
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"procuringEntity": {
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"availableLanguage": "uk"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"tender_id": "932b9b683eab4ce4a7eb7f1ecfd2164f",
"id": "b7536ab0fbe34a1dafa73fe7943ff79c",
"numberOfContracts": 3
}
}
Завантаження документів¶
Замовник може завантажити PDF-файли в створену угоду. Завантаження повинне слідувати правилам завантаження.
Request
POST /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents?acc_token=2308192c93e846339ff07b8a89dfaff0 HTTP/1.0
Authorization: Bearer broker
Content-Length: 148
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="agreement.doc"
Content-Type: application/msword
content
-----BOUNDARY--
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/72fdf9de6e2f4261afd2e1f0b78b5d9c
{
"data": {
"id": "72fdf9de6e2f4261afd2e1f0b78b5d9c",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/86c9d65b81ed4b6ca7b236b3cb537550?Signature=JWrmVhZvxw4C8JVy1%2B7j1azTXTvCtOM1bcT5YSq%2B5NPMuFGtPd5CxSw0P5YitMZBzGChzjsXIrcMYoMWXtbdDA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"documentOf": "agreement"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було додано. Додатково можна запитати точку входу API колекції documents для підтвердження дії:
Request
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents?acc_token=2308192c93e846339ff07b8a89dfaff0 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": "dc3a00e2a21e45259890216f6c0e543b",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d11ca4c1fd0b4a2f80bd5e74a6da52d2?Signature=kWWQwE4OnCp4g4ZgykRjc4TcDN87gzj7Uo6bqsdHa64HQJ9h%2FxubjfysczaJV9zLLsSE3u81A8ODWWhM3jNXAQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"relatedItem": "021c093dc15d4e078ce3061ae63cd514",
"documentOf": "change"
},
{
"id": "72fdf9de6e2f4261afd2e1f0b78b5d9c",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/86c9d65b81ed4b6ca7b236b3cb537550?Signature=JWrmVhZvxw4C8JVy1%2B7j1azTXTvCtOM1bcT5YSq%2B5NPMuFGtPd5CxSw0P5YitMZBzGChzjsXIrcMYoMWXtbdDA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"documentOf": "agreement"
}
]
}
І знову можна підтвердити, що два документи завантажені.
Request
POST /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents?acc_token=2308192c93e846339ff07b8a89dfaff0 HTTP/1.0
Authorization: Bearer broker
Content-Length: 172
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="agreement_additional_docs.doc"
Content-Type: application/msword
additional info
-----BOUNDARY--
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/4c6d354091cf435481454317dda2fc0a
{
"data": {
"id": "4c6d354091cf435481454317dda2fc0a",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc56c7bb082c42979e8fe585c03d410e?Signature=L2Ct5WuDd85sICUquUmNWyBdcMPf67kl6nG54jwKsbl8O9ngdFIAXRf%2BSh%2BeGEvPszUpJtegfQjMFHYGRzfpDg%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"documentOf": "agreement"
}
}
У випадку помилки, можна заново завантажити документ поверх старої версії:
Request
PUT /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/4c6d354091cf435481454317dda2fc0a?acc_token=2308192c93e846339ff07b8a89dfaff0 HTTP/1.0
Authorization: Bearer broker
Content-Length: 181
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="agreement_additional_docs.doc"
Content-Type: application/msword
extended additional info
-----BOUNDARY--
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "4c6d354091cf435481454317dda2fc0a",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e943e058f9794023b764221262b0c800?Signature=MNY2cH0xKYk8cB8J3R9HNGYYUvJ0Isp8sy%2FSIAj979JHrCym64o20EnerxZyiVI36hzEuQbRlFquGsyNOePhDA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"documentOf": "agreement"
}
}
І можна побачити, що цей документ переважає оригінальну версію:
Request
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/4c6d354091cf435481454317dda2fc0a?acc_token=2308192c93e846339ff07b8a89dfaff0 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": "4c6d354091cf435481454317dda2fc0a",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e943e058f9794023b764221262b0c800?Signature=MNY2cH0xKYk8cB8J3R9HNGYYUvJ0Isp8sy%2FSIAj979JHrCym64o20EnerxZyiVI36hzEuQbRlFquGsyNOePhDA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"documentOf": "agreement",
"previousVersions": [
{
"id": "4c6d354091cf435481454317dda2fc0a",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc56c7bb082c42979e8fe585c03d410e?Signature=L2Ct5WuDd85sICUquUmNWyBdcMPf67kl6nG54jwKsbl8O9ngdFIAXRf%2BSh%2BeGEvPszUpJtegfQjMFHYGRzfpDg%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"documentOf": "agreement"
}
]
}
}
Завершення угоди¶
Угода може бути завершена переходом в статус terminated. Давайте виконаємо ці дії одним запитом:
Request
PATCH /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c?acc_token=2308192c93e846339ff07b8a89dfaff0 HTTP/1.0
Authorization: Bearer broker
Content-Length: 34
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "terminated"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-01-01-000001-a-e75ece1cddb64807825e058d729510f61",
"status": "terminated",
"dateModified": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"changes": [
{
"id": "021c093dc15d4e078ce3061ae63cd514",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2023-01-01T00:00:00+02:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
],
"documents": [
{
"id": "dc3a00e2a21e45259890216f6c0e543b",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d11ca4c1fd0b4a2f80bd5e74a6da52d2?Signature=kWWQwE4OnCp4g4ZgykRjc4TcDN87gzj7Uo6bqsdHa64HQJ9h%2FxubjfysczaJV9zLLsSE3u81A8ODWWhM3jNXAQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"relatedItem": "021c093dc15d4e078ce3061ae63cd514",
"documentOf": "change"
},
{
"id": "72fdf9de6e2f4261afd2e1f0b78b5d9c",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/86c9d65b81ed4b6ca7b236b3cb537550?Signature=JWrmVhZvxw4C8JVy1%2B7j1azTXTvCtOM1bcT5YSq%2B5NPMuFGtPd5CxSw0P5YitMZBzGChzjsXIrcMYoMWXtbdDA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"documentOf": "agreement"
},
{
"id": "4c6d354091cf435481454317dda2fc0a",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc56c7bb082c42979e8fe585c03d410e?Signature=L2Ct5WuDd85sICUquUmNWyBdcMPf67kl6nG54jwKsbl8O9ngdFIAXRf%2BSh%2BeGEvPszUpJtegfQjMFHYGRzfpDg%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"documentOf": "agreement"
},
{
"id": "4c6d354091cf435481454317dda2fc0a",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e943e058f9794023b764221262b0c800?Signature=MNY2cH0xKYk8cB8J3R9HNGYYUvJ0Isp8sy%2FSIAj979JHrCym64o20EnerxZyiVI36hzEuQbRlFquGsyNOePhDA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"documentOf": "agreement"
}
],
"contracts": [
{
"id": "3f790a2fc7c647a7be968a10e669e9fa",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 14.93
}
}
],
"awardID": "f99be86681de4f368037738d6af12903",
"bidID": "78290ccc2a114830a97e8f2c510bacaf",
"date": "2023-01-01T00:00:00+02:00"
},
{
"id": "142288b4ac5447c088ae5c55bed1f9fc",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 14.93
}
}
],
"awardID": "e5e6c374e9db46c2bf634056b03768db",
"bidID": "be6885d5a2ec4336a11ed73370239ed6",
"date": "2023-01-01T00:00:00+02:00"
},
{
"id": "bd325edc619c4f61b067e07529a08461",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 14.93
}
}
],
"awardID": "ea7c848eefbb4037a273456dd333ce1a",
"bidID": "593a5fc959d64463b40f460fe47f30cb",
"date": "2023-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "b0a774dcb2784648b6f81791b294a6be",
"description": "футляри до державних нагород",
"quantity": 5.0,
"relatedLot": "04651361e47848abb6eda21e59c8b4a1",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"description_en": "Cases for state awards",
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"procuringEntity": {
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"availableLanguage": "uk"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"tender_id": "932b9b683eab4ce4a7eb7f1ecfd2164f",
"id": "b7536ab0fbe34a1dafa73fe7943ff79c",
"numberOfContracts": 3
}
}
Якщо угода неуспішна, причини припинення угоди повинні бути вказані в полі terminationDetails.
Будь-які майбутні зміни в угоді не дозволяються.
Можливо, буде корисно побачити актуальні вимоги: Сценарії ручного тестування для III рівня акредитації і Сценарії ручного тестування для IV рівня акредитації.