Multiple Lots Tutorial
Creating tender
Let’s create tender:
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": {
"tenderPeriod": {
"endDate": "2023-11-10T01:00:00+03:00"
},
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"minimalStep": {
"currency": "UAH",
"amount": 5
},
"procurementMethodType": "competitiveDialogueEU",
"value": {
"currency": "UAH",
"amount": 500
},
"procuringEntity": {
"kind": "general",
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21027",
"region": "Вінницька область",
"streetAddress": "вул. Стахурського. 22"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"name_en": "Kutsa Svitlana V.",
"telephone": "+380432465302",
"availableLanguage": "uk",
"url": "http://sch10.edu.vn.ua/"
},
"identifier": {
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
"scheme": "UA-EDR"
},
"name": "ЗОСШ #10 м.Вінниці",
"name_en": "School #10 of Vinnytsia"
},
"items": [
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"description_en": "Services in school canteens",
"classification": {
"scheme": "ДК021",
"id": "37810000-9",
"description": "Test"
},
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"unit": {
"code": "KGM",
"name": "кілограм",
"value": {
"amount": 6
}
},
"quantity": 1
},
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"description_en": "Services in school canteens",
"classification": {
"scheme": "ДК021",
"id": "37810000-9",
"description": "Test"
},
"unit": {
"code": "PK",
"name": "упаковка",
"value": {
"amount": 6
}
},
"quantity": 1,
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
],
"mainProcurementCategory": "services"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": true,
"minBidsNumber": 3,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": true,
"hasAwardComplaints": false,
"hasCancellationComplaints": true,
"restricted": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd
{
"data": {
"title_en": "Services in school canteens",
"title": "Послуги шкільних їдалень",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "b81f2856d0b04849810c73b463a23f4b",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"name_en": "School #10 of Vinnytsia",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\""
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/",
"name_en": "Kutsa Svitlana V.",
"availableLanguage": "uk"
},
"kind": "general"
},
"awardCriteria": "lowestCost",
"tenderPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-10T01:00:00+03:00"
},
"procurementMethodType": "competitiveDialogueEU",
"mainProcurementCategory": "services",
"status": "draft",
"items": [
{
"id": "c3f9ef125fde41f2b0559a39a9527282",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens"
},
{
"id": "ecdc7b89d8574bf293dec751fef6d3d2",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "упаковка",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "PK"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens"
}
],
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"procurementMethod": "open",
"complaintPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-06T00:00:00+02:00"
},
"date": "2023-10-10T01:00:00+03:00",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-31T00:00:00+02:00",
"clarificationsUntil": "2023-11-03T00:00:00+02:00"
},
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "0122f7569ef34718a69b5de8643cccfd"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": true,
"minBidsNumber": 3,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": true,
"hasAwardComplaints": false,
"hasCancellationComplaints": true,
"restricted": false
},
"access": {
"token": "e179e7123ebc4555bde66499540f5ee6",
"transfer": "80e85930986641bba232047db3a10f11"
}
}
Now we can see that new object was created. Response code is 201 and Location response header reports the location of the created object. The body of response reveals the information about the created tender: its internal id (that matches the Location segment), its official tenderID and dateModified datestamp stating the moment in time when tender was last modified. Note that tender is created with active.tendering status.
The peculiarity of the Open EU procedure is that procurementMethodType
was changed from belowThreshold
to aboveThresholdEU
.
Also there is no opportunity to set up enquiryPeriod
, it will be assigned automatically.
Tender can contain several different lots. We can add lot using the following way:
POST /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/lots?acc_token=e179e7123ebc4555bde66499540f5ee6 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Лот №1",
"description": "Опис Лот №1",
"value": {
"currency": "UAH",
"amount": 500
},
"minimalStep": {
"currency": "UAH",
"amount": 5
}
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/lots/3d9bd8f913544205bad6df7a3843e883
{
"data": {
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "3d9bd8f913544205bad6df7a3843e883",
"status": "active",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"date": "2023-10-10T01:00:00+03:00"
}
}
Also you will need to update data about item’s related lots:
PATCH /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd?acc_token=e179e7123ebc4555bde66499540f5ee6 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "c3f9ef125fde41f2b0559a39a9527282",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens",
"relatedLot": "3d9bd8f913544205bad6df7a3843e883"
},
{
"id": "ecdc7b89d8574bf293dec751fef6d3d2",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "упаковка",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "PK"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens",
"relatedLot": "21068d0f3d3849709ec8f44d8bd0c140"
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title_en": "Services in school canteens",
"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",
"owner": "broker",
"title": "Послуги шкільних їдалень",
"procurementMethod": "open",
"value": {
"amount": 1000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "b81f2856d0b04849810c73b463a23f4b",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"name_en": "School #10 of Vinnytsia",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\""
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/",
"name_en": "Kutsa Svitlana V.",
"availableLanguage": "uk"
},
"kind": "general"
},
"awardCriteria": "lowestCost",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-31T00:00:00+02:00",
"clarificationsUntil": "2023-11-03T00:00:00+02:00",
"invalidationDate": "2023-10-10T01:00:00+03:00"
},
"tenderPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-10T01:00:00+03:00"
},
"complaintPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-06T00:00:00+02:00"
},
"procurementMethodType": "competitiveDialogueEU",
"mainProcurementCategory": "services",
"status": "draft",
"items": [
{
"id": "c3f9ef125fde41f2b0559a39a9527282",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"relatedLot": "3d9bd8f913544205bad6df7a3843e883",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens"
},
{
"id": "ecdc7b89d8574bf293dec751fef6d3d2",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "упаковка",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "PK"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"relatedLot": "21068d0f3d3849709ec8f44d8bd0c140",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens"
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"id": "3d9bd8f913544205bad6df7a3843e883",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"title": "Лот №2",
"description": "Опис Лот №2",
"status": "active",
"id": "21068d0f3d3849709ec8f44d8bd0c140",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"id": "0122f7569ef34718a69b5de8643cccfd"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": true,
"minBidsNumber": 3,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": true,
"hasAwardComplaints": false,
"hasCancellationComplaints": true,
"restricted": false
}
}
View tender listing:
GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "0122f7569ef34718a69b5de8643cccfd"
}
],
"next_page": {
"offset": 1696888800.0,
"path": "/api/2.5/tenders?offset=1696888800.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1696888800.0"
}
}
or view tender:
GET /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title_en": "Services in school canteens",
"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",
"owner": "broker",
"title": "Послуги шкільних їдалень",
"procurementMethod": "open",
"value": {
"amount": 1000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "b81f2856d0b04849810c73b463a23f4b",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"name_en": "School #10 of Vinnytsia",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\""
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/",
"name_en": "Kutsa Svitlana V.",
"availableLanguage": "uk"
},
"kind": "general"
},
"awardCriteria": "lowestCost",
"enquiryPeriod": {
"startDate": "2023-10-09T01:00:00+03:00",
"endDate": "2023-10-30T01:00:00+02:00",
"clarificationsUntil": "2023-11-03T00:00:00+02:00",
"invalidationDate": "2023-10-10T01:00:00+03:00"
},
"tenderPeriod": {
"startDate": "2023-10-09T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+02:00"
},
"complaintPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-06T00:00:00+02:00"
},
"procurementMethodType": "competitiveDialogueEU",
"mainProcurementCategory": "services",
"status": "active.tendering",
"items": [
{
"id": "c3f9ef125fde41f2b0559a39a9527282",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"relatedLot": "3d9bd8f913544205bad6df7a3843e883",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens"
},
{
"id": "ecdc7b89d8574bf293dec751fef6d3d2",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "упаковка",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "PK"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"relatedLot": "21068d0f3d3849709ec8f44d8bd0c140",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens"
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"id": "3d9bd8f913544205bad6df7a3843e883",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"title": "Лот №2",
"description": "Опис Лот №2",
"status": "active",
"id": "21068d0f3d3849709ec8f44d8bd0c140",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"id": "0122f7569ef34718a69b5de8643cccfd"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": true,
"minBidsNumber": 3,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": true,
"hasAwardComplaints": false,
"hasCancellationComplaints": true,
"restricted": false
}
}
Registering bid
Tender status active.tendering
allows registration of bids.
Bidder can register a bid for lot №1:
POST /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "draft",
"selfQualified": true,
"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"
}
],
"lotValues": [
{
"subcontractingDetails": "ДКП «Орфей», Україна",
"relatedLot": "3d9bd8f913544205bad6df7a3843e883"
}
]
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/bids/67eb57fa061f47b9836630fd4f90122a
{
"data": {
"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"
}
],
"lotValues": [
{
"relatedLot": "3d9bd8f913544205bad6df7a3843e883",
"subcontractingDetails": "ДКП «Орфей», Україна",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
],
"selfQualified": true,
"status": "draft",
"id": "67eb57fa061f47b9836630fd4f90122a",
"date": "2023-10-10T01:00:00+03:00"
},
"access": {
"token": "4d7feff188c5479ba9b421f97a1a7aa8",
"transfer": "fbafe18f48a14d00a7bfbac4d323226d"
}
}
Bidder can register bids for all lots:
POST /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "draft",
"selfQualified": true,
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Львів",
"postalCode": "79013",
"region": "Львівська область",
"streetAddress": "вул. Островського, 35"
},
"contactPoint": {
"email": "fake@mail.com",
"name": "Іван Іваненко",
"telephone": "+380322123456"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137227",
"uri": "http://www.sc.gov.ua/"
},
"name": "«Снігур»",
"scale": "mid"
}
],
"lotValues": [
{
"relatedLot": "3d9bd8f913544205bad6df7a3843e883"
},
{
"subcontractingDetails": "ДКП «Укр Прінт», Україна",
"relatedLot": "21068d0f3d3849709ec8f44d8bd0c140"
}
]
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/bids/8f1f20c9676f4c51b1e41855982f5629
{
"data": {
"tenderers": [
{
"name": "«Снігур»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137227",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 35",
"locality": "м. Львів",
"region": "Львівська область",
"postalCode": "79013",
"countryName": "Україна"
},
"contactPoint": {
"name": "Іван Іваненко",
"email": "fake@mail.com",
"telephone": "+380322123456"
},
"scale": "mid"
}
],
"lotValues": [
{
"relatedLot": "3d9bd8f913544205bad6df7a3843e883",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
},
{
"relatedLot": "21068d0f3d3849709ec8f44d8bd0c140",
"subcontractingDetails": "ДКП «Укр Прінт», Україна",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
],
"selfQualified": true,
"status": "draft",
"id": "8f1f20c9676f4c51b1e41855982f5629",
"date": "2023-10-10T01:00:00+03:00"
},
"access": {
"token": "c962dec9949240f9aa7733143f3c8165",
"transfer": "ffe1ac45b2174e578dd1033be926afcc"
}
}
Then bidder should upload technical and private documents of proposal.
We can update tender during active.tendering
period. Bids will be invalid after updating tender. For example, let’s reduce the lot price to 400.
PATCH /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/lots/21068d0f3d3849709ec8f44d8bd0c140?acc_token=e179e7123ebc4555bde66499540f5ee6 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 400,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title": "Лот №2",
"description": "Опис Лот №2",
"status": "active",
"id": "21068d0f3d3849709ec8f44d8bd0c140",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 400.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
}
Here is the bidder’s proposal after tender was updated.
GET /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/bids/67eb57fa061f47b9836630fd4f90122a?acc_token=4d7feff188c5479ba9b421f97a1a7aa8 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "67eb57fa061f47b9836630fd4f90122a",
"status": "invalid"
}
}
Firstly bidder has to renew bid, even if he was placing a bid just for a lot №1.
PATCH /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/bids/67eb57fa061f47b9836630fd4f90122a?acc_token=4d7feff188c5479ba9b421f97a1a7aa8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"lotValues": [
{
"subcontractingDetails": "ДКП «Орфей»",
"relatedLot": "3d9bd8f913544205bad6df7a3843e883"
}
],
"status": "pending"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "67eb57fa061f47b9836630fd4f90122a",
"date": "2023-10-10T01:00:00+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"
}
],
"lotValues": [
{
"relatedLot": "3d9bd8f913544205bad6df7a3843e883",
"subcontractingDetails": "ДКП «Орфей»",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
],
"selfQualified": true,
"status": "pending"
}
}
Then bidder has to renew bid only for a lot №1.
PATCH /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/bids/110e51882d0f47e5a0c6168c89e9595a?acc_token=e4b02cd63c0043b797c182e47876a189 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"lotValues": [
{
"relatedLot": "3d9bd8f913544205bad6df7a3843e883"
}
],
"status": "pending"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "110e51882d0f47e5a0c6168c89e9595a",
"date": "2023-10-10T01:00:00+03:00",
"tenderers": [
{
"name": "ДКП «Книга»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"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"
}
],
"lotValues": [
{
"relatedLot": "3d9bd8f913544205bad6df7a3843e883",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
],
"selfQualified": true,
"status": "pending"
}
}
Bid Qualification
CompetitiveDialogue procedure requires bid’s value qualification.
Let’s view tender:
GET /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd?acc_token=e179e7123ebc4555bde66499540f5ee6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title_en": "Services in school canteens",
"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",
"owner": "broker",
"title": "Послуги шкільних їдалень",
"procurementMethod": "open",
"value": {
"amount": 900.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "b81f2856d0b04849810c73b463a23f4b",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"name_en": "School #10 of Vinnytsia",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\""
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/",
"name_en": "Kutsa Svitlana V.",
"availableLanguage": "uk"
},
"kind": "general"
},
"awardCriteria": "lowestCost",
"enquiryPeriod": {
"startDate": "2023-09-09T01:00:00+03:00",
"endDate": "2023-09-30T01:00:00+03:00",
"clarificationsUntil": "2023-11-03T00:00:00+02:00",
"invalidationDate": "2023-10-10T01:00:00+03:00"
},
"tenderPeriod": {
"startDate": "2023-09-09T01:00:00+03:00",
"endDate": "2023-10-10T01:00:00+03:00"
},
"complaintPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-06T00:00:00+02:00"
},
"procurementMethodType": "competitiveDialogueEU",
"mainProcurementCategory": "services",
"status": "active.pre-qualification",
"items": [
{
"id": "c3f9ef125fde41f2b0559a39a9527282",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"relatedLot": "3d9bd8f913544205bad6df7a3843e883",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens"
},
{
"id": "ecdc7b89d8574bf293dec751fef6d3d2",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "упаковка",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "PK"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"relatedLot": "21068d0f3d3849709ec8f44d8bd0c140",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens"
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"id": "3d9bd8f913544205bad6df7a3843e883",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"title": "Лот №2",
"description": "Опис Лот №2",
"status": "unsuccessful",
"id": "21068d0f3d3849709ec8f44d8bd0c140",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 400.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"bids": [
{
"id": "67eb57fa061f47b9836630fd4f90122a",
"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"
}
],
"status": "pending"
},
{
"id": "110e51882d0f47e5a0c6168c89e9595a",
"tenderers": [
{
"name": "ДКП «Книга»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"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"
}
],
"status": "pending"
},
{
"id": "8f1f20c9676f4c51b1e41855982f5629",
"tenderers": [
{
"name": "«Снігур»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137227",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 35",
"locality": "м. Львів",
"region": "Львівська область",
"postalCode": "79013",
"countryName": "Україна"
},
"contactPoint": {
"name": "Іван Іваненко",
"email": "fake@mail.com",
"telephone": "+380322123456"
},
"scale": "mid"
}
],
"status": "pending"
}
],
"qualificationPeriod": {
"startDate": "2023-10-10T01:00:00+03:00"
},
"qualifications": [
{
"id": "ba13d85d37f04003947d8496ec5424c9",
"bidID": "67eb57fa061f47b9836630fd4f90122a",
"lotID": "3d9bd8f913544205bad6df7a3843e883",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"qualified": false,
"eligible": false
},
{
"id": "c12360741abb4076b696b29499e5a84c",
"bidID": "110e51882d0f47e5a0c6168c89e9595a",
"lotID": "3d9bd8f913544205bad6df7a3843e883",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"qualified": false,
"eligible": false
},
{
"id": "f955e8f824c84580b273347a24cf0d05",
"bidID": "8f1f20c9676f4c51b1e41855982f5629",
"lotID": "3d9bd8f913544205bad6df7a3843e883",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"qualified": false,
"eligible": false
}
],
"id": "0122f7569ef34718a69b5de8643cccfd"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": true,
"minBidsNumber": 3,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": true,
"hasAwardComplaints": false,
"hasCancellationComplaints": true,
"restricted": false
}
}
Let’s list qualifications:
GET /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/qualifications?acc_token=e179e7123ebc4555bde66499540f5ee6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "ba13d85d37f04003947d8496ec5424c9",
"bidID": "67eb57fa061f47b9836630fd4f90122a",
"lotID": "3d9bd8f913544205bad6df7a3843e883",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"qualified": false,
"eligible": false
},
{
"id": "c12360741abb4076b696b29499e5a84c",
"bidID": "110e51882d0f47e5a0c6168c89e9595a",
"lotID": "3d9bd8f913544205bad6df7a3843e883",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"qualified": false,
"eligible": false
},
{
"id": "f955e8f824c84580b273347a24cf0d05",
"bidID": "8f1f20c9676f4c51b1e41855982f5629",
"lotID": "3d9bd8f913544205bad6df7a3843e883",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"qualified": false,
"eligible": false
}
]
}
Approve bid’s value through qualification objects:
PATCH /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd/qualifications/ba13d85d37f04003947d8496ec5424c9?acc_token=e179e7123ebc4555bde66499540f5ee6 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true,
"eligible": true
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "ba13d85d37f04003947d8496ec5424c9",
"bidID": "67eb57fa061f47b9836630fd4f90122a",
"lotID": "3d9bd8f913544205bad6df7a3843e883",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"qualified": true,
"eligible": true
}
}
Procuring entity approves qualifications by switching to next status:
PATCH /api/2.5/tenders/0122f7569ef34718a69b5de8643cccfd?acc_token=e179e7123ebc4555bde66499540f5ee6 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.pre-qualification.stand-still"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title_en": "Services in school canteens",
"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",
"bids": [
{
"id": "67eb57fa061f47b9836630fd4f90122a",
"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"
}
],
"status": "active"
},
{
"id": "110e51882d0f47e5a0c6168c89e9595a",
"tenderers": [
{
"name": "ДКП «Книга»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"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"
}
],
"status": "active"
},
{
"id": "8f1f20c9676f4c51b1e41855982f5629",
"tenderers": [
{
"name": "«Снігур»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137227",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 35",
"locality": "м. Львів",
"region": "Львівська область",
"postalCode": "79013",
"countryName": "Україна"
},
"contactPoint": {
"name": "Іван Іваненко",
"email": "fake@mail.com",
"telephone": "+380322123456"
},
"scale": "mid"
}
],
"status": "active"
}
],
"owner": "broker",
"title": "Послуги шкільних їдалень",
"procurementMethod": "open",
"value": {
"amount": 900.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "b81f2856d0b04849810c73b463a23f4b",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"qualificationPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-16T00:00:00+03:00",
"reportingDatePublication": "2023-10-10T01:00:00+03:00"
},
"qualifications": [
{
"id": "ba13d85d37f04003947d8496ec5424c9",
"bidID": "67eb57fa061f47b9836630fd4f90122a",
"lotID": "3d9bd8f913544205bad6df7a3843e883",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"qualified": true,
"eligible": true
},
{
"id": "c12360741abb4076b696b29499e5a84c",
"bidID": "110e51882d0f47e5a0c6168c89e9595a",
"lotID": "3d9bd8f913544205bad6df7a3843e883",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"qualified": true,
"eligible": true
},
{
"id": "f955e8f824c84580b273347a24cf0d05",
"bidID": "8f1f20c9676f4c51b1e41855982f5629",
"lotID": "3d9bd8f913544205bad6df7a3843e883",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"qualified": true,
"eligible": true
}
],
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"name_en": "School #10 of Vinnytsia",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\""
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/",
"name_en": "Kutsa Svitlana V.",
"availableLanguage": "uk"
},
"kind": "general"
},
"awardCriteria": "lowestCost",
"enquiryPeriod": {
"startDate": "2023-09-09T01:00:00+03:00",
"endDate": "2023-09-30T01:00:00+03:00",
"clarificationsUntil": "2023-11-03T00:00:00+02:00",
"invalidationDate": "2023-10-10T01:00:00+03:00"
},
"tenderPeriod": {
"startDate": "2023-09-09T01:00:00+03:00",
"endDate": "2023-10-10T01:00:00+03:00"
},
"complaintPeriod": {
"startDate": "2023-09-09T01:00:00+03:00",
"endDate": "2023-10-06T00:00:00+03:00"
},
"procurementMethodType": "competitiveDialogueEU",
"mainProcurementCategory": "services",
"status": "active.pre-qualification.stand-still",
"items": [
{
"id": "c3f9ef125fde41f2b0559a39a9527282",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"relatedLot": "3d9bd8f913544205bad6df7a3843e883",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens"
},
{
"id": "ecdc7b89d8574bf293dec751fef6d3d2",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "упаковка",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "PK"
},
"quantity": 1.0,
"classification": {
"description": "Test",
"scheme": "ДК021",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"relatedLot": "21068d0f3d3849709ec8f44d8bd0c140",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"description_en": "Services in school canteens"
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"id": "3d9bd8f913544205bad6df7a3843e883",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"title": "Лот №2",
"description": "Опис Лот №2",
"status": "unsuccessful",
"id": "21068d0f3d3849709ec8f44d8bd0c140",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 400.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"next_check": "2023-10-16T00:00:00+03:00",
"id": "0122f7569ef34718a69b5de8643cccfd"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": true,
"minBidsNumber": 3,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": true,
"hasAwardComplaints": false,
"hasCancellationComplaints": true,
"restricted": false
}
}
There is 10 day stand-still period set in qualificationPeriod.
Second stage
On second stage we must register new bids, but register bid can only users who was approved on first stage
Let’s try register bid by procuring which didn’t was on first stage
POST /api/2.5/tenders/48845373b4f4425aacd15269732d23fe/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "draft",
"selfQualified": true,
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Львів",
"postalCode": "21100",
"region": "Львівська область",
"streetAddress": "вул. Поле, 33"
},
"contactPoint": {
"email": "pole@gmail.com",
"name": "Вільям Поле",
"telephone": "+380452216931"
},
"identifier": {
"id": "00137230",
"legalName": "ТОВ Бур",
"scheme": "UA-EDR",
"uri": "http://pole.edu.vn.ua/"
},
"name": "ТОВ \"Бур\"",
"scale": "mid"
}
],
"lotValues": [
{
"subcontractingDetails": "ДКП «Орфей», Україна",
"value": {
"amount": 500
},
"relatedLot": "3d9bd8f913544205bad6df7a3843e883"
}
]
}
}
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Firm can't create bid"
}
]
}
We catch error.
Now procuring which was approved on 1 lot.
POST /api/2.5/tenders/48845373b4f4425aacd15269732d23fe/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "draft",
"selfQualified": true,
"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"
}
],
"lotValues": [
{
"subcontractingDetails": "ДКП «Орфей», Україна",
"value": {
"amount": 500
},
"relatedLot": "3d9bd8f913544205bad6df7a3843e883"
}
]
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/48845373b4f4425aacd15269732d23fe/bids/7fec345ba2914e28bd28e7dd15100c66
{
"data": {
"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"
}
],
"status": "draft",
"lotValues": [
{
"status": "pending",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "3d9bd8f913544205bad6df7a3843e883",
"subcontractingDetails": "ДКП «Орфей», Україна",
"date": "2023-10-10T01:00:00+03:00"
}
],
"selfQualified": true,
"id": "7fec345ba2914e28bd28e7dd15100c66",
"date": "2023-10-10T01:00:00+03:00"
},
"access": {
"token": "83cd77ef6cb141478248c8ff09529e31",
"transfer": "f032e52121a74e1787c1e91877bed16f"
}
}
Successs!
And now try register on lot which he not allowed.
POST /api/2.5/tenders/48845373b4f4425aacd15269732d23fe/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "draft",
"selfQualified": true,
"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"
}
],
"lotValues": [
{
"subcontractingDetails": "ДКП «Орфей», Україна",
"value": {
"amount": 300
},
"relatedLot": "21068d0f3d3849709ec8f44d8bd0c140"
}
]
}
}
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Firm can't create bid"
}
]
}
We again catch error. So we can conclude that, only user from first stage can register bid on second stage.