Tutorial
Configuration
The set of possible configuration values:
name |
values |
default |
---|---|---|
hasAuction |
false |
false |
hasAwardingOrder |
true |
true |
hasValueRestriction |
true |
true |
valueCurrencyEquality |
true |
true |
hasPrequalification |
false |
false |
minBidsNumber |
1 |
1 |
hasPreSelectionAgreement |
true |
true |
hasTenderComplaints |
false |
false |
hasAwardComplaints |
false |
false |
hasCancellationComplaints |
false |
false |
restricted |
false |
false |
You can look for more details in Configuration section.
Creating tender
Let’s provide the data attribute in the submitted body :
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"value": {
"amount": 22000,
"currency": "UAH"
},
"tenderPeriod": {
"endDate": "2023-10-04T01:00:00+03:00"
},
"procurementMethodType": "priceQuotation",
"procurementMethod": "selective",
"items": [
{
"description": "Комп’ютерне обладнання",
"quantity": 5,
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"profile": "655360-30230000-889652-40000777",
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"criteria": [
{
"description": "Форма випуску",
"requirementGroups": [
{
"description": "Форма випуску",
"requirements": [
{
"dataType": "string",
"expectedValue": "Розчин для інфузій",
"title": "Форма випуску"
}
]
}
],
"title": "Форма випуску"
},
{
"description": "Доза діючої речовини",
"requirementGroups": [
{
"description": "Доза діючої речовини",
"requirements": [
{
"dataType": "integer",
"minValue": 5,
"title": "Доза діючої речовини",
"unit": {
"code": "KGM",
"name": "кілограми"
}
}
]
}
],
"title": "Доза діючої речовини"
},
{
"description": "Форма випуску",
"requirementGroups": [
{
"description": "Форма випуску",
"requirements": [
{
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3,
"title": "Форма випуску"
}
]
}
],
"title": "Форма випуску"
}
]
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4
{
"data": {
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"title": "Комп’ютерне обладнання",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"endDate": "2023-10-04T01:00:00+03:00",
"startDate": "2023-09-20T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "04d0a215a93a4cd5beb0558049de9cc4",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "e177ce55c92c491cbc8d0431a6a25b8c",
"description": "Форма випуску",
"requirements": [
{
"id": "620397eaf9544635bb0366a1f65dae0e",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "549960a19ba44135be17d698eb40bb53",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "d160fa72c890473eb0595a4f111c3f51",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "68a31e41a65f44aeaf41d99090ac0db5",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "b56e2b8215974320966e2b85e567b0e8",
"description": "Форма випуску",
"requirements": [
{
"id": "2c6c054563904e35ac6e25b6ec864228",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"date": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"id": "3f38940af1314712ac29867b3e4eced4"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
},
"access": {
"token": "3f07ab10456e4f519a3cf51c24d19c80",
"transfer": "e92a5b619eb1406ba559e4ec7c1d9dfe"
}
}
Success! Now we can see that new object was created. Response code is 201 and Location response header reports the location of the created object. The body of response reveals the information about the created tender: its internal id (that matches the Location segment), its official tenderID and dateModified datestamp stating the moment in time when tender was last modified. Note that tender is created with draft status.
Note
User receives access: token with which operations as a Procuring Entity role are accessible.
Price Quotation procedure has procurementMethodType
: priceQuotation
and procurementMethod
: selective
.
Let’s access the URL of the created object (the Location header of the response):
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"title": "Комп’ютерне обладнання",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"endDate": "2023-10-04T01:00:00+03:00",
"startDate": "2023-09-20T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "04d0a215a93a4cd5beb0558049de9cc4",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "e177ce55c92c491cbc8d0431a6a25b8c",
"description": "Форма випуску",
"requirements": [
{
"id": "620397eaf9544635bb0366a1f65dae0e",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "549960a19ba44135be17d698eb40bb53",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "d160fa72c890473eb0595a4f111c3f51",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "68a31e41a65f44aeaf41d99090ac0db5",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "b56e2b8215974320966e2b85e567b0e8",
"description": "Форма випуску",
"requirements": [
{
"id": "2c6c054563904e35ac6e25b6ec864228",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"date": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"id": "3f38940af1314712ac29867b3e4eced4"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
We can see the same response we got after creating tender.
Modifying tender
Procuring Entity can modify tender before publishing. Let’s update tender by supplementing it with all other essential properties:
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-05T01:00:11+03:00"
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:01+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-05T01:00:11+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "04d0a215a93a4cd5beb0558049de9cc4",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "e177ce55c92c491cbc8d0431a6a25b8c",
"description": "Форма випуску",
"requirements": [
{
"id": "620397eaf9544635bb0366a1f65dae0e",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "549960a19ba44135be17d698eb40bb53",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "d160fa72c890473eb0595a4f111c3f51",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "68a31e41a65f44aeaf41d99090ac0db5",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "b56e2b8215974320966e2b85e567b0e8",
"description": "Форма випуску",
"requirements": [
{
"id": "2c6c054563904e35ac6e25b6ec864228",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"id": "3f38940af1314712ac29867b3e4eced4"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
We see the added properties have merged with existing tender data. Additionally, the dateModified property was updated to reflect the last modification datestamp.
Checking the listing again reflects the new modification date:
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": "2023-09-20T01:00:01+03:00",
"id": "3f38940af1314712ac29867b3e4eced4"
}
],
"next_page": {
"offset": 1695160801.0,
"path": "/api/2.5/tenders?offset=1695160801.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1695160801.0"
}
}
Publishing tender
After creation Procuring Entity publishes procedure by changing status to draft.publishing where priceQuotationBot robot runs validation of the procedure and supplement procedure with additional data taken from ProZorro e-Catalogues database including shortListedFirms.
PATCH /api/2.5/tenders/8fc54d118a544ade91d3c28d8c89affb?acc_token=5bc846d5687141fa9b6e6dda2122dd32 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "draft.publishing"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft.publishing",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "d53c5a78817b4eec8047b872c498f3f4",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "5d5b28b41e7a4cdcb4be7c7d889340a7",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "0ee557f53cbf4abda11383d9afd27419",
"description": "Форма випуску",
"requirements": [
{
"id": "05ddda51d81741938adee8a1d202c478",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "c98667d13e4d46c2adfd021d0af298b2",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "04517e7feb9f42e181c011c28753df20",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "ae21e9856f254105a5f69c269c708348",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "0b9b868b5ba4475f9219623d5d9fcd09",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "d87a09363c984c02ba40e8ea8c19e998",
"description": "Форма випуску",
"requirements": [
{
"id": "741bf2e4125247eabc8fa9bc82df246a",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"noticePublicationDate": "2023-09-20T01:00:00+03:00",
"id": "8fc54d118a544ade91d3c28d8c89affb"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
After successful validation priceQuotationBot transmit procedure to status: active.tendering
GET /api/2.5/tenders/8fc54d118a544ade91d3c28d8c89affb HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "active.tendering",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"shortlistedFirms": [
{
"name": "Товариство з обмеженою відповідальністю «Пікселі»",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Товариство з обмеженою відповідальністю «Пікселі»"
},
"address": {
"streetAddress": "бул.Дружби Народів, 8",
"locality": "м.Київ",
"region": "Київська область",
"postalCode": "01100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Оксана Піксель",
"email": "contact@pixel.pix",
"telephone": "+0671234567"
},
"scale": "large",
"id": "UA-EDR-12345678",
"status": "active"
},
{
"name": "Товариство з обмеженою відповідальністю «Штекер-Пекер»",
"identifier": {
"scheme": "UA-EDR",
"id": "87654321",
"legalName": "Товариство з обмеженою відповідальністю «Штекер-Пекер»"
},
"address": {
"streetAddress": "вул. Кластерна, 777-К",
"locality": "м.Тернопіль",
"region": "Тернопільська область",
"postalCode": "46000",
"countryName": "Україна"
},
"contactPoint": {
"name": "Олег Штекер",
"email": "info@shteker.pek",
"telephone": "+0951234567"
},
"scale": "large",
"id": "UA-EDR-87654321",
"status": "active"
}
],
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"noticePublicationDate": "2023-09-20T01:00:00+03:00",
"items": [
{
"id": "d53c5a78817b4eec8047b872c498f3f4",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "5d5b28b41e7a4cdcb4be7c7d889340a7",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "0ee557f53cbf4abda11383d9afd27419",
"description": "Форма випуску",
"requirements": [
{
"id": "05ddda51d81741938adee8a1d202c478",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "c98667d13e4d46c2adfd021d0af298b2",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "04517e7feb9f42e181c011c28753df20",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "ae21e9856f254105a5f69c269c708348",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "0b9b868b5ba4475f9219623d5d9fcd09",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "d87a09363c984c02ba40e8ea8c19e998",
"description": "Форма випуску",
"requirements": [
{
"id": "741bf2e4125247eabc8fa9bc82df246a",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"contractTemplateName": "00000000-0.0001.01",
"next_check": "2023-10-04T01:00:00+03:00",
"id": "8fc54d118a544ade91d3c28d8c89affb"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
In case if procedure do not pass validation due to invalid options, it will be switched to status: draft.unsuccessful by the priceQuotationBot.
GET /api/2.5/tenders/3a30afeece164702acbcbd999c068e6c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000002-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft.unsuccessful",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "f8940cf415e64f08a9d6259db7146e2b",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777bad_profile"
}
],
"criteria": [
{
"id": "852d1c7c0dac4281b448282ce4fda4ab",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "6d134dd3ce2a4997a25e5043af124258",
"description": "Форма випуску",
"requirements": [
{
"id": "f0f83e19edd941f9a8d146d638b5ad02",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "d3a0fd015db14f1aae290c3ce8302a93",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "db2dc0e37937449d8cabb64705d61a85",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "7edaf68d943b4d91b3bd12b0a599f0d1",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "842ff1e7b13a439da73e03cd68afdeb2",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "1f9e1751f91a4ee1af35a80131477c5d",
"description": "Форма випуску",
"requirements": [
{
"id": "88655f0a81744d3a865f958a550013e2",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"id": "3a30afeece164702acbcbd999c068e6c"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
Bid submission
Registering bid
Tender status active.tendering
allows registration of bids.
Bidder can register a bid with draft
status:
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"value": {
"amount": 469,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"requirement": {
"id": "2c6c054563904e35ac6e25b6ec864228"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "draft",
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0
}
]
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"value": {
"amount": 469.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "664cdc4af3b14a80890750ac88c5b5b6",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "b6478bf929684a39884e346a57e2aeee",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "b6e87f07d4dc4b989dec73c17059138f",
"requirement": {
"id": "2c6c054563904e35ac6e25b6ec864228"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "draft",
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0
}
],
"id": "e1e5b10f2f544862978912218b1bcb35",
"date": "2023-09-20T01:00:01+03:00"
},
"access": {
"token": "68c0f183a82143678b411345d129233c",
"transfer": "34a7da83c79448129b18ef4214fe4e42"
}
}
Note
User receives access: token with which operations as a Supplier role are accessible.
and approve to pending status:
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35?acc_token=68c0f183a82143678b411345d129233c 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": {
"id": "e1e5b10f2f544862978912218b1bcb35",
"date": "2023-09-20T01:00:01+03:00",
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "664cdc4af3b14a80890750ac88c5b5b6",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "b6478bf929684a39884e346a57e2aeee",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "b6e87f07d4dc4b989dec73c17059138f",
"requirement": {
"id": "2c6c054563904e35ac6e25b6ec864228"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "pending",
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0
}
]
}
}
Modifying bid
Bid can be updated until the end of tender period.
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35?acc_token=68c0f183a82143678b411345d129233c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 459
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e1e5b10f2f544862978912218b1bcb35",
"date": "2023-09-20T01:00:01+03:00",
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "664cdc4af3b14a80890750ac88c5b5b6",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "b6478bf929684a39884e346a57e2aeee",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "b6e87f07d4dc4b989dec73c17059138f",
"requirement": {
"id": "2c6c054563904e35ac6e25b6ec864228"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "draft",
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0
}
]
}
}
Proposal Uploading
Then bidder should upload proposal document(s):
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35/documents?acc_token=68c0f183a82143678b411345d129233c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Proposal.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7abe246945c74a798ef5abd6f6c3eacc?Signature=EkqkVQuxM0R2kMqqSHvh9wqelZ9s92zoy%2F8n3nXPtAiCUwONLevSQXvdstC7JGSuO743uvpHg7hGPeo6xrz3DA%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/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35/documents/5c63b9bde7d34f95896fb073e4ab8103
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7abe246945c74a798ef5abd6f6c3eacc?Signature=ix%2BAtoVHTr7n%2BtlzacHRzW5MXhg6cNDGh1H06A%2B%2Be5QADUguPxtLtZv0azfvgcsDePmEaAiMOiXEgsOVUNfIDw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "5c63b9bde7d34f95896fb073e4ab8103",
"confidentiality": "public",
"datePublished": "2023-09-20T01:00:01+03:00",
"dateModified": "2023-09-20T01:00:01+03:00"
}
}
It is possible to check the uploaded documents:
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35/documents?acc_token=68c0f183a82143678b411345d129233c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7abe246945c74a798ef5abd6f6c3eacc?Signature=ix%2BAtoVHTr7n%2BtlzacHRzW5MXhg6cNDGh1H06A%2B%2Be5QADUguPxtLtZv0azfvgcsDePmEaAiMOiXEgsOVUNfIDw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "5c63b9bde7d34f95896fb073e4ab8103",
"confidentiality": "public",
"datePublished": "2023-09-20T01:00:01+03:00",
"dateModified": "2023-09-20T01:00:01+03:00"
}
]
}
Awarding process
After the tender period end date, system automatically creates award in pending status for the bid with the most economically advantageous price.
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"status": "pending",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"date": "2023-09-20T01:00:01+03:00",
"id": "dcf5db2bd67c47faaf0b9cc04f6539fe"
}
]
}
Procuring Entity can accept award by transferring it to status: active.
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/dcf5db2bd67c47faaf0b9cc04f6539fe?acc_token=3f07ab10456e4f519a3cf51c24d19c80 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": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "active",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
}
}
Let’s check the listing of awards:
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/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": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "active",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
}
]
}
Procuring Entity can cancel award after acceptance by changing award status to cancelled:
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/dcf5db2bd67c47faaf0b9cc04f6539fe?acc_token=3f07ab10456e4f519a3cf51c24d19c80 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/3f38940af1314712ac29867b3e4eced4/awards/ef0d25ab94dc424fa0a0863235ada151
{
"data": {
"id": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "cancelled",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
}
}
After canceling award system creates second award for the same bid in status: pending:
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/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": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "cancelled",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
},
{
"id": "ef0d25ab94dc424fa0a0863235ada151",
"status": "pending",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
}
]
}
If the offer of the Participant with the lowest price meets the requirements, Procuring Entity uploads a document that recognizes the offer as the Winner (awards:status:active). If it does not meet the requirements, Procuring Entity downloads a protocol confirming its decision to reject the Participant and rejects such an offer (awards:status:unsuccessful). The system leads to the evaluation of the next one with most economically advantageous price (awards:status:pending).
Let’s decline award by transferring it to status: unsuccessful.
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/ef0d25ab94dc424fa0a0863235ada151?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/e01ef20540ac40c288dcd352b827253a
{
"data": {
"id": "ef0d25ab94dc424fa0a0863235ada151",
"status": "unsuccessful",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
}
}
In that case Award will be granted to the next bid with most economically advantageous price.
Let’s check the listing of awards:
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/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": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "cancelled",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
},
{
"id": "ef0d25ab94dc424fa0a0863235ada151",
"status": "unsuccessful",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
},
{
"id": "e01ef20540ac40c288dcd352b827253a",
"status": "pending",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 479.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "7555abc429b14bd7a5fb385a6c7931c1"
}
]
}
Procuring Entity can accept second bidder award by transferring it to status: active.
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/e01ef20540ac40c288dcd352b827253a?acc_token=3f07ab10456e4f519a3cf51c24d19c80 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": "e01ef20540ac40c288dcd352b827253a",
"status": "active",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 479.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "7555abc429b14bd7a5fb385a6c7931c1"
}
}
Let’s check the listing of awards:
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/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": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "cancelled",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
},
{
"id": "ef0d25ab94dc424fa0a0863235ada151",
"status": "unsuccessful",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
},
{
"id": "e01ef20540ac40c288dcd352b827253a",
"status": "active",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 479.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "7555abc429b14bd7a5fb385a6c7931c1"
}
]
}
Note
In the case of award being transferred to unsuccessful status for the last bid procedure will inherit termination status: `unsuccessful`.
Setting Contract
All operations with contract moved to EContracting API interface to OpenProcurement database
Cancelling tender
Tender creator can cancel tender anytime (except when tender in terminal status e.g. draft.unsuccessful, unsuccessful, cancelled, complete).
The following steps should be applied:
Prepare cancellation request.
Fill it with the protocol describing the cancellation reasons.
Cancel the tender with the prepared reasons.
Only the request that has been activated (3rd step above) has power to cancel tender. I.e. you have to not only prepare cancellation request but to activate it as well.
For cancelled cancellation you need to update cancellation status to unsuccessful from draft or pending.
See Cancellation data structure for details.
Preparing the cancellation request
You should pass reason and reasonType, status defaults to draft.
There are 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/3f38940af1314712ac29867b3e4eced4/cancellations?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reason": "cancellation reason",
"reasonType": "noDemand"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "0162fbd6680f40e8b12a7235ace8cf98",
"date": "2023-09-20T01:00:01+03:00",
"cancellationOf": "tender",
"status": "draft"
}
}
You can change reasonType
value to any of the above.
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "expensesCut"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0162fbd6680f40e8b12a7235ace8cf98",
"status": "draft",
"date": "2023-09-20T01:00:01+03:00",
"reasonType": "expensesCut",
"reason": "cancellation reason",
"cancellationOf": "tender"
}
}
Filling cancellation with protocol and supplementary documentation
This step is required. Without documents you can’t update tender status.
Upload the file contents
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b51f286a456744a5aa311917ee24504a?Signature=9KkaDLqMGbQT%2B1ZKKh3fJraW%2FS7QAVYc0beKGLk%2FoPDSU6H0gnqVXDCI%2FoxpGshn0cGW4M11zMwTHJnkiGprAQ%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/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents/497191c24d4b49759574f384a2690a30
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b51f286a456744a5aa311917ee24504a?Signature=YHcahWxxAcYSGa9HFfWHlPRBYSaTYUUi1lPh0gSVQiBwIX0MWoVsCpKb7%2BIM5t113k1MQNMMMe8%2F0aPDtaXACQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "497191c24d4b49759574f384a2690a30",
"datePublished": "2023-09-20T01:00:01+03:00",
"dateModified": "2023-09-20T01:00:01+03:00"
}
}
Change the document description and other properties
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents/497191c24d4b49759574f384a2690a30?acc_token=3f07ab10456e4f519a3cf51c24d19c80 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": {
"description": "Changed description",
"id": "497191c24d4b49759574f384a2690a30",
"datePublished": "2023-09-20T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b51f286a456744a5aa311917ee24504a?Signature=YHcahWxxAcYSGa9HFfWHlPRBYSaTYUUi1lPh0gSVQiBwIX0MWoVsCpKb7%2BIM5t113k1MQNMMMe8%2F0aPDtaXACQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-09-20T01:00:01+03:00",
"language": "uk"
}
}
Upload new version of the document
PUT /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents/497191c24d4b49759574f384a2690a30?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice-2.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/04b19e98abbc481f944b5a4e1376e930?Signature=AXwZfcLUrCdPBMKtiuBJGEVMMujTL08LBQ2Jbz%2B1erbKeFVm0PQEhPFa5BLoIDu3msiBjhnTTDV9H19Z1sDoBQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"description": "Changed description",
"id": "497191c24d4b49759574f384a2690a30",
"datePublished": "2023-09-20T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice-2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/04b19e98abbc481f944b5a4e1376e930?Signature=wonP7nxBLzgfRnPAAi4UlfqIzubU3uA9sSG4fWwckC9AK2Bh3G1LX7aeiqEq%2FuX5hCnBCY2b%2FIAjawi66cfiDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-09-20T01:00:01+03:00",
"language": "uk"
}
}
Activating the request and cancelling tender
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0162fbd6680f40e8b12a7235ace8cf98",
"status": "active",
"date": "2023-09-20T01:00:01+03:00",
"reasonType": "expensesCut",
"reason": "cancellation reason",
"cancellationOf": "tender",
"documents": [
{
"description": "Changed description",
"id": "497191c24d4b49759574f384a2690a30",
"datePublished": "2023-09-20T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b51f286a456744a5aa311917ee24504a?Signature=YHcahWxxAcYSGa9HFfWHlPRBYSaTYUUi1lPh0gSVQiBwIX0MWoVsCpKb7%2BIM5t113k1MQNMMMe8%2F0aPDtaXACQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-09-20T01:00:01+03:00",
"language": "uk"
},
{
"description": "Changed description",
"id": "497191c24d4b49759574f384a2690a30",
"datePublished": "2023-09-20T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice-2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/04b19e98abbc481f944b5a4e1376e930?Signature=wonP7nxBLzgfRnPAAi4UlfqIzubU3uA9sSG4fWwckC9AK2Bh3G1LX7aeiqEq%2FuX5hCnBCY2b%2FIAjawi66cfiDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-09-20T01:00:01+03:00",
"language": "uk"
}
]
}
}