Централізовані закупівлі¶
Створення плану закупівлі¶
Покупець створює план. Він повинен вказати себе в списку покупців buyers і вказати на одну з центральних закупівельних організацій у полі procuringEntity:
POST /api/2.5/plans?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1898
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
"data": {
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2019-11-01T01:00:00+03:00"
}
},
"items": [
{
"deliveryDate": {
"endDate": "2019-11-09T01:00:00+03:00"
},
"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"
},
"buyers": [
{
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"name": "ДУС"
}
],
"budget": {
"project": {
"name": "proj_name",
"id": "123"
},
"amount": 10000,
"amountNet": 12222,
"currency": "UAH",
"id": "12303111000-2",
"description": "budget_description",
"period": {
"startDate": "2020-01-01T00:00:00",
"endDate": "2020-12-31T00:00:00"
},
"breakdown": [
{
"title": "other",
"description": "Breakdown other description.",
"value": {
"amount": 1500,
"currency": "UAH"
}
}
]
},
"status": "draft"
}
}
Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761
X-Content-Type-Options: nosniff
{
"data": {
"procuringEntity": {
"name": "ЦЗО №1",
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2019-11-01T01:00:00+03:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "123",
"name": "proj_name"
},
"period": {
"startDate": "2020-01-01T00:00:00+02:00",
"endDate": "2020-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "1bf7d60f1ad24027a538784c5b6c9bc2",
"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-2019-05-02-000001",
"items": [
{
"id": "17c0df4205d34d73b32c735a06a6b533",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"deliveryDate": {
"endDate": "2019-11-09T01:00:00+03:00"
},
"description": "Насіння гірчиці"
}
],
"buyers": [
{
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
}
}
],
"status": "draft",
"dateModified": "2019-05-02T04:00:00+03:00",
"datePublished": "2019-05-02T04:00:00+03:00",
"owner": "broker",
"id": "6cb30e0a8f2d4487946a40c0b043c761"
},
"access": {
"token": "68c63f3cbac242fbb15c334a84fb2fcf",
"transfer": "5765c54af6b5450aaabaa146c2861dd3"
}
}
Створення об’єкту відповіді¶
Коли центральна організація є procuringEntity плану, вона може додати відповідь до цього плану:
POST /api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761/milestones HTTP/1.0 Authorization: Bearer broker Content-Length: 1334 Content-Type: application/json Host: lb-api-sandbox.prozorro.gov.ua DATA: { "data": { "title": "Підготовка до проведення процедури", "description": "Узагальнення та аналіз отриманної інформації щодо проведення закупівель товарів, послуг (крім поточного ремонту) в інтересах замовників", "type": "approval", "author": { "identifier": { "scheme": "UA-EDR", "id": "111111", "legalName": "ДП Центральний закупівельний орган №1" }, "name": "ЦЗО №1" }, "dueDate": "2019-05-15T13:00:00.000000+02:00" } } Response: 201 Created Content-Type: application/json Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761/milestones/bcd0fdcf5036434881da407a855782c1 X-Content-Type-Options: nosniff { "data": { "id": "bcd0fdcf5036434881da407a855782c1", "title": "Підготовка до проведення процедури", "description": "Узагальнення та аналіз отриманної інформації щодо проведення закупівель товарів, послуг (крім поточного ремонту) в інтересах замовників", "type": "approval", "dueDate": "2019-05-15T13:00:00+02:00", "status": "scheduled", "author": { "name": "ЦЗО №1", "identifier": { "scheme": "UA-EDR", "id": "111111", "legalName": "ДП Центральний закупівельний орган №1" } }, "dateModified": "2019-05-02T05:00:00+03:00", "owner": "broker" }, "access": { "token": "4771af7ff4b24a448b71c2ee3cb688ee" } }
Тільки якщо надається токен доступу, відповідь можна змінити:
PATCH /api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761/milestones/bcd0fdcf5036434881da407a855782c1?acc_token=4771af7ff4b24a448b71c2ee3cb688ee HTTP/1.0 Authorization: Bearer broker Content-Length: 233 Content-Type: application/json Host: lb-api-sandbox.prozorro.gov.ua DATA: { "data": { "status": "met", "description": "Доповнений опис відповіді", "dueDate": "2019-05-30T18:00:00.000000+02:00" } } Response: 200 OK Content-Type: application/json X-Content-Type-Options: nosniff { "data": { "id": "bcd0fdcf5036434881da407a855782c1", "title": "Підготовка до проведення процедури", "description": "Доповнений опис відповіді", "type": "approval", "dueDate": "2019-05-30T18:00:00+02:00", "status": "met", "author": { "name": "ЦЗО №1", "identifier": { "scheme": "UA-EDR", "id": "111111", "legalName": "ДП Центральний закупівельний орган №1" } }, "dateModified": "2019-05-02T06:00:00+03:00", "dateMet": "2019-05-02T06:00:00+03:00", "owner": "broker" } }
Примітка
- Поля, які можна оновити, залежать від поточного статусу об’єкту:
- dueDate можна оновити лише у статусі scheduled
- description - у scheduled та met
Публікація документів також вимагає токен доступу (як і зміна документів за допомогою методів PATCH / PUT):
POST /api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761/milestones/bcd0fdcf5036434881da407a855782c1/documents?acc_token=4771af7ff4b24a448b71c2ee3cb688ee HTTP/1.0 Authorization: Bearer broker Content-Length: 318 Content-Type: application/json Host: lb-api-sandbox.prozorro.gov.ua DATA: { "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: 201 Created Content-Type: application/json Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761/milestones/bcd0fdcf5036434881da407a855782c1/documents/e4ec0c0e29d74a5e868f8e53b79bd05c X-Content-Type-Options: nosniff { "data": { "id": "e4ec0c0e29d74a5e868f8e53b79bd05c", "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": "2019-05-02T06:00:00+03:00", "dateModified": "2019-05-02T06:00:00+03:00" } }
Створення закупівлі¶
Центральна закупівельна організація створює агрегований тендер у статусі draft і вказує всіх покупців, використовуючи buyers список об’єктів PlanOrganization:
POST /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 2546
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
"data": {
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"procuringEntity": {
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
},
"name": "ЦЗО №1",
"contactPoint": {
"name": "Довідкова",
"telephone": "0440000000"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "central"
},
"value": {
"amount": 500,
"currency": "UAH"
},
"minimalStep": {
"amount": 15,
"currency": "UAH"
},
"items": [
{
"deliveryDate": {
"endDate": "2019-11-09T01:00:00+03:00"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"code": "KGM",
"name": "кг"
},
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"quantity": 1000,
"description": "Насіння гірчиці"
}
],
"enquiryPeriod": {
"startDate": "2019-10-01T01:00:00+03:00",
"endDate": "2019-10-30T01:00:00+03:00"
},
"tenderPeriod": {
"startDate": "2019-11-01T01:00:00+03:00",
"endDate": "2019-11-11T01:00:00+03: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": [
{
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
},
"name": "ДУС"
}
],
"status": "draft"
}
}
Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2d3b9e1f38c34125b1d2f7a164f871ba
X-Content-Type-Options: nosniff
{
"data": {
"title": "футляри до державних нагород",
"date": "2019-05-12T12:00:00+03:00",
"dateModified": "2019-05-12T12:00:00+03:00",
"tenderID": "UA-2019-05-12-000001",
"owner": "broker",
"mainProcurementCategory": "goods",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "bc6cce300c9941c4a5df776d1cf7a062",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"buyers": [
{
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
}
}
],
"procurementMethod": "open",
"awardCriteria": "lowestCost",
"submissionMethod": "electronicAuction",
"status": "draft",
"items": [
{
"id": "95fea057d382491fb93778d67d3c70f3",
"description": "Насіння гірчиці",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"deliveryDate": {
"endDate": "2019-11-09T01:00:00+03:00"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
}
}
],
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"enquiryPeriod": {
"startDate": "2019-10-01T01:00:00+03:00",
"endDate": "2019-10-30T01:00:00+03:00"
},
"tenderPeriod": {
"startDate": "2019-11-01T01:00:00+03:00",
"endDate": "2019-11-11T01:00:00+03:00"
},
"procuringEntity": {
"name": "ЦЗО №1",
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Довідкова",
"telephone": "0440000000"
},
"kind": "central"
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"procurementMethodType": "belowThreshold",
"id": "2d3b9e1f38c34125b1d2f7a164f871ba"
},
"access": {
"token": "10dc4c83ec444b9b9c38aad1cc00d390",
"transfer": "425ac43ccdc8457f84482d747bf7f76c"
}
}
Зв’язування планів з тендером¶
Центральна організація закупівель зв’язує план з тендером. Якщо є більш ніж один план, вони повинні бути з’єднані один за одним.
POST /api/2.5/tenders/2d3b9e1f38c34125b1d2f7a164f871ba/plans?acc_token=10dc4c83ec444b9b9c38aad1cc00d390 HTTP/1.0
Authorization: Bearer broker
Content-Length: 52
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
"data": {
"id": "6cb30e0a8f2d4487946a40c0b043c761"
}
}
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": [
{
"id": "6cb30e0a8f2d4487946a40c0b043c761"
}
]
}
У результаті план переміщається у статус “complete”
GET /api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"procuringEntity": {
"name": "ЦЗО №1",
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
}
},
"tender": {
"procurementMethod": "open",
"procurementMethodType": "belowThreshold",
"tenderPeriod": {
"startDate": "2019-11-01T01:00:00+03:00"
}
},
"budget": {
"id": "12303111000-2",
"description": "budget_description",
"amount": 10000.0,
"currency": "UAH",
"amountNet": 12222.0,
"project": {
"id": "123",
"name": "proj_name"
},
"period": {
"startDate": "2020-01-01T00:00:00+02:00",
"endDate": "2020-12-31T00:00:00+02:00"
},
"breakdown": [
{
"id": "1bf7d60f1ad24027a538784c5b6c9bc2",
"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": "2d3b9e1f38c34125b1d2f7a164f871ba",
"planID": "UA-P-2019-05-02-000001",
"items": [
{
"id": "17c0df4205d34d73b32c735a06a6b533",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"deliveryDate": {
"endDate": "2019-11-09T01:00:00+03:00"
},
"description": "Насіння гірчиці"
}
],
"buyers": [
{
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
}
}
],
"status": "complete",
"milestones": [
{
"id": "bcd0fdcf5036434881da407a855782c1",
"title": "Підготовка до проведення процедури",
"description": "Доповнений опис відповіді",
"type": "approval",
"dueDate": "2019-05-30T18:00:00+02:00",
"status": "met",
"documents": [
{
"id": "e4ec0c0e29d74a5e868f8e53b79bd05c",
"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": "2019-05-02T06:00:00+03:00",
"dateModified": "2019-05-02T06:00:00+03:00"
}
],
"author": {
"name": "ЦЗО №1",
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
}
},
"dateModified": "2019-05-02T06:00:00+03:00",
"dateMet": "2019-05-02T06:00:00+03:00",
"owner": "broker"
}
],
"dateModified": "2019-05-12T12:01:00+03:00",
"datePublished": "2019-05-02T04:00:00+03:00",
"owner": "broker",
"id": "6cb30e0a8f2d4487946a40c0b043c761"
}
}
Поле plans тендеру містить всі ідентифікатори планів
GET /api/2.5/tenders/2d3b9e1f38c34125b1d2f7a164f871ba HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"title": "футляри до державних нагород",
"date": "2019-05-12T12:00:00+03:00",
"dateModified": "2019-05-12T12:01:00+03:00",
"tenderID": "UA-2019-05-12-000001",
"owner": "broker",
"mainProcurementCategory": "goods",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "bc6cce300c9941c4a5df776d1cf7a062",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"buyers": [
{
"name": "ДУС",
"identifier": {
"scheme": "UA-EDR",
"id": "111983",
"legalName": "ДП Державне Управління Справами"
}
}
],
"plans": [
{
"id": "6cb30e0a8f2d4487946a40c0b043c761"
}
],
"procurementMethod": "open",
"awardCriteria": "lowestCost",
"submissionMethod": "electronicAuction",
"status": "draft",
"items": [
{
"id": "95fea057d382491fb93778d67d3c70f3",
"description": "Насіння гірчиці",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "01.11.92",
"description": "Насіння гірчиці"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 1000.0,
"deliveryDate": {
"endDate": "2019-11-09T01:00:00+03:00"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
}
}
],
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"enquiryPeriod": {
"startDate": "2019-10-01T01:00:00+03:00",
"endDate": "2019-10-30T01:00:00+03:00"
},
"tenderPeriod": {
"startDate": "2019-11-01T01:00:00+03:00",
"endDate": "2019-11-11T01:00:00+03:00"
},
"procuringEntity": {
"name": "ЦЗО №1",
"identifier": {
"scheme": "UA-EDR",
"id": "111111",
"legalName": "ДП Центральний закупівельний орган №1"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Довідкова",
"telephone": "0440000000"
},
"kind": "central"
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"procurementMethodType": "belowThreshold",
"id": "2d3b9e1f38c34125b1d2f7a164f871ba"
}
}