Tutorial
Configuration
The set of possible configuration values:
name |
values |
default |
days |
|---|---|---|---|
hasAuction |
true |
true |
|
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 |
3 |
3 |
calendar |
hasEnquiries |
true |
true |
|
minEnquiriesDuration |
1 |
1 |
calendar |
enquiryPeriodRegulation |
0 |
0 |
|
restricted |
false |
false |
|
hasMultiSourcing |
false |
false |
You can look for more details in Configuration section.
Allowed procuringEntity.kind values
procuringEntity.kind |
|---|
authority |
social |
central |
general |
defense |
special |
Creating tender
Let’s create tender with the minimal (only required) data set:
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": {
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"title": "футляри до державних нагород",
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"procuringEntity": {
"name": "Державне управління справами",
"kind": "general",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"name": "Державне управління справами 1",
"telephone": "+0440000000",
"availableLanguage": "uk"
}
]
},
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "New Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "item",
"code": "KGM"
},
"quantity": 5,
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "66bd7aa82b7d403cb3626390997acbaf"
}
]
},
"config": {
"hasAuction": true,
"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": 3,
"hasEnquiries": true,
"minEnquiriesDuration": 1,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/42d9343086154eaf83080514ecd42ff6
{
"data": {
"title": "футляри до державних нагород",
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"name": "Державне управління справами 1",
"telephone": "+0440000000",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "draft",
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"quantity": 5.0,
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "66bd7aa82b7d403cb3626390997acbaf",
"status": "active",
"date": "2027-01-01T00:00:00+02:00"
}
],
"tenderID": "UA-2027-01-01-000001-a",
"owner": "broker",
"procurementMethod": "selective",
"submissionMethod": "electronicAuction",
"date": "2027-01-01T00:00:00+02:00",
"contractChangeRationaleTypes": {
"durationExtension": {
"description_en": "Extension of the period of the procurement contract duration and the term of obligations fulfilment regarding the transfer of goods, implementation of works and provision of services in case of documented objective circumstances that led to such extension, including circumstances of force majeure, delays in funding of procuring entitys expenditures, provided that such changes will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 4, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Продовження строку дії договору про закупівлю та строку виконання зобов’язань щодо передачі товару, виконання робіт, надання послуг у разі виникнення документально підтверджених об’єктивних обставин, що спричинили таке продовження, у тому числі обставин непереборної сили, затримки фінансування витрат замовника, за умови що такі зміни не призведуть до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 4 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"fiscalYearExtension": {
"description_en": "Еffect of the procurement contract may be extended for a period sufficient for conduction of the procurement procedure/simplified procurement at the beginning of the next year in volume that does not exceed 20% of the sum specified in the initial procurement contract concluded in the previous year, if expenditures for achieving this goal are approved in the prescribed manner",
"title_en": "Part 6 of Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Дія договору про закупівлю може бути продовжена на строк, достатній для проведення процедури закупівлі/спрощеної закупівлі на початку наступного року в обсязі, що не перевищує 20 відсотків суми, визначеної в початковому договорі про закупівлю, укладеному в попередньому році, якщо видатки на досягнення цієї цілі затверджено в установленому порядку",
"title_uk": "Частина 6 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceClarification": {
"description_en": "Drawing up a contract price, specified in accordance with the approved project documentation for the purchase contract, specified in paragraph three of part one of this article",
"title_en": "Clause 2, Part 7, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Складання договірної ціни, уточненої відповідно до затвердженої проектної документації до договору про закупівлю, зазначеного в абзаці третьому частини першої цієї статті",
"title_uk": "Пункт 2 частини 7 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"itemPriceVariation": {
"description_en": "An increase in the price per unit of goods by up to 10 percent in proportion to the increase in the market price of such goods in the event of fluctuations in the market price of such goods, provided that such a change does not lead to an increase in the amount specified in the procurement contract; - no more than once every 90 days from the date of signing the procurement contract/making changes to such a contract regarding an increase in the price per unit of goods. The restriction on the timing of changes in the price per unit of goods does not apply in cases of changes in the terms of the contract for the procurement of gasoline and diesel fuel, natural gas, and electricity",
"title_en": "Clause 2, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Збільшення ціни за одиницю товару до 10 відсотків пропорційно збільшенню ціни такого товару на ринку у разі коливання ціни такого товару на ринку за умови, що така зміна не призведе до збільшення суми, визначеної в договорі про закупівлю, - не частіше ніж один раз на 90 днів з моменту підписання договору про закупівлю/внесення змін до такого договору щодо збільшення ціни за одиницю товару. Обмеження щодо строків зміни ціни за одиницю товару не застосовується у випадках зміни умов договору про закупівлю бензину та дизельного пального, природного газу та електричної енергії",
"title_uk": "Пункт 2 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceReduction": {
"description_en": "Аpproval of price changes in the procurement contract in the direction of reduction (without changing the quantity (volume) and quality of goods, works and services), including in case of fluctuations in the price of goods on the market",
"title_en": "Clause 5, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Погодження зміни ціни в договорі про закупівлю в бік зменшення (без зміни кількості (обсягу) та якості товарів, робіт і послуг), у тому числі у разі коливання ціни товару на ринку",
"title_uk": "Пункт 5 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"qualityImprovement": {
"description_en": "Іmprovement of the item's quality, provided that such improvement will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 3, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Покращення якості предмета закупівлі, за умови що таке покращення не призведе до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 3 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"taxRate": {
"description_en": "Changes in the price in the purchase contract due to changes in tax and duty rates and/or changes in the conditions for granting tax benefits - in proportion to the change in such rates and/or tax benefits",
"title_en": "Clause 6, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни ціни в договорі про закупівлю у зв’язку зі зміною ставок податків і зборів та/або зміною умов щодо надання пільг з оподаткування - пропорційно до зміни таких ставок та/або пільг з оподаткування",
"title_uk": "Пункт 6 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"thirdParty": {
"description_en": "Changes in the consumer price index established in accordance with the legislation by state statistics bodies, changes in foreign currency exchange rates, changes in stock market quotes or Platts, ARGUS indicators of regulated prices (tariffs) and standards applied in the procurement contract, if the procurement contract establishes the procedure for changing the price",
"title_en": "Clause 7, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни встановленого згідно із законодавством органами державної статистики індексу споживчих цін, зміни курсу іноземної валюти, зміни біржових котирувань або показників Platts, ARGUS регульованих цін (тарифів) і нормативів, що застосовуються в договорі про закупівлю, у разі встановлення в договорі про закупівлю порядку зміни ціни",
"title_uk": "Пункт 7 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"volumeCuts": {
"description_en": "Reduction of the procurement's volume, particularly taking into account the actual expenditures of the procuring entity",
"title_en": "Clause 1, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зменшення обсягів закупівлі, зокрема з урахуванням фактичного обсягу видатків замовника",
"title_uk": "Пункт 1 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
}
},
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "42d9343086154eaf83080514ecd42ff6"
},
"config": {
"hasAuction": true,
"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": 3,
"hasEnquiries": true,
"minEnquiriesDuration": 1,
"enquiryPeriodRegulation": 0,
"restricted": false,
"hasMultiSourcing": false
},
"access": {
"token": "d2f4a5cf84ba424d8439f906e5faf58e",
"transfer": "63abcfbba3c04d1ca5916e634a8ff89c"
}
}
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. Pay attention to the procurementMethodType. Note that tender is created with draft status.
Let’s access the URL of the created object (the Location header of the response):
GET /api/2.5/tenders/42d9343086154eaf83080514ecd42ff6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title": "футляри до державних нагород",
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"name": "Державне управління справами 1",
"telephone": "+0440000000",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "draft",
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"quantity": 5.0,
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "66bd7aa82b7d403cb3626390997acbaf",
"status": "active",
"date": "2027-01-01T00:00:00+02:00"
}
],
"tenderID": "UA-2027-01-01-000001-a",
"owner": "broker",
"procurementMethod": "selective",
"submissionMethod": "electronicAuction",
"date": "2027-01-01T00:00:00+02:00",
"contractChangeRationaleTypes": {
"durationExtension": {
"description_en": "Extension of the period of the procurement contract duration and the term of obligations fulfilment regarding the transfer of goods, implementation of works and provision of services in case of documented objective circumstances that led to such extension, including circumstances of force majeure, delays in funding of procuring entitys expenditures, provided that such changes will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 4, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Продовження строку дії договору про закупівлю та строку виконання зобов’язань щодо передачі товару, виконання робіт, надання послуг у разі виникнення документально підтверджених об’єктивних обставин, що спричинили таке продовження, у тому числі обставин непереборної сили, затримки фінансування витрат замовника, за умови що такі зміни не призведуть до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 4 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"fiscalYearExtension": {
"description_en": "Еffect of the procurement contract may be extended for a period sufficient for conduction of the procurement procedure/simplified procurement at the beginning of the next year in volume that does not exceed 20% of the sum specified in the initial procurement contract concluded in the previous year, if expenditures for achieving this goal are approved in the prescribed manner",
"title_en": "Part 6 of Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Дія договору про закупівлю може бути продовжена на строк, достатній для проведення процедури закупівлі/спрощеної закупівлі на початку наступного року в обсязі, що не перевищує 20 відсотків суми, визначеної в початковому договорі про закупівлю, укладеному в попередньому році, якщо видатки на досягнення цієї цілі затверджено в установленому порядку",
"title_uk": "Частина 6 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceClarification": {
"description_en": "Drawing up a contract price, specified in accordance with the approved project documentation for the purchase contract, specified in paragraph three of part one of this article",
"title_en": "Clause 2, Part 7, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Складання договірної ціни, уточненої відповідно до затвердженої проектної документації до договору про закупівлю, зазначеного в абзаці третьому частини першої цієї статті",
"title_uk": "Пункт 2 частини 7 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"itemPriceVariation": {
"description_en": "An increase in the price per unit of goods by up to 10 percent in proportion to the increase in the market price of such goods in the event of fluctuations in the market price of such goods, provided that such a change does not lead to an increase in the amount specified in the procurement contract; - no more than once every 90 days from the date of signing the procurement contract/making changes to such a contract regarding an increase in the price per unit of goods. The restriction on the timing of changes in the price per unit of goods does not apply in cases of changes in the terms of the contract for the procurement of gasoline and diesel fuel, natural gas, and electricity",
"title_en": "Clause 2, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Збільшення ціни за одиницю товару до 10 відсотків пропорційно збільшенню ціни такого товару на ринку у разі коливання ціни такого товару на ринку за умови, що така зміна не призведе до збільшення суми, визначеної в договорі про закупівлю, - не частіше ніж один раз на 90 днів з моменту підписання договору про закупівлю/внесення змін до такого договору щодо збільшення ціни за одиницю товару. Обмеження щодо строків зміни ціни за одиницю товару не застосовується у випадках зміни умов договору про закупівлю бензину та дизельного пального, природного газу та електричної енергії",
"title_uk": "Пункт 2 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceReduction": {
"description_en": "Аpproval of price changes in the procurement contract in the direction of reduction (without changing the quantity (volume) and quality of goods, works and services), including in case of fluctuations in the price of goods on the market",
"title_en": "Clause 5, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Погодження зміни ціни в договорі про закупівлю в бік зменшення (без зміни кількості (обсягу) та якості товарів, робіт і послуг), у тому числі у разі коливання ціни товару на ринку",
"title_uk": "Пункт 5 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"qualityImprovement": {
"description_en": "Іmprovement of the item's quality, provided that such improvement will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 3, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Покращення якості предмета закупівлі, за умови що таке покращення не призведе до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 3 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"taxRate": {
"description_en": "Changes in the price in the purchase contract due to changes in tax and duty rates and/or changes in the conditions for granting tax benefits - in proportion to the change in such rates and/or tax benefits",
"title_en": "Clause 6, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни ціни в договорі про закупівлю у зв’язку зі зміною ставок податків і зборів та/або зміною умов щодо надання пільг з оподаткування - пропорційно до зміни таких ставок та/або пільг з оподаткування",
"title_uk": "Пункт 6 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"thirdParty": {
"description_en": "Changes in the consumer price index established in accordance with the legislation by state statistics bodies, changes in foreign currency exchange rates, changes in stock market quotes or Platts, ARGUS indicators of regulated prices (tariffs) and standards applied in the procurement contract, if the procurement contract establishes the procedure for changing the price",
"title_en": "Clause 7, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни встановленого згідно із законодавством органами державної статистики індексу споживчих цін, зміни курсу іноземної валюти, зміни біржових котирувань або показників Platts, ARGUS регульованих цін (тарифів) і нормативів, що застосовуються в договорі про закупівлю, у разі встановлення в договорі про закупівлю порядку зміни ціни",
"title_uk": "Пункт 7 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"volumeCuts": {
"description_en": "Reduction of the procurement's volume, particularly taking into account the actual expenditures of the procuring entity",
"title_en": "Clause 1, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зменшення обсягів закупівлі, зокрема з урахуванням фактичного обсягу видатків замовника",
"title_uk": "Пункт 1 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
}
},
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "42d9343086154eaf83080514ecd42ff6"
},
"config": {
"hasAuction": true,
"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": 3,
"hasEnquiries": true,
"minEnquiriesDuration": 1,
"enquiryPeriodRegulation": 0,
"restricted": false,
"hasMultiSourcing": false
}
}
We can see the same response we got after creating tender.
We do see the internal id of a tender (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/tenders/) and its dateModified datestamp.
The previous tender contained only required fields. Let’s try creating tender with more data (tender has status created):
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": "футляри до державних нагород",
"title_en": "Cases with state awards",
"title_ru": "футляры к государственным наградам",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "436ebf0b3b85490390602f4890d098b8",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кілограм",
"code": "KGM"
},
"quantity": 5,
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"mode": "test",
"milestones": [
{
"id": "cccccccccccccccccccccccccccccccc",
"title": "signingTheContract",
"type": "delivery",
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 1,
"code": "standard",
"percentage": 100
},
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 2,
"percentage": 45.55
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 3,
"percentage": 54.45
}
],
"mainProcurementCategory": "services",
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "66bd7aa82b7d403cb3626390997acbaf"
}
]
},
"config": {
"hasAuction": true,
"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": 3,
"hasEnquiries": true,
"minEnquiriesDuration": 1,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/8df554f83b464a2e952391aa6a518771
{
"data": {
"mainProcurementCategory": "services",
"title_en": "[TESTING] Cases with state awards",
"title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
"title": "[ТЕСТУВАННЯ] футляри до державних нагород",
"mode": "test",
"milestones": [
{
"id": "cccccccccccccccccccccccccccccccc",
"title": "signingTheContract",
"type": "delivery",
"code": "standard",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 1
},
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 2
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 3
}
],
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"availableLanguage": "uk"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "draft",
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "436ebf0b3b85490390602f4890d098b8",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "кілограм",
"code": "KGM"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "66bd7aa82b7d403cb3626390997acbaf",
"status": "active",
"date": "2027-01-01T00:00:00+02:00"
}
],
"tenderID": "UA-2027-01-01-000002-a",
"owner": "broker",
"procurementMethod": "selective",
"submissionMethod": "electronicAuction",
"date": "2027-01-01T00:00:00+02:00",
"contractChangeRationaleTypes": {
"durationExtension": {
"description_en": "Extension of the period of the procurement contract duration and the term of obligations fulfilment regarding the transfer of goods, implementation of works and provision of services in case of documented objective circumstances that led to such extension, including circumstances of force majeure, delays in funding of procuring entitys expenditures, provided that such changes will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 4, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Продовження строку дії договору про закупівлю та строку виконання зобов’язань щодо передачі товару, виконання робіт, надання послуг у разі виникнення документально підтверджених об’єктивних обставин, що спричинили таке продовження, у тому числі обставин непереборної сили, затримки фінансування витрат замовника, за умови що такі зміни не призведуть до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 4 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"fiscalYearExtension": {
"description_en": "Еffect of the procurement contract may be extended for a period sufficient for conduction of the procurement procedure/simplified procurement at the beginning of the next year in volume that does not exceed 20% of the sum specified in the initial procurement contract concluded in the previous year, if expenditures for achieving this goal are approved in the prescribed manner",
"title_en": "Part 6 of Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Дія договору про закупівлю може бути продовжена на строк, достатній для проведення процедури закупівлі/спрощеної закупівлі на початку наступного року в обсязі, що не перевищує 20 відсотків суми, визначеної в початковому договорі про закупівлю, укладеному в попередньому році, якщо видатки на досягнення цієї цілі затверджено в установленому порядку",
"title_uk": "Частина 6 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceClarification": {
"description_en": "Drawing up a contract price, specified in accordance with the approved project documentation for the purchase contract, specified in paragraph three of part one of this article",
"title_en": "Clause 2, Part 7, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Складання договірної ціни, уточненої відповідно до затвердженої проектної документації до договору про закупівлю, зазначеного в абзаці третьому частини першої цієї статті",
"title_uk": "Пункт 2 частини 7 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"itemPriceVariation": {
"description_en": "An increase in the price per unit of goods by up to 10 percent in proportion to the increase in the market price of such goods in the event of fluctuations in the market price of such goods, provided that such a change does not lead to an increase in the amount specified in the procurement contract; - no more than once every 90 days from the date of signing the procurement contract/making changes to such a contract regarding an increase in the price per unit of goods. The restriction on the timing of changes in the price per unit of goods does not apply in cases of changes in the terms of the contract for the procurement of gasoline and diesel fuel, natural gas, and electricity",
"title_en": "Clause 2, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Збільшення ціни за одиницю товару до 10 відсотків пропорційно збільшенню ціни такого товару на ринку у разі коливання ціни такого товару на ринку за умови, що така зміна не призведе до збільшення суми, визначеної в договорі про закупівлю, - не частіше ніж один раз на 90 днів з моменту підписання договору про закупівлю/внесення змін до такого договору щодо збільшення ціни за одиницю товару. Обмеження щодо строків зміни ціни за одиницю товару не застосовується у випадках зміни умов договору про закупівлю бензину та дизельного пального, природного газу та електричної енергії",
"title_uk": "Пункт 2 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceReduction": {
"description_en": "Аpproval of price changes in the procurement contract in the direction of reduction (without changing the quantity (volume) and quality of goods, works and services), including in case of fluctuations in the price of goods on the market",
"title_en": "Clause 5, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Погодження зміни ціни в договорі про закупівлю в бік зменшення (без зміни кількості (обсягу) та якості товарів, робіт і послуг), у тому числі у разі коливання ціни товару на ринку",
"title_uk": "Пункт 5 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"qualityImprovement": {
"description_en": "Іmprovement of the item's quality, provided that such improvement will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 3, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Покращення якості предмета закупівлі, за умови що таке покращення не призведе до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 3 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"taxRate": {
"description_en": "Changes in the price in the purchase contract due to changes in tax and duty rates and/or changes in the conditions for granting tax benefits - in proportion to the change in such rates and/or tax benefits",
"title_en": "Clause 6, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни ціни в договорі про закупівлю у зв’язку зі зміною ставок податків і зборів та/або зміною умов щодо надання пільг з оподаткування - пропорційно до зміни таких ставок та/або пільг з оподаткування",
"title_uk": "Пункт 6 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"thirdParty": {
"description_en": "Changes in the consumer price index established in accordance with the legislation by state statistics bodies, changes in foreign currency exchange rates, changes in stock market quotes or Platts, ARGUS indicators of regulated prices (tariffs) and standards applied in the procurement contract, if the procurement contract establishes the procedure for changing the price",
"title_en": "Clause 7, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни встановленого згідно із законодавством органами державної статистики індексу споживчих цін, зміни курсу іноземної валюти, зміни біржових котирувань або показників Platts, ARGUS регульованих цін (тарифів) і нормативів, що застосовуються в договорі про закупівлю, у разі встановлення в договорі про закупівлю порядку зміни ціни",
"title_uk": "Пункт 7 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"volumeCuts": {
"description_en": "Reduction of the procurement's volume, particularly taking into account the actual expenditures of the procuring entity",
"title_en": "Clause 1, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зменшення обсягів закупівлі, зокрема з урахуванням фактичного обсягу видатків замовника",
"title_uk": "Пункт 1 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
}
},
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "8df554f83b464a2e952391aa6a518771"
},
"config": {
"hasAuction": true,
"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": 3,
"hasEnquiries": true,
"minEnquiriesDuration": 1,
"enquiryPeriodRegulation": 0,
"restricted": false,
"hasMultiSourcing": false
},
"access": {
"token": "1508e38e18ae4542b4ef7c569035bcc0",
"transfer": "3f6763d524f045d9a14e671f1c929110"
}
}
And again we have 201 Created response code, Location header and body with extra id, tenderID, and dateModified properties.
To move forward, you need to change status of procedure to draft.pending. This will let the bot to pull up Agreement in cfaua and move tender to the next status. If provided information meets all the requirements, than the bot moves procedure to active.enquiries status, else to draft.unsuccessful terminal status.
PATCH /api/2.5/tenders/42d9343086154eaf83080514ecd42ff6?acc_token=d2f4a5cf84ba424d8439f906e5faf58e HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "draft.pending"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"tenderID": "UA-2027-01-01-000001-a",
"owner": "broker",
"title": "футляри до державних нагород",
"procurementMethod": "selective",
"contractChangeRationaleTypes": {
"durationExtension": {
"description_en": "Extension of the period of the procurement contract duration and the term of obligations fulfilment regarding the transfer of goods, implementation of works and provision of services in case of documented objective circumstances that led to such extension, including circumstances of force majeure, delays in funding of procuring entitys expenditures, provided that such changes will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 4, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Продовження строку дії договору про закупівлю та строку виконання зобов’язань щодо передачі товару, виконання робіт, надання послуг у разі виникнення документально підтверджених об’єктивних обставин, що спричинили таке продовження, у тому числі обставин непереборної сили, затримки фінансування витрат замовника, за умови що такі зміни не призведуть до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 4 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"fiscalYearExtension": {
"description_en": "Еffect of the procurement contract may be extended for a period sufficient for conduction of the procurement procedure/simplified procurement at the beginning of the next year in volume that does not exceed 20% of the sum specified in the initial procurement contract concluded in the previous year, if expenditures for achieving this goal are approved in the prescribed manner",
"title_en": "Part 6 of Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Дія договору про закупівлю може бути продовжена на строк, достатній для проведення процедури закупівлі/спрощеної закупівлі на початку наступного року в обсязі, що не перевищує 20 відсотків суми, визначеної в початковому договорі про закупівлю, укладеному в попередньому році, якщо видатки на досягнення цієї цілі затверджено в установленому порядку",
"title_uk": "Частина 6 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceClarification": {
"description_en": "Drawing up a contract price, specified in accordance with the approved project documentation for the purchase contract, specified in paragraph three of part one of this article",
"title_en": "Clause 2, Part 7, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Складання договірної ціни, уточненої відповідно до затвердженої проектної документації до договору про закупівлю, зазначеного в абзаці третьому частини першої цієї статті",
"title_uk": "Пункт 2 частини 7 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"itemPriceVariation": {
"description_en": "An increase in the price per unit of goods by up to 10 percent in proportion to the increase in the market price of such goods in the event of fluctuations in the market price of such goods, provided that such a change does not lead to an increase in the amount specified in the procurement contract; - no more than once every 90 days from the date of signing the procurement contract/making changes to such a contract regarding an increase in the price per unit of goods. The restriction on the timing of changes in the price per unit of goods does not apply in cases of changes in the terms of the contract for the procurement of gasoline and diesel fuel, natural gas, and electricity",
"title_en": "Clause 2, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Збільшення ціни за одиницю товару до 10 відсотків пропорційно збільшенню ціни такого товару на ринку у разі коливання ціни такого товару на ринку за умови, що така зміна не призведе до збільшення суми, визначеної в договорі про закупівлю, - не частіше ніж один раз на 90 днів з моменту підписання договору про закупівлю/внесення змін до такого договору щодо збільшення ціни за одиницю товару. Обмеження щодо строків зміни ціни за одиницю товару не застосовується у випадках зміни умов договору про закупівлю бензину та дизельного пального, природного газу та електричної енергії",
"title_uk": "Пункт 2 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceReduction": {
"description_en": "Аpproval of price changes in the procurement contract in the direction of reduction (without changing the quantity (volume) and quality of goods, works and services), including in case of fluctuations in the price of goods on the market",
"title_en": "Clause 5, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Погодження зміни ціни в договорі про закупівлю в бік зменшення (без зміни кількості (обсягу) та якості товарів, робіт і послуг), у тому числі у разі коливання ціни товару на ринку",
"title_uk": "Пункт 5 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"qualityImprovement": {
"description_en": "Іmprovement of the item's quality, provided that such improvement will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 3, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Покращення якості предмета закупівлі, за умови що таке покращення не призведе до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 3 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"taxRate": {
"description_en": "Changes in the price in the purchase contract due to changes in tax and duty rates and/or changes in the conditions for granting tax benefits - in proportion to the change in such rates and/or tax benefits",
"title_en": "Clause 6, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни ціни в договорі про закупівлю у зв’язку зі зміною ставок податків і зборів та/або зміною умов щодо надання пільг з оподаткування - пропорційно до зміни таких ставок та/або пільг з оподаткування",
"title_uk": "Пункт 6 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"thirdParty": {
"description_en": "Changes in the consumer price index established in accordance with the legislation by state statistics bodies, changes in foreign currency exchange rates, changes in stock market quotes or Platts, ARGUS indicators of regulated prices (tariffs) and standards applied in the procurement contract, if the procurement contract establishes the procedure for changing the price",
"title_en": "Clause 7, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни встановленого згідно із законодавством органами державної статистики індексу споживчих цін, зміни курсу іноземної валюти, зміни біржових котирувань або показників Platts, ARGUS регульованих цін (тарифів) і нормативів, що застосовуються в договорі про закупівлю, у разі встановлення в договорі про закупівлю порядку зміни ціни",
"title_uk": "Пункт 7 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"volumeCuts": {
"description_en": "Reduction of the procurement's volume, particularly taking into account the actual expenditures of the procuring entity",
"title_en": "Clause 1, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зменшення обсягів закупівлі, зокрема з урахуванням фактичного обсягу видатків замовника",
"title_uk": "Пункт 1 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
}
},
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"name": "Державне управління справами 1",
"telephone": "+0440000000",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "draft.pending",
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"quantity": 5.0,
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"date": "2027-01-01T00:00:00+02:00",
"id": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-02T00:00:00+02:00"
},
"tenderPeriod": {
"startDate": "2027-01-02T00:00:00+02:00",
"endDate": "2027-01-05T00:00:00+02:00"
},
"id": "42d9343086154eaf83080514ecd42ff6"
},
"config": {
"hasAuction": true,
"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": 3,
"hasEnquiries": true,
"minEnquiriesDuration": 1,
"enquiryPeriodRegulation": 0,
"restricted": false,
"hasMultiSourcing": false
}
}
Let’s see, that our tender meets all the requirements, the bot pulled up Agreement in cfaua of tender and changed status to active.enquiries.
GET /api/2.5/tenders/42d9343086154eaf83080514ecd42ff6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"tenderID": "UA-2027-01-01-000001-a",
"owner": "broker",
"title": "футляри до державних нагород",
"procurementMethod": "selective",
"contractChangeRationaleTypes": {
"durationExtension": {
"description_en": "Extension of the period of the procurement contract duration and the term of obligations fulfilment regarding the transfer of goods, implementation of works and provision of services in case of documented objective circumstances that led to such extension, including circumstances of force majeure, delays in funding of procuring entitys expenditures, provided that such changes will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 4, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Продовження строку дії договору про закупівлю та строку виконання зобов’язань щодо передачі товару, виконання робіт, надання послуг у разі виникнення документально підтверджених об’єктивних обставин, що спричинили таке продовження, у тому числі обставин непереборної сили, затримки фінансування витрат замовника, за умови що такі зміни не призведуть до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 4 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"fiscalYearExtension": {
"description_en": "Еffect of the procurement contract may be extended for a period sufficient for conduction of the procurement procedure/simplified procurement at the beginning of the next year in volume that does not exceed 20% of the sum specified in the initial procurement contract concluded in the previous year, if expenditures for achieving this goal are approved in the prescribed manner",
"title_en": "Part 6 of Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Дія договору про закупівлю може бути продовжена на строк, достатній для проведення процедури закупівлі/спрощеної закупівлі на початку наступного року в обсязі, що не перевищує 20 відсотків суми, визначеної в початковому договорі про закупівлю, укладеному в попередньому році, якщо видатки на досягнення цієї цілі затверджено в установленому порядку",
"title_uk": "Частина 6 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceClarification": {
"description_en": "Drawing up a contract price, specified in accordance with the approved project documentation for the purchase contract, specified in paragraph three of part one of this article",
"title_en": "Clause 2, Part 7, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Складання договірної ціни, уточненої відповідно до затвердженої проектної документації до договору про закупівлю, зазначеного в абзаці третьому частини першої цієї статті",
"title_uk": "Пункт 2 частини 7 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"itemPriceVariation": {
"description_en": "An increase in the price per unit of goods by up to 10 percent in proportion to the increase in the market price of such goods in the event of fluctuations in the market price of such goods, provided that such a change does not lead to an increase in the amount specified in the procurement contract; - no more than once every 90 days from the date of signing the procurement contract/making changes to such a contract regarding an increase in the price per unit of goods. The restriction on the timing of changes in the price per unit of goods does not apply in cases of changes in the terms of the contract for the procurement of gasoline and diesel fuel, natural gas, and electricity",
"title_en": "Clause 2, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Збільшення ціни за одиницю товару до 10 відсотків пропорційно збільшенню ціни такого товару на ринку у разі коливання ціни такого товару на ринку за умови, що така зміна не призведе до збільшення суми, визначеної в договорі про закупівлю, - не частіше ніж один раз на 90 днів з моменту підписання договору про закупівлю/внесення змін до такого договору щодо збільшення ціни за одиницю товару. Обмеження щодо строків зміни ціни за одиницю товару не застосовується у випадках зміни умов договору про закупівлю бензину та дизельного пального, природного газу та електричної енергії",
"title_uk": "Пункт 2 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceReduction": {
"description_en": "Аpproval of price changes in the procurement contract in the direction of reduction (without changing the quantity (volume) and quality of goods, works and services), including in case of fluctuations in the price of goods on the market",
"title_en": "Clause 5, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Погодження зміни ціни в договорі про закупівлю в бік зменшення (без зміни кількості (обсягу) та якості товарів, робіт і послуг), у тому числі у разі коливання ціни товару на ринку",
"title_uk": "Пункт 5 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"qualityImprovement": {
"description_en": "Іmprovement of the item's quality, provided that such improvement will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 3, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Покращення якості предмета закупівлі, за умови що таке покращення не призведе до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 3 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"taxRate": {
"description_en": "Changes in the price in the purchase contract due to changes in tax and duty rates and/or changes in the conditions for granting tax benefits - in proportion to the change in such rates and/or tax benefits",
"title_en": "Clause 6, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни ціни в договорі про закупівлю у зв’язку зі зміною ставок податків і зборів та/або зміною умов щодо надання пільг з оподаткування - пропорційно до зміни таких ставок та/або пільг з оподаткування",
"title_uk": "Пункт 6 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"thirdParty": {
"description_en": "Changes in the consumer price index established in accordance with the legislation by state statistics bodies, changes in foreign currency exchange rates, changes in stock market quotes or Platts, ARGUS indicators of regulated prices (tariffs) and standards applied in the procurement contract, if the procurement contract establishes the procedure for changing the price",
"title_en": "Clause 7, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни встановленого згідно із законодавством органами державної статистики індексу споживчих цін, зміни курсу іноземної валюти, зміни біржових котирувань або показників Platts, ARGUS регульованих цін (тарифів) і нормативів, що застосовуються в договорі про закупівлю, у разі встановлення в договорі про закупівлю порядку зміни ціни",
"title_uk": "Пункт 7 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"volumeCuts": {
"description_en": "Reduction of the procurement's volume, particularly taking into account the actual expenditures of the procuring entity",
"title_en": "Clause 1, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зменшення обсягів закупівлі, зокрема з урахуванням фактичного обсягу видатків замовника",
"title_uk": "Пункт 1 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
}
},
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"name": "Державне управління справами 1",
"telephone": "+0440000000",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "active.enquiries",
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168",
"agreementID": "UA-2018-09-11-000002-1",
"dateSigned": "2018-09-11T11:23:23.220310+03:00",
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "Cases for state awards",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"period": {
"startDate": "2018-09-11T11:23:20.418390+03:00",
"endDate": "2222-01-23T11:23:20.418436+03:00"
},
"status": "active",
"contracts": [
{
"id": "d6cd8c3188d74e1481a9cebb57fd9329",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "large",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.0
}
}
],
"awardID": "d7406b07c05b4796bb168a7c47ee7d31",
"bidID": "0a292b6466274139ad3d973fd64830ff",
"date": "2018-07-30T17:40:15.471158+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"amount": 500.56,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "unsuccessful",
"suppliers": [
{
"name": "Державне управління справами 1",
"identifier": {
"scheme": "UA-EDR",
"id": "00037251",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами 1",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"amount": 500.56,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
},
{
"id": "d925d6c6124447d581f2ae5f52ba710f",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037258",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.0
}
}
],
"awardID": "a915a07f7f0b4dafa583cce119bf1823",
"bidID": "fc02090c338a477f8013156a4fa2da10",
"date": "2018-07-30T17:40:15.471264+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
}
],
"title": "[ТЕСТУВАННЯ] ",
"title_en": "[TESTING] ",
"title_ru": "[ТЕСТИРОВАНИЕ] ",
"tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32",
"dateModified": "2027-01-01T00:00:00+02:00",
"mode": "test",
"numberOfContracts": 3,
"owner": "broker",
"procuringEntity": {
"name": "Шевченківська районна в місті Києві державна адміністрація",
"name_en": "Angelica Davis",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Шевченківська районна в місті Києві державна адміністрація",
"legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\""
},
"contactPoint": {
"name": "Ліповець Євген Іванович",
"name_en": "Gregory Gillespie",
"email": "buh510@ukr.net",
"telephone": "+2341170",
"faxNumber": "2343591",
"url": "http://www.shev.gov.ua/",
"availableLanguage": "en"
},
"address": {
"streetAddress": "Богдана Хмельницького вулиця, 21-29",
"locality": "Переяслав-Хмельницький",
"region": "Київська область",
"postalCode": "01030",
"countryName": "Україна"
},
"kind": "general"
}
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"quantity": 5.0,
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"date": "2027-01-01T00:00:00+02:00",
"id": "66bd7aa82b7d403cb3626390997acbaf",
"value": {
"amount": 500.56,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"minimalStep": {
"amount": 2.5,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"auctionPeriod": {
"shouldStartAfter": "2027-01-05T00:00:00+02:00",
"startDate": "2027-01-05T13:09:55.701000+02:00"
}
}
],
"value": {
"amount": 500.56,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-02T00:00:00+02:00"
},
"tenderPeriod": {
"startDate": "2027-01-02T00:00:00+02:00",
"endDate": "2027-01-05T00:00:00+02:00"
},
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"next_check": "2027-01-02T00:00:00+02:00",
"id": "42d9343086154eaf83080514ecd42ff6"
},
"config": {
"hasAuction": true,
"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": 3,
"hasEnquiries": true,
"minEnquiriesDuration": 1,
"enquiryPeriodRegulation": 0,
"restricted": false,
"hasMultiSourcing": false
}
}
Let’s see what listing of tenders reveals us:
GET /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "42d9343086154eaf83080514ecd42ff6"
}
],
"next_page": {
"offset": "1798754400.0.1.c742207bda3cfbc93734ed6ddeae7bf3",
"path": "/api/2.5/tenders?offset=1798754400.0.1.c742207bda3cfbc93734ed6ddeae7bf3",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1798754400.0.1.c742207bda3cfbc93734ed6ddeae7bf3"
}
}
- When you create a procedure (draft status), you can fill in the following fields:
in Agreement in cfaua - id
in Tender - title, title_en, description, description_en, guarantee, procurementMethodType, procuringEntity
in Lot - title, title_en, description, description_en, id, guarantee
in Item - description, quantity, relatedLot, unit, description_en, classification, additionalClassifications, deliveryAddress, deliveryDate, deliveryLocation, id
The only field can be modified is Tender: status.
Modifying tender
Let’s update tender by supplementing it with all other essential properties:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"startDate": "2027-01-02T00:00:00+02:00",
"endDate": "2027-01-16T00:00:10+02:00"
},
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"quantity": 10,
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "item",
"code": "KGM"
}
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"tenderID": "UA-2027-01-01-000004-a",
"owner": "broker",
"title": "футляри до державних нагород",
"procurementMethod": "selective",
"contractChangeRationaleTypes": {
"durationExtension": {
"description_en": "Extension of the period of the procurement contract duration and the term of obligations fulfilment regarding the transfer of goods, implementation of works and provision of services in case of documented objective circumstances that led to such extension, including circumstances of force majeure, delays in funding of procuring entitys expenditures, provided that such changes will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 4, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Продовження строку дії договору про закупівлю та строку виконання зобов’язань щодо передачі товару, виконання робіт, надання послуг у разі виникнення документально підтверджених об’єктивних обставин, що спричинили таке продовження, у тому числі обставин непереборної сили, затримки фінансування витрат замовника, за умови що такі зміни не призведуть до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 4 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"fiscalYearExtension": {
"description_en": "Еffect of the procurement contract may be extended for a period sufficient for conduction of the procurement procedure/simplified procurement at the beginning of the next year in volume that does not exceed 20% of the sum specified in the initial procurement contract concluded in the previous year, if expenditures for achieving this goal are approved in the prescribed manner",
"title_en": "Part 6 of Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Дія договору про закупівлю може бути продовжена на строк, достатній для проведення процедури закупівлі/спрощеної закупівлі на початку наступного року в обсязі, що не перевищує 20 відсотків суми, визначеної в початковому договорі про закупівлю, укладеному в попередньому році, якщо видатки на досягнення цієї цілі затверджено в установленому порядку",
"title_uk": "Частина 6 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceClarification": {
"description_en": "Drawing up a contract price, specified in accordance with the approved project documentation for the purchase contract, specified in paragraph three of part one of this article",
"title_en": "Clause 2, Part 7, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Складання договірної ціни, уточненої відповідно до затвердженої проектної документації до договору про закупівлю, зазначеного в абзаці третьому частини першої цієї статті",
"title_uk": "Пункт 2 частини 7 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"itemPriceVariation": {
"description_en": "An increase in the price per unit of goods by up to 10 percent in proportion to the increase in the market price of such goods in the event of fluctuations in the market price of such goods, provided that such a change does not lead to an increase in the amount specified in the procurement contract; - no more than once every 90 days from the date of signing the procurement contract/making changes to such a contract regarding an increase in the price per unit of goods. The restriction on the timing of changes in the price per unit of goods does not apply in cases of changes in the terms of the contract for the procurement of gasoline and diesel fuel, natural gas, and electricity",
"title_en": "Clause 2, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Збільшення ціни за одиницю товару до 10 відсотків пропорційно збільшенню ціни такого товару на ринку у разі коливання ціни такого товару на ринку за умови, що така зміна не призведе до збільшення суми, визначеної в договорі про закупівлю, - не частіше ніж один раз на 90 днів з моменту підписання договору про закупівлю/внесення змін до такого договору щодо збільшення ціни за одиницю товару. Обмеження щодо строків зміни ціни за одиницю товару не застосовується у випадках зміни умов договору про закупівлю бензину та дизельного пального, природного газу та електричної енергії",
"title_uk": "Пункт 2 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceReduction": {
"description_en": "Аpproval of price changes in the procurement contract in the direction of reduction (without changing the quantity (volume) and quality of goods, works and services), including in case of fluctuations in the price of goods on the market",
"title_en": "Clause 5, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Погодження зміни ціни в договорі про закупівлю в бік зменшення (без зміни кількості (обсягу) та якості товарів, робіт і послуг), у тому числі у разі коливання ціни товару на ринку",
"title_uk": "Пункт 5 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"qualityImprovement": {
"description_en": "Іmprovement of the item's quality, provided that such improvement will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 3, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Покращення якості предмета закупівлі, за умови що таке покращення не призведе до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 3 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"taxRate": {
"description_en": "Changes in the price in the purchase contract due to changes in tax and duty rates and/or changes in the conditions for granting tax benefits - in proportion to the change in such rates and/or tax benefits",
"title_en": "Clause 6, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни ціни в договорі про закупівлю у зв’язку зі зміною ставок податків і зборів та/або зміною умов щодо надання пільг з оподаткування - пропорційно до зміни таких ставок та/або пільг з оподаткування",
"title_uk": "Пункт 6 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"thirdParty": {
"description_en": "Changes in the consumer price index established in accordance with the legislation by state statistics bodies, changes in foreign currency exchange rates, changes in stock market quotes or Platts, ARGUS indicators of regulated prices (tariffs) and standards applied in the procurement contract, if the procurement contract establishes the procedure for changing the price",
"title_en": "Clause 7, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни встановленого згідно із законодавством органами державної статистики індексу споживчих цін, зміни курсу іноземної валюти, зміни біржових котирувань або показників Platts, ARGUS регульованих цін (тарифів) і нормативів, що застосовуються в договорі про закупівлю, у разі встановлення в договорі про закупівлю порядку зміни ціни",
"title_uk": "Пункт 7 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"volumeCuts": {
"description_en": "Reduction of the procurement's volume, particularly taking into account the actual expenditures of the procuring entity",
"title_en": "Clause 1, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зменшення обсягів закупівлі, зокрема з урахуванням фактичного обсягу видатків замовника",
"title_uk": "Пункт 1 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
}
},
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"name": "Державне управління справами 1",
"telephone": "+0440000000",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "active.enquiries",
"agreements": [
{
"agreementID": "UA-2018-09-11-000002-1",
"dateSigned": "2018-09-11T11:23:23.220310+03:00",
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "Cases for state awards",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"period": {
"startDate": "2018-09-11T11:23:20.418390+03:00",
"endDate": "2222-01-23T11:23:20.418436+03:00"
},
"status": "active",
"contracts": [
{
"id": "d6cd8c3188d74e1481a9cebb57fd9329",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "large",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.0
}
}
],
"awardID": "d7406b07c05b4796bb168a7c47ee7d31",
"bidID": "0a292b6466274139ad3d973fd64830ff",
"date": "2018-07-30T17:40:15.471158+03:00",
"value": {
"amount": 1000.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"amount": 1001.11,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "unsuccessful",
"suppliers": [
{
"name": "Державне управління справами 1",
"identifier": {
"scheme": "UA-EDR",
"id": "00037251",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами 1",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"amount": 1001.11,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
},
{
"id": "d925d6c6124447d581f2ae5f52ba710f",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037258",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.0
}
}
],
"awardID": "a915a07f7f0b4dafa583cce119bf1823",
"bidID": "fc02090c338a477f8013156a4fa2da10",
"date": "2018-07-30T17:40:15.471264+03:00",
"value": {
"amount": 1000.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
}
],
"title": "[ТЕСТУВАННЯ] ",
"title_en": "[TESTING] ",
"title_ru": "[ТЕСТИРОВАНИЕ] ",
"tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32",
"dateModified": "2027-01-01T00:00:00+02:00",
"mode": "test",
"numberOfContracts": 3,
"owner": "broker",
"procuringEntity": {
"name": "Шевченківська районна в місті Києві державна адміністрація",
"name_en": "Angelica Davis",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Шевченківська районна в місті Києві державна адміністрація",
"legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\""
},
"contactPoint": {
"name": "Ліповець Євген Іванович",
"name_en": "Gregory Gillespie",
"email": "buh510@ukr.net",
"telephone": "+2341170",
"faxNumber": "2343591",
"url": "http://www.shev.gov.ua/",
"availableLanguage": "en"
},
"address": {
"streetAddress": "Богдана Хмельницького вулиця, 21-29",
"locality": "Переяслав-Хмельницький",
"region": "Київська область",
"postalCode": "01030",
"countryName": "Україна"
},
"kind": "general"
},
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"quantity": 10.0,
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"date": "2027-01-01T00:00:00+02:00",
"id": "66bd7aa82b7d403cb3626390997acbaf",
"value": {
"amount": 1001.11,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"minimalStep": {
"amount": 2.5,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"auctionPeriod": {
"startDate": "2027-01-18T12:29:40.230000+02:00",
"shouldStartAfter": "2027-01-17T00:00:00+02:00"
}
}
],
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"tenderPeriod": {
"startDate": "2027-01-02T00:00:00+02:00",
"endDate": "2027-01-16T00:00:10+02:00"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-02T00:00:00+02:00"
},
"value": {
"amount": 1001.11,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"next_check": "2027-01-02T00:00:00+02:00",
"id": "b4bcd8f9ee82480fb413c261d6cea972"
},
"config": {
"hasAuction": true,
"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": 3,
"hasEnquiries": true,
"minEnquiriesDuration": 1,
"enquiryPeriodRegulation": 0,
"restricted": false,
"hasMultiSourcing": false
}
}
We see the added properies 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:
GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "42d9343086154eaf83080514ecd42ff6"
},
{
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "b4bcd8f9ee82480fb413c261d6cea972"
}
],
"next_page": {
"offset": "1798754400.0.2.a965c6b1e98870c7825302418138cc9e",
"path": "/api/2.5/tenders?offset=1798754400.0.2.a965c6b1e98870c7825302418138cc9e",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1798754400.0.2.a965c6b1e98870c7825302418138cc9e"
}
}
Procuring entity can set bid guarantee:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/lots/66bd7aa82b7d403cb3626390997acbaf?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"guarantee": {
"amount": 8,
"currency": "USD"
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"date": "2027-01-01T00:00:00+02:00",
"id": "66bd7aa82b7d403cb3626390997acbaf",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 1001.11
},
"minimalStep": {
"amount": 2.5,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"guarantee": {
"amount": 8.0,
"currency": "USD"
},
"auctionPeriod": {
"startDate": "2027-01-18T12:29:40.230000+02:00",
"shouldStartAfter": "2027-01-17T00:00:00+02:00"
}
}
}
- You may modify the following fields on this stage of procedure:
tenderPeriod:endDate should differ from tender publication date at least on three days.
You can modify the same fields on this stage of procedure in the case of multiple Item selected.
Uploading documentation
Procuring entity should only upload digital signature on this stage of procedure.
Procuring entity can upload PDF files into the created tender. Uploading should follow the Documents Uploading rules.
POST /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/documents?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 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/3ba0f207674a43cf8e9d4c5871611d15?Signature=hZFi%2F8fyPtTO8f7JuJPvCyKTdf2qP8jMXmqeNgamJu9rpCq102mEfaQGA4dKdndRMLpVndNuuiVwyzBbRPqjDQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/documents/f3f54900b0c5465eaff2702da04c8865
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ba0f207674a43cf8e9d4c5871611d15?Signature=LBOVrszR%2FPkgCoL2sXgxu%2FmzZVj%2FZsLxKy%2BolJOPFUdWVmGXQ%2FA4uehXg4sua6XYNupyqdbZ0hqR2N8Fva4XDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "f3f54900b0c5465eaff2702da04c8865",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner"
}
}
201 Created response code and Location header confirm document creation. We can additionally query the documents collection API endpoint to confirm the action:
GET /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/documents/f3f54900b0c5465eaff2702da04c8865 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ba0f207674a43cf8e9d4c5871611d15?Signature=LBOVrszR%2FPkgCoL2sXgxu%2FmzZVj%2FZsLxKy%2BolJOPFUdWVmGXQ%2FA4uehXg4sua6XYNupyqdbZ0hqR2N8Fva4XDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "f3f54900b0c5465eaff2702da04c8865",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner"
}
}
The single array element describes the uploaded document. We can upload more documents:
POST /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/documents?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "AwardCriteria.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/14359ceb09f94a278561e1aa1095f780?Signature=uaMP35ppfeStRUCly9NIigi6uUo9y8E7XEG1CL7eRCQWM6L2%2FMYS51evUDziG9uAUIBmkHPjvZeV5%2Bte1LfcDA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/documents/cf72effb0e9541309a7a47d9f981e6df
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/14359ceb09f94a278561e1aa1095f780?Signature=jUv8MCIlmqdUjUYc8hckYZx2mhZdO9EJBSiumxzi6Cnx6oP8PtkJ5FsFq2%2BMpBw9S%2FGzIHOslPFXmVJGFcU0BA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "cf72effb0e9541309a7a47d9f981e6df",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner"
}
}
And again we can confirm that there are two documents uploaded.
GET /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "document description modified",
"id": "f3f54900b0c5465eaff2702da04c8865",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ba0f207674a43cf8e9d4c5871611d15?Signature=LBOVrszR%2FPkgCoL2sXgxu%2FmzZVj%2FZsLxKy%2BolJOPFUdWVmGXQ%2FA4uehXg4sua6XYNupyqdbZ0hqR2N8Fva4XDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/14359ceb09f94a278561e1aa1095f780?Signature=jUv8MCIlmqdUjUYc8hckYZx2mhZdO9EJBSiumxzi6Cnx6oP8PtkJ5FsFq2%2BMpBw9S%2FGzIHOslPFXmVJGFcU0BA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "cf72effb0e9541309a7a47d9f981e6df",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner"
}
]
}
Let’s add new documentType field with technicalSpecifications parameter to the previously uploaded document:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/documents/f3f54900b0c5465eaff2702da04c8865?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentType": "technicalSpecifications"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"documentType": "technicalSpecifications",
"id": "f3f54900b0c5465eaff2702da04c8865",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ba0f207674a43cf8e9d4c5871611d15?Signature=LBOVrszR%2FPkgCoL2sXgxu%2FmzZVj%2FZsLxKy%2BolJOPFUdWVmGXQ%2FA4uehXg4sua6XYNupyqdbZ0hqR2N8Fva4XDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
}
}
Success! Response code is 200 OK and it confirms that documentType field with technicalSpecifications parameter was added .
Now let’s try to modify any field in our document. For example, description:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/documents/f3f54900b0c5465eaff2702da04c8865?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"description": "document description modified"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "document description modified",
"id": "f3f54900b0c5465eaff2702da04c8865",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ba0f207674a43cf8e9d4c5871611d15?Signature=LBOVrszR%2FPkgCoL2sXgxu%2FmzZVj%2FZsLxKy%2BolJOPFUdWVmGXQ%2FA4uehXg4sua6XYNupyqdbZ0hqR2N8Fva4XDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
}
}
200 OK response was returned. The description was modified successfully.
In case we made an error, we can reupload the document over the older version:
PUT /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/documents/cf72effb0e9541309a7a47d9f981e6df?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "AwardCriteria.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc31c542db644a04a056d2f41e169385?Signature=G0ttxkOJR4wXRVNase3YdZw1fQddW3I6fsVFvs8hsuPhDS44j58gRTOuC9iIK%2Bq2MkLDU09o8wnQWoH5OtZRCw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"id": "cf72effb0e9541309a7a47d9f981e6df",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc31c542db644a04a056d2f41e169385?Signature=3iLysvaWuh1GF%2FU9cep86w%2Flqj6f4NSoN3gzTgfNzmhT3LfbPYcXYU9Tcu4Gee8A7eQobbzpis4j9eTFpbu1CQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
}
}
And we can see that it is overriding the original version:
GET /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "document description modified",
"id": "f3f54900b0c5465eaff2702da04c8865",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ba0f207674a43cf8e9d4c5871611d15?Signature=LBOVrszR%2FPkgCoL2sXgxu%2FmzZVj%2FZsLxKy%2BolJOPFUdWVmGXQ%2FA4uehXg4sua6XYNupyqdbZ0hqR2N8Fva4XDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"id": "cf72effb0e9541309a7a47d9f981e6df",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc31c542db644a04a056d2f41e169385?Signature=3iLysvaWuh1GF%2FU9cep86w%2Flqj6f4NSoN3gzTgfNzmhT3LfbPYcXYU9Tcu4Gee8A7eQobbzpis4j9eTFpbu1CQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
}
]
}
Registering bid
Step-by-step registration
When Tender.tenderingPeriod.startDate comes, Tender switches to active.tendering status that allows registration of bids.
Bidder can register a bid in draft status:
You cannot submit a bid greater than agreement.contract.value. Also Bidder can’t submit a bid if he is not party of this Framework Agreement (Agreement in cfaua).
POST /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21100",
"region": "Вінницька область",
"streetAddress": "вул. Островського, 33"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"name": "Сергій Олексюк",
"telephone": "+380432216930"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"status": "draft",
"lotValues": [
{
"value": {
"amount": 500
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"quantity": 10.0,
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 50.0
}
}
}
]
}
}
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Bid is not a member of agreement"
}
]
}
POST /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "large",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"status": "draft",
"lotValues": [
{
"value": {
"amount": 500
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"quantity": 10.0,
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 50.0
}
}
}
]
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids/9dd4fb4f9744467da45e0c9f4081374d
{
"data": {
"tenderers": [
{
"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"
},
"scale": "large"
}
],
"lotValues": [
{
"status": "pending",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"date": "2027-01-01T00:00:00+02:00"
}
],
"status": "draft",
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"unit": {
"name": "item",
"value": {
"amount": 50.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 10.0,
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"id": "9dd4fb4f9744467da45e0c9f4081374d",
"date": "2027-01-01T00:00:00+02:00"
},
"access": {
"token": "83f92bda690946688278a68cf744bee4",
"transfer": "e088df15af3449ba84f0ef8b879852a5"
}
}
Then bidder should approve bid with pending status. If tenderers.identifier.scheme = ‘UA-EDR’ it is required to add sign document to bid. If there is no sign document during activation, we will see an error:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids/9dd4fb4f9744467da45e0c9f4081374d?acc_token=83f92bda690946688278a68cf744bee4 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'proposal' and format pkcs7-signature is required"
}
]
}
Sign document should have documentType: proposal and title: *.p7s. Let’s add such document:
POST /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids/9dd4fb4f9744467da45e0c9f4081374d/documents?acc_token=83f92bda690946688278a68cf744bee4 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/18ea12dfc4e94e6c9943de2c76ac7697?Signature=l2AmKA39WC5aVwCpwaiD714kkm0aLeB2dzy9wRxRiG84ue20mNuuZWCi0Oo%2F%2BsF39qiJyqwn%2FODs82SdEOwxAw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "sign/p7s",
"documentType": "proposal"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids/9dd4fb4f9744467da45e0c9f4081374d/documents/e044f75804f8499b930234974905263e
{
"data": {
"confidentiality": "public",
"documentType": "proposal",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/18ea12dfc4e94e6c9943de2c76ac7697?Signature=rN3qahSbbx73%2B0CMO%2BYD4OARhMUPYJM4fIyW7RptCN4eeutRJvzaYJ%2FhNzO9OaPdx2pn0EE5w89kxd2Jb5KnCg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "e044f75804f8499b930234974905263e",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
}
Let’s try to activate bid one more time:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids/9dd4fb4f9744467da45e0c9f4081374d?acc_token=83f92bda690946688278a68cf744bee4 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"lotValues": [
{
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"status": "pending",
"date": "2027-01-01T00:00:00+02:00"
}
],
"tenderers": [
{
"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"
},
"scale": "large"
}
],
"status": "pending",
"id": "9dd4fb4f9744467da45e0c9f4081374d",
"date": "2027-01-01T00:00:00+02:00",
"documents": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "e044f75804f8499b930234974905263e",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/18ea12dfc4e94e6c9943de2c76ac7697?Signature=rN3qahSbbx73%2B0CMO%2BYD4OARhMUPYJM4fIyW7RptCN4eeutRJvzaYJ%2FhNzO9OaPdx2pn0EE5w89kxd2Jb5KnCg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"unit": {
"name": "item",
"value": {
"amount": 50.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 10.0,
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"submissionDate": "2027-01-01T00:00:00+02:00"
}
}
Bidder should only upload digital signature on this stage of procedure.
It is possible to check the uploaded documents:
GET /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids/9dd4fb4f9744467da45e0c9f4081374d/documents?acc_token=83f92bda690946688278a68cf744bee4 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "e044f75804f8499b930234974905263e",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/18ea12dfc4e94e6c9943de2c76ac7697?Signature=rN3qahSbbx73%2B0CMO%2BYD4OARhMUPYJM4fIyW7RptCN4eeutRJvzaYJ%2FhNzO9OaPdx2pn0EE5w89kxd2Jb5KnCg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
]
}
If we patched some fields in pending bid, then bid becomes invalid and should be signed one more time:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids/9dd4fb4f9744467da45e0c9f4081374d?acc_token=83f92bda690946688278a68cf744bee4 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"lotValues": [
{
"status": "pending",
"value": {
"amount": 510,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"date": "2027-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"quantity": 10.0,
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 51.0
}
}
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"lotValues": [
{
"value": {
"amount": 510.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"status": "pending",
"date": "2027-01-01T00:00:00+02:00"
}
],
"tenderers": [
{
"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"
},
"scale": "large"
}
],
"status": "invalid",
"id": "9dd4fb4f9744467da45e0c9f4081374d",
"date": "2027-01-01T00:00:00+02:00",
"submissionDate": "2027-01-01T00:00:00+02:00",
"documents": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "e044f75804f8499b930234974905263e",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/18ea12dfc4e94e6c9943de2c76ac7697?Signature=rN3qahSbbx73%2B0CMO%2BYD4OARhMUPYJM4fIyW7RptCN4eeutRJvzaYJ%2FhNzO9OaPdx2pn0EE5w89kxd2Jb5KnCg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"unit": {
"name": "item",
"value": {
"amount": 51.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 10.0,
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
]
}
}
If we try to activate bidder the new sign will be needed:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids/9dd4fb4f9744467da45e0c9f4081374d?acc_token=83f92bda690946688278a68cf744bee4 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'proposal' and format pkcs7-signature is required"
}
]
}
Batch-mode registration
Register bid with documents using one request:
POST /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"lotValues": [
{
"value": {
"amount": 499
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"documents": [
{
"title": "Proposal_part1.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3fa6d35497f649faafdc2dba7dcdecd5?Signature=9QWLee%2F5pHgobCTPkskXwQAYHTy03CGZ%2BzHlxKQaHuiuy3hAvQEJYR1k7hWnvxyeLtZYmYU2dtTaP7Iiq1QjCQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
},
{
"title": "Proposal_part2.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/df847d0a972a47449fdbcfb6d0552db4?Signature=S%2BEIhE%2FfUCleRbqrbfN7C5lVC%2FN%2BC5dytqiemkpii8SXkRaBgc2iP6wXo07oXFeBP9nFsOFUO8vNbbJKYKyqBQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"quantity": 10.0,
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 49.9
}
}
}
]
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids/570a8e1d582b45db9b79dcd3f2553c1b
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"lotValues": [
{
"status": "pending",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"date": "2027-01-01T00:01:00+02:00"
}
],
"status": "draft",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3fa6d35497f649faafdc2dba7dcdecd5?Signature=wQyre6x8c9J%2BhDgF6s0ErHWpfTvY69rKWh0zTeBuAV%2FRCG3ULxdMVg0A3neC1CYwgROArxgXYK6efVfhOxzqDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "7858cb309ac945909ba275cccee11ba6",
"datePublished": "2027-01-01T00:01:00+02:00",
"dateModified": "2027-01-01T00:01:00+02:00"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/df847d0a972a47449fdbcfb6d0552db4?Signature=3Eg3y4sxqiCqbOiXdkha%2B6Yi%2BZm4mqrMqTB14pCZ8FRRMuk%2FyL2JMzmSEP3jkVfF%2FWRTTOeUjlfC29X8UShQDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "fd192eba9b2c4ce6b8928b22ee62aec1",
"datePublished": "2027-01-01T00:01:00+02:00",
"dateModified": "2027-01-01T00:01:00+02:00"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"unit": {
"name": "item",
"value": {
"amount": 49.9,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 10.0,
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"id": "570a8e1d582b45db9b79dcd3f2553c1b",
"date": "2027-01-01T00:01:00+02:00"
},
"access": {
"token": "c14459cfcd3e4101b2bb1f83f04d0047",
"transfer": "47bde89e410f46efbf09a354b531427d"
}
}
Auction
After auction is scheduled anybody can visit it to watch. The auction can be reached at Tender.auctionUrl:
GET /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:01:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"tenderID": "UA-2027-01-01-000004-a",
"owner": "broker",
"title": "футляри до державних нагород",
"procurementMethod": "selective",
"contractChangeRationaleTypes": {
"durationExtension": {
"description_en": "Extension of the period of the procurement contract duration and the term of obligations fulfilment regarding the transfer of goods, implementation of works and provision of services in case of documented objective circumstances that led to such extension, including circumstances of force majeure, delays in funding of procuring entitys expenditures, provided that such changes will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 4, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Продовження строку дії договору про закупівлю та строку виконання зобов’язань щодо передачі товару, виконання робіт, надання послуг у разі виникнення документально підтверджених об’єктивних обставин, що спричинили таке продовження, у тому числі обставин непереборної сили, затримки фінансування витрат замовника, за умови що такі зміни не призведуть до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 4 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"fiscalYearExtension": {
"description_en": "Еffect of the procurement contract may be extended for a period sufficient for conduction of the procurement procedure/simplified procurement at the beginning of the next year in volume that does not exceed 20% of the sum specified in the initial procurement contract concluded in the previous year, if expenditures for achieving this goal are approved in the prescribed manner",
"title_en": "Part 6 of Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Дія договору про закупівлю може бути продовжена на строк, достатній для проведення процедури закупівлі/спрощеної закупівлі на початку наступного року в обсязі, що не перевищує 20 відсотків суми, визначеної в початковому договорі про закупівлю, укладеному в попередньому році, якщо видатки на досягнення цієї цілі затверджено в установленому порядку",
"title_uk": "Частина 6 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceClarification": {
"description_en": "Drawing up a contract price, specified in accordance with the approved project documentation for the purchase contract, specified in paragraph three of part one of this article",
"title_en": "Clause 2, Part 7, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Складання договірної ціни, уточненої відповідно до затвердженої проектної документації до договору про закупівлю, зазначеного в абзаці третьому частини першої цієї статті",
"title_uk": "Пункт 2 частини 7 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"itemPriceVariation": {
"description_en": "An increase in the price per unit of goods by up to 10 percent in proportion to the increase in the market price of such goods in the event of fluctuations in the market price of such goods, provided that such a change does not lead to an increase in the amount specified in the procurement contract; - no more than once every 90 days from the date of signing the procurement contract/making changes to such a contract regarding an increase in the price per unit of goods. The restriction on the timing of changes in the price per unit of goods does not apply in cases of changes in the terms of the contract for the procurement of gasoline and diesel fuel, natural gas, and electricity",
"title_en": "Clause 2, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Збільшення ціни за одиницю товару до 10 відсотків пропорційно збільшенню ціни такого товару на ринку у разі коливання ціни такого товару на ринку за умови, що така зміна не призведе до збільшення суми, визначеної в договорі про закупівлю, - не частіше ніж один раз на 90 днів з моменту підписання договору про закупівлю/внесення змін до такого договору щодо збільшення ціни за одиницю товару. Обмеження щодо строків зміни ціни за одиницю товару не застосовується у випадках зміни умов договору про закупівлю бензину та дизельного пального, природного газу та електричної енергії",
"title_uk": "Пункт 2 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceReduction": {
"description_en": "Аpproval of price changes in the procurement contract in the direction of reduction (without changing the quantity (volume) and quality of goods, works and services), including in case of fluctuations in the price of goods on the market",
"title_en": "Clause 5, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Погодження зміни ціни в договорі про закупівлю в бік зменшення (без зміни кількості (обсягу) та якості товарів, робіт і послуг), у тому числі у разі коливання ціни товару на ринку",
"title_uk": "Пункт 5 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"qualityImprovement": {
"description_en": "Іmprovement of the item's quality, provided that such improvement will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 3, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Покращення якості предмета закупівлі, за умови що таке покращення не призведе до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 3 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"taxRate": {
"description_en": "Changes in the price in the purchase contract due to changes in tax and duty rates and/or changes in the conditions for granting tax benefits - in proportion to the change in such rates and/or tax benefits",
"title_en": "Clause 6, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни ціни в договорі про закупівлю у зв’язку зі зміною ставок податків і зборів та/або зміною умов щодо надання пільг з оподаткування - пропорційно до зміни таких ставок та/або пільг з оподаткування",
"title_uk": "Пункт 6 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"thirdParty": {
"description_en": "Changes in the consumer price index established in accordance with the legislation by state statistics bodies, changes in foreign currency exchange rates, changes in stock market quotes or Platts, ARGUS indicators of regulated prices (tariffs) and standards applied in the procurement contract, if the procurement contract establishes the procedure for changing the price",
"title_en": "Clause 7, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни встановленого згідно із законодавством органами державної статистики індексу споживчих цін, зміни курсу іноземної валюти, зміни біржових котирувань або показників Platts, ARGUS регульованих цін (тарифів) і нормативів, що застосовуються в договорі про закупівлю, у разі встановлення в договорі про закупівлю порядку зміни ціни",
"title_uk": "Пункт 7 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"volumeCuts": {
"description_en": "Reduction of the procurement's volume, particularly taking into account the actual expenditures of the procuring entity",
"title_en": "Clause 1, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зменшення обсягів закупівлі, зокрема з урахуванням фактичного обсягу видатків замовника",
"title_uk": "Пункт 1 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
}
},
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"name": "Державне управління справами 1",
"telephone": "+0440000000",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "active.auction",
"agreements": [
{
"agreementID": "UA-2018-09-11-000002-1",
"dateSigned": "2018-09-11T11:23:23.220310+03:00",
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "Cases for state awards",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"period": {
"startDate": "2018-09-11T11:23:20.418390+03:00",
"endDate": "2222-01-23T11:23:20.418436+03:00"
},
"status": "active",
"contracts": [
{
"id": "d6cd8c3188d74e1481a9cebb57fd9329",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "large",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.0
}
}
],
"awardID": "d7406b07c05b4796bb168a7c47ee7d31",
"bidID": "0a292b6466274139ad3d973fd64830ff",
"date": "2018-07-30T17:40:15.471158+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 1000.0
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 1001.11
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "unsuccessful",
"suppliers": [
{
"name": "Державне управління справами 1",
"identifier": {
"scheme": "UA-EDR",
"id": "00037251",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами 1",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 1001.11
}
},
{
"id": "d925d6c6124447d581f2ae5f52ba710f",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037258",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 100.0
}
}
],
"awardID": "a915a07f7f0b4dafa583cce119bf1823",
"bidID": "fc02090c338a477f8013156a4fa2da10",
"date": "2018-07-30T17:40:15.471264+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 1000.0
}
}
],
"title": "[ТЕСТУВАННЯ] ",
"title_en": "[TESTING] ",
"title_ru": "[ТЕСТИРОВАНИЕ] ",
"tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32",
"dateModified": "2027-01-01T00:00:00+02:00",
"mode": "test",
"numberOfContracts": 3,
"owner": "broker",
"procuringEntity": {
"name": "Шевченківська районна в місті Києві державна адміністрація",
"name_en": "Angelica Davis",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Шевченківська районна в місті Києві державна адміністрація",
"legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\""
},
"contactPoint": {
"name": "Ліповець Євген Іванович",
"name_en": "Gregory Gillespie",
"email": "buh510@ukr.net",
"telephone": "+2341170",
"faxNumber": "2343591",
"url": "http://www.shev.gov.ua/",
"availableLanguage": "en"
},
"address": {
"streetAddress": "Богдана Хмельницького вулиця, 21-29",
"locality": "Переяслав-Хмельницький",
"region": "Київська область",
"postalCode": "01030",
"countryName": "Україна"
},
"kind": "general"
},
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"quantity": 10.0,
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"unit": {
"name": "item",
"code": "KGM"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"date": "2027-01-01T00:00:00+02:00",
"id": "66bd7aa82b7d403cb3626390997acbaf",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 1001.11
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 5.00555
},
"guarantee": {
"amount": 8.0,
"currency": "USD"
},
"auctionPeriod": {
"startDate": "2027-01-04T15:28:52.219000+02:00",
"shouldStartAfter": "2027-01-02T00:00:00+02:00"
},
"auctionUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/b4bcd8f9ee82480fb413c261d6cea972_66bd7aa82b7d403cb3626390997acbaf"
}
],
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"tenderPeriod": {
"startDate": "2026-12-28T00:01:00+02:00",
"endDate": "2027-01-01T00:01:00+02:00"
},
"enquiryPeriod": {
"startDate": "2026-12-26T00:01:00+02:00",
"endDate": "2026-12-28T00:01:00+02:00"
},
"value": {
"amount": 1001.11,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"next_check": "2027-01-04T15:28:52.219000+02:00",
"guarantee": {
"amount": 8.0,
"currency": "USD"
},
"documents": [
{
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "document description modified",
"id": "f3f54900b0c5465eaff2702da04c8865",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ba0f207674a43cf8e9d4c5871611d15?Signature=LBOVrszR%2FPkgCoL2sXgxu%2FmzZVj%2FZsLxKy%2BolJOPFUdWVmGXQ%2FA4uehXg4sua6XYNupyqdbZ0hqR2N8Fva4XDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/14359ceb09f94a278561e1aa1095f780?Signature=jUv8MCIlmqdUjUYc8hckYZx2mhZdO9EJBSiumxzi6Cnx6oP8PtkJ5FsFq2%2BMpBw9S%2FGzIHOslPFXmVJGFcU0BA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "cf72effb0e9541309a7a47d9f981e6df",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner"
},
{
"confidentiality": "public",
"id": "cf72effb0e9541309a7a47d9f981e6df",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc31c542db644a04a056d2f41e169385?Signature=3iLysvaWuh1GF%2FU9cep86w%2Flqj6f4NSoN3gzTgfNzmhT3LfbPYcXYU9Tcu4Gee8A7eQobbzpis4j9eTFpbu1CQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
}
],
"auctionPeriod": {},
"id": "b4bcd8f9ee82480fb413c261d6cea972"
},
"config": {
"hasAuction": true,
"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": 3,
"hasEnquiries": true,
"minEnquiriesDuration": 1,
"enquiryPeriodRegulation": 0,
"restricted": false,
"hasMultiSourcing": false
}
}
And bidders can find out their participation URLs via their bids:
GET /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids/9dd4fb4f9744467da45e0c9f4081374d?acc_token=83f92bda690946688278a68cf744bee4 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"lotValues": [
{
"value": {
"amount": 510.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"status": "active",
"date": "2027-01-01T00:01:00+02:00",
"initialValue": {
"amount": 510.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/b4bcd8f9ee82480fb413c261d6cea972_66bd7aa82b7d403cb3626390997acbaf?key_for_bid=9dd4fb4f9744467da45e0c9f4081374d"
}
],
"tenderers": [
{
"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"
},
"scale": "large"
}
],
"status": "active",
"id": "9dd4fb4f9744467da45e0c9f4081374d",
"date": "2027-01-01T00:01:00+02:00",
"submissionDate": "2027-01-01T00:01:00+02:00",
"documents": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "e044f75804f8499b930234974905263e",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/18ea12dfc4e94e6c9943de2c76ac7697?Signature=rN3qahSbbx73%2B0CMO%2BYD4OARhMUPYJM4fIyW7RptCN4eeutRJvzaYJ%2FhNzO9OaPdx2pn0EE5w89kxd2Jb5KnCg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"confidentiality": "public",
"documentType": "proposal",
"id": "e044f75804f8499b930234974905263e",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d6f1d8d573a74f4d852a5c8cf1d72299?Signature=0VfxsxSjYPY7Fp8hQoILA4B%2Fvmo9c9vpTCAyH1ZLJoX%2F0OgxqFDFjjRcY5d1f7cZZzIpp0HK%2BYqiTfMHdpS2Cw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"language": "uk"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"unit": {
"name": "item",
"value": {
"amount": 51.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 10.0,
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
]
}
}
See the Bid.participationUrl in the response. Similar, but different, URL can be retrieved for other participants:
GET /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/bids/570a8e1d582b45db9b79dcd3f2553c1b?acc_token=c14459cfcd3e4101b2bb1f83f04d0047 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"lotValues": [
{
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf",
"status": "active",
"date": "2027-01-01T00:01:00+02:00",
"initialValue": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/b4bcd8f9ee82480fb413c261d6cea972_66bd7aa82b7d403cb3626390997acbaf?key_for_bid=570a8e1d582b45db9b79dcd3f2553c1b"
}
],
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"status": "active",
"id": "570a8e1d582b45db9b79dcd3f2553c1b",
"date": "2027-01-01T00:01:00+02:00",
"documents": [
{
"confidentiality": "public",
"id": "7858cb309ac945909ba275cccee11ba6",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3fa6d35497f649faafdc2dba7dcdecd5?Signature=wQyre6x8c9J%2BhDgF6s0ErHWpfTvY69rKWh0zTeBuAV%2FRCG3ULxdMVg0A3neC1CYwgROArxgXYK6efVfhOxzqDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"language": "uk"
},
{
"confidentiality": "public",
"id": "fd192eba9b2c4ce6b8928b22ee62aec1",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/df847d0a972a47449fdbcfb6d0552db4?Signature=3Eg3y4sxqiCqbOiXdkha%2B6Yi%2BZm4mqrMqTB14pCZ8FRRMuk%2FyL2JMzmSEP3jkVfF%2FWRTTOeUjlfC29X8UShQDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"language": "uk"
},
{
"confidentiality": "public",
"documentType": "proposal",
"id": "c446b7244daf476ab324254cd5c4185c",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/04dcde65a16a413cbbaad61ad365ed37?Signature=qpHQFzOpnM8y7H60FpnEJJJA9uhiPgI%2FuMzCKEJvxl7EOM9eCts6BufVb8fCe7dGxLmof6jPU2V4zE6YL%2FanBA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"language": "uk"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"unit": {
"name": "item",
"value": {
"amount": 49.9,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 10.0,
"relatedLot": "66bd7aa82b7d403cb3626390997acbaf"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"submissionDate": "2027-01-01T00:01:00+02:00"
}
}
Listing awards
The pending award can be retrieved via request to list all available awards:
GET /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "eeaf3cee7bcc424f84976424d1db2d77",
"status": "pending",
"date": "2027-01-01T00:01:00+02:00",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"weightedValue": {
"currency": "UAH",
"amount": 388.11,
"denominator": 1.2857142857142858
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "570a8e1d582b45db9b79dcd3f2553c1b",
"lotID": "66bd7aa82b7d403cb3626390997acbaf",
"period": {
"startDate": "2027-01-01T00:01:00+02:00",
"endDate": "2027-01-09T00:00:00+02:00"
}
}
]
}
Confirming qualification
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:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/eeaf3cee7bcc424f84976424d1db2d77?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful",
"qualified": true
}
}
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:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/eeaf3cee7bcc424f84976424d1db2d77?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": false
}
}
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"
]
}
]
}
Before making decision it is required to add sign document to award. If there is no sign document during activation, we will see an error:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/eeaf3cee7bcc424f84976424d1db2d77?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
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"
}
]
}
The same logic for unsuccessful status:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/eeaf3cee7bcc424f84976424d1db2d77?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful",
"qualified": false
}
}
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:
POST /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/eeaf3cee7bcc424f84976424d1db2d77/documents?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 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/83a0dc4c58474a54a1a76a0443df626b?Signature=yZqnjfOYtOTe0uSbQtLc4Zn1P%2FJtSgcHl3bw7duIhiM7ysAUlFX4oimT3zJUw0bW2mNaH1KyBzRLqfUX3veYCw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/eeaf3cee7bcc424f84976424d1db2d77/documents/ad38def4bdb84e2aa58a4c34255f9a2b
{
"data": {
"confidentiality": "public",
"documentType": "notice",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/83a0dc4c58474a54a1a76a0443df626b?Signature=XyoDW7D%2BfWDYpf%2BvI575ZDhtiBX6bVoAmmbCZSrnLHe%2FyjtaTaxtu3zbrazbwKMOHmHaFf0gs0FnQprHCE9YDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "ad38def4bdb84e2aa58a4c34255f9a2b",
"datePublished": "2027-01-01T00:01:00+02:00",
"dateModified": "2027-01-01T00:01:00+02:00",
"author": "tender_owner"
}
}
Let’s try to disqualify award by switching it’s status from pending to unsuccessful.
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/eeaf3cee7bcc424f84976424d1db2d77?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful",
"qualified": false
}
}
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Can't update award status to unsuccessful, if tender status is active.qualification and there is no cancelled award with the same bid_id"
}
]
}
As we can see it is impossible. Procuring entity should activate pending award at first and switch it to cancelled status then.
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/eeaf3cee7bcc424f84976424d1db2d77?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "eeaf3cee7bcc424f84976424d1db2d77",
"status": "active",
"date": "2027-01-01T00:01:00+02:00",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"weightedValue": {
"currency": "UAH",
"amount": 388.11,
"denominator": 1.2857142857142858
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "570a8e1d582b45db9b79dcd3f2553c1b",
"lotID": "66bd7aa82b7d403cb3626390997acbaf",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "ad38def4bdb84e2aa58a4c34255f9a2b",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/83a0dc4c58474a54a1a76a0443df626b?Signature=XyoDW7D%2BfWDYpf%2BvI575ZDhtiBX6bVoAmmbCZSrnLHe%2FyjtaTaxtu3zbrazbwKMOHmHaFf0gs0FnQprHCE9YDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"author": "tender_owner",
"language": "uk"
}
],
"period": {
"startDate": "2027-01-01T00:01:00+02:00",
"endDate": "2027-01-09T00:00:00+02:00"
},
"qualified": true
}
}
Now cancelling active award.
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/eeaf3cee7bcc424f84976424d1db2d77?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/7f6c5662328e49d1b4923cf38caf4bfa
{
"data": {
"id": "eeaf3cee7bcc424f84976424d1db2d77",
"status": "cancelled",
"date": "2027-01-01T00:01:00+02:00",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"weightedValue": {
"currency": "UAH",
"amount": 388.11,
"denominator": 1.2857142857142858
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "570a8e1d582b45db9b79dcd3f2553c1b",
"lotID": "66bd7aa82b7d403cb3626390997acbaf",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "ad38def4bdb84e2aa58a4c34255f9a2b",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/83a0dc4c58474a54a1a76a0443df626b?Signature=XyoDW7D%2BfWDYpf%2BvI575ZDhtiBX6bVoAmmbCZSrnLHe%2FyjtaTaxtu3zbrazbwKMOHmHaFf0gs0FnQprHCE9YDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"author": "tender_owner",
"language": "uk"
}
],
"period": {
"startDate": "2027-01-01T00:01:00+02:00",
"endDate": "2027-01-09T00:00:00+02:00"
},
"qualified": true
}
}
We see that new pending award is generated for the same bidder now. So we can successfully switch this pending award to unsuccessful.
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/7f6c5662328e49d1b4923cf38caf4bfa?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful",
"qualified": false
}
}
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/3395f23d55b94f26b040afd105ea600f
{
"data": {
"id": "7f6c5662328e49d1b4923cf38caf4bfa",
"status": "unsuccessful",
"date": "2027-01-01T00:01:00+02:00",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"weightedValue": {
"currency": "UAH",
"amount": 388.11,
"denominator": 1.2857142857142858
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "570a8e1d582b45db9b79dcd3f2553c1b",
"lotID": "66bd7aa82b7d403cb3626390997acbaf",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "42f19f1da62d49fbb3897eb7b86a945c",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a499d50a22e54269a4c49b72eeb1ec6b?Signature=ezIzVFjQ2XwLY0TlkY6KWB36dyNtPZacTbX2mUvU5pBiv%2Bx37I6gsMbRy7g%2BBCTI4MtHA4UvkM6OePIE3N8RCw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"author": "tender_owner",
"language": "uk"
}
],
"period": {
"startDate": "2027-01-01T00:01:00+02:00",
"endDate": "2027-01-09T00:00:00+02:00"
},
"qualified": false
}
}
Qualification comission registers its decision via the following call:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/awards/3395f23d55b94f26b040afd105ea600f?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "3395f23d55b94f26b040afd105ea600f",
"status": "active",
"date": "2027-01-01T00:01:00+02:00",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"weightedValue": {
"currency": "UAH",
"amount": 388.11,
"denominator": 1.2857142857142858
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037258",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "eb1a65c5339349f491ffb6be7e74b641",
"lotID": "66bd7aa82b7d403cb3626390997acbaf",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "0d47176992a3498c8f151fcfc8eeeb88",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1cde1d1230724f8b85f3f49389aa119a?Signature=GIsI0QCfzUVpFAdXWyMtbIP4Neq%2BQVkRLlQJov1Se%2FfOubFnSa%2F7F7IDgBSkc%2FN52hlhyEZD6tHTbffHj2S3BQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"author": "tender_owner",
"language": "uk"
}
],
"period": {
"startDate": "2027-01-01T00:01:00+02:00",
"endDate": "2027-01-09T00:00:00+02:00"
},
"qualified": true
}
}
Procuring entity should fill the information about extension of the bidder’s term in the description field.
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 status active.auction or in terminal status e.g. unsuccessful, canceled, complete).
The following steps should be applied:
Prepare cancellation request
Fill it with the protocol describing the cancellation reasons
Cancel the tender with the reasons prepared.
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.
See Cancellation data structure for details.
Preparing the cancellation request
You should pass reason and reasonType, status defaults to draft.
There are four possible types of cancellation reason - tender was noDemand, unFixable, forceMajeure and expensesCut.
id is autogenerated and passed in the Location header of response.
POST /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/cancellations?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reason": "cancellation reason",
"reasonType": "noDemand"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/cancellations/9bd1f8dc532a494c823fc51ca4386ecf
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "9bd1f8dc532a494c823fc51ca4386ecf",
"date": "2027-01-01T00:01:00+02:00",
"cancellationOf": "tender",
"status": "draft"
}
}
Filling cancellation with protocol and supplementary documentation
This step is required. Without documents you can’t update tender status.
Upload the file contents
POST /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/cancellations/9bd1f8dc532a494c823fc51ca4386ecf/documents?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 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/4234daa316364795b45fa893dc7ede7e?Signature=MexgswUNonIWeecs0cnZHCe567LIUDGyFCFJM4USp7u3ICh9NuXTgLRLj%2FbriekuQrc%2BSN%2BX1BE1SuHis3V1AA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/cancellations/9bd1f8dc532a494c823fc51ca4386ecf/documents/3f4526c35da14b70a9ec520bbb456061
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4234daa316364795b45fa893dc7ede7e?Signature=8ceglBTUZmrmlwopAj86%2Bw4OZmQCr%2B4%2B2BA%2Bq0F0UKe8UJtDDwUxSAU3YiuTRaDosf%2BFG5fzWvlUBWGJPZKbCQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "3f4526c35da14b70a9ec520bbb456061",
"datePublished": "2027-01-01T00:01:00+02:00",
"dateModified": "2027-01-01T00:01:00+02:00"
}
}
Change the document description and other properties
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/cancellations/9bd1f8dc532a494c823fc51ca4386ecf/documents/3f4526c35da14b70a9ec520bbb456061?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"description": "Changed description"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"description": "Changed description",
"id": "3f4526c35da14b70a9ec520bbb456061",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4234daa316364795b45fa893dc7ede7e?Signature=8ceglBTUZmrmlwopAj86%2Bw4OZmQCr%2B4%2B2BA%2Bq0F0UKe8UJtDDwUxSAU3YiuTRaDosf%2BFG5fzWvlUBWGJPZKbCQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"language": "uk"
}
}
Upload new version of the document
PUT /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/cancellations/9bd1f8dc532a494c823fc51ca4386ecf/documents/3f4526c35da14b70a9ec520bbb456061?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 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/130c0ce9d3014d1292529f1edd390941?Signature=XyMGJOOv9e11g0GUntACvvW6ZfELFs1JTSyWJA2LzgYS63xqvqSTrAcAQ%2Flwt4f6VU5DKx2jbPRiqEgguxyPAA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"description": "Changed description",
"id": "3f4526c35da14b70a9ec520bbb456061",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/130c0ce9d3014d1292529f1edd390941?Signature=vyGheQ3nh0SwMUhU81m5GcG1PxUozEyq9dLyiJZrDLnGOao8Vf9rZNGlFAcUD0NjD15GXw%2BDRQc88orMAEceAg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"language": "uk"
}
}
Activating the request and cancelling tender
Before activating cancellation request, you must add a signature file to cancellation. If there is no signature file when activating the cancellation, we will see an error:
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/cancellations/9bd1f8dc532a494c823fc51ca4386ecf?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'cancellationReport' and format pkcs7-signature is required"
}
]
}
Sign document should have documentType: cancellationReport and title: *.p7s. Let’s add such document:
POST /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/cancellations/9bd1f8dc532a494c823fc51ca4386ecf/documents?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "sign.p7s",
"documentType": "cancellationReport",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e769513f6d5248f59a63617d89430c06?Signature=kci70aoyhArWdXdTKoKwzx%2FHxWA%2Fef7Z87QHGRJFNHdmL0IoiXrjInK22%2BzR%2FhFQoED4SlCjHBJq%2FckPDFtUCg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/cancellations/9bd1f8dc532a494c823fc51ca4386ecf/documents/5f07fe8860654fb7bd1b7d808f8b1804
{
"data": {
"confidentiality": "public",
"documentType": "cancellationReport",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e769513f6d5248f59a63617d89430c06?Signature=pDSTaxe4FoAt1g3u%2F3O92ub7AosZw5JGy6nMlhzlD%2BfGYtw1AAy0dQGilSxAJlsVUZjeYJeqaPpHHUxg3h6DAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "5f07fe8860654fb7bd1b7d808f8b1804",
"datePublished": "2027-01-01T00:01:00+02:00",
"dateModified": "2027-01-01T00:01:00+02:00"
}
}
Activate the request of cancelling tender
PATCH /api/2.5/tenders/b4bcd8f9ee82480fb413c261d6cea972/cancellations/9bd1f8dc532a494c823fc51ca4386ecf?acc_token=71a2cd2ca3764e0ba43ac51484c2c194 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "9bd1f8dc532a494c823fc51ca4386ecf",
"status": "active",
"date": "2027-01-01T00:01:00+02:00",
"reasonType": "noDemand",
"reason": "cancellation reason",
"cancellationOf": "tender",
"documents": [
{
"confidentiality": "public",
"description": "Changed description",
"id": "3f4526c35da14b70a9ec520bbb456061",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4234daa316364795b45fa893dc7ede7e?Signature=8ceglBTUZmrmlwopAj86%2Bw4OZmQCr%2B4%2B2BA%2Bq0F0UKe8UJtDDwUxSAU3YiuTRaDosf%2BFG5fzWvlUBWGJPZKbCQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"language": "uk"
},
{
"confidentiality": "public",
"description": "Changed description",
"id": "3f4526c35da14b70a9ec520bbb456061",
"datePublished": "2027-01-01T00:01:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/130c0ce9d3014d1292529f1edd390941?Signature=vyGheQ3nh0SwMUhU81m5GcG1PxUozEyq9dLyiJZrDLnGOao8Vf9rZNGlFAcUD0NjD15GXw%2BDRQc88orMAEceAg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2027-01-01T00:01:00+02:00",
"language": "uk"
},
{
"confidentiality": "public",
"documentType": "cancellationReport",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e769513f6d5248f59a63617d89430c06?Signature=pDSTaxe4FoAt1g3u%2F3O92ub7AosZw5JGy6nMlhzlD%2BfGYtw1AAy0dQGilSxAJlsVUZjeYJeqaPpHHUxg3h6DAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "5f07fe8860654fb7bd1b7d808f8b1804",
"datePublished": "2027-01-01T00:01:00+02:00",
"dateModified": "2027-01-01T00:01:00+02:00"
}
]
}
}
It may be useful to see top requirements: Test Cases for III level of accreditation and Test Cases for IV level of accreditation.