Централізовані закупівлі¶
Створення плану закупівлі¶
Покупець створює план. Він повинен вказати себе в списку покупців buyers і вказати на одну з центральних закупівельних організацій у полі procuringEntity:
Request
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"
}
}
Response
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"
}
}
Створення об’єкту відповіді¶
Коли центральна організація є procuringEntity плану, вона може додати відповідь до цього плану:
Request
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" } }Response
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" } }
Тільки якщо надається токен доступу, відповідь можна змінити:
Request
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" } }Response
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" } }
Примітка
- Поля, які можна оновити, залежать від поточного статусу об’єкту:
- dueDate можна оновити лише у статусі scheduled
- description - у scheduled та met
Публікація документів також вимагає токен доступу (як і зміна документів за допомогою методів PATCH / PUT):
Request
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" } }Response
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" } }
Створення закупівлі¶
Центральна закупівельна організація створює агрегований тендер у статусі draft і вказує всіх покупців, використовуючи buyers список об’єктів PlanOrganization:
Request
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
}
}
Response
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"
}
}
Зв’язування планів з тендером¶
Центральна організація закупівель зв’язує план з тендером. Якщо є більш ніж один план, вони повинні бути з’єднані один за одним.
Request
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"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "2c376a06cbf7476b8c229e6955bd8194"
}
]
}
У результаті план переміщається у статус “complete”
Request
GET /api/2.5/plans/2c376a06cbf7476b8c229e6955bd8194 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
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"
}
}
Поле plans тендеру містить всі ідентифікатори планів
Request
GET /api/2.5/tenders/d1b73c4e72e244f1833086204faadff6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
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
}
}
Створення агрегованих контрактів¶
Для кожного об’єктку buyer в тендері система створює окремий contract відповідно, в той момент коли award стає активним.
Створюємо тендер з декількома buyers, кожен item повинен бути прив’язаний до відповідного buyer, використовючи поле relatedBuyer:
Request
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
}
}
Response
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"
}
}
Йдемо далі, як зазвичай, активуємо авард
Request
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"
}
}
Response
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"
}
}
}
Після активації аварду система створює таку кількість об’єктів contracts, що відповідає кількості buyers в тендері
Request
GET /api/2.5/tenders/3e0dfd2adc2d453f81b040ab4669c62c/contracts HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
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"
}
]
}
Оновлюємо Amount.Value для кожного контракту, враховуючи суму добутків Unit.Value на Quantity для кожного item в контракті:
Request
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
}
}
}
Response
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"
}
}
Request
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
}
}
}
Response
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"
}
}
Ви можете активувати або термінувати кожен контракт як зазвичай. Якщо відсутні контракти в стутусі pending та хоча б один котракт знаходиться в статусі active, тендер переходить в статус complete
При скасуванні аварду всі контракти відповідного awardID переходять в статус cancelled.
Відміна агрегованих контрактів¶
Контракт може бути відмінений:
Request
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"
}
}
Response
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"
}
}
За винятком коли котракт є останнім невідміненим контрактом:
Request
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"
}
}
Response
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."
}
]
}
В цьому випадку повинен бути відмінений відповідний авард:
Request
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"
}
}
Response
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"
}
}
}
Перевіримо що всі контракти відмінені:
Request
GET /api/2.5/tenders/3e0dfd2adc2d453f81b040ab4669c62c/contracts HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
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"
}
]
}