Multiple Lots Tutorial¶
Creating a tender¶
Let’s create a tender:
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3753
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"tenderPeriod": {
"endDate": "2017-03-19T13:35:25.283800+02:00"
},
"title": "Послуги шкільних їдалень",
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"id": "37810000-9",
"description": "Test"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283623+02:00",
"endDate": "2017-04-07T13:35:25.283712+02:00"
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
},
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"id": "37810000-9",
"description": "Test"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283746+02:00",
"endDate": "2017-04-07T13:35:25.283773+02:00"
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"title_en": "Services in school canteens",
"value": {
"currency": "UAH",
"amount": 500
},
"procurementMethodType": "aboveThresholdTS",
"procuringEntity": {
"kind": "general",
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"countryName": "Україна",
"postalCode": "21027",
"region": "м. Вінниця",
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця"
},
"name_en": "School #10 of Vinnytsia",
"identifier": {
"scheme": "UA-EDR",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name_en": "Kutsa Svitlana V.",
"name": "Куца Світлана Валентинівна",
"availableLanguage": "uk",
"telephone": "+380 (432) 46-53-02"
}
}
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/5be924af98a445448a0a8a81b5f109db
{
"access": {
"transfer": "f3e439fc545d444184ba53949f9722f4",
"token": "3254958c3d944d8eb0f670a2d9af96d5"
},
"data": {
"procurementMethod": "open",
"complaintPeriod": {
"startDate": "2017-02-16T13:35:38.308570+02:00",
"endDate": "2017-02-16T13:35:39.308570+02:00"
},
"enquiryPeriod": {
"startDate": "2017-02-16T13:35:38.308570+02:00",
"clarificationsUntil": "2017-03-18T13:35:25.283800+02:00",
"endDate": "2017-03-18T13:35:25.283800+02:00"
},
"submissionMethod": "electronicAuction",
"operator": "ua",
"next_check": "2017-03-19T13:35:25.283800+02:00",
"procuringEntity": {
"kind": "general",
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
},
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name_en": "Kutsa Svitlana V.",
"name": "Куца Світлана Валентинівна",
"availableLanguage": "uk",
"telephone": "+380 (432) 46-53-02"
},
"identifier": {
"scheme": "UA-EDR",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"name_en": "School #10 of Vinnytsia"
},
"owner": "broker",
"title_en": "Services in school canteens",
"id": "5be924af98a445448a0a8a81b5f109db",
"title": "Послуги шкільних їдалень",
"tenderID": "R-UA-2017-02-16-000001",
"dateModified": "2017-02-16T13:35:38.315175+02:00",
"status": "active.tendering",
"tenderPeriod": {
"startDate": "2017-02-16T13:35:38.308570+02:00",
"endDate": "2017-03-19T13:35:25.283800+02:00"
},
"auctionPeriod": {
"shouldStartAfter": "2017-03-21T00:00:00+02:00"
},
"procurementMethodType": "aboveThresholdTS",
"date": "2017-02-16T13:35:38.308887+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"description": "Test",
"id": "37810000-9"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283623+02:00",
"endDate": "2017-04-07T13:35:25.283712+02:00"
},
"id": "0322a1ec11a9443daf7e03d1dc070caf",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
},
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"description": "Test",
"id": "37810000-9"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283746+02:00",
"endDate": "2017-04-07T13:35:25.283773+02:00"
},
"id": "bacc2842f1ba4337ae7b0840ab0f1c0c",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"awardCriteria": "lowestCost"
}
}
Now we can see that a new object was created. Response code is 201 and Location response header reports the location of the created object. The body of the 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 Two-stage tendering procedure is that enquiryPeriod ends one day before tenderPeriod.
Tender can contain several different lots. We can add a lot the following way:
POST /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db/lots?acc_token=3254958c3d944d8eb0f670a2d9af96d5 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 214
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"description": "Опис Лот №1",
"value": {
"currency": "UAH",
"amount": 500
},
"title": "Лот №1"
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/5be924af98a445448a0a8a81b5f109db/lots/f2542173d5f74511bd1d3fd7b0ca6333
{
"data": {
"status": "active",
"description": "Опис Лот №1",
"title": "Лот №1",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"auctionPeriod": {
"shouldStartAfter": "2017-03-21T00:00:00+02:00"
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-16T13:35:38.383146+02:00",
"id": "f2542173d5f74511bd1d3fd7b0ca6333"
}
}
Also, you will need to update data about item’s related lots:
PATCH /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db?acc_token=3254958c3d944d8eb0f670a2d9af96d5 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 125
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"items": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333"
},
{
"relatedLot": "37dbcb6cabfe4c44b6c42457cb39dcc9"
}
]
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"complaintPeriod": {
"startDate": "2017-02-16T13:35:38.308570+02:00",
"endDate": "2017-02-16T13:35:39.308570+02:00"
},
"enquiryPeriod": {
"startDate": "2017-02-16T13:35:38.308570+02:00",
"clarificationsUntil": "2017-03-18T13:35:25.283800+02:00",
"endDate": "2017-03-18T13:35:25.283800+02:00",
"invalidationDate": "2017-02-16T13:35:38.611426+02:00"
},
"submissionMethod": "electronicAuction",
"operator": "ua",
"next_check": "2017-03-19T13:35:25.283800+02:00",
"procuringEntity": {
"kind": "general",
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
},
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name_en": "Kutsa Svitlana V.",
"name": "Куца Світлана Валентинівна",
"availableLanguage": "uk",
"telephone": "+380 (432) 46-53-02"
},
"identifier": {
"scheme": "UA-EDR",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"name_en": "School #10 of Vinnytsia"
},
"owner": "broker",
"id": "5be924af98a445448a0a8a81b5f109db",
"title": "Послуги шкільних їдалень",
"lots": [
{
"status": "active",
"description": "Опис Лот №1",
"title": "Лот №1",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"auctionPeriod": {
"shouldStartAfter": "2017-03-21T00:00:00+02:00"
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-16T13:35:38.383146+02:00",
"id": "f2542173d5f74511bd1d3fd7b0ca6333"
},
{
"status": "active",
"description": "Опис Лот №2",
"title": "Лот №2",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"auctionPeriod": {
"shouldStartAfter": "2017-03-21T00:00:00+02:00"
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-16T13:35:38.457427+02:00",
"id": "37dbcb6cabfe4c44b6c42457cb39dcc9"
}
],
"tenderID": "R-UA-2017-02-16-000001",
"dateModified": "2017-02-16T13:35:38.617068+02:00",
"status": "active.tendering",
"tenderPeriod": {
"startDate": "2017-02-16T13:35:38.308570+02:00",
"endDate": "2017-03-19T13:35:25.283800+02:00"
},
"title_en": "Services in school canteens",
"procurementMethodType": "aboveThresholdTS",
"date": "2017-02-16T13:35:38.308887+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"description": "Test",
"id": "37810000-9"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283623+02:00",
"endDate": "2017-04-07T13:35:25.283712+02:00"
},
"id": "0322a1ec11a9443daf7e03d1dc070caf",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
},
{
"relatedLot": "37dbcb6cabfe4c44b6c42457cb39dcc9",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"description": "Test",
"id": "37810000-9"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283746+02:00",
"endDate": "2017-04-07T13:35:25.283773+02:00"
},
"id": "bacc2842f1ba4337ae7b0840ab0f1c0c",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"value": {
"currency": "UAH",
"amount": 1000.0,
"valueAddedTaxIncluded": true
},
"awardCriteria": "lowestCost"
}
}
View tender listing:
GET /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"next_page": {
"path": "/api/2.3/tenders?offset=",
"uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=",
"offset": ""
},
"data": []
}
or view tender:
GET /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db HTTP/1.0
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"complaintPeriod": {
"startDate": "2017-02-16T13:35:38.308570+02:00",
"endDate": "2017-02-16T13:35:39.308570+02:00"
},
"enquiryPeriod": {
"startDate": "2017-02-16T13:35:38.308570+02:00",
"clarificationsUntil": "2017-03-18T13:35:25.283800+02:00",
"endDate": "2017-03-18T13:35:25.283800+02:00",
"invalidationDate": "2017-02-16T13:35:38.611426+02:00"
},
"submissionMethod": "electronicAuction",
"operator": "ua",
"next_check": "2017-03-19T13:35:25.283800+02:00",
"procuringEntity": {
"kind": "general",
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
},
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name_en": "Kutsa Svitlana V.",
"name": "Куца Світлана Валентинівна",
"availableLanguage": "uk",
"telephone": "+380 (432) 46-53-02"
},
"identifier": {
"scheme": "UA-EDR",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"name_en": "School #10 of Vinnytsia"
},
"owner": "broker",
"id": "5be924af98a445448a0a8a81b5f109db",
"title": "Послуги шкільних їдалень",
"lots": [
{
"status": "active",
"description": "Опис Лот №1",
"title": "Лот №1",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"auctionPeriod": {
"shouldStartAfter": "2017-03-21T00:00:00+02:00"
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-16T13:35:38.383146+02:00",
"id": "f2542173d5f74511bd1d3fd7b0ca6333"
},
{
"status": "active",
"description": "Опис Лот №2",
"title": "Лот №2",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"auctionPeriod": {
"shouldStartAfter": "2017-03-21T00:00:00+02:00"
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-16T13:35:38.457427+02:00",
"id": "37dbcb6cabfe4c44b6c42457cb39dcc9"
}
],
"tenderID": "R-UA-2017-02-16-000001",
"dateModified": "2017-02-16T13:35:38.617068+02:00",
"status": "active.tendering",
"tenderPeriod": {
"startDate": "2017-02-16T13:35:38.308570+02:00",
"endDate": "2017-03-19T13:35:25.283800+02:00"
},
"title_en": "Services in school canteens",
"procurementMethodType": "aboveThresholdTS",
"date": "2017-02-16T13:35:38.308887+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"description": "Test",
"id": "37810000-9"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283623+02:00",
"endDate": "2017-04-07T13:35:25.283712+02:00"
},
"id": "0322a1ec11a9443daf7e03d1dc070caf",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
},
{
"relatedLot": "37dbcb6cabfe4c44b6c42457cb39dcc9",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"description": "Test",
"id": "37810000-9"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283746+02:00",
"endDate": "2017-04-07T13:35:25.283773+02:00"
},
"id": "bacc2842f1ba4337ae7b0840ab0f1c0c",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"value": {
"currency": "UAH",
"amount": 1000.0,
"valueAddedTaxIncluded": true
},
"awardCriteria": "lowestCost"
}
}
Registering a bid¶
Tender status active.tendering allows registration of bids.
Bidder can register a bid for lot №1:
POST /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 805
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"lotValues": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"value": {
"amount": 500
}
}
],
"tenderers": [
{
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
]
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/5be924af98a445448a0a8a81b5f109db/bids/0e394c14e7d6442a8e054b41ace2b246
{
"access": {
"transfer": "cbbd77066c5d4022819ebca9b349629c",
"token": "409eda271d244a6a93f9e9b2013eba36"
},
"data": {
"date": "2017-02-16T13:35:38.793024+02:00",
"status": "pending",
"id": "0e394c14e7d6442a8e054b41ace2b246",
"lotValues": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"date": "2017-02-16T13:35:38.793713+02:00",
"status": "pending",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
}
}
],
"tenderers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
]
}
}
Bidder can register bids for all lots:
POST /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 849
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"lotValues": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"value": {
"amount": 500
}
},
{
"relatedLot": "37dbcb6cabfe4c44b6c42457cb39dcc9",
"value": {
"amount": 500
}
}
],
"tenderers": [
{
"contactPoint": {
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк",
"email": "aagt@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"countryName": "Україна",
"postalCode": "79013",
"region": "м. Львів",
"streetAddress": "вул. Островського, 34",
"locality": "м. Львів"
}
}
]
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/5be924af98a445448a0a8a81b5f109db/bids/c8e665a8d0f8479f82d29057e9a1eba8
{
"access": {
"transfer": "997250d856de455a8f2e6b7ba0a0712c",
"token": "0173b76dcf374ed1bcfe585440525a67"
},
"data": {
"date": "2017-02-16T13:35:38.907221+02:00",
"status": "pending",
"id": "c8e665a8d0f8479f82d29057e9a1eba8",
"lotValues": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"date": "2017-02-16T13:35:38.907907+02:00",
"status": "pending",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
}
},
{
"relatedLot": "37dbcb6cabfe4c44b6c42457cb39dcc9",
"date": "2017-02-16T13:35:38.908518+02:00",
"status": "pending",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
}
}
],
"tenderers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
]
}
}
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.3/tenders/5be924af98a445448a0a8a81b5f109db/lots/37dbcb6cabfe4c44b6c42457cb39dcc9?acc_token=3254958c3d944d8eb0f670a2d9af96d5 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"value": {
"amount": 400
}
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"description": "Опис Лот №2",
"title": "Лот №2",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"auctionPeriod": {
"shouldStartAfter": "2017-03-21T00:00:00+02:00"
},
"value": {
"currency": "UAH",
"amount": 400.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-16T13:35:38.457427+02:00",
"id": "37dbcb6cabfe4c44b6c42457cb39dcc9"
}
}
Here is the bidder’s proposal after tender was updated.
GET /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db/bids/0e394c14e7d6442a8e054b41ace2b246?acc_token=409eda271d244a6a93f9e9b2013eba36 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "invalid",
"id": "0e394c14e7d6442a8e054b41ace2b246"
}
}
Firstly bidder has to renew bid, even if he was placing a bid just for a lot №1.
PATCH /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db/bids/0e394c14e7d6442a8e054b41ace2b246?acc_token=409eda271d244a6a93f9e9b2013eba36 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 124
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"status": "pending",
"lotValues": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"value": {
"amount": 500
}
}
]
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"date": "2017-02-16T13:35:38.793024+02:00",
"status": "pending",
"id": "0e394c14e7d6442a8e054b41ace2b246",
"lotValues": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"date": "2017-02-16T13:35:38.793713+02:00",
"status": "pending",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
}
}
],
"tenderers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
]
}
}
Then bidder has to renew bid only for a lot №1.
PATCH /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db/bids/c8e665a8d0f8479f82d29057e9a1eba8?acc_token=0173b76dcf374ed1bcfe585440525a67 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 124
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"status": "pending",
"lotValues": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"value": {
"amount": 500
}
}
]
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"date": "2017-02-16T13:35:38.907221+02:00",
"status": "pending",
"id": "c8e665a8d0f8479f82d29057e9a1eba8",
"lotValues": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"date": "2017-02-16T13:35:38.907907+02:00",
"status": "pending",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
}
}
],
"tenderers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
]
}
}
Bid Qualification¶
Two-stage tendering procedure requires bid’s value qualification.
Let’s view tender:
GET /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db?acc_token=3254958c3d944d8eb0f670a2d9af96d5 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"status": "active.pre-qualification",
"complaintPeriod": {
"startDate": "2017-02-11T13:35:39.377098+02:00",
"endDate": "2017-02-11T13:35:40.377098+02:00"
},
"enquiryPeriod": {
"startDate": "2017-02-11T13:35:39.377098+02:00",
"clarificationsUntil": "2017-02-15T13:35:39.377098+02:00",
"endDate": "2017-02-15T13:35:39.377098+02:00",
"invalidationDate": "2017-02-16T13:35:39.023355+02:00"
},
"submissionMethod": "electronicAuction",
"operator": "ua",
"procuringEntity": {
"kind": "general",
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
},
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name_en": "Kutsa Svitlana V.",
"name": "Куца Світлана Валентинівна",
"availableLanguage": "uk",
"telephone": "+380 (432) 46-53-02"
},
"identifier": {
"scheme": "UA-EDR",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"name_en": "School #10 of Vinnytsia"
},
"owner": "broker",
"title_en": "Services in school canteens",
"id": "5be924af98a445448a0a8a81b5f109db",
"transfer_token": "68b667da50b941a3363a9557b4eb10b3a52e735651e3574d0fe3c6c29a68547e3fa95cfe5bf13db0148eae35a204b9cdad3fc2d4a7601795a13d3faadd071872",
"title": "Послуги шкільних їдалень",
"lots": [
{
"status": "active",
"description": "Опис Лот №1",
"title": "Лот №1",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-16T13:35:38.383146+02:00",
"id": "f2542173d5f74511bd1d3fd7b0ca6333"
},
{
"status": "unsuccessful",
"description": "Опис Лот №2",
"title": "Лот №2",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"value": {
"currency": "UAH",
"amount": 400.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-16T13:35:39.560544+02:00",
"id": "37dbcb6cabfe4c44b6c42457cb39dcc9"
}
],
"qualificationPeriod": {
"startDate": "2017-02-16T13:35:39.551420+02:00"
},
"tenderID": "R-UA-2017-02-16-000001",
"dateModified": "2017-02-16T13:35:39.560544+02:00",
"numberOfBids": 2,
"tenderPeriod": {
"startDate": "2017-02-11T13:35:39.377098+02:00",
"endDate": "2017-02-16T13:35:39.377098+02:00"
},
"procurementMethodType": "aboveThresholdTS",
"qualifications": [
{
"status": "pending",
"date": "2017-02-16T13:35:39.552505+02:00",
"lotID": "f2542173d5f74511bd1d3fd7b0ca6333",
"id": "a364da935c8d4be1ae0f6daf125a4893",
"bidID": "0e394c14e7d6442a8e054b41ace2b246"
},
{
"status": "pending",
"date": "2017-02-16T13:35:39.552853+02:00",
"lotID": "f2542173d5f74511bd1d3fd7b0ca6333",
"id": "b8f81df67c624be983e2bb55e36afe14",
"bidID": "c8e665a8d0f8479f82d29057e9a1eba8"
}
],
"date": "2017-02-16T13:35:39.560544+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"description": "Test",
"id": "37810000-9"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283623+02:00",
"endDate": "2017-04-07T13:35:25.283712+02:00"
},
"id": "0322a1ec11a9443daf7e03d1dc070caf",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
},
{
"relatedLot": "37dbcb6cabfe4c44b6c42457cb39dcc9",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"description": "Test",
"id": "37810000-9"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283746+02:00",
"endDate": "2017-04-07T13:35:25.283773+02:00"
},
"id": "bacc2842f1ba4337ae7b0840ab0f1c0c",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"bids": [
{
"status": "pending",
"id": "0e394c14e7d6442a8e054b41ace2b246",
"tenderers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
]
},
{
"status": "pending",
"id": "c8e665a8d0f8479f82d29057e9a1eba8",
"tenderers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
]
}
],
"value": {
"currency": "UAH",
"amount": 900.0,
"valueAddedTaxIncluded": true
},
"awardCriteria": "lowestCost"
}
}
Let’s list qualifications:
GET /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db/qualifications?acc_token=3254958c3d944d8eb0f670a2d9af96d5 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"status": "pending",
"date": "2017-02-16T13:35:39.552505+02:00",
"lotID": "f2542173d5f74511bd1d3fd7b0ca6333",
"id": "a364da935c8d4be1ae0f6daf125a4893",
"bidID": "0e394c14e7d6442a8e054b41ace2b246"
},
{
"status": "pending",
"date": "2017-02-16T13:35:39.552853+02:00",
"lotID": "f2542173d5f74511bd1d3fd7b0ca6333",
"id": "b8f81df67c624be983e2bb55e36afe14",
"bidID": "c8e665a8d0f8479f82d29057e9a1eba8"
}
]
}
Approve bid’s value through qualification objects:
PATCH /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db/qualifications/a364da935c8d4be1ae0f6daf125a4893?acc_token=3254958c3d944d8eb0f670a2d9af96d5 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"status": "active"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"date": "2017-02-16T13:35:39.777061+02:00",
"lotID": "f2542173d5f74511bd1d3fd7b0ca6333",
"id": "a364da935c8d4be1ae0f6daf125a4893",
"bidID": "0e394c14e7d6442a8e054b41ace2b246"
}
}
Procuring entity approves qualifications by switching to next status:
PATCH /api/2.3/tenders/5be924af98a445448a0a8a81b5f109db?acc_token=3254958c3d944d8eb0f670a2d9af96d5 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 60
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"status": "active.pre-qualification.stand-still"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"status": "active.pre-qualification.stand-still",
"complaintPeriod": {
"startDate": "2017-02-11T13:35:39.377098+02:00",
"endDate": "2017-02-11T13:35:40.377098+02:00"
},
"enquiryPeriod": {
"startDate": "2017-02-11T13:35:39.377098+02:00",
"clarificationsUntil": "2017-02-15T13:35:39.377098+02:00",
"endDate": "2017-02-15T13:35:39.377098+02:00",
"invalidationDate": "2017-02-16T13:35:39.023355+02:00"
},
"submissionMethod": "electronicAuction",
"operator": "ua",
"next_check": "2017-02-17T00:00:01+02:00",
"procuringEntity": {
"kind": "general",
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
},
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name_en": "Kutsa Svitlana V.",
"name": "Куца Світлана Валентинівна",
"availableLanguage": "uk",
"telephone": "+380 (432) 46-53-02"
},
"identifier": {
"scheme": "UA-EDR",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"name_en": "School #10 of Vinnytsia"
},
"owner": "broker",
"title_en": "Services in school canteens",
"id": "5be924af98a445448a0a8a81b5f109db",
"transfer_token": "68b667da50b941a3363a9557b4eb10b3a52e735651e3574d0fe3c6c29a68547e3fa95cfe5bf13db0148eae35a204b9cdad3fc2d4a7601795a13d3faadd071872",
"title": "Послуги шкільних їдалень",
"lots": [
{
"status": "active",
"description": "Опис Лот №1",
"title": "Лот №1",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"auctionPeriod": {
"shouldStartAfter": "2017-02-18T00:00:00+02:00"
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-16T13:35:38.383146+02:00",
"id": "f2542173d5f74511bd1d3fd7b0ca6333"
},
{
"status": "unsuccessful",
"description": "Опис Лот №2",
"title": "Лот №2",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"value": {
"currency": "UAH",
"amount": 400.0,
"valueAddedTaxIncluded": true
},
"date": "2017-02-16T13:35:39.560544+02:00",
"id": "37dbcb6cabfe4c44b6c42457cb39dcc9"
}
],
"qualificationPeriod": {
"startDate": "2017-02-16T13:35:39.551420+02:00",
"endDate": "2017-02-17T00:00:01+02:00"
},
"tenderID": "R-UA-2017-02-16-000001",
"dateModified": "2017-02-16T13:35:40.148010+02:00",
"numberOfBids": 2,
"tenderPeriod": {
"startDate": "2017-02-11T13:35:39.377098+02:00",
"endDate": "2017-02-16T13:35:39.377098+02:00"
},
"procurementMethodType": "aboveThresholdTS",
"qualifications": [
{
"status": "active",
"date": "2017-02-16T13:35:39.777061+02:00",
"lotID": "f2542173d5f74511bd1d3fd7b0ca6333",
"id": "a364da935c8d4be1ae0f6daf125a4893",
"bidID": "0e394c14e7d6442a8e054b41ace2b246"
},
{
"status": "active",
"date": "2017-02-16T13:35:39.898377+02:00",
"lotID": "f2542173d5f74511bd1d3fd7b0ca6333",
"id": "b8f81df67c624be983e2bb55e36afe14",
"bidID": "c8e665a8d0f8479f82d29057e9a1eba8"
}
],
"date": "2017-02-16T13:35:40.148010+02:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"relatedLot": "f2542173d5f74511bd1d3fd7b0ca6333",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"description": "Test",
"id": "37810000-9"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283623+02:00",
"endDate": "2017-04-07T13:35:25.283712+02:00"
},
"id": "0322a1ec11a9443daf7e03d1dc070caf",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
},
{
"relatedLot": "37dbcb6cabfe4c44b6c42457cb39dcc9",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "CPV",
"description": "Test",
"id": "37810000-9"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-03-08T13:35:25.283746+02:00",
"endDate": "2017-04-07T13:35:25.283773+02:00"
},
"id": "bacc2842f1ba4337ae7b0840ab0f1c0c",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"bids": [
{
"status": "active",
"id": "0e394c14e7d6442a8e054b41ace2b246",
"tenderers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
]
},
{
"status": "active",
"id": "c8e665a8d0f8479f82d29057e9a1eba8",
"tenderers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
]
}
],
"value": {
"currency": "UAH",
"amount": 900.0,
"valueAddedTaxIncluded": true
},
"awardCriteria": "lowestCost"
}
}