Туторіал
Конфігурація
Набір можливих значень конфігурації:
name |
values |
default |
days |
|---|---|---|---|
hasAuction |
true / false |
false |
|
hasAwardingOrder |
true / false |
false |
|
hasValueRestriction |
true / false |
false |
|
valueCurrencyEquality |
true / false |
false |
|
hasPrequalification |
true / false |
false |
|
minBidsNumber |
1 - 9 |
1 |
|
hasPreSelectionAgreement |
true / false |
false |
|
hasTenderComplaints |
false |
false |
|
hasAwardComplaints |
false |
false |
|
hasCancellationComplaints |
false |
false |
|
hasValueEstimation |
true / false |
false |
|
hasQualificationComplaints |
false |
false |
|
tenderComplainRegulation |
0 |
0 |
|
qualificationComplainDuration |
10 |
working |
|
awardComplainDuration |
2 |
2 |
|
cancellationComplainDuration |
0 |
0 |
|
clarificationUntilDuration |
4 |
4 |
calendar |
qualificationDuration |
20 |
20 |
|
minTenderingDuration |
4 |
4 |
calendar |
hasEnquiries |
true |
true |
|
minEnquiriesDuration |
3 |
3 |
calendar |
enquiryPeriodRegulation |
3 |
3 |
calendar |
restricted |
false |
false |
Ви можете ознайомитись з деталями в секції Конфігурація.
Закупівля з контролером
Ви можете отримати інформацію тут: Туторіал Закупівля з контролером
Створення закупівлі
Для тендеру requestForProposal замовник може зазначити, що був попередній відбір учасників та вказати id agreement.
Використаємо agreement для прикладу:
Request
GET /api/2.5/agreements/144de8e79e64488a967c57cebaacb0d3 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-10-10-000001",
"frameworkID": "5bbf44a4849d4cb8a80c469d8d91231e",
"agreementType": "internationalFinancialInstitutions",
"status": "active",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-12-03T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "general"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"contracts": [
{
"id": "0024966553564a8f812f84689d34148c",
"qualificationID": "da120b087f8c42f18d4c12b374cdf2eb",
"submissionID": "78e643e7c5c94f6c9e686ffa9c723713",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "12345678",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"email": "aa@aa.com"
}
}
],
"milestones": [
{
"id": "00464c7636ce464bb05b8504af6f9d9b",
"status": "scheduled",
"type": "activation",
"dueDate": "2024-12-03T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "71493e93a3804e8b8c23cfcc21d838cf",
"qualificationID": "93225b64f2dc409292bfe706bf11b712",
"submissionID": "73c23c0a23454500a3a406ef0b592b69",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "12345679",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"email": "aa@aa.com"
}
}
],
"milestones": [
{
"id": "f09b253e29ee403a93db4be0fc9c4d54",
"status": "scheduled",
"type": "activation",
"dueDate": "2024-12-03T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"id": "a4ff7ab0a7794f20af93e8f54678b8f6",
"qualificationID": "1de5a50bb22b483baf5812ade87f8d0a",
"submissionID": "65b9f9a60a1d4d82998ca065a810da81",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "12345671",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"email": "aa@aa.com"
}
}
],
"milestones": [
{
"id": "6cb16718fd5c44beb4a3d0fc3a6323ed",
"status": "scheduled",
"type": "activation",
"dueDate": "2024-12-03T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"owner": "broker",
"dateModified": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"next_check": "2024-12-03T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"id": "144de8e79e64488a967c57cebaacb0d3"
},
"config": {
"restricted": false
}
}
Ми можемо створити тендер, вказавши цей agreement:
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": {
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"classification": {
"scheme": "ДК021",
"id": "03111600-8",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кілограм",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T00:00:00+02:00"
},
"procurementMethodType": "requestForProposal",
"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
}
],
"contractTemplateName": "00000000.0002.01",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64
{
"data": {
"mainProcurementCategory": "goods",
"contractTemplateName": "00000000.0002.01",
"title": "футляри до державних нагород",
"status": "draft",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "0b78866cd0af4b7995fbeaa9ed101d08",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"procurementMethod": "selective",
"submissionMethod": "electronicAuction",
"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": "285d5c5b074a45f198c9a207b4c60b64"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
},
"access": {
"token": "393a491380684a1b82995ce57d50794c",
"transfer": "5908a1c84377494181d53c46db8975bc"
}
}
Успіх! Тепер ми бачимо, що новий об’єкт було створено. Код відповіді 201 та заголовок відповіді Location вказує місцерозташування створеного об’єкта. Тіло відповіді показує інформацію про створену закупівлю, її внутрішнє id (яке співпадає з сегментом Location), її офіційне tenderID та dateModified дату, що показує час, коли закупівля востаннє модифікувалась. Зверніть увагу на procurementMethodType, а також на те, що закупівля створюється зі статусом draft.
Використаємо URL створеного об’єкта (заголовок відповіді Location):
Request
GET /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"mainProcurementCategory": "goods",
"contractTemplateName": "00000000.0002.01",
"title": "футляри до державних нагород",
"status": "draft",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "0b78866cd0af4b7995fbeaa9ed101d08",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"procurementMethod": "selective",
"submissionMethod": "electronicAuction",
"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": "285d5c5b074a45f198c9a207b4c60b64"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Ми бачимо ту ж відповідь, що і після створення закупівлі.
Подивимось, що показує список закупівель:
Request
GET /api/2.5/tenders 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.enquiries
Закупівля може складатись із декількох лотів. Можна створити лот таким чином:
Request
POST /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/lots?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "lot title",
"description": "lot description",
"value": {
"amount": 500,
"currency": "UAH"
},
"minimalStep": {
"amount": 15,
"currency": "UAH"
}
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/lots/880b8274983b40cfa8455e8e3d82bb70
{
"data": {
"title": "lot title",
"description": "lot description",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"status": "active",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"date": "2023-10-10T01:00:00+03:00"
}
}
Потрібно оновити дані пов’язані із залежністю на лот:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"contractTemplateName": "00000000.0002.01",
"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",
"status": "draft",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "0b78866cd0af4b7995fbeaa9ed101d08",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00",
"endDate": "2023-10-17T00:00:00+02:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"id": "285d5c5b074a45f198c9a207b4c60b64"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Активація закупівлі
Для активації процедури потрібно перевести її статус в active.enquiries:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active.enquiries"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"contractTemplateName": "00000000.0002.01",
"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",
"status": "active.enquiries",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "0b78866cd0af4b7995fbeaa9ed101d08",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00",
"endDate": "2023-10-17T00:00:00+02:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"next_check": "2023-10-17T00:00:00+02:00",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"id": "285d5c5b074a45f198c9a207b4c60b64"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Подивимось, що показує список закупівель:
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": "285d5c5b074a45f198c9a207b4c60b64"
}
],
"next_page": {
"offset": "1696888800.0.1.5f3c207aff66d29196094fd296c9ad8a",
"path": "/api/2.5/tenders?offset=1696888800.0.1.5f3c207aff66d29196094fd296c9ad8a",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1696888800.0.1.5f3c207aff66d29196094fd296c9ad8a"
}
}
Ми бачимо внутрішнє id закупівлі (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/tenders/) та її dateModified дату.
Створення другої закупівлі
Попередня закупівля була створена лише з обов’язковими полями. Тепер додамо закупівлю з максимально допустимим набором даних при створенні (тендер повинен бути у статусі created).
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": {
"title": "футляри до державних нагород",
"title_en": "Cases with state awards",
"title_ru": "футляры к государственным наградам",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кілограм",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T00:00:00+02:00"
},
"procurementMethodType": "requestForProposal",
"mode": "test",
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"value": 0.1,
"title": "До 1000 Вт"
},
{
"value": 0.15,
"title": "Більше 1000 Вт"
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"value": 0.05,
"title": "До 3 років"
},
{
"value": 0.1,
"title": "Більше 3 років, менше 5 років"
},
{
"value": 0.15,
"title": "Більше 5 років"
}
]
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"percentage": 45.55,
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45,
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
}
],
"mainProcurementCategory": "services",
"contractTemplateName": "00000000.0002.01",
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "85459ec7097d4e0489bc373a9f039e7a",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
]
},
"config": {
"hasAuction": true,
"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": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/d9348acb91fa4dd59c3248bf74029319
{
"data": {
"mainProcurementCategory": "services",
"title_en": "[TESTING] Cases with state awards",
"title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
"contractTemplateName": "00000000.0002.01",
"title": "[ТЕСТУВАННЯ] футляри до державних нагород",
"mode": "test",
"status": "draft",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"date": "2023-10-10T01:00:00+03:00",
"id": "85459ec7097d4e0489bc373a9f039e7a",
"status": "active",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"value": 0.1,
"title": "До 1000 Вт"
},
{
"value": 0.15,
"title": "Більше 1000 Вт"
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"value": 0.05,
"title": "До 3 років"
},
{
"value": 0.1,
"title": "Більше 3 років, менше 5 років"
},
{
"value": 0.15,
"title": "Більше 5 років"
}
]
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
},
{
"id": "db46b86e200b4e97b3167cb7f3255765",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "85459ec7097d4e0489bc373a9f039e7a"
}
],
"tenderID": "UA-2023-10-10-000002-a",
"owner": "broker",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"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": "d9348acb91fa4dd59c3248bf74029319"
},
"config": {
"hasAuction": true,
"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": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
},
"access": {
"token": "c15de98e7a17408e95e488963349b713",
"transfer": "8c79c0513bb34497835251331efce717"
}
}
І знову код відповіді 201 Created, заголовок Location і тіло з додатковим id, tenderID, та властивість dateModified.
Перевіримо, що містить реєстр закупівель:
Request
GET /api/2.5/tenders 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": "285d5c5b074a45f198c9a207b4c60b64"
},
{
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "0a6891e35335413c84571febcaedd50d"
}
],
"next_page": {
"offset": "1696888800.0.2.d73c3336f234b6145fec68926a9eaf5c",
"path": "/api/2.5/tenders?offset=1696888800.0.2.d73c3336f234b6145fec68926a9eaf5c",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1696888800.0.2.d73c3336f234b6145fec68926a9eaf5c"
}
}
Дійсно, в нас зараз є дві закупівлі.
Можливо створювати закупівлю з полем funders, яке є необов’язковим:
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": {
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кілограм",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T00:00:00+02:00"
},
"procurementMethodType": "requestForProposal",
"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
}
],
"contractTemplateName": "00000000.0002.01",
"funders": [
{
"additionalIdentifiers": [],
"address": {
"countryName": "Швейцарська Конфедерація",
"locality": "Geneva",
"postalCode": "1218",
"region": "Grand-Saconnex",
"streetAddress": "Global Health Campus, Chemin du Pommier 40"
},
"contactPoint": {
"email": "ccm@theglobalfund.org",
"faxNumber": "+41 44 580 6820",
"name": "",
"telephone": "+41587911700",
"url": "https://www.theglobalfund.org/en/"
},
"identifier": {
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією",
"scheme": "XM-DAC"
},
"name": "Глобальний фонд"
}
]
},
"config": {
"hasAuction": true,
"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": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/edf794081dcd444fbd0b8cc1e31f792b
{
"data": {
"mainProcurementCategory": "goods",
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"title": "футляри до державних нагород",
"status": "draft",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "287eac32299645e58057bf526f3f67c8",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"tenderID": "UA-2023-10-10-000003-a",
"owner": "broker",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"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": "edf794081dcd444fbd0b8cc1e31f792b"
},
"config": {
"hasAuction": true,
"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": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
},
"access": {
"token": "4c97ef37809a4c2f9a609abb1d016459",
"transfer": "21ff86c0635d4aceb88fce04e474b6ac"
}
}
Модифікація закупівлі
Оновимо закупівлю шляхом надання їй усіх інших важливих властивостей:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-25T01:00:11+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"status": "active.enquiries",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"next_check": "2023-10-17T00:00:00+02:00",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-25T01:00:11+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "0b78866cd0af4b7995fbeaa9ed101d08",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00",
"endDate": "2023-10-17T00:00:00+02:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"id": "285d5c5b074a45f198c9a207b4c60b64"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"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": "0a6891e35335413c84571febcaedd50d"
},
{
"dateModified": "2023-10-10T01:00:01+03:00",
"id": "285d5c5b074a45f198c9a207b4c60b64"
}
],
"next_page": {
"offset": "1696888801.0.1.5f3c207aff66d29196094fd296c9ad8a",
"path": "/api/2.5/tenders?offset=1696888801.0.1.5f3c207aff66d29196094fd296c9ad8a",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1696888801.0.1.5f3c207aff66d29196094fd296c9ad8a"
}
}
Замовник може встановити забезпечення тендерної пропозиції:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"guarantee": {
"amount": 8,
"currency": "USD"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"status": "active.enquiries",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"guarantee": {
"amount": 8.0,
"currency": "USD"
},
"next_check": "2023-10-17T00:00:00+02:00",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-25T01:00:11+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "0b78866cd0af4b7995fbeaa9ed101d08",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00",
"endDate": "2023-10-17T00:00:00+02:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"id": "285d5c5b074a45f198c9a207b4c60b64"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Також можна оновлювати закупівлю шляхом додавання поля funders:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"funders": [
{
"additionalIdentifiers": [],
"address": {
"countryName": "Швейцарська Конфедерація",
"locality": "Geneva",
"postalCode": "1218",
"region": "Grand-Saconnex",
"streetAddress": "Global Health Campus, Chemin du Pommier 40"
},
"contactPoint": {
"email": "ccm@theglobalfund.org",
"faxNumber": "+41 44 580 6820",
"name": "",
"telephone": "+41587911700",
"url": "https://www.theglobalfund.org/en/"
},
"identifier": {
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією",
"scheme": "XM-DAC"
},
"name": "Глобальний фонд"
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"status": "active.enquiries",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"next_check": "2023-10-17T00:00:00+02:00",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-25T01:00:11+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "0b78866cd0af4b7995fbeaa9ed101d08",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00",
"endDate": "2023-10-17T00:00:00+02:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"id": "285d5c5b074a45f198c9a207b4c60b64"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Замовник не може редагувати tenderPeriod.endDate, якщо залишилось менше 4 днів до завершення періоду подання пропозицій. API таких змін не прийме.
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 501.0
},
"tenderPeriod": {
"endDate": "2023-10-18T01:10:05+03:00"
}
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "tenderPeriod should be extended by 4 days"
}
]
}
Ось чому потрібно продовжити період подання пропозицій (tenderPeriod) на мінімум 4 дні.
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 501,
"currency": "UAH"
},
"tenderPeriod": {
"endDate": "2023-10-21T01:10:05+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-16T01:14:06+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"questions": [
{
"id": "18aed6d02f154d56b9784733349f80f0",
"author": {
"hash": "1aed9a553aa8fab0177d7427516aa4fe"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"date": "2023-10-10T01:10:05+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"questionOf": "tender",
"dateAnswered": "2023-10-10T01:10:05+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc867212802644aea197d58690d3ba5a?Signature=MtSkXRos1yrfdfBsgMVs8NAB4Wh%2F3OPVOFqVj5MdI%2BUj6iyTIMVI7fe6VbiXH3hp71yoRH90hxn6jwSEUdesDQ%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:06:04+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c9a7351bbd9c4577b75310df27591499?Signature=MunTW%2BVyETXx31v93sGhr6mh73PISFITfTGZpi50QbReHquPGEuZi04vK%2F9JcE45YC5McBK17PE%2FTSY6U%2FB%2BAQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:06:04+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:10:05+03:00",
"hash": "md5:11111111111111111111111111111111",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/56b3816a95d94faa973fdac01b15d17f?Signature=OwaEFJzrubfVGiEJjno3o6fbkaDy8WMg0aIbV29ps0%2FiV7Eu7ggkxhTP0bldt05cfWWqeVZRCMyMceYRFqfvAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:10:05+03:00",
"author": "tender_owner",
"language": "en"
}
],
"status": "active.tendering",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"guarantee": {
"amount": 8.0,
"currency": "USD"
},
"next_check": "2023-10-21T01:10:05+03:00",
"tenderPeriod": {
"startDate": "2023-10-10T01:10:05+03:00",
"endDate": "2023-10-21T01:10:05+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"auctionPeriod": {
"shouldStartAfter": "2023-10-22T00:00:00+03:00",
"startDate": "2023-10-23T13:09:55.701000+03:00"
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "0b78866cd0af4b7995fbeaa9ed101d08",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-09-30T01:10:05+03:00",
"clarificationsUntil": "2023-10-15T00:00:00+03:00",
"endDate": "2023-10-10T01:10:05+03:00",
"invalidationDate": "2023-10-16T01:14:06+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"id": "285d5c5b074a45f198c9a207b4c60b64"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Завантаження документації
Замовник може завантажити PDF файл у створену закупівлю. Завантаження повинно відбуватись згідно правил Завантаження документів.
Request
POST /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/documents?acc_token=393a491380684a1b82995ce57d50794c 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/dc867212802644aea197d58690d3ba5a?Signature=d6kzpGzA9Uq3abfjv6%2FGYikAYH%2BXyAnEuKyIZFPe0uOGEO%2FvuEtx7qUokKIDo%2Fq0jT%2BYpJoAAUMZPYQsoHabAw%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/285d5c5b074a45f198c9a207b4c60b64/documents/0eb8412a31bf4fb495e2d50c6a0876d5
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc867212802644aea197d58690d3ba5a?Signature=MtSkXRos1yrfdfBsgMVs8NAB4Wh%2F3OPVOFqVj5MdI%2BUj6iyTIMVI7fe6VbiXH3hp71yoRH90hxn6jwSEUdesDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"dateModified": "2023-10-10T01:00:01+03:00",
"author": "tender_owner"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
Request
GET /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/documents/0eb8412a31bf4fb495e2d50c6a0876d5 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": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc867212802644aea197d58690d3ba5a?Signature=MtSkXRos1yrfdfBsgMVs8NAB4Wh%2F3OPVOFqVj5MdI%2BUj6iyTIMVI7fe6VbiXH3hp71yoRH90hxn6jwSEUdesDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"dateModified": "2023-10-10T01:00:01+03:00",
"author": "tender_owner"
}
}
Додамо нове поле documentType з параметром technicalSpecifications до вже завантаженого документа.
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/documents/0eb8412a31bf4fb495e2d50c6a0876d5?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentType": "technicalSpecifications"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"documentType": "technicalSpecifications",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc867212802644aea197d58690d3ba5a?Signature=MtSkXRos1yrfdfBsgMVs8NAB4Wh%2F3OPVOFqVj5MdI%2BUj6iyTIMVI7fe6VbiXH3hp71yoRH90hxn6jwSEUdesDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:01:02+03:00",
"author": "tender_owner",
"language": "uk"
}
}
Успіх! Код відповіді 200 OK підтверджує, що поле documentType з параметром technicalSpecifications було додано.
Ось основний перелік полів, які можна змінити для документа.
documentOf
language
documentType
title
title_en
description
description_en
format
relatedItem
Ми можемо змінити декілька з них:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/documents/0eb8412a31bf4fb495e2d50c6a0876d5?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice.doc",
"format": "application/msword",
"description": "змінений опис документа",
"description_en": "document description modified",
"documentOf": "item",
"relatedItem": "ffffffffffffffffffffffffffffffff"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc867212802644aea197d58690d3ba5a?Signature=MtSkXRos1yrfdfBsgMVs8NAB4Wh%2F3OPVOFqVj5MdI%2BUj6iyTIMVI7fe6VbiXH3hp71yoRH90hxn6jwSEUdesDQ%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
}
}
Ви могли помітити що dateModified оновлюється при зміні інформації про документ.
Один елемент масиву описує завантажений документ. Ми можемо завантажити більше документів:
Request
POST /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/documents?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "AwardCriteria.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c9a7351bbd9c4577b75310df27591499?Signature=SZquYEeYbOSZghUqDe25awbv2Gt8iq9l2WKPXdRJNUSblNtawx8cGdBqr8awPgchjhlJxF9Se1QtpsvOG7lKAA%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/285d5c5b074a45f198c9a207b4c60b64/documents/fc20014ad6434b7b93c655c13b2f699a
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c9a7351bbd9c4577b75310df27591499?Signature=MunTW%2BVyETXx31v93sGhr6mh73PISFITfTGZpi50QbReHquPGEuZi04vK%2F9JcE45YC5McBK17PE%2FTSY6U%2FB%2BAQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:06:04+03:00",
"dateModified": "2023-10-10T01:06:04+03:00",
"author": "tender_owner"
}
}
І знову можна перевірити, що є два завантажених документа.
Request
GET /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/documents 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",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc867212802644aea197d58690d3ba5a?Signature=MtSkXRos1yrfdfBsgMVs8NAB4Wh%2F3OPVOFqVj5MdI%2BUj6iyTIMVI7fe6VbiXH3hp71yoRH90hxn6jwSEUdesDQ%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c9a7351bbd9c4577b75310df27591499?Signature=MunTW%2BVyETXx31v93sGhr6mh73PISFITfTGZpi50QbReHquPGEuZi04vK%2F9JcE45YC5McBK17PE%2FTSY6U%2FB%2BAQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:06:04+03:00",
"dateModified": "2023-10-10T01:06:04+03:00",
"author": "tender_owner"
}
]
}
Раніше ми оновлювали деталі документа. Також можливо змінити сам (файл) документ. Для цього ми можемо завантажити нову версію:
Request
PUT /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/documents/fc20014ad6434b7b93c655c13b2f699a?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "AwardCriteria.pdf",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/56b3816a95d94faa973fdac01b15d17f?Signature=s5o%2FpywpaaEFoqaBBEsSCGljB1Ho2flS7SI2ou0%2BJ5SFmT5hBtbSEGrSo31QHajXsLeCyB7D00v%2Fn7szgQh7Ag%3D%3D&KeyID=a8968c46",
"hash": "md5:11111111111111111111111111111111",
"format": "application/pdf",
"language": "en"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:10:05+03:00",
"hash": "md5:11111111111111111111111111111111",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/56b3816a95d94faa973fdac01b15d17f?Signature=OwaEFJzrubfVGiEJjno3o6fbkaDy8WMg0aIbV29ps0%2FiV7Eu7ggkxhTP0bldt05cfWWqeVZRCMyMceYRFqfvAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:10:05+03:00",
"author": "tender_owner",
"language": "en"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
Request
GET /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/documents 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",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc867212802644aea197d58690d3ba5a?Signature=MtSkXRos1yrfdfBsgMVs8NAB4Wh%2F3OPVOFqVj5MdI%2BUj6iyTIMVI7fe6VbiXH3hp71yoRH90hxn6jwSEUdesDQ%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:10:05+03:00",
"hash": "md5:11111111111111111111111111111111",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/56b3816a95d94faa973fdac01b15d17f?Signature=OwaEFJzrubfVGiEJjno3o6fbkaDy8WMg0aIbV29ps0%2FiV7Eu7ggkxhTP0bldt05cfWWqeVZRCMyMceYRFqfvAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:10:05+03:00",
"author": "tender_owner",
"language": "en"
}
]
}
Зауважте, що datePublished поле також було змінено. Воно пов’язано з файлом документа і вказує на момент його додавання.
Є можливість переглянути всі версії усіх документів. Для цього використайте ?all=1 параметр.
Request
GET /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/documents?all=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": [
{
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc867212802644aea197d58690d3ba5a?Signature=MtSkXRos1yrfdfBsgMVs8NAB4Wh%2F3OPVOFqVj5MdI%2BUj6iyTIMVI7fe6VbiXH3hp71yoRH90hxn6jwSEUdesDQ%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c9a7351bbd9c4577b75310df27591499?Signature=MunTW%2BVyETXx31v93sGhr6mh73PISFITfTGZpi50QbReHquPGEuZi04vK%2F9JcE45YC5McBK17PE%2FTSY6U%2FB%2BAQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:06:04+03:00",
"dateModified": "2023-10-10T01:06:04+03:00",
"author": "tender_owner"
},
{
"confidentiality": "public",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:10:05+03:00",
"hash": "md5:11111111111111111111111111111111",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/56b3816a95d94faa973fdac01b15d17f?Signature=OwaEFJzrubfVGiEJjno3o6fbkaDy8WMg0aIbV29ps0%2FiV7Eu7ggkxhTP0bldt05cfWWqeVZRCMyMceYRFqfvAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:10:05+03:00",
"author": "tender_owner",
"language": "en"
}
]
}
У відповіді ми бачимо одну версію Notice документа і дві версії AwardCriteria документа. Обидві версії мають однакове значення id поля, але різні для datePublished. Вони вказують на час додавання цих версій.
Зауважте, поля datePublished та dateModified дорівнюють одне одному.
Також зверніть увагу поля з інформацією про документ, що можна змінювати, - title, language, description і тд. Всі вони застосовані до нової версії. Попередня версія зберігає свої значення.
Уточнення
Коли закупівля має статус active.enquiry, зацікавлені сторони можуть подавати звернення:
Request
POST /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/questions HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"author": {
"address": {
"countryName": "Україна",
"locality": "м. Львів",
"postalCode": "79013",
"region": "Львівська область",
"streetAddress": "вул. Островського, 34"
},
"contactPoint": {
"email": "aagt@gmail.com",
"name": "Андрій Олексюк",
"telephone": "+380322916930"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
"id": "12345678",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»"
},
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/questions/18aed6d02f154d56b9784733349f80f0
{
"data": {
"author": {
"hash": "1aed9a553aa8fab0177d7427516aa4fe"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"questionOf": "tender",
"id": "18aed6d02f154d56b9784733349f80f0",
"date": "2023-10-10T01:10:05+03:00"
}
}
Замовник може на них відповісти:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/questions/18aed6d02f154d56b9784733349f80f0?acc_token=393a491380684a1b82995ce57d50794c HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "18aed6d02f154d56b9784733349f80f0",
"author": {
"hash": "1aed9a553aa8fab0177d7427516aa4fe"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"date": "2023-10-10T01:10:05+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"questionOf": "tender",
"dateAnswered": "2023-10-10T01:10:05+03:00"
}
}
Можна отримати список запитань:
Request
GET /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/questions HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "18aed6d02f154d56b9784733349f80f0",
"author": {
"hash": "1aed9a553aa8fab0177d7427516aa4fe"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"date": "2023-10-10T01:10:05+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"questionOf": "tender",
"dateAnswered": "2023-10-10T01:10:05+03:00"
}
]
}
та окрему відповідь:
Request
GET /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/questions/18aed6d02f154d56b9784733349f80f0 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "18aed6d02f154d56b9784733349f80f0",
"author": {
"hash": "1aed9a553aa8fab0177d7427516aa4fe"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"date": "2023-10-10T01:10:05+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"questionOf": "tender",
"dateAnswered": "2023-10-10T01:10:05+03:00"
}
}
Реєстрація пропозиції
Покроковий режим реєстрації
Коли приходить Tender.tenderingPeriod.startDate, Закупівля отримує статус active.tendering, що дозволяє реєстрацію пропозицій.
Учасник може зареєструвати пропозицію для лота №1 у статусі draft (чернетка):
Request
POST /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21100",
"region": "Вінницька область",
"streetAddress": "вул. Островського, 33"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"name": "Сергій Олексюк",
"telephone": "+380432216930"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "12345678",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"status": "draft",
"items": [
{
"quantity": 5,
"description": "папір",
"id": "ffffffffffffffffffffffffffffffff",
"unit": {
"code": "KGM",
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
}
}
],
"lotValues": [
{
"value": {
"amount": 500
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/4723f26e27044daebdc065be7140e59c
{
"data": {
"tenderers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "12345678",
"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": "Статут компанії"
}
}
],
"lotValues": [
{
"status": "pending",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-16T01:14:06+03:00"
}
],
"status": "draft",
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
],
"id": "4723f26e27044daebdc065be7140e59c",
"date": "2023-10-16T01:14:06+03:00"
},
"access": {
"token": "86498b9bd8114fe6b3874ac2340bf614",
"transfer": "0cbbbe0b37a14661a9d0b999b526149a"
}
}
Після цього учасник має підтвердити пропозицію, перевівши у pending статус. Якщо учасник резидент (tenderers.identifier.scheme = „UA-EDR“), то перед підтвердженням пропозиції він має накласти електронний підпис. Якщо файлу підписа не знайдено під час підтвердження, буде наступна помилка:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/4723f26e27044daebdc065be7140e59c?acc_token=86498b9bd8114fe6b3874ac2340bf614 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'proposal' and format pkcs7-signature is required"
}
]
}
Файл підпису має тип документу documentType: proposal та розширення title: *.p7s. Додамо файл підпису:
Request
POST /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/4723f26e27044daebdc065be7140e59c/documents?acc_token=86498b9bd8114fe6b3874ac2340bf614 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Proposal.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7ccd8d40fc3e4a74beb969f8949c8d67?Signature=1814KVliHPefag%2F6LHsyrJOqSNSazOtnURe0tGcjdKlz2BNKTPQT25vVSz%2FQ8mk7e947hiA7M00ODjSODtypDA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "sign/p7s",
"documentType": "proposal"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/4723f26e27044daebdc065be7140e59c/documents/4947523771de4d7ea963bb65ffd92b13
{
"data": {
"confidentiality": "public",
"documentType": "proposal",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7ccd8d40fc3e4a74beb969f8949c8d67?Signature=I1%2FWtkNS5vCIlYLjfyPEJ1udaq2k0M48c67pEHG6p0gkWp%2FQZcb5aIm7NhM2lNYwnpx3DM8LqMfi8wPIpYreDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:14:06+03:00",
"dateModified": "2023-10-16T01:14:06+03:00"
}
}
Спробуємо підтвердити пропозицію:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/4723f26e27044daebdc065be7140e59c?acc_token=86498b9bd8114fe6b3874ac2340bf614 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": {
"lotValues": [
{
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"status": "pending",
"date": "2023-10-16T01:14:06+03:00"
}
],
"tenderers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "12345678",
"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": "Статут компанії"
}
}
],
"status": "pending",
"id": "4723f26e27044daebdc065be7140e59c",
"date": "2023-10-16T01:14:06+03:00",
"documents": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:14:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7ccd8d40fc3e4a74beb969f8949c8d67?Signature=I1%2FWtkNS5vCIlYLjfyPEJ1udaq2k0M48c67pEHG6p0gkWp%2FQZcb5aIm7NhM2lNYwnpx3DM8LqMfi8wPIpYreDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:14:06+03:00",
"language": "uk"
}
],
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
],
"submissionDate": "2023-10-16T01:14:06+03:00"
}
}
Можна перевірити завантажені документи:
Request
GET /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/4723f26e27044daebdc065be7140e59c/documents?acc_token=86498b9bd8114fe6b3874ac2340bf614 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",
"documentType": "proposal",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:14:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7ccd8d40fc3e4a74beb969f8949c8d67?Signature=I1%2FWtkNS5vCIlYLjfyPEJ1udaq2k0M48c67pEHG6p0gkWp%2FQZcb5aIm7NhM2lNYwnpx3DM8LqMfi8wPIpYreDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:14:06+03:00",
"language": "uk"
}
]
}
Якщо закупівля не мультивалютна, тоді існує додаткова перевірка, що сума всіх items.unit.value не може перевищувати ціну пропозиції:
Request
POST /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21100",
"region": "Вінницька область",
"streetAddress": "вул. Островського, 33"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"name": "Сергій Олексюк",
"telephone": "+380432216930"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "12345678",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"status": "draft",
"items": [
{
"quantity": 5,
"description": "папір",
"id": "ffffffffffffffffffffffffffffffff",
"unit": {
"code": "KGM",
"value": {
"amount": 1500,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
}
}
],
"lotValues": [
{
"value": {
"amount": 500
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
]
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "items",
"description": "Total amount of unit values can't be greater than bid.lotValues.value.amount"
}
]
}
При кожному редагуванні вже поданої пропозиції, пропозиція буде переходити в статус invalid і її треба буде заново підписати:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/4723f26e27044daebdc065be7140e59c?acc_token=86498b9bd8114fe6b3874ac2340bf614 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"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": "Генеральний директор"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"lotValues": [
{
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"status": "pending",
"date": "2023-10-16T01:14:06+03:00"
}
],
"tenderers": [
{
"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": "Статут компанії"
}
}
],
"status": "invalid",
"id": "4723f26e27044daebdc065be7140e59c",
"date": "2023-10-16T01:14:06+03:00",
"submissionDate": "2023-10-16T01:14:06+03:00",
"documents": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:14:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7ccd8d40fc3e4a74beb969f8949c8d67?Signature=I1%2FWtkNS5vCIlYLjfyPEJ1udaq2k0M48c67pEHG6p0gkWp%2FQZcb5aIm7NhM2lNYwnpx3DM8LqMfi8wPIpYreDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:14:06+03:00",
"language": "uk"
}
],
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
]
}
}
Якщо ми спробуємо підтвердити пропозиціію, буде вимагатися новий підпиис:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/4723f26e27044daebdc065be7140e59c?acc_token=86498b9bd8114fe6b3874ac2340bf614 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'proposal' and format pkcs7-signature is required"
}
]
}
Пакетний режим реєстрації
У пакетному режимі (batch-mode) є можливість зареєструвати пропозицію одним запитом:
Request
POST /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Львів",
"postalCode": "79013",
"region": "Львівська область",
"streetAddress": "вул. Островського, 34"
},
"contactPoint": {
"email": "aagt@gmail.com",
"name": "Андрій Олексюк",
"telephone": "+380322916930"
},
"identifier": {
"scheme": "UA-IPN",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
"id": "12345678",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"scale": "sme",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"documents": [
{
"title": "Proposal_part1.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/deac80b383ff42fda5cfcdd724525b10?Signature=7P1EB%2FQi8l%2Bd5w2BkbUwjnyrcFMJCNeDOJDUM7IWzOoDxGqWqpN8Ve3PCz5aJkNWquLEwiYEaJ1Cg58FpK3OBg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
},
{
"title": "Proposal_part2.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9a280ea4d55b488cb4a2fe24ca2b23a0?Signature=cjXYUD21PnQ1RhZ3YxmDzAuIvI23E1nWXGWO%2BZTK6eJjyi9l2wn4NjXl9pENKYTzYWV%2FzbJs%2Bkhc%2BASTzv7OBg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"confidentiality": "buyerOnly",
"confidentialityRationale": "Only our company sells badgers with pink hair."
}
],
"lotValues": [
{
"value": {
"amount": 499
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"items": [
{
"quantity": 5,
"description": "папір",
"id": "ffffffffffffffffffffffffffffffff",
"unit": {
"code": "KGM",
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
}
}
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/c9c4aaf7df5e4f5dacb4a02c06e28913
{
"data": {
"tenderers": [
{
"name": "ДКП «Книга»",
"identifier": {
"scheme": "UA-IPN",
"id": "12345678",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 34",
"locality": "м. Львів",
"region": "Львівська область",
"postalCode": "79013",
"countryName": "Україна"
},
"contactPoint": {
"name": "Андрій Олексюк",
"email": "aagt@gmail.com",
"telephone": "+380322916930"
},
"scale": "sme",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"lotValues": [
{
"status": "pending",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-16T01:15:06+03:00"
}
],
"status": "draft",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/deac80b383ff42fda5cfcdd724525b10?Signature=29nICiPxbfTuyFCt%2FRxEi7iH%2Fj1Ax%2BmRjAnJFyzSxXr8YKhdwaKulPnB8Ocd8%2B19ptzalZSdFUVQP%2FeRAomPBQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "d3096d156ee84d7ab0433022c92e2fbd",
"datePublished": "2023-10-16T01:15:06+03:00",
"dateModified": "2023-10-16T01:15:06+03:00"
},
{
"confidentiality": "buyerOnly",
"confidentialityRationale": "Only our company sells badgers with pink hair.",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"format": "application/pdf",
"documentOf": "tender",
"language": "uk",
"id": "d2dfe13138124130871c639c03917436",
"datePublished": "2023-10-16T01:15:06+03:00",
"dateModified": "2023-10-16T01:15:06+03:00"
}
],
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
],
"id": "c9c4aaf7df5e4f5dacb4a02c06e28913",
"date": "2023-10-16T01:15:06+03:00"
},
"access": {
"token": "db0c253d0e7b4629a3a71227034d0ee0",
"transfer": "9be7fa6a5e5548c7b4dd45bb233655ff"
}
}
Аукціон
Після того, як аукціон заплановано, будь-хто може його відвідати для перегляду. Аукціон можна подивитись за допомогою Tender.auctionUrl:
Request
GET /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-16T01:15:06+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"questions": [
{
"id": "18aed6d02f154d56b9784733349f80f0",
"author": {
"hash": "1aed9a553aa8fab0177d7427516aa4fe"
},
"title": "Калорійність",
"description": "Просимо додати таблицю потрібної калорійності харчування",
"date": "2023-10-10T01:10:05+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"questionOf": "tender",
"dateAnswered": "2023-10-10T01:10:05+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"documentType": "technicalSpecifications",
"description": "змінений опис документа",
"description_en": "document description modified",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"id": "0eb8412a31bf4fb495e2d50c6a0876d5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc867212802644aea197d58690d3ba5a?Signature=MtSkXRos1yrfdfBsgMVs8NAB4Wh%2F3OPVOFqVj5MdI%2BUj6iyTIMVI7fe6VbiXH3hp71yoRH90hxn6jwSEUdesDQ%3D%3D&KeyID=a8968c46",
"documentOf": "item",
"dateModified": "2023-10-10T01:03:03+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:06:04+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c9a7351bbd9c4577b75310df27591499?Signature=MunTW%2BVyETXx31v93sGhr6mh73PISFITfTGZpi50QbReHquPGEuZi04vK%2F9JcE45YC5McBK17PE%2FTSY6U%2FB%2BAQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:06:04+03:00",
"author": "tender_owner",
"language": "uk"
},
{
"confidentiality": "public",
"description": "Нова версія AwardCriteria документу",
"description_en": "new version of the AwardCriteria document",
"id": "fc20014ad6434b7b93c655c13b2f699a",
"datePublished": "2023-10-10T01:10:05+03:00",
"hash": "md5:11111111111111111111111111111111",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/56b3816a95d94faa973fdac01b15d17f?Signature=OwaEFJzrubfVGiEJjno3o6fbkaDy8WMg0aIbV29ps0%2FiV7Eu7ggkxhTP0bldt05cfWWqeVZRCMyMceYRFqfvAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:10:05+03:00",
"author": "tender_owner",
"language": "en"
}
],
"status": "active.auction",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"agreements": [
{
"id": "144de8e79e64488a967c57cebaacb0d3"
}
],
"procurementMethod": "selective",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"guarantee": {
"amount": 8.0,
"currency": "USD"
},
"next_check": "2023-10-16T02:45:06+03:00",
"tenderPeriod": {
"startDate": "2023-10-09T01:15:06+03:00",
"endDate": "2023-10-16T01:15:06+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"auctionPeriod": {
"startDate": "2023-10-16T01:15:06+03:00"
},
"auctionUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/285d5c5b074a45f198c9a207b4c60b64_880b8274983b40cfa8455e8e3d82bb70"
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "0b78866cd0af4b7995fbeaa9ed101d08",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"startDate": "2023-10-01T01:15:06+03:00",
"clarificationsUntil": "2023-10-10T01:15:06+03:00",
"endDate": "2023-10-09T01:15:06+03:00",
"invalidationDate": "2023-10-16T01:14:06+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70"
}
],
"auctionPeriod": {
"startDate": "2023-10-16T01:15:06+03:00"
},
"id": "285d5c5b074a45f198c9a207b4c60b64"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Учасники можуть дізнатись свої URL-адреси для участі через свої пропозиції:
Request
GET /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/4723f26e27044daebdc065be7140e59c?acc_token=86498b9bd8114fe6b3874ac2340bf614 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"lotValues": [
{
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"status": "active",
"date": "2023-10-16T01:15:06+03:00",
"initialValue": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/285d5c5b074a45f198c9a207b4c60b64_880b8274983b40cfa8455e8e3d82bb70?key_for_bid=4723f26e27044daebdc065be7140e59c"
}
],
"tenderers": [
{
"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": "Статут компанії"
}
}
],
"status": "active",
"id": "4723f26e27044daebdc065be7140e59c",
"date": "2023-10-16T01:15:06+03:00",
"submissionDate": "2023-10-16T01:15:06+03:00",
"documents": [
{
"confidentiality": "public",
"documentType": "proposal",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:14:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7ccd8d40fc3e4a74beb969f8949c8d67?Signature=I1%2FWtkNS5vCIlYLjfyPEJ1udaq2k0M48c67pEHG6p0gkWp%2FQZcb5aIm7NhM2lNYwnpx3DM8LqMfi8wPIpYreDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:14:06+03:00",
"language": "uk"
},
{
"confidentiality": "public",
"documentType": "proposal",
"id": "4947523771de4d7ea963bb65ffd92b13",
"datePublished": "2023-10-16T01:15:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/beed7b02edc24dbf9f72bce75e009ad7?Signature=L17afSUKK3YF%2FTFyzF56a5vBiol8qeXZ%2BkUZHbCYyT5WZbokFbsgzlGp7GOA3KJ%2BVX2auOahFaRF%2FEAUjM6FDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:15:06+03:00",
"language": "uk"
}
],
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
]
}
}
Дивіться на Bid.participationUrl у відповіді. Схожу, але іншу, URL-адресу можна отримати для інших учасників.
Request
GET /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/c9c4aaf7df5e4f5dacb4a02c06e28913?acc_token=db0c253d0e7b4629a3a71227034d0ee0 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"tenderers": [
{
"name": "ДКП «Книга»",
"identifier": {
"scheme": "UA-IPN",
"id": "12345678",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 34",
"locality": "м. Львів",
"region": "Львівська область",
"postalCode": "79013",
"countryName": "Україна"
},
"contactPoint": {
"name": "Андрій Олексюк",
"email": "aagt@gmail.com",
"telephone": "+380322916930"
},
"scale": "sme",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"lotValues": [
{
"status": "pending",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "880b8274983b40cfa8455e8e3d82bb70",
"date": "2023-10-16T01:15:06+03:00",
"participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/285d5c5b074a45f198c9a207b4c60b64_880b8274983b40cfa8455e8e3d82bb70?key_for_bid=c9c4aaf7df5e4f5dacb4a02c06e28913"
}
],
"status": "draft",
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/deac80b383ff42fda5cfcdd724525b10?Signature=29nICiPxbfTuyFCt%2FRxEi7iH%2Fj1Ax%2BmRjAnJFyzSxXr8YKhdwaKulPnB8Ocd8%2B19ptzalZSdFUVQP%2FeRAomPBQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "d3096d156ee84d7ab0433022c92e2fbd",
"datePublished": "2023-10-16T01:15:06+03:00",
"dateModified": "2023-10-16T01:15:06+03:00"
},
{
"confidentiality": "buyerOnly",
"confidentialityRationale": "Only our company sells badgers with pink hair.",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/bids/c9c4aaf7df5e4f5dacb4a02c06e28913/documents/d2dfe13138124130871c639c03917436?download=9a280ea4d55b488cb4a2fe24ca2b23a0",
"documentOf": "tender",
"language": "uk",
"id": "d2dfe13138124130871c639c03917436",
"datePublished": "2023-10-16T01:15:06+03:00",
"dateModified": "2023-10-16T01:15:06+03:00"
}
],
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "папір",
"unit": {
"value": {
"amount": 0.6,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
],
"id": "c9c4aaf7df5e4f5dacb4a02c06e28913",
"date": "2023-10-16T01:15:06+03:00"
}
}
Підтвердження кваліфікації
Кваліфікаційна комісія може винести рішення по переможцю або відхилити award - перевести авард в active або unsuccessful статус.
Валідація значення полів відповідно до рішення під час винесення рішення:
qualified: True - при переході award з pending в active
qualified: False - при переході award з pending в unsuccessful
Спробуємо відхилити авард для qualified учасника:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/awards/d7753a57912a4547ac35509b690cd6d3?acc_token=393a491380684a1b82995ce57d50794c 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/285d5c5b074a45f198c9a207b4c60b64/awards/d7753a57912a4547ac35509b690cd6d3?acc_token=393a491380684a1b82995ce57d50794c 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"
]
}
]
}
Кваліфікаційна комісія реєструє своє рішення через такий виклик:
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/awards/d7753a57912a4547ac35509b690cd6d3?acc_token=393a491380684a1b82995ce57d50794c 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": "d7753a57912a4547ac35509b690cd6d3",
"status": "active",
"date": "2023-10-16T01:15:06+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"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": "Статут компанії"
}
}
],
"bid_id": "4723f26e27044daebdc065be7140e59c",
"lotID": "880b8274983b40cfa8455e8e3d82bb70",
"period": {
"startDate": "2023-10-16T01:15:06+03:00",
"endDate": "2023-10-24T00:00:00+03:00"
},
"qualified": true,
"complaintPeriod": {
"startDate": "2023-10-16T01:15:06+03:00",
"endDate": "2023-10-19T00:00:00+03:00"
}
}
}
Налаштування угоди
В режимі Е-Контрактінгу угода створюється безпосередньо в системі угод.
Примітка
Деякі дані для забезпечення сумісності будуть дублюватись в закупівлі до тих пір, поки угода не буде активована.
Більше дізнатись про роботу з Е-Контрактінгом в системі угод можна в розділі Туторіал.
Скасування закупівлі
Замовник може скасувати закупівлю у будь-який момент (крім закупівель у кінцевому стані, наприклад, usuccesfull, canceled, complete).
Для цього потрібно виконати наступні кроки:
Приготуйте запит на скасування
Наповніть його протоколом про причини скасування
Скасуйте закупівлю через подані причини
Запит на скасування, який не пройшов активації (3-й крок), не матиме сили, тобто, для скасування закупівлі буде обов’язковим не тільки створити заявку, але і активувати її.
Див. структуру запиту Cancellation для більш детальної інформації.
Формування запиту на скасування
Ви повинні передати змінні reason та reasonType, status у стані draft.
id генерується автоматично і повертається у додатковому заголовку відповіді Location:
Request
POST /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/cancellations?acc_token=393a491380684a1b82995ce57d50794c 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/285d5c5b074a45f198c9a207b4c60b64/cancellations/a753e80a5036439fbfc50dc11bd20c0a
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "a753e80a5036439fbfc50dc11bd20c0a",
"date": "2023-10-16T01:15:06+03:00",
"cancellationOf": "tender",
"status": "draft"
}
}
Наповнення протоколом та іншою супровідною документацією
Цей крок обов’язковий. Без документів ви не можете оновити статус скарги.
Завантаження вмісту файлу
Request
POST /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/cancellations/a753e80a5036439fbfc50dc11bd20c0a/documents?acc_token=393a491380684a1b82995ce57d50794c 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/72127eecd0f94595823506fe71393d8d?Signature=N9XArApbM%2FYivaOeUYwECEuNiPbHknzpNydfBEfbVd8SQ8BUGgkon34PT06JcpJfTE6p0dqKm%2BZKES1ZMnxuCQ%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/285d5c5b074a45f198c9a207b4c60b64/cancellations/a753e80a5036439fbfc50dc11bd20c0a/documents/cf8f4a04fff446d190131ca8a6f60f82
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/72127eecd0f94595823506fe71393d8d?Signature=1M3V9rlBESmjcezXkf6E%2BZype%2FzgHRODFwSPgYojiLdglmr2U%2BC7F8qhxG5jdekxopOEySam9LBJb8otO7L2BQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "cf8f4a04fff446d190131ca8a6f60f82",
"datePublished": "2023-10-16T01:15:06+03:00",
"dateModified": "2023-10-16T01:15:06+03:00"
}
}
Зміна опису документа та інших властивостей
Request
PATCH /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/cancellations/a753e80a5036439fbfc50dc11bd20c0a/documents/cf8f4a04fff446d190131ca8a6f60f82?acc_token=393a491380684a1b82995ce57d50794c 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": "cf8f4a04fff446d190131ca8a6f60f82",
"datePublished": "2023-10-16T01:15:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/72127eecd0f94595823506fe71393d8d?Signature=1M3V9rlBESmjcezXkf6E%2BZype%2FzgHRODFwSPgYojiLdglmr2U%2BC7F8qhxG5jdekxopOEySam9LBJb8otO7L2BQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:15:06+03:00",
"language": "uk"
}
}
Завантаження нової версії документа
Request
PUT /api/2.5/tenders/285d5c5b074a45f198c9a207b4c60b64/cancellations/a753e80a5036439fbfc50dc11bd20c0a/documents/cf8f4a04fff446d190131ca8a6f60f82?acc_token=393a491380684a1b82995ce57d50794c 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/96dd566c62644e8fbce28487acf60acc?Signature=vGSLS5yOagt0lxWb1WbIW0L%2Fw9m5QdU8TVCcmatPEChYVrUjkgn16pu97U1v5fov2FRwcPYMew4gKrAhLpD6Dg%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": "cf8f4a04fff446d190131ca8a6f60f82",
"datePublished": "2023-10-16T01:15:06+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/96dd566c62644e8fbce28487acf60acc?Signature=ny%2BU7NdGXm0HWSrShMIfmBHJtZI%2BkQ%2FmXQOjXWRdj4Cf4%2B1tkRdC2gb1sQkmEFFxX538FZZCQVPmCrjVRqF6Aw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-16T01:15:06+03:00",
"language": "uk"
}
}
Активація запиту та скасування закупівлі
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": {
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кілограм",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T00:00:00+02:00"
},
"procurementMethodType": "requestForProposal",
"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
}
],
"contractTemplateName": "00000000.0002.01",
"funders": [
{
"additionalIdentifiers": [],
"address": {
"countryName": "Швейцарська Конфедерація",
"locality": "Geneva",
"postalCode": "1218",
"region": "Grand-Saconnex",
"streetAddress": "Global Health Campus, Chemin du Pommier 40"
},
"contactPoint": {
"email": "ccm@theglobalfund.org",
"faxNumber": "+41 44 580 6820",
"name": "",
"telephone": "+41587911700",
"url": "https://www.theglobalfund.org/en/"
},
"identifier": {
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією",
"scheme": "XM-DAC"
},
"name": "Глобальний фонд"
}
]
},
"config": {
"hasAuction": true,
"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": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/edf794081dcd444fbd0b8cc1e31f792b
{
"data": {
"mainProcurementCategory": "goods",
"funders": [
{
"name": "Глобальний фонд",
"identifier": {
"scheme": "XM-DAC",
"id": "47045",
"legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
},
"address": {
"streetAddress": "Global Health Campus, Chemin du Pommier 40",
"locality": "Geneva",
"region": "Grand-Saconnex",
"postalCode": "1218",
"countryName": "Швейцарська Конфедерація"
},
"contactPoint": {
"name": "",
"email": "ccm@theglobalfund.org",
"telephone": "+41587911700",
"faxNumber": "+41 44 580 6820",
"url": "https://www.theglobalfund.org/en/"
}
}
],
"contractTemplateName": "00000000.0002.01",
"title": "футляри до державних нагород",
"status": "draft",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "287eac32299645e58057bf526f3f67c8",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "requestForProposal",
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-22T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"tenderID": "UA-2023-10-10-000003-a",
"owner": "broker",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"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": "edf794081dcd444fbd0b8cc1e31f792b"
},
"config": {
"hasAuction": true,
"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": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 4,
"qualificationDuration": 20,
"minTenderingDuration": 4,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 3,
"restricted": false
},
"access": {
"token": "4c97ef37809a4c2f9a609abb1d016459",
"transfer": "21ff86c0635d4aceb88fce04e474b6ac"
}
}