Tutorial¶
Exploring basic rules¶
Let’s try exploring the /tenders endpoint:
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"
}
}
Just invoking it reveals empty set.
Now let’s attempt creating some tender:
Request
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
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": "data",
"description": "Expecting value: line 1 column 1 (char 0)"
}
]
}
Error states that the only accepted Content-Type is application/json.
Let’s satisfy the Content-type requirement:
Request
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 4
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": "data",
"description": "Expecting value: line 1 column 1 (char 0)"
}
]
}
Error states that no data has been found in JSON body.
Creating tender¶
Let’s create tender with the minimal (only required) data set:
Request
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3005
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"title": "футляри до державних нагород",
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"procuringEntity": {
"name": "Державне управління справами",
"kind": "general",
"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",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"name": "Державне управління справами 1",
"telephone": "+0440000000",
"availableLanguage": "uk"
}
]
},
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "New Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "item",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42"
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "50fc7d0cb4e3423491c35387a046af42"
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/bf399bcd03af45efa76f2d266f03ccf6
{
"data": {
"title": "футляри до державних нагород",
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"awardCriteria": "lowestCost",
"procurementMethod": "selective",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"telephone": "+0440000000",
"name": "Державне управління справами 1",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "draft",
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "50fc7d0cb4e3423491c35387a046af42",
"status": "active",
"date": "2023-01-01T00:00:00+02:00"
}
],
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"submissionMethod": "electronicAuction",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"id": "bf399bcd03af45efa76f2d266f03ccf6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
},
"access": {
"token": "1e9ca1a6b2574ae38056c8eac4729d40",
"transfer": "550fa6e8f8644be4888033fca7d61c6b"
}
}
Success! Now we can see that new object was created. Response code is 201 and Location response header reports the location of the created object. The body of response reveals the information about the created tender: its internal id (that matches the Location segment), its official tenderID and dateModified datestamp stating the moment in time when tender was last modified. Pay attention to the procurementMethodType. Note that tender is created with draft status.
Let’s access the URL of the created object (the Location header of the response):
Request
GET /api/2.5/tenders/bf399bcd03af45efa76f2d266f03ccf6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title": "футляри до державних нагород",
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"awardCriteria": "lowestCost",
"procurementMethod": "selective",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"telephone": "+0440000000",
"name": "Державне управління справами 1",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "draft",
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "50fc7d0cb4e3423491c35387a046af42",
"status": "active",
"date": "2023-01-01T00:00:00+02:00"
}
],
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"submissionMethod": "electronicAuction",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"id": "bf399bcd03af45efa76f2d266f03ccf6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
}
}
We can see the same response we got after creating tender.
We do see the internal id of a tender (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/tenders/) and its dateModified datestamp.
The previous tender contained only required fields. Let’s try creating tender with more data (tender has status created):
Request
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3262
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"
},
"items": [
{
"id": "7cafcae8b551443599f87782cd56a35d",
"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": "50fc7d0cb4e3423491c35387a046af42"
}
],
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"mode": "test",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
],
"mainProcurementCategory": "services",
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "50fc7d0cb4e3423491c35387a046af42"
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/dd5002cf75a64ce6bc9d60862b662d27
{
"data": {
"mainProcurementCategory": "services",
"title_en": "[TESTING] Cases with state awards",
"title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
"title": "[ТЕСТУВАННЯ] футляри до державних нагород",
"mode": "test",
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"awardCriteria": "lowestCost",
"procurementMethod": "selective",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами",
"availableLanguage": "uk"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "draft",
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "7cafcae8b551443599f87782cd56a35d",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 5.0,
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"unit": {
"name": "кілограм",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"id": "50fc7d0cb4e3423491c35387a046af42",
"status": "active",
"date": "2023-01-01T00:00:00+02:00"
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "e3ecb4dac667456ba483498c8c348d92",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"tenderID": "UA-2023-01-01-000002-a",
"owner": "broker",
"submissionMethod": "electronicAuction",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"id": "dd5002cf75a64ce6bc9d60862b662d27"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
},
"access": {
"token": "65ab2952b7c34b23bea707b8c33a7022",
"transfer": "a313947e69e048138630f529b090f6ba"
}
}
And again we have 201 Created response code, Location header and body with extra id, tenderID, and dateModified properties.
To move forward, you need to change status of procedure to draft.pending. This will let the bot to pull up
Agreement in frameworks_electroniccatalogue and move tender to the next status. If provided information meets all the requirements, than the bot
moves procedure to active.enquiries status, else to draft.unsuccessful terminal status.
Request
PATCH /api/2.5/tenders/bf399bcd03af45efa76f2d266f03ccf6?acc_token=1e9ca1a6b2574ae38056c8eac4729d40 HTTP/1.0
Authorization: Bearer broker
Content-Length: 37
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "draft.pending"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"title": "футляри до державних нагород",
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procurementMethod": "selective",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"telephone": "+0440000000",
"name": "Державне управління справами 1",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "draft.pending",
"agreements": [
{
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"id": "50fc7d0cb4e3423491c35387a046af42"
}
],
"enquiryPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-02T00:00:00+02:00"
},
"tenderPeriod": {
"startDate": "2023-01-02T00:00:00+02:00",
"endDate": "2023-01-05T00:00:00+02:00"
},
"id": "bf399bcd03af45efa76f2d266f03ccf6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
}
}
Let’s see, that our tender meets all the requirements, the bot pulled up Agreement in frameworks_electroniccatalogue of tender and changed status to active.enquiries.
Request
GET /api/2.5/tenders/bf399bcd03af45efa76f2d266f03ccf6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"title": "футляри до державних нагород",
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procurementMethod": "selective",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"telephone": "+0440000000",
"name": "Державне управління справами 1",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "active.enquiries",
"agreements": [
{
"agreementID": "UA-2018-09-11-000002-1",
"dateSigned": "2018-09-11T11:23:23.220310+03:00",
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "Cases for state awards",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 5.0,
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"unit": {
"name": "item",
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"period": {
"startDate": "2018-09-11T11:23:20.418390+03:00",
"endDate": "2222-01-23T11:23:20.418436+03:00"
},
"status": "active",
"contracts": [
{
"id": "d6cd8c3188d74e1481a9cebb57fd9329",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "large",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.0
}
}
],
"awardID": "d7406b07c05b4796bb168a7c47ee7d31",
"bidID": "0a292b6466274139ad3d973fd64830ff",
"date": "2018-07-30T17:40:15.471158+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"amount": 500.56,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "unsuccessful",
"suppliers": [
{
"name": "Державне управління справами 1",
"identifier": {
"scheme": "UA-EDR",
"id": "00037251",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами 1"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"amount": 500.56,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"id": "d925d6c6124447d581f2ae5f52ba710f",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037258",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.0
}
}
],
"awardID": "a915a07f7f0b4dafa583cce119bf1823",
"bidID": "fc02090c338a477f8013156a4fa2da10",
"date": "2018-07-30T17:40:15.471264+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"title": "[ТЕСТУВАННЯ] ",
"title_en": "[TESTING] ",
"title_ru": "[ТЕСТИРОВАНИЕ] ",
"tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32",
"dateModified": "2018-09-17T16:26:31.372995+03:00",
"mode": "test",
"numberOfContracts": 3,
"owner": "broker",
"procuringEntity": {
"name": "Шевченківська районна в місті Києві державна адміністрація",
"name_en": "Angelica Davis",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Шевченківська районна в місті Києві державна адміністрація",
"legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\""
},
"contactPoint": {
"name_en": "Gregory Gillespie",
"email": "buh510@ukr.net",
"telephone": "+2341170",
"faxNumber": "2343591",
"url": "http://www.shev.gov.ua/",
"name": "Ліповець Євген Іванович",
"availableLanguage": "en"
},
"address": {
"streetAddress": "Богдана Хмельницького вулиця, 21-29",
"locality": "Переяслав-Хмельницький",
"region": "Київська область",
"postalCode": "01030",
"countryName": "Україна"
},
"kind": "general"
},
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"id": "50fc7d0cb4e3423491c35387a046af42",
"value": {
"amount": 500.56,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 2.5,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"tenderPeriod": {
"startDate": "2023-01-02T00:00:00+02:00",
"endDate": "2023-01-05T00:00:00+02:00"
},
"enquiryPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-02T00:00:00+02:00"
},
"minimalStep": {
"amount": 2.5,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"value": {
"amount": 500.56,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"next_check": "2023-01-02T00:00:00+02:00",
"id": "bf399bcd03af45efa76f2d266f03ccf6"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
}
}
Let’s see what listing of tenders reveals us:
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-01-01T00:00:00+02:00",
"id": "bf399bcd03af45efa76f2d266f03ccf6"
}
],
"next_page": {
"offset": 1672524000.0,
"path": "/api/2.5/tenders?offset=1672524000.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1672524000.0"
}
}
- When you create a procedure (draft status), you can fill in the following fields:
- in Agreement in frameworks_electroniccatalogue - id
- in Tender - title, title_en, description, description_en, guarantee, procurementMethodType, procuringEntity
- in Lot - title, title_en, description, description_en, id, guarantee
- in Item - description, quantity, relatedLot, unit, description_en, classification, additionalClassifications, deliveryAddress, deliveryDate, deliveryLocation, id
The only field can be modified is Tender: status.
Modifying tender¶
Let’s update tender by supplementing it with all other essential properties:
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 1421
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"startDate": "2023-01-02T00:00:00+02:00",
"endDate": "2023-01-16T00:00:10+02:00"
},
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 6,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"tenderID": "UA-2023-01-01-000004-a",
"owner": "broker",
"title": "футляри до державних нагород",
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procurementMethod": "selective",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"telephone": "+0440000000",
"name": "Державне управління справами 1",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "active.enquiries",
"agreements": [
{
"agreementID": "UA-2018-09-11-000002-1",
"dateSigned": "2018-09-11T11:23:23.220310+03:00",
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "Cases for state awards",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 5.0,
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"unit": {
"name": "item",
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"period": {
"startDate": "2018-09-11T11:23:20.418390+03:00",
"endDate": "2222-01-23T11:23:20.418436+03:00"
},
"status": "active",
"contracts": [
{
"id": "d6cd8c3188d74e1481a9cebb57fd9329",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "large",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.0
}
}
],
"awardID": "d7406b07c05b4796bb168a7c47ee7d31",
"bidID": "0a292b6466274139ad3d973fd64830ff",
"date": "2018-07-30T17:40:15.471158+03:00",
"value": {
"amount": 600.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"amount": 600.67,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "unsuccessful",
"suppliers": [
{
"name": "Державне управління справами 1",
"identifier": {
"scheme": "UA-EDR",
"id": "00037251",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами 1"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"amount": 600.67,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"id": "d925d6c6124447d581f2ae5f52ba710f",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037258",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.0
}
}
],
"awardID": "a915a07f7f0b4dafa583cce119bf1823",
"bidID": "fc02090c338a477f8013156a4fa2da10",
"date": "2018-07-30T17:40:15.471264+03:00",
"value": {
"amount": 600.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"title": "[ТЕСТУВАННЯ] ",
"title_en": "[TESTING] ",
"title_ru": "[ТЕСТИРОВАНИЕ] ",
"tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32",
"dateModified": "2018-09-17T16:26:31.372995+03:00",
"mode": "test",
"numberOfContracts": 3,
"owner": "broker",
"procuringEntity": {
"name": "Шевченківська районна в місті Києві державна адміністрація",
"name_en": "Angelica Davis",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Шевченківська районна в місті Києві державна адміністрація",
"legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\""
},
"contactPoint": {
"name_en": "Gregory Gillespie",
"email": "buh510@ukr.net",
"telephone": "+2341170",
"faxNumber": "2343591",
"url": "http://www.shev.gov.ua/",
"name": "Ліповець Євген Іванович",
"availableLanguage": "en"
},
"address": {
"streetAddress": "Богдана Хмельницького вулиця, 21-29",
"locality": "Переяслав-Хмельницький",
"region": "Київська область",
"postalCode": "01030",
"countryName": "Україна"
},
"kind": "general"
},
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 6.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"id": "50fc7d0cb4e3423491c35387a046af42",
"value": {
"amount": 600.67,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 2.5,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"tenderPeriod": {
"startDate": "2023-01-02T00:00:00+02:00",
"endDate": "2023-01-16T00:00:10+02:00"
},
"enquiryPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-02T00:00:00+02:00"
},
"minimalStep": {
"amount": 2.5,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"value": {
"amount": 600.67,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"next_check": "2023-01-02T00:00:00+02:00",
"id": "e23dee5896254eb4ac3364a9a854c3fe"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
}
}
We see the added properies have merged with existing tender data. Additionally, the dateModified property was updated to reflect the last modification datestamp.
Checking the listing again reflects the new modification date:
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-01-01T00:00:00+02:00",
"id": "bf399bcd03af45efa76f2d266f03ccf6"
},
{
"dateModified": "2023-01-01T00:00:00+02:00",
"id": "e23dee5896254eb4ac3364a9a854c3fe"
}
],
"next_page": {
"offset": 1672524000.0,
"path": "/api/2.5/tenders?offset=1672524000.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1672524000.0"
}
}
Procuring entity can set bid guarantee:
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/lots/50fc7d0cb4e3423491c35387a046af42?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 57
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": {
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"id": "50fc7d0cb4e3423491c35387a046af42",
"value": {
"amount": 600.67,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 2.5,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"guarantee": {
"amount": 8.0,
"currency": "USD"
}
}
}
- You may modify the following fields on this stage of procedure:
tenderPeriod:endDate should differ from tender publication date at least on three days.
You can modify the same fields on this stage of procedure in the case of multiple Item selected.
Uploading documentation¶
Procuring entity should only upload digital signature on this stage of procedure.
Procuring entity can upload PDF files into the created tender. Uploading should follow the Documents Uploading rules.
Request
POST /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/documents?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 324
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=mjrhcvxfj51xIU2CqbPF%2FzPe%2Bd9FKslP4eiSZXoY%2FMzKo2zEQf5WkBpSQFsYC8wf0lH99XgwPL9nZqe2hhqLBw%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/e23dee5896254eb4ac3364a9a854c3fe/documents/20aade7d4c9948b2b97308ac6e6c942d
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "20aade7d4c9948b2b97308ac6e6c942d",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
}
}
201 Created response code and Location header confirm document creation. We can additionally query the documents collection API endpoint to confirm the action:
Request
GET /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/documents/20aade7d4c9948b2b97308ac6e6c942d HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "20aade7d4c9948b2b97308ac6e6c942d",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
}
}
The single array element describes the uploaded document. We can upload more documents:
Request
POST /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/documents?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 337
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "AwardCriteria.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dd09c74752f54370b81db56456d4622c?Signature=7EP5UfK%2BI7IT6JR%2FLpnvQa2MEx8B%2BN6CfTM3Rl%2FJy1QIl%2BNJ0A4pQ9uYbN%2BOJQCaVkdGSEMXbfT1qTQF0zqqDg%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/e23dee5896254eb4ac3364a9a854c3fe/documents/4fb26dfadede4a7f85699e8e626fc794
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dd09c74752f54370b81db56456d4622c?Signature=tSnRb6e0HBpOwpT1iHOjPI9TGBVNiiboyXfwC161eAwy84ICIfE8LARUNwZx50p5QDtRnNFfYqxDJzhn%2FVW%2FDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "4fb26dfadede4a7f85699e8e626fc794",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
}
}
And again we can confirm that there are two documents uploaded.
Request
GET /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/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": [
{
"documentType": "technicalSpecifications",
"description": "document description modified",
"id": "20aade7d4c9948b2b97308ac6e6c942d",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dd09c74752f54370b81db56456d4622c?Signature=tSnRb6e0HBpOwpT1iHOjPI9TGBVNiiboyXfwC161eAwy84ICIfE8LARUNwZx50p5QDtRnNFfYqxDJzhn%2FVW%2FDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "4fb26dfadede4a7f85699e8e626fc794",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
}
]
}
Let’s add new documentType field with technicalSpecifications parameter to the previously uploaded document:
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/documents/20aade7d4c9948b2b97308ac6e6c942d?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
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": {
"documentType": "technicalSpecifications",
"id": "20aade7d4c9948b2b97308ac6e6c942d",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
}
}
Success! Response code is 200 OK and it confirms that documentType field with technicalSpecifications parameter was added .
Now let’s try to modify any field in our document. For example, description:
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/documents/20aade7d4c9948b2b97308ac6e6c942d?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 58
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"description": "document description modified"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"documentType": "technicalSpecifications",
"description": "document description modified",
"id": "20aade7d4c9948b2b97308ac6e6c942d",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
}
}
200 OK response was returned. The description was modified successfully.
In case we made an error, we can reupload the document over the older version:
Request
PUT /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/documents/4fb26dfadede4a7f85699e8e626fc794?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 333
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "AwardCriteria-2.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1c680c5a847e47d397d53c35cd19ac5f?Signature=inZVNXt6PbjQoJ30QUEAQ%2FTXOEsq1Bbum27TIfYSNTQccgQDHHNMYN1Iut%2BI4BBgyGBjm%2BEfOouHKLepDLGkDw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "4fb26dfadede4a7f85699e8e626fc794",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria-2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1c680c5a847e47d397d53c35cd19ac5f?Signature=4DY%2BwYwk31zBKOw4YNVvCqHePAJpPICn5kDOkt%2Bg%2FZf8q%2FaArkqgD7xFV10WPeHL74r1s3mG4FD5Y%2F%2BSXDKaBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
}
}
And we can see that it is overriding the original version:
Request
GET /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/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": [
{
"documentType": "technicalSpecifications",
"description": "document description modified",
"id": "20aade7d4c9948b2b97308ac6e6c942d",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
},
{
"id": "4fb26dfadede4a7f85699e8e626fc794",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria-2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1c680c5a847e47d397d53c35cd19ac5f?Signature=4DY%2BwYwk31zBKOw4YNVvCqHePAJpPICn5kDOkt%2Bg%2FZf8q%2FaArkqgD7xFV10WPeHL74r1s3mG4FD5Y%2F%2BSXDKaBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
}
]
}
Registering bid¶
Step-by-step registration¶
When Tender.tenderingPeriod.startDate comes, Tender switches to active.tendering status that allows registration
of bids.
Bidder can register a bid in draft status:
You cannot submit a bid greater than agreement.contract.value. Also Bidder can’t submit a bid if he is not party of this Framework Agreement
(Agreement in frameworks_electroniccatalogue).
Request
POST /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 1376
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"
}
],
"status": "draft",
"lotValues": [
{
"value": {
"amount": 500
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
]
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Bid is not a member of agreement"
}
]
}
Request
POST /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 1059
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "large",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"status": "draft",
"lotValues": [
{
"value": {
"amount": 500
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/bids/ba9c4ed2a7794a2d8234ba4ce62d909e
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "large"
}
],
"status": "draft",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"lotValues": [
{
"status": "pending",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"date": "2023-01-01T00:00:00+02:00"
}
],
"id": "ba9c4ed2a7794a2d8234ba4ce62d909e",
"date": "2023-01-01T00:00:00+02:00"
},
"access": {
"token": "66a6f8fd577143f0a72ce197fbc1ec37",
"transfer": "682388a7750b4f21b80b05c508894a48"
}
}
and approve to pending status:
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/bids/ba9c4ed2a7794a2d8234ba4ce62d909e?acc_token=66a6f8fd577143f0a72ce197fbc1ec37 HTTP/1.0
Authorization: Bearer broker
Content-Length: 31
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": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "large"
}
],
"status": "pending",
"id": "ba9c4ed2a7794a2d8234ba4ce62d909e",
"date": "2023-01-01T00:00:00+02:00",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"lotValues": [
{
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"status": "pending",
"date": "2023-01-01T00:00:00+02:00"
}
]
}
}
Bidder should only upload digital signature on this stage of procedure.
Upload proposal document:
Request
POST /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/bids/ba9c4ed2a7794a2d8234ba4ce62d909e/documents?acc_token=66a6f8fd577143f0a72ce197fbc1ec37 HTTP/1.0
Authorization: Bearer broker
Content-Length: 322
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Proposal.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e5d937aec73f4c07aec4e91e7de7d0c0?Signature=ThEuR34wf1tPqsNQroLH8otCJkwtR0BMJRBO%2BudrVDjRl85gUk6YcvjYxwBJPN0MXyGwn2jG51RrcgCPxHZHAA%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/e23dee5896254eb4ac3364a9a854c3fe/bids/ba9c4ed2a7794a2d8234ba4ce62d909e/documents/62f0b2930d8141f6a477f9df9c073e16
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e5d937aec73f4c07aec4e91e7de7d0c0?Signature=i1QFE0pwj%2BuQT99%2FY4GX2uZghCioK2WSMSpY6%2BMlXr1TETaF6FoXkWJE5ceSIenvOO9CMxJTx4kTn5aoga4JAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"confidentiality": "public",
"id": "62f0b2930d8141f6a477f9df9c073e16",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
}
It is possible to check the uploaded documents:
Request
GET /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/bids/ba9c4ed2a7794a2d8234ba4ce62d909e/documents?acc_token=66a6f8fd577143f0a72ce197fbc1ec37 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e5d937aec73f4c07aec4e91e7de7d0c0?Signature=i1QFE0pwj%2BuQT99%2FY4GX2uZghCioK2WSMSpY6%2BMlXr1TETaF6FoXkWJE5ceSIenvOO9CMxJTx4kTn5aoga4JAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"confidentiality": "public",
"id": "62f0b2930d8141f6a477f9df9c073e16",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
]
}
Batch-mode registration¶
Register bid with documents using one request:
Request
POST /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 1699
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"lotValues": [
{
"value": {
"amount": 499
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42"
}
],
"documents": [
{
"title": "Proposal_part1.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6f5d54d6f96e4f93bb84aaf2005ecd74?Signature=Mo04A31PiR8t5ZU5YIge%2B%2FKNq930zaj52Y%2BQgdtIdmq1y1E%2BB5O5O8rWiWpgAR0VXxDd1FCp7nVSJLsKg3RhCQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
},
{
"title": "Proposal_part2.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7c465d3486b487db509f0e8482bcafd?Signature=hMKg5q0zUd5uHXOeMKHBLUxB4hjVOc9ILgQz2ZSbyqNPqsb7QEVoTlMJDNL15wFmJrKNyZWBGFf5bFYE5HPnDg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/bids/c6ce785401b149cca81e00c5236c853b
{
"data": {
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"status": "draft",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6f5d54d6f96e4f93bb84aaf2005ecd74?Signature=gWkknoOyOQh2cpnX6nZmhLZJrFxulp8qPlSiERXttONVOcfK8ZCL1ksm1AQp292iAQqY6uzphnL10nz8PEnlAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"confidentiality": "public",
"id": "ccbc49d9afb64e48bc47326d43f3df4f",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7c465d3486b487db509f0e8482bcafd?Signature=Dt0bUdqRLCf5ENnzoOZDqA6XZdViV36%2BLgE4rzqjUtBbVG0krDrux7p3D7C45U3%2BZaqfHqB1ntI9LVS%2F6PoeCg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"confidentiality": "public",
"id": "a75a8ee9ac0040c18c01303d794b899c",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"lotValues": [
{
"status": "pending",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"date": "2023-01-01T00:00:00+02:00"
}
],
"id": "c6ce785401b149cca81e00c5236c853b",
"date": "2023-01-01T00:00:00+02:00"
},
"access": {
"token": "8120441ba0e4471ebbc6f7e9e5a73771",
"transfer": "c8e4ae56ba04430095535f7996b20379"
}
}
Auction¶
After auction is scheduled anybody can visit it to watch. The auction can be reached at Tender.auctionUrl:
Request
GET /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"tenderID": "UA-2023-01-01-000004-a",
"owner": "broker",
"title": "футляри до державних нагород",
"procurementMethodType": "closeFrameworkAgreementSelectionUA",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procurementMethod": "selective",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами",
"availableLanguage": "en"
},
"additionalContactPoints": [
{
"telephone": "+0440000000",
"name": "Державне управління справами 1",
"availableLanguage": "uk"
}
],
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general"
},
"status": "active.auction",
"agreements": [
{
"agreementID": "UA-2018-09-11-000002-1",
"dateSigned": "2018-09-11T11:23:23.220310+03:00",
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "Cases for state awards",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 5.0,
"deliveryDate": {
"startDate": "2018-06-27T13:39:09.362837+03:00",
"endDate": "2018-06-30T13:39:09.362837+03:00"
},
"unit": {
"name": "item",
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"period": {
"startDate": "2018-09-11T11:23:20.418390+03:00",
"endDate": "2222-01-23T11:23:20.418436+03:00"
},
"status": "active",
"contracts": [
{
"id": "d6cd8c3188d74e1481a9cebb57fd9329",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "large",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.0
}
}
],
"awardID": "d7406b07c05b4796bb168a7c47ee7d31",
"bidID": "0a292b6466274139ad3d973fd64830ff",
"date": "2018-07-30T17:40:15.471158+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 600.0
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 600.666
}
},
{
"id": "c8ef8c0d1cb74528b13335a623225762",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "unsuccessful",
"suppliers": [
{
"name": "Державне управління справами 1",
"identifier": {
"scheme": "UA-EDR",
"id": "00037251",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами 1"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.111
}
}
],
"awardID": "cdb6da320600480d8eaabd8eaa920872",
"bidID": "d85ef51272f14087abb2eed535340493",
"date": "2018-07-30T17:40:15.471207+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 600.666
}
},
{
"id": "d925d6c6124447d581f2ae5f52ba710f",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037258",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"unitPrices": [
{
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 100.0
}
}
],
"awardID": "a915a07f7f0b4dafa583cce119bf1823",
"bidID": "fc02090c338a477f8013156a4fa2da10",
"date": "2018-07-30T17:40:15.471264+03:00",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 600.0
}
}
],
"title": "[ТЕСТУВАННЯ] ",
"title_en": "[TESTING] ",
"title_ru": "[ТЕСТИРОВАНИЕ] ",
"tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32",
"dateModified": "2018-09-17T16:26:31.372995+03:00",
"mode": "test",
"numberOfContracts": 3,
"owner": "broker",
"procuringEntity": {
"name": "Шевченківська районна в місті Києві державна адміністрація",
"name_en": "Angelica Davis",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Шевченківська районна в місті Києві державна адміністрація",
"legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\""
},
"contactPoint": {
"name_en": "Gregory Gillespie",
"email": "buh510@ukr.net",
"telephone": "+2341170",
"faxNumber": "2343591",
"url": "http://www.shev.gov.ua/",
"name": "Ліповець Євген Іванович",
"availableLanguage": "en"
},
"address": {
"streetAddress": "Богдана Хмельницького вулиця, 21-29",
"locality": "Переяслав-Хмельницький",
"region": "Київська область",
"postalCode": "01030",
"countryName": "Україна"
},
"kind": "general"
},
"id": "53e68cfa78da42188f99f9e054e0e168"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 6.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"id": "50fc7d0cb4e3423491c35387a046af42",
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 600.666
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 3.0033300000000005
},
"guarantee": {
"amount": 8.0,
"currency": "USD"
},
"auctionPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"shouldStartAfter": "2023-01-01T00:00:00+02:00"
},
"auctionUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/e23dee5896254eb4ac3364a9a854c3fe_50fc7d0cb4e3423491c35387a046af42"
}
],
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"title": "До 1000 Вт",
"value": 0.1
},
{
"title": "Більше 1000 Вт",
"value": 0.15
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"title": "До 3 років",
"value": 0.05
},
{
"title": "Більше 3 років, менше 5 років",
"value": 0.1
},
{
"title": "Більше 5 років",
"value": 0.15
}
]
}
],
"tenderPeriod": {
"startDate": "2022-12-28T00:00:00+02:00",
"endDate": "2023-01-01T00:00:00+02:00"
},
"enquiryPeriod": {
"startDate": "2022-12-26T00:00:00+02:00",
"endDate": "2022-12-28T00:00:00+02:00"
},
"minimalStep": {
"amount": 3.0033300000000005,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"value": {
"amount": 600.666,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"next_check": "2023-01-01T00:42:00+02:00",
"guarantee": {
"amount": 8.0,
"currency": "USD"
},
"documents": [
{
"documentType": "technicalSpecifications",
"description": "document description modified",
"id": "20aade7d4c9948b2b97308ac6e6c942d",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/documents/20aade7d4c9948b2b97308ac6e6c942d?download=d351393c1280494ba80f9ffa0b2345f7",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/documents/4fb26dfadede4a7f85699e8e626fc794?download=dd09c74752f54370b81db56456d4622c",
"documentOf": "tender",
"language": "uk",
"id": "4fb26dfadede4a7f85699e8e626fc794",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
},
{
"id": "4fb26dfadede4a7f85699e8e626fc794",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria-2.pdf",
"format": "application/pdf",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/documents/4fb26dfadede4a7f85699e8e626fc794?download=1c680c5a847e47d397d53c35cd19ac5f",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner",
"language": "uk"
}
],
"auctionPeriod": {
"startDate": "2023-01-01T00:00:00+02:00"
},
"id": "e23dee5896254eb4ac3364a9a854c3fe"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
}
}
And bidders can find out their participation URLs via their bids:
Request
GET /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/bids/ba9c4ed2a7794a2d8234ba4ce62d909e?acc_token=66a6f8fd577143f0a72ce197fbc1ec37 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-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "large"
}
],
"status": "active",
"id": "ba9c4ed2a7794a2d8234ba4ce62d909e",
"date": "2023-01-01T00:00:00+02:00",
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"lotValues": [
{
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/e23dee5896254eb4ac3364a9a854c3fe_50fc7d0cb4e3423491c35387a046af42?key_for_bid=ba9c4ed2a7794a2d8234ba4ce62d909e"
}
],
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e5d937aec73f4c07aec4e91e7de7d0c0?Signature=i1QFE0pwj%2BuQT99%2FY4GX2uZghCioK2WSMSpY6%2BMlXr1TETaF6FoXkWJE5ceSIenvOO9CMxJTx4kTn5aoga4JAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"confidentiality": "public",
"id": "62f0b2930d8141f6a477f9df9c073e16",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
]
}
}
See the Bid.participationUrl in the response. Similar, but different, URL can be retrieved for other participants:
Request
GET /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/bids/c6ce785401b149cca81e00c5236c853b?acc_token=8120441ba0e4471ebbc6f7e9e5a73771 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-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"status": "active",
"id": "c6ce785401b149cca81e00c5236c853b",
"date": "2023-01-01T00:00:00+02:00",
"documents": [
{
"id": "ccbc49d9afb64e48bc47326d43f3df4f",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6f5d54d6f96e4f93bb84aaf2005ecd74?Signature=gWkknoOyOQh2cpnX6nZmhLZJrFxulp8qPlSiERXttONVOcfK8ZCL1ksm1AQp292iAQqY6uzphnL10nz8PEnlAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"language": "uk",
"confidentiality": "public"
},
{
"id": "a75a8ee9ac0040c18c01303d794b899c",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7c465d3486b487db509f0e8482bcafd?Signature=Dt0bUdqRLCf5ENnzoOZDqA6XZdViV36%2BLgE4rzqjUtBbVG0krDrux7p3D7C45U3%2BZaqfHqB1ntI9LVS%2F6PoeCg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"language": "uk",
"confidentiality": "public"
}
],
"parameters": [
{
"code": "OCDS-123454-AIR-INTAKE",
"value": 0.1
},
{
"code": "OCDS-123454-YEARS",
"value": 0.1
}
],
"lotValues": [
{
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/e23dee5896254eb4ac3364a9a854c3fe_50fc7d0cb4e3423491c35387a046af42?key_for_bid=c6ce785401b149cca81e00c5236c853b"
}
]
}
}
Listing awards¶
The pending award can be retrieved via request to list all available awards:
Request
GET /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/awards 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": "22fef0a4f3e74e778afb520847f7409f",
"status": "pending",
"date": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"weightedValue": {
"amount": 388.11,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"denominator": 1.286
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "c6ce785401b149cca81e00c5236c853b",
"lotID": "50fc7d0cb4e3423491c35387a046af42"
}
]
}
Confirming qualification¶
Let’s try to disqualify award by switching it’s status from pending to unsuccessful.
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/awards/22fef0a4f3e74e778afb520847f7409f?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 36
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Can't update award status to unsuccessful, if tender status is active.qualification and there is no cancelled award with the same bid_id"
}
]
}
As we can see it is impossible. Procuring entity should activate pending award at first and switch it to cancelled status then.
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/awards/22fef0a4f3e74e778afb520847f7409f?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "22fef0a4f3e74e778afb520847f7409f",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"weightedValue": {
"amount": 388.11,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"denominator": 1.286
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "c6ce785401b149cca81e00c5236c853b",
"lotID": "50fc7d0cb4e3423491c35387a046af42"
}
}
Now cancelling active award.
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/awards/22fef0a4f3e74e778afb520847f7409f?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/awards/a80e29abc8b74a38aa33d17371bae942
{
"data": {
"id": "22fef0a4f3e74e778afb520847f7409f",
"status": "cancelled",
"date": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"weightedValue": {
"amount": 388.11,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"denominator": 1.286
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "c6ce785401b149cca81e00c5236c853b",
"lotID": "50fc7d0cb4e3423491c35387a046af42"
}
}
We see that new pending award is generated for the same bidder now. So we can successfully switch this pending award to unsuccessful.
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/awards/a80e29abc8b74a38aa33d17371bae942?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 36
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/awards/27ea2d3a36f44b9ca26e10e249a47b77
{
"data": {
"id": "a80e29abc8b74a38aa33d17371bae942",
"status": "unsuccessful",
"date": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"weightedValue": {
"amount": 388.11,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"denominator": 1.286
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "c6ce785401b149cca81e00c5236c853b",
"lotID": "50fc7d0cb4e3423491c35387a046af42"
}
}
Qualification comission registers its decision via the following call:
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/awards/27ea2d3a36f44b9ca26e10e249a47b77?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "27ea2d3a36f44b9ca26e10e249a47b77",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 499.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"weightedValue": {
"amount": 388.11,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"denominator": 1.286
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037258",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "cac5717cd00c4786ab92d1e93fe315ac",
"lotID": "50fc7d0cb4e3423491c35387a046af42"
}
}
Procuring entity should fill the information about extension of the bidder’s term in the description field.
Setting contract value¶
By default contract value is set based on the award, but there is a possibility to set custom contract value.
If you want to lower contract value, you can insert new one into the amount field.
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/contracts/0f8bcfb7afef4ca0ac7b84f773208786?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 91
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"contractNumber": "contract #13111",
"value": {
"amount": 238,
"amountNet": 230
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0f8bcfb7afef4ca0ac7b84f773208786",
"contractID": "UA-2023-01-01-000004-a-2",
"contractNumber": "contract #13111",
"status": "pending",
"date": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"awardID": "27ea2d3a36f44b9ca26e10e249a47b77",
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 6.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037258",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
]
}
}
200 OK response was returned. The value was modified successfully.
Setting contract signature date¶
There is a possibility to set custom contract signature date. You can insert appropriate date into the dateSigned field.
If this date is not set, it will be auto-generated on the date of contract registration.
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/contracts/0f8bcfb7afef4ca0ac7b84f773208786?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"dateSigned": "2023-01-01T00:00:00+02:00"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
null
Setting contract validity period¶
Setting contract validity period is optional, but if it is needed, you can set appropriate startDate and endDate.
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/contracts/0f8bcfb7afef4ca0ac7b84f773208786?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2024-01-01T00:00:00+02:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0f8bcfb7afef4ca0ac7b84f773208786",
"contractID": "UA-2023-01-01-000004-a-2",
"contractNumber": "contract #13111",
"status": "pending",
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2024-01-01T00:00:00+02:00"
},
"date": "2023-01-01T00:00:00+02:00",
"dateSigned": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"awardID": "27ea2d3a36f44b9ca26e10e249a47b77",
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 6.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037258",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
]
}
}
Uploading contract documentation¶
You can upload contract documents. Let’s upload contract document:
Request
POST /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/contracts/0f8bcfb7afef4ca0ac7b84f773208786/documents?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 342
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_first_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a83f0a33f5af423ca2e0d30d39935784?Signature=TmZlsGA0myFb5UYGdwSF0BgZO%2BcYz4NZl4srBStswad93jDjgNRS6TFpTSTK9yXuw7wurF2iZSOgM68G%2B917CA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/contracts/0f8bcfb7afef4ca0ac7b84f773208786/documents/c5b4dda6bfb1463082ef3f10346f5b56
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a83f0a33f5af423ca2e0d30d39935784?Signature=9jE1X0uFLKzjDVyMW6miRQjQ79QgJ8%2BNMMIBhQ2PUz3vSPdXimT3XHkjNowMCwcuziKASLF7HZ%2FH%2FbRX8zWEDQ%3D%3D&KeyID=a8968c46",
"id": "c5b4dda6bfb1463082ef3f10346f5b56",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
}
201 Created response code and Location header confirm document was added.
Let’s see the list of contract documents:
Request
GET /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/contracts/0f8bcfb7afef4ca0ac7b84f773208786/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": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a83f0a33f5af423ca2e0d30d39935784?Signature=9jE1X0uFLKzjDVyMW6miRQjQ79QgJ8%2BNMMIBhQ2PUz3vSPdXimT3XHkjNowMCwcuziKASLF7HZ%2FH%2FbRX8zWEDQ%3D%3D&KeyID=a8968c46",
"id": "c5b4dda6bfb1463082ef3f10346f5b56",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
]
}
We can add another contract document:
Request
POST /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/contracts/0f8bcfb7afef4ca0ac7b84f773208786/documents?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 341
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_second_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/52885cec7411475ea472a5688d3739f9?Signature=6vsSN7PC7P0QepWvmz5xQ0QltP9f6c0hgg5sHvKaxOGaCFpDL%2FGzTPQ4PUfB5ZGhKqqF60J0xigyxfD0sKEcDg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/contracts/0f8bcfb7afef4ca0ac7b84f773208786/documents/141c6ddfa7f24a9da7291db7fe4f6718
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/52885cec7411475ea472a5688d3739f9?Signature=eCACfBQqTNvM5orOFP9q1lq7%2Bo0kIVneUJC3Hd7cnFgS0ngh8QxWFf3CvXLgVOuLK2jYZLSSwJ2KaPDNI7fcCA%3D%3D&KeyID=a8968c46",
"id": "141c6ddfa7f24a9da7291db7fe4f6718",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
}
201 Created response code and Location header confirm second document was uploaded.
Let’s see the list of all added contract documents:
Request
GET /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/contracts/0f8bcfb7afef4ca0ac7b84f773208786/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": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a83f0a33f5af423ca2e0d30d39935784?Signature=9jE1X0uFLKzjDVyMW6miRQjQ79QgJ8%2BNMMIBhQ2PUz3vSPdXimT3XHkjNowMCwcuziKASLF7HZ%2FH%2FbRX8zWEDQ%3D%3D&KeyID=a8968c46",
"id": "c5b4dda6bfb1463082ef3f10346f5b56",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/52885cec7411475ea472a5688d3739f9?Signature=eCACfBQqTNvM5orOFP9q1lq7%2Bo0kIVneUJC3Hd7cnFgS0ngh8QxWFf3CvXLgVOuLK2jYZLSSwJ2KaPDNI7fcCA%3D%3D&KeyID=a8968c46",
"id": "141c6ddfa7f24a9da7291db7fe4f6718",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
]
}
Set contract signature date¶
There is a possibility to set custom contract signature date. If the date is not set it will be generated on contract registration.
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/contracts/0f8bcfb7afef4ca0ac7b84f773208786?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"dateSigned": "2023-01-01T00:00:00+02:00"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
null
Contract registration¶
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/contracts/0f8bcfb7afef4ca0ac7b84f773208786?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0f8bcfb7afef4ca0ac7b84f773208786",
"contractID": "UA-2023-01-01-000004-a-2",
"contractNumber": "contract #13111",
"status": "active",
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2024-01-01T00:00:00+02:00"
},
"date": "2023-01-01T00:00:00+02:00",
"dateSigned": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"awardID": "27ea2d3a36f44b9ca26e10e249a47b77",
"documents": [
{
"id": "c5b4dda6bfb1463082ef3f10346f5b56",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a83f0a33f5af423ca2e0d30d39935784?Signature=9jE1X0uFLKzjDVyMW6miRQjQ79QgJ8%2BNMMIBhQ2PUz3vSPdXimT3XHkjNowMCwcuziKASLF7HZ%2FH%2FbRX8zWEDQ%3D%3D&KeyID=a8968c46",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "141c6ddfa7f24a9da7291db7fe4f6718",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/52885cec7411475ea472a5688d3739f9?Signature=eCACfBQqTNvM5orOFP9q1lq7%2Bo0kIVneUJC3Hd7cnFgS0ngh8QxWFf3CvXLgVOuLK2jYZLSSwJ2KaPDNI7fcCA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-01-01T00:00:00+02:00"
}
],
"items": [
{
"id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
"description": "футляри до державних нагород",
"description_en": "futliary do derzhavnyh nagorod",
"classification": {
"description": "New Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 6.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"relatedLot": "50fc7d0cb4e3423491c35387a046af42",
"unit": {
"name": "item",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037258",
"uri": "http://www.dus.gov.ua/"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
]
}
}
To see more information about contract look at the Contracting API interface to OpenProcurement database.
Cancelling tender¶
Tender creator can cancel tender anytime (except when tender in status active.auction or in terminal status e.g. unsuccessful, canceled, complete).
The following steps should be applied:
- Prepare cancellation request
- Fill it with the protocol describing the cancellation reasons
- Cancel the tender with the reasons prepared.
Only the request that has been activated (3rd step above) has power to cancel tender. I.e. you have to not only prepare cancellation request but to activate it as well.
See Cancellation data structure for details.
Preparing the cancellation request¶
You should pass reason and reasonType, status defaults to draft.
There are four possible types of cancellation reason - tender was noDemand, unFixable, forceMajeure and expensesCut.
id is autogenerated and passed in the Location header of response.
Request
POST /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/cancellations?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 69
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/e23dee5896254eb4ac3364a9a854c3fe/cancellations/dfe7a1f0003d45968ecff4c41e2f7f0c
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "dfe7a1f0003d45968ecff4c41e2f7f0c",
"date": "2023-01-01T00:00:00+02:00",
"cancellationOf": "tender",
"status": "draft"
}
}
Filling cancellation with protocol and supplementary documentation¶
This step is required. Without documents you can’t update tender status.
Upload the file contents
Request
POST /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/cancellations/dfe7a1f0003d45968ecff4c41e2f7f0c/documents?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 330
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/77ca9cc7a37f4d8faf20107b1a01d381?Signature=qqsNUkZVrAttA%2BIJ9%2ByvmzDFNOHYJ6G0y%2F%2FfNUN3VCIAr5T76FEURKbzf%2B5erQufCpuy4%2B0eIaa8iKU1jOVMBQ%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/e23dee5896254eb4ac3364a9a854c3fe/cancellations/dfe7a1f0003d45968ecff4c41e2f7f0c/documents/cefec5420d47423b87331af559495f3a
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/77ca9cc7a37f4d8faf20107b1a01d381?Signature=1sXhVyK9CLpqVnRp8BdFBBt%2Bca%2FJ%2BIj1tzMENpKk3WKxA7y71c7tbPw%2BRlKZprbziBR0%2BvdOgTc%2BuFzwbJ5tDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "cefec5420d47423b87331af559495f3a",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
}
Change the document description and other properties
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/cancellations/dfe7a1f0003d45968ecff4c41e2f7f0c/documents/cefec5420d47423b87331af559495f3a?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 48
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": {
"description": "Changed description",
"id": "cefec5420d47423b87331af559495f3a",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/77ca9cc7a37f4d8faf20107b1a01d381?Signature=1sXhVyK9CLpqVnRp8BdFBBt%2Bca%2FJ%2BIj1tzMENpKk3WKxA7y71c7tbPw%2BRlKZprbziBR0%2BvdOgTc%2BuFzwbJ5tDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"language": "uk"
}
}
Upload new version of the document
Request
PUT /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/cancellations/dfe7a1f0003d45968ecff4c41e2f7f0c/documents/cefec5420d47423b87331af559495f3a?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 324
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice-2.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9e3298c336c945499e5a62d8764a1b8d?Signature=jV%2BvJVqKip1KnqKj8tIl4JG9tIfhNoiIrYqQ8iUtXHd00NUy3Olmz%2FAHchB50qVdHFlLzvHP2AX7ykHWafgJCA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"description": "Changed description",
"id": "cefec5420d47423b87331af559495f3a",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice-2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9e3298c336c945499e5a62d8764a1b8d?Signature=ABDhPkZ3RG4Jl2IDp0UTO6%2Fu6JyDpiTVsyWOsdD94P13KKe%2FvCGWkHnvKC%2FZrv5OEpftyMoxkKly3veOWTPhDw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"language": "uk"
}
}
Activating the request and cancelling tender¶
Request
PATCH /api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/cancellations/dfe7a1f0003d45968ecff4c41e2f7f0c?acc_token=5585cd490cac4cb68cd03d747b3c247c HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "dfe7a1f0003d45968ecff4c41e2f7f0c",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"reasonType": "noDemand",
"reason": "cancellation reason",
"cancellationOf": "tender",
"documents": [
{
"description": "Changed description",
"id": "cefec5420d47423b87331af559495f3a",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/cancellations/dfe7a1f0003d45968ecff4c41e2f7f0c/documents/cefec5420d47423b87331af559495f3a?download=77ca9cc7a37f4d8faf20107b1a01d381",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"language": "uk"
},
{
"description": "Changed description",
"id": "cefec5420d47423b87331af559495f3a",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice-2.pdf",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/e23dee5896254eb4ac3364a9a854c3fe/cancellations/dfe7a1f0003d45968ecff4c41e2f7f0c/documents/cefec5420d47423b87331af559495f3a?download=9e3298c336c945499e5a62d8764a1b8d",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"language": "uk"
}
]
}
}
It may be useful to see top requirements: Test Cases for III level of accreditation and Test Cases for IV level of accreditation.