Туторіал
Загальна картина
Процес визначення переможця відбувається на майданчиках 1-4 рівнів акредитації.
Процес електронного контракту відбувається на майданчиках 6 рівня акредитації.
Передумови
Вимоги до тендеру
Для електронних контрактів тендер має відповідати наступним вимогам
має бути обрано шаблон договору за допомогою поля contractTemplateName в тендері
має бути обраним майданчик 6 рівня акредитації для замовників та постачальників
Розглянемо детальніше вимоги щодо тендеру.
Шаблон договору
Поле contractTemplateName має бути обов’язково обрано на етапі створення тендеру (більше тут Надання проекту договору)
Це поле визначає шаблон договору, який буде використано для створення 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"
}
}
Як бачимо, майданчик вказано правильно.
Створення договору
Нехай у нас відбулась закупівля і є переможець. Після вибору перможця автоматично створюється контракт в закупівлі з обмеженим набором полів(id, awardID, status, date, value) та в системі договорів з повним набором полів(EContract) у статусі pending.
Договір створюється з додатковими полями:
contractTemplateName - копіюється з закупівлі, якщо вона встановлена (більше про це в Надання проекту договору)
period - startDate дорівнює dateCreated контракту + 5 календарних днів, endDate дорівнює кінець року, що вказаний у startDate
Договір PQ створюється з додатковими полями:
attributes - формується з вимог та відповідей на вимоги у закупівлі
Також, PDF документ створюється на основі шаблону (contractTemplateName) та автоматично прикріплюється до договору з documentType contractNotice.
Цей документ буде потрібен для підписання як постачальником, так і замовником пізніше, щоб активувати договір.
Отримання договору
Договір в системі закупівель
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
}
}
}
Ідентифікатор `id` договору однаковий в системах закупівель та договорів.
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"
}
}
Спробуємо отримати створений об’єкт по URL:
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
}
}
Отримання доступу
Для отримання доступу для замовника або постачальника використовується ендпоінт contracts/{contract_id}/access після ствворення контракту.
Алгоритм отримання доступу:
POST /access з індентифікатором клієнта - повертає токен для клієнта
Треба зробити POST /access - запит з індентифікатором клієнта, по якому визначається чи це buyer чи 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-EDR",
"id": "123456780"
}
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Invalid identifier"
}
]
}
Якщо індентифікатор знайшло, після цього відбувається валідація чи підходить майданчик, з якого робиться запит для цієї ролі:
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"
}
]
}
Якщо індентифікатор знайшло і owner підходить, то сетапиться токен відповідно до сутності для постачальника або замовника:
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"
}
}
Якщо замовник запитує доступ, то у відповіді також буде згенерований новий transfer токен.
Після генерації токену все ще дозволено перегенерувати токен, тому можна робити нові POST запити з цим ідентифікатором:
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: Тепер користувачу дозволено редагувати контракт як замовник тільки використовуючи останній згенерований токен.
Після того, як токен був перегенерований, попередній токен при редагуванні контракту вже не можна буде використати:
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"
}
]
}
Такий самий алгоритм і для отримання доступу постачальником.
Запросимо доступ для постачальника:
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: Отримання доступів дозволено тільки під час pending контракту.
Реєстрація договору
Якщо контракт був створений за правилами електронного контрактингу за новим флоу зі встановленними майданчиками для постачальника та замовника ще під час закупівлі, то для активації такого контракту обов’язковими є заповнення інформації підписантів та додавання підписів всіх учасників.
Для того, щоб активувати контракт, потрібно замовнику та постачальнику додати в якості документів електронні підписи.
Вимоги до підпису:
Має бути підписаний документ договору з documentType contractNotice
Файл підпису має бути прикріплений до договору з documentType contractSignature
Підпис повинен мати наступні параметри:
Формат підпису: CAdES-X Long
Алгоритм підпису: ДСТУ 4145
Тип підпису: Підпис та дані в окремих файлах (detached)
Діаграма процесу підписання:
Після того, як будуть накладені два підписи на поточну весрію контракту, контракт стає active.
Постачальник додає документ підпису використовуючи свій токен (supplier_token), який він отримав при запиті доступу:
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_token), який він отримав при запиті доступу:
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"
}
}
Коли обидва підписа є у системі, то система підтверджує, що контракт підписано і активує його:
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
}
}
Нові версії договору
Якщо одна зі сторін договору не погоджується підписувати поточну версію контракту, існує можливість створити нову версію контракту, змінивши деякі поля.
Етапи:
скасування попереднього контракту
створення нової версії зі змінами (POST)
підписання нової версії і очікування поки друга сторона погодиться підписати дану версію (або створення нової версії контракту вже іншою стороною)
Скасування
Інсує можливість скасування поточної версії контракту та створення нової тільки поки контракт знаходиться в статусі pending.
Для того, щоб скасувати контракт, учасник договору має додати об’єкт cancellation обов’язково вказавши причину скасування 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"
}
}
Подивимося на договір:
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
}
}
Заборонено додавати більше ніж один 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"
}
]
}
Після того, як додано cancellation, підписувати цю версію контракту вже заборонено:
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"
}
]
}
Створення нової версії договору
Після скасування будь-який учасник має створити нову версію контракту, використовуючи свій токен.
Сторона, яка створює нову версію може змінити наступні поля:
period
contractNumber
items.unit
items.quantity
value
title
title_en
description
description_en
dateSigned
signerInfo (інформацію про підписанта своєї сторони)
Якщо учасник намагається змінити якесь інше поле, то він побачить помилку:
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"
}
]
}
Змінемо наступні поля period та signerInfo.name, використовуючи токен замовника:
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
}
}
Успіх! Подивимося на попередню версію контракту, в нього статус тепер cancelled і cancellation тепер має статус 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
}
}
Подивимося на всі контракти в закупівлі:
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
}
}
]
}
Після цього починається новий етап підписання.
Замовник та постачальник можуть підписати нову версію договору, якщо їх влаштовують зміни або створити нову версію, якщо треба ще щось змінити.
Скасування електронного договору
Договір можна скасувати, поки він в статусі pending.
При створенні скасування договору можна обрати одну з двох причини скасування:
requiresChanges
signingRefusal
Причина скасування requiresChanges використовується, якщо одна зі сторін договору не погоджується підписувати поточну версію контракту і є необхідність створити нову версію контракту, змінивши деякі поля. Детально описано в Нові версії договору.
Причина скасування signingRefusal використовується, якщо переможець процедури закупівлі відмовився від підписання договору про закупівлю відповідно до вимог тендерної документації або укладення договору про закупівлю. В цьому випадку авард переможця має бути скасований.
Підписант (замовник/постачальник) може створити cancellation з причиною reasonType = 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"
}
}
Подивимося на договір:
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
}
}
Після цього замовник скасовує переможця - award змінює статус на cancelled:
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
}
}
Подивимося на контракт ще раз і побачимо, що в нього статус тепер cancelled і cancellation тепер має статус 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
}
}
Подивимося на закупівлю, переможець скасований і підтвердження кваліфікації продовужється (статус закупівлі знову active.qualification):
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
}
}
Додаткові угоди (зміни) в EContract
Зміни в умови контрактів можуть бути внесені підписантами через подання і підписання додаткових угод. В системі використовується термінологія «змін» / «changes».
Ініціатором внесення змін може бути обидва замовник і постачальник.
Ініціатор заповнює три обов’язкових поля:
- rationale:
string, причина змін
- rationaleTypes:
list, типи причин
- modifications:
object, нові значення в електронних полях
modifications це структура, що відображає зміни в електроних поля, які буде внесено:
- title:
string
- title_en:
string
- description:
string
- description_en:
string
- period:
-
Дата початку та кінця договору.
- items:
List of Item objects
- value:
ContractValue object
- contractNumber:
string
Зміни можна вносити тільки в підписані контракти:
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"
}
]
}
Створення додаткових угод
Запит створення пропозиції змін:
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"
}
]
}
}
Для деяких полів договору існують валідації (такі самі як і були при PATCH для активного договору),
Наприклад, якщо замовник вирішив змінити валюту в 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"
}
]
}
Наприклад, якщо постачальник вирішив змінити період договору на неправильну дату:
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"
}
]
}
Підписання змін
Для того, щоб активувати зміни, потрібно замовнику та постачальнику додати в якості документів електронні підписи.
Після того, як будуть накладені два підписи на зміни, зміни стають active.
Постачальник додає документ підпису використовуючи свій токен (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_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"
}
}
Коли обидва підписа є у системі, то система підтверджує, що зміни підписано і активує їх:
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"
}
}
Скасування
Сторони можуть скасовувати дод. угоди, якщо вони неактуальні, надавши коментар.
Створимо ще одну додаткову угоду:
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"
}
]
}
}
Для того, щоб скасувати угоду, учасник договору має додати об’єкт 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 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"
}
}
Подивимося на додаткову угоду:
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"
}
]
}
}
Заборонено додавати більше ніж один 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"
}
]
}
Після того, як додано cancellation, підписувати цю додаткову угоду вже заборонено:
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"
}
]
}
Підписання додаткових угод не змінює електронні поля самого контракту. Тобто якщо, наприклад, вартість контракту було змінено додатковою угодою, то в changes буде актуальне значення, а в контракті - актуальне на момент підписання контракту.
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 в активному статусі контракту через changes.
Дозволяється додавати новий item, але при цьому основні поля мають відповідати попереднім значенням в масиві items.
Поля, які не можна змінювати:
classification
relatedLot
relatedBuyer
additionalClassifications
Спробуємо додати новий item з новим полем classification і побачимо помилку:
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"
}
]
}
Наприклад, розділимо перший item на дві номенклатури з такими самими основними полями.
Але при цьому все ще існує валідація на суму цін за одиницю для всіх 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"
}
]
}
Відредагуємо quantity в першому item і додамо новий item з коректною ціною 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"
}
]
}
}