Туторіал
Базові правила
Подивимось як працює точка входу /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/abbc9a0c6f034659b3b28397ceceaac1/agreements/8887db77f71c4a0496b39ac2c4eea78c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "8887db77f71c4a0496b39ac2c4eea78c",
"items": [
{
"id": "ce7ee9fee64b4eaa87dd010843796c9a",
"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": "41d9357c4d24494186fe2da6c7e8ad7d",
"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-2027-01-01-000001-a-ea4a5ba075dd404db964b580ae32918c1",
"date": "2027-01-01T00:00:00+02:00",
"contracts": [
{
"id": "633a51fd12d44a77ab03e65ccd808aa7",
"suppliers": [
{
"contactPoint": {
"name_en": "State administration",
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"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": "011e63208de240c896e459f6bcb39725",
"bidID": "2b11d016d9234ec2b719df7659304750",
"date": "2027-01-01T00:00:00+02:00",
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 93
}
}
],
"status": "active"
},
{
"id": "b0403401034942fe9e4317ee69e69f8d",
"suppliers": [
{
"contactPoint": {
"name_en": "State administration",
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"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": "1e4ce39ccc9d44f694f3311d124f43d9",
"bidID": "668d4247367842bc867d5e415519e115",
"date": "2027-01-01T00:00:00+02:00",
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 93
}
}
],
"status": "active"
},
{
"id": "ff0b7237e5e74871a348807ea6591bb6",
"suppliers": [
{
"contactPoint": {
"name_en": "State administration",
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"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": "0f7d7962750e47f3bc7deadc3e1e4071",
"bidID": "5205692aa028408abb67b23cdb8ecab6",
"date": "2027-01-01T00:00:00+02:00",
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 93
}
}
],
"status": "active"
}
],
"status": "active",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "signingTheContract",
"type": "delivery",
"code": "standard",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 2
}
]
}
}
Ідентифікатор угоди є тим самим і в модулі тендера, і в модулі угод.
Звернемося до URL-адреси створеного об’єкта в модулі угод:
GET /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2027-01-01-000001-a-ea4a5ba075dd404db964b580ae32918c1",
"status": "active",
"owner": "broker",
"agreementType": "closeFrameworkAgreementUA",
"contracts": [
{
"id": "633a51fd12d44a77ab03e65ccd808aa7",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 93
}
}
],
"awardID": "011e63208de240c896e459f6bcb39725",
"bidID": "2b11d016d9234ec2b719df7659304750",
"date": "2027-01-01T00:00:00+02:00"
},
{
"id": "b0403401034942fe9e4317ee69e69f8d",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 93
}
}
],
"awardID": "1e4ce39ccc9d44f694f3311d124f43d9",
"bidID": "668d4247367842bc867d5e415519e115",
"date": "2027-01-01T00:00:00+02:00"
},
{
"id": "ff0b7237e5e74871a348807ea6591bb6",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 93
}
}
],
"awardID": "0f7d7962750e47f3bc7deadc3e1e4071",
"bidID": "5205692aa028408abb67b23cdb8ecab6",
"date": "2027-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "ce7ee9fee64b4eaa87dd010843796c9a",
"description": "футляри до державних нагород",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"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"
},
"description_en": "Cases for state awards",
"relatedLot": "41d9357c4d24494186fe2da6c7e8ad7d"
}
],
"procuringEntity": {
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"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": "abbc9a0c6f034659b3b28397ceceaac1",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "signingTheContract",
"type": "delivery",
"code": "standard",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"numberOfContracts": 3,
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "8887db77f71c4a0496b39ac2c4eea78c"
},
"config": {
"restricted": false
}
}
Отримання доступу
Для того, щоб отримати права для редагування угоди в майбутньому, вам потрібно виконати 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/8887db77f71c4a0496b39ac2c4eea78c/credentials?acc_token=b76d0e5d00ec4313b7be7fc5341f6e1c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2027-01-01-000001-a-ea4a5ba075dd404db964b580ae32918c1",
"status": "active",
"owner": "broker",
"agreementType": "closeFrameworkAgreementUA",
"contracts": [
{
"id": "633a51fd12d44a77ab03e65ccd808aa7",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 93
}
}
],
"awardID": "011e63208de240c896e459f6bcb39725",
"bidID": "2b11d016d9234ec2b719df7659304750",
"date": "2027-01-01T00:00:00+02:00"
},
{
"id": "b0403401034942fe9e4317ee69e69f8d",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 93
}
}
],
"awardID": "1e4ce39ccc9d44f694f3311d124f43d9",
"bidID": "668d4247367842bc867d5e415519e115",
"date": "2027-01-01T00:00:00+02:00"
},
{
"id": "ff0b7237e5e74871a348807ea6591bb6",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 93
}
}
],
"awardID": "0f7d7962750e47f3bc7deadc3e1e4071",
"bidID": "5205692aa028408abb67b23cdb8ecab6",
"date": "2027-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "ce7ee9fee64b4eaa87dd010843796c9a",
"description": "футляри до державних нагород",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"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"
},
"description_en": "Cases for state awards",
"relatedLot": "41d9357c4d24494186fe2da6c7e8ad7d"
}
],
"procuringEntity": {
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"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": "abbc9a0c6f034659b3b28397ceceaac1",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "signingTheContract",
"type": "delivery",
"code": "standard",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"numberOfContracts": 3,
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "8887db77f71c4a0496b39ac2c4eea78c"
},
"access": {
"token": "9870067ea6e64d14adf4016d24d15f0c",
"transfer": "b0a78824908548d7abce4666df53829d"
}
}
Подивимось на угоди.
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": "2027-01-01T00:00:00+02:00",
"id": "8887db77f71c4a0496b39ac2c4eea78c"
}
],
"next_page": {
"offset": "1798754400.0.1.aaab20edd6bc6c99278f3591e7bacf53",
"path": "/api/2.5/agreements?offset=1798754400.0.1.aaab20edd6bc6c99278f3591e7bacf53",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?offset=1798754400.0.1.aaab20edd6bc6c99278f3591e7bacf53"
}
}
Бачимо внутрішні 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/8887db77f71c4a0496b39ac2c4eea78c/changes?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
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": "2027-01-01T00:00:00+02:00",
"rationaleType": "taxRate",
"id": "763394fc5c714348b33cea25674f6916"
}
}
Візьміть до уваги, потрібно заповнити обов’язкове поле rationaleType.
Подивимось на change:
GET /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/changes/763394fc5c714348b33cea25674f6916 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": "2027-01-01T00:00:00+02:00",
"rationaleType": "taxRate",
"id": "763394fc5c714348b33cea25674f6916"
}
}
Change може бути модифікований, поки об’єкт в статусі pending:
PATCH /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/changes/763394fc5c714348b33cea25674f6916?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "763394fc5c714348b33cea25674f6916",
"status": "pending",
"date": "2027-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"rationaleType": "taxRate"
}
}
Завантаження документів до змін
Документ може бути доданий тільки тоді, коли change в статусі pending.
Документи додаються в два етапи:
завантажте документ
POST /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/documents?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
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/8887db77f71c4a0496b39ac2c4eea78c/documents/2dca769710034e8cb17e18c4431a6261
{
"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": "2dca769710034e8cb17e18c4431a6261",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
}
налаштуйте властивості документу
"documentOf": "change"і"relatedItem": "{change.id}"для того, щоб підв’язати заватажений документ до об’єкту change:
PATCH /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/documents/2dca769710034e8cb17e18c4431a6261?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentOf": "change",
"relatedItem": "763394fc5c714348b33cea25674f6916"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"relatedItem": "763394fc5c714348b33cea25674f6916",
"id": "2dca769710034e8cb17e18c4431a6261",
"datePublished": "2027-01-01T00:00:00+02: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": "2027-01-01T00:00:00+02:00",
"language": "uk",
"documentOf": "change"
}
}
Оновлення властивостей угоди
Тепер можете оновити властивості угоди, які належать зміні.
PATCH /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/changes/763394fc5c714348b33cea25674f6916?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"modifications": [
{
"itemId": "ce7ee9fee64b4eaa87dd010843796c9a",
"factor": 0.1605
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "763394fc5c714348b33cea25674f6916",
"status": "pending",
"date": "2027-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "ce7ee9fee64b4eaa87dd010843796c9a",
"factor": 0.1605
}
]
}
}
Є можливість змінювати кожен factor в modifications у випадку декількох Item.
Попередній перегляд угоди
Також, поки change в статусі pending, можна бачити угоду, оскільки зміни будуть застосовані. Необхідно використати GET: /agreements/{id}/preview?acc_token={agreement_token}.
GET /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/preview?acc_token=9870067ea6e64d14adf4016d24d15f0c 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-2027-01-01-000001-a-ea4a5ba075dd404db964b580ae32918c1",
"status": "active",
"owner": "broker",
"agreementType": "closeFrameworkAgreementUA",
"contracts": [
{
"id": "633a51fd12d44a77ab03e65ccd808aa7",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 14.93
}
}
],
"awardID": "011e63208de240c896e459f6bcb39725",
"bidID": "2b11d016d9234ec2b719df7659304750",
"date": "2027-01-01T00:00:00+02:00"
},
{
"id": "b0403401034942fe9e4317ee69e69f8d",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 14.93
}
}
],
"awardID": "1e4ce39ccc9d44f694f3311d124f43d9",
"bidID": "668d4247367842bc867d5e415519e115",
"date": "2027-01-01T00:00:00+02:00"
},
{
"id": "ff0b7237e5e74871a348807ea6591bb6",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 14.93
}
}
],
"awardID": "0f7d7962750e47f3bc7deadc3e1e4071",
"bidID": "5205692aa028408abb67b23cdb8ecab6",
"date": "2027-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "ce7ee9fee64b4eaa87dd010843796c9a",
"description": "футляри до державних нагород",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"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"
},
"description_en": "Cases for state awards",
"relatedLot": "41d9357c4d24494186fe2da6c7e8ad7d"
}
],
"procuringEntity": {
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"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": "abbc9a0c6f034659b3b28397ceceaac1",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "signingTheContract",
"type": "delivery",
"code": "standard",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"numberOfContracts": 3,
"dateModified": "2027-01-01T00:00:00+02:00",
"changes": [
{
"id": "763394fc5c714348b33cea25674f6916",
"status": "pending",
"date": "2027-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "ce7ee9fee64b4eaa87dd010843796c9a",
"factor": 0.1605
}
]
}
],
"documents": [
{
"relatedItem": "763394fc5c714348b33cea25674f6916",
"id": "2dca769710034e8cb17e18c4431a6261",
"datePublished": "2027-01-01T00:00:00+02: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": "2027-01-01T00:00:00+02:00",
"language": "uk",
"documentOf": "change"
}
],
"id": "8887db77f71c4a0496b39ac2c4eea78c"
}
}
Як бачимо, value.amount на unitPrices об’єкту contracts змінюється після прийняття змін. Тож, якщо ці зміни - це те, що вам потрібно, то ви можете подати об’єкт change.
Застосування зміни
Change може бути застосована після переходу в статус active.
Для того, щоб застосувати статус active, має бути налаштоване поле dateSigned.
Після цього change не можна більше модифікувати.
PATCH /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/changes/763394fc5c714348b33cea25674f6916?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"dateSigned": "2027-01-01T00:00:00+02:00"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "763394fc5c714348b33cea25674f6916",
"status": "active",
"date": "2027-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2027-01-01T00:00:00+02:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "ce7ee9fee64b4eaa87dd010843796c9a",
"factor": 0.1605
}
]
}
}
Валідація поля dateSigned:
для першої change в угоді, дата повинна бути після agreement.dateSigned;
для всіх наступних об’єктів change, дата повинна бути після попередньої change.dateSigned.
Подивимось на всі зміни:
GET /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/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": "763394fc5c714348b33cea25674f6916",
"status": "active",
"date": "2027-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2027-01-01T00:00:00+02:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "ce7ee9fee64b4eaa87dd010843796c9a",
"factor": 0.1605
}
]
}
]
}
Всі зміни також перераховані у view угоди.
GET /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c 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-2027-01-01-000001-a-ea4a5ba075dd404db964b580ae32918c1",
"status": "active",
"owner": "broker",
"agreementType": "closeFrameworkAgreementUA",
"contracts": [
{
"id": "633a51fd12d44a77ab03e65ccd808aa7",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 14.93
}
}
],
"awardID": "011e63208de240c896e459f6bcb39725",
"bidID": "2b11d016d9234ec2b719df7659304750",
"date": "2027-01-01T00:00:00+02:00"
},
{
"id": "b0403401034942fe9e4317ee69e69f8d",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 14.93
}
}
],
"awardID": "1e4ce39ccc9d44f694f3311d124f43d9",
"bidID": "668d4247367842bc867d5e415519e115",
"date": "2027-01-01T00:00:00+02:00"
},
{
"id": "ff0b7237e5e74871a348807ea6591bb6",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 14.93
}
}
],
"awardID": "0f7d7962750e47f3bc7deadc3e1e4071",
"bidID": "5205692aa028408abb67b23cdb8ecab6",
"date": "2027-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "ce7ee9fee64b4eaa87dd010843796c9a",
"description": "футляри до державних нагород",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"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"
},
"description_en": "Cases for state awards",
"relatedLot": "41d9357c4d24494186fe2da6c7e8ad7d"
}
],
"procuringEntity": {
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"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": "abbc9a0c6f034659b3b28397ceceaac1",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "signingTheContract",
"type": "delivery",
"code": "standard",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"numberOfContracts": 3,
"dateModified": "2027-01-01T00:00:00+02:00",
"changes": [
{
"id": "763394fc5c714348b33cea25674f6916",
"status": "active",
"date": "2027-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2027-01-01T00:00:00+02:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "ce7ee9fee64b4eaa87dd010843796c9a",
"factor": 0.1605
}
]
}
],
"documents": [
{
"relatedItem": "763394fc5c714348b33cea25674f6916",
"id": "2dca769710034e8cb17e18c4431a6261",
"datePublished": "2027-01-01T00:00:00+02: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": "2027-01-01T00:00:00+02:00",
"language": "uk",
"documentOf": "change"
}
],
"id": "8887db77f71c4a0496b39ac2c4eea78c"
},
"config": {
"restricted": false
}
}
Завантаження документів
Замовник може завантажити PDF-файли в створену угоду. Завантаження повинне слідувати правилам завантаження.
POST /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/documents?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
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/8887db77f71c4a0496b39ac2c4eea78c/documents/124232565e204145814107fa995adb71
{
"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": "124232565e204145814107fa995adb71",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було додано. Додатково можна запитати точку входу API колекції documents для підтвердження дії:
GET /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/documents?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"relatedItem": "763394fc5c714348b33cea25674f6916",
"id": "2dca769710034e8cb17e18c4431a6261",
"datePublished": "2027-01-01T00:00:00+02: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": "2027-01-01T00:00:00+02: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": "124232565e204145814107fa995adb71",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
]
}
І знову можна підтвердити, що два документи завантажені.
POST /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/documents?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
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/8887db77f71c4a0496b39ac2c4eea78c/documents/b1f954546ec1466e8e9cc3b47a8af9de
{
"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": "b1f954546ec1466e8e9cc3b47a8af9de",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
}
У випадку помилки, можна заново завантажити документ поверх старої версії:
PUT /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/documents/b1f954546ec1466e8e9cc3b47a8af9de?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
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": "b1f954546ec1466e8e9cc3b47a8af9de",
"datePublished": "2027-01-01T00:00:00+02: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": "2027-01-01T00:00:00+02:00",
"language": "uk",
"documentOf": "agreement"
}
}
І можна побачити, що цей документ переважає оригінальну версію:
GET /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c/documents/b1f954546ec1466e8e9cc3b47a8af9de?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "b1f954546ec1466e8e9cc3b47a8af9de",
"datePublished": "2027-01-01T00:00:00+02: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": "2027-01-01T00:00:00+02: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": "b1f954546ec1466e8e9cc3b47a8af9de",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
]
}
}
Завершення угоди
Угода може бути завершена переходом в статус terminated. Давайте виконаємо ці дії одним запитом:
PATCH /api/2.5/agreements/8887db77f71c4a0496b39ac2c4eea78c?acc_token=9870067ea6e64d14adf4016d24d15f0c HTTP/1.0
Authorization: Bearer broker
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-2027-01-01-000001-a-ea4a5ba075dd404db964b580ae32918c1",
"status": "terminated",
"dateModified": "2027-01-01T00:00:00+02:00",
"owner": "broker",
"agreementType": "closeFrameworkAgreementUA",
"changes": [
{
"id": "763394fc5c714348b33cea25674f6916",
"status": "active",
"date": "2027-01-01T00:00:00+02:00",
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Agreement change cause",
"dateSigned": "2027-01-01T00:00:00+02:00",
"rationaleType": "taxRate",
"modifications": [
{
"itemId": "ce7ee9fee64b4eaa87dd010843796c9a",
"factor": 0.1605
}
]
}
],
"documents": [
{
"relatedItem": "763394fc5c714348b33cea25674f6916",
"id": "2dca769710034e8cb17e18c4431a6261",
"datePublished": "2027-01-01T00:00:00+02: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": "2027-01-01T00:00:00+02:00",
"language": "uk",
"documentOf": "change"
},
{
"id": "124232565e204145814107fa995adb71",
"datePublished": "2027-01-01T00:00:00+02: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": "2027-01-01T00:00:00+02:00",
"language": "uk",
"documentOf": "agreement"
},
{
"id": "b1f954546ec1466e8e9cc3b47a8af9de",
"datePublished": "2027-01-01T00:00:00+02: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": "2027-01-01T00:00:00+02:00",
"language": "uk",
"documentOf": "agreement"
},
{
"id": "b1f954546ec1466e8e9cc3b47a8af9de",
"datePublished": "2027-01-01T00:00:00+02: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": "2027-01-01T00:00:00+02:00",
"language": "uk",
"documentOf": "agreement"
}
],
"contracts": [
{
"id": "633a51fd12d44a77ab03e65ccd808aa7",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 14.93
}
}
],
"awardID": "011e63208de240c896e459f6bcb39725",
"bidID": "2b11d016d9234ec2b719df7659304750",
"date": "2027-01-01T00:00:00+02:00"
},
{
"id": "b0403401034942fe9e4317ee69e69f8d",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 14.93
}
}
],
"awardID": "1e4ce39ccc9d44f694f3311d124f43d9",
"bidID": "668d4247367842bc867d5e415519e115",
"date": "2027-01-01T00:00:00+02:00"
},
{
"id": "ff0b7237e5e74871a348807ea6591bb6",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"unitPrices": [
{
"relatedItem": "ce7ee9fee64b4eaa87dd010843796c9a",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 14.93
}
}
],
"awardID": "0f7d7962750e47f3bc7deadc3e1e4071",
"bidID": "5205692aa028408abb67b23cdb8ecab6",
"date": "2027-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "ce7ee9fee64b4eaa87dd010843796c9a",
"description": "футляри до державних нагород",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"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"
},
"description_en": "Cases for state awards",
"relatedLot": "41d9357c4d24494186fe2da6c7e8ad7d"
}
],
"procuringEntity": {
"name": "Державне управління справами",
"name_en": "State administration",
"identifier": {
"scheme": "UA-IPN",
"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": "abbc9a0c6f034659b3b28397ceceaac1",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "signingTheContract",
"type": "delivery",
"code": "standard",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"numberOfContracts": 3,
"id": "8887db77f71c4a0496b39ac2c4eea78c"
},
"config": {
"restricted": false
}
}
Якщо угода неуспішна, причини припинення угоди повинні бути вказані в полі terminationDetails.
Будь-які майбутні зміни в угоді не дозволяються.
Можливо, буде корисно побачити актуальні вимоги: Сценарії ручного тестування для III рівня акредитації і Сценарії ручного тестування для IV рівня акредитації.