Туторіал
Базові правила
Подивимось як працює точка входу /agreements:
GET /api/2.5/agreements HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
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) не можуть створити угоди в модулі угод.
Отримання угоди
Угода в модулі тендера
GET /api/2.5/tenders/932b9b683eab4ce4a7eb7f1ecfd2164f/agreements/b7536ab0fbe34a1dafa73fe7943ff79c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "b7536ab0fbe34a1dafa73fe7943ff79c",
"items": [
{
"id": "b0a774dcb2784648b6f81791b294a6be",
"description": "футляри до державних нагород",
"unit": {
"name": "item",
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"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-10-10-000001-a-e75ece1cddb64807825e058d729510f61",
"date": "2023-10-10T01:00:00+03: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-10-10T01:00:00+03: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-10-10T01:00:00+03: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-10-10T01:00:00+03:00",
"unitPrices": [
{
"relatedItem": "b0a774dcb2784648b6f81791b294a6be",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 93
}
}
],
"status": "active"
}
],
"status": "active"
}
}
Ідентифікатор угоди є тим самим і в модулі тендера, і в модулі угод.
Звернемося до URL-адреси створеного об’єкта в модулі угод:
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-10-10-000001-a-e75ece1cddb64807825e058d729510f61",
"status": "active",
"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-10-10T01:00:00+03: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-10-10T01:00:00+03: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-10-10T01:00:00+03: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",
"numberOfContracts": 3,
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "b7536ab0fbe34a1dafa73fe7943ff79c"
}
}
Отримання доступу
Для того, щоб отримати права для редагування угоди в майбутньому, вам потрібно виконати PATCH: /agreements/{id}/credentials?acc_token={tender_token}
з ключами майданчика до API, яким був згенерований тендер.
У PATCH: /agreements/{id}/credentials?acc_token={tender_token}
:
id
- ідентифікатор угоди,tender_token
- це токен тендера (використовується для генерації токена угоди).
Відповідь міститиме access.token
для угоди, який можна використовувати для майбутнього редагування угоди.
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
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-10-10-000001-a-e75ece1cddb64807825e058d729510f61",
"status": "active",
"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-10-10T01:00:00+03: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-10-10T01:00:00+03: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-10-10T01:00:00+03: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",
"numberOfContracts": 3,
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "b7536ab0fbe34a1dafa73fe7943ff79c"
},
"access": {
"token": "3abb3c33e785449ca322284f6ccfbeaf",
"transfer": "a2476a3ad1744b5eae26514a32d0e70a"
}
}
Подивимось на угоди.
GET /api/2.5/agreements HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "b7536ab0fbe34a1dafa73fe7943ff79c"
}
],
"next_page": {
"offset": 1696888800.0,
"path": "/api/2.5/agreements?offset=1696888800.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?offset=1696888800.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 до угоди:
POST /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/changes?acc_token=3abb3c33e785449ca322284f6ccfbeaf 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"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"status": "pending",
"rationale": "Опис причини змін егріменту",
"rationale_en": "Agreement change cause",
"date": "2023-10-10T01:00:00+03:00",
"rationaleType": "taxRate",
"id": "30eb3b69a8174931a5bc64636ea3e4b2"
}
}
Візьміть до уваги, потрібно заповнити обов’язкове поле rationaleType
.
Подивимось на change:
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/changes/30eb3b69a8174931a5bc64636ea3e4b2 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "pending",
"rationale": "Опис причини змін егріменту",
"rationale_en": "Agreement change cause",
"date": "2023-10-10T01:00:00+03:00",
"rationaleType": "taxRate",
"id": "30eb3b69a8174931a5bc64636ea3e4b2"
}
}
Change може бути модифікований, поки об’єкт в статусі pending
:
PATCH /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/changes/30eb3b69a8174931a5bc64636ea3e4b2?acc_token=3abb3c33e785449ca322284f6ccfbeaf HTTP/1.0
Authorization: Bearer broker
Content-Length: 255
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "30eb3b69a8174931a5bc64636ea3e4b2",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"rationaleType": "taxRate"
}
}
Завантаження документів до змін
Документ може бути доданий тільки тоді, коли change в статусі pending
.
Документи додаються в два етапи:
завантажте документ
POST /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents?acc_token=3abb3c33e785449ca322284f6ccfbeaf HTTP/1.0
Authorization: Bearer broker
Content-Length: 340
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "agreement_changes.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6c343bcdd7d241068f88138036b4e52a?Signature=vhFVJH%2BWXh8iggm9ieV4RAxb8cH6Bmf%2F%2BacGhtnigHlLyPezAg2WgaAnhdh211eXDo0T2q%2F22rai3BVdbVH7BQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/2379d9c9a78f43c4a3cb72c9100c8784
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6c343bcdd7d241068f88138036b4e52a?Signature=cU7WXirw65OUUhuS5lZDppSTLBBAEOZ6GMLIefKy1mqh5Qe9B9T8b%2B%2BfoucGKMRZRL2%2FSJeoZWpypUlbWdU5DA%3D%3D&KeyID=a8968c46",
"language": "uk",
"documentOf": "agreement",
"id": "2379d9c9a78f43c4a3cb72c9100c8784",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
налаштуйте властивості документу
"documentOf": "change"
і"relatedItem": "{change.id}"
для того, щоб підв’язати заватажений документ до об’єкту change:
PATCH /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/2379d9c9a78f43c4a3cb72c9100c8784?acc_token=3abb3c33e785449ca322284f6ccfbeaf HTTP/1.0
Authorization: Bearer broker
Content-Length: 85
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentOf": "change",
"relatedItem": "30eb3b69a8174931a5bc64636ea3e4b2"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"relatedItem": "30eb3b69a8174931a5bc64636ea3e4b2",
"id": "2379d9c9a78f43c4a3cb72c9100c8784",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6c343bcdd7d241068f88138036b4e52a?Signature=cU7WXirw65OUUhuS5lZDppSTLBBAEOZ6GMLIefKy1mqh5Qe9B9T8b%2B%2BfoucGKMRZRL2%2FSJeoZWpypUlbWdU5DA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk",
"documentOf": "change"
}
}
Оновлення властивостей угоди
Тепер можете оновити властивості угоди, які належать зміні.
PATCH /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/changes/30eb3b69a8174931a5bc64636ea3e4b2?acc_token=3abb3c33e785449ca322284f6ccfbeaf 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
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "30eb3b69a8174931a5bc64636ea3e4b2",
"status": "pending",
"date": "2023-10-10T01:00:00+03: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}
.
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/preview?acc_token=3abb3c33e785449ca322284f6ccfbeaf HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-10-10-000001-a-e75ece1cddb64807825e058d729510f61",
"status": "active",
"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": 14.93
}
}
],
"awardID": "f99be86681de4f368037738d6af12903",
"bidID": "78290ccc2a114830a97e8f2c510bacaf",
"date": "2023-10-10T01:00:00+03: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-10-10T01:00:00+03: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-10-10T01:00:00+03: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",
"numberOfContracts": 3,
"dateModified": "2023-10-10T01:00:00+03:00",
"changes": [
{
"id": "30eb3b69a8174931a5bc64636ea3e4b2",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
],
"documents": [
{
"relatedItem": "30eb3b69a8174931a5bc64636ea3e4b2",
"id": "2379d9c9a78f43c4a3cb72c9100c8784",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6c343bcdd7d241068f88138036b4e52a?Signature=cU7WXirw65OUUhuS5lZDppSTLBBAEOZ6GMLIefKy1mqh5Qe9B9T8b%2B%2BfoucGKMRZRL2%2FSJeoZWpypUlbWdU5DA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk",
"documentOf": "change"
}
],
"id": "b7536ab0fbe34a1dafa73fe7943ff79c"
}
}
Як бачимо, value.amount на unitPrices об’єкту contracts змінюється після прийняття змін. Тож, якщо ці зміни - це те, що вам потрібно, то ви можете подати об’єкт change.
Застосування зміни
Change може бути застосована після переходу в статус active
.
Для того, щоб застосувати статус active
, має бути налаштоване поле dateSigned.
Після цього change не можна більше модифікувати.
PATCH /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/changes/30eb3b69a8174931a5bc64636ea3e4b2?acc_token=3abb3c33e785449ca322284f6ccfbeaf 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-10-10T01:00:00+03:00"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "30eb3b69a8174931a5bc64636ea3e4b2",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2023-10-10T01:00:00+03:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
}
Валідація поля dateSigned:
для першої change в угоді, дата повинна бути після agreement.dateSigned;
для всіх наступних об’єктів change, дата повинна бути після попередньої change.dateSigned.
Подивимось на всі зміни:
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/changes HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "30eb3b69a8174931a5bc64636ea3e4b2",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2023-10-10T01:00:00+03:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
]
}
Всі зміни також перераховані у view угоди.
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-10-10-000001-a-e75ece1cddb64807825e058d729510f61",
"status": "active",
"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": 14.93
}
}
],
"awardID": "f99be86681de4f368037738d6af12903",
"bidID": "78290ccc2a114830a97e8f2c510bacaf",
"date": "2023-10-10T01:00:00+03: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-10-10T01:00:00+03: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-10-10T01:00:00+03: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",
"numberOfContracts": 3,
"dateModified": "2023-10-10T01:00:00+03:00",
"changes": [
{
"id": "30eb3b69a8174931a5bc64636ea3e4b2",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2023-10-10T01:00:00+03:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
],
"documents": [
{
"relatedItem": "30eb3b69a8174931a5bc64636ea3e4b2",
"id": "2379d9c9a78f43c4a3cb72c9100c8784",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6c343bcdd7d241068f88138036b4e52a?Signature=cU7WXirw65OUUhuS5lZDppSTLBBAEOZ6GMLIefKy1mqh5Qe9B9T8b%2B%2BfoucGKMRZRL2%2FSJeoZWpypUlbWdU5DA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk",
"documentOf": "change"
}
],
"id": "b7536ab0fbe34a1dafa73fe7943ff79c"
}
}
Завантаження документів
Замовник може завантажити PDF-файли в створену угоду. Завантаження повинне слідувати правилам завантаження.
POST /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents?acc_token=3abb3c33e785449ca322284f6ccfbeaf HTTP/1.0
Authorization: Bearer broker
Content-Length: 330
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "agreement.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/11eb2dec3c4941aaa20b9f9f3242da8a?Signature=v%2FqOQ3a%2F1XjZ5CNeWW9svvq7xZB97hdeUhbVCLijO8pQrmyesxDtxrSGFlx2zFRx%2FOGSobWlAboCFcODDivODQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/fbacaaf3d97b4c0cbf6b2c78aedec61b
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "agreement.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/11eb2dec3c4941aaa20b9f9f3242da8a?Signature=aSUaH4aKyvvHHNyDgX%2BUS92rE%2Fpy8aEUBTNaribYkkc5XyYX4awtgUD8TuwG0XeiLc87akD36sgPaPE32NZnCg%3D%3D&KeyID=a8968c46",
"language": "uk",
"documentOf": "agreement",
"id": "fbacaaf3d97b4c0cbf6b2c78aedec61b",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було додано. Додатково можна запитати точку входу API колекції documents для підтвердження дії:
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents?acc_token=3abb3c33e785449ca322284f6ccfbeaf HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"relatedItem": "30eb3b69a8174931a5bc64636ea3e4b2",
"id": "2379d9c9a78f43c4a3cb72c9100c8784",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6c343bcdd7d241068f88138036b4e52a?Signature=cU7WXirw65OUUhuS5lZDppSTLBBAEOZ6GMLIefKy1mqh5Qe9B9T8b%2B%2BfoucGKMRZRL2%2FSJeoZWpypUlbWdU5DA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk",
"documentOf": "change"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "agreement.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/11eb2dec3c4941aaa20b9f9f3242da8a?Signature=aSUaH4aKyvvHHNyDgX%2BUS92rE%2Fpy8aEUBTNaribYkkc5XyYX4awtgUD8TuwG0XeiLc87akD36sgPaPE32NZnCg%3D%3D&KeyID=a8968c46",
"language": "uk",
"documentOf": "agreement",
"id": "fbacaaf3d97b4c0cbf6b2c78aedec61b",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
І знову можна підтвердити, що два документи завантажені.
POST /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents?acc_token=3abb3c33e785449ca322284f6ccfbeaf HTTP/1.0
Authorization: Bearer broker
Content-Length: 346
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "agreement_additional_docs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a8c422f0d19e454891bd6c7bf538cb56?Signature=mgZfr05rkCOhapXVu43Ab%2FvwznTQy%2BHE9NpHorxn3kPP75z%2BXUxnBZ41TOBtDM7R0rfVQvQgffcNimBtiOFYCQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/47ab85c3f0b341b58583c157dd99c085
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a8c422f0d19e454891bd6c7bf538cb56?Signature=l7XDy0xp10QmGZTwdWpN%2F6T9NyfWuvV91%2BX3fhdtEcWlsj8IjuQ%2Fqj%2B7VWPN1RM8BWhUmb7jktjc6gXIHgRwBQ%3D%3D&KeyID=a8968c46",
"language": "uk",
"documentOf": "agreement",
"id": "47ab85c3f0b341b58583c157dd99c085",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
У випадку помилки, можна заново завантажити документ поверх старої версії:
PUT /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/47ab85c3f0b341b58583c157dd99c085?acc_token=3abb3c33e785449ca322284f6ccfbeaf HTTP/1.0
Authorization: Bearer broker
Content-Length: 346
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "agreement_additional_docs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d41141b923574f31b55bb728076744c5?Signature=gf5g0y6A72zdzKKXSO3rs%2Fi909in90TfVvF5zGhqniVYi9L2enwWu%2B4qmhLAmCI7SnEqXDH%2BlYSHxxcq7sj0BA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "47ab85c3f0b341b58583c157dd99c085",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d41141b923574f31b55bb728076744c5?Signature=mka6smLvqizbQTfO5zttaBl0L1iNsnfonJHjBmAaWOqflP%2FdQtzy6LFcx6uujeC5rElua6Cf1pLu5BfrQkWWCA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk",
"documentOf": "agreement"
}
}
І можна побачити, що цей документ переважає оригінальну версію:
GET /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c/documents/47ab85c3f0b341b58583c157dd99c085?acc_token=3abb3c33e785449ca322284f6ccfbeaf HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "47ab85c3f0b341b58583c157dd99c085",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d41141b923574f31b55bb728076744c5?Signature=mka6smLvqizbQTfO5zttaBl0L1iNsnfonJHjBmAaWOqflP%2FdQtzy6LFcx6uujeC5rElua6Cf1pLu5BfrQkWWCA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk",
"documentOf": "agreement",
"previousVersions": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a8c422f0d19e454891bd6c7bf538cb56?Signature=l7XDy0xp10QmGZTwdWpN%2F6T9NyfWuvV91%2BX3fhdtEcWlsj8IjuQ%2Fqj%2B7VWPN1RM8BWhUmb7jktjc6gXIHgRwBQ%3D%3D&KeyID=a8968c46",
"language": "uk",
"documentOf": "agreement",
"id": "47ab85c3f0b341b58583c157dd99c085",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
}
Завершення угоди
Угода може бути завершена переходом в статус terminated
. Давайте виконаємо ці дії одним запитом:
PATCH /api/2.5/agreements/b7536ab0fbe34a1dafa73fe7943ff79c?acc_token=3abb3c33e785449ca322284f6ccfbeaf HTTP/1.0
Authorization: Bearer broker
Content-Length: 34
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "terminated"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-10-10-000001-a-e75ece1cddb64807825e058d729510f61",
"status": "terminated",
"dateModified": "2023-10-10T01:00:00+03:00",
"owner": "broker",
"changes": [
{
"id": "30eb3b69a8174931a5bc64636ea3e4b2",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2023-10-10T01:00:00+03:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "b0a774dcb2784648b6f81791b294a6be",
"factor": 0.1605
}
]
}
],
"documents": [
{
"relatedItem": "30eb3b69a8174931a5bc64636ea3e4b2",
"id": "2379d9c9a78f43c4a3cb72c9100c8784",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6c343bcdd7d241068f88138036b4e52a?Signature=cU7WXirw65OUUhuS5lZDppSTLBBAEOZ6GMLIefKy1mqh5Qe9B9T8b%2B%2BfoucGKMRZRL2%2FSJeoZWpypUlbWdU5DA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk",
"documentOf": "change"
},
{
"id": "fbacaaf3d97b4c0cbf6b2c78aedec61b",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/11eb2dec3c4941aaa20b9f9f3242da8a?Signature=aSUaH4aKyvvHHNyDgX%2BUS92rE%2Fpy8aEUBTNaribYkkc5XyYX4awtgUD8TuwG0XeiLc87akD36sgPaPE32NZnCg%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk",
"documentOf": "agreement"
},
{
"id": "47ab85c3f0b341b58583c157dd99c085",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a8c422f0d19e454891bd6c7bf538cb56?Signature=l7XDy0xp10QmGZTwdWpN%2F6T9NyfWuvV91%2BX3fhdtEcWlsj8IjuQ%2Fqj%2B7VWPN1RM8BWhUmb7jktjc6gXIHgRwBQ%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk",
"documentOf": "agreement"
},
{
"id": "47ab85c3f0b341b58583c157dd99c085",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "agreement_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d41141b923574f31b55bb728076744c5?Signature=mka6smLvqizbQTfO5zttaBl0L1iNsnfonJHjBmAaWOqflP%2FdQtzy6LFcx6uujeC5rElua6Cf1pLu5BfrQkWWCA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk",
"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-10-10T01:00:00+03: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-10-10T01:00:00+03: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-10-10T01:00:00+03: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",
"numberOfContracts": 3,
"id": "b7536ab0fbe34a1dafa73fe7943ff79c"
}
}
Якщо угода неуспішна, причини припинення угоди повинні бути вказані в полі terminationDetails
.
Будь-які майбутні зміни в угоді не дозволяються.
Можливо, буде корисно побачити актуальні вимоги: Сценарії ручного тестування для III рівня акредитації і Сценарії ручного тестування для IV рівня акредитації.