Tender Inspector Tutorial
Creating tender with inspector
To create tender with inspector you should set field inspector on creation (or you can in set it later by patching tender in draft or active.enquiries statuses)
Inspector field can be set only together with funders .
that’s what will happen if you try to create tender with inspector without 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",
"inspector": {
"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 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "inspector",
"description": [
"Inspector couldn't exist without funders"
]
}
]
}
We got error 422, now let’s create tender with inspector together with 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",
"inspector": {
"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": "Глобальний фонд"
},
"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/977d8a4eb3e440b3acdc8a7f39b7c764
{
"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",
"inspector": {
"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/"
}
},
"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",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"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": "a927cad96b924b708af56cf9f4fbe837",
"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-000001-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": "977d8a4eb3e440b3acdc8a7f39b7c764"
},
"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": "dae7afe6e0d149468a4426e0384ca817",
"transfer": "087446d435b1422a8ecf718a9be14347"
}
}
Patch inspector
Field inspector can be patched only in statuses draft or active.enquiries:
Request
PATCH /api/2.5/tenders/977d8a4eb3e440b3acdc8a7f39b7c764?acc_token=dae7afe6e0d149468a4426e0384ca817 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"inspector": {
"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: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",
"inspector": {
"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/"
}
},
"procurementMethod": "open",
"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
},
"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": "4aa3fea01ec145d8bdbe302a816f8953",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 15.0
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "a927cad96b924b708af56cf9f4fbe837",
"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": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"id": "977d8a4eb3e440b3acdc8a7f39b7c764"
},
"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
}
}
Create review request
Review request can create tender owner for tender with inspector and only in active.enquiries, active.qualification (if procedure with multiple lots)/ active.awarded (if procedure with one or without lots).
Request
POST /api/2.5/tenders/977d8a4eb3e440b3acdc8a7f39b7c764/review_requests?acc_token=dae7afe6e0d149468a4426e0384ca817 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/977d8a4eb3e440b3acdc8a7f39b7c764/review_requests/0b98081079674cf1834f21d5e0e3d3ac
{
"data": {
"id": "0b98081079674cf1834f21d5e0e3d3ac",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderStatus": "active.enquiries"
}
}
- Depends on status from the moment of creation to the moment of providing the result prohibited:
active.enquiries - PATCH tender(except tenderPeriod)
active.qualification/active.awarded - PATCH awards, activate contracts
Let’s try to patch tender description:
Request
PATCH /api/2.5/tenders/977d8a4eb3e440b3acdc8a7f39b7c764?acc_token=dae7afe6e0d149468a4426e0384ca817 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"description": "Оновлений опис"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "With unanswered review request can be patched only ('tenderPeriod',) fields"
}
]
}
Now let’s patch tenderPeriod:
Request
PATCH /api/2.5/tenders/977d8a4eb3e440b3acdc8a7f39b7c764?acc_token=dae7afe6e0d149468a4426e0384ca817 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"startDate": "2023-10-20T01:00:00+03:00",
"endDate": "2023-10-28T01:00:00+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-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",
"inspector": {
"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/"
}
},
"reviewRequests": [
{
"id": "0b98081079674cf1834f21d5e0e3d3ac",
"tenderStatus": "active.enquiries",
"dateCreated": "2023-10-10T01:00:00+03:00"
}
],
"procurementMethod": "open",
"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
},
"tenderPeriod": {
"startDate": "2023-10-20T01:00:00+03:00",
"endDate": "2023-10-28T01:00:00+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "4aa3fea01ec145d8bdbe302a816f8953",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 15.0
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "a927cad96b924b708af56cf9f4fbe837",
"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": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
]
}
],
"id": "977d8a4eb3e440b3acdc8a7f39b7c764"
},
"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
}
}
New review request can’t be created if already exists unanswered review request:
Request
POST /api/2.5/tenders/977d8a4eb3e440b3acdc8a7f39b7c764/review_requests?acc_token=dae7afe6e0d149468a4426e0384ca817 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Disallowed create review request while existing another unanswered review request"
}
]
}
Create review request on qualification stage
If procedure has lots, review request should be created with lotID:
Request
POST /api/2.5/tenders/977d8a4eb3e440b3acdc8a7f39b7c764/review_requests?acc_token=dae7afe6e0d149468a4426e0384ca817 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "lotID",
"description": "Required field."
}
]
}
Review request on qualification stage(active.qualification/active.awarded) can be created only if exists active award.
Request
POST /api/2.5/tenders/977d8a4eb3e440b3acdc8a7f39b7c764/review_requests?acc_token=dae7afe6e0d149468a4426e0384ca817 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"lotID": "4aa3fea01ec145d8bdbe302a816f8953"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Review request can be created only for lot with active award"
}
]
}
Inspector providing review result
Provide result on review request can only user with inspector role using PATCH method:
Request
PATCH /api/2.5/tenders/977d8a4eb3e440b3acdc8a7f39b7c764/review_requests/0b98081079674cf1834f21d5e0e3d3ac HTTP/1.0
Authorization: Bearer inspector
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"approved": false,
"description": "Виправте description"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0b98081079674cf1834f21d5e0e3d3ac",
"tenderStatus": "active.enquiries",
"approved": false,
"description": "Виправте description",
"dateCreated": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00"
}
}
Inspector can’t provide review result on the same review request twice:
Request
PATCH /api/2.5/tenders/977d8a4eb3e440b3acdc8a7f39b7c764/review_requests/0b98081079674cf1834f21d5e0e3d3ac HTTP/1.0
Authorization: Bearer inspector
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"approved": true
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Disallowed re-patching review request"
}
]
}
The procedure cannot go further through the statuses until the controller gives a positive response to review request.
So buyer should make changes, create new review request and after that inspector can provide new result:
Request
PATCH /api/2.5/tenders/977d8a4eb3e440b3acdc8a7f39b7c764/review_requests/67c79432a5f1456fbe492842a2e8584c HTTP/1.0
Authorization: Bearer inspector
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"approved": true
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "67c79432a5f1456fbe492842a2e8584c",
"tenderStatus": "active.enquiries",
"approved": true,
"dateCreated": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"is_valid": true
}
}