Tutorial
Configuration
The set of possible configuration values:
name |
values |
default |
days |
|---|---|---|---|
hasAuction |
true / false |
false |
|
hasAwardingOrder |
true / false |
false |
|
hasValueRestriction |
true / false |
false |
|
valueCurrencyEquality |
true / false |
false |
|
hasPrequalification |
true / false |
false |
|
minBidsNumber |
1 - 9 |
1 |
|
hasPreSelectionAgreement |
true / false |
false |
|
hasTenderComplaints |
false |
false |
|
hasAwardComplaints |
false |
false |
|
hasCancellationComplaints |
false |
false |
|
hasValueEstimation |
true / false |
false |
|
hasQualificationComplaints |
false |
false |
|
tenderComplainRegulation |
0 |
0 |
|
qualificationComplainDuration |
10 |
working |
|
awardComplainDuration |
2 |
2 |
|
cancellationComplainDuration |
0 |
0 |
|
clarificationUntilDuration |
4 |
4 |
calendar |
qualificationDuration |
20 |
20 |
|
minTenderingDuration |
4 |
4 |
calendar |
hasEnquiries |
true |
true |
|
minEnquiriesDuration |
3 |
3 |
calendar |
enquiryPeriodRegulation |
3 |
3 |
calendar |
restricted |
false |
false |
You can look for more details in Configuration section.
Tender with inspector
You can get info here: Tender Inspector Tutorial
Creating tender
Tender requestForProposal may have pre-selection procedure and can be connected to agreement.
Let’s use next agreement for our example:
Request
GET /api/2.5/agreements/144de8e79e64488a967c57cebaacb0d3 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-10-10-000001",
"frameworkID": "5bbf44a4849d4cb8a80c469d8d91231e",
"agreementType": "internationalFinancialInstitutions",
"status": "active",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-12-03T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "general"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"contracts": [
{
"id": "0024966553564a8f812f84689d34148c",
"qualificationID": "da120b087f8c42f18d4c12b374cdf2eb",
"submissionID": "78e643e7c5c94f6c9e686ffa9c723713",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "12345678",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"email": "aa@aa.com"
}
}
],
"milestones": [
{
"id": "00464c7636ce464bb05b8504af6f9d9b",
"status": "scheduled",
"type": "activation",
"dueDate": "2024-12-03T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "71493e93a3804e8b8c23cfcc21d838cf",
"qualificationID": "93225b64f2dc409292bfe706bf11b712",
"submissionID": "73c23c0a23454500a3a406ef0b592b69",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "12345679",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"email": "aa@aa.com"
}
}
],
"milestones": [
{
"id": "f09b253e29ee403a93db4be0fc9c4d54",
"status": "scheduled",
"type": "activation",
"dueDate": "2024-12-03T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "a4ff7ab0a7794f20af93e8f54678b8f6",
"qualificationID": "1de5a50bb22b483baf5812ade87f8d0a",
"submissionID": "65b9f9a60a1d4d82998ca065a810da81",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "12345671",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"email": "aa@aa.com"
}
}
],
"milestones": [
{
"id": "6cb16718fd5c44beb4a3d0fc3a6323ed",
"status": "scheduled",
"type": "activation",
"dueDate": "2024-12-03T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"owner": "broker",
"dateModified": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"next_check": "2024-12-03T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"id": "144de8e79e64488a967c57cebaacb0d3"
},
"config": {
"restricted": false
}
}
We can create tender connected to this agreement:
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",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"classification": {
"scheme": "ДК021",
"id": "03111600-8",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кілограм",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T00:00:00+02:00"
},
"procurementMethodType": "requestForProposal",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45
}
],
"contractTemplateName": "00000000.0002.01",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/137bba901398466a9aa1880da2ade9a6
{
"data": {
"mainProcurementCategory": "goods",
"contractTemplateName": "00000000.0002.01",
"title": "футляри до державних нагород",
"status": "draft",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "4b7d2866ae0e4de7b1ccffded4f891fc",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"procurementMethod": "selective",
"submissionMethod": "electronicAuction",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "137bba901398466a9aa1880da2ade9a6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
},
"access": {
"token": "76e7037e0a9a445f8bfe44a967308c41",
"transfer": "4651d7baa45945d09ba9d2e5c433d1a2"
}
}
Success! Now we can see that new object was created. Response code is 201 and Location response header reports the location of the created object. The body of response reveals the information about the created tender: its internal id (that matches the Location segment), its official tenderID and dateModified datestamp stating the moment in time when tender was last modified. Pay attention to the procurementMethodType. Note that tender is created with draft status.
Let’s access the URL of the created object (the Location header of the response):
Request
GET /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6 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",
"contractTemplateName": "00000000.0002.01",
"title": "футляри до державних нагород",
"status": "draft",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "4b7d2866ae0e4de7b1ccffded4f891fc",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"procurementMethod": "selective",
"submissionMethod": "electronicAuction",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "137bba901398466a9aa1880da2ade9a6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
We can see the same response we got after creating tender.
Let’s see what listing of tenders reveals us:
Request
GET /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [],
"next_page": {
"offset": "",
"path": "/api/2.5/tenders",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders"
}
}
We don’t see internal id of tender, because tender appears in the listing from active.enquiries status.
Tender can contain several different lots. We can add lot using the following way:
Request
POST /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/lots?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "lot title",
"description": "lot description",
"value": {
"amount": 500,
"currency": "UAH"
},
"minimalStep": {
"amount": 15,
"currency": "UAH"
}
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/lots/880b8274983b40cfa8455e8e3d82bb70
{
"data": {
"title": "lot title",
"description": "lot description",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"status": "active",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"minimalStep": {
"currency": "UAH",
"amount": 15.0,
"valueAddedTaxIncluded": true
},
"date": "2023-10-10T01:00:00+03:00"
}
}
Also you will need to update data about item’s related lots:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"status": "draft",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 15.0
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "4b7d2866ae0e4de7b1ccffded4f891fc",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00",
"endDate": "2023-10-17T00:00:00+02:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"id": "137bba901398466a9aa1880da2ade9a6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Tender activating
For activating tender you should update status to active.enquiries:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.enquiries"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"status": "active.enquiries",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 15.0
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "4b7d2866ae0e4de7b1ccffded4f891fc",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00",
"endDate": "2023-10-17T00:00:00+02:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"next_check": "2023-10-17T00:00:00+02:00",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"id": "137bba901398466a9aa1880da2ade9a6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Let’s see what listing of tenders reveals us:
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-10-10T01:00:00+03:00",
"id": "137bba901398466a9aa1880da2ade9a6"
}
],
"next_page": {
"offset": "1696888800.0.1.b852b8685edadbe58aeb393d5cc0d5d2",
"path": "/api/2.5/tenders?offset=1696888800.0.1.b852b8685edadbe58aeb393d5cc0d5d2",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1696888800.0.1.b852b8685edadbe58aeb393d5cc0d5d2"
}
}
We do see the internal id of a tender (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/tenders/) and its dateModified datestamp.
Creating second tender
The previous tender contained only required fields. Let’s try creating tender with more data (tender has status created):
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": "футляри до державних нагород",
"title_en": "Cases with state awards",
"title_ru": "футляры к государственным наградам",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кілограм",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T00:00:00+02:00"
},
"procurementMethodType": "requestForProposal",
"mode": "test",
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"value": 0.1,
"title": "До 1000 Вт"
},
{
"value": 0.15,
"title": "Більше 1000 Вт"
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"value": 0.05,
"title": "До 3 років"
},
{
"value": 0.1,
"title": "Більше 3 років, менше 5 років"
},
{
"value": 0.15,
"title": "Більше 5 років"
}
]
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"percentage": 45.55,
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45,
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
}
],
"mainProcurementCategory": "services",
"contractTemplateName": "00000000.0002.01",
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "85459ec7097d4e0489bc373a9f039e7a",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 15.0
}
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/d9348acb91fa4dd59c3248bf74029319
{
"data": {
"mainProcurementCategory": "services",
"title_en": "[TESTING] Cases with state awards",
"title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
"contractTemplateName": "00000000.0002.01",
"title": "[ТЕСТУВАННЯ] футляри до державних нагород",
"mode": "test",
"status": "draft",
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"date": "2023-10-10T01:00:00+03:00",
"id": "85459ec7097d4e0489bc373a9f039e7a",
"status": "active",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"minimalStep": {
"currency": "UAH",
"amount": 15.0,
"valueAddedTaxIncluded": true
}
}
],
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"value": 0.1,
"title": "До 1000 Вт"
},
{
"value": 0.15,
"title": "Більше 1000 Вт"
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"value": 0.05,
"title": "До 3 років"
},
{
"value": 0.1,
"title": "Більше 3 років, менше 5 років"
},
{
"value": 0.15,
"title": "Більше 5 років"
}
]
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
},
{
"id": "db46b86e200b4e97b3167cb7f3255765",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
}
],
"tenderID": "UA-2023-10-10-000002-a",
"owner": "broker",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "d9348acb91fa4dd59c3248bf74029319"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
},
"access": {
"token": "c15de98e7a17408e95e488963349b713",
"transfer": "8c79c0513bb34497835251331efce717"
}
}
And again we have 201 Created response code, Location header and body with extra id, tenderID, and dateModified properties.
Let’s check what tender registry contains:
Request
GET /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "137bba901398466a9aa1880da2ade9a6"
},
{
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "0a6891e35335413c84571febcaedd50d"
}
],
"next_page": {
"offset": "1696888800.0.2.2f2f7d41be40d83ce62a1f11f34732cc",
"path": "/api/2.5/tenders?offset=1696888800.0.2.2f2f7d41be40d83ce62a1f11f34732cc",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1696888800.0.2.2f2f7d41be40d83ce62a1f11f34732cc"
}
}
And indeed we have 2 tenders now.
We can create tender with optional funders field:
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",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кілограм",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T00:00:00+02:00"
},
"procurementMethodType": "requestForProposal",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45
}
],
"contractTemplateName": "00000000.0002.01",
"funders": [
{
"additionalIdentifiers": [],
"address": {
"countryName": "Швейцарська Конфедерація",
"locality": "Geneva",
"postalCode": "1218",
"region": "Grand-Saconnex",
"streetAddress": "Global Health Campus, Chemin du Pommier 40"
},
"contactPoint": {
"email": "ccm@theglobalfund.org",
"faxNumber": "+41 44 580 6820",
"name": "",
"telephone": "+41587911700",
"url": "https://www.theglobalfund.org/en/"
},
"identifier": {
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією",
"scheme": "XM-DAC"
},
"name": "Глобальний фонд"
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/edf794081dcd444fbd0b8cc1e31f792b
{
"data": {
"mainProcurementCategory": "goods",
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"title": "футляри до державних нагород",
"status": "draft",
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "287eac32299645e58057bf526f3f67c8",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"tenderID": "UA-2023-10-10-000003-a",
"owner": "broker",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "edf794081dcd444fbd0b8cc1e31f792b"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
},
"access": {
"token": "4c97ef37809a4c2f9a609abb1d016459",
"transfer": "21ff86c0635d4aceb88fce04e474b6ac"
}
}
Modifying tender
Let’s update tender by supplementing it with all other essential properties:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-25T01:00:11+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"status": "active.enquiries",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"next_check": "2023-10-17T00:00:00+02:00",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-25T01:00:11+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 15.0
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "4b7d2866ae0e4de7b1ccffded4f891fc",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00",
"endDate": "2023-10-17T00:00:00+02:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"id": "137bba901398466a9aa1880da2ade9a6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
We see the added properies have merged with existing tender data. Additionally, the dateModified property was updated to reflect the last modification datestamp.
Checking the listing again reflects the new modification date:
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-10-10T01:00:00+03:00",
"id": "0a6891e35335413c84571febcaedd50d"
},
{
"dateModified": "2023-10-10T01:00:01+03:00",
"id": "137bba901398466a9aa1880da2ade9a6"
}
],
"next_page": {
"offset": "1696888801.0.1.b852b8685edadbe58aeb393d5cc0d5d2",
"path": "/api/2.5/tenders?offset=1696888801.0.1.b852b8685edadbe58aeb393d5cc0d5d2",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1696888801.0.1.b852b8685edadbe58aeb393d5cc0d5d2"
}
}
Procuring entity can set bid guarantee:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"guarantee": {
"amount": 8,
"currency": "USD"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"status": "active.enquiries",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"guarantee": {
"amount": 8.0,
"currency": "USD"
},
"next_check": "2023-10-17T00:00:00+02:00",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-25T01:00:11+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 15.0
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "4b7d2866ae0e4de7b1ccffded4f891fc",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00",
"endDate": "2023-10-17T00:00:00+02:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"id": "137bba901398466a9aa1880da2ade9a6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Also we can modify tender by adding funders field data:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"funders": [
{
"additionalIdentifiers": [],
"address": {
"countryName": "Швейцарська Конфедерація",
"locality": "Geneva",
"postalCode": "1218",
"region": "Grand-Saconnex",
"streetAddress": "Global Health Campus, Chemin du Pommier 40"
},
"contactPoint": {
"email": "ccm@theglobalfund.org",
"faxNumber": "+41 44 580 6820",
"name": "",
"telephone": "+41587911700",
"url": "https://www.theglobalfund.org/en/"
},
"identifier": {
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією",
"scheme": "XM-DAC"
},
"name": "Глобальний фонд"
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"status": "active.enquiries",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"next_check": "2023-10-17T00:00:00+02:00",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-25T01:00:11+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 15.0
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "4b7d2866ae0e4de7b1ccffded4f891fc",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00",
"endDate": "2023-10-17T00:00:00+02:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"id": "137bba901398466a9aa1880da2ade9a6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Procuring entity can not change tenderPeriod.endDate if there are less than 4 days before tenderPeriod ends. Changes will not be accepted by API.
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 501.0
},
"tenderPeriod": {
"endDate": "2023-10-18T01:10:05+03:00"
}
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "tenderPeriod should be extended by 4 days"
}
]
}
That is why tenderPeriod has to be extended by minimum 4 days.
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 501,
"currency": "UAH"
},
"tenderPeriod": {
"endDate": "2023-10-21T01:10:05+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-16T01:14:06+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"questions": [
{
"id": "18aed6d02f154d56b9784733349f80f0",
"author": {
"hash": "0008badd6aa9dd04675d471581d21e5f"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"date": "2023-10-10T01:10:05+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"questionOf": "tender",
"dateAnswered": "2023-10-10T01:10:05+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d990d4897b1a47a19bf707544e0c8c39?Signature=Odg7g4lnQq9K23uhoeviII9%2BTeGyK%2BZebhgl5aO%2FJj1M4qGN5N%2Fq0TCVhB39EYEVdlWkc0V%2B3rnS%2FDb4w%2Fd7Bg%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:06:04+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/67b500f3327a4160bff847fa3b925862?Signature=QDxTKt%2F6a6o%2F969%2BED3IcEBTGuad5zzNYo28gOuxadXnyR0axXnzhPWvrEHCP4VwkSewBFtL2VvUFUHm%2FE9PBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:06:04+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:10:05+03:00",
"hash": "md5:11111111111111111111111111111111",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b1f6e46ecf5b4734b57a1aceb67834c1?Signature=%2Bq%2F%2FE5Sml8snWliS1olYK%2Bk9P5xg%2Bp0PVGPhAjQOELiMK882BsSWbDnohWwS9zCChlXkEgWdayK5lb2oDaVeBA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:10:05+03:00",
"author": "tender_owner",
"language": "en"
}
],
"status": "active.tendering",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"guarantee": {
"amount": 8.0,
"currency": "USD"
},
"next_check": "2023-10-21T01:10:05+03:00",
"tenderPeriod": {
"startDate": "2023-10-10T01:10:05+03:00",
"endDate": "2023-10-21T01:10:05+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 15.0
},
"auctionPeriod": {
"shouldStartAfter": "2023-10-22T00:00:00+03:00",
"startDate": "2023-10-23T13:09:55.701000+03:00"
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "4b7d2866ae0e4de7b1ccffded4f891fc",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-09-30T01:10:05+03:00",
"clarificationsUntil": "2023-10-15T00:00:00+03:00",
"endDate": "2023-10-10T01:10:05+03:00",
"invalidationDate": "2023-10-16T01:14:06+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"id": "137bba901398466a9aa1880da2ade9a6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Uploading documentation
Procuring entity can upload PDF files into the created tender. Uploading should follow the Documents Uploading rules.
Request
POST /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/documents?acc_token=76e7037e0a9a445f8bfe44a967308c41 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/d990d4897b1a47a19bf707544e0c8c39?Signature=Cnqgf4baRhlPGfZI3oqbgFwtYRe5cF%2FIteSCxhLKf3ZQ5ONP%2BGtbffmOvR4UcfVPekxZBVKiw21PlNvpBhqkAw%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/137bba901398466a9aa1880da2ade9a6/documents/0eb8412a31bf4fb495e2d50c6a0876d5
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d990d4897b1a47a19bf707544e0c8c39?Signature=Odg7g4lnQq9K23uhoeviII9%2BTeGyK%2BZebhgl5aO%2FJj1M4qGN5N%2Fq0TCVhB39EYEVdlWkc0V%2B3rnS%2FDb4w%2Fd7Bg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"dateModified": "2023-10-10T01:00:01+03:00",
"author": "tender_owner"
}
}
201 Created response code and Location header confirm document creation. We can additionally query the documents collection API endpoint to confirm the action:
Request
GET /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/documents/0eb8412a31bf4fb495e2d50c6a0876d5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d990d4897b1a47a19bf707544e0c8c39?Signature=Odg7g4lnQq9K23uhoeviII9%2BTeGyK%2BZebhgl5aO%2FJj1M4qGN5N%2Fq0TCVhB39EYEVdlWkc0V%2B3rnS%2FDb4w%2Fd7Bg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"dateModified": "2023-10-10T01:00:01+03:00",
"author": "tender_owner"
}
}
Let’s add new documentType field with technicalSpecifications parameter to the previously uploaded document:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/documents/0eb8412a31bf4fb495e2d50c6a0876d5?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentType": "technicalSpecifications"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"documentType": "technicalSpecifications",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d990d4897b1a47a19bf707544e0c8c39?Signature=Odg7g4lnQq9K23uhoeviII9%2BTeGyK%2BZebhgl5aO%2FJj1M4qGN5N%2Fq0TCVhB39EYEVdlWkc0V%2B3rnS%2FDb4w%2Fd7Bg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:01:02+03:00",
"author": "tender_owner",
"language": "uk"
}
}
Success! Response code is 200 OK and it confirms that documentType field with technicalSpecifications parameter was added .
Here is the basic list of fields that can be changed for a document.
documentOf
language
documentType
title
title_en
description
description_en
format
relatedItem
We can modify more of them:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/documents/0eb8412a31bf4fb495e2d50c6a0876d5?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice.doc",
"format": "application/msword",
"description": "змінений опис документа",
"description_en": "document description modified",
"documentOf": "item",
"relatedItem": "ffffffffffffffffffffffffffffffff"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d990d4897b1a47a19bf707544e0c8c39?Signature=Odg7g4lnQq9K23uhoeviII9%2BTeGyK%2BZebhgl5aO%2FJj1M4qGN5N%2Fq0TCVhB39EYEVdlWkc0V%2B3rnS%2FDb4w%2Fd7Bg%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
}
}
You may notice that dateModified field changes with every modification.
The single array element describes the uploaded document. We can upload more documents:
Request
POST /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/documents?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "AwardCriteria.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/67b500f3327a4160bff847fa3b925862?Signature=a%2FmiBNjuduOdoDI6IaR%2F4BcXUodk67mmDx79xTC71EGZLTKmW6vRmje4CFiprcpe0%2BkTQmi%2F6Lyn8bg0q7ydDw%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/137bba901398466a9aa1880da2ade9a6/documents/fc20014ad6434b7b93c655c13b2f699a
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/67b500f3327a4160bff847fa3b925862?Signature=QDxTKt%2F6a6o%2F969%2BED3IcEBTGuad5zzNYo28gOuxadXnyR0axXnzhPWvrEHCP4VwkSewBFtL2VvUFUHm%2FE9PBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:06:04+03:00",
"dateModified": "2023-10-10T01:06:04+03:00",
"author": "tender_owner"
}
}
And again we can confirm that there are two documents uploaded.
Request
GET /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d990d4897b1a47a19bf707544e0c8c39?Signature=Odg7g4lnQq9K23uhoeviII9%2BTeGyK%2BZebhgl5aO%2FJj1M4qGN5N%2Fq0TCVhB39EYEVdlWkc0V%2B3rnS%2FDb4w%2Fd7Bg%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/67b500f3327a4160bff847fa3b925862?Signature=QDxTKt%2F6a6o%2F969%2BED3IcEBTGuad5zzNYo28gOuxadXnyR0axXnzhPWvrEHCP4VwkSewBFtL2VvUFUHm%2FE9PBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:06:04+03:00",
"dateModified": "2023-10-10T01:06:04+03:00",
"author": "tender_owner"
}
]
}
Before we updated document details. It is also possible to change document content itself (file). To do so, we can upload a new version of the document:
Request
PUT /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/documents/fc20014ad6434b7b93c655c13b2f699a?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "AwardCriteria.pdf",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b1f6e46ecf5b4734b57a1aceb67834c1?Signature=KGBqcT8ngrDj2LSbNYFZnmpzBp53sPihdF8xxiI7xlj58oLKSjqkvA1Y3h1SRQTiLn%2B4zCS3GCQABuBM2bb2Aw%3D%3D&KeyID=a8968c46",
"hash": "md5:11111111111111111111111111111111",
"format": "application/pdf",
"language": "en"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:10:05+03:00",
"hash": "md5:11111111111111111111111111111111",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b1f6e46ecf5b4734b57a1aceb67834c1?Signature=%2Bq%2F%2FE5Sml8snWliS1olYK%2Bk9P5xg%2Bp0PVGPhAjQOELiMK882BsSWbDnohWwS9zCChlXkEgWdayK5lb2oDaVeBA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:10:05+03:00",
"author": "tender_owner",
"language": "en"
}
}
And we can see that it is overriding the original version:
Request
GET /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d990d4897b1a47a19bf707544e0c8c39?Signature=Odg7g4lnQq9K23uhoeviII9%2BTeGyK%2BZebhgl5aO%2FJj1M4qGN5N%2Fq0TCVhB39EYEVdlWkc0V%2B3rnS%2FDb4w%2Fd7Bg%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:10:05+03:00",
"hash": "md5:11111111111111111111111111111111",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b1f6e46ecf5b4734b57a1aceb67834c1?Signature=%2Bq%2F%2FE5Sml8snWliS1olYK%2Bk9P5xg%2Bp0PVGPhAjQOELiMK882BsSWbDnohWwS9zCChlXkEgWdayK5lb2oDaVeBA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:10:05+03:00",
"author": "tender_owner",
"language": "en"
}
]
}
Please notice that datePublished field has also been changed. It is connected to the document file and only changes when a new file uploaded.
It is possible to see all versions of all documents. To do this, use ?all=1 parameter.
Request
GET /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/documents?all=1 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d990d4897b1a47a19bf707544e0c8c39?Signature=Odg7g4lnQq9K23uhoeviII9%2BTeGyK%2BZebhgl5aO%2FJj1M4qGN5N%2Fq0TCVhB39EYEVdlWkc0V%2B3rnS%2FDb4w%2Fd7Bg%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/67b500f3327a4160bff847fa3b925862?Signature=QDxTKt%2F6a6o%2F969%2BED3IcEBTGuad5zzNYo28gOuxadXnyR0axXnzhPWvrEHCP4VwkSewBFtL2VvUFUHm%2FE9PBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:06:04+03:00",
"dateModified": "2023-10-10T01:06:04+03:00",
"author": "tender_owner"
},
{
"confidentiality": "public",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:10:05+03:00",
"hash": "md5:11111111111111111111111111111111",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b1f6e46ecf5b4734b57a1aceb67834c1?Signature=%2Bq%2F%2FE5Sml8snWliS1olYK%2Bk9P5xg%2Bp0PVGPhAjQOELiMK882BsSWbDnohWwS9zCChlXkEgWdayK5lb2oDaVeBA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:10:05+03:00",
"author": "tender_owner",
"language": "en"
}
]
}
In the response you should see one version of the Notice document and two versions of the AwardCriteria document. Both versions have the same id field, but datePublished fields are different. Because that’s the time when files were published.
Notice, the datePublished and dateModified fields are the same. That’s because their documents details haven’t been additionally changed.
Also notice, the fields that can be additionally modified like title, language, description etc. All of them are applied to the latest version. The previous version keeps its own values.
Enquiries
When tender is in active.enquiry status, interested parties can ask questions:
Request
POST /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/questions HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"author": {
"address": {
"countryName": "Україна",
"locality": "м. Львів",
"postalCode": "79013",
"region": "Львівська область",
"streetAddress": "вул. Островського, 34"
},
"contactPoint": {
"email": "aagt@gmail.com",
"name": "Андрій Олексюк",
"telephone": "+380322916930"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
"id": "12345678",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»"
},
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/questions/18aed6d02f154d56b9784733349f80f0
{
"data": {
"author": {
"hash": "0008badd6aa9dd04675d471581d21e5f"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"questionOf": "tender",
"id": "18aed6d02f154d56b9784733349f80f0",
"date": "2023-10-10T01:10:05+03:00"
}
}
Procuring entity can answer them:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/questions/18aed6d02f154d56b9784733349f80f0?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "18aed6d02f154d56b9784733349f80f0",
"author": {
"hash": "0008badd6aa9dd04675d471581d21e5f"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"date": "2023-10-10T01:10:05+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"questionOf": "tender",
"dateAnswered": "2023-10-10T01:10:05+03:00"
}
}
And one can retrieve the questions list:
Request
GET /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/questions 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": "18aed6d02f154d56b9784733349f80f0",
"author": {
"hash": "0008badd6aa9dd04675d471581d21e5f"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"date": "2023-10-10T01:10:05+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"questionOf": "tender",
"dateAnswered": "2023-10-10T01:10:05+03:00"
}
]
}
And individual answer:
Request
GET /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/questions/18aed6d02f154d56b9784733349f80f0 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": "18aed6d02f154d56b9784733349f80f0",
"author": {
"hash": "0008badd6aa9dd04675d471581d21e5f"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"date": "2023-10-10T01:10:05+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"questionOf": "tender",
"dateAnswered": "2023-10-10T01:10:05+03:00"
}
}
Registering bid
Step-by-step registration
When Tender.tenderingPeriod.startDate comes, Tender switches to active.tendering status that allows registration of bids.
Bidder can register a bid for lot №1 in draft status:
Request
POST /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21100",
"region": "Вінницька область",
"streetAddress": "вул. Островського, 33"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"name": "Сергій Олексюк",
"telephone": "+380432216930"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "12345678",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"status": "draft",
"items": [
{
"quantity": 5,
"description": "папір",
"id": "ffffffffffffffffffffffffffffffff",
"unit": {
"code": "KGM",
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
}
}
],
"lotValues": [
{
"value": {
"amount": 500
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/4848c58b14904cea882f5531633ec019
{
"data": {
"tenderers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "12345678",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"lotValues": [
{
"status": "pending",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-16T01:14:06+03:00"
}
],
"status": "draft",
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
],
"id": "4848c58b14904cea882f5531633ec019",
"date": "2023-10-16T01:14:06+03:00"
},
"access": {
"token": "43aaf0a1f5de4ff883e9f3b663a2f79b",
"transfer": "a03fe841fcd6490ea881b0508f9a652c"
}
}
Then bidder should approve bid with pending status. If tenderers.identifier.scheme = ‘UA-EDR’ it is required to add sign document to bid. If there is no sign document during activation, we will see an error:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/4848c58b14904cea882f5531633ec019?acc_token=43aaf0a1f5de4ff883e9f3b663a2f79b HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'proposal' and format pkcs7-signature is required"
}
]
}
Sign document should have documentType: proposal and title: *.p7s. Let’s add such document:
Request
POST /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/4848c58b14904cea882f5531633ec019/documents?acc_token=43aaf0a1f5de4ff883e9f3b663a2f79b HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Proposal.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5c71e77b5c4344afa249eff83eb2046d?Signature=iHah2sPOVWbm44POjofegabpmigy0JFXp27wQy1pdY3CFR9v2w6wD3ErcdHX6Zfcdcvndh8%2BWH%2F8vV7pmWBqCw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "sign/p7s",
"documentType": "proposal"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/4848c58b14904cea882f5531633ec019/documents/4947523771de4d7ea963bb65ffd92b13
{
"data": {
"confidentiality": "public",
"documentType": "proposal",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5c71e77b5c4344afa249eff83eb2046d?Signature=mWEqhX%2F7YsxhdfRWkHvHdwsFa%2B61jCZs1gVkMw8%2B92yOflmMhScqIZpGJFJkVNhT8LBti97QRNtFHRIMJ%2F2ECQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:14:06+03:00",
"dateModified": "2023-10-16T01:14:06+03:00"
}
}
Let’s try to activate bid one more time:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/4848c58b14904cea882f5531633ec019?acc_token=43aaf0a1f5de4ff883e9f3b663a2f79b 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": {
"lotValues": [
{
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"status": "pending",
"date": "2023-10-16T01:14:06+03:00"
}
],
"tenderers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "12345678",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"status": "pending",
"id": "4848c58b14904cea882f5531633ec019",
"date": "2023-10-16T01:14:06+03:00",
"documents": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:14:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5c71e77b5c4344afa249eff83eb2046d?Signature=mWEqhX%2F7YsxhdfRWkHvHdwsFa%2B61jCZs1gVkMw8%2B92yOflmMhScqIZpGJFJkVNhT8LBti97QRNtFHRIMJ%2F2ECQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:14:06+03:00",
"language": "uk"
}
],
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
],
"submissionDate": "2023-10-16T01:14:06+03:00"
}
}
It is possible to check the uploaded documents:
Request
GET /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/4848c58b14904cea882f5531633ec019/documents?acc_token=43aaf0a1f5de4ff883e9f3b663a2f79b HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:14:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5c71e77b5c4344afa249eff83eb2046d?Signature=mWEqhX%2F7YsxhdfRWkHvHdwsFa%2B61jCZs1gVkMw8%2B92yOflmMhScqIZpGJFJkVNhT8LBti97QRNtFHRIMJ%2F2ECQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:14:06+03:00",
"language": "uk"
}
]
}
If tender has multicurrency turned off, than there will be validation that sum of items.unit.value could not be more than bid value:
Request
POST /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21100",
"region": "Вінницька область",
"streetAddress": "вул. Островського, 33"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"name": "Сергій Олексюк",
"telephone": "+380432216930"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "12345678",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"status": "draft",
"items": [
{
"quantity": 5,
"description": "папір",
"id": "ffffffffffffffffffffffffffffffff",
"unit": {
"code": "KGM",
"value": {
"amount": 1500,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
}
}
],
"lotValues": [
{
"value": {
"amount": 500
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
]
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "items",
"description": "Total amount of unit values can't be greater than bid.lotValues.value.amount"
}
]
}
If we patched some fields in pending bid, then bid becomes invalid and should be signed one more time:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/4848c58b14904cea882f5531633ec019?acc_token=43aaf0a1f5de4ff883e9f3b663a2f79b HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21100",
"region": "Вінницька область",
"streetAddress": "вул. Островського, 33"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"name": "Сергій Олексюк",
"telephone": "+380432216930"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "Школяр",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"lotValues": [
{
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"status": "pending",
"date": "2023-10-16T01:14:06+03:00"
}
],
"tenderers": [
{
"name": "Школяр",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"status": "invalid",
"id": "4848c58b14904cea882f5531633ec019",
"date": "2023-10-16T01:14:06+03:00",
"submissionDate": "2023-10-16T01:14:06+03:00",
"documents": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:14:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5c71e77b5c4344afa249eff83eb2046d?Signature=mWEqhX%2F7YsxhdfRWkHvHdwsFa%2B61jCZs1gVkMw8%2B92yOflmMhScqIZpGJFJkVNhT8LBti97QRNtFHRIMJ%2F2ECQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:14:06+03:00",
"language": "uk"
}
],
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
]
}
}
If we try to activate bidder the new sign will be needed:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/4848c58b14904cea882f5531633ec019?acc_token=43aaf0a1f5de4ff883e9f3b663a2f79b HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'proposal' and format pkcs7-signature is required"
}
]
}
Batch-mode registration
Register bid with documents using one request:
Request
POST /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Львів",
"postalCode": "79013",
"region": "Львівська область",
"streetAddress": "вул. Островського, 34"
},
"contactPoint": {
"email": "aagt@gmail.com",
"name": "Андрій Олексюк",
"telephone": "+380322916930"
},
"identifier": {
"scheme": "UA-IPN",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
"id": "12345678",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"scale": "sme",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"documents": [
{
"title": "Proposal_part1.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/231aaa76d39142b388c80d0ce567c1ee?Signature=WvNwVCL95YWcjIXIyw8Kwt1wNCNJFJnHdW%2BjdqCz66VTYGf66Ifr%2FQkxJSHo9zUbC%2FBXJU71Tzv63gkMSiYKDQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
},
{
"title": "Proposal_part2.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d2e51a1f596f40c2a6e90757c5058e53?Signature=RQFCW8P8jWe%2BXFMH1AfoSK1MJLNqhVWr4cHdl%2BfS5hzHE3xvU3iZldEWQ3OQC2%2BwO5aIim9%2FU9QPzp5I0kO%2BCQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"confidentiality": "buyerOnly",
"confidentialityRationale": "Only our company sells badgers with pink hair."
}
],
"lotValues": [
{
"value": {
"amount": 499
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"items": [
{
"quantity": 5,
"description": "папір",
"id": "ffffffffffffffffffffffffffffffff",
"unit": {
"code": "KGM",
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
}
}
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/6cfae443008f4e0283665ec0b76f41fe
{
"data": {
"tenderers": [
{
"name": "ДКП «Книга»",
"identifier": {
"scheme": "UA-IPN",
"id": "12345678",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 34",
"locality": "м. Львів",
"region": "Львівська область",
"postalCode": "79013",
"countryName": "Україна"
},
"contactPoint": {
"name": "Андрій Олексюк",
"email": "aagt@gmail.com",
"telephone": "+380322916930"
},
"scale": "sme",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"lotValues": [
{
"status": "pending",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-16T01:15:06+03:00"
}
],
"status": "draft",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/231aaa76d39142b388c80d0ce567c1ee?Signature=umNNIjuZIzcikUd74nrYvvPmqcW01JAwbcNuDLTMWLul0cRMvIfeGyLpA59Zb1fsx%2FhNDqbszo1egr9mDZ9jAg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "e243257c7bee4ca9b3f7e87d59b016c6",
"datePublished": "2023-10-16T01:15:06+03:00",
"dateModified": "2023-10-16T01:15:06+03:00"
},
{
"confidentialityRationale": "Only our company sells badgers with pink hair.",
"confidentiality": "buyerOnly",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"format": "application/pdf",
"documentOf": "tender",
"language": "uk",
"id": "2adb1a1d4b1440d28dc4250844f8308f",
"datePublished": "2023-10-16T01:15:06+03:00",
"dateModified": "2023-10-16T01:15:06+03:00"
}
],
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
],
"id": "6cfae443008f4e0283665ec0b76f41fe",
"date": "2023-10-16T01:15:06+03:00"
},
"access": {
"token": "a4d432aea01640a3a80976416216f219",
"transfer": "52d70de6f6f84f61a4f04d476efdebce"
}
}
Auction
After auction is scheduled anybody can visit it to watch. The auction can be reached at Tender.auctionUrl:
Request
GET /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-16T01:15:06+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"questions": [
{
"id": "18aed6d02f154d56b9784733349f80f0",
"author": {
"hash": "0008badd6aa9dd04675d471581d21e5f"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"date": "2023-10-10T01:10:05+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"questionOf": "tender",
"dateAnswered": "2023-10-10T01:10:05+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d990d4897b1a47a19bf707544e0c8c39?Signature=Odg7g4lnQq9K23uhoeviII9%2BTeGyK%2BZebhgl5aO%2FJj1M4qGN5N%2Fq0TCVhB39EYEVdlWkc0V%2B3rnS%2FDb4w%2Fd7Bg%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:06:04+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/67b500f3327a4160bff847fa3b925862?Signature=QDxTKt%2F6a6o%2F969%2BED3IcEBTGuad5zzNYo28gOuxadXnyR0axXnzhPWvrEHCP4VwkSewBFtL2VvUFUHm%2FE9PBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:06:04+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:10:05+03:00",
"hash": "md5:11111111111111111111111111111111",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b1f6e46ecf5b4734b57a1aceb67834c1?Signature=%2Bq%2F%2FE5Sml8snWliS1olYK%2Bk9P5xg%2Bp0PVGPhAjQOELiMK882BsSWbDnohWwS9zCChlXkEgWdayK5lb2oDaVeBA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:10:05+03:00",
"author": "tender_owner",
"language": "en"
}
],
"status": "active.auction",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"guarantee": {
"amount": 8.0,
"currency": "USD"
},
"next_check": "2023-10-16T02:45:06+03:00",
"tenderPeriod": {
"startDate": "2023-10-09T01:15:06+03:00",
"endDate": "2023-10-16T01:15:06+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 15.0
},
"auctionPeriod": {
"startDate": "2023-10-16T01:15:06+03:00"
},
"auctionUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/137bba901398466a9aa1880da2ade9a6_880b8274983b40cfa8455e8e3d82bb70"
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "4b7d2866ae0e4de7b1ccffded4f891fc",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-01T01:15:06+03:00",
"clarificationsUntil": "2023-10-10T01:15:06+03:00",
"endDate": "2023-10-09T01:15:06+03:00",
"invalidationDate": "2023-10-16T01:14:06+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"auctionPeriod": {
"startDate": "2023-10-16T01:15:06+03:00"
},
"id": "137bba901398466a9aa1880da2ade9a6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
And bidders can find out their participation URLs via their bids:
Request
GET /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/4848c58b14904cea882f5531633ec019?acc_token=43aaf0a1f5de4ff883e9f3b663a2f79b HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"lotValues": [
{
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"status": "active",
"date": "2023-10-16T01:15:06+03:00",
"initialValue": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/137bba901398466a9aa1880da2ade9a6_880b8274983b40cfa8455e8e3d82bb70?key_for_bid=4848c58b14904cea882f5531633ec019"
}
],
"tenderers": [
{
"name": "Школяр",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"status": "active",
"id": "4848c58b14904cea882f5531633ec019",
"date": "2023-10-16T01:15:06+03:00",
"submissionDate": "2023-10-16T01:15:06+03:00",
"documents": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:14:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5c71e77b5c4344afa249eff83eb2046d?Signature=mWEqhX%2F7YsxhdfRWkHvHdwsFa%2B61jCZs1gVkMw8%2B92yOflmMhScqIZpGJFJkVNhT8LBti97QRNtFHRIMJ%2F2ECQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:14:06+03:00",
"language": "uk"
},
{
"confidentiality": "public",
"documentType": "proposal",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:15:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/beed7b02edc24dbf9f72bce75e009ad7?Signature=L17afSUKK3YF%2FTFyzF56a5vBiol8qeXZ%2BkUZHbCYyT5WZbokFbsgzlGp7GOA3KJ%2BVX2auOahFaRF%2FEAUjM6FDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:15:06+03:00",
"language": "uk"
}
],
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
]
}
}
See the Bid.participationUrl in the response. Similar, but different, URL can be retrieved for other participants:
Request
GET /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/6cfae443008f4e0283665ec0b76f41fe?acc_token=a4d432aea01640a3a80976416216f219 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"tenderers": [
{
"name": "ДКП «Книга»",
"identifier": {
"scheme": "UA-IPN",
"id": "12345678",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 34",
"locality": "м. Львів",
"region": "Львівська область",
"postalCode": "79013",
"countryName": "Україна"
},
"contactPoint": {
"name": "Андрій Олексюк",
"email": "aagt@gmail.com",
"telephone": "+380322916930"
},
"scale": "sme",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"lotValues": [
{
"status": "pending",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-16T01:15:06+03:00",
"participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/137bba901398466a9aa1880da2ade9a6_880b8274983b40cfa8455e8e3d82bb70?key_for_bid=6cfae443008f4e0283665ec0b76f41fe"
}
],
"status": "draft",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/231aaa76d39142b388c80d0ce567c1ee?Signature=umNNIjuZIzcikUd74nrYvvPmqcW01JAwbcNuDLTMWLul0cRMvIfeGyLpA59Zb1fsx%2FhNDqbszo1egr9mDZ9jAg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "e243257c7bee4ca9b3f7e87d59b016c6",
"datePublished": "2023-10-16T01:15:06+03:00",
"dateModified": "2023-10-16T01:15:06+03:00"
},
{
"confidentialityRationale": "Only our company sells badgers with pink hair.",
"confidentiality": "buyerOnly",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/bids/6cfae443008f4e0283665ec0b76f41fe/documents/2adb1a1d4b1440d28dc4250844f8308f?download=d2e51a1f596f40c2a6e90757c5058e53",
"documentOf": "tender",
"language": "uk",
"id": "2adb1a1d4b1440d28dc4250844f8308f",
"datePublished": "2023-10-16T01:15:06+03:00",
"dateModified": "2023-10-16T01:15:06+03:00"
}
],
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
],
"id": "6cfae443008f4e0283665ec0b76f41fe",
"date": "2023-10-16T01:15:06+03:00"
}
}
Confirming qualification
Qualification comission can set award to active or unsuccessful status.
There are validations before registering qualification decision:
qualified: True - for setting award from pending to active
qualified: False - for setting award from pending to unsuccessful
Let’s try to set unsuccessful status for qualified award and we will see an error:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/awards/d7753a57912a4547ac35509b690cd6d3?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful",
"qualified": true
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "qualified",
"description": [
"Can't update award to unsuccessful status when qualified/eligible isn't set to False"
]
}
]
}
Let’s try to set active status for non-qualified award and we will see an error:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/awards/d7753a57912a4547ac35509b690cd6d3?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": false
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "qualified",
"description": [
"Can't update award to active status with not qualified"
]
}
]
}
Qualification commission registers its decision via the following call:
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/awards/d7753a57912a4547ac35509b690cd6d3?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "d7753a57912a4547ac35509b690cd6d3",
"status": "active",
"date": "2023-10-16T01:15:06+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Школяр",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"bid_id": "4848c58b14904cea882f5531633ec019",
"lotID": "880b8274983b40cfa8455e8e3d82bb70",
"period": {
"startDate": "2023-10-16T01:15:06+03:00",
"endDate": "2023-10-24T00:00:00+03:00"
},
"qualified": true,
"complaintPeriod": {
"startDate": "2023-10-16T01:15:06+03:00",
"endDate": "2023-10-19T00:00:00+03:00"
}
}
}
Setting Contract
In EContracting the contract is created directly in contracting system.
Note
Some of data will be mirrored to tender until contract will be activated for backward compatibility.
Read more about working with EContracting in contracting system in Tutorial section.
Cancelling tender
Tender creator can cancel tender anytime (except when tender has terminal status e.g. usuccesfull, canceled, complete).
The following steps should be applied:
Prepare cancellation request
Fill it with the protocol describing the cancellation reasons
Cancel the tender with the reasons prepared.
Only the request that has been activated (3rd step above) has power to cancel tender. I.e. you have to not only prepare cancellation request but to activate it as well.
See Cancellation data structure for details.
Preparing the cancellation request
You should pass reason and reasonType, status defaults to draft.
id is autogenerated and passed in the Location header of response.
Request
POST /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/cancellations?acc_token=76e7037e0a9a445f8bfe44a967308c41 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/137bba901398466a9aa1880da2ade9a6/cancellations/a753e80a5036439fbfc50dc11bd20c0a
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "a753e80a5036439fbfc50dc11bd20c0a",
"date": "2023-10-16T01:15:06+03:00",
"cancellationOf": "tender",
"status": "draft"
}
}
Filling cancellation with protocol and supplementary documentation
This step is required. Without documents you can’t update tender status.
Upload the file contents
Request
POST /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/cancellations/a753e80a5036439fbfc50dc11bd20c0a/documents?acc_token=76e7037e0a9a445f8bfe44a967308c41 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/e780ae1b4e944ee3ba187462bde36ac1?Signature=t4YMI2%2B49X7NvqjItOGZDnOJ3umg3ZFKD0L%2F4%2BPlgGeAp4lCIuziSNOCwywzTmhwTdzdiZTPjm5TXBXriySYBw%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/137bba901398466a9aa1880da2ade9a6/cancellations/a753e80a5036439fbfc50dc11bd20c0a/documents/cf8f4a04fff446d190131ca8a6f60f82
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e780ae1b4e944ee3ba187462bde36ac1?Signature=iDGo9mqwlwS3KeihPGKhcMHLRtcjaQ7S094plBKJDJYrWzmq5sIP6o9SV%2BxPGvBjaMKe0PwbNN46O74aYJTuBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "cf8f4a04fff446d190131ca8a6f60f82",
"datePublished": "2023-10-16T01:15:06+03:00",
"dateModified": "2023-10-16T01:15:06+03:00"
}
}
Change the document description and other properties
Request
PATCH /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/cancellations/a753e80a5036439fbfc50dc11bd20c0a/documents/cf8f4a04fff446d190131ca8a6f60f82?acc_token=76e7037e0a9a445f8bfe44a967308c41 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"description": "Changed description"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"description": "Changed description",
"id": "cf8f4a04fff446d190131ca8a6f60f82",
"datePublished": "2023-10-16T01:15:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e780ae1b4e944ee3ba187462bde36ac1?Signature=iDGo9mqwlwS3KeihPGKhcMHLRtcjaQ7S094plBKJDJYrWzmq5sIP6o9SV%2BxPGvBjaMKe0PwbNN46O74aYJTuBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:15:06+03:00",
"language": "uk"
}
}
Upload new version of the document
Request
PUT /api/2.5/tenders/137bba901398466a9aa1880da2ade9a6/cancellations/a753e80a5036439fbfc50dc11bd20c0a/documents/cf8f4a04fff446d190131ca8a6f60f82?acc_token=76e7037e0a9a445f8bfe44a967308c41 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/131fc5fbb3274c828bc09bb658eecf9e?Signature=6zJJTIZg0FyjjFx3zROF2T0YsUshcFSsoMLdE%2FcQHfgAeRv8ZMKWTh4eHkeu94235xjLI03O0ZINrN3V0rPECA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"description": "Changed description",
"id": "cf8f4a04fff446d190131ca8a6f60f82",
"datePublished": "2023-10-16T01:15:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/131fc5fbb3274c828bc09bb658eecf9e?Signature=Yx0XqCvNvnHjGogOTV7pGmAqQPdSqNPUo1tkRf1NE2OOa3qkVZJjdX%2F35SWvm1lc5HIylKpJkeZi7Xpj58gLBw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:15:06+03:00",
"language": "uk"
}
}
Activating the request and cancelling tender
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",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кілограм",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T00:00:00+02:00"
},
"procurementMethodType": "requestForProposal",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45
}
],
"contractTemplateName": "00000000.0002.01",
"funders": [
{
"additionalIdentifiers": [],
"address": {
"countryName": "Швейцарська Конфедерація",
"locality": "Geneva",
"postalCode": "1218",
"region": "Grand-Saconnex",
"streetAddress": "Global Health Campus, Chemin du Pommier 40"
},
"contactPoint": {
"email": "ccm@theglobalfund.org",
"faxNumber": "+41 44 580 6820",
"name": "",
"telephone": "+41587911700",
"url": "https://www.theglobalfund.org/en/"
},
"identifier": {
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією",
"scheme": "XM-DAC"
},
"name": "Глобальний фонд"
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/edf794081dcd444fbd0b8cc1e31f792b
{
"data": {
"mainProcurementCategory": "goods",
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"title": "футляри до державних нагород",
"status": "draft",
"awardCriteria": "lowestCost",
"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",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "287eac32299645e58057bf526f3f67c8",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"tenderID": "UA-2023-10-10-000003-a",
"owner": "broker",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "edf794081dcd444fbd0b8cc1e31f792b"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
},
"access": {
"token": "4c97ef37809a4c2f9a609abb1d016459",
"transfer": "21ff86c0635d4aceb88fce04e474b6ac"
}
}