Centralized procurements¶
Creating plan procurement¶
Buyer creates a plan. He should specify himself in buyers list and point at one of the central procurement organizations in procuringEntity field:
POST /api/2.5/plans?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 2815
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": "Насіння гірчиці"
}
],
"classification": {
"scheme": "ДК021",
"description": "Seeds",
"id": "03111000-2"
},
"additionalClassifications": [
{
"scheme": "КЕКВ",
"id": "1",
"description": "-"
}
],
"procuringEntity": {
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
},
"name": "ЦЗО №1",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 1"
},
"kind": "central"
},
"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"
},
"breakdown": [
{
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
},
"status": "draft"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/2c376a06cbf7476b8c229e6955bd8194
{
"data": {
"procuringEntity": {
"id": "83f062b81bae47f8ab0961261aa07c76",
"name": "ЦЗО №1",
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
},
"address": {
"streetAddress": "вул. Банкова, 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "central"
},
"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": "cfa7241bcbb349619633cf4892ec6f3f",
"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": "e6aa4dfbda3e4a8b95228fcd5778f66c",
"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": "Насіння гірчиці"
}
],
"buyers": [
{
"id": "f2831f8b59a042c8a5873da24a571fce",
"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": "2c376a06cbf7476b8c229e6955bd8194"
},
"access": {
"token": "783d8c5fb59e427982607629477be85b",
"transfer": "d25294b24370433a9b6bd50df2b6766c"
}
}
Creating approve milestone¶
As central procurement organization sees itself as procuringEntity of a plan, it can post milestones to this plan:
POST /api/2.5/plans/2c376a06cbf7476b8c229e6955bd8194/milestones HTTP/1.0 Authorization: Bearer broker Content-Length: 1623 Content-Type: application/json Host: lb-api-sandbox.prozorro.gov.ua { "data": { "title": "Підготовка до проведення процедури", "description": "Узагальнення та аналіз отриманної інформації щодо проведення закупівель товарів, послуг (крім поточного ремонту) в інтересах замовників", "type": "approval", "author": { "identifier": { "scheme": "UA-EDR", "id": "111111", "legalName": "ДП Центральний закупівельний орган №1" }, "name": "ЦЗО №1", "address": { "countryName": "Україна", "postalCode": "01220", "region": "м. Київ", "locality": "м. Київ", "streetAddress": "вул. Банкова, 1" }, "kind": "central" }, "dueDate": "2023-01-01T00:00:04+02:00" } }HTTP/1.0 201 Created Content-Type: application/json Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/2c376a06cbf7476b8c229e6955bd8194/milestones/15a9ab37fec7476aa9ef10890b9b2f4a { "data": { "id": "15a9ab37fec7476aa9ef10890b9b2f4a", "title": "Підготовка до проведення процедури", "description": "Узагальнення та аналіз отриманної інформації щодо проведення закупівель товарів, послуг (крім поточного ремонту) в інтересах замовників", "type": "approval", "dueDate": "2023-01-01T00:00:04+02:00", "status": "scheduled", "author": { "id": "223cf816f2d343d2ba8d7a038fafc659", "name": "ЦЗО №1", "identifier": { "scheme": "UA-EDR", "id": "111111", "legalName": "ДП Центральний закупівельний орган №1" }, "address": { "streetAddress": "вул. Банкова, 1", "locality": "м. Київ", "region": "м. Київ", "postalCode": "01220", "countryName": "Україна" }, "kind": "central" }, "dateModified": "2023-01-01T00:00:03+02:00", "owner": "broker" }, "access": { "token": "e7245cb4e7ef4e5aa4252c7e90f07af2" } }
Only if the access token from the response is provided, the milestone can be changed later:
PATCH /api/2.5/plans/2c376a06cbf7476b8c229e6955bd8194/milestones/15a9ab37fec7476aa9ef10890b9b2f4a?acc_token=e7245cb4e7ef4e5aa4252c7e90f07af2 HTTP/1.0 Authorization: Bearer broker Content-Length: 226 Content-Type: application/json Host: lb-api-sandbox.prozorro.gov.ua { "data": { "status": "met", "description": "Доповнений опис відповіді", "dueDate": "2023-01-01T00:00:07+02:00" } }HTTP/1.0 200 OK Content-Type: application/json { "data": { "id": "15a9ab37fec7476aa9ef10890b9b2f4a", "title": "Підготовка до проведення процедури", "description": "Доповнений опис відповіді", "type": "approval", "dueDate": "2023-01-01T00:00:07+02:00", "status": "met", "author": { "id": "223cf816f2d343d2ba8d7a038fafc659", "name": "ЦЗО №1", "identifier": { "scheme": "UA-EDR", "id": "111111", "legalName": "ДП Центральний закупівельний орган №1" }, "address": { "streetAddress": "вул. Банкова, 1", "locality": "м. Київ", "region": "м. Київ", "postalCode": "01220", "countryName": "Україна" }, "kind": "central" }, "dateModified": "2023-01-01T00:00:06+02:00", "dateMet": "2023-01-01T00:00:06+02:00", "owner": "broker" } }
Note
- The fields you can update depend on current milestone status:
- dueDate can only be updated at scheduled milestone status
- description - either at scheduled or met
Posting documents is also require the milestone access token (as well as changing documents using PATCH/PUT methods):
POST /api/2.5/plans/2c376a06cbf7476b8c229e6955bd8194/milestones/15a9ab37fec7476aa9ef10890b9b2f4a/documents?acc_token=e7245cb4e7ef4e5aa4252c7e90f07af2 HTTP/1.0 Authorization: Bearer broker Content-Length: 318 Content-Type: application/json Host: lb-api-sandbox.prozorro.gov.ua { "data": { "title": "Notice.pdf", "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e02eb47c177f4e078fd10eb781a99616?Signature=psSyxQ3Vn14knOgHhFLe6TVEXj7Yi87lBPBrVkLSxaWa6sEJGmis1n79SzYZFPntiZ21NiGzXWdQPrQkdDEgBw%3D%3D&KeyID=a8968c46", "hash": "md5:00000000000000000000000000000000", "format": "application/pdf" } }HTTP/1.0 201 Created Content-Type: application/json Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/2c376a06cbf7476b8c229e6955bd8194/milestones/15a9ab37fec7476aa9ef10890b9b2f4a/documents/a23d42fa7c964ecba471e1bcb60acc46 { "data": { "id": "a23d42fa7c964ecba471e1bcb60acc46", "hash": "md5:00000000000000000000000000000000", "title": "Notice.pdf", "format": "application/pdf", "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e02eb47c177f4e078fd10eb781a99616?Signature=rN9%2BwQqp%2FjcIsh194eH4myfxHp7SzO3wXo9uAwzsF8ktudixiljJfdi7VP8qVHaRw4IhD6zi%2BmVMWZpLDOO0AA%3D%3D&KeyID=a8968c46", "datePublished": "2023-01-01T00:00:10+02:00", "dateModified": "2023-01-01T00:00:10+02:00" } }
Creating tender¶
The central procurement organization creates an aggregated tender in draft status and specifies all the buyer organizations using buyers list of PlanOrganization:
POST /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 5756
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"endDate": "2023-02-01T00:00:00+02:00"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 5
},
"procurementMethodType": "aboveThresholdUA",
"value": {
"currency": "UAH",
"amount": 500
},
"procuringEntity": {
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
},
"name": "ЦЗО №1",
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21027",
"region": "Вінницька область",
"streetAddress": "вул. Стахурського. 22"
},
"kind": "central",
"contactPoint": {
"name": "Довідкова",
"telephone": "+0440000000"
}
},
"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": "Насіння гірчиці",
"relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86"
},
{
"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": "Насіння соняшнику",
"relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86"
},
{
"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": "Насіння бавовнику",
"relatedBuyer": "88c051728aae432ca2d39a0215d63fcd"
}
],
"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",
"buyers": [
{
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"name": "ДУС",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general",
"id": "3e32f23699ea4ac0b8e105e7babd2c86"
},
{
"identifier": {
"scheme": "UA-EDR",
"id": "222983",
"legalName": "ДП Державне Управління Справами"
},
"name": "ДУС",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general",
"id": "88c051728aae432ca2d39a0215d63fcd"
}
],
"status": "draft"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 2
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/d1b73c4e72e244f1833086204faadff6
{
"data": {
"mainProcurementCategory": "services",
"buyers": [
{
"id": "3e32f23699ea4ac0b8e105e7babd2c86",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
{
"id": "88c051728aae432ca2d39a0215d63fcd",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "222983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"title": "футляри до державних нагород",
"procurementMethod": "open",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "519152a1889240fd9cf9dd576c46265c",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procuringEntity": {
"name": "ЦЗО №1",
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Довідкова"
},
"kind": "central"
},
"status": "draft",
"procurementMethodType": "aboveThresholdUA",
"awardCriteria": "lowestCost",
"tenderPeriod": {
"startDate": "2023-01-01T00:00:15+02:00",
"endDate": "2023-02-01T00:00:00+02:00"
},
"items": [
{
"id": "97735bdc93204bd7a1469064bb3e615b",
"description": "Насіння гірчиці",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86",
"deliveryDate": {
"endDate": "2023-01-16T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "258306a31f6a47758d528d907f4329fe",
"description": "Насіння соняшнику",
"classification": {
"description": "Sunflower seeds",
"scheme": "ДК021",
"id": "03111300-5"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 2000.0,
"relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86",
"deliveryDate": {
"endDate": "2023-01-17T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "650759050f6a43e4aa1ab880fa5f35fb",
"description": "Насіння бавовнику",
"classification": {
"description": "Cotton seeds",
"scheme": "ДК021",
"id": "03111400-6"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 3000.0,
"relatedBuyer": "88c051728aae432ca2d39a0215d63fcd",
"deliveryDate": {
"endDate": "2023-01-18T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"tenderID": "UA-2023-01-01-000001-a",
"complaintPeriod": {
"startDate": "2023-01-01T00:00:15+02:00",
"endDate": "2023-01-28T00:00:00+02:00"
},
"owner": "broker",
"submissionMethod": "electronicAuction",
"date": "2023-01-01T00:00:15+02:00",
"enquiryPeriod": {
"startDate": "2023-01-01T00:00:15+02:00",
"endDate": "2023-01-22T00:00:00+02:00",
"clarificationsUntil": "2023-01-26T00:00:00+02:00"
},
"dateCreated": "2023-01-01T00:00:15+02:00",
"dateModified": "2023-01-01T00:00:15+02:00",
"id": "d1b73c4e72e244f1833086204faadff6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 2
},
"access": {
"token": "fcf76f747843442fafdd24a444a6063e",
"transfer": "5447b2801ac74791aba778560c183b9e"
}
}
Connecting plans to the tender¶
The central procurement organization connects the plan to the tender. If there are many plans, they should be connected one by one.
POST /api/2.5/tenders/d1b73c4e72e244f1833086204faadff6/plans?acc_token=fcf76f747843442fafdd24a444a6063e HTTP/1.0
Authorization: Bearer broker
Content-Length: 52
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"id": "2c376a06cbf7476b8c229e6955bd8194"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "2c376a06cbf7476b8c229e6955bd8194"
}
]
}
As a result the plan is moved to “complete” status
GET /api/2.5/plans/2c376a06cbf7476b8c229e6955bd8194 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": "83f062b81bae47f8ab0961261aa07c76",
"name": "ЦЗО №1",
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
},
"address": {
"streetAddress": "вул. Банкова, 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "central"
},
"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": "cfa7241bcbb349619633cf4892ec6f3f",
"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": "d1b73c4e72e244f1833086204faadff6",
"planID": "UA-P-2023-01-01-000001",
"items": [
{
"id": "e6aa4dfbda3e4a8b95228fcd5778f66c",
"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": "Насіння гірчиці"
}
],
"buyers": [
{
"id": "f2831f8b59a042c8a5873da24a571fce",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"status": "complete",
"milestones": [
{
"id": "15a9ab37fec7476aa9ef10890b9b2f4a",
"title": "Підготовка до проведення процедури",
"description": "Доповнений опис відповіді",
"type": "approval",
"dueDate": "2023-01-01T00:00:07+02:00",
"status": "met",
"documents": [
{
"id": "a23d42fa7c964ecba471e1bcb60acc46",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e02eb47c177f4e078fd10eb781a99616?Signature=rN9%2BwQqp%2FjcIsh194eH4myfxHp7SzO3wXo9uAwzsF8ktudixiljJfdi7VP8qVHaRw4IhD6zi%2BmVMWZpLDOO0AA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:10+02:00",
"dateModified": "2023-01-01T00:00:10+02:00"
}
],
"author": {
"id": "223cf816f2d343d2ba8d7a038fafc659",
"name": "ЦЗО №1",
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
},
"address": {
"streetAddress": "вул. Банкова, 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "central"
},
"dateModified": "2023-01-01T00:00:10+02:00",
"dateMet": "2023-01-01T00:00:06+02:00",
"owner": "broker"
}
],
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:21+02:00",
"datePublished": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"id": "2c376a06cbf7476b8c229e6955bd8194"
}
}
The tender plans field contains all the plan ids
GET /api/2.5/tenders/d1b73c4e72e244f1833086204faadff6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title": "футляри до державних нагород",
"date": "2023-01-01T00:00:15+02:00",
"dateCreated": "2023-01-01T00:00:15+02:00",
"dateModified": "2023-01-01T00:00:21+02:00",
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"mainProcurementCategory": "services",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "519152a1889240fd9cf9dd576c46265c",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"buyers": [
{
"id": "3e32f23699ea4ac0b8e105e7babd2c86",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
{
"id": "88c051728aae432ca2d39a0215d63fcd",
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "222983",
"legalName": "ДП Державне Управління Справами"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
}
],
"plans": [
{
"id": "2c376a06cbf7476b8c229e6955bd8194"
}
],
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"procuringEntity": {
"name": "ЦЗО №1",
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"contactPoint": {
"name": "Довідкова",
"telephone": "+0440000000"
},
"kind": "central"
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"awardCriteria": "lowestCost",
"enquiryPeriod": {
"startDate": "2023-01-01T00:00:15+02:00",
"endDate": "2023-01-22T00:00:00+02:00",
"clarificationsUntil": "2023-01-26T00:00:00+02:00"
},
"tenderPeriod": {
"startDate": "2023-01-01T00:00:15+02:00",
"endDate": "2023-02-01T00:00:00+02:00"
},
"procurementMethodType": "aboveThresholdUA",
"items": [
{
"id": "97735bdc93204bd7a1469064bb3e615b",
"description": "Насіння гірчиці",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"quantity": 1000.0,
"relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"unit": {
"name": "кг",
"code": "KGM"
},
"deliveryDate": {
"endDate": "2023-01-16T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "258306a31f6a47758d528d907f4329fe",
"description": "Насіння соняшнику",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.95",
"description": "Насіння соняшнику"
}
],
"quantity": 2000.0,
"relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86",
"classification": {
"description": "Sunflower seeds",
"scheme": "ДК021",
"id": "03111300-5"
},
"unit": {
"name": "кг",
"code": "KGM"
},
"deliveryDate": {
"endDate": "2023-01-17T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "650759050f6a43e4aa1ab880fa5f35fb",
"description": "Насіння бавовнику",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.84",
"description": "Насіння бавовнику"
}
],
"quantity": 3000.0,
"relatedBuyer": "88c051728aae432ca2d39a0215d63fcd",
"classification": {
"description": "Cotton seeds",
"scheme": "ДК021",
"id": "03111400-6"
},
"unit": {
"name": "кг",
"code": "KGM"
},
"deliveryDate": {
"endDate": "2023-01-18T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"status": "draft",
"complaintPeriod": {
"startDate": "2023-01-01T00:00:15+02:00",
"endDate": "2023-01-28T00:00:00+02:00"
},
"id": "d1b73c4e72e244f1833086204faadff6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 2
}
}
Creation of aggregate contracts¶
For each buyer object in tender system is creating separate contract respectively when award become active.
Create tender with several buyers, each item should be assigned to related buyer using relatedBuyer field :
POST /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 6146
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/",
"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": [
{
"description": "телевізори",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"relatedBuyer": "11111111111111111111111111111111"
},
{
"description": "портфелі",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"relatedBuyer": "22222222222222222222222222222222"
},
{
"description": "портфелі",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"relatedBuyer": "22222222222222222222222222222222"
}
],
"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
}
],
"buyers": [
{
"id": "11111111111111111111111111111111",
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
}
},
{
"id": "22222222222222222222222222222222",
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037254",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
}
}
]
},
"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/bc77a76696c54e15bf3c933a54fe10c3
{
"data": {
"mainProcurementCategory": "goods",
"buyers": [
{
"id": "11111111111111111111111111111111",
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
}
},
{
"id": "22222222222222222222222222222222",
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037254",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
}
}
],
"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": "6e6b230ec09a42fdaeca0f4816412fb4",
"description": "телевізори",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "11111111111111111111111111111111"
},
{
"id": "6e914978c21c4396b03bc0a3e41658e4",
"description": "портфелі",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
},
{
"id": "85c354a1d9da41c7a31272a5d9f027e3",
"description": "портфелі",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "e35f63be7631427f8547da9e00d40b66",
"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": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"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": "bc77a76696c54e15bf3c933a54fe10c3"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
},
"access": {
"token": "8d3775a905d94c2184646a77323cfd0b",
"transfer": "20364f458396448aa3d76f9196d8e4ad"
}
}
Move forward as usual, activate award:
PATCH /api/2.5/tenders/bc77a76696c54e15bf3c933a54fe10c3/awards/4a612f58ede4430a9192781217044ee7?acc_token=8d3775a905d94c2184646a77323cfd0b HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "4a612f58ede4430a9192781217044ee7",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "9f6fcc72a4a6410a866961f6dab52cdf",
"complaintPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-04T00:00:00+02:00"
}
}
}
After activating award system is creating such amount of contracts that corresponds to the amount of buyers
GET /api/2.5/tenders/3e0dfd2adc2d453f81b040ab4669c62c/contracts HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "bad3b26fe25c4e1db21990d2a3c0d0d7",
"buyerID": "11111111111111111111111111111111",
"awardID": "f1fd258d422149ab94c399824028b762",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "pending",
"value": {
"amount": 0.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0.0
},
"items": [
{
"id": "0ad04d0ffa694aadb466632b29d2ee48",
"description": "телевізори",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "11111111111111111111111111111111"
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:00+02:00"
},
{
"id": "f3eed1ad77b04d82934d3431cd691c64",
"buyerID": "22222222222222222222222222222222",
"awardID": "f1fd258d422149ab94c399824028b762",
"contractID": "UA-2023-01-01-000001-a-2",
"status": "pending",
"value": {
"amount": 0.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0.0
},
"items": [
{
"id": "f01b64460c0e4f2b98c7ceb169446d72",
"description": "портфелі",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
},
{
"id": "01840f7ff4654f5e8b498e144a3d03ec",
"description": "портфелі",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:00+02:00"
}
]
}
Update Amount.Value of each contract considering the sum of product of Unit.Value by Quantity for each item in contract.
PATCH /api/2.5/tenders/bc77a76696c54e15bf3c933a54fe10c3/contracts/72526b749c9147f1a649b285eda4ae4a?acc_token=8d3775a905d94c2184646a77323cfd0b HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 100,
"amountNet": 95
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "72526b749c9147f1a649b285eda4ae4a",
"buyerID": "11111111111111111111111111111111",
"awardID": "4a612f58ede4430a9192781217044ee7",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "pending",
"value": {
"amount": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 95.0
},
"items": [
{
"id": "6e6b230ec09a42fdaeca0f4816412fb4",
"description": "телевізори",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "11111111111111111111111111111111"
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:00+02:00"
}
}
PATCH /api/2.5/tenders/bc77a76696c54e15bf3c933a54fe10c3/contracts/ae3955df173b4bd988629fc92f02056e?acc_token=8d3775a905d94c2184646a77323cfd0b HTTP/1.0
Authorization: Bearer broker
Content-Length: 54
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 200,
"amountNet": 190
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "ae3955df173b4bd988629fc92f02056e",
"buyerID": "22222222222222222222222222222222",
"awardID": "4a612f58ede4430a9192781217044ee7",
"contractID": "UA-2023-01-01-000001-a-2",
"status": "pending",
"value": {
"amount": 200.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 190.0
},
"items": [
{
"id": "6e914978c21c4396b03bc0a3e41658e4",
"description": "портфелі",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
},
{
"id": "85c354a1d9da41c7a31272a5d9f027e3",
"description": "портфелі",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:00+02:00"
}
}
You can activate or terminate each contract as usual. If there are not contracts in pending status and at least one contract became active tender is becoming complete
If award was cancelled, all contracts related to this awardID become in cancelled status.
Cancellation of aggregate contracts¶
Contracts can be cancelled:
PATCH /api/2.5/tenders/3e0dfd2adc2d453f81b040ab4669c62c/contracts/bad3b26fe25c4e1db21990d2a3c0d0d7?acc_token=076fb5f8143749b4b6872a24b8af4176 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "bad3b26fe25c4e1db21990d2a3c0d0d7",
"buyerID": "11111111111111111111111111111111",
"awardID": "f1fd258d422149ab94c399824028b762",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "cancelled",
"value": {
"amount": 0.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0.0
},
"items": [
{
"id": "0ad04d0ffa694aadb466632b29d2ee48",
"description": "телевізори",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "11111111111111111111111111111111"
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:01+02:00"
}
}
Except when contract is the last not cancelled contract:
PATCH /api/2.5/tenders/3e0dfd2adc2d453f81b040ab4669c62c/contracts/f3eed1ad77b04d82934d3431cd691c64?acc_token=076fb5f8143749b4b6872a24b8af4176 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Can't update contract status from pending to cancelled for last not cancelled contract. Cancel award instead."
}
]
}
In that case related award should be cancelled:
PATCH /api/2.5/tenders/bc77a76696c54e15bf3c933a54fe10c3/awards/4a612f58ede4430a9192781217044ee7?acc_token=8d3775a905d94c2184646a77323cfd0b HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "4a612f58ede4430a9192781217044ee7",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "9f6fcc72a4a6410a866961f6dab52cdf",
"complaintPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-04T00:00:00+02:00"
}
}
}
Let’s check all contracts are cancelled:
GET /api/2.5/tenders/3e0dfd2adc2d453f81b040ab4669c62c/contracts HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "bad3b26fe25c4e1db21990d2a3c0d0d7",
"buyerID": "11111111111111111111111111111111",
"awardID": "f1fd258d422149ab94c399824028b762",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "cancelled",
"value": {
"amount": 0.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0.0
},
"items": [
{
"id": "0ad04d0ffa694aadb466632b29d2ee48",
"description": "телевізори",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "11111111111111111111111111111111"
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:01+02:00"
},
{
"id": "f3eed1ad77b04d82934d3431cd691c64",
"buyerID": "22222222222222222222222222222222",
"awardID": "f1fd258d422149ab94c399824028b762",
"contractID": "UA-2023-01-01-000001-a-2",
"status": "cancelled",
"value": {
"amount": 0.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0.0
},
"items": [
{
"id": "f01b64460c0e4f2b98c7ceb169446d72",
"description": "портфелі",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
},
{
"id": "01840f7ff4654f5e8b498e144a3d03ec",
"description": "портфелі",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:01+02:00"
}
]
}