Welcome to openprocurement.tender.limited’s documentation!¶
Please report any problems or suggestions for improvement either via the mailing list or the issue tracker.
Contents:
Overview¶
The Open Procurement API is the only interface to Open Procurement database that is core unit of Open Procurement infrastructure.
This documentation covers three procedures:
reporting
- reporting with no stand-still periodnegotiation
- negotiation procedure with 10 day stand-still before contract registrationnegotiation.quick
- quick negotiation procedure with 5 day stand-still before contract registration
Negotiation procedure¶
Negotiation procurement procedure is a procedure according to which Procuring entity concludes a purchase agreement with a participant after negotiations with one or more participants.
Negotiation procedure stages:
- Publication of the decision of intent to conduct negotiation procedure.
The procuring entity places the announcement of intention to conduct negotiation procedure, describing the following procurement details: procurement subject, expected value, expected delivery time.
Interested suppliers can contact the Procuring entity if they want to participate in the negotiation procedure. The decision about negotiation participants is made by the Procuring entity.
- Awarding
According to the results of conducted negotiations with participant(s) Procuring entity publishes the announcement of intention to conclude an agreement with the winner of the procedure chosen in the course of negotiations.
- Conclusion of the Agreement
The Procuring entity publishes purchase agreement and accompanying documents.
Tutorial¶
Tender creation¶
- You can create three procedures:
reporting
- reporting with no stand-still periodnegotiation
- negotiation procedure with 10 day stand-still before contract registrationnegotiation.quick
- quick negotiation procedure with 5 day stand-still before contract registration
Creating tender for reporting procedure¶
To create tender for reporting procedure you should set reporting
value for procurementMethodType
.
Let’s create a tender:
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3197
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"procurementMethod": "limited",
"status": "active",
"title": "Послуги шкільних їдалень",
"procurementMethodType": "reporting",
"title_en": "Services in school canteens",
"description_en": "Services in school canteens",
"procuringEntity": {
"kind": "general",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна",
"telephone": "+380 (432) 46-53-02"
},
"address": {
"countryName": "Україна",
"postalCode": "21027",
"region": "м. Вінниця",
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця"
},
"name": "ЗОСШ #10 м.Вінниці"
},
"title_ru": "Услуги школьных столовых",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"description": "Послуги шкільних їдалень",
"id": "55.51.10.300"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286",
"endDate": "2017-06-24T20:02:22.515286"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"owner": "broker",
"value": {
"currency": "UAH",
"amount": 500000,
"valueAddedTaxIncluded": true
},
"description_ru": "Услуги школьных столовых"
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83
{
"access": {
"token": "a4b7ef7e4b1248eeb4856ef095f8e657"
},
"data": {
"procurementMethod": "limited",
"status": "active",
"title": "Послуги шкільних їдалень",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"title_en": "Services in school canteens",
"value": {
"currency": "UAH",
"amount": 500000.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2017-06-19T20:02:26.850123+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": "general",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"date": "2017-06-19T20:02:26.846364+03:00",
"procurementMethodType": "reporting",
"description_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"owner": "broker",
"description_ru": "Услуги школьных столовых",
"id": "7d7cb83ee1384fb78ca8aaf919990c83",
"tenderID": "UA-2017-06-19-000001"
}
}
We have 201 Created response code, Location header and body with extra id, tenderID, and dateModified properties.
Let’s check what tender registry contains:
GET /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
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": []
}
We do see the internal id of a tender (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/tenders/) and its dateModified datestamp.
Creating tender for negotiation procedure¶
To create tender for negotiation procedure you should set negotiation
value for procurementMethodType
.
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3743
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"procurementMethod": "limited",
"status": "active",
"causeDescription": "оригінальний тендер не вдався двічі",
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"procurementMethodType": "negotiation",
"description_en": "Services in school canteens",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"causeDescription_en": "original tender has failed twice",
"description_ru": "Услуги школьных столовых",
"procuringEntity": {
"kind": "general",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна",
"telephone": "+380 (432) 46-53-02"
},
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"countryName": "Україна",
"postalCode": "21027",
"region": "м. Вінниця",
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця"
}
},
"title_ru": "Услуги школьных столовых",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"description": "Послуги шкільних їдалень",
"id": "55.51.10.300"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286",
"endDate": "2017-06-24T20:02:22.515286"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"owner": "broker",
"value": {
"currency": "UAH",
"amount": 500000,
"valueAddedTaxIncluded": true
},
"cause": "twiceUnsuccessful"
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/0f67d0af4cdb47f2bab36b37e33bd84a
{
"access": {
"token": "62e6766aacb942c481ff5833e5f1274a"
},
"data": {
"procurementMethod": "limited",
"status": "active",
"causeDescription": "оригінальний тендер не вдався двічі",
"title": "Послуги шкільних їдалень",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"procurementMethodType": "negotiation",
"causeDescription_en": "original tender has failed twice",
"value": {
"currency": "UAH",
"amount": 500000.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2017-06-19T20:02:33.538428+03:00",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"date": "2017-06-19T20:02:33.534492+03:00",
"title_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"owner": "broker",
"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": "general",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"cause": "twiceUnsuccessful",
"id": "0f67d0af4cdb47f2bab36b37e33bd84a",
"tenderID": "UA-2017-06-19-000001"
}
}
Creating tender for negotiation.quick procedure¶
To create tender for negotiation.quick procedure you should set negotiation.quick
value for procurementMethodType
.
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3719
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"procurementMethod": "limited",
"status": "active",
"causeDescription": "оригінальний тендер не вдався двічі",
"title": "Послуги шкільних їдалень",
"procurementMethodType": "negotiation.quick",
"title_en": "Services in school canteens",
"description_en": "Services in school canteens",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"causeDescription_en": "original tender has failed twice",
"procuringEntity": {
"kind": "general",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна",
"telephone": "+380 (432) 46-53-02"
},
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"countryName": "Україна",
"postalCode": "21027",
"region": "м. Вінниця",
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця"
}
},
"title_ru": "Услуги школьных столовых",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"description": "Послуги шкільних їдалень",
"id": "55.51.10.300"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286",
"endDate": "2017-06-24T20:02:22.515286"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"owner": "broker",
"value": {
"currency": "UAH",
"amount": 500000,
"valueAddedTaxIncluded": true
},
"description_ru": "Услуги школьных столовых"
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/ed2bd8393c4a422786a49846f1a5eb61
{
"access": {
"token": "e3475b5af2ce460895020a2db1c9926d"
},
"data": {
"procurementMethod": "limited",
"status": "active",
"causeDescription": "оригінальний тендер не вдався двічі",
"title": "Послуги шкільних їдалень",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"procurementMethodType": "negotiation.quick",
"value": {
"currency": "UAH",
"amount": 500000.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2017-06-19T20:02:48.214465+03:00",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"date": "2017-06-19T20:02:48.211248+03:00",
"causeDescription_en": "original tender has failed twice",
"description_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"owner": "broker",
"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": "general",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title_en": "Services in school canteens",
"id": "ed2bd8393c4a422786a49846f1a5eb61",
"tenderID": "UA-2017-06-19-000001"
}
}
Modifying tender¶
Let’s update tender by supplementing it with all other essential properties:
PATCH /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 80
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"items": [
{
"unit": {
"code": "MON",
"name": "month"
},
"quantity": 9
}
]
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "limited",
"status": "active",
"title": "Послуги шкільних їдалень",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac",
"unit": {
"code": "MON",
"name": "month"
},
"quantity": 9
}
],
"title_en": "Services in school canteens",
"value": {
"currency": "UAH",
"amount": 500000.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2017-06-19T20:02:26.971415+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": "general",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"date": "2017-06-19T20:02:26.846364+03:00",
"procurementMethodType": "reporting",
"description_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"owner": "broker",
"description_ru": "Услуги школьных столовых",
"id": "7d7cb83ee1384fb78ca8aaf919990c83",
"tenderID": "UA-2017-06-19-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=2017-06-19T20%3A02%3A26.850123%2B03%3A00",
"uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=2017-06-19T20%3A02%3A26.850123%2B03%3A00",
"offset": "2017-06-19T20:02:26.850123+03:00"
},
"data": [
{
"id": "7d7cb83ee1384fb78ca8aaf919990c83",
"dateModified": "2017-06-19T20:02:26.850123+03:00"
}
]
}
Uploading documentation¶
Procuring entity can upload documents and files into the created tender. Uploading should follow the Documents Uploading rules.
POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 186
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy270263345618$
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/7d7cb83ee1384fb78ca8aaf919990c83/documents/90a857730bc54c21a77f93875b9e4b4a
{
"data": {
"title": "Notice.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/documents/90a857730bc54c21a77f93875b9e4b4a?download=b37decf945354cdda8c1fd1ca9494913",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:27.268883+03:00",
"id": "90a857730bc54c21a77f93875b9e4b4a",
"dateModified": "2017-06-19T20:02:27.268925+03:00"
}
}
201 Created response code and Location header confirm document creation.
In case we made an error, we can reupload the document over the older version:
PUT /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/documents/90a857730bc54c21a77f93875b9e4b4a?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 189
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy396991568191$
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"title": "Notice-2.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/documents/90a857730bc54c21a77f93875b9e4b4a?download=aad933d6edac492c883fd4ce020fecc8",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:27.268883+03:00",
"id": "90a857730bc54c21a77f93875b9e4b4a",
"dateModified": "2017-06-19T20:02:27.328930+03:00"
}
}
Awarding¶
Adding supplier information¶
Addition of supplier information is the same for all procedures.
Procuring entity registers supplier information for reporting procedure:
POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1284
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"date": "2016-01-14T18:07:00.628073+02:00",
"status": "pending",
"suppliers": [
{
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
],
"id": "d373338bc3324f14b8b3d4af68922773",
"value": {
"currency": "UAH",
"amount": 475000,
"valueAddedTaxIncluded": "true"
}
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557
{
"data": {
"status": "pending",
"date": "2017-06-19T20:02:27.381100+03:00",
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"id": "f73383149db344199699e1a8f587d557",
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
}
}
}
Procuring entity registers supplier information for negotiation procedure:
POST /api/2.3/tenders/0f67d0af4cdb47f2bab36b37e33bd84a/awards?acc_token=62e6766aacb942c481ff5833e5f1274a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1284
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"date": "2016-01-14T18:07:00.628073+02:00",
"status": "pending",
"suppliers": [
{
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
],
"id": "d373338bc3324f14b8b3d4af68922773",
"value": {
"currency": "UAH",
"amount": 475000,
"valueAddedTaxIncluded": "true"
}
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/0f67d0af4cdb47f2bab36b37e33bd84a/awards/13926fdfd30c4e2e939e9b7529fb0edd
{
"data": {
"status": "pending",
"complaintPeriod": {
"startDate": "2017-06-19T20:02:33.589328+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:33.587469+03:00",
"id": "13926fdfd30c4e2e939e9b7529fb0edd"
}
}
You can notice that there is complaintPeriod
record with startDate
value generated.
Procuring entity registers supplier information for negotiation.quick procedure:
POST /api/2.3/tenders/ed2bd8393c4a422786a49846f1a5eb61/awards?acc_token=e3475b5af2ce460895020a2db1c9926d HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1284
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"date": "2016-01-14T18:07:00.628073+02:00",
"status": "pending",
"suppliers": [
{
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
],
"id": "d373338bc3324f14b8b3d4af68922773",
"value": {
"currency": "UAH",
"amount": 475000,
"valueAddedTaxIncluded": "true"
}
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/ed2bd8393c4a422786a49846f1a5eb61/awards/cfcac0dba40547d3b128a94a2b0ffad1
{
"data": {
"status": "pending",
"complaintPeriod": {
"startDate": "2017-06-19T20:02:48.270327+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:48.268153+03:00",
"id": "cfcac0dba40547d3b128a94a2b0ffad1"
}
}
Award for negotiation.quick procedure also has complaintPeriod
record with startDate
value.
Uploading award documentation¶
You can upload award documents only before awarding decision is confirmed. Let’s add award document:
POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 203
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy334667136548$
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/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/31b77702354749ac9a50d5e0f0bc7bac
{
"data": {
"title": "award_first_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/31b77702354749ac9a50d5e0f0bc7bac?download=c6116315f7ae4f1e9b4758092f64f488",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:27.462126+03:00",
"id": "31b77702354749ac9a50d5e0f0bc7bac",
"dateModified": "2017-06-19T20:02:27.462169+03:00"
}
}
201 Created response code and Location header confirm that document has been added.
Let’s see the list of award documents:
GET /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "award_first_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/31b77702354749ac9a50d5e0f0bc7bac?download=c6116315f7ae4f1e9b4758092f64f488",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:27.462126+03:00",
"id": "31b77702354749ac9a50d5e0f0bc7bac",
"dateModified": "2017-06-19T20:02:27.462169+03:00"
}
]
}
We can add another award document:
POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 204
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy890262879158$
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/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/aa227933366a45f58e9fd3755163cdc3
{
"data": {
"title": "award_second_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/aa227933366a45f58e9fd3755163cdc3?download=b1f910c14523425eaf6104d74787ed4e",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:27.568107+03:00",
"id": "aa227933366a45f58e9fd3755163cdc3",
"dateModified": "2017-06-19T20:02:27.568153+03:00"
}
}
201 Created response code and Location header confirm second document has been added.
Let’s see the list of all uploaded award documents:
GET /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "award_first_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/31b77702354749ac9a50d5e0f0bc7bac?download=c6116315f7ae4f1e9b4758092f64f488",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:27.462126+03:00",
"id": "31b77702354749ac9a50d5e0f0bc7bac",
"dateModified": "2017-06-19T20:02:27.462169+03:00"
},
{
"title": "award_second_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/aa227933366a45f58e9fd3755163cdc3?download=b1f910c14523425eaf6104d74787ed4e",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:27.568107+03:00",
"id": "aa227933366a45f58e9fd3755163cdc3",
"dateModified": "2017-06-19T20:02:27.568153+03:00"
}
]
}
Award confirmation¶
Procuring entity can confirm awarding decision:
PATCH /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"title": "award_first_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/31b77702354749ac9a50d5e0f0bc7bac?download=c6116315f7ae4f1e9b4758092f64f488",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:27.462126+03:00",
"id": "31b77702354749ac9a50d5e0f0bc7bac",
"dateModified": "2017-06-19T20:02:27.462169+03:00"
},
{
"title": "award_second_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/aa227933366a45f58e9fd3755163cdc3?download=b1f910c14523425eaf6104d74787ed4e",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:27.568107+03:00",
"id": "aa227933366a45f58e9fd3755163cdc3",
"dateModified": "2017-06-19T20:02:27.568153+03:00"
}
],
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:27.690287+03:00",
"id": "f73383149db344199699e1a8f587d557"
}
}
Award confirmation for negotiation procedure:
PATCH /api/2.3/tenders/0f67d0af4cdb47f2bab36b37e33bd84a/awards/13926fdfd30c4e2e939e9b7529fb0edd?acc_token=62e6766aacb942c481ff5833e5f1274a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 49
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active",
"qualified": true
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"complaintPeriod": {
"startDate": "2017-06-19T20:02:33.589328+03:00",
"endDate": "2017-06-30T00:00:00+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
},
"qualified": true,
"date": "2017-06-19T20:02:33.656887+03:00",
"id": "13926fdfd30c4e2e939e9b7529fb0edd"
}
}
The difference between startDate
and endDate
in complaintPeriod
record for negotiation is 10 days.
Award confirmation for negotiation.quick procedure:
PATCH /api/2.3/tenders/ed2bd8393c4a422786a49846f1a5eb61/awards/cfcac0dba40547d3b128a94a2b0ffad1?acc_token=e3475b5af2ce460895020a2db1c9926d HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 49
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active",
"qualified": true
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"complaintPeriod": {
"startDate": "2017-06-19T20:02:48.270327+03:00",
"endDate": "2017-06-25T00:00:00+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
},
"qualified": true,
"date": "2017-06-19T20:02:48.345348+03:00",
"id": "cfcac0dba40547d3b128a94a2b0ffad1"
}
}
The difference between startDate
and endDate
in complaintPeriod
record for negotiation.quick is 5 days.
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/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"value": {
"amount": 238
}
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac",
"unit": {
"code": "MON",
"name": "month"
},
"quantity": 9
}
],
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:27.834848+03:00",
"awardID": "f73383149db344199699e1a8f587d557",
"id": "8da00d38b52248c8a87fe8b3ef0b0159",
"contractID": "UA-2017-06-19-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/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 54
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"dateSigned": "2017-06-19T20:02:22.515286"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac",
"unit": {
"code": "MON",
"name": "month"
},
"quantity": 9
}
],
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"dateSigned": "2017-06-19T20:02:22.515286+03:00",
"date": "2017-06-19T20:02:27.952492+03:00",
"awardID": "f73383149db344199699e1a8f587d557",
"id": "8da00d38b52248c8a87fe8b3ef0b0159",
"contractID": "UA-2017-06-19-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/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 106
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"period": {
"startDate": "2017-06-19T20:02:22.515286",
"endDate": "2018-06-19T20:02:22.515286"
}
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac",
"unit": {
"code": "MON",
"name": "month"
},
"quantity": 9
}
],
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"period": {
"startDate": "2017-06-19T20:02:22.515286+03:00",
"endDate": "2018-06-19T20:02:22.515286+03:00"
},
"dateSigned": "2017-06-19T20:02:22.515286+03:00",
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:28.073268+03:00",
"awardID": "f73383149db344199699e1a8f587d557",
"id": "8da00d38b52248c8a87fe8b3ef0b0159",
"contractID": "UA-2017-06-19-000001-1"
}
}
Uploading contract documentation¶
Contract documents can be uploaded only up until conclusion of the agreement. Let’s add contract document:
POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 206
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy942597007192$
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/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/771ef06d25c34c2d8e40ba275bc12550
{
"data": {
"title": "contract_first_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/771ef06d25c34c2d8e40ba275bc12550?download=ac838736f7ef4831a00e00ecb6a2c5df",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.190661+03:00",
"id": "771ef06d25c34c2d8e40ba275bc12550",
"dateModified": "2017-06-19T20:02:28.190709+03:00"
}
}
201 Created response code and Location header confirm that document has been added.
Let’s see the list of contract documents:
GET /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "contract_first_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/771ef06d25c34c2d8e40ba275bc12550?download=ac838736f7ef4831a00e00ecb6a2c5df",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.190661+03:00",
"id": "771ef06d25c34c2d8e40ba275bc12550",
"dateModified": "2017-06-19T20:02:28.190709+03:00"
}
]
}
We can add another contract document:
POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 207
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy206947069328$
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/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/49459ab3d7f84c04a319c95f8cc78dc2
{
"data": {
"title": "contract_second_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/49459ab3d7f84c04a319c95f8cc78dc2?download=ee07c83dc2de4b2c82b617ad5c4d3d07",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.342656+03:00",
"id": "49459ab3d7f84c04a319c95f8cc78dc2",
"dateModified": "2017-06-19T20:02:28.342704+03:00"
}
}
201 Created response code and Location header confirm second document has been added.
Let’s see the list of all uploaded contract documents:
GET /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"title": "contract_first_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/771ef06d25c34c2d8e40ba275bc12550?download=ac838736f7ef4831a00e00ecb6a2c5df",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.190661+03:00",
"id": "771ef06d25c34c2d8e40ba275bc12550",
"dateModified": "2017-06-19T20:02:28.190709+03:00"
},
{
"title": "contract_second_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/49459ab3d7f84c04a319c95f8cc78dc2?download=ee07c83dc2de4b2c82b617ad5c4d3d07",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.342656+03:00",
"id": "49459ab3d7f84c04a319c95f8cc78dc2",
"dateModified": "2017-06-19T20:02:28.342704+03:00"
}
]
}
Contract registration¶
Reporting tender contract can be registered immediately after award confirmation:
PATCH /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"title": "contract_first_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/771ef06d25c34c2d8e40ba275bc12550?download=ac838736f7ef4831a00e00ecb6a2c5df",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.190661+03:00",
"id": "771ef06d25c34c2d8e40ba275bc12550",
"dateModified": "2017-06-19T20:02:28.190709+03:00"
},
{
"title": "contract_second_document.doc",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/49459ab3d7f84c04a319c95f8cc78dc2?download=ee07c83dc2de4b2c82b617ad5c4d3d07",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.342656+03:00",
"id": "49459ab3d7f84c04a319c95f8cc78dc2",
"dateModified": "2017-06-19T20:02:28.342704+03:00"
}
],
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac",
"unit": {
"code": "MON",
"name": "month"
},
"quantity": 9
}
],
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"period": {
"startDate": "2017-06-19T20:02:22.515286+03:00",
"endDate": "2018-06-19T20:02:22.515286+03:00"
},
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"dateSigned": "2017-06-19T20:02:22.515286+03:00",
"date": "2017-06-19T20:02:28.532103+03:00",
"awardID": "f73383149db344199699e1a8f587d557",
"id": "8da00d38b52248c8a87fe8b3ef0b0159",
"contractID": "UA-2017-06-19-000001-1"
}
}
Negotiation tender contract can be registered only after the stand-still (10 day period after the award confirmation):
PATCH /api/2.3/tenders/0f67d0af4cdb47f2bab36b37e33bd84a/contracts/a082f0d8c9e0467799042ce231c43c98?acc_token=62e6766aacb942c481ff5833e5f1274a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
},
"dateSigned": "2017-06-19T20:02:33.798112+03:00",
"date": "2017-06-19T20:02:33.801458+03:00",
"awardID": "13926fdfd30c4e2e939e9b7529fb0edd",
"id": "a082f0d8c9e0467799042ce231c43c98",
"contractID": "UA-2017-06-19-000001-1"
}
}
Negotiation.quick tender contract can be registered after the stand-still (5 day period after the award confirmation):
PATCH /api/2.3/tenders/ed2bd8393c4a422786a49846f1a5eb61/contracts/036242a9296148228146e8e1fae0421a?acc_token=e3475b5af2ce460895020a2db1c9926d HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
},
"dateSigned": "2017-06-19T20:02:48.472611+03:00",
"date": "2017-06-19T20:02:48.476008+03:00",
"awardID": "cfcac0dba40547d3b128a94a2b0ffad1",
"id": "036242a9296148228146e8e1fae0421a",
"contractID": "UA-2017-06-19-000001-1"
}
}
Cancelling tender¶
Procuring entity can cancel tender anytime. The following steps should be applied:
- Prepare cancellation request
- Fill it with the protocol describing the cancellation reasons
- Cancel the tender with the reasons prepared.
Only the request that has been activated (3rd step above) has power to cancel tender. I.e. you have to not only prepare cancellation request but to activate it as well.
See Cancellation data structure for details.
Preparing the cancellation request¶
You should pass reason, status defaults to pending.
id is autogenerated and passed in the Location header of response.
POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"reason": "cancellation reason"
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430
{
"data": {
"status": "pending",
"reason": "cancellation reason",
"reasonType": "cancelled",
"date": "2017-06-19T20:02:28.702391+03:00",
"cancellationOf": "tender",
"id": "bc29eeeaf99743f986c6c3950e562430"
}
}
There are two possible types of cancellation reason - tender was cancelled or unsuccessful. By default
reasonType
value is cancelled.
You can change reasonType
value to unsuccessful.
PATCH /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 40
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"reasonType": "unsuccessful"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"reason": "cancellation reason",
"reasonType": "unsuccessful",
"date": "2017-06-19T20:02:28.702391+03:00",
"cancellationOf": "tender",
"id": "bc29eeeaf99743f986c6c3950e562430"
}
}
Filling cancellation with protocol and supplementary documentation¶
Upload the file contents
POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 186
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy508746614462$
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/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb
{
"data": {
"title": "Notice.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?download=472724ab0ed74ce2bb1bd1b68bd8294b",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.930888+03:00",
"id": "781cbd490bbd4c5eb23c40349514d8fb",
"dateModified": "2017-06-19T20:02:28.930940+03:00"
}
}
Change the document description and other properties
PATCH /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 48
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"description": "Changed description"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"description": "Changed description",
"title": "Notice.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?download=472724ab0ed74ce2bb1bd1b68bd8294b",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.930888+03:00",
"id": "781cbd490bbd4c5eb23c40349514d8fb",
"dateModified": "2017-06-19T20:02:28.930940+03:00"
}
}
Upload new version of the document
PUT /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 189
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy516532578802$
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"description": "Changed description",
"title": "Notice-2.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?download=8418c20c071d47bdbd3769a0b1200fe6",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.930888+03:00",
"id": "781cbd490bbd4c5eb23c40349514d8fb",
"dateModified": "2017-06-19T20:02:29.171645+03:00"
}
}
Activating the request and cancelling tender¶
PATCH /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"description": "Changed description",
"title": "Notice.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?download=472724ab0ed74ce2bb1bd1b68bd8294b",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.930888+03:00",
"id": "781cbd490bbd4c5eb23c40349514d8fb",
"dateModified": "2017-06-19T20:02:28.930940+03:00"
},
{
"description": "Changed description",
"title": "Notice-2.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?download=8418c20c071d47bdbd3769a0b1200fe6",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:28.930888+03:00",
"id": "781cbd490bbd4c5eb23c40349514d8fb",
"dateModified": "2017-06-19T20:02:29.171645+03:00"
}
],
"reason": "cancellation reason",
"reasonType": "unsuccessful",
"date": "2017-06-19T20:02:29.310210+03:00",
"cancellationOf": "tender",
"id": "bc29eeeaf99743f986c6c3950e562430"
}
}
Data Standard¶
Data standard is modelled along the Open Contracting Standard with extensions in areas that were not covered by it.
ProcuringEntity¶
Schema¶
name: | string, multilingual OpenContracting Description: The common name of the organization. |
---|---|
identifier: |
OpenContracting Description: The primary identifier for this organization. |
additionalIdentifiers: | |
List of Identifier objects |
|
address: | Address, required |
contactPoint: | ContactPoint, required |
kind: | string Type of procuring entity
|
Contract¶
Schema¶
id: | uid, auto-generated OpenContracting Description: The identifier for this contract. |
---|---|
awardID: | string, required OpenContracting Description: The Award.id against which this contract is being issued. |
contractID: | string, auto-generated, read-only |
title: | string, required OpenContracting Description: Contract title |
description: | string OpenContracting Description: Contract description |
items: | List of Item objects, auto-generated, read-only OpenContracting Description: The goods, services, and any intangible outcomes in this contract. Note: If the items are the same as the award do not repeat. |
suppliers: | List of Organization objects, auto-generated, read-only |
status: | string, required OpenContracting Description: The current status of the contract. Possible values are:
|
period: |
OpenContracting Description: The start and end date for the contract. |
value: | Value object, auto-generated, read-only OpenContracting Description: The total value of this contract. |
dateSigned: | string, Date, auto-generated OpenContracting Description: The date when the contract was signed. In the case of multiple signatures, the date of the last signature. Time frame for dateSigned:
|
date: | string, Date The date when the contract was changed or activated. |
documents: | List of Document objects OpenContracting Description: All documents and attachments related to the contract, including any notices. |
Item¶
Schema¶
id: | string, auto-generated |
||||||
---|---|---|---|---|---|---|---|
description: | string, multilingual, required OpenContracting Description: A description of the goods, services to be provided. |
||||||
classification: |
OpenContracting Description: The primary classification for the item. See the itemClassificationScheme to identify preferred classification lists, including CPV and GSIN. It is mandatory for classification.scheme to be CPV. The classification.id should be valid CPV code. |
||||||
additionalClassifications: | |||||||
List of Classification objects OpenContracting Description: An array of additional classifications for the item. See the itemClassificationScheme codelist for common options to use in OCDS. This may also be used to present codes from an internal classification scheme. It is mandatory to have at least one item with ДКПП as scheme. |
|||||||
unit: |
OpenContracting Description: Description of the unit which the good comes in e.g. hours, kilograms. Made up of a unit name, and the value of a single unit. |
||||||
quantity: | integer OpenContracting Description: The number of units required |
||||||
deliveryDate: | Period, requred Period during which the item should be delivered. |
||||||
deliveryAddress: | |||||||
Address, required Address, where the item should be delivered. |
|||||||
deliveryLocation: | |||||||
dictionary Geographical coordinates of delivery location. Element consist of the following items:
deliveryLocation usually takes precedence over deliveryAddress if both are present. |
|||||||
relatedLot: | string Id of related Lot. |
Classification¶
Schema¶
scheme: | string OpenContracting Description: A classification should be drawn from an existing scheme or list of codes. This field is used to indicate the scheme/codelist from which the classification is drawn. For line item classifications, this value should represent a known Item Classification Scheme wherever possible. |
---|---|
id: | string OpenContracting Description: The classification code drawn from the selected scheme. |
description: | string OpenContracting Description: A textual description or title for the code. |
uri: | uri OpenContracting Description: A URI to identify the code. In the event individual URIs are not available for items in the identifier scheme this value should be left blank. |
Unit¶
Document¶
Schema¶
id: | string, autogenerated |
---|---|
documentType: | string Possible values for Tender
Possible values for Award
Possible values for Contract
Possible values for Bid
|
title: | string, multilingual OpenContracting Description: The document title. |
description: | string, multilingual OpenContracting Description: A short description of the document. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document. |
format: | string OpenContracting Description: The format of the document taken from the IANA Media Types code list, with the addition of one extra value for ‘offline/print’, used when this document entry is being used to describe the offline publication of a document. |
url: | string, autogenerated OpenContracting Description: Direct link to the document or attachment. |
datePublished: | string, Date OpenContracting Description: The date on which the document was first published. |
dateModified: | string, Date OpenContracting Description: Date that the document was last modified |
language: | string OpenContracting Description: Specifies the language of the linked document using either two-digit ISO 639-1, or extended BCP47 language tags. |
documentOf: | string Possible values are:
|
relatedItem: | string |
Tender¶
Schema¶
title: | string, multilingual The name of the tender, displayed in listings. You can include the following items:
|
||||||||
---|---|---|---|---|---|---|---|---|---|
description: | string, multilingual Detailed description of tender. |
||||||||
tenderID: | string, auto-generated, read-only The tender identifier that can be used to find tender in “paper” documentation. OpenContracting Description: TenderID should always be the same as the OCID. It is included to make the flattened data structure more convenient. |
||||||||
procuringEntity: | |||||||||
ProcuringEntity, required Organization conducting the tender. OpenContracting Description: The entity managing the procurement, which may be different from the buyer who is paying / using the items being procured. If |
|||||||||
value: | Value, required Total available tender budget. OpenContracting Description: The total estimated value of the procurement. |
||||||||
items: | list of Item objects, required List that contains single item being procured. OpenContracting Description: The goods and services to be purchased, broken into line items wherever possible. Items should not be duplicated, but a quantity of 2 specified instead. |
||||||||
documents: | List of Document objects OpenContracting Description: All documents and attachments related to the tender. |
||||||||
awards: | List of Award objects All qualifications (disqualifications and awards). |
||||||||
contracts: |
OpenContracting Description: The date or period on which an award is anticipated to be made. |
||||||||
status: | string
Status of the Tender. |
||||||||
cancellations: | List of Cancellation objects. Contains 1 object with active status in case of cancelled Tender. The Cancellation object describes the reason of tender cancellation contains accompanying documents if any. |
||||||||
procurementMethod: | |||||||||
string, auto-generated
Procurement Method of the Tender. |
|||||||||
procurementMethodRationale: | |||||||||
string, multilingual Procurement Method Rationale of tender. |
|||||||||
procurementMethodType: | |||||||||
string
|
|||||||||
dateModified: | string, Date |
||||||||
owner: | string, auto-generated |
||||||||
cause: | string, required for negotiation procedure/ optional for negotiation.quick procedure Causes for using negotiation or negotiation.quick procedures. For more details see Article 35 of the Law of Ukraine “On Public Procurement”.
Purchase of art or intellectual property
Lack of competition
Two tenders have already been cancelled due to lack of participants
Need to use the same supplier for unification, standardization, etc.
Need of additional construction works
Purchase of legal services connected with protection of rights and interests of Ukraine
Procurement is urgent |
||||||||
causeDescription: | |||||||||
string, multilingual, required for negotiation and negotiation.quick procedures Reasoning behind usage of negotiation or negotiation.quick procedures. |
|||||||||
lots: | List of Lot objects. Contains all tender lots. Only if tender.procurementMethodType is negotiation or negotiation.quick. |
Award¶
Schema¶
id: | string, auto-generated, read-only OpenContracting Description: The identifier for this award. |
---|---|
title: | string, multilingual OpenContracting Description: Award title. |
description: | string, multilingual OpenContracting Description: Award description. |
status: | string OpenContracting Description: The current status of the award drawn from the awardStatus codelist. Possible values are:
|
date: | string, Date, auto-generated, read-only OpenContracting Description: The date of the contract award. |
value: | Value object OpenContracting Description: The total value of this award. |
suppliers: | List of Organization objects OpenContracting Description: The suppliers awarded with this award. |
items: | List of Item objects, auto-generated, read-only OpenContracting Description: The goods and services awarded in this award, broken into line items wherever possible. Items should not be duplicated, but the quantity specified instead. |
documents: | List of Document objects OpenContracting Description: All documents and attachments related to the award, including any notices. |
subcontractingDetails: | |
string The text field of any length that contains information about subcontractor. |
|
qualified: | bool Confirms that Procuring entity has no grounds to reject a participant in accordance with Article 17 of the Law of Ukraine “On Public Procurement”. |
lotID: | string Id of related Lot. Only if tender.procurementMethodType is negotiation or negotiation.quick. |
Cancellation¶
Schema¶
id: | uid, auto-generated |
||||
---|---|---|---|---|---|
reason: | string, multilingual, required The reason, why Tender is being cancelled. |
||||
status: | string
|
||||
documents: | List of Document objects Documents accompanying the Cancellation: Protocol of Tender Committee with decision to cancel the Tender. |
||||
date: | string, Date Cancellation date. |
||||
cancellationOf: | string, required Possible and default values are:
|
||||
relatedLot: | string Id of related Lot. |
Lot¶
Schema¶
id: | string, auto-generated |
||||||||
---|---|---|---|---|---|---|---|---|---|
title: | string, multilingual The name of the tender lot. |
||||||||
description: | string, multilingual Detailed description of tender lot. |
||||||||
value: | Value, required Total available tender lot budget. Bids greater then |
||||||||
status: | string
Status of the Lot. |
Multiple Lots Tutorial¶
Creating tender¶
Let’s create tender:
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3719
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"procurementMethod": "limited",
"status": "active",
"causeDescription": "оригінальний тендер не вдався двічі",
"title": "Послуги шкільних їдалень",
"procurementMethodType": "negotiation.quick",
"title_en": "Services in school canteens",
"description_en": "Services in school canteens",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"causeDescription_en": "original tender has failed twice",
"procuringEntity": {
"kind": "general",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"contactPoint": {
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна",
"telephone": "+380 (432) 46-53-02"
},
"name": "ЗОСШ #10 м.Вінниці",
"address": {
"countryName": "Україна",
"postalCode": "21027",
"region": "м. Вінниця",
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця"
}
},
"title_ru": "Услуги школьных столовых",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"description": "Послуги шкільних їдалень",
"id": "55.51.10.300"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286",
"endDate": "2017-06-24T20:02:22.515286"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"owner": "broker",
"value": {
"currency": "UAH",
"amount": 500000,
"valueAddedTaxIncluded": true
},
"description_ru": "Услуги школьных столовых"
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b
{
"access": {
"token": "56bff70fcb174649879a0f9d83055a8c"
},
"data": {
"procurementMethod": "limited",
"status": "active",
"causeDescription": "оригінальний тендер не вдався двічі",
"title": "Послуги шкільних їдалень",
"items": [
{
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"procurementMethodType": "negotiation.quick",
"value": {
"currency": "UAH",
"amount": 500000.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2017-06-19T20:02:50.485614+03:00",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"date": "2017-06-19T20:02:50.482399+03:00",
"causeDescription_en": "original tender has failed twice",
"description_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"owner": "broker",
"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": "general",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title_en": "Services in school canteens",
"id": "e2f60567d1d8406e8bc9f40931e1132b",
"tenderID": "UA-2017-06-19-000001"
}
}
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.
Tender can contain several different lots. We can add lot using the following way:
POST /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/lots?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 198
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"description": "Опис Лот №1",
"value": {
"currency": "UAH",
"amount": 500000,
"valueAddedTaxIncluded": true
},
"title": "Лот №1"
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/lots/132b472e0b564c2a9151fb10fa7abb08
{
"data": {
"status": "active",
"description": "Опис Лот №1",
"title": "Лот №1",
"value": {
"currency": "UAH",
"amount": 500000.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:50.533976+03:00",
"id": "132b472e0b564c2a9151fb10fa7abb08"
}
}
Also you will need to update data about item’s related lots:
PATCH /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 73
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"items": [
{
"relatedLot": "132b472e0b564c2a9151fb10fa7abb08"
}
]
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "limited",
"status": "active",
"causeDescription": "оригінальний тендер не вдався двічі",
"title": "Послуги шкільних їдалень",
"lots": [
{
"status": "active",
"description": "Опис Лот №1",
"title": "Лот №1",
"value": {
"currency": "UAH",
"amount": 500000.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:50.533976+03:00",
"id": "132b472e0b564c2a9151fb10fa7abb08"
}
],
"items": [
{
"relatedLot": "132b472e0b564c2a9151fb10fa7abb08",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"procurementMethodType": "negotiation.quick",
"value": {
"currency": "UAH",
"amount": 500000.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2017-06-19T20:02:50.619378+03:00",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"date": "2017-06-19T20:02:50.482399+03:00",
"causeDescription_en": "original tender has failed twice",
"description_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"owner": "broker",
"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": "general",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title_en": "Services in school canteens",
"id": "e2f60567d1d8406e8bc9f40931e1132b",
"tenderID": "UA-2017-06-19-000001"
}
}
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=2017-06-19T20%3A02%3A50.619378%2B03%3A00",
"uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=2017-06-19T20%3A02%3A50.619378%2B03%3A00",
"offset": "2017-06-19T20:02:50.619378+03:00"
},
"data": [
{
"id": "e2f60567d1d8406e8bc9f40931e1132b",
"dateModified": "2017-06-19T20:02:50.619378+03:00"
}
]
}
or view tender:
GET /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b HTTP/1.0
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "limited",
"status": "active",
"causeDescription": "оригінальний тендер не вдався двічі",
"title": "Послуги шкільних їдалень",
"lots": [
{
"status": "active",
"description": "Опис Лот №1",
"title": "Лот №1",
"value": {
"currency": "UAH",
"amount": 500000.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:50.533976+03:00",
"id": "132b472e0b564c2a9151fb10fa7abb08"
}
],
"items": [
{
"relatedLot": "132b472e0b564c2a9151fb10fa7abb08",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"procurementMethodType": "negotiation.quick",
"value": {
"currency": "UAH",
"amount": 500000.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2017-06-19T20:02:50.619378+03:00",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"date": "2017-06-19T20:02:50.482399+03:00",
"causeDescription_en": "original tender has failed twice",
"description_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"owner": "broker",
"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": "general",
"address": {
"postalCode": "21027",
"countryName": "Україна",
"streetAddress": "вул. Стахурського. 22",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title_en": "Services in school canteens",
"id": "e2f60567d1d8406e8bc9f40931e1132b",
"tenderID": "UA-2017-06-19-000001"
}
}
Awarding¶
Addition of supplier information is the same for all procedures.
Add award for lot №1:
POST /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/awards?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1329
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "pending",
"lotID": "132b472e0b564c2a9151fb10fa7abb08",
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000,
"valueAddedTaxIncluded": "true"
},
"date": "2016-01-14T18:07:00.628073+02:00",
"id": "d373338bc3324f14b8b3d4af68922773"
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/awards/d113ca3649e1455a8f839a496ed2ad36
{
"data": {
"status": "pending",
"lotID": "132b472e0b564c2a9151fb10fa7abb08",
"complaintPeriod": {
"startDate": "2017-06-19T20:02:50.795217+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:50.793061+03:00",
"id": "d113ca3649e1455a8f839a496ed2ad36"
}
}
Award confirmation:
PATCH /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/awards/d113ca3649e1455a8f839a496ed2ad36?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 49
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active",
"qualified": true
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"lotID": "132b472e0b564c2a9151fb10fa7abb08",
"complaintPeriod": {
"startDate": "2017-06-19T20:02:50.795217+03:00",
"endDate": "2017-06-25T00:00:00+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
},
"qualified": true,
"date": "2017-06-19T20:02:50.883003+03:00",
"id": "d113ca3649e1455a8f839a496ed2ad36"
}
}
The difference between startDate
and endDate
in complaintPeriod
record for negotiation is 10 days and for negotiation.quick is 5 days.
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/e2f60567d1d8406e8bc9f40931e1132b/contracts/3a0caa5770a54815bdd48cd2e07a8a20?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"value": {
"amount": 238
}
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"items": [
{
"relatedLot": "132b472e0b564c2a9151fb10fa7abb08",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:51.033377+03:00",
"awardID": "d113ca3649e1455a8f839a496ed2ad36",
"id": "3a0caa5770a54815bdd48cd2e07a8a20",
"contractID": "UA-2017-06-19-000001-1"
}
}
200 OK response was returned. The value was modified successfully.
Contract registration¶
Negotiation and Negotiation.quick tender contract can be registered only after the stand-still (10 and 5 days period after the award confirmation).
PATCH /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/contracts/3a0caa5770a54815bdd48cd2e07a8a20?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"items": [
{
"relatedLot": "132b472e0b564c2a9151fb10fa7abb08",
"description": "Послуги шкільних їдалень",
"classification": {
"scheme": "ДК021",
"description": "Послуги з харчування у школах",
"id": "55523100-3"
},
"description_en": "Services in school canteens",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "55.51.10.300",
"description": "Послуги шкільних їдалень"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-06-21T20:02:22.515286+03:00",
"endDate": "2017-06-24T20:02:22.515286+03:00"
},
"description_ru": "Услуги школьных столовых",
"id": "2dc54675d6364e2baffbc0f8e74432ac"
}
],
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"dateSigned": "2017-06-19T20:02:51.155028+03:00",
"date": "2017-06-19T20:02:51.158920+03:00",
"awardID": "d113ca3649e1455a8f839a496ed2ad36",
"id": "3a0caa5770a54815bdd48cd2e07a8a20",
"contractID": "UA-2017-06-19-000001-1"
}
}
Complaint Workflow¶
For more detailed information read Complaints.
Tender Award Complaints¶
Complaint Retrieval¶
Tender Award Complaint Retrieval¶
You can list all Tender Award Complaints:
GET /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints HTTP/1.0
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"status": "satisfied",
"dateDecision": "2017-06-19T20:02:43.043216+03:00",
"documents": [
{
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:41.325550+03:00",
"id": "3aeda15b69c74c3a82571eba2ff01577",
"dateModified": "2017-06-19T20:02:41.325597+03:00"
},
{
"author": "aboveThresholdReviewers",
"title": "ComplaintResolution.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:42.850136+03:00",
"id": "9799ddf93e664cf49abcc7b325e95198",
"dateModified": "2017-06-19T20:02:42.850182+03:00"
}
],
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"title": "Недостатньо інформації",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateAccepted": "2017-06-19T20:02:42.216517+03:00",
"dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
"complaintID": "UA-2017-06-19-000001.1",
"date": "2017-06-19T20:02:43.050448+03:00",
"acceptance": true,
"type": "complaint",
"id": "bd672abf667d4966974d2f6d6ae07310"
},
{
"status": "invalid",
"dateDecision": "2017-06-19T20:02:42.056253+03:00",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"acceptance": false,
"dateSubmitted": "2017-06-19T20:02:41.530724+03:00",
"complaintID": "UA-2017-06-19-000001.2",
"date": "2017-06-19T20:02:42.063253+03:00",
"title": "Недостатньо інформації",
"type": "complaint",
"id": "e80a7ee0db444c279b368deae7ead938"
},
{
"status": "declined",
"dateDecision": "2017-06-19T20:02:43.212370+03:00",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"acceptance": true,
"dateAccepted": "2017-06-19T20:02:42.370801+03:00",
"dateSubmitted": "2017-06-19T20:02:41.643973+03:00",
"complaintID": "UA-2017-06-19-000001.3",
"date": "2017-06-19T20:02:43.219571+03:00",
"title": "Недостатньо інформації",
"type": "complaint",
"id": "15d1eaca9c8443278c3ce4834228b306"
},
{
"status": "accepted",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"acceptance": true,
"dateAccepted": "2017-06-19T20:02:42.526127+03:00",
"dateSubmitted": "2017-06-19T20:02:41.765389+03:00",
"complaintID": "UA-2017-06-19-000001.4",
"date": "2017-06-19T20:02:42.533124+03:00",
"title": "Недостатньо інформації",
"type": "complaint",
"id": "54480f965268476a98b2aabef16d254b"
},
{
"status": "stopped",
"dateDecision": "2017-06-19T20:02:43.381162+03:00",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"title": "Недостатньо інформації",
"decision": "Тендер скасовується замовником",
"acceptance": true,
"dateCanceled": "2017-06-19T20:02:43.381188+03:00",
"dateAccepted": "2017-06-19T20:02:42.683801+03:00",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateSubmitted": "2017-06-19T20:02:41.900477+03:00",
"complaintID": "UA-2017-06-19-000001.5",
"date": "2017-06-19T20:02:43.388563+03:00",
"type": "complaint",
"id": "835aeb389f5b4fe19dc0854a4834e24d"
}
]
}
And check individual complaint:
GET /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310 HTTP/1.0
Host: api-sandbox.openprocurement.org
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "satisfied",
"dateDecision": "2017-06-19T20:02:43.043216+03:00",
"documents": [
{
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:41.325550+03:00",
"id": "3aeda15b69c74c3a82571eba2ff01577",
"dateModified": "2017-06-19T20:02:41.325597+03:00"
},
{
"author": "aboveThresholdReviewers",
"title": "ComplaintResolution.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:42.850136+03:00",
"id": "9799ddf93e664cf49abcc7b325e95198",
"dateModified": "2017-06-19T20:02:42.850182+03:00"
}
],
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"title": "Недостатньо інформації",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateAccepted": "2017-06-19T20:02:42.216517+03:00",
"dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
"complaintID": "UA-2017-06-19-000001.1",
"date": "2017-06-19T20:02:43.050448+03:00",
"acceptance": true,
"type": "complaint",
"id": "bd672abf667d4966974d2f6d6ae07310"
}
}
Complaint Submission¶
If tender award is favoriting certain supplier, or in any other viable case, any registered user can submit Tender Award Complaint.
Tender Award Complaint Submission (with documents)¶
At first create a complaint.
POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1682
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"author": {
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"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/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310
{
"access": {
"token": "f79c1cb574c848a4b7c56115c0b15c78"
},
"data": {
"status": "draft",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title": "Недостатньо інформації",
"complaintID": "UA-2017-06-19-000001.1",
"date": "2017-06-19T20:02:41.220238+03:00",
"type": "complaint",
"id": "bd672abf667d4966974d2f6d6ae07310"
}
}
Then upload necessary documents:
POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents?acc_token=f79c1cb574c848a4b7c56115c0b15c78 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 201
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy419159797722$
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/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577
{
"data": {
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:41.325550+03:00",
"id": "3aeda15b69c74c3a82571eba2ff01577",
"dateModified": "2017-06-19T20:02:41.325597+03:00"
}
}
Submit tender award complaint:
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310?acc_token=f79c1cb574c848a4b7c56115c0b15c78 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "pending"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"documents": [
{
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:41.325550+03:00",
"id": "3aeda15b69c74c3a82571eba2ff01577",
"dateModified": "2017-06-19T20:02:41.325597+03:00"
}
],
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"title": "Недостатньо інформації",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
"complaintID": "UA-2017-06-19-000001.1",
"date": "2017-06-19T20:02:41.435687+03:00",
"type": "complaint",
"id": "bd672abf667d4966974d2f6d6ae07310"
}
}
Tender Award Complaint Submission (without documents)¶
You can submit complaint that does not need additional documents:
POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1703
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "pending",
"title": "Недостатньо інформації",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.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/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/e80a7ee0db444c279b368deae7ead938
{
"access": {
"token": "1a833276567d4fccae7ac2d7fe187488"
},
"data": {
"status": "pending",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title": "Недостатньо інформації",
"dateSubmitted": "2017-06-19T20:02:41.530724+03:00",
"complaintID": "UA-2017-06-19-000001.2",
"date": "2017-06-19T20:02:41.530698+03:00",
"type": "complaint",
"id": "e80a7ee0db444c279b368deae7ead938"
}
}
Complaint Resolution¶
Rejecting Tender Award Complaint¶
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/e80a7ee0db444c279b368deae7ead938 HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "invalid"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "invalid",
"dateDecision": "2017-06-19T20:02:42.056253+03:00",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"acceptance": false,
"dateSubmitted": "2017-06-19T20:02:41.530724+03:00",
"complaintID": "UA-2017-06-19-000001.2",
"date": "2017-06-19T20:02:42.063253+03:00",
"title": "Недостатньо інформації",
"type": "complaint",
"id": "e80a7ee0db444c279b368deae7ead938"
}
}
Accepting Tender Award Complaint¶
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310 HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 32
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "accepted"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "accepted",
"documents": [
{
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:41.325550+03:00",
"id": "3aeda15b69c74c3a82571eba2ff01577",
"dateModified": "2017-06-19T20:02:41.325597+03:00"
}
],
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"title": "Недостатньо інформації",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateAccepted": "2017-06-19T20:02:42.216517+03:00",
"dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
"complaintID": "UA-2017-06-19-000001.1",
"date": "2017-06-19T20:02:42.223397+03:00",
"acceptance": true,
"type": "complaint",
"id": "bd672abf667d4966974d2f6d6ae07310"
}
}
Submitting Tender Award Complaint Resolution¶
The Complaint Review Body uploads the resolution document:
POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 197
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy22229671021$
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/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198
{
"data": {
"author": "aboveThresholdReviewers",
"title": "ComplaintResolution.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:42.850136+03:00",
"id": "9799ddf93e664cf49abcc7b325e95198",
"dateModified": "2017-06-19T20:02:42.850182+03:00"
}
}
And either resolves complaint:
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310 HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "satisfied"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "satisfied",
"dateDecision": "2017-06-19T20:02:43.043216+03:00",
"documents": [
{
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:41.325550+03:00",
"id": "3aeda15b69c74c3a82571eba2ff01577",
"dateModified": "2017-06-19T20:02:41.325597+03:00"
},
{
"author": "aboveThresholdReviewers",
"title": "ComplaintResolution.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:42.850136+03:00",
"id": "9799ddf93e664cf49abcc7b325e95198",
"dateModified": "2017-06-19T20:02:42.850182+03:00"
}
],
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"title": "Недостатньо інформації",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateAccepted": "2017-06-19T20:02:42.216517+03:00",
"dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
"complaintID": "UA-2017-06-19-000001.1",
"date": "2017-06-19T20:02:43.050448+03:00",
"acceptance": true,
"type": "complaint",
"id": "bd672abf667d4966974d2f6d6ae07310"
}
}
Or declines it:
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/15d1eaca9c8443278c3ce4834228b306 HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 32
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "declined"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "declined",
"dateDecision": "2017-06-19T20:02:43.212370+03:00",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"acceptance": true,
"dateAccepted": "2017-06-19T20:02:42.370801+03:00",
"dateSubmitted": "2017-06-19T20:02:41.643973+03:00",
"complaintID": "UA-2017-06-19-000001.3",
"date": "2017-06-19T20:02:43.219571+03:00",
"title": "Недостатньо інформації",
"type": "complaint",
"id": "15d1eaca9c8443278c3ce4834228b306"
}
}
Correcting problems¶
If tender award complaint was satisfied by the Complaint Review Body, then procuring entity has to correct problems.
One of the possible solutions is award cancellation:
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c?acc_token=d2ede8f9af2745f3a3638745304d52ad HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "cancelled"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "cancelled",
"complaintPeriod": {
"startDate": "2017-06-19T20:02:41.073980+03:00",
"endDate": "2017-06-19T20:02:43.738718+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:43.746020+03:00",
"qualified": true,
"complaints": [
{
"status": "satisfied",
"dateDecision": "2017-06-19T20:02:43.043216+03:00",
"documents": [
{
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:41.325550+03:00",
"id": "3aeda15b69c74c3a82571eba2ff01577",
"dateModified": "2017-06-19T20:02:41.325597+03:00"
},
{
"author": "aboveThresholdReviewers",
"title": "ComplaintResolution.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:42.850136+03:00",
"id": "9799ddf93e664cf49abcc7b325e95198",
"dateModified": "2017-06-19T20:02:42.850182+03:00"
}
],
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"title": "Недостатньо інформації",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateAccepted": "2017-06-19T20:02:42.216517+03:00",
"dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
"complaintID": "UA-2017-06-19-000001.1",
"date": "2017-06-19T20:02:43.050448+03:00",
"acceptance": true,
"type": "complaint",
"id": "bd672abf667d4966974d2f6d6ae07310"
},
{
"status": "invalid",
"dateDecision": "2017-06-19T20:02:42.056253+03:00",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"acceptance": false,
"dateSubmitted": "2017-06-19T20:02:41.530724+03:00",
"complaintID": "UA-2017-06-19-000001.2",
"date": "2017-06-19T20:02:42.063253+03:00",
"title": "Недостатньо інформації",
"type": "complaint",
"id": "e80a7ee0db444c279b368deae7ead938"
},
{
"status": "declined",
"dateDecision": "2017-06-19T20:02:43.212370+03:00",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"acceptance": true,
"dateAccepted": "2017-06-19T20:02:42.370801+03:00",
"dateSubmitted": "2017-06-19T20:02:41.643973+03:00",
"complaintID": "UA-2017-06-19-000001.3",
"date": "2017-06-19T20:02:43.219571+03:00",
"title": "Недостатньо інформації",
"type": "complaint",
"id": "15d1eaca9c8443278c3ce4834228b306"
},
{
"status": "accepted",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"acceptance": true,
"dateAccepted": "2017-06-19T20:02:42.526127+03:00",
"dateSubmitted": "2017-06-19T20:02:41.765389+03:00",
"complaintID": "UA-2017-06-19-000001.4",
"date": "2017-06-19T20:02:42.533124+03:00",
"title": "Недостатньо інформації",
"type": "complaint",
"id": "54480f965268476a98b2aabef16d254b"
},
{
"status": "stopped",
"dateDecision": "2017-06-19T20:02:43.381162+03:00",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"title": "Недостатньо інформації",
"decision": "Тендер скасовується замовником",
"acceptance": true,
"dateCanceled": "2017-06-19T20:02:43.381188+03:00",
"dateAccepted": "2017-06-19T20:02:42.683801+03:00",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateSubmitted": "2017-06-19T20:02:41.900477+03:00",
"complaintID": "UA-2017-06-19-000001.5",
"date": "2017-06-19T20:02:43.388563+03:00",
"type": "complaint",
"id": "835aeb389f5b4fe19dc0854a4834e24d"
}
],
"id": "e2e972fd12194b69acdc11f085ee2d3c"
}
}
Creating new award:
POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards?acc_token=d2ede8f9af2745f3a3638745304d52ad HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1284
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"date": "2016-01-14T18:07:00.628073+02:00",
"status": "pending",
"suppliers": [
{
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
],
"id": "d373338bc3324f14b8b3d4af68922773",
"value": {
"currency": "UAH",
"amount": 475000,
"valueAddedTaxIncluded": "true"
}
}
}
Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/06e2b40410f7418aa4b3d45eb33c90a7
{
"data": {
"status": "pending",
"complaintPeriod": {
"startDate": "2017-06-19T20:02:43.920891+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"value": {
"currency": "UAH",
"amount": 475000.0,
"valueAddedTaxIncluded": true
},
"date": "2017-06-19T20:02:43.919234+03:00",
"id": "06e2b40410f7418aa4b3d45eb33c90a7"
}
}
Submitting Resolution Confirmation¶
When complaint has been successfully resolved, procuring entity submits resolution confirmation.
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310?acc_token=d2ede8f9af2745f3a3638745304d52ad HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 361
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "resolved",
"tendererAction": "Умови виправлено, вибір переможня буде розгянуто повторно"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "resolved",
"dateDecision": "2017-06-19T20:02:43.043216+03:00",
"documents": [
{
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:41.325550+03:00",
"id": "3aeda15b69c74c3a82571eba2ff01577",
"dateModified": "2017-06-19T20:02:41.325597+03:00"
},
{
"author": "aboveThresholdReviewers",
"title": "ComplaintResolution.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-06-19T20:02:42.850136+03:00",
"id": "9799ddf93e664cf49abcc7b325e95198",
"dateModified": "2017-06-19T20:02:42.850182+03:00"
}
],
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title": "Недостатньо інформації",
"tendererAction": "Умови виправлено, вибір переможня буде розгянуто повторно",
"tendererActionDate": "2017-06-19T20:02:44.117092+03:00",
"dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
"complaintID": "UA-2017-06-19-000001.1",
"date": "2017-06-19T20:02:44.124875+03:00",
"acceptance": true,
"type": "complaint",
"id": "bd672abf667d4966974d2f6d6ae07310",
"dateAccepted": "2017-06-19T20:02:42.216517+03:00"
}
}
Submitting complaint to new award¶
POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/06e2b40410f7418aa4b3d45eb33c90a7/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1703
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "pending",
"title": "Недостатньо інформації",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.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/c58da022b8d04704bd0e9036a79e14e7/awards/06e2b40410f7418aa4b3d45eb33c90a7/complaints/a8e1e227638d4950b55dbe39bb15803b
{
"access": {
"token": "d8b48e544d2841f595e92b4c4019d2df"
},
"data": {
"status": "pending",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title": "Недостатньо інформації",
"dateSubmitted": "2017-06-19T20:02:44.903323+03:00",
"complaintID": "UA-2017-06-19-000001.6",
"date": "2017-06-19T20:02:44.903296+03:00",
"type": "complaint",
"id": "a8e1e227638d4950b55dbe39bb15803b"
}
}
Cancelling Tender Award Complaint¶
Cancelling not accepted complaint¶
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/06e2b40410f7418aa4b3d45eb33c90a7/complaints/ac8a06506c444a8c8e775d9f72c02be1?acc_token=b149c055bdfe4c38b11913e0691f1c36 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 150
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "cancelled",
"cancellationReason": "Умови виправлено"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "cancelled",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title": "Недостатньо інформації",
"cancellationReason": "Умови виправлено",
"dateCanceled": "2017-06-19T20:02:45.460475+03:00",
"complaintID": "UA-2017-06-19-000001.7",
"date": "2017-06-19T20:02:45.472775+03:00",
"type": "complaint",
"id": "ac8a06506c444a8c8e775d9f72c02be1"
}
}
Cancelling accepted complaint by Complainant¶
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/54480f965268476a98b2aabef16d254b?acc_token=17e9db6d3fc74de18324c586921b14e0 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 228
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "stopping",
"cancellationReason": "Тендер скасовується замовником"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "stopping",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"acceptance": true,
"cancellationReason": "Тендер скасовується замовником",
"dateCanceled": "2017-06-19T20:02:44.302245+03:00",
"dateAccepted": "2017-06-19T20:02:42.526127+03:00",
"dateSubmitted": "2017-06-19T20:02:41.765389+03:00",
"complaintID": "UA-2017-06-19-000001.4",
"date": "2017-06-19T20:02:44.310202+03:00",
"title": "Недостатньо інформації",
"type": "complaint",
"id": "54480f965268476a98b2aabef16d254b"
}
}
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/54480f965268476a98b2aabef16d254b HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 217
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "stopped",
"decision": "Тендер скасовується замовником"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "stopped",
"dateDecision": "2017-06-19T20:02:44.503176+03:00",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"title": "Недостатньо інформації",
"decision": "Тендер скасовується замовником",
"acceptance": true,
"cancellationReason": "Тендер скасовується замовником",
"dateCanceled": "2017-06-19T20:02:44.302245+03:00",
"dateAccepted": "2017-06-19T20:02:42.526127+03:00",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateSubmitted": "2017-06-19T20:02:41.765389+03:00",
"complaintID": "UA-2017-06-19-000001.4",
"date": "2017-06-19T20:02:44.511235+03:00",
"type": "complaint",
"id": "54480f965268476a98b2aabef16d254b"
}
}
Cancelling accepted complaint by Reviewer¶
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/835aeb389f5b4fe19dc0854a4834e24d HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 217
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "stopped",
"decision": "Тендер скасовується замовником"
}
}
Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "stopped",
"dateDecision": "2017-06-19T20:02:43.381162+03:00",
"description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
"title": "Недостатньо інформації",
"decision": "Тендер скасовується замовником",
"acceptance": true,
"dateCanceled": "2017-06-19T20:02:43.381188+03:00",
"dateAccepted": "2017-06-19T20:02:42.683801+03:00",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "13313462",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateSubmitted": "2017-06-19T20:02:41.900477+03:00",
"complaintID": "UA-2017-06-19-000001.5",
"date": "2017-06-19T20:02:43.388563+03:00",
"type": "complaint",
"id": "835aeb389f5b4fe19dc0854a4834e24d"
}
}
Roles¶
Complainant: | dashed |
---|---|
Procuring entity: | |
plain | |
Reviewer: | bold |
Chronograph: | dotted |
Statuses¶
draft: | Initial status Complainant can submit claim, upload documents, cancel claim, and re-submit it. |
---|---|
claim: | Procuring entity can upload documents and answer to claim. Complainant can cancel claim. |
answered: | Complainant can cancel claim, upload documents, accept solution or escalate claim to complaint. |
pending: | Reviewer can upload documents and review complaint. Complainant can cancel claim. |
invalid: | Terminal status Complaint recognized as invalid. |
declined: | Terminal status Complaint recognized as declined. |
resolved: | Terminal status Complaint recognized as resolved. |
cancelled: | Terminal status Complaint cancelled by complainant. |
Acceleration mode for sandbox¶
Acceleration mode was developed to enable Negotiation and Negotiation.quick procedures testing in the sandbox and to reduce time frames of these procedures.
In order to use acceleration mode you should set quick, accelerator=1440 as text value for procurementMethodDetails during tender creation. The number 1440 shows that restrictions and time frames will be reduced in 1440 times. For example, complaintPeriod for the Negotiation procedure should be at least 10 days. When using the acceleration mode with 1440 value, tenderingPeriod can be as short as 10 minutes (10 days = 14400 min; 14400/1440 = 10 min). This mode will work only in the sandbox.