Туторіал
Конфігурація
Набір можливих значень конфігурації для reporting:
name |
values |
default |
|---|---|---|
hasAuction |
false |
false |
hasAwardingOrder |
true |
true |
hasValueRestriction |
true |
true |
valueCurrencyEquality |
true |
true |
hasPrequalification |
false |
false |
minBidsNumber |
1 |
1 |
hasPreSelectionAgreement |
false |
false |
hasTenderComplaints |
false |
false |
hasAwardComplaints |
false |
false |
hasCancellationComplaints |
false |
false |
hasValueEstimation |
true |
true |
hasQualificationComplaints |
false |
false |
tenderComplainRegulation |
0 |
0 |
qualificationComplainDuration |
0 |
0 |
awardComplainDuration |
0 |
0 |
cancellationComplainDuration |
0 |
0 |
clarificationUntilDuration |
0 |
0 |
qualificationDuration |
0 |
0 |
minTenderingDuration |
0 |
0 |
hasEnquiries |
false |
false |
minEnquiriesDuration |
0 |
0 |
enquiryPeriodRegulation |
0 |
0 |
restricted |
false |
false |
Набір можливих значень конфігурації для negotiation:
name |
values |
default |
|---|---|---|
hasAuction |
false |
false |
hasAwardingOrder |
true |
true |
hasValueRestriction |
true |
true |
valueCurrencyEquality |
true |
true |
hasPrequalification |
false |
false |
minBidsNumber |
1 |
1 |
hasPreSelectionAgreement |
false |
false |
hasTenderComplaints |
false |
false |
hasAwardComplaints |
true |
true |
hasCancellationComplaints |
true |
true |
hasValueEstimation |
true |
true |
hasQualificationComplaints |
false |
false |
tenderComplainRegulation |
0 |
0 |
qualificationComplainDuration |
0 |
0 |
awardComplainDuration |
10 |
10 |
cancellationComplainDuration |
10 |
10 |
clarificationUntilDuration |
0 |
0 |
qualificationDuration |
0 |
0 |
minTenderingDuration |
0 |
0 |
hasEnquiries |
false |
false |
minEnquiriesDuration |
0 |
0 |
enquiryPeriodRegulation |
0 |
0 |
restricted |
false |
false |
Набір можливих значень конфігурації для negotiation.quick:
name |
values |
default |
|---|---|---|
hasAuction |
false |
false |
hasAwardingOrder |
true |
true |
hasValueRestriction |
true |
true |
valueCurrencyEquality |
true |
true |
hasPrequalification |
false |
false |
minBidsNumber |
1 |
1 |
hasPreSelectionAgreement |
false |
false |
hasTenderComplaints |
false |
false |
hasAwardComplaints |
true |
true |
hasCancellationComplaints |
true |
true |
hasValueEstimation |
true |
true |
hasQualificationComplaints |
false |
false |
tenderComplainRegulation |
0 |
0 |
qualificationComplainDuration |
0 |
0 |
awardComplainDuration |
5 |
5 |
cancellationComplainDuration |
10 |
10 |
clarificationUntilDuration |
0 |
0 |
qualificationDuration |
0 |
0 |
minTenderingDuration |
0 |
0 |
hasEnquiries |
false |
false |
minEnquiriesDuration |
0 |
0 |
enquiryPeriodRegulation |
0 |
0 |
restricted |
false |
false |
Ви можете ознайомитись з деталями в секції Конфігурація.
Створення закупівлі
- Можна створити три процедури:
reporting- процедура звітування про укладений договір (без періоду очікування скарг)negotiation- переговорна процедура з десятиденним періодом очікування скарг перед реєстрацією угодиnegotiation.quick- переговорна процедура за нагальною потребою з п’ятиденним періодом очікування скарг перед реєстрацією угоди
Створення закупівлі для процедури звітування про укладений договір
Щоб створити закупівлю за процедурою звітування про укладений договір, потрібно встановити значення reporting для procurementMethodType.
Для процедури звітування про укладений договір додавання поля cause до тендеру є обов’язковими, якщо поле procurmentMethodRationale пусте, в полі procuringEntity.kind вказано щось відмінне від other та очікувана вартість перевищує поріг:
100 000 для товарів,
200 000 для послуг,
1 500 000 для робіт.
Спробуємо створити тендер з очікуваною вартістю більше ніж поріг та без поля procurementMethodRationale:
Request
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": {
"items": [
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"classification": {
"description": "Послуги з харчування у школах",
"id": "55523100-3",
"scheme": "ДК021"
},
"unit": {
"code": "KGM",
"name": "папір",
"value": {
"amount": 10
}
},
"quantity": 1
}
],
"procurementMethod": "limited",
"procurementMethodType": "reporting",
"status": "draft",
"procuringEntity": {
"kind": "special",
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21027",
"region": "Вінницька область",
"streetAddress": "вул. Стахурського. 22"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"identifier": {
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"scheme": "UA-EDR"
},
"name": "ЗОСШ #10 м.Вінниці",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500000,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45
}
],
"mainProcurementCategory": "services"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 0,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 0,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "cause",
"description": [
"This field is required."
]
}
]
}
Додамо до тендеру поля cause та causeDescription і після цього створимо закупівлю:
Request
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": {
"items": [
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"classification": {
"description": "Послуги з харчування у школах",
"id": "55523100-3",
"scheme": "ДК021"
},
"unit": {
"code": "KGM",
"name": "папір",
"value": {
"amount": 10
}
},
"quantity": 1
}
],
"procurementMethod": "limited",
"procurementMethodType": "reporting",
"status": "draft",
"procuringEntity": {
"kind": "special",
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21027",
"region": "Вінницька область",
"streetAddress": "вул. Стахурського. 22"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"identifier": {
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"scheme": "UA-EDR"
},
"name": "ЗОСШ #10 м.Вінниці",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500000,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45
}
],
"mainProcurementCategory": "services",
"cause": "defencePurchase",
"causeDescription": "Задоволення нагальних потреб Збройних Сил, інших військових формувань та правоохоронних органів на їх запит"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 0,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 0,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a
{
"data": {
"mainProcurementCategory": "services",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"procurementMethod": "limited",
"title": "Послуги шкільних їдалень",
"procurementMethodType": "reporting",
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"kind": "special"
},
"items": [
{
"id": "46c639d51deb4d19bcb6e2a44ab46f04",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"value": {
"amount": 500000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"status": "draft",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "3146a414257c4ddd94f2ff02c75d00ab",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"cause": "defencePurchase",
"causeDescription": "Задоволення нагальних потреб Збройних Сил, інших військових формувань та правоохоронних органів на їх запит",
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "f082eef1f646440d9089b9620ea0bb9a"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 0,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 0,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
},
"access": {
"token": "876109ab3fbf46ca81bae8f2e668687a",
"transfer": "87976a5a25a24bd692e842f5cb8cae14"
}
}
Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковим ідентифікатором id, tenderID та властивість dateModified - дату, що показує час, коли закупівля востаннє модифікувалась.
Перевіримо, що містить реєстр закупівель:
Request
GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [],
"next_page": {
"offset": "",
"path": "/api/2.5/tenders",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders"
}
}
Ми поки не бачимо внутрішнього id закупівлі, тому що у списку відображаються закупівлі лише після статусу active.
Створення закупівлі для переговорної процедури
Щоб створити закупівлю за переговорною процедурою, потрібно встановити значення negotiation для procurementMethodType.
Request
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": {
"items": [
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"classification": {
"description": "Послуги з харчування у школах",
"id": "55523100-3",
"scheme": "ДК021"
},
"unit": {
"code": "KGM",
"name": "папір",
"value": {
"amount": 10
}
},
"quantity": 1,
"relatedLot": "e10f7c85d2484c99a312334e6e9faaac"
}
],
"procurementMethod": "limited",
"procurementMethodType": "negotiation",
"status": "draft",
"procuringEntity": {
"kind": "special",
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21027",
"region": "Вінницька область",
"streetAddress": "вул. Стахурського. 22"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"identifier": {
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"scheme": "UA-EDR"
},
"name": "ЗОСШ #10 м.Вінниці",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500000,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"percentage": 45.55,
"relatedLot": "e10f7c85d2484c99a312334e6e9faaac"
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45,
"relatedLot": "e10f7c85d2484c99a312334e6e9faaac"
}
],
"mainProcurementCategory": "services",
"cause": "twiceUnsuccessful",
"causeDescription": "оригінальний тендер не вдався двічі",
"causeDescription_en": "original tender has failed twice",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"value": {
"amount": 500000,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"id": "e10f7c85d2484c99a312334e6e9faaac"
}
]
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": true,
"hasCancellationComplaints": true,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 10,
"cancellationComplainDuration": 10,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 0,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a
{
"data": {
"mainProcurementCategory": "services",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"procurementMethod": "limited",
"title": "Послуги шкільних їдалень",
"procurementMethodType": "negotiation",
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"kind": "special"
},
"status": "draft",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amount": 500000.0
},
"items": [
{
"id": "46c639d51deb4d19bcb6e2a44ab46f04",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"relatedLot": "e10f7c85d2484c99a312334e6e9faaac",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"cause": "twiceUnsuccessful",
"causeDescription": "оригінальний тендер не вдався двічі",
"causeDescription_en": "original tender has failed twice",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "e10f7c85d2484c99a312334e6e9faaac",
"status": "active",
"value": {
"amount": 500000.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"date": "2023-10-10T01:00:00+03:00"
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"relatedLot": "e10f7c85d2484c99a312334e6e9faaac"
},
{
"id": "3146a414257c4ddd94f2ff02c75d00ab",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"relatedLot": "e10f7c85d2484c99a312334e6e9faaac"
}
],
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "f082eef1f646440d9089b9620ea0bb9a"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": true,
"hasCancellationComplaints": true,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 10,
"cancellationComplainDuration": 10,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 0,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
},
"access": {
"token": "876109ab3fbf46ca81bae8f2e668687a",
"transfer": "87976a5a25a24bd692e842f5cb8cae14"
}
}
Створення закупівлі для переговорної процедури за нагальною потребою
Щоб створити закупівлю для переговорної процедури за нагальною потребою, потрібно встановити значення negotiation.quick для procurementMethodType.
Request
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": {
"items": [
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"classification": {
"description": "Послуги з харчування у школах",
"id": "55523100-3",
"scheme": "ДК021"
},
"unit": {
"code": "KGM",
"name": "папір",
"value": {
"amount": 10
}
},
"quantity": 1,
"relatedLot": "5740fe669c0546188adff1c8c9b0aa58"
}
],
"procurementMethod": "limited",
"procurementMethodType": "negotiation.quick",
"status": "draft",
"procuringEntity": {
"kind": "special",
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21027",
"region": "Вінницька область",
"streetAddress": "вул. Стахурського. 22"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"identifier": {
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"scheme": "UA-EDR"
},
"name": "ЗОСШ #10 м.Вінниці",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500000,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"percentage": 45.55,
"relatedLot": "5740fe669c0546188adff1c8c9b0aa58"
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45,
"relatedLot": "5740fe669c0546188adff1c8c9b0aa58"
}
],
"mainProcurementCategory": "services",
"cause": "twiceUnsuccessful",
"causeDescription": "оригінальний тендер не вдався двічі",
"causeDescription_en": "original tender has failed twice",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"value": {
"amount": 500000,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"id": "5740fe669c0546188adff1c8c9b0aa58"
}
]
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": true,
"hasCancellationComplaints": true,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 5,
"cancellationComplainDuration": 10,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 0,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a
{
"data": {
"mainProcurementCategory": "services",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"procurementMethod": "limited",
"title": "Послуги шкільних їдалень",
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"kind": "special"
},
"status": "draft",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500000.0
},
"items": [
{
"id": "46c639d51deb4d19bcb6e2a44ab46f04",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"relatedLot": "5740fe669c0546188adff1c8c9b0aa58",
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"causeDescription": "оригінальний тендер не вдався двічі",
"causeDescription_en": "original tender has failed twice",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "5740fe669c0546188adff1c8c9b0aa58",
"status": "active",
"value": {
"amount": 500000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"date": "2023-10-10T01:00:00+03:00"
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"relatedLot": "5740fe669c0546188adff1c8c9b0aa58"
},
{
"id": "3146a414257c4ddd94f2ff02c75d00ab",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"relatedLot": "5740fe669c0546188adff1c8c9b0aa58"
}
],
"procurementMethodType": "negotiation.quick",
"cause": "twiceUnsuccessful",
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "f082eef1f646440d9089b9620ea0bb9a"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": true,
"hasCancellationComplaints": true,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 5,
"cancellationComplainDuration": 10,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 0,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
},
"access": {
"token": "876109ab3fbf46ca81bae8f2e668687a",
"transfer": "87976a5a25a24bd692e842f5cb8cae14"
}
}
Активація закупівлі
Для активації закупівель reporting, negotiation, negotiation.quick їх потрібно перевести до статусу active:
Request
PATCH /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
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": {
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"title": "Послуги шкільних їдалень",
"mainProcurementCategory": "services",
"procurementMethod": "limited",
"procurementMethodType": "reporting",
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"kind": "special"
},
"items": [
{
"id": "46c639d51deb4d19bcb6e2a44ab46f04",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"value": {
"amount": 500000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"status": "active",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "3146a414257c4ddd94f2ff02c75d00ab",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"cause": "defencePurchase",
"causeDescription": "Задоволення нагальних потреб Збройних Сил, інших військових формувань та правоохоронних органів на їх запит",
"id": "f082eef1f646440d9089b9620ea0bb9a"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 0,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 0,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Подивимось, що показує список закупівель:
Request
GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "f082eef1f646440d9089b9620ea0bb9a"
}
],
"next_page": {
"offset": "1696888800.0.1.e43895e396f45ba74609207be67947bf",
"path": "/api/2.5/tenders?offset=1696888800.0.1.e43895e396f45ba74609207be67947bf",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1696888800.0.1.e43895e396f45ba74609207be67947bf"
}
}
Відображається id - внутрішній ідентифікатор (який можна використовувати, щоб побудувати повну URL-адресу, додаючи http://api-sandbox.openprocurement.org/api/0/tenders/ на початку) та мітка часу dateModified.
Модифікація закупівлі
Оновимо закупівлю шляхом надання їй усіх інших важливих властивостей:
Request
PATCH /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "46c639d51deb4d19bcb6e2a44ab46f04",
"description": "Послуги шкільних їдалень",
"unit": {
"code": "MON",
"name": "month"
},
"quantity": 9,
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"title": "Послуги шкільних їдалень",
"mainProcurementCategory": "services",
"procurementMethod": "limited",
"procurementMethodType": "reporting",
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"kind": "special"
},
"items": [
{
"id": "46c639d51deb4d19bcb6e2a44ab46f04",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "month",
"code": "MON"
},
"quantity": 9.0,
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryDate": {
"startDate": "2023-10-30T00:00:00+02:00",
"endDate": "2023-11-29T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"value": {
"amount": 500000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"status": "active",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "3146a414257c4ddd94f2ff02c75d00ab",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"cause": "defencePurchase",
"causeDescription": "Задоволення нагальних потреб Збройних Сил, інших військових формувань та правоохоронних органів на їх запит",
"id": "f082eef1f646440d9089b9620ea0bb9a"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 0,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 0,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.
Ще одна перевірка списку відображає нову дату модифікації:
Request
GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "f082eef1f646440d9089b9620ea0bb9a"
}
],
"next_page": {
"offset": "1696888800.0.1.e43895e396f45ba74609207be67947bf",
"path": "/api/2.5/tenders?offset=1696888800.0.1.e43895e396f45ba74609207be67947bf",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1696888800.0.1.e43895e396f45ba74609207be67947bf"
}
}
Завантаження документації
Замовник може завантажити документи у створену закупівлю. Завантаження повинно відбуватись згідно правил Завантаження документів.
Request
POST /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/documents?acc_token=876109ab3fbf46ca81bae8f2e668687a 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/6b637535099e452b890198556efb7f70?Signature=z4vCl%2FLtbJ2RpGjssq1HKcQ4DzZJ4QSBdeYcMkt2AzLZUmI8TfP9Hp5fNqcBkQcWjYqnejjnfO4b9mMl%2Foy2BA%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/tenders/f082eef1f646440d9089b9620ea0bb9a/documents/f196a55f73014c74883f38f65e907a02
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b637535099e452b890198556efb7f70?Signature=Gb0uMtev6EiVhDG%2FUzbdh5NxU8ZGf5XusY8RY9n0C9HplAxVHIPVZ8%2FV5X8I0XUCOjzFPqSAe9CiguZlHkj2CA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "f196a55f73014c74883f38f65e907a02",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено.
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
Request
PUT /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/documents/f196a55f73014c74883f38f65e907a02?acc_token=876109ab3fbf46ca81bae8f2e668687a 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/42fbf3c4d1f544caa25e5a34bbe882b1?Signature=47RE4R8qDyxZb6C08wNjYQUj6ZW7%2B0JipGGXkhW8S%2BZFQnGUzpdDo7tirAjxYzRpgry87281sD351x2eovzCAw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"id": "f196a55f73014c74883f38f65e907a02",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/42fbf3c4d1f544caa25e5a34bbe882b1?Signature=vuvQiORGzTDrcMzvBj8DCZALoBAzDuzLP1flCwLHr%2BcWbuA2UqXSwHmtPjhve8Ig1Nro75CiPhiEmob3syjrDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
}
Визначення переможця
Додаємо інформацію про постачальника
Спосіб додавання інформації про постачальника однаковий для всіх процедур.
Замовник реєструє інформацію про постачальника для процедури звітування про укладений договір:
Request
POST /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending",
"suppliers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21100",
"region": "Вінницька область",
"streetAddress": "вул. Островського, 33"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"name": "Сергій Олексюк",
"telephone": "+380432216930"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"value": {
"amount": 475000,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11
{
"data": {
"status": "pending",
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
}
}
],
"value": {
"amount": 475000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"id": "c41959de1f2c4c9086d1ee34dc990c11",
"date": "2023-10-10T01:00:00+03:00"
}
}
Замовник реєструє інформацію про постачальника для переговорної процедури:
Request
POST /api/2.5/tenders/8690ddb7d98e43858e01a709a3b81a8a/awards?acc_token=955ba98fce244b3aa2cd16bcdbd01e2a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending",
"suppliers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21100",
"region": "Вінницька область",
"streetAddress": "вул. Островського, 33"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"name": "Сергій Олексюк",
"telephone": "+380432216930"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"value": {
"amount": 475000,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"lotID": "322c3eb279804f689dc9fd81edec2cdf"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/8690ddb7d98e43858e01a709a3b81a8a/awards/a0c7ef1744234c728ea1c8b9fc7363ea
{
"data": {
"status": "pending",
"value": {
"amount": 475000.0,
"valueAddedTaxIncluded": false,
"currency": "UAH"
},
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"lotID": "322c3eb279804f689dc9fd81edec2cdf",
"id": "a0c7ef1744234c728ea1c8b9fc7363ea",
"date": "2023-10-10T01:00:00+03:00"
}
}
Ви можете побачити, що згенеровано запис complaintPeriod із полем startDate.
Замовник реєструє інформацію про постачальника для переговорної процедури за нагальною потребою:
Request
POST /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending",
"suppliers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21100",
"region": "Вінницька область",
"streetAddress": "вул. Островського, 33"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"name": "Сергій Олексюк",
"telephone": "+380432216930"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"value": {
"amount": 475000,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"lotID": "5740fe669c0546188adff1c8c9b0aa58"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11
{
"data": {
"status": "pending",
"value": {
"amount": 475000.0,
"valueAddedTaxIncluded": false,
"currency": "UAH"
},
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"lotID": "5740fe669c0546188adff1c8c9b0aa58",
"id": "c41959de1f2c4c9086d1ee34dc990c11",
"date": "2023-10-10T01:00:00+03:00"
}
}
Визначення переможця для переговорної процедури за нагальною потребою також має запис complaintPeriod із полем startDate.
Завантаження документів щодо визначення переможця
Завантажувати документи щодо визначення переможця можна лише до того, як рішення про визначення переможця буде підтверджено. Спробуємо додати такий документ:
Request
POST /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11/documents?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "award_first_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a150b81d16504ae88167cb5c3cec719f?Signature=%2FHNjmOyAxIbAMh127UziLYrtgWYyjQjuNPeyQCWfv29uMghJ7jnlr3qOS8y3W2mf58GIDfTRPWR4PXUvYpTADQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11/documents/531bebcd7513437fae759167b2d03c38
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "award_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a150b81d16504ae88167cb5c3cec719f?Signature=VyqNcmitdo%2BX1ROzZI%2BCiQeLLKhcAI6HyxGzEY%2B8MLH1k%2FV6%2BGyLywy3C8rwBiRTWU2cJK8Csm4tIv7OkwMvCA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "531bebcd7513437fae759167b2d03c38",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ додано.
Переглянемо документи пов’язані із визначенням переможця:
Request
GET /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11/documents?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "award_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a150b81d16504ae88167cb5c3cec719f?Signature=VyqNcmitdo%2BX1ROzZI%2BCiQeLLKhcAI6HyxGzEY%2B8MLH1k%2FV6%2BGyLywy3C8rwBiRTWU2cJK8Csm4tIv7OkwMvCA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "531bebcd7513437fae759167b2d03c38",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner"
}
]
}
Тепер спробуємо додати ще один документ щодо визначення переможця:
Request
POST /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11/documents?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "award_second_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4b2e689a0efb48e09297e8f0781145df?Signature=uyIJ%2BTHvo4UBjeSRy0rzQ%2Fz8YImMzAjg8kZyCdYnrvb%2F5VI1CL55osX%2B43BuScH%2B85zRVCZXE%2BpWy5xfChT7AA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11/documents/49c212b8eac34727a41266b9e3e01445
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "award_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4b2e689a0efb48e09297e8f0781145df?Signature=0K0looxslsU82Br8cYEXz%2BfTVToPT1EghT2hkvYmOjQEXndfnbeD%2BYMkV5jHBzmhrM9WTCuD%2BG5auL%2FLjydTAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "49c212b8eac34727a41266b9e3e01445",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що ще один документ було додано.
Тепер переглянемо знову усі документи пов’язані із визначенням переможця:
Request
GET /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11/documents?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "award_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a150b81d16504ae88167cb5c3cec719f?Signature=VyqNcmitdo%2BX1ROzZI%2BCiQeLLKhcAI6HyxGzEY%2B8MLH1k%2FV6%2BGyLywy3C8rwBiRTWU2cJK8Csm4tIv7OkwMvCA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "531bebcd7513437fae759167b2d03c38",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "award_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4b2e689a0efb48e09297e8f0781145df?Signature=0K0looxslsU82Br8cYEXz%2BfTVToPT1EghT2hkvYmOjQEXndfnbeD%2BYMkV5jHBzmhrM9WTCuD%2BG5auL%2FLjydTAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "49c212b8eac34727a41266b9e3e01445",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner"
}
]
}
Підтвердження переможця процедури
Кваліфікаційна комісія може винести рішення по переможцю або відхилити award - перевести авард в active або unsuccessful статус.
Валідація значення полів відповідно до рішення під час винесення рішення:
qualified: True - при переході award з pending в active
qualified: False - при переході award з pending в unsuccessful
Спробуємо відхилити авард для qualified учасника:
Request
PATCH /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful",
"qualified": true
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "qualified",
"description": [
"Can't update award to unsuccessful status when qualified/eligible isn't set to False"
]
}
]
}
Спробуємо винести рішення по переможцю по аварду для non-qualified учасника:
Request
PATCH /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": false
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "qualified",
"description": [
"Can't update award to active status with not qualified"
]
}
]
}
Для reporting процедур файл підпису авардів не вимагається.
Замовник повинен підтвердити своє рішення про визначення переможця:
Request
PATCH /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "c41959de1f2c4c9086d1ee34dc990c11",
"qualified": true,
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"documents": [
{
"confidentiality": "public",
"id": "531bebcd7513437fae759167b2d03c38",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "award_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a150b81d16504ae88167cb5c3cec719f?Signature=VyqNcmitdo%2BX1ROzZI%2BCiQeLLKhcAI6HyxGzEY%2B8MLH1k%2FV6%2BGyLywy3C8rwBiRTWU2cJK8Csm4tIv7OkwMvCA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"id": "49c212b8eac34727a41266b9e3e01445",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "award_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4b2e689a0efb48e09297e8f0781145df?Signature=0K0looxslsU82Br8cYEXz%2BfTVToPT1EghT2hkvYmOjQEXndfnbeD%2BYMkV5jHBzmhrM9WTCuD%2BG5auL%2FLjydTAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
}
}
],
"value": {
"amount": 475000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
}
Підтвердження визначення переможця для переговорної процедури
Перед прийняттям рішення по переможцю необхідно обов’язково додати файл підпису до аварду. Якщо такого документу нема, під час активації буде помилка:
Request
PATCH /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'notice' and format pkcs7-signature is required"
}
]
}
Така сама логіка при відхилені аварду:
Request
PATCH /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful",
"qualified": false
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'notice' and format pkcs7-signature is required"
}
]
}
Файл підпису має тип документу documentType: notice та розширення title: *.p7s. Додамо файл підпису:
Request
POST /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11/documents?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "sign.p7s",
"documentType": "notice",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/090eb78164424bc3a6a8ef1a626b3d2b?Signature=2eulDcupRvq2nXr3ay2coQq8cIFx9dMqK8LTLYUdjYd7CDliTNfatdfm0E1St%2FXlYGgVvFzZIe2OXhYws1uRAQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "sign/pkcs7-signature"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11/documents/9acc1426ce58426283fcc58ebea1e8e7
{
"data": {
"confidentiality": "public",
"documentType": "notice",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/090eb78164424bc3a6a8ef1a626b3d2b?Signature=B6%2BcFjyOPTR4c462I8pPvrco92DE%2FASdfjMCJf1Io%2FBY0KBYvBmjMeHVzWh7644li65XKJbHJVX59GLHUGolDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "9acc1426ce58426283fcc58ebea1e8e7",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner"
}
}
Тепер замовник повинен підтвердити своє рішення про визначення переможця:
Request
PATCH /api/2.5/tenders/8690ddb7d98e43858e01a709a3b81a8a/awards/a0c7ef1744234c728ea1c8b9fc7363ea?acc_token=955ba98fce244b3aa2cd16bcdbd01e2a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "a0c7ef1744234c728ea1c8b9fc7363ea",
"qualified": true,
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 475000.0,
"valueAddedTaxIncluded": false,
"currency": "UAH"
},
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "38326da9738e4ae7880e796eeb04abad",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fdffde85b9524bf78549ab895e02e990?Signature=GcceZGUxgak3beXSrAOS4IjSV2JjlGzoesuRihD2Dnx6aMNxu4jKDUS4NWJHv2mKhO93mtTZjc1RweDpknU5CQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"lotID": "322c3eb279804f689dc9fd81edec2cdf",
"complaintPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-16T00:00:00+03:00"
}
}
}
Різниця між початковою (startDate) та кінцевою (endDate) датою запису complaintPeriod для переговорної процедури становить 10 днів.
Підтвердження визначення переможця для переговорної процедури за нагальною потребою процедури:
Request
PATCH /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/awards/c41959de1f2c4c9086d1ee34dc990c11?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "c41959de1f2c4c9086d1ee34dc990c11",
"qualified": true,
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 475000.0,
"valueAddedTaxIncluded": false,
"currency": "UAH"
},
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "9acc1426ce58426283fcc58ebea1e8e7",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/090eb78164424bc3a6a8ef1a626b3d2b?Signature=B6%2BcFjyOPTR4c462I8pPvrco92DE%2FASdfjMCJf1Io%2FBY0KBYvBmjMeHVzWh7644li65XKJbHJVX59GLHUGolDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"lotID": "5740fe669c0546188adff1c8c9b0aa58",
"complaintPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-16T00:00:00+03:00"
}
}
}
Різниця між початковою ( startDate) та кінцевою (endDate) датою запису complaintPeriod для переговорної процедури за нагальною потребою становить 5 днів.
Налаштування угоди
Усі операції над угодою перенесені до Contracting API для реєстрації даних пов’язаних з договором
Реєстрація угоди
Угода про закупівлю за процедурою звітування про укладений договір може бути зареєстрована одразу після підтвердження визначення переможця:
Request
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/c4c98ad1fd1747d0a520741575a8fc80?acc_token=876109ab3fbf46ca81bae8f2e668687a 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": "c4c98ad1fd1747d0a520741575a8fc80",
"awardID": "58b618d74671419ab1d4efc881a17538",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "active",
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2024-01-01T00:00:00+02:00"
},
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "month",
"value": {
"amount": 13.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "MON"
},
"quantity": 9.0,
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"date": "2023-01-01T00:00:01+02:00",
"documents": [
{
"id": "f0e8435850454bd0871350e0613bf938",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1066f87343c8444996cc74fa9b08ed6e?Signature=Gl7f%2BSpPCET68M9YYpjCX3P2X4B9O2k9iACh4Jlzhjur0Ugdukq1ga39ULMzp5PfzWjcx73XhVWpn%2FLGxz57BQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "2b286c9eeeab4ed888a708e8b46a5315",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/406d025b64f04b06b7c226963c495758?Signature=LC8Q3dTbC0wavOf2OfyJzV3mLWJYIjD%2BX9wxIHyuMu4YZGzWQe15Hk4GepgwHCrcZQDdg6RgTnROKzriF7ThBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"language": "uk"
}
],
"dateSigned": "2023-01-01T00:00:00+02:00",
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
}
}
]
}
}
Угода про закупівлю за переговорною процедурою може бути зареєстрована одразу після періоду очікування скарг (десятиденний період після підтвердження визначення переможця):
Request
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/c4c98ad1fd1747d0a520741575a8fc80?acc_token=876109ab3fbf46ca81bae8f2e668687a 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": "c4c98ad1fd1747d0a520741575a8fc80",
"awardID": "58b618d74671419ab1d4efc881a17538",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "active",
"value": {
"amount": 475000.0,
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amountNet": 475000.0
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedLot": "6f14b03aa0a74d42a3ec0aab60fe4e31"
}
],
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:01+02:00",
"dateSigned": "2023-01-01T00:00:01+02:00"
}
}
Угода про закупівлю для переговорної процедури за нагальною потребою може бути зареєстрована одразу після періоду очікування скарг (п’ятиденний період після підтвердження визначення переможця):
Request
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/c4c98ad1fd1747d0a520741575a8fc80?acc_token=876109ab3fbf46ca81bae8f2e668687a 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": "c4c98ad1fd1747d0a520741575a8fc80",
"awardID": "58b618d74671419ab1d4efc881a17538",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "active",
"value": {
"amount": 475000.0,
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amountNet": 475000.0
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedLot": "9e84d29f3b604a73b10a26caf8f4830d"
}
],
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:01+02:00",
"dateSigned": "2023-01-01T00:00:01+02:00"
}
}
Конфіденційні файли у контракті
Під час створення тендеру замовник з випадаючого списку підстав застосування звіту про договір про закупівлю у формі обирає один з пунктів (cause). У випадку застосування однієї з наведених підстав, в такому звіті мають бути приховані файли (documents), які замовник завантажує до контракту та змін до договору («documentOf»: «contract» та «documentOf»: «change»).
Документи мають бути конфіденційними якщо звіт має одну з перерахованих підстав (cause):
criticalInfrastructure
civilProtection
RNBO
naturalGas
UZ
defencePurchase
і має один з перерахованих типів документів:
contractSigned - Підписаний договір
contractAnnexe - Додатки до договору
Приховання (конфіденційність) має бути застосована для documents, у випадку застосування наведених підстав. Обов’язковим є додавання поля обґрунтування confidentialityRationale для confidentiality: buyerOnly.
Додамо документи до контракту і виставимо в полі confidentiality значення public:
Request
POST /api/2.5/contracts/fcd03c2cc2be4b7693e4c710c31582e1/documents?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": [
{
"title": "annexe.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1066f87343c8444996cc74fa9b08ed6e?Signature=nrdrAU%2BGCtJZfGTetxtS6EdxdviOv9UXfUfAj4HtTqAMKTUvBghNtS3Bb4jHopJopORW94dMYa2gN%2BKGDcEbCw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"documentType": "contractAnnexe",
"confidentiality": "public"
},
{
"title": "schedule.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/406d025b64f04b06b7c226963c495758?Signature=JWkZ9wLsiUDWNqJpls1kj7VS%2F1Jp%2B2wkExSIs6jw1s80itwJZ1YRxdyJXWSEnkvgDPYP7eRJMfcXDO2v424KDg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"documentType": "contractSchedule",
"confidentiality": "public"
}
]
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "confidentiality",
"description": "Document should be confidential"
}
]
}
Змінимо confidentiality на buyerOnly і подивимося, що ми маємо:
Request
POST /api/2.5/contracts/fcd03c2cc2be4b7693e4c710c31582e1/documents?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": [
{
"title": "annexe.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a0b82a5d4bb64c1693b6c5355775df0e?Signature=RhoG4qWpdg2yysEF%2FFBJm%2FgFJ2noZjsv339p310dwG61WFZ9V50j50ST%2BQEy6Bubg0AF%2B6UyokV23HRPqRNFCw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"documentType": "contractAnnexe",
"confidentiality": "buyerOnly"
},
{
"title": "schedule.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ecc3ab92f6645229105fb6c304564b9?Signature=NxlxQfzc50aYeKVMJyMIpq1M9%2BqZS5vssmXeuh3sEVFG2f3ElcQczyHmVFwfbWJh1uqH5JNiogy4ZjiZBtPvAQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"documentType": "contractSchedule",
"confidentiality": "public"
}
]
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "confidentialityRationale",
"description": [
"confidentialityRationale is required"
]
}
]
}
Додамо поле обґрунтування confidentialityRational:
Request
POST /api/2.5/contracts/fcd03c2cc2be4b7693e4c710c31582e1/documents?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": [
{
"title": "annexe.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6867c78ea3ec4ca68a9bf8c374110b6a?Signature=wkAO6azST3xNjT9ls3ELhISFlLZAoQNv3rxBRtrY3M9x9Lyw%2BUks2xPGteIYSILdTXoJZVsCSTdAC2R%2Bu6JtCQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"documentType": "contractAnnexe",
"confidentiality": "buyerOnly",
"confidentialityRationale": "Файл буде оприлюднено в електронній системі закупівель через 90 днів з дня припинення або скасування правового режиму воєнного стану в Україні відповідно до п 13, пп 21 Постанови 1178"
},
{
"title": "schedule.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f6128c1ec7ec4a4fa560a93aff6aa320?Signature=JaCaYMPgcgfGz113y1c6rOFIQqS16bEPOaLmTisBp%2BJLarsflKtCsWLAGcuFKJqwR%2BBX%2BKMUHe4s30zzF3sPDA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"documentType": "contractSchedule"
}
]
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": [
{
"confidentiality": "buyerOnly",
"confidentialityRationale": "Файл буде оприлюднено в електронній системі закупівель через 90 днів з дня припинення або скасування правового режиму воєнного стану в Україні відповідно до п 13, пп 21 Постанови 1178",
"documentType": "contractAnnexe",
"hash": "md5:00000000000000000000000000000000",
"title": "annexe.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/fcd03c2cc2be4b7693e4c710c31582e1/documents/ebe4734e4a17475e88272a8ca9c4642e?download=6867c78ea3ec4ca68a9bf8c374110b6a",
"documentOf": "contract",
"id": "ebe4734e4a17475e88272a8ca9c4642e",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"documentType": "contractSchedule",
"hash": "md5:00000000000000000000000000000000",
"title": "schedule.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f6128c1ec7ec4a4fa560a93aff6aa320?Signature=2CcIMWWPeGFa2oO8dCQYukxJzTxQhzkuQfv47W4evs33aUArp52w9AL2RAbgjIxJfQ%2F6P5OZWbPTTZ0VMGGlCA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "8c1e5e8d65904044950d089deec7a55d",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
Власник звіту бачить такі документи і може завантажиити їх:
Request
GET /api/2.5/contracts/fcd03c2cc2be4b7693e4c710c31582e1/documents/ebe4734e4a17475e88272a8ca9c4642e?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "buyerOnly",
"confidentialityRationale": "Файл буде оприлюднено в електронній системі закупівель через 90 днів з дня припинення або скасування правового режиму воєнного стану в Україні відповідно до п 13, пп 21 Постанови 1178",
"documentType": "contractAnnexe",
"hash": "md5:00000000000000000000000000000000",
"title": "annexe.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/fcd03c2cc2be4b7693e4c710c31582e1/documents/ebe4734e4a17475e88272a8ca9c4642e?download=6867c78ea3ec4ca68a9bf8c374110b6a",
"documentOf": "contract",
"id": "ebe4734e4a17475e88272a8ca9c4642e",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Всі інші користувачі не можуть переглянути документ:
Request
GET /api/2.5/contracts/fcd03c2cc2be4b7693e4c710c31582e1/documents/ebe4734e4a17475e88272a8ca9c4642e HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "buyerOnly",
"confidentialityRationale": "Файл буде оприлюднено в електронній системі закупівель через 90 днів з дня припинення або скасування правового режиму воєнного стану в Україні відповідно до п 13, пп 21 Постанови 1178",
"documentType": "contractAnnexe",
"hash": "md5:00000000000000000000000000000000",
"title": "annexe.doc",
"format": "application/msword",
"documentOf": "contract",
"id": "ebe4734e4a17475e88272a8ca9c4642e",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Ніхто окрім власника звіту не може викачати документ:
Request
GET /api/2.5/contracts/fcd03c2cc2be4b7693e4c710c31582e1/documents/ebe4734e4a17475e88272a8ca9c4642e?download=1 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Document download forbidden."
}
]
}
Скасування закупівлі
Замовник може скасувати закупівлю у будь-який момент (крім закупівель у статусі active.auction чи у кінцевому стані, наприклад, usuccesfull, canceled, complete).
Для цього потрібно виконати наступні кроки:
Приготуйте запит на скасування
Заповніть його протоколом про причини скасування
Проходження періоду оскарження(триває 10 днів), тільки для negotiation та negotiation.quick
Скасуйте закупівлю через подані причини.
Запит на скасування, який не пройшов активації (4-й крок), не матиме сили, тобто, для скасування закупівлі буде обов’язковим не тільки створити заявку, але і активувати її.
Для відміни скасування закупівлі, вам потрібно оновоить статус скасування до unsuccessful з draft чи pending.
Див. структуру запиту Cancellation для більш детальної інформації.
Формування запиту на скасування для reporting процедури
Ви повинні передати змінні reason та reasonType, status у стані draft.
При скасуванні, замовник має визначити один з чотирьох типів reasonType: noDemand, unFixable, forceMajeure aбо expensesCut.
id генерується автоматично і повертається у додатковому заголовку відповіді Location.
Request
POST /api/2.5/tenders/8690ddb7d98e43858e01a709a3b81a8a/cancellations?acc_token=955ba98fce244b3aa2cd16bcdbd01e2a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reason": "cancellation reason",
"reasonType": "noDemand"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/8690ddb7d98e43858e01a709a3b81a8a/cancellations/fb5a1d901e0f4ac0a73bae6f0d7cc312
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "fb5a1d901e0f4ac0a73bae6f0d7cc312",
"date": "2023-10-10T01:00:00+03:00",
"cancellationOf": "tender",
"status": "draft"
}
}
Ви можете виправити тип на будь-який що вказаний вище.
Request
PATCH /api/2.5/tenders/8690ddb7d98e43858e01a709a3b81a8a/cancellations/fb5a1d901e0f4ac0a73bae6f0d7cc312?acc_token=955ba98fce244b3aa2cd16bcdbd01e2a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "unFixable"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "fb5a1d901e0f4ac0a73bae6f0d7cc312",
"status": "draft",
"date": "2023-10-10T01:00:00+03:00",
"reasonType": "unFixable",
"reason": "cancellation reason",
"cancellationOf": "tender"
}
}
Формування запиту на скасування для negotiation та negotiation.quick процедури
При скасуванні, замовник має визначити один з п’яти типів reasonType: noObjectiveness, unFixable, noDemand, expensesCut та dateViolation.
Request
POST /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/cancellations?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reason": "cancellation reason",
"reasonType": "noDemand"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/cancellations/7d78c621c00a4dfc8e5a047a816d1d7e
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "7d78c621c00a4dfc8e5a047a816d1d7e",
"date": "2023-10-10T01:00:00+03:00",
"cancellationOf": "tender",
"status": "draft"
}
}
Ви можете виправити тип на будь-який що вказаний вище.
Request
PATCH /api/2.5/tenders/f082eef1f646440d9089b9620ea0bb9a/cancellations/7d78c621c00a4dfc8e5a047a816d1d7e?acc_token=876109ab3fbf46ca81bae8f2e668687a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "dateViolation"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "7d78c621c00a4dfc8e5a047a816d1d7e",
"status": "draft",
"date": "2023-10-10T01:00:00+03:00",
"reasonType": "dateViolation",
"reason": "cancellation reason",
"cancellationOf": "tender"
}
}
Наповнення протоколом та іншою супровідною документацією
Цей крок обов’язковий. Без документів ви не можете оновити статус скарги.
Завантажте зміст файлу
Request
POST /api/2.5/tenders/8690ddb7d98e43858e01a709a3b81a8a/cancellations/fb5a1d901e0f4ac0a73bae6f0d7cc312/documents?acc_token=955ba98fce244b3aa2cd16bcdbd01e2a 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/7fa03a13dbf6411795e3b66e2f7edf25?Signature=TSLHPtmfDVEzQlOSJx%2FBofzvmpp6BP85dszKQ449iIBWW8PiaP%2BuBFBkzOQbiSSnnoP2Cj89UpQ%2BgapTVGhjDQ%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/tenders/8690ddb7d98e43858e01a709a3b81a8a/cancellations/fb5a1d901e0f4ac0a73bae6f0d7cc312/documents/083738bcfed44477a187e51111718a60
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7fa03a13dbf6411795e3b66e2f7edf25?Signature=L8SCr%2FQ%2BxxunDlxi3Bq%2BUtFIUxx0O64ZDT0CDN%2BVjXJX4YMajFNydQodnZ%2F2RTRx8kB9WuR0Jhm39R%2BxEEzRBQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "083738bcfed44477a187e51111718a60",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Якщо потрібно, змініть опис документа та інші властивості
Request
PATCH /api/2.5/tenders/8690ddb7d98e43858e01a709a3b81a8a/cancellations/fb5a1d901e0f4ac0a73bae6f0d7cc312/documents/083738bcfed44477a187e51111718a60?acc_token=955ba98fce244b3aa2cd16bcdbd01e2a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"description": "Changed description"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"description": "Changed description",
"id": "083738bcfed44477a187e51111718a60",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7fa03a13dbf6411795e3b66e2f7edf25?Signature=L8SCr%2FQ%2BxxunDlxi3Bq%2BUtFIUxx0O64ZDT0CDN%2BVjXJX4YMajFNydQodnZ%2F2RTRx8kB9WuR0Jhm39R%2BxEEzRBQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
}
}
Завантажте нову версію документа
Request
PUT /api/2.5/tenders/8690ddb7d98e43858e01a709a3b81a8a/cancellations/fb5a1d901e0f4ac0a73bae6f0d7cc312/documents/083738bcfed44477a187e51111718a60?acc_token=955ba98fce244b3aa2cd16bcdbd01e2a 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/a0c4427300e148f7bab7da9806571de4?Signature=mBKQXSFDa3dyGIZFcB9NS0tfu0eoin%2BCj%2FC8fLhT8aG3XQqCfc08AZgXH61J5NKW%2BoQVkUjvpOWI9UCVYpo0DA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"description": "Changed description",
"id": "083738bcfed44477a187e51111718a60",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a0c4427300e148f7bab7da9806571de4?Signature=kwgA3NvPJw6GLrFsRHLPM49MrvPlxM0kC0wiQLr4bU85CH5WU7lLd3tU9xSBEdelARDXQNbJxoAEOjPhP%2BC5DQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
}
}
Проходження періоду оскарження(тільки для negotiation та negotiation.quick)
Для того щоб перейти до періоду оскарження потрібно змінити стаутс скасування з draft на pending.
Request
PATCH /api/2.5/tenders/8690ddb7d98e43858e01a709a3b81a8a/cancellations/fb5a1d901e0f4ac0a73bae6f0d7cc312?acc_token=955ba98fce244b3aa2cd16bcdbd01e2a HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "fb5a1d901e0f4ac0a73bae6f0d7cc312",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"reasonType": "unFixable",
"reason": "cancellation reason",
"cancellationOf": "tender",
"documents": [
{
"confidentiality": "public",
"description": "Changed description",
"id": "083738bcfed44477a187e51111718a60",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7fa03a13dbf6411795e3b66e2f7edf25?Signature=L8SCr%2FQ%2BxxunDlxi3Bq%2BUtFIUxx0O64ZDT0CDN%2BVjXJX4YMajFNydQodnZ%2F2RTRx8kB9WuR0Jhm39R%2BxEEzRBQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
},
{
"confidentiality": "public",
"description": "Changed description",
"id": "083738bcfed44477a187e51111718a60",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a0c4427300e148f7bab7da9806571de4?Signature=kwgA3NvPJw6GLrFsRHLPM49MrvPlxM0kC0wiQLr4bU85CH5WU7lLd3tU9xSBEdelARDXQNbJxoAEOjPhP%2BC5DQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
}
],
"complaintPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-21T00:00:00+03:00"
}
}
}
Коли скасування закупівлі в статусі pending замовнику зобороняються всі дії по закупівлі.
Активація запиту та скасування закупівлі
Якщо період оскарження(триває 10 днів) скінчився та не було ніяких скарг на скасування закупівлі або скарги були скасовані, то скасування автоматично зміює статус на active.