Туторіал
Configuration
The set of possible configuration values:
name |
values |
default |
---|---|---|
hasAuction |
false |
false |
hasAwardingOrder |
true |
true |
hasValueRestriction |
true |
true |
valueCurrencyEquality |
true |
true |
hasPrequalification |
false |
false |
minBidsNumber |
1 |
1 |
hasPreSelectionAgreement |
true |
true |
hasTenderComplaints |
false |
false |
hasAwardComplaints |
false |
false |
hasCancellationComplaints |
false |
false |
restricted |
false |
false |
You can look for more details in Конфігурація section.
Створення закупівлі
Введемо data атрибут у поданому тілі:
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"value": {
"amount": 22000,
"currency": "UAH"
},
"tenderPeriod": {
"endDate": "2023-10-04T01:00:00+03:00"
},
"procurementMethodType": "priceQuotation",
"procurementMethod": "selective",
"items": [
{
"description": "Комп’ютерне обладнання",
"quantity": 5,
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"profile": "655360-30230000-889652-40000777",
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"criteria": [
{
"description": "Форма випуску",
"requirementGroups": [
{
"description": "Форма випуску",
"requirements": [
{
"dataType": "string",
"expectedValue": "Розчин для інфузій",
"title": "Форма випуску"
}
]
}
],
"title": "Форма випуску"
},
{
"description": "Доза діючої речовини",
"requirementGroups": [
{
"description": "Доза діючої речовини",
"requirements": [
{
"dataType": "integer",
"minValue": 5,
"title": "Доза діючої речовини",
"unit": {
"code": "KGM",
"name": "кілограми"
}
}
]
}
],
"title": "Доза діючої речовини"
},
{
"description": "Форма випуску",
"requirementGroups": [
{
"description": "Форма випуску",
"requirements": [
{
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3,
"title": "Форма випуску"
}
]
}
],
"title": "Форма випуску"
}
]
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4
{
"data": {
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"title": "Комп’ютерне обладнання",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"endDate": "2023-10-04T01:00:00+03:00",
"startDate": "2023-09-20T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "04d0a215a93a4cd5beb0558049de9cc4",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "e177ce55c92c491cbc8d0431a6a25b8c",
"description": "Форма випуску",
"requirements": [
{
"id": "620397eaf9544635bb0366a1f65dae0e",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "549960a19ba44135be17d698eb40bb53",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "d160fa72c890473eb0595a4f111c3f51",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "68a31e41a65f44aeaf41d99090ac0db5",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "b56e2b8215974320966e2b85e567b0e8",
"description": "Форма випуску",
"requirements": [
{
"id": "2c6c054563904e35ac6e25b6ec864228",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"date": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"id": "3f38940af1314712ac29867b3e4eced4"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
},
"access": {
"token": "3f07ab10456e4f519a3cf51c24d19c80",
"transfer": "e92a5b619eb1406ba559e4ec7c1d9dfe"
}
}
Успіх! Тепер ми бачимо, що новий об’єкт було створено. Код відповіді 201 та заголовок відповіді Location вказує місцерозташування створеного об’єкта. Тіло відповіді показує інформацію про створену закупівлю, її внутрішнє id (яке співпадає з сегментом Location), її офіційне tenderID та dateModified дату, що показує час, коли закупівля востаннє модифікувалась. Зверніть увагу, що закупівля створюється зі статусом draft.
Примітка
Користувач отримує access: token з яким доступні операції ролі Замовника.
Процедура Запиту цінових пропозицій має procurementMethodType
: priceQuotation
та procurementMethod
: selective
.
Використаємо URL створеного об’єкта (заголовок відповіді Location):
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"title": "Комп’ютерне обладнання",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"endDate": "2023-10-04T01:00:00+03:00",
"startDate": "2023-09-20T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "04d0a215a93a4cd5beb0558049de9cc4",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "e177ce55c92c491cbc8d0431a6a25b8c",
"description": "Форма випуску",
"requirements": [
{
"id": "620397eaf9544635bb0366a1f65dae0e",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "549960a19ba44135be17d698eb40bb53",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "d160fa72c890473eb0595a4f111c3f51",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "68a31e41a65f44aeaf41d99090ac0db5",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "b56e2b8215974320966e2b85e567b0e8",
"description": "Форма випуску",
"requirements": [
{
"id": "2c6c054563904e35ac6e25b6ec864228",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"date": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"id": "3f38940af1314712ac29867b3e4eced4"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
Ми бачимо ту ж відповідь, що і після створення закупівлі.
Модифікація закупівлі
Замовник може відредагувати закупівлю перед публікацією. Давайте оновимо закупівлю, доповнюючи її усіма іншими необхідними властивостями:
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-05T01:00:11+03:00"
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:01+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-05T01:00:11+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "04d0a215a93a4cd5beb0558049de9cc4",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "e177ce55c92c491cbc8d0431a6a25b8c",
"description": "Форма випуску",
"requirements": [
{
"id": "620397eaf9544635bb0366a1f65dae0e",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "549960a19ba44135be17d698eb40bb53",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "d160fa72c890473eb0595a4f111c3f51",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "68a31e41a65f44aeaf41d99090ac0db5",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "b56e2b8215974320966e2b85e567b0e8",
"description": "Форма випуску",
"requirements": [
{
"id": "2c6c054563904e35ac6e25b6ec864228",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"id": "3f38940af1314712ac29867b3e4eced4"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.
Ще одна перевірка списку відображає нову дату модифікації:
GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-09-20T01:00:01+03:00",
"id": "3f38940af1314712ac29867b3e4eced4"
}
],
"next_page": {
"offset": 1695160801.0,
"path": "/api/2.5/tenders?offset=1695160801.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1695160801.0"
}
}
Публікація закупівлі
Після створення Замовник публікує процедуру, змінивши статус на draft.publishing, де робот priceQuotationBot запускає перевірку процедури та доповнює процедуру додатковими даними, отриманими з бази даних електронних каталогів ProZorro, включаючи shortListedFirms.
PATCH /api/2.5/tenders/8fc54d118a544ade91d3c28d8c89affb?acc_token=5bc846d5687141fa9b6e6dda2122dd32 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "draft.publishing"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft.publishing",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "d53c5a78817b4eec8047b872c498f3f4",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "5d5b28b41e7a4cdcb4be7c7d889340a7",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "0ee557f53cbf4abda11383d9afd27419",
"description": "Форма випуску",
"requirements": [
{
"id": "05ddda51d81741938adee8a1d202c478",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "c98667d13e4d46c2adfd021d0af298b2",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "04517e7feb9f42e181c011c28753df20",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "ae21e9856f254105a5f69c269c708348",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "0b9b868b5ba4475f9219623d5d9fcd09",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "d87a09363c984c02ba40e8ea8c19e998",
"description": "Форма випуску",
"requirements": [
{
"id": "741bf2e4125247eabc8fa9bc82df246a",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"noticePublicationDate": "2023-09-20T01:00:00+03:00",
"id": "8fc54d118a544ade91d3c28d8c89affb"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
Після успішної валідації priceQuotationBot переводить процедуру в статус: active.tendering
GET /api/2.5/tenders/8fc54d118a544ade91d3c28d8c89affb HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000001-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "active.tendering",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"shortlistedFirms": [
{
"name": "Товариство з обмеженою відповідальністю «Пікселі»",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Товариство з обмеженою відповідальністю «Пікселі»"
},
"address": {
"streetAddress": "бул.Дружби Народів, 8",
"locality": "м.Київ",
"region": "Київська область",
"postalCode": "01100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Оксана Піксель",
"email": "contact@pixel.pix",
"telephone": "+0671234567"
},
"scale": "large",
"id": "UA-EDR-12345678",
"status": "active"
},
{
"name": "Товариство з обмеженою відповідальністю «Штекер-Пекер»",
"identifier": {
"scheme": "UA-EDR",
"id": "87654321",
"legalName": "Товариство з обмеженою відповідальністю «Штекер-Пекер»"
},
"address": {
"streetAddress": "вул. Кластерна, 777-К",
"locality": "м.Тернопіль",
"region": "Тернопільська область",
"postalCode": "46000",
"countryName": "Україна"
},
"contactPoint": {
"name": "Олег Штекер",
"email": "info@shteker.pek",
"telephone": "+0951234567"
},
"scale": "large",
"id": "UA-EDR-87654321",
"status": "active"
}
],
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"noticePublicationDate": "2023-09-20T01:00:00+03:00",
"items": [
{
"id": "d53c5a78817b4eec8047b872c498f3f4",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "5d5b28b41e7a4cdcb4be7c7d889340a7",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "0ee557f53cbf4abda11383d9afd27419",
"description": "Форма випуску",
"requirements": [
{
"id": "05ddda51d81741938adee8a1d202c478",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "c98667d13e4d46c2adfd021d0af298b2",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "04517e7feb9f42e181c011c28753df20",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "ae21e9856f254105a5f69c269c708348",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "0b9b868b5ba4475f9219623d5d9fcd09",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "d87a09363c984c02ba40e8ea8c19e998",
"description": "Форма випуску",
"requirements": [
{
"id": "741bf2e4125247eabc8fa9bc82df246a",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"contractTemplateName": "00000000-0.0001.01",
"next_check": "2023-10-04T01:00:00+03:00",
"id": "8fc54d118a544ade91d3c28d8c89affb"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
У разі, якщо процедура не пройде перевірку через недійсні параметри, вона буде переведена в статус: draft.unsuccessful за допомогою priceQuotationBot.
GET /api/2.5/tenders/3a30afeece164702acbcbd999c068e6c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-09-20T01:00:00+03:00",
"dateModified": "2023-09-20T01:00:00+03:00",
"dateCreated": "2023-09-20T01:00:00+03:00",
"tenderID": "UA-2023-09-20-000002-a",
"owner": "broker",
"title": "Комп’ютерне обладнання",
"mainProcurementCategory": "goods",
"procurementMethod": "selective",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "draft.unsuccessful",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-09-20T01:00:00+03:00",
"endDate": "2023-10-04T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"items": [
{
"id": "f8940cf415e64f08a9d6259db7146e2b",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-09-22T01:00:00+03:00",
"endDate": "2023-09-25T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"profile": "655360-30230000-889652-40000777bad_profile"
}
],
"criteria": [
{
"id": "852d1c7c0dac4281b448282ce4fda4ab",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "6d134dd3ce2a4997a25e5043af124258",
"description": "Форма випуску",
"requirements": [
{
"id": "f0f83e19edd941f9a8d146d638b5ad02",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "d3a0fd015db14f1aae290c3ce8302a93",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "db2dc0e37937449d8cabb64705d61a85",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "7edaf68d943b4d91b3bd12b0a599f0d1",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "842ff1e7b13a439da73e03cd68afdeb2",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "1f9e1751f91a4ee1af35a80131477c5d",
"description": "Форма випуску",
"requirements": [
{
"id": "88655f0a81744d3a865f958a550013e2",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"id": "3a30afeece164702acbcbd999c068e6c"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"restricted": false
}
}
Подача пропозицій
Реєстрація пропозиції
Статус закупівлі active.tendering
дозволяє подання пропозицій.
Учасник може зареєструвати пропозицію зі статусом draft
(чернетка):
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"value": {
"amount": 469,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"requirement": {
"id": "2c6c054563904e35ac6e25b6ec864228"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "draft",
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0
}
]
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"value": {
"amount": 469.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "664cdc4af3b14a80890750ac88c5b5b6",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "b6478bf929684a39884e346a57e2aeee",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "b6e87f07d4dc4b989dec73c17059138f",
"requirement": {
"id": "2c6c054563904e35ac6e25b6ec864228"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "draft",
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0
}
],
"id": "e1e5b10f2f544862978912218b1bcb35",
"date": "2023-09-20T01:00:01+03:00"
},
"access": {
"token": "68c0f183a82143678b411345d129233c",
"transfer": "34a7da83c79448129b18ef4214fe4e42"
}
}
Примітка
Користувач отримує access: token з яким доступні операції ролі Постачальника.
і підтвердити її, перевівши у pending
статус:
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35?acc_token=68c0f183a82143678b411345d129233c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e1e5b10f2f544862978912218b1bcb35",
"date": "2023-09-20T01:00:01+03:00",
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "664cdc4af3b14a80890750ac88c5b5b6",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "b6478bf929684a39884e346a57e2aeee",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "b6e87f07d4dc4b989dec73c17059138f",
"requirement": {
"id": "2c6c054563904e35ac6e25b6ec864228"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "pending",
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0
}
]
}
}
Модифікація пропозиції
Пропозиція може бути оновленою до закінчення тендерного періоду.
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35?acc_token=68c0f183a82143678b411345d129233c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 459
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e1e5b10f2f544862978912218b1bcb35",
"date": "2023-09-20T01:00:01+03:00",
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "664cdc4af3b14a80890750ac88c5b5b6",
"requirement": {
"id": "620397eaf9544635bb0366a1f65dae0e"
},
"value": "Розчин для інфузій"
},
{
"id": "b6478bf929684a39884e346a57e2aeee",
"requirement": {
"id": "44e3b8bef28f42bc9bc8a2da8e48ac70"
},
"value": 5
},
{
"id": "b6e87f07d4dc4b989dec73c17059138f",
"requirement": {
"id": "2c6c054563904e35ac6e25b6ec864228"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "draft",
"items": [
{
"id": "e0171c9b08d34c71948f18a5f3504f5a",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0
}
]
}
}
Завантаження пропозиції
Потім учасник повинен завантажити документ(и) пропозиції:
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35/documents?acc_token=68c0f183a82143678b411345d129233c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Proposal.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7abe246945c74a798ef5abd6f6c3eacc?Signature=EkqkVQuxM0R2kMqqSHvh9wqelZ9s92zoy%2F8n3nXPtAiCUwONLevSQXvdstC7JGSuO743uvpHg7hGPeo6xrz3DA%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/tenders/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35/documents/5c63b9bde7d34f95896fb073e4ab8103
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7abe246945c74a798ef5abd6f6c3eacc?Signature=ix%2BAtoVHTr7n%2BtlzacHRzW5MXhg6cNDGh1H06A%2B%2Be5QADUguPxtLtZv0azfvgcsDePmEaAiMOiXEgsOVUNfIDw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "5c63b9bde7d34f95896fb073e4ab8103",
"confidentiality": "public",
"datePublished": "2023-09-20T01:00:01+03:00",
"dateModified": "2023-09-20T01:00:01+03:00"
}
}
Можна перевірити завантажені документи:
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/bids/e1e5b10f2f544862978912218b1bcb35/documents?acc_token=68c0f183a82143678b411345d129233c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7abe246945c74a798ef5abd6f6c3eacc?Signature=ix%2BAtoVHTr7n%2BtlzacHRzW5MXhg6cNDGh1H06A%2B%2Be5QADUguPxtLtZv0azfvgcsDePmEaAiMOiXEgsOVUNfIDw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "5c63b9bde7d34f95896fb073e4ab8103",
"confidentiality": "public",
"datePublished": "2023-09-20T01:00:01+03:00",
"dateModified": "2023-09-20T01:00:01+03:00"
}
]
}
Процес визначення переможця
Після закінчення тендерного періоду, система автоматично створює award
у статусі pending
для пропозиції з найбільш економічно вигідною ціною.
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"status": "pending",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"date": "2023-09-20T01:00:01+03:00",
"id": "dcf5db2bd67c47faaf0b9cc04f6539fe"
}
]
}
Замовник може прийняти award змінивши його статус на active.
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/dcf5db2bd67c47faaf0b9cc04f6539fe?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
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": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "active",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
}
}
Поглянемо на список awards:
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "active",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
}
]
}
Замовник може відхилити award після прийняття змінивши його статус на cancelled:
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/dcf5db2bd67c47faaf0b9cc04f6539fe?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/ef0d25ab94dc424fa0a0863235ada151
{
"data": {
"id": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "cancelled",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
}
}
Після відхилення award система створює другий award для цієї пропозиції у статусі pending:
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "cancelled",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
},
{
"id": "ef0d25ab94dc424fa0a0863235ada151",
"status": "pending",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
}
]
}
Якщо пропозиція Учасника з найменшою ціною відповідає вимогам, Замовник завантажує документ, що підтверджує його рішення і визнає пропозицію Переможцем (awards:status:active). Якщо не відповідає, Замовник завантажує протокол, що підтверджує його рішення про відхилення Учасника та відхиляє таку пропозицію (awards:status:unsuccessful). Система приводить до оцінки наступного за ціною Учасника (awards:status:pending).
Відхилимо award змінивши його статус на unsuccessful.
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/ef0d25ab94dc424fa0a0863235ada151?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/e01ef20540ac40c288dcd352b827253a
{
"data": {
"id": "ef0d25ab94dc424fa0a0863235ada151",
"status": "unsuccessful",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
}
}
В цьому випадку Award буде наданий до наступної пропозиції з найбільш економічно вигідною ціною.
Поглянемо на список awards:
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "cancelled",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
},
{
"id": "ef0d25ab94dc424fa0a0863235ada151",
"status": "unsuccessful",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
},
{
"id": "e01ef20540ac40c288dcd352b827253a",
"status": "pending",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 479.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "7555abc429b14bd7a5fb385a6c7931c1"
}
]
}
Замовник може прийняти award другого учасника змінивши його статус на active.
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards/e01ef20540ac40c288dcd352b827253a?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
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": "e01ef20540ac40c288dcd352b827253a",
"status": "active",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 479.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "7555abc429b14bd7a5fb385a6c7931c1"
}
}
Поглянемо на список awards:
GET /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "dcf5db2bd67c47faaf0b9cc04f6539fe",
"status": "cancelled",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
},
{
"id": "ef0d25ab94dc424fa0a0863235ada151",
"status": "unsuccessful",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 459.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "e1e5b10f2f544862978912218b1bcb35"
},
{
"id": "e01ef20540ac40c288dcd352b827253a",
"status": "active",
"date": "2023-09-20T01:00:01+03:00",
"value": {
"amount": 479.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"bid_id": "7555abc429b14bd7a5fb385a6c7931c1"
}
]
}
Примітка
У випадку переходу award останньої пропозиції у статус unsuccessful процедура набуде кінцевий статус: `unsuccessful`.
Налаштування угоди
Усі операції над угодою перенесені до EContracting API для реєстрації даних пов’язаних з договором
Відміна закупівлі
Замовник може скасувати закупівлю у будь-який момент (крім закупівель у кінцевому стані, наприклад, unsuccessful, cancelled, complete).
Для цього потрібно виконати наступні кроки:
Приготуйте запит на скасування.
Наповніть його протоколом про причини скасування.
Скасуйте закупівлю через подані причини.
Запит на скасування, який не пройшов активації (3-й крок), не матиме сили, тобто, для скасування закупівлі буде обов’язковим не тільки створити заявку, але і активувати її.
Для відміни скасування закупівлі, вам потрібно оновити статус скасування до unsuccessful з draft чи pending
Дивіться структуру запиту Cancellation для більш детальної інформації.
Формування запиту на скасування
Ви повинні передати змінні reason та reasonType, status у стані draft.
При скасуванні, замовник має визначити один з чотирьох типів reasonType: noDemand, unFixable, forceMajeure aбо expensesCut.
id генерується автоматично і повертається у додатковому заголовку відповіді Location:
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reason": "cancellation reason",
"reasonType": "noDemand"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "0162fbd6680f40e8b12a7235ace8cf98",
"date": "2023-09-20T01:00:01+03:00",
"cancellationOf": "tender",
"status": "draft"
}
}
Ви можете виправити тип на будь-який що вказаний вище.
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "expensesCut"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0162fbd6680f40e8b12a7235ace8cf98",
"status": "draft",
"date": "2023-09-20T01:00:01+03:00",
"reasonType": "expensesCut",
"reason": "cancellation reason",
"cancellationOf": "tender"
}
}
Наповнення протоколом та іншою супровідною документацією
Цей крок обов’язковий. Без документів ви не можете оновити статус закупівлі.
Завантажити вміст файлу
POST /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b51f286a456744a5aa311917ee24504a?Signature=9KkaDLqMGbQT%2B1ZKKh3fJraW%2FS7QAVYc0beKGLk%2FoPDSU6H0gnqVXDCI%2FoxpGshn0cGW4M11zMwTHJnkiGprAQ%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/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents/497191c24d4b49759574f384a2690a30
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b51f286a456744a5aa311917ee24504a?Signature=YHcahWxxAcYSGa9HFfWHlPRBYSaTYUUi1lPh0gSVQiBwIX0MWoVsCpKb7%2BIM5t113k1MQNMMMe8%2F0aPDtaXACQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "497191c24d4b49759574f384a2690a30",
"datePublished": "2023-09-20T01:00:01+03:00",
"dateModified": "2023-09-20T01:00:01+03:00"
}
}
Зміна опису документа та інших властивостей
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents/497191c24d4b49759574f384a2690a30?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"description": "Changed description"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"description": "Changed description",
"id": "497191c24d4b49759574f384a2690a30",
"datePublished": "2023-09-20T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b51f286a456744a5aa311917ee24504a?Signature=YHcahWxxAcYSGa9HFfWHlPRBYSaTYUUi1lPh0gSVQiBwIX0MWoVsCpKb7%2BIM5t113k1MQNMMMe8%2F0aPDtaXACQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-09-20T01:00:01+03:00",
"language": "uk"
}
}
Завантажити нову версію документа
PUT /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98/documents/497191c24d4b49759574f384a2690a30?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice-2.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/04b19e98abbc481f944b5a4e1376e930?Signature=AXwZfcLUrCdPBMKtiuBJGEVMMujTL08LBQ2Jbz%2B1erbKeFVm0PQEhPFa5BLoIDu3msiBjhnTTDV9H19Z1sDoBQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"description": "Changed description",
"id": "497191c24d4b49759574f384a2690a30",
"datePublished": "2023-09-20T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice-2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/04b19e98abbc481f944b5a4e1376e930?Signature=wonP7nxBLzgfRnPAAi4UlfqIzubU3uA9sSG4fWwckC9AK2Bh3G1LX7aeiqEq%2FuX5hCnBCY2b%2FIAjawi66cfiDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-09-20T01:00:01+03:00",
"language": "uk"
}
}
Активація запиту на відміну закупівлі
PATCH /api/2.5/tenders/3f38940af1314712ac29867b3e4eced4/cancellations/0162fbd6680f40e8b12a7235ace8cf98?acc_token=3f07ab10456e4f519a3cf51c24d19c80 HTTP/1.0
Authorization: Bearer broker
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": "0162fbd6680f40e8b12a7235ace8cf98",
"status": "active",
"date": "2023-09-20T01:00:01+03:00",
"reasonType": "expensesCut",
"reason": "cancellation reason",
"cancellationOf": "tender",
"documents": [
{
"description": "Changed description",
"id": "497191c24d4b49759574f384a2690a30",
"datePublished": "2023-09-20T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b51f286a456744a5aa311917ee24504a?Signature=YHcahWxxAcYSGa9HFfWHlPRBYSaTYUUi1lPh0gSVQiBwIX0MWoVsCpKb7%2BIM5t113k1MQNMMMe8%2F0aPDtaXACQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-09-20T01:00:01+03:00",
"language": "uk"
},
{
"description": "Changed description",
"id": "497191c24d4b49759574f384a2690a30",
"datePublished": "2023-09-20T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice-2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/04b19e98abbc481f944b5a4e1376e930?Signature=wonP7nxBLzgfRnPAAi4UlfqIzubU3uA9sSG4fWwckC9AK2Bh3G1LX7aeiqEq%2FuX5hCnBCY2b%2FIAjawi66cfiDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-09-20T01:00:01+03:00",
"language": "uk"
}
]
}
}