Tutorial
Creating plan procurement
We strongly recommend creating plans in draft status.
Let’s create a plan:
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": "2027-01-08T00:00:00+02:00"
}
},
"items": [
{
"deliveryDate": {
"endDate": "2027-01-16T00: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": "2027-01-17T00: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": "2027-01-18T00: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": "2000",
"description": "Поточні видатки"
}
],
"procuringEntity": {
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"name": "ДУС",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"buyers": [
{
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"name": "ДУС",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"budget": {
"project": {
"name": "proj_name",
"id": "123"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2027-01-01T00:00:00",
"endDate": "2027-12-31T00:00:00"
},
"breakdown": [
{
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"status": "draft"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b
{
"data": {
"status": "draft",
"procuringEntity": {
"id": "019119a10d54454c87160a4ef37ee2d4",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00: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": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "94fe0f8da6ae4848a61651a731437bdf",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"items": [
{
"id": "2b13ae33978148fb9b77de4996cda2d3",
"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": "2027-01-16T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "42e33d5b17fb41c5955319fb22d63f9e",
"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": "2027-01-17T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "2b38eca569584f28947fadfae8a05b37",
"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": "2027-01-18T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "a24fc4de512141d294ae3ccab128061d",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-01T00:00:00+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"planID": "UA-P-2027-01-01-000001-a",
"owner": "broker",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
},
"access": {
"token": "80859e574f134c2293a68741f9752cb3",
"transfer": "880bc5d414e8422eb41f87466feed9bb"
}
}
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:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "scheduled"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "019119a10d54454c87160a4ef37ee2d4",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00: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": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "94fe0f8da6ae4848a61651a731437bdf",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"planID": "UA-P-2027-01-01-000001-a",
"items": [
{
"id": "2b13ae33978148fb9b77de4996cda2d3",
"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": "2027-01-16T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "42e33d5b17fb41c5955319fb22d63f9e",
"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": "2027-01-17T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "2b38eca569584f28947fadfae8a05b37",
"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": "2027-01-18T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "a24fc4de512141d294ae3ccab128061d",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-01T00:00:00+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"owner": "broker",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"datePublished": "2027-01-01T00:00:00+02:00",
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
}
}
Let’s check what plan registry contains:
GET /api/2.5/plans HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
}
],
"next_page": {
"offset": "1798754400.0.1.8d94e47845ce869c52e12fce4590c523",
"path": "/api/2.5/plans?offset=1798754400.0.1.8d94e47845ce869c52e12fce4590c523",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/plans?offset=1798754400.0.1.8d94e47845ce869c52e12fce4590c523"
}
}
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:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 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
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "019119a10d54454c87160a4ef37ee2d4",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00: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": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "94fe0f8da6ae4848a61651a731437bdf",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"planID": "UA-P-2027-01-01-000001-a",
"items": [
{
"id": "72406d30465d4a66b6c2867545edd942",
"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": "a24fc4de512141d294ae3ccab128061d",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-01T00:00:00+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"owner": "broker",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"datePublished": "2027-01-01T00:00:00+02:00",
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
}
}
We see the added properties 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:
GET /api/2.5/plans HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
}
],
"next_page": {
"offset": "1798754400.0.1.8d94e47845ce869c52e12fce4590c523",
"path": "/api/2.5/plans?offset=1798754400.0.1.8d94e47845ce869c52e12fce4590c523",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/plans?offset=1798754400.0.1.8d94e47845ce869c52e12fce4590c523"
}
}
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
POST /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b/tenders HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"endDate": "2027-02-01T00:00:00+02:00"
},
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"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",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"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": "2027-01-21T00:00:00+02:00",
"endDate": "2027-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"unit": {
"code": "KGM",
"name": "кілограм"
},
"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": "упаковка"
},
"quantity": 1,
"deliveryDate": {
"startDate": "2027-01-21T00:00:00+02:00",
"endDate": "2027-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
}
}
],
"milestones": [
{
"id": "cccccccccccccccccccccccccccccccc",
"title": "signingTheContract",
"type": "delivery",
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 1,
"code": "standard",
"percentage": 100
},
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 2,
"percentage": 45.55
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 3,
"percentage": 54.45
}
],
"mainProcurementCategory": "services"
}
}
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:
POST /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b/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",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"deliveryDate": {
"endDate": "2027-01-16T00: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": "2027-01-17T00: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": "2027-01-18T00: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": "2027-01-08T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2027-01-15T00:00:00+02:00"
},
"procurementMethodType": "belowThreshold",
"milestones": [
{
"id": "cccccccccccccccccccccccccccccccc",
"title": "signingTheContract",
"type": "delivery",
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 1,
"code": "standard",
"percentage": 100
},
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 2,
"percentage": 45.55
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 3,
"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,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
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 and project to plan:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"budget": {
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2027-01-01T00:00:00",
"endDate": "2027-12-31T00:00:00"
},
"breakdown": [
{
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "019119a10d54454c87160a4ef37ee2d4",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "989fcc4b6dba414fba7da15425c1626c",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"planID": "UA-P-2027-01-01-000001-a",
"items": [
{
"id": "72406d30465d4a66b6c2867545edd942",
"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": "a24fc4de512141d294ae3ccab128061d",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-01T00:00:00+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"owner": "broker",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"datePublished": "2027-01-01T00:00:00+02:00",
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
}
}
A successful example looks like this:
POST /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b/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",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"deliveryDate": {
"endDate": "2027-01-16T00: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": "2027-01-17T00: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": "2027-01-18T00: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": "2027-01-08T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2027-01-15T00:00:00+02:00"
},
"procurementMethodType": "belowThreshold",
"milestones": [
{
"id": "cccccccccccccccccccccccccccccccc",
"title": "signingTheContract",
"type": "delivery",
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 1,
"code": "standard",
"percentage": 100
},
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 2,
"percentage": 45.55
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 3,
"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,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e7db462b6c17406f8ddda353f082a92a
{
"data": {
"mainProcurementCategory": "goods",
"title": "Насіння",
"status": "draft",
"milestones": [
{
"id": "cccccccccccccccccccccccccccccccc",
"title": "signingTheContract",
"type": "delivery",
"code": "standard",
"percentage": 100.0,
"duration": {
"days": 2,
"type": "calendar"
},
"sequenceNumber": 1
},
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 2
},
{
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 3
}
],
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": false
},
"tenderPeriod": {
"startDate": "2027-01-08T00:00:00+02:00",
"endDate": "2027-01-15T00:00:00+02:00"
},
"procurementMethodType": "belowThreshold",
"enquiryPeriod": {
"endDate": "2027-01-08T00:00:00+02:00",
"startDate": "2027-01-01T00:00:00+02:00",
"clarificationsUntil": "2027-01-09T00:00:00+02:00"
},
"items": [
{
"id": "48fdbd1264b1494db6cd237763da8a83",
"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": "2027-01-16T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "85eeb9b42c034ef69e31c8c40e20d0e3",
"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": "2027-01-17T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "7973d2a79bbe4e8d91a09fbb4415a0a3",
"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": "2027-01-18T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"tenderID": "UA-2027-01-01-000001-a",
"owner": "broker",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"date": "2027-01-01T00:00:00+02:00",
"contractChangeRationaleTypes": {
"durationExtension": {
"description_en": "Extension of the period of the procurement contract duration and the term of obligations fulfilment regarding the transfer of goods, implementation of works and provision of services in case of documented objective circumstances that led to such extension, including circumstances of force majeure, delays in funding of procuring entitys expenditures, provided that such changes will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 4, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Продовження строку дії договору про закупівлю та строку виконання зобов’язань щодо передачі товару, виконання робіт, надання послуг у разі виникнення документально підтверджених об’єктивних обставин, що спричинили таке продовження, у тому числі обставин непереборної сили, затримки фінансування витрат замовника, за умови що такі зміни не призведуть до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 4 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"fiscalYearExtension": {
"description_en": "Еffect of the procurement contract may be extended for a period sufficient for conduction of the procurement procedure/simplified procurement at the beginning of the next year in volume that does not exceed 20% of the sum specified in the initial procurement contract concluded in the previous year, if expenditures for achieving this goal are approved in the prescribed manner",
"title_en": "Part 6 of Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Дія договору про закупівлю може бути продовжена на строк, достатній для проведення процедури закупівлі/спрощеної закупівлі на початку наступного року в обсязі, що не перевищує 20 відсотків суми, визначеної в початковому договорі про закупівлю, укладеному в попередньому році, якщо видатки на досягнення цієї цілі затверджено в установленому порядку",
"title_uk": "Частина 6 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceClarification": {
"description_en": "Drawing up a contract price, specified in accordance with the approved project documentation for the purchase contract, specified in paragraph three of part one of this article",
"title_en": "Clause 2, Part 7, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Складання договірної ціни, уточненої відповідно до затвердженої проектної документації до договору про закупівлю, зазначеного в абзаці третьому частини першої цієї статті",
"title_uk": "Пункт 2 частини 7 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"itemPriceVariation": {
"description_en": "An increase in the price per unit of goods by up to 10 percent in proportion to the increase in the market price of such goods in the event of fluctuations in the market price of such goods, provided that such a change does not lead to an increase in the amount specified in the procurement contract; - no more than once every 90 days from the date of signing the procurement contract/making changes to such a contract regarding an increase in the price per unit of goods. The restriction on the timing of changes in the price per unit of goods does not apply in cases of changes in the terms of the contract for the procurement of gasoline and diesel fuel, natural gas, and electricity",
"title_en": "Clause 2, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Збільшення ціни за одиницю товару до 10 відсотків пропорційно збільшенню ціни такого товару на ринку у разі коливання ціни такого товару на ринку за умови, що така зміна не призведе до збільшення суми, визначеної в договорі про закупівлю, - не частіше ніж один раз на 90 днів з моменту підписання договору про закупівлю/внесення змін до такого договору щодо збільшення ціни за одиницю товару. Обмеження щодо строків зміни ціни за одиницю товару не застосовується у випадках зміни умов договору про закупівлю бензину та дизельного пального, природного газу та електричної енергії",
"title_uk": "Пункт 2 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"priceReduction": {
"description_en": "Аpproval of price changes in the procurement contract in the direction of reduction (without changing the quantity (volume) and quality of goods, works and services), including in case of fluctuations in the price of goods on the market",
"title_en": "Clause 5, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Погодження зміни ціни в договорі про закупівлю в бік зменшення (без зміни кількості (обсягу) та якості товарів, робіт і послуг), у тому числі у разі коливання ціни товару на ринку",
"title_uk": "Пункт 5 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"qualityImprovement": {
"description_en": "Іmprovement of the item's quality, provided that such improvement will not increase the sum of money specified in the procurement contract",
"title_en": "Clause 3, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Покращення якості предмета закупівлі, за умови що таке покращення не призведе до збільшення суми, визначеної в договорі про закупівлю",
"title_uk": "Пункт 3 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"taxRate": {
"description_en": "Changes in the price in the purchase contract due to changes in tax and duty rates and/or changes in the conditions for granting tax benefits - in proportion to the change in such rates and/or tax benefits",
"title_en": "Clause 6, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни ціни в договорі про закупівлю у зв’язку зі зміною ставок податків і зборів та/або зміною умов щодо надання пільг з оподаткування - пропорційно до зміни таких ставок та/або пільг з оподаткування",
"title_uk": "Пункт 6 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"thirdParty": {
"description_en": "Changes in the consumer price index established in accordance with the legislation by state statistics bodies, changes in foreign currency exchange rates, changes in stock market quotes or Platts, ARGUS indicators of regulated prices (tariffs) and standards applied in the procurement contract, if the procurement contract establishes the procedure for changing the price",
"title_en": "Clause 7, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зміни встановленого згідно із законодавством органами державної статистики індексу споживчих цін, зміни курсу іноземної валюти, зміни біржових котирувань або показників Platts, ARGUS регульованих цін (тарифів) і нормативів, що застосовуються в договорі про закупівлю, у разі встановлення в договорі про закупівлю порядку зміни ціни",
"title_uk": "Пункт 7 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
},
"volumeCuts": {
"description_en": "Reduction of the procurement's volume, particularly taking into account the actual expenditures of the procuring entity",
"title_en": "Clause 1, Part 5, Article 41 of the Law of Ukraine dated 25.12.2015 No. 922-VIII \"On Public Procurement\"",
"description_uk": "Зменшення обсягів закупівлі, зокрема з урахуванням фактичного обсягу видатків замовника",
"title_uk": "Пункт 1 частини 5 статті 41 Закону України від 25.12.2015 № 922-VIII \"Про публічні закупівлі\""
}
},
"auctionPeriod": {
"shouldStartAfter": "2027-01-15T00:00:00+02:00",
"startDate": "2027-01-15T13:09:55.701000+02:00"
},
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "e7db462b6c17406f8ddda353f082a92a",
"plans": [
{
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false,
"hasMultiSourcing": false
},
"access": {
"token": "098d33295ed448cfa248af0641ed8ec8",
"transfer": "90260c36ef2349518f963a4ca6d1053b"
}
}
Let’s check that the plan status was switched to complete:
GET /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "complete",
"procuringEntity": {
"id": "019119a10d54454c87160a4ef37ee2d4",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "79900bc220ad42e0b5aed4a95015c1ff",
"title": "local",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
},
"address": {
"countryName": "Україна",
"addressDetails": [
{
"id": "UA01020030010043419",
"description": "Ароматне",
"scheme": "КАТОТТГ"
}
]
},
"classification": {
"id": "2170",
"description": "Будівництво закладів охорони здоров’я",
"scheme": "ТПКВКМБ"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"planID": "UA-P-2027-01-01-000001-a",
"items": [
{
"id": "72406d30465d4a66b6c2867545edd942",
"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": "a24fc4de512141d294ae3ccab128061d",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-01T00:00:00+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"owner": "broker",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"datePublished": "2027-01-01T00:00:00+02:00",
"tender_id": "e7db462b6c17406f8ddda353f082a92a",
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
}
}
After tender was created from plan it’s no longer allowed to change plan:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 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": "ДУС"
}
}
}
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:
PATCH /api/2.5/plans/90872dc91a6c457283f521fec87b3db9?acc_token=6f445f8ad768485ebab228d82950e7ba HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "complete"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "complete",
"procuringEntity": {
"id": "a8b8bd20df3a4cb598969a36a60db786",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00: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": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "fa5831916eb64278b2734b7d4c675139",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"planID": "UA-P-2027-01-02-000001-a",
"items": [
{
"id": "56e237f9525141a388ba6b0a4114d1b0",
"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": "2027-01-16T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "90ba552424664ae28f33dccf362598df",
"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": "2027-01-17T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "fecee7d47f6e44ab9c066f2c691cfe80",
"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": "2027-01-18T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "c7187aff04e346a39fce47d6e791912b",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-02T01:00:33+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"owner": "broker",
"dateCreated": "2027-01-02T01:00:33+02:00",
"dateModified": "2027-01-02T01:00:33+02:00",
"datePublished": "2027-01-02T01:00:33+02:00",
"id": "90872dc91a6c457283f521fec87b3db9"
}
}
This only works if procurementMethodType is one of the following:
belowThreshold
reportingempty string
Plan cancellation
A plan can be cancelled using PlanCancellation:
PATCH /api/2.5/plans/6701056dc6fd4e12a83fcb4a6b9e8c02?acc_token=d995817ea96d4dd897846ab1f81b9eb8 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"
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "2072317ee04141ae81b6cc9e6cebd71c",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00: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": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "bc4eb9875ee341f6b2c5f7a09b93b988",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"planID": "UA-P-2027-01-02-000002-a",
"items": [
{
"id": "bbc03c520ecb49f08ebd90262484d8c8",
"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": "2027-01-16T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "f4e03ef0e02f447fa3be363d660c54b1",
"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": "2027-01-17T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "5cde49e88fd447059a4fa7da01ca73c2",
"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": "2027-01-18T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "0f691a1d70e7424e805daab926fc39a5",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"cancellation": {
"reason": "Підстава для скасування",
"reason_en": "Reason of the cancellation",
"status": "pending",
"id": "59e7751a919c456987d2531195cad02e",
"date": "2027-01-02T01:00:33+02:00"
},
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-02T01:00:33+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"owner": "broker",
"dateCreated": "2027-01-02T01:00:33+02:00",
"dateModified": "2027-01-02T01:00:33+02:00",
"datePublished": "2027-01-02T01:00:33+02:00",
"id": "6701056dc6fd4e12a83fcb4a6b9e8c02"
}
}
Making the cancellation object active cancels the plan:
PATCH /api/2.5/plans/6701056dc6fd4e12a83fcb4a6b9e8c02?acc_token=d995817ea96d4dd897846ab1f81b9eb8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"cancellation": {
"reason": "Підстава для скасування",
"status": "active"
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "cancelled",
"procuringEntity": {
"id": "2072317ee04141ae81b6cc9e6cebd71c",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00: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": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "bc4eb9875ee341f6b2c5f7a09b93b988",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"planID": "UA-P-2027-01-02-000002-a",
"items": [
{
"id": "bbc03c520ecb49f08ebd90262484d8c8",
"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": "2027-01-16T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "f4e03ef0e02f447fa3be363d660c54b1",
"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": "2027-01-17T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "5cde49e88fd447059a4fa7da01ca73c2",
"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": "2027-01-18T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "0f691a1d70e7424e805daab926fc39a5",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"cancellation": {
"reason": "Підстава для скасування",
"status": "active",
"id": "69f03e5b5e7c4b919bd13bbc0a68558e",
"date": "2027-01-02T01:00:33+02:00"
},
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-02T01:00:33+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"owner": "broker",
"dateCreated": "2027-01-02T01:00:33+02:00",
"dateModified": "2027-01-02T01:00:33+02:00",
"datePublished": "2027-01-02T01:00:33+02:00",
"id": "6701056dc6fd4e12a83fcb4a6b9e8c02"
}
}
Plan rationale update
The rationale field can be updated at any plan status:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": {
"description": "Змістовне пояснення необхідності закупівлі"
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "complete",
"procuringEntity": {
"id": "019119a10d54454c87160a4ef37ee2d4",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "79900bc220ad42e0b5aed4a95015c1ff",
"title": "local",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
},
"address": {
"countryName": "Україна",
"addressDetails": [
{
"id": "UA01020030010043419",
"description": "Ароматне",
"scheme": "КАТОТТГ"
}
]
},
"classification": {
"id": "2170",
"description": "Будівництво закладів охорони здоров’я",
"scheme": "ТПКВКМБ"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"tender_id": "e7db462b6c17406f8ddda353f082a92a",
"planID": "UA-P-2027-01-01-000001-a",
"items": [
{
"id": "72406d30465d4a66b6c2867545edd942",
"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": "a24fc4de512141d294ae3ccab128061d",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"rationale": {
"description": "Змістовне пояснення необхідності закупівлі",
"date": "2027-01-02T01:00:33+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"owner": "broker",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-02T01:00:33+02:00",
"datePublished": "2027-01-01T00:00:00+02:00",
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
}
}
Plan fields history
There is an endpoint that can show changes history of the certain fields.
At the moment only rationale is supported:
GET /api/2.5/history/plans/cccb8928810c4bda97b1eabb9c4c4f9b?opt_fields=rationale HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"changes": [
{
"date": "2027-01-01T00:00:00+02:00",
"data": {
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-01T00:00:00+02:00"
}
}
},
{
"date": "2027-01-02T01:00:33+02:00",
"data": {
"rationale": {
"description": "Змістовне пояснення необхідності закупівлі",
"date": "2027-01-02T01:00:33+02:00"
}
}
}
]
}
}
Plan of Ukraine
If the source of financing is indicated, the Customer may indicate the item of the Plan of Ukraine in budget.project.
If item is from dictionary plan_of_ukraine than there are additional validations for name and name_en fields:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"budget": {
"project": {
"id": "532ba4bc-e1a7-4334-8d8e-59646d5dcee6",
"name": "Project name"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2027-01-01T00:00:00",
"endDate": "2027-12-31T00:00:00"
},
"breakdown": [
{
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
}
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "budget",
"description": {
"project": {
"name": [
"Value should be from plan_of_ukraine dictionary for 532ba4bc-e1a7-4334-8d8e-59646d5dcee6"
],
"name_en": [
"Value should be from plan_of_ukraine dictionary for 532ba4bc-e1a7-4334-8d8e-59646d5dcee6"
]
}
}
}
]
}
Successful adding project from plan of Ukraine:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"budget": {
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2027-01-01T00:00:00",
"endDate": "2027-12-31T00:00:00"
},
"breakdown": [
{
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "019119a10d54454c87160a4ef37ee2d4",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "989fcc4b6dba414fba7da15425c1626c",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"planID": "UA-P-2027-01-01-000001-a",
"items": [
{
"id": "72406d30465d4a66b6c2867545edd942",
"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": "a24fc4de512141d294ae3ccab128061d",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-01T00:00:00+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"owner": "broker",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"datePublished": "2027-01-01T00:00:00+02:00",
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
}
}
Ukraine facility
For state, local and crimea budgets, the Customer should indicate the code of Ukraine facility’s classifiers in budget.breakdown.classification and budget.breakdown.address.addressDetails.
For state budgets KPK dictionaries are used. They are divided by year, e.g. KPK-2025.
For local and crimea budgets KATOTTG and TPKVKMB dictionaries are used.
There are additional validations for these kinds of budget’s breakdown:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"budget": {
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2027-01-01T00:00:00",
"endDate": "2027-12-31T00:00:00"
},
"breakdown": [
{
"title": "state",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
}
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "budget.breakdown.classification",
"description": "КПК is required for state budget."
}
]
}
Successful adding classification for state budget breakdown:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"budget": {
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2027-01-01T00:00:00",
"endDate": "2027-12-31T00:00:00"
},
"breakdown": [
{
"title": "state",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
},
"classification": {
"scheme": "КПК-2023",
"id": "3505000",
"description": "Державна аудиторська служба України"
}
}
]
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "019119a10d54454c87160a4ef37ee2d4",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "cf2e3878c224439b82bbc00457b30822",
"title": "state",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
},
"classification": {
"id": "3505000",
"description": "Державна аудиторська служба України",
"scheme": "КПК-2023"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"planID": "UA-P-2027-01-01-000001-a",
"items": [
{
"id": "72406d30465d4a66b6c2867545edd942",
"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": "a24fc4de512141d294ae3ccab128061d",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-01T00:00:00+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"owner": "broker",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"datePublished": "2027-01-01T00:00:00+02:00",
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
}
}
Let’s look what we have for local budget breakdown:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"budget": {
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2027-01-01T00:00:00",
"endDate": "2027-12-31T00:00:00"
},
"breakdown": [
{
"title": "local",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
}
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "budget.breakdown.classification",
"description": "ТПКВКМБ is required for local budget."
}
]
}
Let’s add classification for local budget breakdown and see what happened:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"budget": {
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2027-01-01T00:00:00",
"endDate": "2027-12-31T00:00:00"
},
"breakdown": [
{
"title": "local",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
},
"classification": {
"scheme": "ТПКВКМБ",
"id": "2170",
"description": "Будівництво закладів охорони здоров’я"
}
}
]
}
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "budget.breakdown.address",
"description": "Address is required for local budget."
}
]
}
Let’s add address, KATOTTG is required for local budget:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"budget": {
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2027-01-01T00:00:00",
"endDate": "2027-12-31T00:00:00"
},
"breakdown": [
{
"title": "local",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
},
"classification": {
"scheme": "ТПКВКМБ",
"id": "2170",
"description": "Будівництво закладів охорони здоров’я"
},
"address": {
"countryName": "Україна"
}
}
]
}
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "budget.breakdown.address.addressDetails",
"description": "КАТОТТГ is required for local budget."
}
]
}
Successful adding classification and address for local budget breakdown:
PATCH /api/2.5/plans/cccb8928810c4bda97b1eabb9c4c4f9b?acc_token=80859e574f134c2293a68741f9752cb3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"budget": {
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2027-01-01T00:00:00",
"endDate": "2027-12-31T00:00:00"
},
"breakdown": [
{
"title": "local",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
},
"classification": {
"scheme": "ТПКВКМБ",
"id": "2170",
"description": "Будівництво закладів охорони здоров’я"
},
"address": {
"countryName": "Україна",
"addressDetails": [
{
"scheme": "КАТОТТГ",
"id": "UA01020030010043419",
"description": "Ароматне"
}
]
}
}
]
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "019119a10d54454c87160a4ef37ee2d4",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2027-01-08T00:00:00+02:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "95f87658-ffa5-472e-89ee-6e9417aa8cbd",
"name": "1.1. Набрання чинності законодавчими змінами щодо реформи оплати праці в державній службі",
"name_en": "1.1. Entry into force of the legislative changes to the civil service remuneration reform"
},
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "79900bc220ad42e0b5aed4a95015c1ff",
"title": "local",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
},
"address": {
"countryName": "Україна",
"addressDetails": [
{
"id": "UA01020030010043419",
"description": "Ароматне",
"scheme": "КАТОТТГ"
}
]
},
"classification": {
"id": "2170",
"description": "Будівництво закладів охорони здоров’я",
"scheme": "ТПКВКМБ"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "2000",
"description": "Поточні видатки"
}
],
"planID": "UA-P-2027-01-01-000001-a",
"items": [
{
"id": "72406d30465d4a66b6c2867545edd942",
"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": "a24fc4de512141d294ae3ccab128061d",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2027-01-01T00:00:00+02:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"owner": "broker",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"datePublished": "2027-01-01T00:00:00+02:00",
"id": "cccb8928810c4bda97b1eabb9c4c4f9b"
}
}