Tutorial
Configuration
The set of possible configuration values:
name |
values |
default |
days |
|---|---|---|---|
hasAuction |
false |
false |
|
hasAwardingOrder |
true |
true |
|
hasValueRestriction |
true |
true |
|
valueCurrencyEquality |
true |
true |
|
hasPrequalification |
false |
false |
|
minBidsNumber |
1 |
1 |
|
hasPreSelectionAgreement |
true |
true |
|
hasTenderComplaints |
false |
false |
|
hasAwardComplaints |
false |
false |
|
hasCancellationComplaints |
false |
false |
|
hasValueEstimation |
true |
true |
|
hasQualificationComplaints |
false |
false |
|
tenderComplainRegulation |
0 |
0 |
|
qualificationComplainDuration |
0 |
0 |
|
awardComplainDuration |
0 |
0 |
|
cancellationComplainDuration |
0 |
0 |
|
clarificationUntilDuration |
0 |
0 |
|
qualificationDuration |
0 |
0 |
|
minTenderingDuration |
2 |
2 |
working |
hasEnquiries |
false |
false |
|
minEnquiriesDuration |
0 |
0 |
|
enquiryPeriodRegulation |
0 |
0 |
|
restricted |
true / false |
false |
You can look for more details in Configuration section.
Creating tender
Let’s provide the data attribute in the submitted body :
Request
POST /api/2.5/tenders?opt_pretty=1 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": "00037200",
"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": "Генеральний директор"
}
},
"value": {
"amount": 22000,
"currency": "UAH"
},
"tenderPeriod": {
"endDate": "2024-01-15T00:00:00+02:00"
},
"procurementMethodType": "priceQuotation",
"procurementMethod": "selective",
"items": [
{
"description": "Комп’ютерне обладнання",
"category": "655360-30230000-889652",
"profile": "655360-30230000-889652-40000777",
"quantity": 5,
"deliveryDate": {
"startDate": "2024-01-03T00:00:00+02:00",
"endDate": "2024-01-06T00:00:00+02: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": "30c4edcb5705460a9ca5fd7985bfe56c"
}
],
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"contractTemplateName": "00000000.0002.01",
"criteria": [
{
"title": "Технічні, якісні та кількісні характеристики предмета закупівлі",
"description": "Технічна специфікація повинна містити опис усіх необхідних характеристик товарів, робіт або послуг, що закуповуються, у тому числі їх технічні, функціональні та якісні характеристики. Характеристики товарів, робіт або послуг можуть містити опис конкретного технологічного процесу або технології виробництва чи порядку постачання товару (товарів), виконання необхідних робіт, надання послуги (послуг)",
"source": "tenderer",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
},
"relatesTo": "item",
"legislation": [
{
"version": "2024-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1398"
},
"type": "NATIONAL_LEGISLATION",
"article": "22.2.3"
},
{
"version": "2024-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1426"
},
"type": "NATIONAL_LEGISLATION",
"article": "23"
},
{
"version": "2023-10-31",
"identifier": {
"id": "1135-2023-п",
"legalName": "Про внесення змін до постанов Кабінету Міністрів України від 14 вересня 2020 р. № 822 і від 12 жовтня 2022 р. № 1178",
"uri": "https://zakon.rada.gov.ua/laws/show/1135-2023-%D0%BF#n24"
},
"type": "NATIONAL_LEGISLATION",
"article": "2.1"
}
],
"requirementGroups": [
{
"description": "Підтверджується, що",
"requirements": [
{
"title": "Діагональ екрану",
"dataType": "number",
"minValue": 23.8,
"unit": {
"code": "INH",
"name": "дюйм"
}
},
{
"title": "Роздільна здатність",
"dataType": "string",
"expectedValues": [
"1920x1080"
],
"expectedMinItems": 1
},
{
"title": "Співвідношення сторін",
"dataType": "string",
"expectedValues": [
"16:9"
],
"expectedMinItems": 1
},
{
"title": "Яскравість дисплея",
"dataType": "integer",
"minValue": 0,
"maxValue": 250,
"unit": {
"code": "A24",
"name": "кд/м²"
}
},
{
"title": "Контрастність (статична)",
"dataType": "string",
"expectedValues": [
"1000:1"
],
"expectedMinItems": 1
},
{
"title": "Кількість портів HDMI",
"dataType": "integer",
"minValue": 1,
"unit": {
"code": "H87",
"name": "штук"
}
},
{
"title": "Кількість портів D-sub",
"dataType": "integer",
"minValue": 1,
"unit": {
"code": "H87",
"name": "штук"
}
},
{
"title": "Кабель для під’єднання",
"dataType": "string",
"expectedValues": [
"HDMI"
],
"expectedMinItems": 1
},
{
"title": "Гарантія",
"dataType": "integer",
"minValue": 36,
"unit": {
"code": "MON",
"name": "місяців"
}
}
]
}
],
"relatedItem": "30c4edcb5705460a9ca5fd7985bfe56c"
}
]
},
"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/3f38940af1314712ac29867b3e4eced4
{
"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": "2024-01-15T00:00:00+02:00",
"startDate": "2024-01-01T00:00:00+02:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037200",
"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": "Статут компанії"
},
"kind": "general"
},
"items": [
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2024-01-03T00:00:00+02:00",
"endDate": "2024-01-06T00:00:00+02: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": "dc2946c9a6cc47b9bd3b196fe2b0369c",
"description": "Технічна специфікація повинна містити опис усіх необхідних характеристик товарів, робіт або послуг, що закуповуються, у тому числі їх технічні, функціональні та якісні характеристики. Характеристики товарів, робіт або послуг можуть містити опис конкретного технологічного процесу або технології виробництва чи порядку постачання товару (товарів), виконання необхідних робіт, надання послуги (послуг)",
"source": "tenderer",
"relatesTo": "item",
"relatedItem": "30c4edcb5705460a9ca5fd7985bfe56c",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
},
"title": "Технічні, якісні та кількісні характеристики предмета закупівлі",
"legislation": [
{
"version": "2024-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1398"
},
"type": "NATIONAL_LEGISLATION",
"article": "22.2.3"
},
{
"version": "2024-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1426"
},
"type": "NATIONAL_LEGISLATION",
"article": "23"
},
{
"version": "2023-10-31",
"identifier": {
"id": "1135-2023-п",
"legalName": "Про внесення змін до постанов Кабінету Міністрів України від 14 вересня 2020 р. № 822 і від 12 жовтня 2022 р. № 1178",
"uri": "https://zakon.rada.gov.ua/laws/show/1135-2023-%D0%BF#n24"
},
"type": "NATIONAL_LEGISLATION",
"article": "2.1"
}
],
"requirementGroups": [
{
"id": "e87c44abe0ee40ffbc5e96da1cb2c7ad",
"description": "Підтверджується, що",
"requirements": [
{
"id": "8cac9e406b954b80b22aec9a77e63593",
"title": "Діагональ екрану",
"dataType": "number",
"status": "active",
"unit": {
"code": "INH",
"name": "дюйм"
},
"minValue": 23.8,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "17d57e334aed49d19de4fd5b27b3b314",
"title": "Роздільна здатність",
"dataType": "string",
"status": "active",
"expectedValues": [
"1920x1080"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "08ac3b62c1114ed1918bbde211047916",
"title": "Співвідношення сторін",
"dataType": "string",
"status": "active",
"expectedValues": [
"16:9"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "0cbbfa2735324fe8bd172bfe98510c39",
"title": "Яскравість дисплея",
"dataType": "integer",
"status": "active",
"unit": {
"code": "A24",
"name": "кд/м²"
},
"minValue": 0,
"maxValue": 250,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "6b78fd178786471ebff1faf01277c285",
"title": "Контрастність (статична)",
"dataType": "string",
"status": "active",
"expectedValues": [
"1000:1"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "6d027700fb9646968fed97d3291e487a",
"title": "Кількість портів HDMI",
"dataType": "integer",
"status": "active",
"unit": {
"code": "H87",
"name": "штук"
},
"minValue": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "ce5247fff13a4a5bb8cc27b5c9edc972",
"title": "Кількість портів D-sub",
"dataType": "integer",
"status": "active",
"unit": {
"code": "H87",
"name": "штук"
},
"minValue": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "3a028e0e6ea34ccebfcd214944fb439a",
"title": "Кабель для під’єднання",
"dataType": "string",
"status": "active",
"expectedValues": [
"HDMI"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "68f8023f5da1456789a9b355f67022f9",
"title": "Гарантія",
"dataType": "integer",
"status": "active",
"unit": {
"code": "MON",
"name": "місяців"
},
"minValue": 36,
"datePublished": "2024-01-01T00:00:00+02:00"
}
]
}
]
}
],
"tenderID": "UA-2024-01-01-000001-a",
"owner": "broker",
"date": "2024-01-01T00:00:00+02:00",
"dateCreated": "2024-01-01T00:00:00+02:00",
"dateModified": "2024-01-01T00:00:00+02:00",
"id": "3f38940af1314712ac29867b3e4eced4"
},
"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": "3f07ab10456e4f519a3cf51c24d19c80",
"transfer": "e92a5b619eb1406ba559e4ec7c1d9dfe"
}
}
Success! Now we can see that new object was created. Response code is 201 and Location response header reports the location of the created object. The body of response reveals the information about the created tender: its internal id (that matches the Location segment), its official tenderID and dateModified datestamp stating the moment in time when tender was last modified. Note that tender is created with draft status.
Note
User receives access: token with which operations as a Procuring Entity role are accessible.
Price Quotation procedure has procurementMethodType: priceQuotation and procurementMethod: selective.
Let’s access the URL of the created object (the Location header of the response):
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4 HTTP/1.0
Authorization: Bearer broker
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": "draft",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"endDate": "2024-01-15T00:00:00+02:00",
"startDate": "2024-01-01T00:00:00+02:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037200",
"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": "Статут компанії"
},
"kind": "general"
},
"items": [
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2024-01-03T00:00:00+02:00",
"endDate": "2024-01-06T00:00:00+02: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": "dc2946c9a6cc47b9bd3b196fe2b0369c",
"description": "Технічна специфікація повинна містити опис усіх необхідних характеристик товарів, робіт або послуг, що закуповуються, у тому числі їх технічні, функціональні та якісні характеристики. Характеристики товарів, робіт або послуг можуть містити опис конкретного технологічного процесу або технології виробництва чи порядку постачання товару (товарів), виконання необхідних робіт, надання послуги (послуг)",
"source": "tenderer",
"relatesTo": "item",
"relatedItem": "30c4edcb5705460a9ca5fd7985bfe56c",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
},
"title": "Технічні, якісні та кількісні характеристики предмета закупівлі",
"legislation": [
{
"version": "2024-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1398"
},
"type": "NATIONAL_LEGISLATION",
"article": "22.2.3"
},
{
"version": "2024-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1426"
},
"type": "NATIONAL_LEGISLATION",
"article": "23"
},
{
"version": "2023-10-31",
"identifier": {
"id": "1135-2023-п",
"legalName": "Про внесення змін до постанов Кабінету Міністрів України від 14 вересня 2020 р. № 822 і від 12 жовтня 2022 р. № 1178",
"uri": "https://zakon.rada.gov.ua/laws/show/1135-2023-%D0%BF#n24"
},
"type": "NATIONAL_LEGISLATION",
"article": "2.1"
}
],
"requirementGroups": [
{
"id": "e87c44abe0ee40ffbc5e96da1cb2c7ad",
"description": "Підтверджується, що",
"requirements": [
{
"id": "8cac9e406b954b80b22aec9a77e63593",
"title": "Діагональ екрану",
"dataType": "number",
"status": "active",
"unit": {
"code": "INH",
"name": "дюйм"
},
"minValue": 23.8,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "17d57e334aed49d19de4fd5b27b3b314",
"title": "Роздільна здатність",
"dataType": "string",
"status": "active",
"expectedValues": [
"1920x1080"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "08ac3b62c1114ed1918bbde211047916",
"title": "Співвідношення сторін",
"dataType": "string",
"status": "active",
"expectedValues": [
"16:9"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "0cbbfa2735324fe8bd172bfe98510c39",
"title": "Яскравість дисплея",
"dataType": "integer",
"status": "active",
"unit": {
"code": "A24",
"name": "кд/м²"
},
"minValue": 0,
"maxValue": 250,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "6b78fd178786471ebff1faf01277c285",
"title": "Контрастність (статична)",
"dataType": "string",
"status": "active",
"expectedValues": [
"1000:1"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "6d027700fb9646968fed97d3291e487a",
"title": "Кількість портів HDMI",
"dataType": "integer",
"status": "active",
"unit": {
"code": "H87",
"name": "штук"
},
"minValue": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "ce5247fff13a4a5bb8cc27b5c9edc972",
"title": "Кількість портів D-sub",
"dataType": "integer",
"status": "active",
"unit": {
"code": "H87",
"name": "штук"
},
"minValue": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "3a028e0e6ea34ccebfcd214944fb439a",
"title": "Кабель для під’єднання",
"dataType": "string",
"status": "active",
"expectedValues": [
"HDMI"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "68f8023f5da1456789a9b355f67022f9",
"title": "Гарантія",
"dataType": "integer",
"status": "active",
"unit": {
"code": "MON",
"name": "місяців"
},
"minValue": 36,
"datePublished": "2024-01-01T00:00:00+02:00"
}
]
}
]
}
],
"tenderID": "UA-2024-01-01-000001-a",
"owner": "broker",
"date": "2024-01-01T00:00:00+02:00",
"dateCreated": "2024-01-01T00:00:00+02:00",
"dateModified": "2024-01-01T00:00:00+02:00",
"id": "3f38940af1314712ac29867b3e4eced4"
},
"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
}
}
We can see the same response we got after creating tender.
Modifying tender
Procuring Entity can modify tender before publishing. Let’s update tender by supplementing it with all other essential properties:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"startDate": "2024-01-01T00:00:00+02:00",
"endDate": "2024-01-16T00:00:11+02:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"contractTemplateName": "00000000.0002.01",
"date": "2024-01-01T00:00:00+02:00",
"dateModified": "2024-01-01T00:00:01+02:00",
"dateCreated": "2024-01-01T00:00:00+02:00",
"tenderID": "UA-2024-01-01-000001-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2024-01-01T00:00:00+02:00",
"endDate": "2024-01-16T00:00:11+02:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037200",
"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": "Статут компанії"
},
"kind": "general"
},
"items": [
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2024-01-03T00:00:00+02:00",
"endDate": "2024-01-06T00:00:00+02: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": "dc2946c9a6cc47b9bd3b196fe2b0369c",
"description": "Технічна специфікація повинна містити опис усіх необхідних характеристик товарів, робіт або послуг, що закуповуються, у тому числі їх технічні, функціональні та якісні характеристики. Характеристики товарів, робіт або послуг можуть містити опис конкретного технологічного процесу або технології виробництва чи порядку постачання товару (товарів), виконання необхідних робіт, надання послуги (послуг)",
"source": "tenderer",
"relatesTo": "item",
"relatedItem": "30c4edcb5705460a9ca5fd7985bfe56c",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
},
"title": "Технічні, якісні та кількісні характеристики предмета закупівлі",
"legislation": [
{
"version": "2024-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1398"
},
"type": "NATIONAL_LEGISLATION",
"article": "22.2.3"
},
{
"version": "2024-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1426"
},
"type": "NATIONAL_LEGISLATION",
"article": "23"
},
{
"version": "2023-10-31",
"identifier": {
"id": "1135-2023-п",
"legalName": "Про внесення змін до постанов Кабінету Міністрів України від 14 вересня 2020 р. № 822 і від 12 жовтня 2022 р. № 1178",
"uri": "https://zakon.rada.gov.ua/laws/show/1135-2023-%D0%BF#n24"
},
"type": "NATIONAL_LEGISLATION",
"article": "2.1"
}
],
"requirementGroups": [
{
"id": "e87c44abe0ee40ffbc5e96da1cb2c7ad",
"description": "Підтверджується, що",
"requirements": [
{
"id": "8cac9e406b954b80b22aec9a77e63593",
"title": "Діагональ екрану",
"dataType": "number",
"status": "active",
"unit": {
"code": "INH",
"name": "дюйм"
},
"minValue": 23.8,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "17d57e334aed49d19de4fd5b27b3b314",
"title": "Роздільна здатність",
"dataType": "string",
"status": "active",
"expectedValues": [
"1920x1080"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "08ac3b62c1114ed1918bbde211047916",
"title": "Співвідношення сторін",
"dataType": "string",
"status": "active",
"expectedValues": [
"16:9"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "0cbbfa2735324fe8bd172bfe98510c39",
"title": "Яскравість дисплея",
"dataType": "integer",
"status": "active",
"unit": {
"code": "A24",
"name": "кд/м²"
},
"minValue": 0,
"maxValue": 250,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "6b78fd178786471ebff1faf01277c285",
"title": "Контрастність (статична)",
"dataType": "string",
"status": "active",
"expectedValues": [
"1000:1"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "6d027700fb9646968fed97d3291e487a",
"title": "Кількість портів HDMI",
"dataType": "integer",
"status": "active",
"unit": {
"code": "H87",
"name": "штук"
},
"minValue": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "ce5247fff13a4a5bb8cc27b5c9edc972",
"title": "Кількість портів D-sub",
"dataType": "integer",
"status": "active",
"unit": {
"code": "H87",
"name": "штук"
},
"minValue": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "3a028e0e6ea34ccebfcd214944fb439a",
"title": "Кабель для під’єднання",
"dataType": "string",
"status": "active",
"expectedValues": [
"HDMI"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "68f8023f5da1456789a9b355f67022f9",
"title": "Гарантія",
"dataType": "integer",
"status": "active",
"unit": {
"code": "MON",
"name": "місяців"
},
"minValue": 36,
"datePublished": "2024-01-01T00:00:00+02:00"
}
]
}
]
}
],
"id": "3f38940af1314712ac29867b3e4eced4"
},
"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
}
}
We see the added properties have merged with existing tender data. Additionally, the dateModified property was updated to reflect the last modification datestamp.
Checking the listing again reflects the new modification date:
Request
GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2024-01-01T00:00:01+02:00",
"id": "3f38940af1314712ac29867b3e4eced4"
}
],
"next_page": {
"offset": "1704060001.0.1.711c70254848796dce076768becfdfcf",
"path": "/api/2.5/tenders?offset=1704060001.0.1.711c70254848796dce076768becfdfcf",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1704060001.0.1.711c70254848796dce076768becfdfcf"
}
}
Publishing tender (deprecated)
After creation Procuring Entity publishes procedure by changing status to draft.publishing where priceQuotationBot robot runs validation of the procedure and supplement procedure with additional data taken from ProZorro e-Catalogues database including shortListedFirms.
Request
PATCH /api/2.5/tenders/8fc54d118a544ade91d3c28d8c89affb?acc_token=5bc846d5687141fa9b6e6dda2122dd32 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "draft.publishing"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft.publishing",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "d53c5a78817b4eec8047b872c498f3f4",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "0fd8fe3ac5e54feaa5c06745409e51de",
"requirementGroups": [
{
"id": "f6fe4520f6ff4e29893ab28f0c17cc7b",
"description": "Форма випуску",
"requirements": [
{
"id": "02caab74423640f0a94a9af6650aac03",
"title": "Форма випуску",
"dataType": "string",
"status": "active",
"expectedValue": "Розчин для інфузій",
"datePublished": "2023-09-20T01:00:00+03:00"
}
]
}
],
"title": "Форма випуску",
"description": "Форма випуску"
},
{
"id": "97a3f8c96cc74e768bee16aff66e9370",
"requirementGroups": [
{
"id": "02e99658730d4e3eb284888785d470c4",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "d7e840f22c984693a3184aafb358d083",
"title": "Доза діючої речовини",
"dataType": "integer",
"status": "active",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5,
"datePublished": "2023-09-20T01:00:00+03:00"
}
]
}
],
"title": "Доза діючої речовини",
"description": "Доза діючої речовини"
},
{
"id": "b8cb4beee31b4884bebf4b68ad089cc5",
"requirementGroups": [
{
"id": "e75ca60c2bc4400f9feb15e4191a0dca",
"description": "Форма випуску",
"requirements": [
{
"id": "4926ebc3da25439e881462b5727de938",
"title": "Форма випуску",
"dataType": "string",
"status": "active",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3,
"datePublished": "2023-09-20T01:00:00+03:00"
}
]
}
],
"title": "Форма випуску",
"description": "Форма випуску"
}
],
"noticePublicationDate": "2023-09-20T01:00:00+03:00",
"id": "8fc54d118a544ade91d3c28d8c89affb"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
After successful validation priceQuotationBot transmit procedure to status: active.tendering
Request
GET /api/2.5/tenders/8fc54d118a544ade91d3c28d8c89affb HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "active.tendering",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"shortlistedFirms": [
{
"name": "Товариство з обмеженою відповідальністю «Пікселі»",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Товариство з обмеженою відповідальністю «Пікселі»"
},
"address": {
"streetAddress": "бул.Дружби Народів, 8",
"locality": "м.Київ",
"region": "Київська область",
"postalCode": "01100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Оксана Піксель",
"email": "contact@pixel.pix",
"telephone": "+0671234567"
},
"scale": "large",
"id": "UA-EDR-12345678",
"status": "active"
},
{
"name": "Товариство з обмеженою відповідальністю «Штекер-Пекер»",
"identifier": {
"scheme": "UA-EDR",
"id": "87654321",
"legalName": "Товариство з обмеженою відповідальністю «Штекер-Пекер»"
},
"address": {
"streetAddress": "вул. Кластерна, 777-К",
"locality": "м.Тернопіль",
"region": "Тернопільська область",
"postalCode": "46000",
"countryName": "Україна"
},
"contactPoint": {
"name": "Олег Штекер",
"email": "info@shteker.pek",
"telephone": "+0951234567"
},
"scale": "large",
"id": "UA-EDR-87654321",
"status": "active"
}
],
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"noticePublicationDate": "2023-09-20T01:00:00+03:00",
"items": [
{
"id": "d53c5a78817b4eec8047b872c498f3f4",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "0fd8fe3ac5e54feaa5c06745409e51de",
"requirementGroups": [
{
"id": "f6fe4520f6ff4e29893ab28f0c17cc7b",
"description": "Форма випуску",
"requirements": [
{
"id": "02caab74423640f0a94a9af6650aac03",
"title": "Форма випуску",
"dataType": "string",
"status": "active",
"expectedValue": "Розчин для інфузій",
"datePublished": "2023-09-20T01:00:00+03:00"
}
]
}
],
"title": "Форма випуску",
"description": "Форма випуску"
},
{
"id": "97a3f8c96cc74e768bee16aff66e9370",
"requirementGroups": [
{
"id": "02e99658730d4e3eb284888785d470c4",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "d7e840f22c984693a3184aafb358d083",
"title": "Доза діючої речовини",
"dataType": "integer",
"status": "active",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5,
"datePublished": "2023-09-20T01:00:00+03:00"
}
]
}
],
"title": "Доза діючої речовини",
"description": "Доза діючої речовини"
},
{
"id": "b8cb4beee31b4884bebf4b68ad089cc5",
"requirementGroups": [
{
"id": "e75ca60c2bc4400f9feb15e4191a0dca",
"description": "Форма випуску",
"requirements": [
{
"id": "4926ebc3da25439e881462b5727de938",
"title": "Форма випуску",
"dataType": "string",
"status": "active",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3,
"datePublished": "2023-09-20T01:00:00+03:00"
}
]
}
],
"title": "Форма випуску",
"description": "Форма випуску"
}
],
"contractTemplateName": "00000000-0.0001.01",
"next_check": "2023-10-04T01:00:00+03:00",
"id": "8fc54d118a544ade91d3c28d8c89affb"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
In case if procedure do not pass validation due to invalid options, it will be switched to status: draft.unsuccessful by the priceQuotationBot.
Request
GET /api/2.5/tenders/3a30afeece164702acbcbd999c068e6c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000002-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft.unsuccessful",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "f8940cf415e64f08a9d6259db7146e2b",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777bad_profile"
}
],
"criteria": [
{
"id": "7f4c2bf22f634adfafb1ede8982e5322",
"requirementGroups": [
{
"id": "695a7849ca454580a6bdfc84b9301fcd",
"description": "Форма випуску",
"requirements": [
{
"id": "9ad67de704dc4175bef6da13ddd47995",
"title": "Форма випуску",
"dataType": "string",
"status": "active",
"expectedValue": "Розчин для інфузій",
"datePublished": "2023-09-20T01:00:00+03:00"
}
]
}
],
"title": "Форма випуску",
"description": "Форма випуску"
},
{
"id": "9d05220ef0854d4383f143a281abc38c",
"requirementGroups": [
{
"id": "44ca6a24def54878875c12faf8eba28a",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "d34c8fbfb0d1439e951e6f2ddbaac144",
"title": "Доза діючої речовини",
"dataType": "integer",
"status": "active",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5,
"datePublished": "2023-09-20T01:00:00+03:00"
}
]
}
],
"title": "Доза діючої речовини",
"description": "Доза діючої речовини"
},
{
"id": "0698def8382342068eef0b30c2415757",
"requirementGroups": [
{
"id": "c15d8c80af7e4dbb8df90269b767321c",
"description": "Форма випуску",
"requirements": [
{
"id": "428a0172e14841f5bc5137ca5d74411e",
"title": "Форма випуску",
"dataType": "string",
"status": "active",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3,
"datePublished": "2023-09-20T01:00:00+03:00"
}
]
}
],
"title": "Форма випуску",
"description": "Форма випуску"
}
],
"id": "3a30afeece164702acbcbd999c068e6c"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
Activating tender
After creation Procuring Entity can activate tender by changing status to active.tendering.
Before activating tender it is required to add sign document to tender. If there is no sign document during activation, we will see an error:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.tendering"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'notice' and format pkcs7-signature is required"
}
]
}
Sign document should have documentType: notice and title: *.p7s. Let’s add such document:
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/documents?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "sign.p7s",
"documentType": "notice",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/17fcf59747f74e2f91397a15ecb36c53?Signature=a7itndJn9sQrFIyWnCpHok6%2B%2FC2wMxdaDzN3DWWSQpqMi%2FVerOzlGHCHM0AME33ImTaz1bHEmdZs4XU2qmBoAw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "sign/pkcs7-signature"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/documents/e47110a516244ea3a12a10be4c5585f9
{
"data": {
"confidentiality": "public",
"documentType": "notice",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/17fcf59747f74e2f91397a15ecb36c53?Signature=VsT7Y9HMROGoWjJC%2FHlgpCTPfOJ0y7dPVkd%2BxJkiTSk3YgboJrkXPZp1iYoc%2Byu4bOiGoAc0cY5MUO3%2FbpGxCw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "e47110a516244ea3a12a10be4c5585f9",
"datePublished": "2024-01-01T00:00:01+02:00",
"dateModified": "2024-01-01T00:00:01+02:00",
"author": "tender_owner"
}
}
During activation CBD runs some validations:
Existence of item profile in catalogue
Profile should be active or general
Existence of related agreement
Equality of profile agreement and related agreement in tender
Agreement should not be in terminated status
If Procuring Entity will try to activate PQ procedure with non-existed profile in catalogue, we will see error:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.tendering"
}
}
Response
HTTP/1.0 404 Not Found
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Profiles 655360-30230000-889652-40000777 not found in catalouges."
}
]
}
If profile isn’t in active status, we will see error:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.tendering"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Profiles 655360-30230000-889652-40000777: hidden not in ('active',)"
}
]
}
In case profile agreement and related agreement in tender aren’t equal, the next error will be generated:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.tendering"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Tender agreement doesn't match profile agreement"
}
]
}
If agreement is in terminated status:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.tendering"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "agreement",
"description": "Agreement status is not active"
}
]
}
If PQ procedure matches all requirements, it will be switched to active.tendering:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.tendering"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"contractTemplateName": "00000000.0002.01",
"date": "2024-01-01T00:00:01+02:00",
"dateModified": "2024-01-01T00:00:01+02:00",
"dateCreated": "2024-01-01T00:00:00+02:00",
"tenderID": "UA-2024-01-01-000001-a",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "e47110a516244ea3a12a10be4c5585f9",
"datePublished": "2024-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/17fcf59747f74e2f91397a15ecb36c53?Signature=VsT7Y9HMROGoWjJC%2FHlgpCTPfOJ0y7dPVkd%2BxJkiTSk3YgboJrkXPZp1iYoc%2Byu4bOiGoAc0cY5MUO3%2FbpGxCw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2024-01-01T00:00:01+02:00",
"author": "tender_owner",
"language": "uk"
}
],
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "active.tendering",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-16T00:00:11+02:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037200",
"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": "Статут компанії"
},
"kind": "general"
},
"items": [
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2024-01-03T00:00:00+02:00",
"endDate": "2024-01-06T00:00:00+02: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": "dc2946c9a6cc47b9bd3b196fe2b0369c",
"description": "Технічна специфікація повинна містити опис усіх необхідних характеристик товарів, робіт або послуг, що закуповуються, у тому числі їх технічні, функціональні та якісні характеристики. Характеристики товарів, робіт або послуг можуть містити опис конкретного технологічного процесу або технології виробництва чи порядку постачання товару (товарів), виконання необхідних робіт, надання послуги (послуг)",
"source": "tenderer",
"relatesTo": "item",
"relatedItem": "30c4edcb5705460a9ca5fd7985bfe56c",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
},
"title": "Технічні, якісні та кількісні характеристики предмета закупівлі",
"legislation": [
{
"version": "2024-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1398"
},
"type": "NATIONAL_LEGISLATION",
"article": "22.2.3"
},
{
"version": "2024-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1426"
},
"type": "NATIONAL_LEGISLATION",
"article": "23"
},
{
"version": "2023-10-31",
"identifier": {
"id": "1135-2023-п",
"legalName": "Про внесення змін до постанов Кабінету Міністрів України від 14 вересня 2020 р. № 822 і від 12 жовтня 2022 р. № 1178",
"uri": "https://zakon.rada.gov.ua/laws/show/1135-2023-%D0%BF#n24"
},
"type": "NATIONAL_LEGISLATION",
"article": "2.1"
}
],
"requirementGroups": [
{
"id": "e87c44abe0ee40ffbc5e96da1cb2c7ad",
"description": "Підтверджується, що",
"requirements": [
{
"id": "8cac9e406b954b80b22aec9a77e63593",
"title": "Діагональ екрану",
"dataType": "number",
"status": "active",
"unit": {
"code": "INH",
"name": "дюйм"
},
"minValue": 23.8,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "17d57e334aed49d19de4fd5b27b3b314",
"title": "Роздільна здатність",
"dataType": "string",
"status": "active",
"expectedValues": [
"1920x1080"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "08ac3b62c1114ed1918bbde211047916",
"title": "Співвідношення сторін",
"dataType": "string",
"status": "active",
"expectedValues": [
"16:9"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "0cbbfa2735324fe8bd172bfe98510c39",
"title": "Яскравість дисплея",
"dataType": "integer",
"status": "active",
"unit": {
"code": "A24",
"name": "кд/м²"
},
"minValue": 0,
"maxValue": 250,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "6b78fd178786471ebff1faf01277c285",
"title": "Контрастність (статична)",
"dataType": "string",
"status": "active",
"expectedValues": [
"1000:1"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "6d027700fb9646968fed97d3291e487a",
"title": "Кількість портів HDMI",
"dataType": "integer",
"status": "active",
"unit": {
"code": "H87",
"name": "штук"
},
"minValue": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "ce5247fff13a4a5bb8cc27b5c9edc972",
"title": "Кількість портів D-sub",
"dataType": "integer",
"status": "active",
"unit": {
"code": "H87",
"name": "штук"
},
"minValue": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "3a028e0e6ea34ccebfcd214944fb439a",
"title": "Кабель для під’єднання",
"dataType": "string",
"status": "active",
"expectedValues": [
"HDMI"
],
"expectedMinItems": 1,
"datePublished": "2024-01-01T00:00:00+02:00"
},
{
"id": "68f8023f5da1456789a9b355f67022f9",
"title": "Гарантія",
"dataType": "integer",
"status": "active",
"unit": {
"code": "MON",
"name": "місяців"
},
"minValue": 36,
"datePublished": "2024-01-01T00:00:00+02:00"
}
]
}
]
}
],
"noticePublicationDate": "2024-01-01T00:00:01+02:00",
"next_check": "2024-01-16T00:00:11+02:00",
"id": "3f38940af1314712ac29867b3e4eced4"
},
"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
}
}
Bid submission
Registering bid
Tender status active.tendering allows registration of bids.
If bid tenderer is not a member of agreement, than we will see an error during registration of bid:
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037200",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"value": {
"amount": 469,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"status": "draft",
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593"
},
"value": 23.8
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314"
},
"values": [
"1920x1080"
]
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916"
},
"values": [
"16:9"
]
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39"
},
"value": 0
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285"
},
"values": [
"1000:1"
]
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a"
},
"value": 1
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972"
},
"value": 1
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a"
},
"values": [
"HDMI"
]
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9"
},
"value": 36
}
],
"items": [
{
"quantity": 4,
"description": "футляри до державних нагород",
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
},
"product": "bee4548f9f344b8db47807229189394f"
}
]
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Bid is not a member of agreement"
}
]
}
Note
For PQ bids have strict validation: the amount of bids by item (item.quantity * item.unit.value.amount) must be greater than 0, and may differ downwards from bid.value.amount by no more than 20%.
If sum of unit items values are less than net value bid.value.amount (bid.value.amount * 1.2), the bidder will see the error:
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"value": {
"amount": 469,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"status": "draft",
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593"
},
"value": 23.8
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314"
},
"values": [
"1920x1080"
]
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916"
},
"values": [
"16:9"
]
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39"
},
"value": 0
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285"
},
"values": [
"1000:1"
]
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a"
},
"value": 1
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972"
},
"value": 1
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a"
},
"values": [
"HDMI"
]
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9"
},
"value": 36
}
],
"items": [
{
"quantity": 3,
"description": "футляри до державних нагород",
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
},
"product": "bee4548f9f344b8db47807229189394f"
}
]
}
}
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 bid.value.amount and no less than net bid amount"
}
]
}
If item in tender has category or profile relation, then bidder must set product in this item. If there is no product we will see the error:
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"value": {
"amount": 469,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"status": "draft",
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593"
},
"value": 23.8
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314"
},
"values": [
"1920x1080"
]
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916"
},
"values": [
"16:9"
]
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39"
},
"value": 0
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285"
},
"values": [
"1000:1"
]
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a"
},
"value": 1
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972"
},
"value": 1
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a"
},
"values": [
"HDMI"
]
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9"
},
"value": 36
}
],
"items": [
{
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
]
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "items",
"description": {
"product": "This field is required."
}
}
]
}
Bidder can register a bid with draft status:
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"value": {
"amount": 469,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"status": "draft",
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593"
},
"value": 23.8
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314"
},
"values": [
"1920x1080"
]
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916"
},
"values": [
"16:9"
]
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39"
},
"value": 0
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285"
},
"values": [
"1000:1"
]
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a"
},
"value": 1
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972"
},
"value": 1
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a"
},
"values": [
"HDMI"
]
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9"
},
"value": 36
}
],
"items": [
{
"quantity": 4,
"description": "футляри до державних нагород",
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
},
"product": "bee4548f9f344b8db47807229189394f"
}
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/0e3de0a7af624bd294b409456dee24e6
{
"data": {
"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": "Статут компанії"
}
}
],
"value": {
"amount": 469.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593",
"title": "Діагональ екрану"
},
"value": 23.8,
"id": "be170b878344470180d33b0c11a0943e",
"unit": {
"code": "INH",
"name": "дюйм"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314",
"title": "Роздільна здатність"
},
"values": [
"1920x1080"
],
"id": "487bed9ad7cb42a581753d0a70d4fc3a",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916",
"title": "Співвідношення сторін"
},
"values": [
"16:9"
],
"id": "54b62b2a50ef40cbbc820b2f5f5297af",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39",
"title": "Яскравість дисплея"
},
"value": 0,
"id": "67aa1163fe6041baa2723655c670ac72",
"unit": {
"code": "A24",
"name": "кд/м²"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285",
"title": "Контрастність (статична)"
},
"values": [
"1000:1"
],
"id": "a077bd0f0f4d4994b461d7f9b5a6aefd",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a",
"title": "Кількість портів HDMI"
},
"value": 1,
"id": "099093502c0f43d7b8cca99960147c15",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972",
"title": "Кількість портів D-sub"
},
"value": 1,
"id": "9555a5c3e5184c05b7bb2a28e6d0fdce",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a",
"title": "Кабель для під’єднання"
},
"values": [
"HDMI"
],
"id": "8101956340e44e0fb6a7a9835b672b8b",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9",
"title": "Гарантія"
},
"value": 36,
"id": "d2561440b9c2420b958fd8d1cb50f71e",
"unit": {
"code": "MON",
"name": "місяців"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
}
],
"status": "draft",
"items": [
{
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "футляри до державних нагород",
"unit": {
"name": "кг",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 4.0,
"product": "bee4548f9f344b8db47807229189394f"
}
],
"id": "0e3de0a7af624bd294b409456dee24e6",
"date": "2024-01-01T00:00:01+02:00"
},
"access": {
"token": "0484ed15231c4703bd9ddf87eb9575e8",
"transfer": "bd6e54799536465fb49e96a1fdab66ff"
}
}
Note
User receives access: token with which operations as a Supplier role are accessible.
and approve to pending status:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/0e3de0a7af624bd294b409456dee24e6?acc_token=0484ed15231c4703bd9ddf87eb9575e8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0e3de0a7af624bd294b409456dee24e6",
"date": "2024-01-01T00:00:01+02: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": "Статут компанії"
}
}
],
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593",
"title": "Діагональ екрану"
},
"value": 23.8,
"id": "be170b878344470180d33b0c11a0943e",
"unit": {
"code": "INH",
"name": "дюйм"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314",
"title": "Роздільна здатність"
},
"values": [
"1920x1080"
],
"id": "487bed9ad7cb42a581753d0a70d4fc3a",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916",
"title": "Співвідношення сторін"
},
"values": [
"16:9"
],
"id": "54b62b2a50ef40cbbc820b2f5f5297af",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39",
"title": "Яскравість дисплея"
},
"value": 0,
"id": "67aa1163fe6041baa2723655c670ac72",
"unit": {
"code": "A24",
"name": "кд/м²"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285",
"title": "Контрастність (статична)"
},
"values": [
"1000:1"
],
"id": "a077bd0f0f4d4994b461d7f9b5a6aefd",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a",
"title": "Кількість портів HDMI"
},
"value": 1,
"id": "099093502c0f43d7b8cca99960147c15",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972",
"title": "Кількість портів D-sub"
},
"value": 1,
"id": "9555a5c3e5184c05b7bb2a28e6d0fdce",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a",
"title": "Кабель для під’єднання"
},
"values": [
"HDMI"
],
"id": "8101956340e44e0fb6a7a9835b672b8b",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9",
"title": "Гарантія"
},
"value": 36,
"id": "d2561440b9c2420b958fd8d1cb50f71e",
"unit": {
"code": "MON",
"name": "місяців"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
}
],
"status": "pending",
"items": [
{
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "футляри до державних нагород",
"unit": {
"name": "кг",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 4.0,
"product": "bee4548f9f344b8db47807229189394f"
}
],
"submissionDate": "2024-01-01T00:00:01+02:00"
}
}
If bid tenderer is not a member of agreement, than we will see an error during registration of bid:
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037200",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"value": {
"amount": 469,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"status": "draft",
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593"
},
"value": 23.8
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314"
},
"values": [
"1920x1080"
]
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916"
},
"values": [
"16:9"
]
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39"
},
"value": 0
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285"
},
"values": [
"1000:1"
]
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a"
},
"value": 1
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972"
},
"value": 1
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a"
},
"values": [
"HDMI"
]
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9"
},
"value": 36
}
],
"items": [
{
"quantity": 4,
"description": "футляри до державних нагород",
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
},
"product": "bee4548f9f344b8db47807229189394f"
}
]
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Bid is not a member of agreement"
}
]
}
Modifying bid
Bid can be updated until the end of tender period.
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/0e3de0a7af624bd294b409456dee24e6?acc_token=0484ed15231c4703bd9ddf87eb9575e8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 459
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0e3de0a7af624bd294b409456dee24e6",
"date": "2024-01-01T00:00:01+02: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": "Статут компанії"
}
}
],
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593",
"title": "Діагональ екрану"
},
"value": 23.8,
"id": "be170b878344470180d33b0c11a0943e",
"unit": {
"code": "INH",
"name": "дюйм"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314",
"title": "Роздільна здатність"
},
"values": [
"1920x1080"
],
"id": "487bed9ad7cb42a581753d0a70d4fc3a",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916",
"title": "Співвідношення сторін"
},
"values": [
"16:9"
],
"id": "54b62b2a50ef40cbbc820b2f5f5297af",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39",
"title": "Яскравість дисплея"
},
"value": 0,
"id": "67aa1163fe6041baa2723655c670ac72",
"unit": {
"code": "A24",
"name": "кд/м²"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285",
"title": "Контрастність (статична)"
},
"values": [
"1000:1"
],
"id": "a077bd0f0f4d4994b461d7f9b5a6aefd",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a",
"title": "Кількість портів HDMI"
},
"value": 1,
"id": "099093502c0f43d7b8cca99960147c15",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972",
"title": "Кількість портів D-sub"
},
"value": 1,
"id": "9555a5c3e5184c05b7bb2a28e6d0fdce",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a",
"title": "Кабель для під’єднання"
},
"values": [
"HDMI"
],
"id": "8101956340e44e0fb6a7a9835b672b8b",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9",
"title": "Гарантія"
},
"value": 36,
"id": "d2561440b9c2420b958fd8d1cb50f71e",
"unit": {
"code": "MON",
"name": "місяців"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
}
],
"status": "draft",
"items": [
{
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "футляри до державних нагород",
"unit": {
"name": "кг",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 4.0,
"product": "bee4548f9f344b8db47807229189394f"
}
]
}
}
Deleting bid
Bid can be deleted until the end of tender period.
Let’s add new bid to tender:
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"value": {
"amount": 469,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"status": "draft",
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593"
},
"value": 23.8
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314"
},
"values": [
"1920x1080"
]
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916"
},
"values": [
"16:9"
]
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39"
},
"value": 0
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285"
},
"values": [
"1000:1"
]
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a"
},
"value": 1
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972"
},
"value": 1
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a"
},
"values": [
"HDMI"
]
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9"
},
"value": 36
}
],
"items": [
{
"quantity": 4,
"description": "футляри до державних нагород",
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
},
"product": "bee4548f9f344b8db47807229189394f"
}
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/4ab3fec8e0784ffbb62c204741ed37fc
{
"data": {
"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": "Статут компанії"
}
}
],
"value": {
"amount": 469.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593",
"title": "Діагональ екрану"
},
"value": 23.8,
"id": "be4caa39955a4cafb7d1aa9f595b31fd",
"unit": {
"code": "INH",
"name": "дюйм"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314",
"title": "Роздільна здатність"
},
"values": [
"1920x1080"
],
"id": "39be98dc02274a1eb4b7f714b60a80b2",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916",
"title": "Співвідношення сторін"
},
"values": [
"16:9"
],
"id": "f8a8879c85c649e1867a9bac8e707106",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39",
"title": "Яскравість дисплея"
},
"value": 0,
"id": "8c30b05d1b0d44f39eb7c9e2f24b6398",
"unit": {
"code": "A24",
"name": "кд/м²"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285",
"title": "Контрастність (статична)"
},
"values": [
"1000:1"
],
"id": "f890f771f119438c84df516bedf71125",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a",
"title": "Кількість портів HDMI"
},
"value": 1,
"id": "42aaf319b91a42579853fc576c437faf",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972",
"title": "Кількість портів D-sub"
},
"value": 1,
"id": "006470aff5344f12b98c26e3fced17f5",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a",
"title": "Кабель для під’єднання"
},
"values": [
"HDMI"
],
"id": "f47628aed7c44295a311a82af64ca477",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9",
"title": "Гарантія"
},
"value": 36,
"id": "c2f888b26b0b458d8b9ee2e1eb492aec",
"unit": {
"code": "MON",
"name": "місяців"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
}
],
"status": "draft",
"items": [
{
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "футляри до державних нагород",
"unit": {
"name": "кг",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 4.0,
"product": "bee4548f9f344b8db47807229189394f"
}
],
"id": "4ab3fec8e0784ffbb62c204741ed37fc",
"date": "2024-01-01T00:00:01+02:00"
},
"access": {
"token": "4b182a91a2864791a3088e84e44e6f08",
"transfer": "4357e6956ea1450e9cc97790729bc949"
}
}
Now we can delete this bid:
Request
DELETE /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/4ab3fec8e0784ffbb62c204741ed37fc?acc_token=4b182a91a2864791a3088e84e44e6f08 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"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": "Статут компанії"
}
}
],
"value": {
"amount": 469.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593",
"title": "Діагональ екрану"
},
"value": 23.8,
"id": "be4caa39955a4cafb7d1aa9f595b31fd",
"unit": {
"code": "INH",
"name": "дюйм"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314",
"title": "Роздільна здатність"
},
"values": [
"1920x1080"
],
"id": "39be98dc02274a1eb4b7f714b60a80b2",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916",
"title": "Співвідношення сторін"
},
"values": [
"16:9"
],
"id": "f8a8879c85c649e1867a9bac8e707106",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39",
"title": "Яскравість дисплея"
},
"value": 0,
"id": "8c30b05d1b0d44f39eb7c9e2f24b6398",
"unit": {
"code": "A24",
"name": "кд/м²"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285",
"title": "Контрастність (статична)"
},
"values": [
"1000:1"
],
"id": "f890f771f119438c84df516bedf71125",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a",
"title": "Кількість портів HDMI"
},
"value": 1,
"id": "42aaf319b91a42579853fc576c437faf",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972",
"title": "Кількість портів D-sub"
},
"value": 1,
"id": "006470aff5344f12b98c26e3fced17f5",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a",
"title": "Кабель для під’єднання"
},
"values": [
"HDMI"
],
"id": "f47628aed7c44295a311a82af64ca477",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9",
"title": "Гарантія"
},
"value": 36,
"id": "c2f888b26b0b458d8b9ee2e1eb492aec",
"unit": {
"code": "MON",
"name": "місяців"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
}
],
"status": "draft",
"items": [
{
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "футляри до державних нагород",
"unit": {
"name": "кг",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 4.0,
"product": "bee4548f9f344b8db47807229189394f"
}
],
"id": "4ab3fec8e0784ffbb62c204741ed37fc",
"date": "2024-01-01T00:00:01+02:00"
}
}
The bid is not exist in tender after deletion:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/4ab3fec8e0784ffbb62c204741ed37fc?acc_token=4b182a91a2864791a3088e84e44e6f08 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 404 Not Found
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "url",
"name": "bid_id",
"description": "Not Found"
}
]
}
Proposal Uploading
Then bidder should upload proposal document(s):
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/0e3de0a7af624bd294b409456dee24e6/documents?acc_token=0484ed15231c4703bd9ddf87eb9575e8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Proposal.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e0c4facd2ccf4da8b83d04b0beb94c85?Signature=G8C7n0FWNNpni29AqbH80UtTkEUu3gu%2FxNqUI37ana6CeYzWWv7Kju2z4gHL57A8A1Z2x%2FBUk4VtDZsxYbgQDA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"documentType": "proposal",
"format": "sign/p7s"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/0e3de0a7af624bd294b409456dee24e6/documents/8eeccb3aef1d4373844028cddf65bc15
{
"data": {
"confidentiality": "public",
"documentType": "proposal",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e0c4facd2ccf4da8b83d04b0beb94c85?Signature=EUuHrPRN9JfMPae13U5%2F40s%2BIyXR6rK%2B%2FbV%2BNAjT7qTELiXpBzWAmQWJ0Ro1cZ8cMcf0OoTowSQoK9IeRbpKBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "8eeccb3aef1d4373844028cddf65bc15",
"datePublished": "2024-01-01T00:00:01+02:00",
"dateModified": "2024-01-01T00:00:01+02:00"
}
}
It is possible to check the uploaded documents:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/0e3de0a7af624bd294b409456dee24e6/documents?acc_token=0484ed15231c4703bd9ddf87eb9575e8 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"documentType": "proposal",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e0c4facd2ccf4da8b83d04b0beb94c85?Signature=EUuHrPRN9JfMPae13U5%2F40s%2BIyXR6rK%2B%2FbV%2BNAjT7qTELiXpBzWAmQWJ0Ro1cZ8cMcf0OoTowSQoK9IeRbpKBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "8eeccb3aef1d4373844028cddf65bc15",
"datePublished": "2024-01-01T00:00:01+02:00",
"dateModified": "2024-01-01T00:00:01+02:00"
}
]
}
Active tendering period end
After tender period ended, CBD checks one more time status of contract for suppliers in agreement. If contract status is still active - bid is getting active status too, in other cases - bid gets invalid status.
Let’s imagine that second contract supplier in agreement was disqualified during active.tendering period.
Let’s see our bids statuses after active.tendering period ends. Last bid was disqualified:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids?acc_token=3f07ab10456e4f519a3cf51c24d19c80 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": "0e3de0a7af624bd294b409456dee24e6",
"date": "2024-01-01T00:00:01+02:00",
"submissionDate": "2024-01-01T00:00:01+02:00",
"documents": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "8eeccb3aef1d4373844028cddf65bc15",
"datePublished": "2024-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e0c4facd2ccf4da8b83d04b0beb94c85?Signature=EUuHrPRN9JfMPae13U5%2F40s%2BIyXR6rK%2B%2FbV%2BNAjT7qTELiXpBzWAmQWJ0Ro1cZ8cMcf0OoTowSQoK9IeRbpKBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2024-01-01T00:00:01+02:00",
"language": "uk"
}
],
"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": "Статут компанії"
}
}
],
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593",
"title": "Діагональ екрану"
},
"value": 23.8,
"id": "be170b878344470180d33b0c11a0943e",
"unit": {
"code": "INH",
"name": "дюйм"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314",
"title": "Роздільна здатність"
},
"values": [
"1920x1080"
],
"id": "487bed9ad7cb42a581753d0a70d4fc3a",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916",
"title": "Співвідношення сторін"
},
"values": [
"16:9"
],
"id": "54b62b2a50ef40cbbc820b2f5f5297af",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39",
"title": "Яскравість дисплея"
},
"value": 0,
"id": "67aa1163fe6041baa2723655c670ac72",
"unit": {
"code": "A24",
"name": "кд/м²"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285",
"title": "Контрастність (статична)"
},
"values": [
"1000:1"
],
"id": "a077bd0f0f4d4994b461d7f9b5a6aefd",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a",
"title": "Кількість портів HDMI"
},
"value": 1,
"id": "099093502c0f43d7b8cca99960147c15",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972",
"title": "Кількість портів D-sub"
},
"value": 1,
"id": "9555a5c3e5184c05b7bb2a28e6d0fdce",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a",
"title": "Кабель для під’єднання"
},
"values": [
"HDMI"
],
"id": "8101956340e44e0fb6a7a9835b672b8b",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9",
"title": "Гарантія"
},
"value": 36,
"id": "d2561440b9c2420b958fd8d1cb50f71e",
"unit": {
"code": "MON",
"name": "місяців"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
}
],
"status": "active",
"items": [
{
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "футляри до державних нагород",
"unit": {
"name": "кг",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 4.0,
"product": "bee4548f9f344b8db47807229189394f"
}
],
"initialValue": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"id": "b01762f36d1e4980945e212dd14bd93d",
"date": "2024-01-01T00:00:01+02:00",
"documents": [
{
"confidentiality": "public",
"id": "ae2f7e79aa9d4801a43e65f56d72df78",
"datePublished": "2024-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e60395021f82401794cf794d2d778174?Signature=Wik5JD7p5h%2F%2Bvz%2FUYKxzcE2HWzbwtS%2BpEhmjDVLq2UJREucO5%2BCfcSCPM6B0BHmv7JDRxO3AHotaFGsT5ilCDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2024-01-01T00:00:01+02:00",
"language": "uk"
},
{
"confidentiality": "public",
"id": "661a3fe718574a66bae746d8d8fcb9fa",
"datePublished": "2024-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d4fa24e55e3849dfafde7ba0914a38e6?Signature=8ZgQYUJLFLwp6z8%2FcaUJ3%2F7ODQ5ofPCavIPxk2MHGphlzUoChh68xxyq%2FCEtHLhRYZjOJs2q5aYMAcgcjHRsBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2024-01-01T00:00:01+02:00",
"language": "uk"
}
],
"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": "Статут компанії"
}
}
],
"value": {
"amount": 479.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "8cac9e406b954b80b22aec9a77e63593",
"title": "Діагональ екрану"
},
"value": 23.8,
"id": "231f1e3954204c21b7cf408002b7f3bc",
"unit": {
"code": "INH",
"name": "дюйм"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "17d57e334aed49d19de4fd5b27b3b314",
"title": "Роздільна здатність"
},
"values": [
"1920x1080"
],
"id": "3a61e6e21b41431291c1f1d08eb878e9",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "08ac3b62c1114ed1918bbde211047916",
"title": "Співвідношення сторін"
},
"values": [
"16:9"
],
"id": "8110369c29dd46a38e7ded66f17cc932",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "0cbbfa2735324fe8bd172bfe98510c39",
"title": "Яскравість дисплея"
},
"value": 0,
"id": "96623c0401e2431ea6724653130ec49f",
"unit": {
"code": "A24",
"name": "кд/м²"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6b78fd178786471ebff1faf01277c285",
"title": "Контрастність (статична)"
},
"values": [
"1000:1"
],
"id": "3c89603d681247078e3bad10d1bc69d4",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "6d027700fb9646968fed97d3291e487a",
"title": "Кількість портів HDMI"
},
"value": 1,
"id": "eb19587850bf434581ab91900ee8a530",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "ce5247fff13a4a5bb8cc27b5c9edc972",
"title": "Кількість портів D-sub"
},
"value": 1,
"id": "cf23a8b7409b47f791a9be2915aa4a5a",
"unit": {
"code": "H87",
"name": "штук"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "3a028e0e6ea34ccebfcd214944fb439a",
"title": "Кабель для під’єднання"
},
"values": [
"HDMI"
],
"id": "0882b19956864a8fab2702eddceee117",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "68f8023f5da1456789a9b355f67022f9",
"title": "Гарантія"
},
"value": 36,
"id": "667530b271cc4647a94bd10a9e2395d8",
"unit": {
"code": "MON",
"name": "місяців"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
}
],
"status": "active",
"items": [
{
"id": "30c4edcb5705460a9ca5fd7985bfe56c",
"description": "футляри до державних нагород",
"unit": {
"name": "кг",
"value": {
"amount": 110.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 4.0,
"product": "308b6fa8fb944b308b6e8088ba9fe43d"
}
],
"submissionDate": "2024-01-01T00:00:01+02:00",
"initialValue": {
"amount": 479.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"id": "3804047cf5e54ee98d6293d153b0c56e",
"status": "invalid"
}
]
}
Awarding process
After the tender period end date, system automatically creates award in pending status for the bid with the most economically advantageous price.
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards 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": "b1c41ec4a4d84cdb82270c0795928bfd",
"status": "pending",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 459.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": "Статут компанії"
}
}
],
"bid_id": "0e3de0a7af624bd294b409456dee24e6",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
}
}
]
}
Qualification comission can set award to active or unsuccessful status.
There are validations before registering qualification decision:
qualified: True - for setting award from pending to active
qualified: False - for setting award from pending to unsuccessful
Let’s try to set unsuccessful status for qualified award and we will see an error:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/b1c41ec4a4d84cdb82270c0795928bfd?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful",
"qualified": true
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "qualified",
"description": [
"Can't update award to unsuccessful status when qualified/eligible isn't set to False"
]
}
]
}
Let’s try to set active status for non-qualified award and we will see an error:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/b1c41ec4a4d84cdb82270c0795928bfd?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": false
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "qualified",
"description": [
"Can't update award to active status with not qualified"
]
}
]
}
Procuring Entity can accept award by transferring it to status: active.
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/b1c41ec4a4d84cdb82270c0795928bfd?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "b1c41ec4a4d84cdb82270c0795928bfd",
"status": "active",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 459.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": "Статут компанії"
}
}
],
"bid_id": "0e3de0a7af624bd294b409456dee24e6",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
},
"qualified": true
}
}
Let’s check the listing of awards:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards 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": "b1c41ec4a4d84cdb82270c0795928bfd",
"status": "active",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 459.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": "Статут компанії"
}
}
],
"bid_id": "0e3de0a7af624bd294b409456dee24e6",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
},
"qualified": true
}
]
}
Procuring Entity can cancel award after acceptance by changing award status to cancelled:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/b1c41ec4a4d84cdb82270c0795928bfd?acc_token=3f07ab10456e4f519a3cf51c24d19c80 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/3f38940af1314712ac29867b3e4eced4/awards/a6c7b280a49c4f7788e5768c3ce3464b
{
"data": {
"id": "b1c41ec4a4d84cdb82270c0795928bfd",
"status": "cancelled",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 459.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": "Статут компанії"
}
}
],
"bid_id": "0e3de0a7af624bd294b409456dee24e6",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
},
"qualified": true
}
}
After canceling award system creates second award for the same bid in status: pending:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards 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": "b1c41ec4a4d84cdb82270c0795928bfd",
"status": "cancelled",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 459.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": "Статут компанії"
}
}
],
"bid_id": "0e3de0a7af624bd294b409456dee24e6",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
},
"qualified": true
},
{
"id": "a6c7b280a49c4f7788e5768c3ce3464b",
"status": "pending",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 459.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": "Статут компанії"
}
}
],
"bid_id": "0e3de0a7af624bd294b409456dee24e6",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
}
}
]
}
If the offer of the Participant with the lowest price meets the requirements, Procuring Entity uploads a document that recognizes the offer as the Winner (awards:status:active). If it does not meet the requirements, Procuring Entity downloads a protocol confirming its decision to reject the Participant and rejects such an offer (awards:status:unsuccessful). The system leads to the evaluation of the next one with most economically advantageous price (awards:status:pending).
Let’s decline award by transferring it to status: unsuccessful.
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/a6c7b280a49c4f7788e5768c3ce3464b?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful",
"qualified": false
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/d2ac59c439604dd29f5e5d6c0be61dbd
{
"data": {
"id": "a6c7b280a49c4f7788e5768c3ce3464b",
"status": "unsuccessful",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 459.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": "Статут компанії"
}
}
],
"bid_id": "0e3de0a7af624bd294b409456dee24e6",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
},
"qualified": false
}
}
In that case Award will be granted to the next bid with most economically advantageous price.
Let’s check the listing of awards:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards 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": "b1c41ec4a4d84cdb82270c0795928bfd",
"status": "cancelled",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 459.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": "Статут компанії"
}
}
],
"bid_id": "0e3de0a7af624bd294b409456dee24e6",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
},
"qualified": true
},
{
"id": "a6c7b280a49c4f7788e5768c3ce3464b",
"status": "unsuccessful",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 459.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": "Статут компанії"
}
}
],
"bid_id": "0e3de0a7af624bd294b409456dee24e6",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
},
"qualified": false
},
{
"id": "d2ac59c439604dd29f5e5d6c0be61dbd",
"status": "pending",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 479.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": "Статут компанії"
}
}
],
"bid_id": "b01762f36d1e4980945e212dd14bd93d",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
}
}
]
}
Procuring Entity can accept second bidder award by transferring it to status: active.
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/d2ac59c439604dd29f5e5d6c0be61dbd?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "d2ac59c439604dd29f5e5d6c0be61dbd",
"status": "active",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 479.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": "Статут компанії"
}
}
],
"bid_id": "b01762f36d1e4980945e212dd14bd93d",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
},
"qualified": true
}
}
Let’s check the listing of awards:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards 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": "b1c41ec4a4d84cdb82270c0795928bfd",
"status": "cancelled",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 459.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": "Статут компанії"
}
}
],
"bid_id": "0e3de0a7af624bd294b409456dee24e6",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
},
"qualified": true
},
{
"id": "a6c7b280a49c4f7788e5768c3ce3464b",
"status": "unsuccessful",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 459.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": "Статут компанії"
}
}
],
"bid_id": "0e3de0a7af624bd294b409456dee24e6",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
},
"qualified": false
},
{
"id": "d2ac59c439604dd29f5e5d6c0be61dbd",
"status": "active",
"date": "2024-01-01T00:00:01+02:00",
"value": {
"amount": 479.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": "Статут компанії"
}
}
],
"bid_id": "b01762f36d1e4980945e212dd14bd93d",
"period": {
"startDate": "2024-01-01T00:00:01+02:00",
"endDate": "2024-01-09T00:00:00+02:00"
},
"qualified": true
}
]
}
Note
In the case of award being transferred to unsuccessful status for the last bid procedure will inherit termination status: `unsuccessful`.
Setting Contract
In EContracting the contract is created directly in contracting system.
Note
Some of data will be mirrored to tender until contract will be activated for backward compatibility.
Read more about working with EContracting in contracting system in Tutorial section.
Cancelling tender
Tender creator can cancel tender anytime (except when tender in terminal status e.g. draft.unsuccessful, unsuccessful, cancelled, complete).
The following steps should be applied:
Prepare cancellation request.
Fill it with the protocol describing the cancellation reasons.
Cancel the tender with the prepared reasons.
Only the request that has been activated (3rd step above) has power to cancel tender. I.e. you have to not only prepare cancellation request but to activate it as well.
For cancelled cancellation you need to update cancellation status to unsuccessful from draft or pending.
See Cancellation data structure for details.
Preparing the cancellation request
You should pass reason and reasonType, status defaults to draft.
There are three possible types of cancellation reason - tender was noDemand, forceMajeure and expensesCut.
id is autogenerated and passed in the Location header of response.
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reason": "cancellation reason",
"reasonType": "noDemand"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "0162fbd6680f40e8b12a7235ace8cf98",
"date": "2024-01-01T00:00:01+02:00",
"cancellationOf": "tender",
"status": "draft"
}
}
You can change reasonType value to any of the above.
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "expensesCut"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0162fbd6680f40e8b12a7235ace8cf98",
"status": "draft",
"date": "2024-01-01T00:00:01+02:00",
"reasonType": "expensesCut",
"reason": "cancellation reason",
"cancellationOf": "tender"
}
}
Filling cancellation with protocol and supplementary documentation
This step is required. Without documents you can’t update tender status.
Upload the file contents
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d6ebb6c1c3094985962581583a6e9bb6?Signature=V0Zf4YQL3tSs26qyApV6Ztak790Y%2FUg7kZHL7KtUgj7wCK%2BY%2BcGuzP0UmxjNWil1qV4vZ%2FZNJgxZFJvJNygKDQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents/18f867b8bed74749819ccc7ca09b8f24
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d6ebb6c1c3094985962581583a6e9bb6?Signature=E5t5hH%2Fqwooek8WhW8vI5PBNXpOiC8D26zX8qjI4OSyu7kQ7ho%2B7QzajpI2G9%2B4QAE264SpQ9ansqYWhReEDBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "18f867b8bed74749819ccc7ca09b8f24",
"datePublished": "2024-01-01T00:00:01+02:00",
"dateModified": "2024-01-01T00:00:01+02:00"
}
}
Change the document description and other properties
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents/18f867b8bed74749819ccc7ca09b8f24?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"description": "Changed description"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"description": "Changed description",
"id": "18f867b8bed74749819ccc7ca09b8f24",
"datePublished": "2024-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d6ebb6c1c3094985962581583a6e9bb6?Signature=E5t5hH%2Fqwooek8WhW8vI5PBNXpOiC8D26zX8qjI4OSyu7kQ7ho%2B7QzajpI2G9%2B4QAE264SpQ9ansqYWhReEDBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2024-01-01T00:00:01+02:00",
"language": "uk"
}
}
Upload new version of the document
Request
PUT /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents/18f867b8bed74749819ccc7ca09b8f24?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5cb0540fdcf8439c861729e7f0016a3b?Signature=71mkZA4atd7BszBPiE%2FJMuYG9o64MZV1LiFggcJ0qx5bNCh1pmsR7d95haGRkKiR0MY9XsVniQnrK38e03AbDA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"description": "Changed description",
"id": "18f867b8bed74749819ccc7ca09b8f24",
"datePublished": "2024-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5cb0540fdcf8439c861729e7f0016a3b?Signature=wpwA9uXhxRbAtOJko6cYXh6hrOXBHVo%2FePWl93F5oHRKveePKWfeKUrIrwXCub3PPQl%2Bl798XFOuB6psvAbiAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2024-01-01T00:00:01+02:00",
"language": "uk"
}
}
Activating the request and cancelling tender
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0162fbd6680f40e8b12a7235ace8cf98",
"status": "active",
"date": "2024-01-01T00:00:01+02:00",
"reasonType": "expensesCut",
"reason": "cancellation reason",
"cancellationOf": "tender",
"documents": [
{
"confidentiality": "public",
"description": "Changed description",
"id": "18f867b8bed74749819ccc7ca09b8f24",
"datePublished": "2024-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d6ebb6c1c3094985962581583a6e9bb6?Signature=E5t5hH%2Fqwooek8WhW8vI5PBNXpOiC8D26zX8qjI4OSyu7kQ7ho%2B7QzajpI2G9%2B4QAE264SpQ9ansqYWhReEDBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2024-01-01T00:00:01+02:00",
"language": "uk"
},
{
"confidentiality": "public",
"description": "Changed description",
"id": "18f867b8bed74749819ccc7ca09b8f24",
"datePublished": "2024-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5cb0540fdcf8439c861729e7f0016a3b?Signature=wpwA9uXhxRbAtOJko6cYXh6hrOXBHVo%2FePWl93F5oHRKveePKWfeKUrIrwXCub3PPQl%2Bl798XFOuB6psvAbiAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2024-01-01T00:00:01+02:00",
"language": "uk"
}
]
}
}