Tutorial
Creating plan procurement
We strongly recommend creating plans in draft status.
Let’s create a plan:
Request
POST /api/2.5/plans?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": {
"description": "Недостатньо змістовне обгрунтування"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00"
}
},
"items": [
{
"deliveryDate": {
"endDate": "2023-10-25T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"code": "KGM",
"name": "кг"
},
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"quantity": 1000,
"description": "Насіння гірчиці"
},
{
"deliveryDate": {
"endDate": "2023-10-26T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"unit": {
"code": "KGM",
"name": "кг"
},
"classification": {
"scheme": "ДК021",
"description": "Sunflower seeds",
"id": "03111300-5"
},
"quantity": 2000,
"description": "Насіння соняшнику"
},
{
"deliveryDate": {
"endDate": "2023-10-27T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"unit": {
"code": "KGM",
"name": "кг"
},
"classification": {
"scheme": "ДК021",
"description": "Cotton seeds",
"id": "03111400-6"
},
"quantity": 3000,
"description": "Насіння бавовнику"
}
],
"classification": {
"scheme": "ДК021",
"description": "Seeds",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"procuringEntity": {
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"name": "ДУС",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general"
},
"buyers": [
{
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"name": "ДУС",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general"
}
],
"budget": {
"project": {
"name": "proj_name",
"id": "123"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2023-01-01T00:00:00",
"endDate": "2023-12-31T00:00:00"
}
},
"status": "draft"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/647ea8f38f72484ea0245b71b7cd4231
{
"data": {
"status": "draft",
"procuringEntity": {
"id": "59fd7716ba954f7c9ed44eff506106a5",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "123",
"name": "proj_name"
},
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"items": [
{
"id": "e163ef58b47e42ccbacc9706d4fbd0eb",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-25T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "ae37d2d419704b4e85311f2b59b7d2f3",
"classification": {
"description": "Sunflower seeds",
"scheme": "ДК021",
"id": "03111300-5"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 2000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-26T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "e0e469224d1a4746a9cf02d4a7ccc70c",
"classification": {
"description": "Cotton seeds",
"scheme": "ДК021",
"id": "03111400-6"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 3000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-27T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "e0cc0f5599f44b6cbf9acffd0a6c9dd0",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2023-10-10T01:00:00+03:00"
},
"planID": "UA-P-2023-10-10-000001-a",
"owner": "broker",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"id": "647ea8f38f72484ea0245b71b7cd4231"
},
"access": {
"token": "499da8e897254fb7a478ae7555785628",
"transfer": "afcfaf20511c4a4ab431b503208ccbe1"
}
}
We have 201 Created response code, Location header and body with extra id, planID, and dateModified properties.
The second step is moving the plan to scheduled status so that it becomes actually published:
Request
PATCH /api/2.5/plans/647ea8f38f72484ea0245b71b7cd4231?acc_token=499da8e897254fb7a478ae7555785628 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "scheduled"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "59fd7716ba954f7c9ed44eff506106a5",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "123",
"name": "proj_name"
},
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-10-10-000001-a",
"items": [
{
"id": "e163ef58b47e42ccbacc9706d4fbd0eb",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-25T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "ae37d2d419704b4e85311f2b59b7d2f3",
"classification": {
"description": "Sunflower seeds",
"scheme": "ДК021",
"id": "03111300-5"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 2000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-26T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "e0e469224d1a4746a9cf02d4a7ccc70c",
"classification": {
"description": "Cotton seeds",
"scheme": "ДК021",
"id": "03111400-6"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 3000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-27T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "e0cc0f5599f44b6cbf9acffd0a6c9dd0",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2023-10-10T01:00:00+03:00"
},
"owner": "broker",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"datePublished": "2023-10-10T01:00:00+03:00",
"id": "647ea8f38f72484ea0245b71b7cd4231"
}
}
Let’s check what plan registry contains:
Request
GET /api/2.5/plans HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "647ea8f38f72484ea0245b71b7cd4231"
}
],
"next_page": {
"offset": 1696888800.0,
"path": "/api/2.5/plans?offset=1696888800.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/plans?offset=1696888800.0"
}
}
We do see the internal id of a plan (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/plans/) and its dateModified datestamp.
Modifying plan
Let’s update plan by supplementing it with all other essential properties:
Request
PATCH /api/2.5/plans/647ea8f38f72484ea0245b71b7cd4231?acc_token=499da8e897254fb7a478ae7555785628 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"description": "Насіння овочевих культур",
"classification": {
"scheme": "ДК021",
"description": "Vegetable seeds",
"id": "03111700-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.13.6",
"description": "Насіння овочевих культур"
}
],
"deliveryDate": {
"endDate": "2016-06-01T23:06:30.023018+03:00"
},
"unit": {
"code": "KGM",
"name": "кг"
},
"quantity": 5000
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "59fd7716ba954f7c9ed44eff506106a5",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "123",
"name": "proj_name"
},
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-10-10-000001-a",
"items": [
{
"id": "8265d940677245ab849e78e617bd6f22",
"classification": {
"description": "Vegetable seeds",
"scheme": "ДК021",
"id": "03111700-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.13.6",
"description": "Насіння овочевих культур"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 5000.0,
"deliveryDate": {
"endDate": "2016-06-01T23:06:30.023018+03:00"
},
"description": "Насіння овочевих культур"
}
],
"buyers": [
{
"id": "e0cc0f5599f44b6cbf9acffd0a6c9dd0",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2023-10-10T01:00:00+03:00"
},
"owner": "broker",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"datePublished": "2023-10-10T01:00:00+03:00",
"id": "647ea8f38f72484ea0245b71b7cd4231"
}
}
We see the added properies have merged with existing plan data. Additionally, the dateModified property was updated to reflect the last modification datestamp.
Checking the listing again reflects the new modification date:
Request
GET /api/2.5/plans HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "647ea8f38f72484ea0245b71b7cd4231"
}
],
"next_page": {
"offset": 1696888800.0,
"path": "/api/2.5/plans?offset=1696888800.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/plans?offset=1696888800.0"
}
}
Tender creation from a procurement plan
A tender can be created from your procurement plan. This tender will be linked with the plan using tender’s plans and plan’s tender_id fields.
Note
System failures during tender-from-plan creation can produce tenders that are not linked with their plans by tender_id.
Make sure you do use 2 Phase Commit and do not proceed with these error state tender objects (create new ones).
There are validation rules that are supposed to decline the chance of making a mistake
Request
POST /api/2.5/plans/647ea8f38f72484ea0245b71b7cd4231/tenders HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"endDate": "2023-11-10T00:00:00+02:00"
},
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"minimalStep": {
"currency": "UAH",
"amount": 5
},
"procurementMethodType": "aboveThresholdEU",
"value": {
"currency": "UAH",
"amount": 500
},
"procuringEntity": {
"kind": "general",
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21027",
"region": "Вінницька область",
"streetAddress": "вул. Стахурського. 22"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"name_en": "Kutsa Svitlana V.",
"telephone": "+380432465302",
"availableLanguage": "uk",
"url": "http://sch10.edu.vn.ua/"
},
"identifier": {
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
"scheme": "UA-EDR"
},
"name": "ЗОСШ #10 м.Вінниці",
"name_en": "School #10 of Vinnytsia"
},
"items": [
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"description_en": "Services in school canteens",
"classification": {
"scheme": "ДК021",
"id": "37810000-9",
"description": "Test"
},
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"unit": {
"code": "KGM",
"name": "кілограм",
"value": {
"amount": 6
}
},
"quantity": 1
},
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"description_en": "Services in school canteens",
"classification": {
"scheme": "ДК021",
"id": "37810000-9",
"description": "Test"
},
"unit": {
"code": "PK",
"name": "упаковка",
"value": {
"amount": 6
}
},
"quantity": 1,
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
],
"mainProcurementCategory": "services"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "procurementMethodType",
"description": "procurementMethodType doesn't match: belowThreshold != aboveThresholdEU"
}
]
}
There are three of them:
procurementMethodType
procuringEntity.identifier - matching id and scheme with the same fields in tender data
classification.id - matching with tender item classification codes using first 4 digits (
336is exception)
Plan should contain budget breakdown, otherwise it will be an error during tender creation:
Request
POST /api/2.5/plans/647ea8f38f72484ea0245b71b7cd4231/tenders HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Насіння",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"value": {
"amount": 500,
"currency": "UAH"
},
"minimalStep": {
"amount": 15,
"currency": "UAH"
},
"items": [
{
"deliveryDate": {
"endDate": "2023-10-25T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"code": "KGM",
"name": "кг"
},
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"quantity": 1000,
"description": "Насіння гірчиці"
},
{
"deliveryDate": {
"endDate": "2023-10-26T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"unit": {
"code": "KGM",
"name": "кг"
},
"classification": {
"scheme": "ДК021",
"description": "Sunflower seeds",
"id": "03111300-5"
},
"quantity": 2000,
"description": "Насіння соняшнику"
},
{
"deliveryDate": {
"endDate": "2023-10-27T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"unit": {
"code": "KGM",
"name": "кг"
},
"classification": {
"scheme": "ДК021",
"description": "Cotton seeds",
"id": "03111400-6"
},
"quantity": 3000,
"description": "Насіння бавовнику"
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T00:00:00+02:00"
},
"procurementMethodType": "belowThreshold",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
],
"status": "draft"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "budget.breakdown",
"description": "Plan should contain budget breakdown"
}
]
}
Let’s add budget breakdown to plan:
Request
PATCH /api/2.5/plans/647ea8f38f72484ea0245b71b7cd4231?acc_token=499da8e897254fb7a478ae7555785628 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"budget": {
"project": {
"name": "proj_name",
"id": "123"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2023-01-01T00:00:00",
"endDate": "2023-12-31T00:00:00"
},
"breakdown": [
{
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "59fd7716ba954f7c9ed44eff506106a5",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "123",
"name": "proj_name"
},
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "88ef03e7027447a4b70444b262521dec",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-10-10-000001-a",
"items": [
{
"id": "8265d940677245ab849e78e617bd6f22",
"classification": {
"description": "Vegetable seeds",
"scheme": "ДК021",
"id": "03111700-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.13.6",
"description": "Насіння овочевих культур"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 5000.0,
"deliveryDate": {
"endDate": "2016-06-01T23:06:30.023018+03:00"
},
"description": "Насіння овочевих культур"
}
],
"buyers": [
{
"id": "e0cc0f5599f44b6cbf9acffd0a6c9dd0",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2023-10-10T01:00:00+03:00"
},
"owner": "broker",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"datePublished": "2023-10-10T01:00:00+03:00",
"id": "647ea8f38f72484ea0245b71b7cd4231"
}
}
A successful example looks like this:
Request
POST /api/2.5/plans/647ea8f38f72484ea0245b71b7cd4231/tenders HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Насіння",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"value": {
"amount": 500,
"currency": "UAH"
},
"minimalStep": {
"amount": 15,
"currency": "UAH"
},
"items": [
{
"deliveryDate": {
"endDate": "2023-10-25T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"code": "KGM",
"name": "кг"
},
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"quantity": 1000,
"description": "Насіння гірчиці"
},
{
"deliveryDate": {
"endDate": "2023-10-26T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"unit": {
"code": "KGM",
"name": "кг"
},
"classification": {
"scheme": "ДК021",
"description": "Sunflower seeds",
"id": "03111300-5"
},
"quantity": 2000,
"description": "Насіння соняшнику"
},
{
"deliveryDate": {
"endDate": "2023-10-27T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"unit": {
"code": "KGM",
"name": "кг"
},
"classification": {
"scheme": "ДК021",
"description": "Cotton seeds",
"id": "03111400-6"
},
"quantity": 3000,
"description": "Насіння бавовнику"
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T00:00:00+02:00"
},
"procurementMethodType": "belowThreshold",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
],
"status": "draft"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7f5e6c2aa6f54cc3a2f6589002f0d6ce
{
"data": {
"mainProcurementCategory": "goods",
"title": "Насіння",
"status": "draft",
"awardCriteria": "lowestCost",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"items": [
{
"id": "5828ed46f9184580a3de1b95535f9df9",
"description": "Насіння гірчиці",
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"deliveryDate": {
"endDate": "2023-10-25T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "9db989db3ad44254a2a64b7d1874c3e9",
"description": "Насіння соняшнику",
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 2000.0,
"classification": {
"description": "Sunflower seeds",
"scheme": "ДК021",
"id": "03111300-5"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"deliveryDate": {
"endDate": "2023-10-26T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "1bc5eb35f18a41bb9870224788b922d8",
"description": "Насіння бавовнику",
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 3000.0,
"classification": {
"description": "Cotton seeds",
"scheme": "ДК021",
"id": "03111400-6"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"deliveryDate": {
"endDate": "2023-10-27T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "2803bbf7f8ea47759525c44ef0a52cd1",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procurementMethodType": "belowThreshold",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-19T00:00:00+03:00"
},
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "7f5e6c2aa6f54cc3a2f6589002f0d6ce",
"plans": [
{
"id": "647ea8f38f72484ea0245b71b7cd4231"
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
},
"access": {
"token": "098d33295ed448cfa248af0641ed8ec8",
"transfer": "90260c36ef2349518f963a4ca6d1053b"
}
}
Let’s check that the plan status was switched to complete:
Request
GET /api/2.5/plans/647ea8f38f72484ea0245b71b7cd4231 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "complete",
"procuringEntity": {
"id": "59fd7716ba954f7c9ed44eff506106a5",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "123",
"name": "proj_name"
},
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "88ef03e7027447a4b70444b262521dec",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-10-10-000001-a",
"items": [
{
"id": "8265d940677245ab849e78e617bd6f22",
"classification": {
"description": "Vegetable seeds",
"scheme": "ДК021",
"id": "03111700-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.13.6",
"description": "Насіння овочевих культур"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 5000.0,
"deliveryDate": {
"endDate": "2016-06-01T23:06:30.023018+03:00"
},
"description": "Насіння овочевих культур"
}
],
"buyers": [
{
"id": "e0cc0f5599f44b6cbf9acffd0a6c9dd0",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2023-10-10T01:00:00+03:00"
},
"owner": "broker",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"datePublished": "2023-10-10T01:00:00+03:00",
"tender_id": "7f5e6c2aa6f54cc3a2f6589002f0d6ce",
"id": "647ea8f38f72484ea0245b71b7cd4231"
}
}
After tender was created from plan it’s no longer allowed to change plan:
Request
PATCH /api/2.5/plans/647ea8f38f72484ea0245b71b7cd4231?acc_token=499da8e897254fb7a478ae7555785628 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"procuringEntity": {
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"name": "ДУС"
}
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "procuringEntity",
"description": {
"address": [
"This field is required."
],
"kind": [
"This field is required."
]
}
}
]
}
Plan completing without tendering
There is a way to complete a plan without tender creation:
Request
PATCH /api/2.5/plans/efc2bdfd149240f1bf2262ff356c60d0?acc_token=cc99c7a557f54ca08b0bf5d757bb11b8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "complete"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "complete",
"procuringEntity": {
"id": "def790be05b74139ab77d236a7382740",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "123",
"name": "proj_name"
},
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-10-11-000001-a",
"items": [
{
"id": "eefce1d2abac4e90b26369880f787f7b",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-25T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "6683a906d04e459383b2d54ec4061eb8",
"classification": {
"description": "Sunflower seeds",
"scheme": "ДК021",
"id": "03111300-5"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 2000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-26T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "f15208f65b534133bccc300132f0a778",
"classification": {
"description": "Cotton seeds",
"scheme": "ДК021",
"id": "03111400-6"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 3000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-27T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "2bce6ee3884c474ab3ef8337303f0a75",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2023-10-11T02:00:33+03:00"
},
"owner": "broker",
"dateCreated": "2023-10-11T02:00:33+03:00",
"dateModified": "2023-10-11T02:00:33+03:00",
"datePublished": "2023-10-11T02:00:33+03:00",
"id": "efc2bdfd149240f1bf2262ff356c60d0"
}
}
This only works if procurementMethodType is one of the following:
belowThreshold
reportingempty string
Plan cancellation
A plan can be cancelled using PlanCancellation:
Request
PATCH /api/2.5/plans/b0fe086d27094c24895c95d0b2a6b29d?acc_token=9b0c2eb782a148278eafc00e8a90a28c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"cancellation": {
"reason": "Підстава для скасування",
"reason_en": "Reason of the cancellation"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "4df1f9e4cc5649ffab24a5bfb0bfc994",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "123",
"name": "proj_name"
},
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-10-11-000002-a",
"items": [
{
"id": "e42b0b8206564451a7fc8febbbf790ad",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-25T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "8774033b75b04f649cfe3b04dce1255f",
"classification": {
"description": "Sunflower seeds",
"scheme": "ДК021",
"id": "03111300-5"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 2000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-26T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "8de84bee0b3c4440bd96801659c5bc99",
"classification": {
"description": "Cotton seeds",
"scheme": "ДК021",
"id": "03111400-6"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 3000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-27T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "255ab9dd605242fe8cb94aad962090c9",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"cancellation": {
"reason": "Підстава для скасування",
"reason_en": "Reason of the cancellation",
"status": "pending",
"id": "061bcecf77af4f94ab34a39317d9305c",
"date": "2023-10-11T02:00:33+03:00"
},
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2023-10-11T02:00:33+03:00"
},
"owner": "broker",
"dateCreated": "2023-10-11T02:00:33+03:00",
"dateModified": "2023-10-11T02:00:33+03:00",
"datePublished": "2023-10-11T02:00:33+03:00",
"id": "b0fe086d27094c24895c95d0b2a6b29d"
}
}
Making the cancellation object active cancels the plan:
Request
PATCH /api/2.5/plans/b0fe086d27094c24895c95d0b2a6b29d?acc_token=9b0c2eb782a148278eafc00e8a90a28c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"cancellation": {
"reason": "Підстава для скасування",
"status": "active"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "cancelled",
"procuringEntity": {
"id": "4df1f9e4cc5649ffab24a5bfb0bfc994",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "123",
"name": "proj_name"
},
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-10-11-000002-a",
"items": [
{
"id": "e42b0b8206564451a7fc8febbbf790ad",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-25T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "8774033b75b04f649cfe3b04dce1255f",
"classification": {
"description": "Sunflower seeds",
"scheme": "ДК021",
"id": "03111300-5"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 2000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-26T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "8de84bee0b3c4440bd96801659c5bc99",
"classification": {
"description": "Cotton seeds",
"scheme": "ДК021",
"id": "03111400-6"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 3000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2023-10-27T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "255ab9dd605242fe8cb94aad962090c9",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"cancellation": {
"reason": "Підстава для скасування",
"status": "active",
"id": "2962ba3967934f68af977c7e2dac0ad1",
"date": "2023-10-11T02:00:33+03:00"
},
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2023-10-11T02:00:33+03:00"
},
"owner": "broker",
"dateCreated": "2023-10-11T02:00:33+03:00",
"dateModified": "2023-10-11T02:00:33+03:00",
"datePublished": "2023-10-11T02:00:33+03:00",
"id": "b0fe086d27094c24895c95d0b2a6b29d"
}
}
Plan rationale update
The rationale field can be updated at any plan status:
Request
PATCH /api/2.5/plans/647ea8f38f72484ea0245b71b7cd4231?acc_token=499da8e897254fb7a478ae7555785628 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": {
"description": "Змістовне пояснення необхідності закупівлі"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "complete",
"procuringEntity": {
"id": "59fd7716ba954f7c9ed44eff506106a5",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "123",
"name": "proj_name"
},
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "88ef03e7027447a4b70444b262521dec",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"tender_id": "7f5e6c2aa6f54cc3a2f6589002f0d6ce",
"planID": "UA-P-2023-10-10-000001-a",
"items": [
{
"id": "8265d940677245ab849e78e617bd6f22",
"classification": {
"description": "Vegetable seeds",
"scheme": "ДК021",
"id": "03111700-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.13.6",
"description": "Насіння овочевих культур"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 5000.0,
"deliveryDate": {
"endDate": "2016-06-01T23:06:30.023018+03:00"
},
"description": "Насіння овочевих культур"
}
],
"buyers": [
{
"id": "e0cc0f5599f44b6cbf9acffd0a6c9dd0",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"rationale": {
"description": "Змістовне пояснення необхідності закупівлі",
"date": "2023-10-11T02:00:33+03:00"
},
"owner": "broker",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-11T02:00:33+03:00",
"datePublished": "2023-10-10T01:00:00+03:00",
"id": "647ea8f38f72484ea0245b71b7cd4231"
}
}
Plan fields history
There is an endpoint that can show changes history of the certain fields.
At the moment only rationale is supported:
Request
GET /api/2.5/history/plans/647ea8f38f72484ea0245b71b7cd4231?opt_fields=rationale HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"changes": [
{
"date": "2023-10-10T01:00:00+03:00",
"data": {
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2023-10-10T01:00:00+03:00"
}
}
},
{
"date": "2023-10-11T02:00:33+03:00",
"data": {
"rationale": {
"description": "Змістовне пояснення необхідності закупівлі",
"date": "2023-10-11T02:00:33+03:00"
}
}
}
]
}
}