If on first stage you set procurementMethodType to CompetitiveDialogueUA
then on second stage you have tender witch similar to Open UA procedure
Modifying tender¶
You can modify only tenderPeriod.endDate and deliveryDate for items. Another changes will not be saved.
Let’s update tender by supplementing it with all other essential properties:
PATCH /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"tenderPeriod": {
"endDate": "2017-07-21T17:05:45.162746+03:00"
}
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "draft.stage2",
"procurementMethod": "selective",
"awardCriteria": "lowestCost",
"tenderPeriod": {
"startDate": "2017-06-21T17:05:35.036836+03:00",
"endDate": "2017-07-21T17:05:45.162746+03:00"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"enquiryPeriod": {
"startDate": "2017-06-21T17:05:35.036836+03:00",
"clarificationsUntil": "2017-07-14T17:05:45.162746+03:00",
"endDate": "2017-07-11T17:05:45.162746+03:00"
},
"complaintPeriod": {
"startDate": "2017-06-21T17:05:35.036836+03:00",
"endDate": "2017-07-17T00:00:00+03:00"
},
"procurementMethodType": "competitiveDialogueUA.stage2",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"submissionMethod": "electronicAuction",
"shortlistedFirms": [
{
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»"
},
{
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»"
},
{
"identifier": {
"scheme": "UA-EDR",
"id": "00137228",
"uri": "http://www.sc.gov.ua/"
},
"name": "«Кенгуру»"
}
],
"date": "2017-06-21T17:05:35.130513+03:00",
"procuringEntity": {
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна",
"telephone": "+380 (432) 46-53-02"
},
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"name": "ЗОСШ #10 м.Вінниці",
"kind": "special",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Test",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-11T17:04:37.419004+03:00",
"endDate": "2017-08-10T17:04:37.419026+03:00"
},
"id": "770e64d0f1ee48d2b468359361f14862",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"owner": "broker",
"dateModified": "2017-06-21T17:05:35.235527+03:00",
"id": "92ad8804586d4edbb98cdb5c7c79412f",
"tenderID": "UA-2017-06-21-000001"
}
}
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:
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": []
}
Procuring entity can not change tender if there are less than 7 days before tenderPeriod ends. Changes will not be accepted by API.
PATCH /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 88
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"items": [
{
"deliveryDate": {
"endDate": "2017-07-21T17:05:46.028866+03:00"
}
}
]
}
}
Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
"status": "error",
"errors": [
{
"description": "tenderPeriod should be extended by 7 days",
"location": "body",
"name": "data"
}
]
}
That is why tenderPeriod has to be extended by 7 days.
PATCH /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 153
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"items": [
{
"deliveryDate": {
"endDate": "2017-07-21T17:05:46.028866+03:00"
}
}
],
"tenderPeriod": {
"endDate": "2017-06-29T17:05:36.171450+03:00"
}
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "selective",
"complaintPeriod": {
"startDate": "2017-05-24T17:05:35.979204+03:00",
"endDate": "2017-06-25T00:00:00+03:00"
},
"enquiryPeriod": {
"startDate": "2017-05-24T17:05:35.979204+03:00",
"clarificationsUntil": "2017-06-22T17:05:36.171450+03:00",
"endDate": "2017-06-19T17:05:36.171450+03:00",
"invalidationDate": "2017-06-21T17:05:36.286497+03:00"
},
"submissionMethod": "electronicAuction",
"next_check": "2017-06-29T17:05:36.171450+03:00",
"procuringEntity": {
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна",
"telephone": "+380 (432) 46-53-02"
},
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"name": "ЗОСШ #10 м.Вінниці",
"kind": "special",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"questions": [
{
"description": "Просимо додати таблицю потрібної калорійності харчування",
"dateAnswered": "2017-06-21T17:05:35.875664+03:00",
"title": "Калорійність",
"date": "2017-06-21T17:05:35.787600+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "84585ae05ec44e988d3679413daca74c",
"questionOf": "tender"
}
],
"owner": "broker",
"id": "92ad8804586d4edbb98cdb5c7c79412f",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/bcad7e91e01b47fc8a5706ab1b0486d8?KeyID=1b00d854&Signature=6yuqaSqnxCZj6t7BFRX%252BUNrOdmqWTSOGv4kljNuDGbZheM0LCK%252BKtblL1SwFUj%2Fi7P9p8osXbWmGNL8mksNzBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.461094+03:00",
"id": "6d8849370f384999963d9182911d9313",
"dateModified": "2017-06-21T17:05:35.461127+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/731c49a1d81f43299abc2cabdd4e970c?KeyID=1b00d854&Signature=gCItXqKPoAbTJeE%2F0uR9tAzH8PKFFjids72nj5ePSiqnihT4FfrpTFnF1AHbJoG1olbxfdxUHlyZ3BMitaVrBQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.549749+03:00",
"id": "1c08a9569f2a4c40bcb74b28b648049a",
"dateModified": "2017-06-21T17:05:35.549783+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria-2.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/03d63cb7f7dc40418fc0754cda8d479c?KeyID=1b00d854&Signature=UL6VbRD6aqWZP8lS54wxuj%2Fl91FUGA8nt%252B6zslODMA4lK%2FXR93s5YSicIf6%252BYtnMaLxCYf9ZhtRND%2FPIeGHeCQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.549749+03:00",
"id": "1c08a9569f2a4c40bcb74b28b648049a",
"dateModified": "2017-06-21T17:05:35.645217+03:00"
}
],
"title": "футляри до державних нагород",
"shortlistedFirms": [
{
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»"
},
{
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»"
},
{
"identifier": {
"scheme": "UA-EDR",
"id": "00137228",
"uri": "http://www.sc.gov.ua/"
},
"name": "«Кенгуру»"
}
],
"tenderID": "UA-2017-06-21-000001",
"dateModified": "2017-06-21T17:05:36.291022+03:00",
"status": "active.tendering",
"tenderPeriod": {
"startDate": "2017-05-24T17:05:35.979204+03:00",
"endDate": "2017-06-29T17:05:36.171450+03:00"
},
"auctionPeriod": {
"shouldStartAfter": "2017-06-30T00:00:00+03:00"
},
"procurementMethodType": "competitiveDialogueUA.stage2",
"date": "2017-06-21T17:05:35.349169+03:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Test",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-11T17:04:37.419004+03:00",
"endDate": "2017-07-21T17:05:46.028866+03:00"
},
"id": "770e64d0f1ee48d2b468359361f14862",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"awardCriteria": "lowestCost"
}
}
Uploading documentation¶
Procuring entity can upload PDF files into the created tender. Uploading should follow the Documents Uploading rules.
POST /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/documents?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 186
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy947945385267$
Host: api-sandbox.openprocurement.org
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/documents/6d8849370f384999963d9182911d9313
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/bcad7e91e01b47fc8a5706ab1b0486d8?KeyID=1b00d854&Signature=6yuqaSqnxCZj6t7BFRX%252BUNrOdmqWTSOGv4kljNuDGbZheM0LCK%252BKtblL1SwFUj%2Fi7P9p8osXbWmGNL8mksNzBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.461094+03:00",
"id": "6d8849370f384999963d9182911d9313",
"dateModified": "2017-06-21T17:05:35.461127+03:00"
}
}
201 Created response code and Location header confirm document creation. We can additionally query the documents collection API endpoint to confirm the action:
GET /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/documents/6d8849370f384999963d9182911d9313?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/bcad7e91e01b47fc8a5706ab1b0486d8?KeyID=1b00d854&Signature=6yuqaSqnxCZj6t7BFRX%252BUNrOdmqWTSOGv4kljNuDGbZheM0LCK%252BKtblL1SwFUj%2Fi7P9p8osXbWmGNL8mksNzBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.461094+03:00",
"previousVersions": [],
"id": "6d8849370f384999963d9182911d9313",
"dateModified": "2017-06-21T17:05:35.461127+03:00"
}
}
The single array element describes the uploaded document. We can upload more documents:
POST /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/documents?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 193
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy202162386733$
Host: api-sandbox.openprocurement.org
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/documents/1c08a9569f2a4c40bcb74b28b648049a
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/731c49a1d81f43299abc2cabdd4e970c?KeyID=1b00d854&Signature=gCItXqKPoAbTJeE%2F0uR9tAzH8PKFFjids72nj5ePSiqnihT4FfrpTFnF1AHbJoG1olbxfdxUHlyZ3BMitaVrBQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.549749+03:00",
"id": "1c08a9569f2a4c40bcb74b28b648049a",
"dateModified": "2017-06-21T17:05:35.549783+03:00"
}
}
And again we can confirm that there are two documents uploaded.
GET /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/documents?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/bcad7e91e01b47fc8a5706ab1b0486d8?KeyID=1b00d854&Signature=6yuqaSqnxCZj6t7BFRX%252BUNrOdmqWTSOGv4kljNuDGbZheM0LCK%252BKtblL1SwFUj%2Fi7P9p8osXbWmGNL8mksNzBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.461094+03:00",
"id": "6d8849370f384999963d9182911d9313",
"dateModified": "2017-06-21T17:05:35.461127+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/731c49a1d81f43299abc2cabdd4e970c?KeyID=1b00d854&Signature=gCItXqKPoAbTJeE%2F0uR9tAzH8PKFFjids72nj5ePSiqnihT4FfrpTFnF1AHbJoG1olbxfdxUHlyZ3BMitaVrBQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.549749+03:00",
"id": "1c08a9569f2a4c40bcb74b28b648049a",
"dateModified": "2017-06-21T17:05:35.549783+03:00"
}
]
}
In case we made an error, we can reupload the document over the older version:
PUT /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/documents/1c08a9569f2a4c40bcb74b28b648049a?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 196
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy770666048545$
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria-2.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/03d63cb7f7dc40418fc0754cda8d479c?KeyID=1b00d854&Signature=UL6VbRD6aqWZP8lS54wxuj%2Fl91FUGA8nt%252B6zslODMA4lK%2FXR93s5YSicIf6%252BYtnMaLxCYf9ZhtRND%2FPIeGHeCQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.549749+03:00",
"id": "1c08a9569f2a4c40bcb74b28b648049a",
"dateModified": "2017-06-21T17:05:35.645217+03:00"
}
}
And we can see that it is overriding the original version:
GET /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/bcad7e91e01b47fc8a5706ab1b0486d8?KeyID=1b00d854&Signature=6yuqaSqnxCZj6t7BFRX%252BUNrOdmqWTSOGv4kljNuDGbZheM0LCK%252BKtblL1SwFUj%2Fi7P9p8osXbWmGNL8mksNzBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.461094+03:00",
"id": "6d8849370f384999963d9182911d9313",
"dateModified": "2017-06-21T17:05:35.461127+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria-2.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/03d63cb7f7dc40418fc0754cda8d479c?KeyID=1b00d854&Signature=UL6VbRD6aqWZP8lS54wxuj%2Fl91FUGA8nt%252B6zslODMA4lK%2FXR93s5YSicIf6%252BYtnMaLxCYf9ZhtRND%2FPIeGHeCQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.549749+03:00",
"id": "1c08a9569f2a4c40bcb74b28b648049a",
"dateModified": "2017-06-21T17:05:35.645217+03:00"
}
]
}
Enquiries¶
When tender has active.tendering status and Tender.enqueryPeriod.endDate hasn’t come yet, interested parties can ask questions.
Ask question can only participants which were approved on first stage, someone else try ask, he catch error:
POST /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1057
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"author": {
"contactPoint": {
"telephone": "+380 (452) 21-69-31",
"name": "Вільям Поле",
"email": "pole@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "ТОВ Бур",
"id": "00137230",
"uri": "http://pole.edu.vn.ua/"
},
"name": "ТОВ \"Бур\"",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Львів",
"streetAddress": "вул. Поле, 33",
"locality": "м. Львів"
}
},
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність"
}
}
Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
"status": "error",
"errors": [
{
"description": "Author can't create question",
"location": "body",
"name": "author"
}
]
}
POST /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"author": {
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137226",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
},
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність"
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/questions/84585ae05ec44e988d3679413daca74c
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137226",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title": "Калорійність",
"date": "2017-06-21T17:05:35.787600+03:00",
"id": "84585ae05ec44e988d3679413daca74c",
"questionOf": "tender"
}
}
Procuring entity can answer them:
PATCH /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/questions/84585ae05ec44e988d3679413daca74c?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"dateAnswered": "2017-06-21T17:05:35.875664+03:00",
"title": "Калорійність",
"date": "2017-06-21T17:05:35.787600+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "84585ae05ec44e988d3679413daca74c",
"questionOf": "tender"
}
}
One can retrieve either questions list:
GET /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"description": "Просимо додати таблицю потрібної калорійності харчування",
"dateAnswered": "2017-06-21T17:05:35.875664+03:00",
"title": "Калорійність",
"date": "2017-06-21T17:05:35.787600+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "84585ae05ec44e988d3679413daca74c",
"questionOf": "tender"
}
]
}
or individual answer:
GET /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/questions/84585ae05ec44e988d3679413daca74c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"dateAnswered": "2017-06-21T17:05:35.875664+03:00",
"title": "Калорійність",
"date": "2017-06-21T17:05:35.787600+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "84585ae05ec44e988d3679413daca74c",
"questionOf": "tender"
}
}
Enquiries can be made only during Tender.enqueryPeriod
POST /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"author": {
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137226",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
},
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність"
}
}
Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
"status": "error",
"errors": [
{
"description": "Can add question only in enquiryPeriod",
"location": "body",
"name": "data"
}
]
}
Registering bid¶
Tender status active.tendering allows registration of bids.
Like with question only approved participants can register bid. First participant witch didn’t was on first stage try create bid.
POST /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 871
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"status": "draft",
"selfEligible": true,
"value": {
"amount": 500
},
"subcontractingDetails": "ДКП «Орфей», Україна",
"tenderers": [
{
"contactPoint": {
"telephone": "+380 (452) 21-69-31",
"name": "Вільям Поле",
"email": "pole@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "ТОВ Бур",
"id": "00137230",
"uri": "http://pole.edu.vn.ua/"
},
"name": "ТОВ \"Бур\"",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Львів",
"streetAddress": "вул. Поле, 33",
"locality": "м. Львів"
}
}
],
"selfQualified": true
}
}
Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
"status": "error",
"errors": [
{
"description": "Firm can't create bid",
"location": "body",
"name": "data"
}
]
}
Bidder can register a bid with draft status:
POST /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 936
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"status": "draft",
"selfEligible": true,
"value": {
"amount": 500
},
"subcontractingDetails": "ДКП «Орфей», Україна",
"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": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
],
"selfQualified": true
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2
{
"access": {
"token": "8829f7b52d3a4c22987d23fdd5940398"
},
"data": {
"status": "draft",
"selfEligible": true,
"id": "57a74d772b4546a6b3cfbc90985a42a2",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"subcontractingDetails": "ДКП «Орфей», Україна",
"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": "м. Вінниця"
}
}
],
"date": "2017-06-21T17:05:36.427120+03:00",
"selfQualified": true
}
}
And activate a bid:
PATCH /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2?acc_token=8829f7b52d3a4c22987d23fdd5940398 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",
"selfEligible": true,
"id": "57a74d772b4546a6b3cfbc90985a42a2",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"subcontractingDetails": "ДКП «Орфей», Україна",
"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": "м. Вінниця"
}
}
],
"date": "2017-06-21T17:05:36.427120+03:00",
"selfQualified": true
}
}
Proposal Uploading¶
Then bidder should upload proposal document(s):
POST /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2/documents?acc_token=8829f7b52d3a4c22987d23fdd5940398 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 188
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy837483776897$
Host: api-sandbox.openprocurement.org
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2/documents/e4d9acbd75a249858bcf1691f88a50bd
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2/documents/e4d9acbd75a249858bcf1691f88a50bd?download=0b8747c722434d31acbb9478eb4f2ae2",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:36.631598+03:00",
"id": "e4d9acbd75a249858bcf1691f88a50bd",
"dateModified": "2017-06-21T17:05:36.631629+03:00"
}
}
It is possible to check the uploaded documents:
GET /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2/documents?acc_token=8829f7b52d3a4c22987d23fdd5940398 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2/documents/e4d9acbd75a249858bcf1691f88a50bd?download=0b8747c722434d31acbb9478eb4f2ae2",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:36.631598+03:00",
"id": "e4d9acbd75a249858bcf1691f88a50bd",
"dateModified": "2017-06-21T17:05:36.631629+03:00"
}
]
}
Bid invalidation¶
If tender is modified, status of all bid proposals will be changed to invalid. Bid proposal will look the following way after tender has been modified:
GET /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2?acc_token=8829f7b52d3a4c22987d23fdd5940398 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": "57a74d772b4546a6b3cfbc90985a42a2"
}
}
Bid confirmation¶
Bidder should confirm bid proposal:
PATCH /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2?acc_token=8829f7b52d3a4c22987d23fdd5940398 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",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2/documents/e4d9acbd75a249858bcf1691f88a50bd?download=0b8747c722434d31acbb9478eb4f2ae2",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:36.631598+03:00",
"id": "e4d9acbd75a249858bcf1691f88a50bd",
"dateModified": "2017-06-21T17:05:36.631629+03:00"
}
],
"selfEligible": true,
"id": "57a74d772b4546a6b3cfbc90985a42a2",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"subcontractingDetails": "ДКП «Орфей», Україна",
"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": "м. Вінниця"
}
}
],
"date": "2017-06-21T17:05:36.427120+03:00",
"selfQualified": true
}
}
Second stage Competitive Dialogue UA procedure demands at least two bidders, so there should be at least two bid proposals registered to move to auction stage.
Batch-mode bid registration¶
Register one more bid with documents using single request (batch-mode):
POST /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1090
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"selfEligible": true,
"documents": [
{
"url": "http://public.docs-sandbox.openprocurement.org/get/33748309e27e4d45a9982fd6fa9a7746?KeyID=1b00d854&Signature=OBYLJGA1M6K0zCIcRXLg4w3gpQzbfJZRKgFxfwVg%2FgZ42eG2untyPwh0pwyyBqcuBfYRh2DS72777s49Y%2BJUAw%3D%3D",
"title": "Proposal_part1.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
],
"selfQualified": true,
"value": {
"amount": 499
},
"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": {
"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/92ad8804586d4edbb98cdb5c7c79412f/bids/388af60857fa4ac69f9a53214dea400a
{
"access": {
"token": "6f7d1089d007420cbdad36dbfe02a2c9"
},
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/388af60857fa4ac69f9a53214dea400a/documents/cd12e1eb7a9647a69c2695a87d612d6d?download=33748309e27e4d45a9982fd6fa9a7746",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:37.145285+03:00",
"id": "cd12e1eb7a9647a69c2695a87d612d6d",
"dateModified": "2017-06-21T17:05:37.145317+03:00"
}
],
"selfEligible": true,
"value": {
"currency": "UAH",
"amount": 499.0,
"valueAddedTaxIncluded": true
},
"id": "388af60857fa4ac69f9a53214dea400a",
"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": "м. Львів"
}
}
],
"date": "2017-06-21T17:05:37.144235+03:00",
"selfQualified": true
}
}
Auction¶
After auction is scheduled anybody can visit it to watch. The auction can be reached at Tender.auctionUrl:
GET /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "selective",
"status": "active.auction",
"complaintPeriod": {
"startDate": "2017-06-05T17:04:37.384821+03:00",
"endDate": "2017-06-17T00:00:00+03:00"
},
"auctionUrl": "http://auction-sandbox.openprocurement.org/tenders/92ad8804586d4edbb98cdb5c7c79412f",
"enquiryPeriod": {
"startDate": "2017-06-05T17:04:37.384821+03:00",
"clarificationsUntil": "2017-06-15T00:00:00+03:00",
"endDate": "2017-06-11T17:04:37.384821+03:00",
"invalidationDate": "2017-06-21T17:05:36.873254+03:00"
},
"submissionMethod": "electronicAuction",
"next_check": "2017-06-21T17:40:37.384821+03:00",
"procuringEntity": {
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна",
"telephone": "+380 (432) 46-53-02"
},
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"name": "ЗОСШ #10 м.Вінниці",
"kind": "special",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"questions": [
{
"description": "Просимо додати таблицю потрібної калорійності харчування",
"dateAnswered": "2017-06-21T17:05:35.875664+03:00",
"title": "Калорійність",
"date": "2017-06-21T17:05:35.787600+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "84585ae05ec44e988d3679413daca74c",
"questionOf": "tender"
}
],
"owner": "broker",
"id": "92ad8804586d4edbb98cdb5c7c79412f",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/bcad7e91e01b47fc8a5706ab1b0486d8?KeyID=1b00d854&Signature=6yuqaSqnxCZj6t7BFRX%252BUNrOdmqWTSOGv4kljNuDGbZheM0LCK%252BKtblL1SwFUj%2Fi7P9p8osXbWmGNL8mksNzBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.461094+03:00",
"id": "6d8849370f384999963d9182911d9313",
"dateModified": "2017-06-21T17:05:35.461127+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/731c49a1d81f43299abc2cabdd4e970c?KeyID=1b00d854&Signature=gCItXqKPoAbTJeE%2F0uR9tAzH8PKFFjids72nj5ePSiqnihT4FfrpTFnF1AHbJoG1olbxfdxUHlyZ3BMitaVrBQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.549749+03:00",
"id": "1c08a9569f2a4c40bcb74b28b648049a",
"dateModified": "2017-06-21T17:05:35.549783+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria-2.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/03d63cb7f7dc40418fc0754cda8d479c?KeyID=1b00d854&Signature=UL6VbRD6aqWZP8lS54wxuj%2Fl91FUGA8nt%252B6zslODMA4lK%2FXR93s5YSicIf6%252BYtnMaLxCYf9ZhtRND%2FPIeGHeCQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:35.549749+03:00",
"id": "1c08a9569f2a4c40bcb74b28b648049a",
"dateModified": "2017-06-21T17:05:35.645217+03:00"
}
],
"title": "футляри до державних нагород",
"shortlistedFirms": [
{
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»"
},
{
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»"
},
{
"identifier": {
"scheme": "UA-EDR",
"id": "00137228",
"uri": "http://www.sc.gov.ua/"
},
"name": "«Кенгуру»"
}
],
"tenderID": "UA-2017-06-21-000001",
"dateModified": "2017-06-21T17:05:37.476786+03:00",
"numberOfBids": 2,
"tenderPeriod": {
"startDate": "2017-06-05T17:04:37.384821+03:00",
"endDate": "2017-06-21T17:04:37.384821+03:00"
},
"auctionPeriod": {
"startDate": "2017-06-21T17:04:37.384821+03:00",
"shouldStartAfter": "2017-06-22T00:00:00+03:00"
},
"procurementMethodType": "competitiveDialogueUA.stage2",
"date": "2017-06-21T17:05:35.349169+03:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Test",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-11T17:04:37.419004+03:00",
"endDate": "2017-07-21T17:05:46.028866+03:00"
},
"id": "770e64d0f1ee48d2b468359361f14862",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"awardCriteria": "lowestCost"
}
}
Bidders can find out their participation URLs via their bids:
GET /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2?acc_token=8829f7b52d3a4c22987d23fdd5940398 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/57a74d772b4546a6b3cfbc90985a42a2/documents/e4d9acbd75a249858bcf1691f88a50bd?download=0b8747c722434d31acbb9478eb4f2ae2",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:36.631598+03:00",
"id": "e4d9acbd75a249858bcf1691f88a50bd",
"dateModified": "2017-06-21T17:05:36.631629+03:00"
}
],
"selfEligible": true,
"id": "57a74d772b4546a6b3cfbc90985a42a2",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"subcontractingDetails": "ДКП «Орфей», Україна",
"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": "м. Вінниця"
}
}
],
"date": "2017-06-21T17:05:36.427120+03:00",
"selfQualified": true,
"participationUrl": "http://auction-sandbox.openprocurement.org/tenders/92ad8804586d4edbb98cdb5c7c79412f?key_for_bid=57a74d772b4546a6b3cfbc90985a42a2"
}
}
See the Bid.participationUrl in the response. Similar, but different, URL can be retrieved for other participants:
GET /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/388af60857fa4ac69f9a53214dea400a?acc_token=6f7d1089d007420cbdad36dbfe02a2c9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/bids/388af60857fa4ac69f9a53214dea400a/documents/cd12e1eb7a9647a69c2695a87d612d6d?download=33748309e27e4d45a9982fd6fa9a7746",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-21T17:05:37.145285+03:00",
"id": "cd12e1eb7a9647a69c2695a87d612d6d",
"dateModified": "2017-06-21T17:05:37.145317+03:00"
}
],
"selfEligible": true,
"value": {
"currency": "UAH",
"amount": 499.0,
"valueAddedTaxIncluded": true
},
"id": "388af60857fa4ac69f9a53214dea400a",
"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": "м. Львів"
}
}
],
"date": "2017-06-21T17:05:37.144235+03:00",
"selfQualified": true,
"participationUrl": "http://auction-sandbox.openprocurement.org/tenders/92ad8804586d4edbb98cdb5c7c79412f?key_for_bid=388af60857fa4ac69f9a53214dea400a"
}
}
Confirming qualification¶
Qualification commission registers its decision via the following call:
PATCH /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/awards/2e46b74286c04dd6bb8625c2b6d2b39a?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 67
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"status": "active",
"qualified": true,
"eligible": true
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"eligible": true,
"suppliers": [
{
"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": "м. Львів"
}
}
],
"complaintPeriod": {
"startDate": "2017-06-21T17:05:37.871542+03:00",
"endDate": "2017-07-02T00:00:00+03:00"
},
"bid_id": "388af60857fa4ac69f9a53214dea400a",
"value": {
"currency": "UAH",
"amount": 499.0,
"valueAddedTaxIncluded": true
},
"qualified": true,
"date": "2017-06-21T17:05:38.082464+03:00",
"id": "2e46b74286c04dd6bb8625c2b6d2b39a"
}
}
Setting contract value¶
By default contract value is set based on the award, but there is a possibility to set custom contract value.
If you want to lower contract value, you can insert new one into the amount field.
PATCH /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/contracts/2565e20d778242a0a9d27fdab2a68bb5?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"value": {
"amount": 238
}
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Test",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-11T17:04:37.419004+03:00",
"endDate": "2017-07-21T17:05:46.028866+03:00"
},
"id": "770e64d0f1ee48d2b468359361f14862",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"suppliers": [
{
"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": 238.0,
"valueAddedTaxIncluded": true
},
"awardID": "2e46b74286c04dd6bb8625c2b6d2b39a",
"id": "2565e20d778242a0a9d27fdab2a68bb5",
"contractID": "UA-2017-06-21-000001-1"
}
}
200 OK response was returned. The value was modified successfully.
Setting contract signature date¶
There is a possibility to set custom contract signature date. You can insert appropriate date into the dateSigned field.
If this date is not set, it will be auto-generated on the date of contract registration.
PATCH /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/contracts/2565e20d778242a0a9d27fdab2a68bb5?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 60
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"dateSigned": "2017-06-21T17:05:38.421602+03:00"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Test",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-11T17:04:37.419004+03:00",
"endDate": "2017-07-21T17:05:46.028866+03:00"
},
"id": "770e64d0f1ee48d2b468359361f14862",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"suppliers": [
{
"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": "м. Львів"
}
}
],
"dateSigned": "2017-06-21T17:05:38.421602+03:00",
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"awardID": "2e46b74286c04dd6bb8625c2b6d2b39a",
"id": "2565e20d778242a0a9d27fdab2a68bb5",
"contractID": "UA-2017-06-21-000001-1"
}
}
Setting contract validity period¶
Setting contract validity period is optional, but if it is needed, you can set appropriate startDate and endDate.
PATCH /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/contracts/2565e20d778242a0a9d27fdab2a68bb5?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 118
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
"data": {
"period": {
"startDate": "2017-06-21T17:05:38.597334+03:00",
"endDate": "2018-06-21T17:05:38.597385+03:00"
}
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Test",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-11T17:04:37.419004+03:00",
"endDate": "2017-07-21T17:05:46.028866+03:00"
},
"id": "770e64d0f1ee48d2b468359361f14862",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"suppliers": [
{
"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": "м. Львів"
}
}
],
"period": {
"startDate": "2017-06-21T17:05:38.597334+03:00",
"endDate": "2018-06-21T17:05:38.597385+03:00"
},
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"dateSigned": "2017-06-21T17:05:38.421602+03:00",
"awardID": "2e46b74286c04dd6bb8625c2b6d2b39a",
"id": "2565e20d778242a0a9d27fdab2a68bb5",
"contractID": "UA-2017-06-21-000001-1"
}
}
Uploading contract documentation¶
You can upload contract documents for the second stage Competitive Dialogue procedure.
Let’s upload contract document:
POST /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/contracts/2565e20d778242a0a9d27fdab2a68bb5/documents?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 200
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy151059467172$
Host: api-sandbox.openprocurement.org
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/contracts/2565e20d778242a0a9d27fdab2a68bb5/documents/b0af1247b222471aa970d3404f22d7cb
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/d0045d5795864ba793bb60ae3691bb6f?KeyID=1b00d854&Signature=2ys181JjejvGgq5ViInraeFPpCFD%252B%252Bu9kg6wQSYDRGlW1olqpCbi23rP7zGNv%252BNudvjROqx2rsCE96mqd9zYDA%253D%253D",
"format": "application/msword",
"datePublished": "2017-06-21T17:05:38.856701+03:00",
"id": "b0af1247b222471aa970d3404f22d7cb",
"dateModified": "2017-06-21T17:05:38.856740+03:00"
}
}
201 Created response code and Location header confirm that this document was added.
Let’s view the uploaded contract document:
GET /api/2.3/tenders/92ad8804586d4edbb98cdb5c7c79412f/contracts/2565e20d778242a0a9d27fdab2a68bb5?acc_token=415d188e59964730bee17aae7ed1f7ab HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/d0045d5795864ba793bb60ae3691bb6f?KeyID=1b00d854&Signature=2ys181JjejvGgq5ViInraeFPpCFD%252B%252Bu9kg6wQSYDRGlW1olqpCbi23rP7zGNv%252BNudvjROqx2rsCE96mqd9zYDA%253D%253D",
"format": "application/msword",
"datePublished": "2017-06-21T17:05:38.856701+03:00",
"id": "b0af1247b222471aa970d3404f22d7cb",
"dateModified": "2017-06-21T17:05:38.856740+03:00"
}
],
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Test",
"id": "37810000-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-11T17:04:37.419004+03:00",
"endDate": "2017-07-21T17:05:46.028866+03:00"
},
"id": "770e64d0f1ee48d2b468359361f14862",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 1
}
],
"suppliers": [
{
"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": "м. Львів"
}
}
],
"period": {
"startDate": "2017-06-21T17:05:38.597334+03:00",
"endDate": "2018-06-21T17:05:38.597385+03:00"
},
"dateSigned": "2017-06-21T17:05:38.421602+03:00",
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"awardID": "2e46b74286c04dd6bb8625c2b6d2b39a",
"id": "2565e20d778242a0a9d27fdab2a68bb5",
"contractID": "UA-2017-06-21-000001-1"
}
}