Tutorial
Загальна картина
Процес визначення переможця відбувається на майданчиках 1-4 рівнів акредитації.
Процес електронного контракту відбувається на майданчиках 6 рівня акредитації.
Передумови
Вимоги до тендеру
Для електронних контрактів тендер має відповідати наступним вимогам
має бути обрано шаблон договору за допомогою поля contractTemplateName в тендері
має бути обраним майданчик 6 рівня акредитації для замовників та постачальників
Розглянемо детальніше вимоги щодо тендеру.
Шаблон договору
Поле contractTemplateName має бути обов’язково обрано на етапі створення тендеру (більше тут Providing contract template)
Це поле визначає шаблон договору, який буде використано для створення PDF документу договору.
Майданчик 6 рівня акредитації
При створенні контракту замовнику (buyer) та постачальнику (supplier) має бути надано можливість вказати майданчик на якому буде проходити контрактінг.
Назва майданчика має бути вказана
в полі contract_owner в procuringEntity (або buyers для закупівель ЦЗО) для замовників
в полі contract_owner в tenderers пропозиції для постачальників
Поле contract_owner може мати лише назву майданчика, який пройшов акредитацію 6 рівня.
Для замовника майданчик має вказати поле contract_owner в procuringEntity (або buyers для закупівель ЦЗО).
Отримати перелік майданчиків можна за допомогою API запиту:
Request
GET /api/2.5/brokers HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"name": "broker",
"title": "broker",
"levels": [
1,
2,
3,
4,
5,
6
],
"permissions": []
},
{
"name": "brokerh",
"title": "brokerh",
"levels": [
1,
2,
3,
4,
5
],
"permissions": []
},
{
"name": "brokerx",
"title": "brokerx",
"levels": [
1,
2,
3,
4,
5
],
"permissions": [
"x"
]
},
{
"name": "brokerr",
"title": "brokerr",
"levels": [
1,
2,
3,
4,
5
],
"permissions": [
"r"
]
},
{
"name": "broker05",
"title": "broker05",
"levels": [
1,
2,
3,
4,
5,
6
],
"permissions": []
},
{
"name": "broker1",
"title": "broker1",
"levels": [
1
],
"permissions": []
},
{
"name": "broker2",
"title": "broker2",
"levels": [
2
],
"permissions": []
},
{
"name": "broker3",
"title": "broker3",
"levels": [
3
],
"permissions": []
},
{
"name": "broker4",
"title": "broker4",
"levels": [
4
],
"permissions": []
},
{
"name": "broker6",
"title": "broker6",
"levels": [
6
],
"permissions": []
},
{
"name": "broker1t",
"title": "broker1t",
"levels": [
1
],
"permissions": [
"t"
]
},
{
"name": "broker2t",
"title": "broker2t",
"levels": [
2
],
"permissions": [
"t"
]
},
{
"name": "broker3t",
"title": "broker3t",
"levels": [
3
],
"permissions": [
"t"
]
},
{
"name": "broker4t",
"title": "broker4t",
"levels": [
4
],
"permissions": [
"t"
]
}
]
}
Якщо спробувати створити тендер з майданчиком не 6го рівня, то отримаємо помилку:
Request
POST /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
},
"contract_owner": "broker1"
},
"value": {
"amount": 22000,
"currency": "UAH"
},
"tenderPeriod": {
"endDate": "2023-10-24T01:00:00+03:00"
},
"procurementMethodType": "priceQuotation",
"procurementMethod": "selective",
"items": [
{
"description": "Комп’ютерне обладнання",
"category": "655360-30230000-889652",
"profile": "655360-30230000-889652-40000777",
"quantity": 5,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 100
}
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"id": "29cbde01600848de837efe5448e726fb"
},
{
"description": "Комп’ютерне обладнання",
"category": "655360-30230000-889652",
"profile": "655360-30230000-889652-40000777",
"quantity": 5,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 100
}
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"id": "24726f3002834ed287ec1c07b91606cf"
}
],
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"contractTemplateName": "00000000.0002.01",
"criteria": [
{
"description": "Форма випуску",
"source": "tenderer",
"relatesTo": "item",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
},
"legislation": [
{
"version": "2020-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19"
},
"type": "NATIONAL_LEGISLATION"
}
],
"requirementGroups": [
{
"description": "Форма випуску",
"requirements": [
{
"dataType": "string",
"expectedValues": [
"Розчин для інфузій"
],
"title": "Форма випуску",
"expectedMinItems": 1
},
{
"dataType": "integer",
"minValue": 5,
"title": "Доза діючої речовини",
"unit": {
"code": "KGM",
"name": "кілограми"
}
},
{
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 1,
"expectedMaxItems": 3,
"title": "Форма випуску 1"
}
]
}
],
"title": "Форма випуску",
"relatedItem": "29cbde01600848de837efe5448e726fb"
}
]
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 0,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "procuringEntity",
"description": {
"contract_owner": "should be one of brokers with level 6"
}
}
]
}
Відфільтруємо майданчики 6го рівня:
Request
GET /api/2.5/brokers?levels=6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"name": "broker",
"title": "broker",
"levels": [
1,
2,
3,
4,
5,
6
],
"permissions": []
},
{
"name": "broker05",
"title": "broker05",
"levels": [
1,
2,
3,
4,
5,
6
],
"permissions": []
},
{
"name": "broker6",
"title": "broker6",
"levels": [
6
],
"permissions": []
}
]
}
Створимо тендер з майданчиком 6го рівня:
Request
POST /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
},
"contract_owner": "broker6"
},
"value": {
"amount": 22000,
"currency": "UAH"
},
"tenderPeriod": {
"endDate": "2023-10-24T01:00:00+03:00"
},
"procurementMethodType": "priceQuotation",
"procurementMethod": "selective",
"items": [
{
"description": "Комп’ютерне обладнання",
"category": "655360-30230000-889652",
"profile": "655360-30230000-889652-40000777",
"quantity": 5,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 100
}
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"id": "29cbde01600848de837efe5448e726fb"
},
{
"description": "Комп’ютерне обладнання",
"category": "655360-30230000-889652",
"profile": "655360-30230000-889652-40000777",
"quantity": 5,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 100
}
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"id": "24726f3002834ed287ec1c07b91606cf"
}
],
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"contractTemplateName": "00000000.0002.01",
"criteria": [
{
"description": "Форма випуску",
"source": "tenderer",
"relatesTo": "item",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
},
"legislation": [
{
"version": "2020-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19"
},
"type": "NATIONAL_LEGISLATION"
}
],
"requirementGroups": [
{
"description": "Форма випуску",
"requirements": [
{
"dataType": "string",
"expectedValues": [
"Розчин для інфузій"
],
"title": "Форма випуску",
"expectedMinItems": 1
},
{
"dataType": "integer",
"minValue": 5,
"title": "Доза діючої речовини",
"unit": {
"code": "KGM",
"name": "кілограми"
}
},
{
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 1,
"expectedMaxItems": 3,
"title": "Форма випуску 1"
}
]
}
],
"title": "Форма випуску",
"relatedItem": "29cbde01600848de837efe5448e726fb"
}
]
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 0,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b86d98f551fa49dfa9004373a996b627
{
"data": {
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"contractTemplateName": "00000000.0002.01",
"title": "Комп’ютерне обладнання",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"endDate": "2023-10-24T01:00:00+03:00",
"startDate": "2023-10-10T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contract_owner": "broker6",
"kind": "general"
},
"items": [
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
},
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
}
],
"criteria": [
{
"id": "a21ebe3a09474068bab9c6d923d1659d",
"description": "Форма випуску",
"source": "tenderer",
"relatesTo": "item",
"relatedItem": "29cbde01600848de837efe5448e726fb",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
},
"title": "Форма випуску",
"legislation": [
{
"version": "2020-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19"
},
"type": "NATIONAL_LEGISLATION"
}
],
"requirementGroups": [
{
"id": "fc85dc9ee12c47d6bb70cce9899fb4cd",
"description": "Форма випуску",
"requirements": [
{
"id": "2de4ee74b54b45898ddd46d2bd7400e2",
"title": "Форма випуску",
"dataType": "string",
"status": "active",
"expectedValues": [
"Розчин для інфузій"
],
"expectedMinItems": 1,
"datePublished": "2023-10-10T01:00:00+03:00"
},
{
"id": "f26994c6d1a44559b89c1f222ef7a058",
"title": "Доза діючої речовини",
"dataType": "integer",
"status": "active",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5,
"datePublished": "2023-10-10T01:00:00+03:00"
},
{
"id": "f5db16e047d64f44bae77b44d68006a7",
"title": "Форма випуску 1",
"dataType": "string",
"status": "active",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 1,
"expectedMaxItems": 3,
"datePublished": "2023-10-10T01:00:00+03:00"
}
]
}
]
}
],
"tenderID": "UA-2023-10-10-000002-a",
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "b86d98f551fa49dfa9004373a996b627"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 0,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
},
"access": {
"token": "1e2b3d149c2f4d238ac5c11930db13e9",
"transfer": "d212aa1985af429b844f0cbd5bddb1f8"
}
}
Тендер створено успішно.
Для постачальника майданчик має вказати поле contract_owner в полі tenderers пропозиції.
Переглянемо як виглядає пропозиція для постачальника:
Request
GET /api/2.5/tenders/b86d98f551fa49dfa9004373a996b627/bids/6eb4106605214f398c4336aee7072c4c?acc_token=59d78bf3d096420083e6123a1a8f570e HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "6eb4106605214f398c4336aee7072c4c",
"date": "2023-10-10T01:00:00+03:00",
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contract_owner": "broker6"
}
],
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "2de4ee74b54b45898ddd46d2bd7400e2",
"title": "Форма випуску"
},
"values": [
"Розчин для інфузій"
],
"id": "8fdf76d96e1343edb25e36a00f7f8a77",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "f26994c6d1a44559b89c1f222ef7a058",
"title": "Доза діючої речовини"
},
"value": 5,
"id": "cc5f60db5c874a83ac3e02081b1abeb9",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "f5db16e047d64f44bae77b44d68006a7",
"title": "Форма випуску 1"
},
"values": [
"Відповідь1",
"Відповідь2"
],
"id": "3c14d0aff57746b5b102d37694354cf4",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
}
],
"status": "pending",
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 10.0,
"product": "11111111111111111111111111111111"
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0,
"product": "11111111111111111111111111111111"
}
],
"submissionDate": "2023-10-10T01:00:00+03:00"
}
}
Як бачимо, майданчик вказано правильно.
Creating contract
Let’s say that we have conducted tender with award. When the award is activated, a contract is automatically created in the tender with a limited set of fields(id, awardID, status, date, value) and in the contracting module with a full set of fields(EContract) in pending status.
A contract is created with additional fields:
contractTemplateName - copied from tender if exists (more about it in Providing contract template)
period - startDate equals dateCreated + 5 calendar days, endDate is the end of the year of startDate
A PQ contract is created with additional fields:
attributes - formed from requirements and responses in tender
Also, PDF document is created based on the template (contractTemplateName) and automatically attached to the contract with documentType contractNotice.
This document will be required for signing for both supplier and buyer later to activate the contract.
Getting contract
Contract in the tender system
Request
GET /api/2.5/tenders/b86d98f551fa49dfa9004373a996b627/contracts/37d2cea7a3564774858ad5c8681f57b1 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "37d2cea7a3564774858ad5c8681f57b1",
"status": "pending",
"awardID": "f10947246ab44416ab8f1f75df484ded",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000002-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
}
}
}
Contract id is the same in both tender and contract system.
Let’s see what listing of contracts in contracting module reveals us:
Request
GET /api/2.5/contracts?opt_fields=status HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"status": "pending",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "37d2cea7a3564774858ad5c8681f57b1"
}
],
"next_page": {
"offset": "1696888800.0.1.f0f69585e969cbbe45fecf74b0a96340",
"path": "/api/2.5/contracts?opt_fields=status&offset=1696888800.0.1.f0f69585e969cbbe45fecf74b0a96340",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?opt_fields=status&offset=1696888800.0.1.f0f69585e969cbbe45fecf74b0a96340"
}
}
Let’s access the URL of the created object:
Request
GET /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "f10947246ab44416ab8f1f75df484ded",
"contractID": "UA-2023-10-10-000002-a-1",
"period": {
"startDate": "2023-10-15T00:00:00+03:00",
"endDate": "2023-12-31T23:59:59+03:00"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "b86d98f551fa49dfa9004373a996b627",
"contractTemplateName": "00000000.0002.01",
"status": "pending",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/documents/6275a28d9e274758a944bcbbb9b6c103?download=acdee3c5fbb14da0b63000963dea8a81",
"documentOf": "contract",
"id": "6275a28d9e274758a944bcbbb9b6c103",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
}
],
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "37d2cea7a3564774858ad5c8681f57b1"
},
"config": {
"restricted": false
}
}
Getting access
For getting access for buyer or supplier endpoint contracts/{contract_id}/access is used after contract was created.
Algorith of getting access:
POST /access with identifier of client - returns token for client
Main action is POST /access - a query with a client identifier determines whether it is a buyer or supplier. If the identifier does not match any of the entities, an error is issued:
Request
POST /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/access HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"identifier": {
"scheme": "UA-EDR",
"id": "123456780"
}
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Invalid identifier"
}
]
}
If identifier is found, then we validate whether authenticated user is an owner for this role:
Request
POST /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/access HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
}
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Owner mismatch"
}
]
}
If identifier is found and owner matches, then the token is set according to the entity for supplier or buyer:
Request
POST /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/access HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
}
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
}
},
"access": {
"token": "e062b9ad8c5f453f9343377d4fcce628",
"transfer": "594765ed2bfc40df90e7401f5483e4aa"
}
}
If buyer get access, we will see in response new transfer token too.
After token generation, it is allowed to regenerate token, make new POST request with this identifier:
Request
POST /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/access HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
}
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
}
},
"access": {
"token": "838bca54aee04fbaabd502cb2c7b28a4",
"transfer": "59e83bca2364481789368d2893158992"
}
}
NOTE: Then user can modify contract as buyer only using the last generated token.
After token was regenerated, previous token can not be used for updating contract:
Request
POST /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/documents?acc_token=e062b9ad8c5f453f9343377d4fcce628 HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentType": "contractSignature",
"title": "sign.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9dc6bfe4683b4e63a799bbe366ba9376?Signature=7DWfdBRHAAJ%2B1P1BSGB%2FmCbWTCo%2BtmGS9jsRJ8ZjGLgs3620bu7fab8LAVooJfFR4ddSLVDqvY%2Brn2aywo2TAg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "url",
"name": "permission",
"description": "Forbidden"
}
]
}
The same algorithm will be for supplier access.
Let’s require access for supplier:
Request
POST /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/access HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
}
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
}
},
"access": {
"token": "47c3f4968e1341499809200105e2aade"
}
}
WARNING: It is allowed to get access only during contract is pending.
Activating contract
If contract was created using new flow with set contract_owner in tender for suppliers and buyers than for activating electronic contract, signer information and all participants signature are required.
To activate contract it is required to add contract signature document type from each participant (supplier and buyer).
Requirements for signing:
Contract document with documentType contractNotice should be signed
Signature file should be attached to the contract with documentType contractSignature
Signature must have following parameters:
Format: CAdES-X Long
Algorithm: DSTU 4145
Type: Separate data and signature files (detached)
Here is a diagram of the signing process:
If both sides signed the current version of contract, than contract becomes active.
Supplier adds signature document using his token (supplier_token) which he got during access query:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/documents?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentType": "contractSignature",
"title": "sign.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9dc6bfe4683b4e63a799bbe366ba9376?Signature=7DWfdBRHAAJ%2B1P1BSGB%2FmCbWTCo%2BtmGS9jsRJ8ZjGLgs3620bu7fab8LAVooJfFR4ddSLVDqvY%2Brn2aywo2TAg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/documents/7f7d3898f20743798bf86ef67bf260d6
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9dc6bfe4683b4e63a799bbe366ba9376?Signature=%2BLgh9VhF5n7wmuNcFF6T%2Bjmx3ZE5OebUfgBYsTIQUnvJGC2XVvYlyijyC8iAq83srktGfhtCKMK8bky9f%2BnXCg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"documentType": "contractSignature",
"id": "7f7d3898f20743798bf86ef67bf260d6",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "supplier"
}
}
Buyer adds signature document using his token (buyer_token) which he got during access query:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/documents?acc_token=095f224d5ed54436b623b406684b80f1 HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentType": "contractSignature",
"title": "sign.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9dc6bfe4683b4e63a799bbe366ba9376?Signature=7DWfdBRHAAJ%2B1P1BSGB%2FmCbWTCo%2BtmGS9jsRJ8ZjGLgs3620bu7fab8LAVooJfFR4ddSLVDqvY%2Brn2aywo2TAg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/documents/22ad6fee7d0042aaa9a1d88e22bf9d67
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9dc6bfe4683b4e63a799bbe366ba9376?Signature=%2BLgh9VhF5n7wmuNcFF6T%2Bjmx3ZE5OebUfgBYsTIQUnvJGC2XVvYlyijyC8iAq83srktGfhtCKMK8bky9f%2BnXCg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"documentType": "contractSignature",
"id": "22ad6fee7d0042aaa9a1d88e22bf9d67",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "buyer"
}
}
If all required signatures are completed, the contract will automatically transition to the active status:
Request
GET /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260?acc_token=095f224d5ed54436b623b406684b80f1 HTTP/1.0
Authorization: Bearer broker6
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "1b4f4c15efe44f04bcd52e5db833077a",
"contractID": "UA-2023-10-10-000002-a-3",
"period": {
"startDate": "2023-10-15T00:00:00+03:00",
"endDate": "2023-12-31T23:59:59+03:00"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "b86d98f551fa49dfa9004373a996b627",
"contractTemplateName": "00000000.0002.01",
"status": "active",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/documents/e7d826dbc2944bb6bba19f45034deddd?download=acdee3c5fbb14da0b63000963dea8a81",
"documentOf": "contract",
"id": "e7d826dbc2944bb6bba19f45034deddd",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/documents/7f7d3898f20743798bf86ef67bf260d6?download=9dc6bfe4683b4e63a799bbe366ba9376",
"documentOf": "contract",
"documentType": "contractSignature",
"id": "7f7d3898f20743798bf86ef67bf260d6",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "supplier"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/documents/22ad6fee7d0042aaa9a1d88e22bf9d67?download=9dc6bfe4683b4e63a799bbe366ba9376",
"documentOf": "contract",
"documentType": "contractSignature",
"id": "22ad6fee7d0042aaa9a1d88e22bf9d67",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "buyer"
}
],
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateSigned": "2023-10-10T01:00:00+03:00",
"id": "38891909c9274c02b0bdca60fa5d2260"
},
"config": {
"restricted": false
}
}
New versions of contract
If one of sides doesn’t agree to sign current version of contract, there is an opportunity to create a new version of contract.
Flow:
create a cancellation of current version of contract
POST new version o contract with updates
sign new version and wait till another side agrees to sign (or create new version by his side)
Cancellations
It is allowed to cancel current version of contract and create new one during contract is pending.
To cancel current version of contract, participant of contract should create a cancellation with reason requiresChanges:
Request
POST /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/cancellations?acc_token=47c3f4968e1341499809200105e2aade HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "requiresChanges",
"reason": "want to change signerInfo"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"reason": "want to change signerInfo",
"reasonType": "requiresChanges",
"id": "c58f0f2f3df849e6bbe4ad1f4ca04144",
"dateCreated": "2023-10-10T01:00:00+03:00",
"status": "pending",
"author": "supplier"
}
}
Let’s look at contract:
Request
GET /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1 HTTP/1.0
Authorization: Bearer broker6
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "f10947246ab44416ab8f1f75df484ded",
"contractID": "UA-2023-10-10-000002-a-1",
"period": {
"startDate": "2023-10-15T00:00:00+03:00",
"endDate": "2023-12-31T23:59:59+03:00"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "b86d98f551fa49dfa9004373a996b627",
"contractTemplateName": "00000000.0002.01",
"status": "pending",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/documents/6275a28d9e274758a944bcbbb9b6c103?download=acdee3c5fbb14da0b63000963dea8a81",
"documentOf": "contract",
"id": "6275a28d9e274758a944bcbbb9b6c103",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/documents/8e9a0dd828594b84a952bd293bf939a4?download=9dc6bfe4683b4e63a799bbe366ba9376",
"documentOf": "contract",
"documentType": "contractSignature",
"id": "8e9a0dd828594b84a952bd293bf939a4",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "buyer"
}
],
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"cancellations": [
{
"reason": "want to change signerInfo",
"reasonType": "requiresChanges",
"id": "c58f0f2f3df849e6bbe4ad1f4ca04144",
"dateCreated": "2023-10-10T01:00:00+03:00",
"status": "pending",
"author": "supplier"
}
],
"id": "37d2cea7a3564774858ad5c8681f57b1"
},
"config": {
"restricted": false
}
}
It is forbidden to add more than one cancellation:
Request
POST /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/cancellations?acc_token=47c3f4968e1341499809200105e2aade HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "requiresChanges",
"reason": "want to change signerInfo"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Cancellation for contract already exists"
}
]
}
After cancellation created, there is forbidden to sign contract:
Request
POST /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/documents?acc_token=47c3f4968e1341499809200105e2aade HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentType": "contractSignature",
"title": "sign.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9dc6bfe4683b4e63a799bbe366ba9376?Signature=7DWfdBRHAAJ%2B1P1BSGB%2FmCbWTCo%2BtmGS9jsRJ8ZjGLgs3620bu7fab8LAVooJfFR4ddSLVDqvY%2Brn2aywo2TAg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Forbidden to sign contract with cancellation"
}
]
}
Create new contract version
Then any of the participant should create a new version of contract using his token.
Allowed fields for updating:
period
contractNumber
items.unit
items.quantity
value
title
title_en
description
description_en
dateSigned
signerInfo (for supplier or buyer depends on who cancelled contract)
If participant tried to update another field, he will see an error:
Request
POST /api/2.5/contracts?acc_token=47c3f4968e1341499809200105e2aade HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"awardID": "f10947246ab44416ab8f1f75df484ded",
"contractID": "UA-2023-10-10-000002-a-1",
"period": {
"startDate": "2023-10-15T00:00:00+03:00",
"endDate": "2023-12-31T23:59:59+03:00"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"kind": "general",
"signerInfo": {
"name": "Another buyer",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "b86d98f551fa49dfa9004373a996b627",
"contractTemplateName": "00000000.0002.01",
"status": "pending"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Updated could be only ('items', 'value', 'period', 'title', 'title_en', 'description', 'description_en', 'dateSigned', 'suppliers') in contract, buyer change forbidden"
}
]
}
Let’s update fields period and signerInfo.name using token for supplier:
Request
POST /api/2.5/contracts?acc_token=47c3f4968e1341499809200105e2aade HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"awardID": "f10947246ab44416ab8f1f75df484ded",
"contractID": "UA-2023-10-10-000002-a-1",
"period": {
"startDate": "2022-01-01",
"endDate": "2026-01-01"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"scale": "micro",
"signerInfo": {
"name": "Another supplier",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "b86d98f551fa49dfa9004373a996b627",
"contractTemplateName": "00000000.0002.01",
"status": "pending"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"awardID": "f10947246ab44416ab8f1f75df484ded",
"contractID": "UA-2023-10-10-000002-a-2",
"period": {
"startDate": "2022-01-01T00:00:00+02:00",
"endDate": "2026-01-01T00:00:00+02:00"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"scale": "micro",
"signerInfo": {
"name": "Another supplier",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "b86d98f551fa49dfa9004373a996b627",
"contractTemplateName": "00000000.0002.01",
"status": "pending",
"author": "supplier",
"date": "2023-10-10T01:00:00+03:00",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.pdf",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/d71a69be5f1a437abf5134881f4c4b98/documents/ba34cbd977c84a82a2261261c72db7ec?download=acdee3c5fbb14da0b63000963dea8a81",
"documentOf": "contract",
"id": "ba34cbd977c84a82a2261261c72db7ec",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
}
],
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "d71a69be5f1a437abf5134881f4c4b98"
},
"config": {
"restricted": false
}
}
Success! Let’s look at previous version of contract, it became cancelled and cancellation now is active:
Request
GET /api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1 HTTP/1.0
Authorization: Bearer broker6
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "f10947246ab44416ab8f1f75df484ded",
"contractID": "UA-2023-10-10-000002-a-1",
"period": {
"startDate": "2023-10-15T00:00:00+03:00",
"endDate": "2023-12-31T23:59:59+03:00"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "b86d98f551fa49dfa9004373a996b627",
"contractTemplateName": "00000000.0002.01",
"status": "cancelled",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/documents/6275a28d9e274758a944bcbbb9b6c103?download=acdee3c5fbb14da0b63000963dea8a81",
"documentOf": "contract",
"id": "6275a28d9e274758a944bcbbb9b6c103",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/37d2cea7a3564774858ad5c8681f57b1/documents/8e9a0dd828594b84a952bd293bf939a4?download=9dc6bfe4683b4e63a799bbe366ba9376",
"documentOf": "contract",
"documentType": "contractSignature",
"id": "8e9a0dd828594b84a952bd293bf939a4",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "buyer"
}
],
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"cancellations": [
{
"reason": "want to change signerInfo",
"reasonType": "requiresChanges",
"id": "c58f0f2f3df849e6bbe4ad1f4ca04144",
"dateCreated": "2023-10-10T01:00:00+03:00",
"status": "active",
"author": "supplier"
}
],
"date": "2023-10-10T01:00:00+03:00",
"id": "37d2cea7a3564774858ad5c8681f57b1"
},
"config": {
"restricted": false
}
}
Let’s look at all contracts in tender:
Request
GET /api/2.5/tenders/b86d98f551fa49dfa9004373a996b627/contracts HTTP/1.0
Authorization: Bearer broker6
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "37d2cea7a3564774858ad5c8681f57b1",
"status": "cancelled",
"awardID": "f10947246ab44416ab8f1f75df484ded",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000002-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
}
},
{
"id": "d71a69be5f1a437abf5134881f4c4b98",
"status": "pending",
"awardID": "f10947246ab44416ab8f1f75df484ded",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000002-a-2",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
}
}
]
}
After that new round of signatures begins.
Supplier and buyer can sign this new version of contract if they agreed with changes or create new version if disagreed.
Cancellations of Econtract
It is allowed to cancel contract while it is on pending status.
There are two reasonTypes for creating cancellation of contract:
requiresChanges
signingRefusal
Reason requiresChanges means that one of the sides doesn’t agree to sign current version of contract, and they want to create a new version of contract. Described in New versions of contract.
Reason signingRefusal means that the winner of tender is refused to sign aa contract, that’s why his award should be cancelled by buyer.
Participant of contract can create a cancellation with reason signingRefusal:
Request
POST /api/2.5/contracts/d71a69be5f1a437abf5134881f4c4b98/cancellations?acc_token=47c3f4968e1341499809200105e2aade HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "signingRefusal",
"reason": "want to quid"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"reason": "want to quid",
"reasonType": "signingRefusal",
"id": "3380e0835b714c2d8c6a852fbef4187e",
"dateCreated": "2023-10-10T01:00:00+03:00",
"status": "pending",
"author": "supplier"
}
}
Let’s look at contract:
Request
GET /api/2.5/contracts/d71a69be5f1a437abf5134881f4c4b98 HTTP/1.0
Authorization: Bearer broker6
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "f10947246ab44416ab8f1f75df484ded",
"contractID": "UA-2023-10-10-000002-a-2",
"period": {
"startDate": "2022-01-01T00:00:00+02:00",
"endDate": "2026-01-01T00:00:00+02:00"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"scale": "micro",
"signerInfo": {
"name": "Another supplier",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "b86d98f551fa49dfa9004373a996b627",
"contractTemplateName": "00000000.0002.01",
"status": "pending",
"author": "supplier",
"date": "2023-10-10T01:00:00+03:00",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/d71a69be5f1a437abf5134881f4c4b98/documents/ba34cbd977c84a82a2261261c72db7ec?download=acdee3c5fbb14da0b63000963dea8a81",
"documentOf": "contract",
"id": "ba34cbd977c84a82a2261261c72db7ec",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
}
],
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"cancellations": [
{
"reason": "want to quid",
"reasonType": "signingRefusal",
"id": "3380e0835b714c2d8c6a852fbef4187e",
"dateCreated": "2023-10-10T01:00:00+03:00",
"status": "pending",
"author": "supplier"
}
],
"id": "d71a69be5f1a437abf5134881f4c4b98"
},
"config": {
"restricted": false
}
}
After that buyer should cancel the winner via award:
Request
PATCH /api/2.5/tenders/b86d98f551fa49dfa9004373a996b627/awards/f10947246ab44416ab8f1f75df484ded?acc_token=1e2b3d149c2f4d238ac5c11930db13e9 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b86d98f551fa49dfa9004373a996b627/awards/1b4f4c15efe44f04bcd52e5db833077a
{
"data": {
"id": "f10947246ab44416ab8f1f75df484ded",
"status": "cancelled",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contract_owner": "broker6"
}
],
"bid_id": "6eb4106605214f398c4336aee7072c4c",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "aaa30dac32c847c9b6835c1f4501df97",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/86bc318502e343a59c58137933cd1af0?Signature=hsltR%2BvlMEkWC%2FYGw3BxRGC2fe9YODIu8lrnHVBW1hH6OIcxnEy6JCOCxu9p62rOUREo7qYfN8t2LtrPDngpDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"qualified": true
}
}
Let’s look at contract one more time and we will see that contract became cancelled, cancellation became active:
Request
GET /api/2.5/contracts/d71a69be5f1a437abf5134881f4c4b98 HTTP/1.0
Authorization: Bearer broker6
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "f10947246ab44416ab8f1f75df484ded",
"contractID": "UA-2023-10-10-000002-a-2",
"period": {
"startDate": "2022-01-01T00:00:00+02:00",
"endDate": "2026-01-01T00:00:00+02:00"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"scale": "micro",
"signerInfo": {
"name": "Another supplier",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "b86d98f551fa49dfa9004373a996b627",
"contractTemplateName": "00000000.0002.01",
"status": "cancelled",
"author": "supplier",
"date": "2023-10-10T01:00:00+03:00",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/d71a69be5f1a437abf5134881f4c4b98/documents/ba34cbd977c84a82a2261261c72db7ec?download=acdee3c5fbb14da0b63000963dea8a81",
"documentOf": "contract",
"id": "ba34cbd977c84a82a2261261c72db7ec",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
}
],
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"cancellations": [
{
"reason": "want to quid",
"reasonType": "signingRefusal",
"id": "3380e0835b714c2d8c6a852fbef4187e",
"dateCreated": "2023-10-10T01:00:00+03:00",
"status": "active",
"author": "supplier"
}
],
"id": "d71a69be5f1a437abf5134881f4c4b98"
},
"config": {
"restricted": false
}
}
Let’s look at tender, the winner is cancelled an awarding is continuing:
Request
GET /api/2.5/tenders/b86d98f551fa49dfa9004373a996b627?acc_token=1e2b3d149c2f4d238ac5c11930db13e9 HTTP/1.0
Authorization: Bearer broker6
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"contractTemplateName": "00000000.0002.01",
"title": "Комп’ютерне обладнання",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "active.qualification",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"endDate": "2023-10-09T01:00:00+03:00",
"startDate": "2023-09-30T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contract_owner": "broker6",
"kind": "general"
},
"items": [
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
},
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
}
],
"criteria": [
{
"id": "a21ebe3a09474068bab9c6d923d1659d",
"description": "Форма випуску",
"source": "tenderer",
"relatesTo": "item",
"relatedItem": "29cbde01600848de837efe5448e726fb",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
},
"title": "Форма випуску",
"legislation": [
{
"version": "2020-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19"
},
"type": "NATIONAL_LEGISLATION"
}
],
"requirementGroups": [
{
"id": "fc85dc9ee12c47d6bb70cce9899fb4cd",
"description": "Форма випуску",
"requirements": [
{
"id": "2de4ee74b54b45898ddd46d2bd7400e2",
"title": "Форма випуску",
"dataType": "string",
"status": "active",
"expectedValues": [
"Розчин для інфузій"
],
"expectedMinItems": 1,
"datePublished": "2023-10-10T01:00:00+03:00"
},
{
"id": "f26994c6d1a44559b89c1f222ef7a058",
"title": "Доза діючої речовини",
"dataType": "integer",
"status": "active",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5,
"datePublished": "2023-10-10T01:00:00+03:00"
},
{
"id": "f5db16e047d64f44bae77b44d68006a7",
"title": "Форма випуску 1",
"dataType": "string",
"status": "active",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 1,
"expectedMaxItems": 3,
"datePublished": "2023-10-10T01:00:00+03:00"
}
]
}
]
}
],
"tenderID": "UA-2023-10-10-000002-a",
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"auctionPeriod": {
"startDate": "2023-10-20T01:00:00+03:00"
},
"bids": [
{
"id": "6eb4106605214f398c4336aee7072c4c",
"date": "2023-10-10T01:00:00+03:00",
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contract_owner": "broker6"
}
],
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "2de4ee74b54b45898ddd46d2bd7400e2",
"title": "Форма випуску"
},
"values": [
"Розчин для інфузій"
],
"id": "8fdf76d96e1343edb25e36a00f7f8a77",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "f26994c6d1a44559b89c1f222ef7a058",
"title": "Доза діючої речовини"
},
"value": 5,
"id": "cc5f60db5c874a83ac3e02081b1abeb9",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "f5db16e047d64f44bae77b44d68006a7",
"title": "Форма випуску 1"
},
"values": [
"Відповідь1",
"Відповідь2"
],
"id": "3c14d0aff57746b5b102d37694354cf4",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
}
],
"status": "active",
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 10.0,
"product": "11111111111111111111111111111111"
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0,
"product": "11111111111111111111111111111111"
}
],
"submissionDate": "2023-10-10T01:00:00+03:00",
"initialValue": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"awardPeriod": {
"startDate": "2023-10-10T01:00:00+03:00"
},
"awards": [
{
"id": "f10947246ab44416ab8f1f75df484ded",
"status": "cancelled",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contract_owner": "broker6"
}
],
"bid_id": "6eb4106605214f398c4336aee7072c4c",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "aaa30dac32c847c9b6835c1f4501df97",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/86bc318502e343a59c58137933cd1af0?Signature=hsltR%2BvlMEkWC%2FYGw3BxRGC2fe9YODIu8lrnHVBW1hH6OIcxnEy6JCOCxu9p62rOUREo7qYfN8t2LtrPDngpDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"qualified": true
},
{
"id": "1b4f4c15efe44f04bcd52e5db833077a",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contract_owner": "broker6"
}
],
"bid_id": "6eb4106605214f398c4336aee7072c4c",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-18T00:00:00+03:00"
}
}
],
"contracts": [
{
"id": "37d2cea7a3564774858ad5c8681f57b1",
"status": "cancelled",
"awardID": "f10947246ab44416ab8f1f75df484ded",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000002-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
}
},
{
"id": "d71a69be5f1a437abf5134881f4c4b98",
"status": "cancelled",
"awardID": "f10947246ab44416ab8f1f75df484ded",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000002-a-2",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
}
}
],
"id": "b86d98f551fa49dfa9004373a996b627"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 0,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Changes for active contract
Changes to the terms of the contracts can be made by the signatories through the submission and signing of an additional agreement. The system uses the terminology “changes”.
The initiator of the change can be both the buyer and the supplier.
The initiator fills in three mandatory fields:
- rationale:
string, reason of changes
- rationaleTypes:
list, reason type of changes
- modifications:
object, new values in fields
modifications is a structure that reflects the changes in the contract field that will be made:
- title:
string
- title_en:
string
- description:
string
- description_en:
string
- period:
-
The start and end date for the contract.
- items:
List of Item objects
- value:
ContractValue object
- contractNumber:
string
Changes can be made only to signed contracts:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"priceReduction"
],
"modifications": {
"value": {
"amount": 235,
"amountNet": 200
}
}
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Can't add contract change in current (pending) contract status"
}
]
}
Creating changes
Request to create a change:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"priceReduction"
],
"modifications": {
"value": {
"amount": 535,
"amountNet": 490
}
}
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"priceReduction"
],
"modifications": {
"value": {
"amount": 535.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 490.0
}
},
"id": "68db49ecd6ef439a81feaec69cd6ab07",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"author": "supplier",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_change.pdf",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07/documents/88962047c28144d99916ae75c9a2a38a?download=33830e473a1348d6a5a7e4eb3379672d",
"documentOf": "change",
"id": "88962047c28144d99916ae75c9a2a38a",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
}
]
}
}
There are validations for some fields during changes.
For example, if the buyer decided to change currency in contract value:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes?acc_token=095f224d5ed54436b623b406684b80f1 HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "причина зміни укр",
"rationaleTypes": [
"volumeCuts"
],
"modifications": {
"value": {
"currency": "USD",
"amount": 500
}
}
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "value",
"description": "Can't update currency for contract value"
}
]
}
For example, if the supplier decided to change period endDate in contract to incorrect date:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"durationExtension"
],
"modifications": {
"period": {
"endDate": "2021-01-01T00:00:00+02:00"
}
}
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "period should begin before its end"
}
]
}
Change activation
To activate change it is required to add contract signature document type from each participant (supplier and buyer).
If both sides signed the current version of change, than change becomes active and modifications will be taken into account during next changes.
Supplier adds signature document using his token (supplier_token):
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07/documents?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentType": "contractSignature",
"title": "sign.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9dc6bfe4683b4e63a799bbe366ba9376?Signature=7DWfdBRHAAJ%2B1P1BSGB%2FmCbWTCo%2BtmGS9jsRJ8ZjGLgs3620bu7fab8LAVooJfFR4ddSLVDqvY%2Brn2aywo2TAg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07/documents/c681b342eb664c3ab671f50a68860c14
{
"data": {
"confidentiality": "public",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"hash": "md5:00000000000000000000000000000000",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9dc6bfe4683b4e63a799bbe366ba9376?Signature=%2BLgh9VhF5n7wmuNcFF6T%2Bjmx3ZE5OebUfgBYsTIQUnvJGC2XVvYlyijyC8iAq83srktGfhtCKMK8bky9f%2BnXCg%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"documentType": "contractSignature",
"id": "c681b342eb664c3ab671f50a68860c14",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "supplier"
}
}
Buyer adds signature document using his token (buyer_token):
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07/documents?acc_token=095f224d5ed54436b623b406684b80f1 HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentType": "contractSignature",
"title": "sign.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9dc6bfe4683b4e63a799bbe366ba9376?Signature=7DWfdBRHAAJ%2B1P1BSGB%2FmCbWTCo%2BtmGS9jsRJ8ZjGLgs3620bu7fab8LAVooJfFR4ddSLVDqvY%2Brn2aywo2TAg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07/documents/dbfd77f646e24646b486c9993d548773
{
"data": {
"confidentiality": "public",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"hash": "md5:00000000000000000000000000000000",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9dc6bfe4683b4e63a799bbe366ba9376?Signature=%2BLgh9VhF5n7wmuNcFF6T%2Bjmx3ZE5OebUfgBYsTIQUnvJGC2XVvYlyijyC8iAq83srktGfhtCKMK8bky9f%2BnXCg%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"documentType": "contractSignature",
"id": "dbfd77f646e24646b486c9993d548773",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "buyer"
}
}
If all required signatures are completed, the change will automatically transition to the active status:
Request
GET /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07?acc_token=095f224d5ed54436b623b406684b80f1 HTTP/1.0
Authorization: Bearer broker6
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"priceReduction"
],
"modifications": {
"value": {
"amount": 535.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 490.0
}
},
"id": "68db49ecd6ef439a81feaec69cd6ab07",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"author": "supplier",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_change.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07/documents/88962047c28144d99916ae75c9a2a38a?download=33830e473a1348d6a5a7e4eb3379672d",
"documentOf": "change",
"id": "88962047c28144d99916ae75c9a2a38a",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
},
{
"confidentiality": "public",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"hash": "md5:00000000000000000000000000000000",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07/documents/c681b342eb664c3ab671f50a68860c14?download=9dc6bfe4683b4e63a799bbe366ba9376",
"documentOf": "change",
"documentType": "contractSignature",
"id": "c681b342eb664c3ab671f50a68860c14",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "supplier"
},
{
"confidentiality": "public",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"hash": "md5:00000000000000000000000000000000",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07/documents/dbfd77f646e24646b486c9993d548773?download=9dc6bfe4683b4e63a799bbe366ba9376",
"documentOf": "change",
"documentType": "contractSignature",
"id": "dbfd77f646e24646b486c9993d548773",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "buyer"
}
],
"dateSigned": "2023-10-10T01:00:00+03:00"
}
}
Cancellations
It is allowed to cancel change of contract if it is not actual anymore.
Create one more change:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"durationExtension"
],
"modifications": {
"period": {
"endDate": "2027-01-01T00:00:00+02:00"
}
}
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"durationExtension"
],
"modifications": {
"period": {
"endDate": "2027-01-01T00:00:00+02:00",
"startDate": "2023-10-15T00:00:00+03:00"
}
},
"id": "e3b63c3aac354f6db3fbc8f25d03cc7d",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"author": "supplier",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_change.pdf",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/e3b63c3aac354f6db3fbc8f25d03cc7d/documents/9471624212664412824822e912a743df?download=33830e473a1348d6a5a7e4eb3379672d",
"documentOf": "change",
"id": "9471624212664412824822e912a743df",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
}
]
}
}
To cancel change, participant of contract should create a cancellation with reason:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/e3b63c3aac354f6db3fbc8f25d03cc7d/cancellations?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "requiresChanges",
"reason": "not actual change"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"reason": "not actual change",
"reasonType": "requiresChanges",
"id": "4f8c5f34f0e34e2fad07dce1798124e2",
"dateCreated": "2023-10-10T01:00:00+03:00",
"status": "active",
"author": "supplier"
}
}
Let’s look at change:
Request
GET /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/e3b63c3aac354f6db3fbc8f25d03cc7d HTTP/1.0
Authorization: Bearer broker6
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"durationExtension"
],
"modifications": {
"period": {
"endDate": "2027-01-01T00:00:00+02:00",
"startDate": "2023-10-15T00:00:00+03:00"
}
},
"id": "e3b63c3aac354f6db3fbc8f25d03cc7d",
"status": "cancelled",
"date": "2023-10-10T01:00:00+03:00",
"author": "supplier",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_change.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/e3b63c3aac354f6db3fbc8f25d03cc7d/documents/9471624212664412824822e912a743df?download=33830e473a1348d6a5a7e4eb3379672d",
"documentOf": "change",
"id": "9471624212664412824822e912a743df",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
}
],
"cancellations": [
{
"reason": "not actual change",
"reasonType": "requiresChanges",
"id": "4f8c5f34f0e34e2fad07dce1798124e2",
"dateCreated": "2023-10-10T01:00:00+03:00",
"status": "active",
"author": "supplier"
}
]
}
}
It is forbidden to add more than one cancellation:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/e3b63c3aac354f6db3fbc8f25d03cc7d/cancellations?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "requiresChanges",
"reason": "not actual change"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Can't update contract change in current (cancelled) status"
}
]
}
After cancellation created, there is forbidden to sign change:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/e3b63c3aac354f6db3fbc8f25d03cc7d/documents?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentType": "contractSignature",
"title": "sign.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9dc6bfe4683b4e63a799bbe366ba9376?Signature=7DWfdBRHAAJ%2B1P1BSGB%2FmCbWTCo%2BtmGS9jsRJ8ZjGLgs3620bu7fab8LAVooJfFR4ddSLVDqvY%2Brn2aywo2TAg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Can't update contract change in current (cancelled) status"
}
]
}
Signing additional changes does not change the electronic fields of the contract itself. That is, if, for example, the value of the contract was changed by an additional change, then changes will contain the current value, and the contract will contain the value current at the time of signing the contract:
Request
GET /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "1b4f4c15efe44f04bcd52e5db833077a",
"contractID": "UA-2023-10-10-000002-a-3",
"period": {
"startDate": "2023-10-15T00:00:00+03:00",
"endDate": "2023-12-31T23:59:59+03:00"
},
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contract_owner": "broker6",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "b86d98f551fa49dfa9004373a996b627",
"contractTemplateName": "00000000.0002.01",
"status": "active",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/documents/e7d826dbc2944bb6bba19f45034deddd?download=acdee3c5fbb14da0b63000963dea8a81",
"documentOf": "contract",
"id": "e7d826dbc2944bb6bba19f45034deddd",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/documents/7f7d3898f20743798bf86ef67bf260d6?download=9dc6bfe4683b4e63a799bbe366ba9376",
"documentOf": "contract",
"documentType": "contractSignature",
"id": "7f7d3898f20743798bf86ef67bf260d6",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "supplier"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/documents/22ad6fee7d0042aaa9a1d88e22bf9d67?download=9dc6bfe4683b4e63a799bbe366ba9376",
"documentOf": "contract",
"documentType": "contractSignature",
"id": "22ad6fee7d0042aaa9a1d88e22bf9d67",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "buyer"
}
],
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateSigned": "2023-10-10T01:00:00+03:00",
"changes": [
{
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"priceReduction"
],
"modifications": {
"value": {
"amount": 535.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 490.0
}
},
"id": "68db49ecd6ef439a81feaec69cd6ab07",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"author": "supplier",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_change.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07/documents/88962047c28144d99916ae75c9a2a38a?download=33830e473a1348d6a5a7e4eb3379672d",
"documentOf": "change",
"id": "88962047c28144d99916ae75c9a2a38a",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
},
{
"confidentiality": "public",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"hash": "md5:00000000000000000000000000000000",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07/documents/c681b342eb664c3ab671f50a68860c14?download=9dc6bfe4683b4e63a799bbe366ba9376",
"documentOf": "change",
"documentType": "contractSignature",
"id": "c681b342eb664c3ab671f50a68860c14",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "supplier"
},
{
"confidentiality": "public",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"hash": "md5:00000000000000000000000000000000",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/68db49ecd6ef439a81feaec69cd6ab07/documents/dbfd77f646e24646b486c9993d548773?download=9dc6bfe4683b4e63a799bbe366ba9376",
"documentOf": "change",
"documentType": "contractSignature",
"id": "dbfd77f646e24646b486c9993d548773",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "buyer"
}
],
"dateSigned": "2023-10-10T01:00:00+03:00"
},
{
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"durationExtension"
],
"modifications": {
"period": {
"endDate": "2027-01-01T00:00:00+02:00",
"startDate": "2023-10-15T00:00:00+03:00"
}
},
"id": "e3b63c3aac354f6db3fbc8f25d03cc7d",
"status": "cancelled",
"date": "2023-10-10T01:00:00+03:00",
"author": "supplier",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_change.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/e3b63c3aac354f6db3fbc8f25d03cc7d/documents/9471624212664412824822e912a743df?download=33830e473a1348d6a5a7e4eb3379672d",
"documentOf": "change",
"id": "9471624212664412824822e912a743df",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
}
],
"cancellations": [
{
"reason": "not actual change",
"reasonType": "requiresChanges",
"id": "4f8c5f34f0e34e2fad07dce1798124e2",
"dateCreated": "2023-10-10T01:00:00+03:00",
"status": "active",
"author": "supplier"
}
]
}
],
"id": "38891909c9274c02b0bdca60fa5d2260"
},
"config": {
"restricted": false
}
}
Items length change
There is an opportunity to change length of items during contract is active using changes.
It is allowed to add new items, but the main fields should be the same as in one of previous item in contact.
Fields that can not be changed:
classification
relatedLot
relatedBuyer
additionalClassifications
Let’s try to add new item with new classification and we will see an error:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"itemPriceChange"
],
"modifications": {
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
},
{
"description": "Картон ручного виготовлення",
"quantity": 10.0,
"classification": {
"id": "22992000-0",
"scheme": "ДК021",
"description": "Папір або картон ручного виготовлення"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
}
]
}
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Forbidden to add new items main information in contract, all main fields should be the same as in previous items: classification, relatedLot, relatedBuyer, additionalClassifications"
}
]
}
For example, we can split first item into two new items.
But there is still a validation for unit prices of all items:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"itemPriceChange"
],
"modifications": {
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
},
{
"description": "Додаткове комп’ютерне обладнання",
"quantity": 20,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 2,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
}
]
}
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "items",
"description": "Total amount of unit values must be no more than contract.value.amount and no less than net contract amount"
}
]
}
Let’s update quantity in first item and add new item with correct unit.value:
Request
POST /api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes?acc_token=8ff3555ff5734dac917f580f1d09995a HTTP/1.0
Authorization: Bearer broker6
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"itemPriceChange"
],
"modifications": {
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 9,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
},
{
"description": "Додаткове комп’ютерне обладнання",
"quantity": 20,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 2,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
}
]
}
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"rationale": "причина зміни укр",
"rationale_en": "change cause en",
"rationaleTypes": [
"itemPriceChange"
],
"modifications": {
"items": [
{
"id": "29cbde01600848de837efe5448e726fb",
"description": "Комп’ютерне обладнання для біда",
"quantity": 9.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "24726f3002834ed287ec1c07b91606cf",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 20.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
},
{
"id": "76134ffb707f4949ba496e4ac0cfec1c",
"description": "Додаткове комп’ютерне обладнання",
"quantity": 20.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 2.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
}
]
},
"id": "5a6edb03ef214eb1a35197f1ff71ae91",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"author": "supplier",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_change.pdf",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38891909c9274c02b0bdca60fa5d2260/changes/5a6edb03ef214eb1a35197f1ff71ae91/documents/0cb36779b6aa4253ac5e76601c1ad586?download=33830e473a1348d6a5a7e4eb3379672d",
"documentOf": "change",
"id": "0cb36779b6aa4253ac5e76601c1ad586",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"documentType": "contractNotice"
}
]
}
}