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-Length: 4361
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-01-08T00:00:00+02:00"
}
},
"items": [
{
"deliveryDate": {
"endDate": "2023-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": "2023-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": "2023-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": "1",
"description": "-"
}
],
"procuringEntity": {
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"name": "ДУС",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general"
},
"buyers": [
{
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"name": "ДУС",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general"
}
],
"budget": {
"project": {
"name": "proj_name",
"id": "123"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2023-01-01T00:00:00",
"endDate": "2023-12-31T00:00:00"
}
},
"status": "draft"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/249bf7a3e1ce48c9bba765eed435b2b4
{
"data": {
"procuringEntity": {
"id": "1bd99b9c2bb84667a1e0ea59f1d06569",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-01-01-000001",
"items": [
{
"id": "55aa3eaa98104cae9ddf1f95dc81ff13",
"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-01-16T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "33585a8f9b424821a368c3c610eea7be",
"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-01-17T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "78de1ef6ea9f4eee8dd2501db2c92ea4",
"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-01-18T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "7bce9e1719ed48cc97494f9c9370229e",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"status": "draft",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"datePublished": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"id": "249bf7a3e1ce48c9bba765eed435b2b4"
},
"access": {
"token": "ef8e82ab09a448dfab7d3d4766ac13d2",
"transfer": "6fc31b0b960b427fa037f07f9c96be44"
}
}
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/249bf7a3e1ce48c9bba765eed435b2b4?acc_token=ef8e82ab09a448dfab7d3d4766ac13d2 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "scheduled"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"procuringEntity": {
"id": "1bd99b9c2bb84667a1e0ea59f1d06569",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-01-01-000001",
"items": [
{
"id": "55aa3eaa98104cae9ddf1f95dc81ff13",
"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-01-16T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "33585a8f9b424821a368c3c610eea7be",
"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-01-17T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "78de1ef6ea9f4eee8dd2501db2c92ea4",
"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-01-18T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "7bce9e1719ed48cc97494f9c9370229e",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"status": "scheduled",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"datePublished": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"id": "249bf7a3e1ce48c9bba765eed435b2b4"
}
}
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": "2023-01-01T00:00:00+02:00",
"id": "249bf7a3e1ce48c9bba765eed435b2b4"
}
],
"next_page": {
"offset": 1672524000.0,
"path": "/api/2.5/plans?offset=1672524000.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/plans?offset=1672524000.0"
}
}
We do see the internal id of a plan (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/plans/) and its dateModified datestamp.
Modifying plan¶
Let’s update plan by supplementing it with all other essential properties:
PATCH /api/2.5/plans/249bf7a3e1ce48c9bba765eed435b2b4?acc_token=ef8e82ab09a448dfab7d3d4766ac13d2 HTTP/1.0
Authorization: Bearer broker
Content-Length: 652
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": {
"procuringEntity": {
"id": "1bd99b9c2bb84667a1e0ea59f1d06569",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-01-01-000001",
"items": [
{
"id": "55aa3eaa98104cae9ddf1f95dc81ff13",
"classification": {
"description": "Vegetable seeds",
"scheme": "ДК021",
"id": "03111700-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.13.6",
"description": "Насіння овочевих культур"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 5000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2016-06-01T23:06:30.023018+03:00"
},
"description": "Насіння овочевих культур"
}
],
"buyers": [
{
"id": "7bce9e1719ed48cc97494f9c9370229e",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"status": "scheduled",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"datePublished": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"id": "249bf7a3e1ce48c9bba765eed435b2b4"
}
}
We see the added properies have merged with existing plan data. Additionally, the dateModified property was updated to reflect the last modification datestamp.
Checking the listing again reflects the new modification date:
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": "2023-01-01T00:00:00+02:00",
"id": "249bf7a3e1ce48c9bba765eed435b2b4"
}
],
"next_page": {
"offset": 1672524000.0,
"path": "/api/2.5/plans?offset=1672524000.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/plans?offset=1672524000.0"
}
}
Tender creation from a procurement plan¶
A tender can be created from your procurement plan. This tender will be linked with the plan using tender’s plans and plan’s tender_id fields.
Note
There are validation rules that are supposed to decline the chance of making a mistake
POST /api/2.5/plans/249bf7a3e1ce48c9bba765eed435b2b4/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 4325
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"endDate": "2023-02-01T00:00:00+02:00"
},
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"minimalStep": {
"currency": "UAH",
"amount": 5
},
"procurementMethodType": "aboveThresholdEU",
"value": {
"currency": "UAH",
"amount": 500
},
"procuringEntity": {
"kind": "general",
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21027",
"region": "Вінницька область",
"streetAddress": "вул. Стахурського. 22"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"name_en": "Kutsa Svitlana V.",
"telephone": "+380432465302",
"availableLanguage": "uk",
"url": "http://sch10.edu.vn.ua/"
},
"identifier": {
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
"scheme": "UA-EDR"
},
"name": "ЗОСШ #10 м.Вінниці",
"name_en": "School #10 of Vinnytsia"
},
"items": [
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"description_en": "Services in school canteens",
"classification": {
"scheme": "ДК021",
"id": "37810000-9",
"description": "Test"
},
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00: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-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
],
"mainProcurementCategory": "services"
}
}
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 (
336
is exception)
Plan should contain budget breakdown, otherwise it will be an error during tender creation:
POST /api/2.5/plans/249bf7a3e1ce48c9bba765eed435b2b4/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 4367
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Насіння",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"value": {
"amount": 500,
"currency": "UAH"
},
"minimalStep": {
"amount": 15,
"currency": "UAH"
},
"items": [
{
"deliveryDate": {
"endDate": "2023-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": "2023-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": "2023-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": "2023-01-08T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-01-15T00:00:00+02:00"
},
"procurementMethodType": "belowThreshold",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
],
"status": "draft"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "budget.breakdown",
"description": "Plan should contain budget breakdown"
}
]
}
Let’s add budget breakdown to plan:
PATCH /api/2.5/plans/249bf7a3e1ce48c9bba765eed435b2b4?acc_token=ef8e82ab09a448dfab7d3d4766ac13d2 HTTP/1.0
Authorization: Bearer broker
Content-Length: 150
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"budget": {
"breakdown": [
{
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"procuringEntity": {
"id": "1bd99b9c2bb84667a1e0ea59f1d06569",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "73e21bf40ee949c08d404f9470a5649a",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-01-01-000001",
"items": [
{
"id": "55aa3eaa98104cae9ddf1f95dc81ff13",
"classification": {
"description": "Vegetable seeds",
"scheme": "ДК021",
"id": "03111700-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.13.6",
"description": "Насіння овочевих культур"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 5000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2016-06-01T23:06:30.023018+03:00"
},
"description": "Насіння овочевих культур"
}
],
"buyers": [
{
"id": "7bce9e1719ed48cc97494f9c9370229e",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"status": "scheduled",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"datePublished": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"id": "249bf7a3e1ce48c9bba765eed435b2b4"
}
}
A successful example looks like this:
POST /api/2.5/plans/249bf7a3e1ce48c9bba765eed435b2b4/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 4367
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Насіння",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"value": {
"amount": 500,
"currency": "UAH"
},
"minimalStep": {
"amount": 15,
"currency": "UAH"
},
"items": [
{
"deliveryDate": {
"endDate": "2023-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": "2023-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": "2023-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": "2023-01-08T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-01-15T00:00:00+02:00"
},
"procurementMethodType": "belowThreshold",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
],
"status": "draft"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/faedbc9487564abc8ac82e0fe70308c3
{
"data": {
"mainProcurementCategory": "goods",
"title": "Насіння",
"status": "draft",
"procurementMethod": "open",
"awardCriteria": "lowestCost",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-01-08T00:00:00+02:00",
"endDate": "2023-01-15T00:00:00+02:00"
},
"items": [
{
"id": "891cd1d74642419faf18d4a8d2ddd740",
"description": "Насіння гірчиці",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"deliveryDate": {
"endDate": "2023-01-16T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "1d5b24218fc14889b0a544f23b62bcc4",
"description": "Насіння соняшнику",
"classification": {
"description": "Sunflower seeds",
"scheme": "ДК021",
"id": "03111300-5"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 2000.0,
"deliveryDate": {
"endDate": "2023-01-17T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "14bb3d84d5d84c9a9832d2060a1e5385",
"description": "Насіння бавовнику",
"classification": {
"description": "Cotton seeds",
"scheme": "ДК021",
"id": "03111400-6"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 3000.0,
"deliveryDate": {
"endDate": "2023-01-18T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "0860c4482846468591e388f90fbdbb52",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procurementMethodType": "belowThreshold",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"kind": "general"
},
"enquiryPeriod": {
"endDate": "2023-01-08T00:00:00+02:00",
"startDate": "2023-01-01T00:00:00+02:00",
"clarificationsUntil": "2023-01-09T00:00:00+02:00"
},
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"submissionMethod": "electronicAuction",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"id": "faedbc9487564abc8ac82e0fe70308c3",
"plans": [
{
"id": "249bf7a3e1ce48c9bba765eed435b2b4"
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
},
"access": {
"token": "a3c708e117344873a6a706a046836900",
"transfer": "e432e425d06a4ddc9aedd46d175737e3"
}
}
Let’s check that the plan status was switched to complete:
GET /api/2.5/plans/249bf7a3e1ce48c9bba765eed435b2b4 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"procuringEntity": {
"id": "1bd99b9c2bb84667a1e0ea59f1d06569",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "73e21bf40ee949c08d404f9470a5649a",
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500.0,
"currency": "UAH"
}
}
]
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"tender_id": "faedbc9487564abc8ac82e0fe70308c3",
"planID": "UA-P-2023-01-01-000001",
"items": [
{
"id": "55aa3eaa98104cae9ddf1f95dc81ff13",
"classification": {
"description": "Vegetable seeds",
"scheme": "ДК021",
"id": "03111700-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.13.6",
"description": "Насіння овочевих культур"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 5000.0,
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"endDate": "2016-06-01T23:06:30.023018+03:00"
},
"description": "Насіння овочевих культур"
}
],
"buyers": [
{
"id": "7bce9e1719ed48cc97494f9c9370229e",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"status": "complete",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"datePublished": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"id": "249bf7a3e1ce48c9bba765eed435b2b4"
}
}
After tender was created from plan it’s no longer allowed to change plan:
PATCH /api/2.5/plans/249bf7a3e1ce48c9bba765eed435b2b4?acc_token=ef8e82ab09a448dfab7d3d4766ac13d2 HTTP/1.0
Authorization: Bearer broker
Content-Length: 301
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": "status",
"description": "Can't update plan in 'complete' status"
}
]
}
Plan completing without tendering¶
There is a way to complete a plan without tender creation:
PATCH /api/2.5/plans/4a8a8a82f7d645289bfd5c1e0ebd4130?acc_token=cfdf866a8ebc4bcfa89f1564dfb0c807 HTTP/1.0
Authorization: Bearer broker
Content-Length: 32
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "complete"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"procuringEntity": {
"id": "4d2d626626ca4d51ad33d67eeed8897d",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-01-01-000002",
"items": [
{
"id": "9ce130486124412f8989953b92dfca88",
"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-01-16T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "031c8f31728947d3b94281bc3e852877",
"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-01-17T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "ab9d59e713bb452e907349ec5e8282f7",
"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-01-18T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "0d9f9d9f96b7483ead8899aa09566a02",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"status": "complete",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"datePublished": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"id": "4a8a8a82f7d645289bfd5c1e0ebd4130"
}
}
This only works if procurementMethodType is one of the following:
belowThreshold
reporting
- empty string
Plan cancellation¶
A plan can be cancelled using PlanCancellation:
PATCH /api/2.5/plans/a93d5d3f8c974702bdcd612e0e78486f?acc_token=bd67bd6df39e4e8fb05655b8db9b4ec0 HTTP/1.0
Authorization: Bearer broker
Content-Length: 213
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": {
"procuringEntity": {
"id": "7e7afa9f45854968b06a08b254af126c",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-01-01-000003",
"items": [
{
"id": "49ffdd118a4245af931b03a25cca7c9b",
"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-01-16T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "4e590821a04243e0b708c1385020b3a6",
"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-01-17T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "95f19ca51ff64639b5fec183db697afc",
"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-01-18T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "9332000f44cd45fbaef683b074ff6666",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"status": "scheduled",
"cancellation": {
"id": "b7e9d6ca56c943a0b5d32f9db0653ce7",
"date": "2023-01-01T00:00:00+02:00",
"reason": "Підстава для скасування",
"reason_en": "Reason of the cancellation",
"status": "pending"
},
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"datePublished": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"id": "a93d5d3f8c974702bdcd612e0e78486f"
}
}
Making the cancellation object active
cancels the plan:
PATCH /api/2.5/plans/a93d5d3f8c974702bdcd612e0e78486f?acc_token=bd67bd6df39e4e8fb05655b8db9b4ec0 HTTP/1.0
Authorization: Bearer broker
Content-Length: 48
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"cancellation": {
"status": "active"
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"procuringEntity": {
"id": "7e7afa9f45854968b06a08b254af126c",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2023-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": "2023-01-01T00:00:00+02:00",
"endDate": "2023-12-31T00:00:00+02:00"
}
},
"classification": {
"description": "Seeds",
"scheme": "ДК021",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"planID": "UA-P-2023-01-01-000003",
"items": [
{
"id": "49ffdd118a4245af931b03a25cca7c9b",
"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-01-16T00:00:00+02:00"
},
"description": "Насіння гірчиці"
},
{
"id": "4e590821a04243e0b708c1385020b3a6",
"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-01-17T00:00:00+02:00"
},
"description": "Насіння соняшнику"
},
{
"id": "95f19ca51ff64639b5fec183db697afc",
"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-01-18T00:00:00+02:00"
},
"description": "Насіння бавовнику"
}
],
"buyers": [
{
"id": "9332000f44cd45fbaef683b074ff6666",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"status": "cancelled",
"cancellation": {
"id": "b7e9d6ca56c943a0b5d32f9db0653ce7",
"date": "2023-01-01T00:00:00+02:00",
"reason": "Підстава для скасування",
"reason_en": "Reason of the cancellation",
"status": "active"
},
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"datePublished": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"id": "a93d5d3f8c974702bdcd612e0e78486f"
}
}