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 :
Request
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-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
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4
{
"data": {
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"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):
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"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:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-05T01:00:11+03:00"
}
}
}
Response
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:
Request
GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "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 (deprecated)
After creation Procuring Entity publishes procedure by changing status to draft.publishing where priceQuotationBot robot runs validation of the procedure and supplement procedure with additional data taken from ProZorro e-Catalogues database including shortListedFirms.
Request
PATCH /api/2.5/tenders/8fc54d118a544ade91d3c28d8c89affb?acc_token=5bc846d5687141fa9b6e6dda2122dd32 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "draft.publishing"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft.publishing",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "d53c5a78817b4eec8047b872c498f3f4",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "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
Request
GET /api/2.5/tenders/8fc54d118a544ade91d3c28d8c89affb HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "active.tendering",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"shortlistedFirms": [
{
"name": "Товариство з обмеженою відповідальністю «Пікселі»",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Товариство з обмеженою відповідальністю «Пікселі»"
},
"address": {
"streetAddress": "бул.Дружби Народів, 8",
"locality": "м.Київ",
"region": "Київська область",
"postalCode": "01100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Оксана Піксель",
"email": "contact@pixel.pix",
"telephone": "+0671234567"
},
"scale": "large",
"id": "UA-EDR-12345678",
"status": "active"
},
{
"name": "Товариство з обмеженою відповідальністю «Штекер-Пекер»",
"identifier": {
"scheme": "UA-EDR",
"id": "87654321",
"legalName": "Товариство з обмеженою відповідальністю «Штекер-Пекер»"
},
"address": {
"streetAddress": "вул. Кластерна, 777-К",
"locality": "м.Тернопіль",
"region": "Тернопільська область",
"postalCode": "46000",
"countryName": "Україна"
},
"contactPoint": {
"name": "Олег Штекер",
"email": "info@shteker.pek",
"telephone": "+0951234567"
},
"scale": "large",
"id": "UA-EDR-87654321",
"status": "active"
}
],
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"noticePublicationDate": "2023-09-20T01:00:00+03:00",
"items": [
{
"id": "d53c5a78817b4eec8047b872c498f3f4",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "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.
Request
GET /api/2.5/tenders/3a30afeece164702acbcbd999c068e6c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000002-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft.unsuccessful",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "f8940cf415e64f08a9d6259db7146e2b",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777bad_profile"
}
],
"criteria": [
{
"id": "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
}
}
Activating tender
After creation Procuring Entity can activate tender by changing status to active.tendering.
During activation CBD runs some validations:
Existence of item profile in catalogue
Profile should be active or general
Existence of related agreement
Equality of profile agreement and related agreement in tender
Agreement should not be in terminated status
If Procuring Entity will try to activate PQ procedure with non-existed profile in catalogue, we will see error:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.tendering"
}
}
Response
HTTP/1.0 404 Not Found
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Profile 655360-30230000-889652-40000777 not found in catalouges."
}
]
}
If profile isn’t in active status, we will see error:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.tendering"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Profile 655360-30230000-889652-40000777 is not active"
}
]
}
In case profile agreement and related agreement in tender aren’t equal, the next error will be generated:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.tendering"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Tender agreement doesn't match profile agreement"
}
]
}
If agreement is in terminated status:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.tendering"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "agreement",
"description": "Agreement status is not active"
}
]
}
If PQ procedure matches all requirements, it will be switched to active.tendering:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.tendering"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:01+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": "active.tendering",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:01+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
}
]
}
]
}
],
"noticePublicationDate": "2023-09-20T01:00:01+03:00",
"contractTemplateName": "00000000-0.0001.01",
"next_check": "2023-10-05T01:00:11+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
}
}
Bid submission
Registering bid
Tender status active.tendering allows registration of bids.
If bid tenderer is not a member of agreement, than we will see an error during registration of bid:
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037200",
"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
}
]
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Bid is not a member of agreement"
}
]
}
Bidder can register a bid with draft status:
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-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
}
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/b8994ac5b9f340da9a0620b8a7b2d8fc
{
"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": "micro"
}
],
"value": {
"amount": 469.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "263249613a324c02ab92203210fb6697",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "95c4273df2af4d31b14c8ce523af1c6f",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "25b694b64afb46a4b2b851fcd9ec61d5",
"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": "b8994ac5b9f340da9a0620b8a7b2d8fc",
"date": "2023-09-20T01:00:01+03:00"
},
"access": {
"token": "56cb85db213f48b395e87a7e1a6023ca",
"transfer": "a5ff5605ae044304893634777fc00e14"
}
}
Note
User receives access: token with which operations as a Supplier role are accessible.
and approve to pending status:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/b8994ac5b9f340da9a0620b8a7b2d8fc?acc_token=56cb85db213f48b395e87a7e1a6023ca HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "b8994ac5b9f340da9a0620b8a7b2d8fc",
"date": "2023-09-20T01:00:01+03: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": "micro"
}
],
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "263249613a324c02ab92203210fb6697",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "95c4273df2af4d31b14c8ce523af1c6f",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "25b694b64afb46a4b2b851fcd9ec61d5",
"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
}
]
}
}
If bid tenderer is not a member of agreement, than we will see an error during registration of bid:
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037200",
"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
}
]
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Bid is not a member of agreement"
}
]
}
Modifying bid
Bid can be updated until the end of tender period.
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/b8994ac5b9f340da9a0620b8a7b2d8fc?acc_token=56cb85db213f48b395e87a7e1a6023ca HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 459
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "b8994ac5b9f340da9a0620b8a7b2d8fc",
"date": "2023-09-20T01:00:01+03: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": "micro"
}
],
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "263249613a324c02ab92203210fb6697",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "95c4273df2af4d31b14c8ce523af1c6f",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "25b694b64afb46a4b2b851fcd9ec61d5",
"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
}
]
}
}
Deleting bid
Bid can be deleted until the end of tender period.
Let’s add new bid to tender:
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-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
}
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/55faa050ef4746c29fc00870518cecad
{
"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": "micro"
}
],
"value": {
"amount": 469.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "35730c0398b84c39b7b6aaaa4e2e84d5",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "d12ecd4d92534e269fe805c201b998c0",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "57aa9e6b70c7414f9ff8b700294b2e9c",
"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": "55faa050ef4746c29fc00870518cecad",
"date": "2023-09-20T01:00:01+03:00"
},
"access": {
"token": "1e67ef046652447ea98fbc09899c438b",
"transfer": "07e6c71a869149a6966a19245036d955"
}
}
Now we can delete this bid:
Request
DELETE /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/55faa050ef4746c29fc00870518cecad?acc_token=1e67ef046652447ea98fbc09899c438b HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "deleted",
"id": "55faa050ef4746c29fc00870518cecad"
}
}
If bidder try to restore you bi, we will see the next error:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/55faa050ef4746c29fc00870518cecad?acc_token=1e67ef046652447ea98fbc09899c438b HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Can't update bid in (deleted) status"
}
]
}
Proposal Uploading
Then bidder should upload proposal document(s):
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/b8994ac5b9f340da9a0620b8a7b2d8fc/documents?acc_token=56cb85db213f48b395e87a7e1a6023ca 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"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/b8994ac5b9f340da9a0620b8a7b2d8fc/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:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/b8994ac5b9f340da9a0620b8a7b2d8fc/documents?acc_token=56cb85db213f48b395e87a7e1a6023ca HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
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"
}
]
}
Active tendering period end
After tender period ended, CBD checks one more time status of contract for suppliers in agreement. If contract status is still active - bid is getting active status too, in other cases - bid gets invalid status.
Let’s imagine that second contract supplier in agreement was disqualified during active.tendering period.
Let’s see our bids statuses after active.tendering period ends. Last bid was disqualified:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "b8994ac5b9f340da9a0620b8a7b2d8fc",
"date": "2023-09-20T01:00:01+03: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": "micro"
}
],
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "263249613a324c02ab92203210fb6697",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "95c4273df2af4d31b14c8ce523af1c6f",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "25b694b64afb46a4b2b851fcd9ec61d5",
"requirement": {
"id": "2c6c054563904e35ac6e25b6ec864228"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "active",
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0
}
],
"documents": [
{
"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"
}
]
},
{
"status": "deleted",
"id": "55faa050ef4746c29fc00870518cecad"
},
{
"id": "70bec639abd44364ae412469587562fc",
"date": "2023-09-20T01:00:01+03:00",
"documents": [
{
"id": "2e798473b06143a284ea2bd8b82831a3",
"datePublished": "2023-09-20T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0ec8fd2dc59a45c4a279f23fb91b2572?Signature=ogddqQNir075wYIRhUPZ6oI5BUvzCD30E0FvQqiiXat9Qib4uMcaop9PnCuO%2BH7lRvmqEqZSraQo3AifEAl8DA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-09-20T01:00:01+03:00",
"language": "uk",
"confidentiality": "public"
},
{
"id": "c6817fd1670a44149fc0dedfb4a3736e",
"datePublished": "2023-09-20T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ec3cbabab3334b0f9405d0b48698fee7?Signature=qBVCZkrQZf2v6sbyohuyI5iQ37pvbp2baN2rdLaaHZkgB5P7KyYmNcfEe1tOEs5WB0P%2B1udLNbUMVs9KEFPIDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-09-20T01:00:01+03:00",
"language": "uk",
"confidentiality": "public"
}
],
"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": "micro"
}
],
"value": {
"amount": 479.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "ce911d42154d49879569c0342fd22433",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "f7da109e540d4d0fb70554dabb00198e",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "52d8d6f0a5dc445586591f9ec952f2f1",
"requirement": {
"id": "2c6c054563904e35ac6e25b6ec864228"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "active",
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0
}
]
},
{
"id": "959df55b73cd4bb09dd7fb17be8d0c51",
"status": "invalid"
}
]
}
Awarding process
After the tender period end date, system automatically creates award in pending status for the bid with the most economically advantageous price.
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "a7c8e239bb0447ab8b05fb0782a7c640",
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "b8994ac5b9f340da9a0620b8a7b2d8fc"
}
]
}
Procuring Entity can accept award by transferring it to status: active.
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/a7c8e239bb0447ab8b05fb0782a7c640?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "a7c8e239bb0447ab8b05fb0782a7c640",
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "b8994ac5b9f340da9a0620b8a7b2d8fc"
}
}
Let’s check the listing of awards:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "a7c8e239bb0447ab8b05fb0782a7c640",
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "b8994ac5b9f340da9a0620b8a7b2d8fc"
}
]
}
Procuring Entity can cancel award after acceptance by changing award status to cancelled:
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/a7c8e239bb0447ab8b05fb0782a7c640?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/ef0d25ab94dc424fa0a0863235ada151
{
"data": {
"id": "a7c8e239bb0447ab8b05fb0782a7c640",
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "b8994ac5b9f340da9a0620b8a7b2d8fc"
}
}
After canceling award system creates second award for the same bid in status: pending:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "a7c8e239bb0447ab8b05fb0782a7c640",
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "b8994ac5b9f340da9a0620b8a7b2d8fc"
},
{
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "b8994ac5b9f340da9a0620b8a7b2d8fc"
}
]
}
If the offer of the Participant with the lowest price meets the requirements, Procuring Entity uploads a document that recognizes the offer as the Winner (awards:status:active). If it does not meet the requirements, Procuring Entity downloads a protocol confirming its decision to reject the Participant and rejects such an offer (awards:status:unsuccessful). The system leads to the evaluation of the next one with most economically advantageous price (awards:status:pending).
Let’s decline award by transferring it to status: unsuccessful.
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/ef0d25ab94dc424fa0a0863235ada151?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful"
}
}
Response
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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "b8994ac5b9f340da9a0620b8a7b2d8fc"
}
}
In that case Award will be granted to the next bid with most economically advantageous price.
Let’s check the listing of awards:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "a7c8e239bb0447ab8b05fb0782a7c640",
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "b8994ac5b9f340da9a0620b8a7b2d8fc"
},
{
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "b8994ac5b9f340da9a0620b8a7b2d8fc"
},
{
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "70bec639abd44364ae412469587562fc"
}
]
}
Procuring Entity can accept second bidder award by transferring it to status: active.
Request
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"
}
}
Response
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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "70bec639abd44364ae412469587562fc"
}
}
Let’s check the listing of awards:
Request
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "a7c8e239bb0447ab8b05fb0782a7c640",
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "b8994ac5b9f340da9a0620b8a7b2d8fc"
},
{
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "b8994ac5b9f340da9a0620b8a7b2d8fc"
},
{
"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/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"bid_id": "70bec639abd44364ae412469587562fc"
}
]
}
Note
In the case of award being transferred to unsuccessful status for the last bid procedure will inherit termination status: `unsuccessful`.
Setting Contract
There are to modes of contracting depending on system configuration:
Regular contracting
In regular contacting the contract will be created in tender system first.
Read more about working with regular contracting in tendering system in Tutorial (registration) section.
When the tender is completed (after contracts activation), contract (that has been created in the tender system) is transferred to the contract system automatically.
Read more about working with regular contracting in contracting system in Tutorial section.
EContracting
In EContracting the contract is created directly in contracting system.
Note
Some of data will be mirrored to tender until contract will be activated for backward compatibility.
Read more about working with EContracting in contracting system in Tutorial section.
Cancelling tender
Tender creator can cancel tender anytime (except when tender in terminal status e.g. draft.unsuccessful, unsuccessful, cancelled, complete).
The following steps should be applied:
Prepare cancellation request.
Fill it with the protocol describing the cancellation reasons.
Cancel the tender with the prepared reasons.
Only the request that has been activated (3rd step above) has power to cancel tender. I.e. you have to not only prepare cancellation request but to activate it as well.
For cancelled cancellation you need to update cancellation status to unsuccessful from draft or pending.
See Cancellation data structure for details.
Preparing the cancellation request
You should pass reason and reasonType, status defaults to draft.
There are four possible types of cancellation reason - tender was noDemand, unFixable, forceMajeure and expensesCut.
id is autogenerated and passed in the Location header of response.
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reason": "cancellation reason",
"reasonType": "noDemand"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "0162fbd6680f40e8b12a7235ace8cf98",
"date": "2023-09-20T01:00:01+03:00",
"cancellationOf": "tender",
"status": "draft"
}
}
You can change reasonType value to any of the above.
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "expensesCut"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0162fbd6680f40e8b12a7235ace8cf98",
"status": "draft",
"date": "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
Request
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b51f286a456744a5aa311917ee24504a?Signature=9KkaDLqMGbQT%2B1ZKKh3fJraW%2FS7QAVYc0beKGLk%2FoPDSU6H0gnqVXDCI%2FoxpGshn0cGW4M11zMwTHJnkiGprAQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents/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
Request
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"
}
}
Response
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
Request
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"
}
}
Response
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
Request
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0162fbd6680f40e8b12a7235ace8cf98",
"status": "active",
"date": "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"
}
]
}
}