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": "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": "2023-01-01T00:00:00",
"endDate": "2023-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"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/41dd1a57d4074913838107cf156a4f5f
{
"data": {
"status": "draft",
"procuringEntity": {
"id": "88b1bac11a154af28d39a636d067680a",
"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": "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": "ebd2d1b64342489db061d882f9616ad9",
"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": "998f939b50334b178aa4d6eb8acfa99b",
"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": "4aabbc78fe474fc9ba966250ee3427d7",
"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": "5b3bb3c4047d471791182f9238088b0a",
"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": "983235c9a84e41128bba17109da5e414",
"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": "2023-10-10T01:00:00+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"planID": "UA-P-2023-10-10-000001-a",
"owner": "broker",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "41dd1a57d4074913838107cf156a4f5f"
},
"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:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?acc_token=80859e574f134c2293a68741f9752cb3 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": "88b1bac11a154af28d39a636d067680a",
"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": "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": "ebd2d1b64342489db061d882f9616ad9",
"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-2023-10-10-000001-a",
"items": [
{
"id": "998f939b50334b178aa4d6eb8acfa99b",
"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": "4aabbc78fe474fc9ba966250ee3427d7",
"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": "5b3bb3c4047d471791182f9238088b0a",
"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": "983235c9a84e41128bba17109da5e414",
"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": "2023-10-10T01:00:00+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"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": "41dd1a57d4074913838107cf156a4f5f"
}
}
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": "41dd1a57d4074913838107cf156a4f5f"
}
],
"next_page": {
"offset": "1696888800.0.1.07b006d33176198b9d61df3c1e48ff2a",
"path": "/api/2.5/plans?offset=1696888800.0.1.07b006d33176198b9d61df3c1e48ff2a",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/plans?offset=1696888800.0.1.07b006d33176198b9d61df3c1e48ff2a"
}
}
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/41dd1a57d4074913838107cf156a4f5f?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
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "88b1bac11a154af28d39a636d067680a",
"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": "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": "ebd2d1b64342489db061d882f9616ad9",
"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-2023-10-10-000001-a",
"items": [
{
"id": "6357797639c344369e5948778ade25b6",
"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": "983235c9a84e41128bba17109da5e414",
"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": "2023-10-10T01:00:00+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"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": "41dd1a57d4074913838107cf156a4f5f"
}
}
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:
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": "41dd1a57d4074913838107cf156a4f5f"
}
],
"next_page": {
"offset": "1696888800.0.1.07b006d33176198b9d61df3c1e48ff2a",
"path": "/api/2.5/plans?offset=1696888800.0.1.07b006d33176198b9d61df3c1e48ff2a",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/plans?offset=1696888800.0.1.07b006d33176198b9d61df3c1e48ff2a"
}
}
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/41dd1a57d4074913838107cf156a4f5f/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",
"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": "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": 1,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45
}
],
"mainProcurementCategory": "services",
"contractTemplateName": "00000000.0002.01"
}
}
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/41dd1a57d4074913838107cf156a4f5f/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": "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": 1,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45
}
],
"contractTemplateName": "00000000.0002.01",
"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
}
}
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 and project to plan:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?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": "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": "88b1bac11a154af28d39a636d067680a",
"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": "2023-10-17T00: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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "fe685ef07eb149389d0906122d242d57",
"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-2023-10-10-000001-a",
"items": [
{
"id": "6357797639c344369e5948778ade25b6",
"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": "983235c9a84e41128bba17109da5e414",
"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": "2023-10-10T01:00:00+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"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": "41dd1a57d4074913838107cf156a4f5f"
}
}
A successful example looks like this:
Request
POST /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f/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": "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": 1,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45
}
],
"contractTemplateName": "00000000.0002.01",
"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
}
}
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",
"contractTemplateName": "00000000.0002.01",
"title": "Насіння",
"status": "draft",
"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": true
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "1a5728bad63e42d5be8ecda73bcd0e49",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "belowThreshold",
"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"
},
"items": [
{
"id": "d2723820528f4ebd9bcb7cb9f969288f",
"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": "cfb78304f96f42d497833ea72b8fc083",
"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": "59aa7fc25e404f0fbe65f7a1144c2b94",
"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": "Україна"
}
}
],
"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": "41dd1a57d4074913838107cf156a4f5f"
}
]
},
"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
},
"access": {
"token": "098d33295ed448cfa248af0641ed8ec8",
"transfer": "90260c36ef2349518f963a4ca6d1053b"
}
}
Let’s check that the plan status was switched to complete:
Request
GET /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f 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": "88b1bac11a154af28d39a636d067680a",
"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": "2023-10-17T00: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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "a274bbff989845ab890f65beecb1426d",
"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-2023-10-10-000001-a",
"items": [
{
"id": "6357797639c344369e5948778ade25b6",
"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": "983235c9a84e41128bba17109da5e414",
"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": "2023-10-10T01:00:00+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"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": "41dd1a57d4074913838107cf156a4f5f"
}
}
After tender was created from plan it’s no longer allowed to change plan:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?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": "ДУС"
}
}
}
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/ea8a6cb667df4469af2c5584ab0a020e?acc_token=6f445f8ad768485ebab228d82950e7ba 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": "cd4726e5f1f64a5c9c188ff51c4346fb",
"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": "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": "3b04a4fad68b4d238ff2e8e15f73a185",
"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-2023-10-11-000001-a",
"items": [
{
"id": "e54a3f8417234a50aa3de12940ad3344",
"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": "c5547809efc24afb89cc5b8183041c30",
"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": "5c315bc666db4c8d878eecf2ca040cb2",
"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": "9a5ea501d57a44988afe500963d6267c",
"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": "2023-10-11T02:00:33+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"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": "ea8a6cb667df4469af2c5584ab0a020e"
}
}
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/eb9b974cc4f44c0d934eb6e612d44189?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"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "a21ea4f0a29943f4a053fd526321cd79",
"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": "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": "c27fd7fa12d344ea9abb99664b54c6a7",
"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-2023-10-11-000002-a",
"items": [
{
"id": "037cce6174704094b0715133f5c16b82",
"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": "1933c8dcdc814b45a560e65bdacb1181",
"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": "ca029ee576d04b55b4a9717d3b9eb548",
"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": "a432b342fc0e4d749a9df812b3c5a261",
"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": "965c004e43df477cbbe36c3fe5796010",
"date": "2023-10-11T02:00:33+03:00"
},
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2023-10-11T02:00:33+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"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": "eb9b974cc4f44c0d934eb6e612d44189"
}
}
Making the cancellation object active cancels the plan:
Request
PATCH /api/2.5/plans/eb9b974cc4f44c0d934eb6e612d44189?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"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "cancelled",
"procuringEntity": {
"id": "a21ea4f0a29943f4a053fd526321cd79",
"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": "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": "c27fd7fa12d344ea9abb99664b54c6a7",
"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-2023-10-11-000002-a",
"items": [
{
"id": "037cce6174704094b0715133f5c16b82",
"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": "1933c8dcdc814b45a560e65bdacb1181",
"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": "ca029ee576d04b55b4a9717d3b9eb548",
"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": "a432b342fc0e4d749a9df812b3c5a261",
"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": "eb9f71a61b4044f4984d23be7049df0c",
"date": "2023-10-11T02:00:33+03:00"
},
"rationale": {
"description": "Недостатньо змістовне обгрунтування",
"date": "2023-10-11T02:00:33+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"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": "eb9b974cc4f44c0d934eb6e612d44189"
}
}
Plan rationale update
The rationale field can be updated at any plan status:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?acc_token=80859e574f134c2293a68741f9752cb3 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": "88b1bac11a154af28d39a636d067680a",
"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": "2023-10-17T00: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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "a274bbff989845ab890f65beecb1426d",
"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": "7f5e6c2aa6f54cc3a2f6589002f0d6ce",
"planID": "UA-P-2023-10-10-000001-a",
"items": [
{
"id": "6357797639c344369e5948778ade25b6",
"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": "983235c9a84e41128bba17109da5e414",
"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": "2023-10-11T02:00:33+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"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": "41dd1a57d4074913838107cf156a4f5f"
}
}
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/41dd1a57d4074913838107cf156a4f5f?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"
}
}
}
]
}
}
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:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?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": "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 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:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?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": "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": "88b1bac11a154af28d39a636d067680a",
"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": "2023-10-17T00: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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "fe685ef07eb149389d0906122d242d57",
"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-2023-10-10-000001-a",
"items": [
{
"id": "6357797639c344369e5948778ade25b6",
"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": "983235c9a84e41128bba17109da5e414",
"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": "2023-10-10T01:00:00+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"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": "41dd1a57d4074913838107cf156a4f5f"
}
}
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:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?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": "2023-01-01T00:00:00",
"endDate": "2023-12-31T00:00:00"
},
"breakdown": [
{
"title": "state",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
}
}
}
Response
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:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?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": "2023-01-01T00:00:00",
"endDate": "2023-12-31T00:00:00"
},
"breakdown": [
{
"title": "state",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
},
"classification": {
"scheme": "КПК-2023",
"id": "3505000",
"description": "Державна аудиторська служба України"
}
}
]
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "88b1bac11a154af28d39a636d067680a",
"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": "2023-10-17T00: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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "768cb045096841d293ac1acc53c18fcd",
"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-2023-10-10-000001-a",
"items": [
{
"id": "6357797639c344369e5948778ade25b6",
"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": "983235c9a84e41128bba17109da5e414",
"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": "2023-10-10T01:00:00+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"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": "41dd1a57d4074913838107cf156a4f5f"
}
}
Let’s look what we have for local budget breakdown:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?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": "2023-01-01T00:00:00",
"endDate": "2023-12-31T00:00:00"
},
"breakdown": [
{
"title": "local",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
}
}
}
Response
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:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?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": "2023-01-01T00:00:00",
"endDate": "2023-12-31T00:00:00"
},
"breakdown": [
{
"title": "local",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
},
"classification": {
"scheme": "ТПКВКМБ",
"id": "2170",
"description": "Будівництво закладів охорони здоров’я"
}
}
]
}
}
}
Response
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:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?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": "2023-01-01T00:00:00",
"endDate": "2023-12-31T00:00:00"
},
"breakdown": [
{
"title": "local",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
},
"classification": {
"scheme": "ТПКВКМБ",
"id": "2170",
"description": "Будівництво закладів охорони здоров’я"
},
"address": {
"countryName": "Україна"
}
}
]
}
}
}
Response
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:
Request
PATCH /api/2.5/plans/41dd1a57d4074913838107cf156a4f5f?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": "2023-01-01T00:00:00",
"endDate": "2023-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": "Ароматне"
}
]
}
}
]
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"status": "scheduled",
"procuringEntity": {
"id": "88b1bac11a154af28d39a636d067680a",
"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": "2023-10-17T00: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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "a274bbff989845ab890f65beecb1426d",
"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-2023-10-10-000001-a",
"items": [
{
"id": "6357797639c344369e5948778ade25b6",
"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": "983235c9a84e41128bba17109da5e414",
"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": "2023-10-10T01:00:00+03:00"
},
"project": {
"title": "DREAMs come true",
"uri": "https://dream.gov.ua/ua/project/DREAM-UA-030524-EE48E08C/profile"
},
"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": "41dd1a57d4074913838107cf156a4f5f"
}
}