Tutorial¶
Framework creation¶
Let’s create a framework:
POST /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Content-Length: 1874
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"name": "Державне управління справами"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2023-03-02T00:00:00+02:00"
}
},
"config": {
"restrictedDerivatives": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/866509257c6546a088e0363315140ee0
{
"data": {
"prettyID": "UA-F-2023-01-01-000001",
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"status": "draft",
"qualificationPeriod": {
"endDate": "2023-03-02T00:00:00+02:00"
},
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "general"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"id": "866509257c6546a088e0363315140ee0"
},
"access": {
"token": "7b5fe43c1f3c4574982dcb841c9ef301",
"transfer": "b7229e63adba4d29ac237837d88a5272"
},
"config": {
"restrictedDerivatives": false
}
}
We have 201 Created response code, Location header and body with extra properties.
Framework was created in draft status. In this status any field, except technical, can be changed using PATCH method.
PATCH /api/2.5/frameworks/866509257c6546a088e0363315140ee0?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 HTTP/1.0
Authorization: Bearer broker
Content-Length: 113
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"procuringEntity": {
"contactPoint": {
"telephone": "+0440000001"
}
},
"title": "updated in draft status"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2023-01-01-000001",
"title": "updated in draft status",
"description": "Назва предмета закупівлі",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"status": "draft",
"qualificationPeriod": {
"endDate": "2023-03-02T00:00:00+02:00"
},
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"id": "866509257c6546a088e0363315140ee0"
},
"config": {
"restrictedDerivatives": false
}
}
Uploading documentation¶
Procuring entity can upload files into the created framework. Uploading should follow the Documents Uploading rules.
POST /api/2.5/frameworks/866509257c6546a088e0363315140ee0/documents?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 HTTP/1.0
Authorization: Bearer broker
Content-Length: 148
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="framework.doc"
Content-Type: application/msword
content
-----BOUNDARY--
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/866509257c6546a088e0363315140ee0/documents/6506c1853419472abd290579305a0e2e
{
"data": {
"id": "6506c1853419472abd290579305a0e2e",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/21845f55a6ee465d8eac46416eac4d04?Signature=%2ByHzPawbrLyMfpg8S7X%2Fy09nWyZjWba6dxKkRJa5K%2FY7w3U9nksK1dQbQD5K77Rhh%2FaFnsUGS8QeDuisls8xCA%3D%3D&KeyID=a8968c46",
"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 creation. We can additionally query the documents collection API endpoint to confirm the action:
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0/documents?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "6506c1853419472abd290579305a0e2e",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/21845f55a6ee465d8eac46416eac4d04?Signature=%2ByHzPawbrLyMfpg8S7X%2Fy09nWyZjWba6dxKkRJa5K%2FY7w3U9nksK1dQbQD5K77Rhh%2FaFnsUGS8QeDuisls8xCA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
]
}
And again we can confirm that there are two documents uploaded.
POST /api/2.5/frameworks/866509257c6546a088e0363315140ee0/documents?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 HTTP/1.0
Authorization: Bearer broker
Content-Length: 172
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="framework_additional_docs.doc"
Content-Type: application/msword
additional info
-----BOUNDARY--
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/866509257c6546a088e0363315140ee0/documents/58b60c5a9fbf4147bcc80eefcedf9d2c
{
"data": {
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a4f3e2ef5f6b4d78934f91b1111336b5?Signature=n6xcmIiAoPC7w06h8DGUxDobhsTqkD6xxBU9PyGULVBH2hhH9SZ3oRekYg6O2MG2Pn4PHf7svoq2TKdjn2FADw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
}
In case we made an error, we can reupload the document over the older version:
PUT /api/2.5/frameworks/866509257c6546a088e0363315140ee0/documents/58b60c5a9fbf4147bcc80eefcedf9d2c?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 HTTP/1.0
Authorization: Bearer broker
Content-Length: 181
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="framework_additional_docs.doc"
Content-Type: application/msword
extended additional info
-----BOUNDARY--
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8f02ae764e8c4eb389cd92c83294f1d4?Signature=msUCyNkYRv64%2BPgFgkZTmEMPEN7xNsSWRpATPCvqfx0mCokSuS%2Bo62e24xZ1OuYSFdNssVF9SfGbtiebc0niBA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
}
And we can see that it is overriding the original version:
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0/documents/58b60c5a9fbf4147bcc80eefcedf9d2c?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8f02ae764e8c4eb389cd92c83294f1d4?Signature=msUCyNkYRv64%2BPgFgkZTmEMPEN7xNsSWRpATPCvqfx0mCokSuS%2Bo62e24xZ1OuYSFdNssVF9SfGbtiebc0niBA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"previousVersions": [
{
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a4f3e2ef5f6b4d78934f91b1111336b5?Signature=n6xcmIiAoPC7w06h8DGUxDobhsTqkD6xxBU9PyGULVBH2hhH9SZ3oRekYg6O2MG2Pn4PHf7svoq2TKdjn2FADw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
]
}
}
Framework activation¶
The second step is moving the framework to active status.
qualificationPeriod.endDate should be in between 30 and 1095 days from activation moment.
There should be at least 1 document in addition to sign document.
PATCH /api/2.5/frameworks/866509257c6546a088e0363315140ee0?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2023-01-01-000001",
"title": "updated in draft status",
"description": "Назва предмета закупівлі",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-31T00:00:00+02:00"
},
"qualificationPeriod": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-03-02T00:00:00+02:00"
},
"enquiryPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-01T00:00:01+02:00"
},
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "6506c1853419472abd290579305a0e2e",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/21845f55a6ee465d8eac46416eac4d04?Signature=%2ByHzPawbrLyMfpg8S7X%2Fy09nWyZjWba6dxKkRJa5K%2FY7w3U9nksK1dQbQD5K77Rhh%2FaFnsUGS8QeDuisls8xCA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a4f3e2ef5f6b4d78934f91b1111336b5?Signature=n6xcmIiAoPC7w06h8DGUxDobhsTqkD6xxBU9PyGULVBH2hhH9SZ3oRekYg6O2MG2Pn4PHf7svoq2TKdjn2FADw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8f02ae764e8c4eb389cd92c83294f1d4?Signature=msUCyNkYRv64%2BPgFgkZTmEMPEN7xNsSWRpATPCvqfx0mCokSuS%2Bo62e24xZ1OuYSFdNssVF9SfGbtiebc0niBA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
],
"id": "866509257c6546a088e0363315140ee0",
"next_check": "2023-01-28T00:00:00+02:00"
},
"config": {
"restrictedDerivatives": false
}
}
After framework activation frameworks periods was calculated:
enquiryPeriod - first 10 full working days after activation.
period - period when suppliers can add submissions (except enquiryPeriod).
qualificationPeriod - last 30 full calendar days of framework when suppliers cannot add submissions but still can be qualified based on previous submissions.
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2023-01-01-000001",
"title": "updated in draft status",
"description": "Назва предмета закупівлі",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-31T00:00:00+02:00"
},
"qualificationPeriod": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-03-02T00:00:00+02:00"
},
"enquiryPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-01T00:00:01+02:00"
},
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "6506c1853419472abd290579305a0e2e",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/21845f55a6ee465d8eac46416eac4d04?Signature=%2ByHzPawbrLyMfpg8S7X%2Fy09nWyZjWba6dxKkRJa5K%2FY7w3U9nksK1dQbQD5K77Rhh%2FaFnsUGS8QeDuisls8xCA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a4f3e2ef5f6b4d78934f91b1111336b5?Signature=n6xcmIiAoPC7w06h8DGUxDobhsTqkD6xxBU9PyGULVBH2hhH9SZ3oRekYg6O2MG2Pn4PHf7svoq2TKdjn2FADw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8f02ae764e8c4eb389cd92c83294f1d4?Signature=msUCyNkYRv64%2BPgFgkZTmEMPEN7xNsSWRpATPCvqfx0mCokSuS%2Bo62e24xZ1OuYSFdNssVF9SfGbtiebc0niBA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
],
"agreementID": "07764e512cfd4004b74989fbab149644",
"id": "866509257c6546a088e0363315140ee0",
"next_check": "2023-01-28T00:00:00+02:00"
},
"config": {
"restrictedDerivatives": false
}
}
Let’s check what framework registry contains:
GET /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-01-17T00:00:00+02:00",
"id": "866509257c6546a088e0363315140ee0"
}
],
"next_page": {
"offset": 1673906400.0,
"path": "/api/2.5/frameworks?offset=1673906400.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/frameworks?offset=1673906400.0"
}
}
We do see the internal id of a framework and its dateModified datestamp.
Modifying framework¶
In active status only some fields can be changed: telephone, name, email for procuringEntity.contactPoint, endDate for qualificationPeriod, description and documents.
If qualificationPeriod.endDate was changed all periods will be recalculated.
PATCH /api/2.5/frameworks/866509257c6546a088e0363315140ee0?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 HTTP/1.0
Authorization: Bearer broker
Content-Length: 360
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"procuringEntity": {
"contactPoint": {
"telephone": "+0440000002",
"name": "зміна",
"email": "ab@aa.com"
}
},
"description": "Назва предмета закупівлі1",
"qualificationPeriod": {
"endDate": "2023-03-17T00:00:00+02:00"
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2023-01-01-000001",
"title": "updated in draft status",
"description": "Назва предмета закупівлі1",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-02-15T00:00:00+02:00"
},
"qualificationPeriod": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-03-17T00:00:00+02:00"
},
"enquiryPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-01T00:00:01+02:00"
},
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "зміна",
"telephone": "+0440000002",
"email": "ab@aa.com"
},
"kind": "general"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "6506c1853419472abd290579305a0e2e",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/21845f55a6ee465d8eac46416eac4d04?Signature=%2ByHzPawbrLyMfpg8S7X%2Fy09nWyZjWba6dxKkRJa5K%2FY7w3U9nksK1dQbQD5K77Rhh%2FaFnsUGS8QeDuisls8xCA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a4f3e2ef5f6b4d78934f91b1111336b5?Signature=n6xcmIiAoPC7w06h8DGUxDobhsTqkD6xxBU9PyGULVBH2hhH9SZ3oRekYg6O2MG2Pn4PHf7svoq2TKdjn2FADw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8f02ae764e8c4eb389cd92c83294f1d4?Signature=msUCyNkYRv64%2BPgFgkZTmEMPEN7xNsSWRpATPCvqfx0mCokSuS%2Bo62e24xZ1OuYSFdNssVF9SfGbtiebc0niBA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
],
"agreementID": "07764e512cfd4004b74989fbab149644",
"id": "866509257c6546a088e0363315140ee0",
"next_check": "2023-01-28T00:00:00+02:00"
},
"config": {
"restrictedDerivatives": false
}
}
Additionally, the dateModified property was updated to reflect the last modification datestamp.
Checking the listing again reflects the new modification date:
GET /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-01-17T00:00:00+02:00",
"id": "866509257c6546a088e0363315140ee0"
}
],
"next_page": {
"offset": 1673906400.0,
"path": "/api/2.5/frameworks?offset=1673906400.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/frameworks?offset=1673906400.0"
}
}
Registering submission¶
After activating framework, users can register their submissions in period from framework.enquiryPeriod.endDate to period.Date:
POST /api/2.5/submissions HTTP/1.0
Authorization: Bearer broker
Content-Length: 1237
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"
}
],
"frameworkID": "866509257c6546a088e0363315140ee0"
},
"config": {
"restricted": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/bcd3769e525d45fd96d69d57e88c7aaf
{
"data": {
"tenderers": [
{
"name": "ДКП «Школяр»",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
}
}
],
"frameworkID": "866509257c6546a088e0363315140ee0",
"dateModified": "2023-01-17T00:00:00+02:00",
"date": "2023-01-17T00:00:00+02:00",
"owner": "broker",
"status": "draft",
"submissionType": "dynamicPurchasingSystem",
"id": "bcd3769e525d45fd96d69d57e88c7aaf"
},
"access": {
"token": "c3c9266b88f94b0492e208c5d98acdfd",
"transfer": "46c4821d00214cb0bdf9b6e9b34bede6"
},
"config": {
"restricted": false
}
}
We have 201 Created response code, Location header and body with extra properties.
Uploading Submission documentation¶
Documents can be uploaded/changed only for submission in draft status.
Documents operations is same like in framework:
POST /api/2.5/submissions/bcd3769e525d45fd96d69d57e88c7aaf/documents?acc_token=c3c9266b88f94b0492e208c5d98acdfd HTTP/1.0
Authorization: Bearer broker
Content-Length: 162
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="submission_docs.doc"
Content-Type: application/msword
additional info
-----BOUNDARY--
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/bcd3769e525d45fd96d69d57e88c7aaf/documents/ec25b11b7d6f4a6e8b111c576f74e728
{
"data": {
"id": "ec25b11b7d6f4a6e8b111c576f74e728",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b3a5368aa2634f6ca846327859183838?Signature=keEOCQEkrnIGVlzysp9vPKnlRkUO0YdsR%2F5TE6Aq7sGiELOqjoBJzNJnuIuaLcudPABXkroE26IAXlvlMs9yBQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
}
GET /api/2.5/submissions/bcd3769e525d45fd96d69d57e88c7aaf/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "ec25b11b7d6f4a6e8b111c576f74e728",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b3a5368aa2634f6ca846327859183838?Signature=keEOCQEkrnIGVlzysp9vPKnlRkUO0YdsR%2F5TE6Aq7sGiELOqjoBJzNJnuIuaLcudPABXkroE26IAXlvlMs9yBQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
]
}
Deleting submission¶
Submission can be deleted only in draft status:
PATCH /api/2.5/submissions/bcd3769e525d45fd96d69d57e88c7aaf?acc_token=c3c9266b88f94b0492e208c5d98acdfd HTTP/1.0
Authorization: Bearer broker
Content-Length: 31
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "deleted"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"tenderers": [
{
"name": "НАЗВА",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
}
}
],
"documents": [
{
"id": "ec25b11b7d6f4a6e8b111c576f74e728",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b3a5368aa2634f6ca846327859183838?Signature=keEOCQEkrnIGVlzysp9vPKnlRkUO0YdsR%2F5TE6Aq7sGiELOqjoBJzNJnuIuaLcudPABXkroE26IAXlvlMs9yBQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
],
"frameworkID": "866509257c6546a088e0363315140ee0",
"dateModified": "2023-01-17T00:00:00+02:00",
"date": "2023-01-17T00:00:00+02:00",
"owner": "broker",
"status": "deleted",
"submissionType": "dynamicPurchasingSystem",
"id": "bcd3769e525d45fd96d69d57e88c7aaf"
},
"config": {
"restricted": false
}
}
Updating Submission¶
Submission can be changed only in draft status:
PATCH /api/2.5/submissions/bcd3769e525d45fd96d69d57e88c7aaf?acc_token=c3c9266b88f94b0492e208c5d98acdfd HTTP/1.0
Authorization: Bearer broker
Content-Length: 69
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderers": [
{
"name": "НАЗВА"
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"tenderers": [
{
"name": "НАЗВА",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
}
}
],
"documents": [
{
"id": "ec25b11b7d6f4a6e8b111c576f74e728",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b3a5368aa2634f6ca846327859183838?Signature=keEOCQEkrnIGVlzysp9vPKnlRkUO0YdsR%2F5TE6Aq7sGiELOqjoBJzNJnuIuaLcudPABXkroE26IAXlvlMs9yBQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
],
"frameworkID": "866509257c6546a088e0363315140ee0",
"dateModified": "2023-01-17T00:00:00+02:00",
"date": "2023-01-17T00:00:00+02:00",
"owner": "broker",
"status": "draft",
"submissionType": "dynamicPurchasingSystem",
"id": "bcd3769e525d45fd96d69d57e88c7aaf"
},
"config": {
"restricted": false
}
}
Submission activation¶
Submission can be activated before period.endDate
PATCH /api/2.5/submissions/82ca7b9acf0c4f7585a682371d6a5b51?acc_token=12b5033a752a46ad94acfb9e128ae58e HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"tenderers": [
{
"name": "ДКП «Школяр»",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
}
}
],
"qualificationID": "e67e3cc511954bc5bdbf5e8d58e27d26",
"frameworkID": "866509257c6546a088e0363315140ee0",
"dateModified": "2023-01-17T00:00:00+02:00",
"date": "2023-01-17T00:00:00+02:00",
"datePublished": "2023-01-17T00:00:00+02:00",
"owner": "broker",
"status": "active",
"submissionType": "dynamicPurchasingSystem",
"id": "82ca7b9acf0c4f7585a682371d6a5b51"
},
"config": {
"restricted": false
}
}
After activating the submission, a qualification object is automatically created and submission qualificationID field is filled.
Let’s check what submission registry contains:
GET /api/2.5/submissions HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-01-17T00:00:00+02:00",
"id": "82ca7b9acf0c4f7585a682371d6a5b51"
}
],
"next_page": {
"offset": 1673906400.0,
"path": "/api/2.5/submissions?offset=1673906400.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?offset=1673906400.0"
}
}
Let’s check created qualification object:
GET /api/2.5/qualifications/e67e3cc511954bc5bdbf5e8d58e27d26 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"submissionID": "82ca7b9acf0c4f7585a682371d6a5b51",
"frameworkID": "866509257c6546a088e0363315140ee0",
"date": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"status": "pending",
"qualificationType": "dynamicPurchasingSystem",
"id": "e67e3cc511954bc5bdbf5e8d58e27d26"
}
}
All operations with qualification object can do only framework_owner.
Uploading qualification documentation¶
Documents can be uploaded/changed only for qualification in pending status.
Documents operations is same like in framework:
POST /api/2.5/qualifications/e67e3cc511954bc5bdbf5e8d58e27d26/documents?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 HTTP/1.0
Authorization: Bearer broker
Content-Length: 152
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="qualification.doc"
Content-Type: application/msword
content
-----BOUNDARY--
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/qualifications/e67e3cc511954bc5bdbf5e8d58e27d26/documents/06fc6adc81e34049bc0ef77f9346a055
{
"data": {
"id": "06fc6adc81e34049bc0ef77f9346a055",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/076a25851dd849ceb3060d7936d4dc66?Signature=IDYMyuQPlPaD1h3usGKxTKYZ3PK%2BsO8qkQO2dZE4YK1Z%2BefEVvDo7FIF00YosMF0y0LA01NZchEshl1RHOXuCQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
}
GET /api/2.5/qualifications/e67e3cc511954bc5bdbf5e8d58e27d26/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "06fc6adc81e34049bc0ef77f9346a055",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/076a25851dd849ceb3060d7936d4dc66?Signature=IDYMyuQPlPaD1h3usGKxTKYZ3PK%2BsO8qkQO2dZE4YK1Z%2BefEVvDo7FIF00YosMF0y0LA01NZchEshl1RHOXuCQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
]
}
Canceled qualification¶
Qualification can be cancelled only in pending status.
PATCH /api/2.5/qualifications/e67e3cc511954bc5bdbf5e8d58e27d26?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 HTTP/1.0
Authorization: Bearer broker
Content-Length: 36
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"submissionID": "82ca7b9acf0c4f7585a682371d6a5b51",
"frameworkID": "866509257c6546a088e0363315140ee0",
"date": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"documents": [
{
"id": "06fc6adc81e34049bc0ef77f9346a055",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/076a25851dd849ceb3060d7936d4dc66?Signature=IDYMyuQPlPaD1h3usGKxTKYZ3PK%2BsO8qkQO2dZE4YK1Z%2BefEVvDo7FIF00YosMF0y0LA01NZchEshl1RHOXuCQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
],
"status": "unsuccessful",
"qualificationType": "dynamicPurchasingSystem",
"id": "e67e3cc511954bc5bdbf5e8d58e27d26"
}
}
After cancelling qualification, related submission changed status from active to complete.
Let’s check what happen with submissions after cancelling qualification:
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0/submissions HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"tenderers": [
{
"name": "ДКП «Школяр»",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
}
}
],
"qualificationID": "e67e3cc511954bc5bdbf5e8d58e27d26",
"frameworkID": "866509257c6546a088e0363315140ee0",
"dateCreated": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"date": "2023-01-17T00:00:00+02:00",
"datePublished": "2023-01-17T00:00:00+02:00",
"status": "complete",
"id": "82ca7b9acf0c4f7585a682371d6a5b51"
},
{
"tenderers": [
{
"name": "ДКП «Школяр»",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
}
}
],
"qualificationID": "244785d441fa4542b1f6d1b9babfc7a1",
"frameworkID": "866509257c6546a088e0363315140ee0",
"dateCreated": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"date": "2023-01-17T00:00:00+02:00",
"datePublished": "2023-01-17T00:00:00+02:00",
"status": "complete",
"id": "ebfd95e14c5b4da4b23188bde4945a76"
}
],
"next_page": {
"offset": 1673906400.0,
"path": "/api/2.5/submissions?offset=1673906400.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?offset=1673906400.0"
}
}
Approve qualification¶
Qualification can be approved only in pending status.
PATCH /api/2.5/qualifications/244785d441fa4542b1f6d1b9babfc7a1?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"submissionID": "ebfd95e14c5b4da4b23188bde4945a76",
"frameworkID": "866509257c6546a088e0363315140ee0",
"date": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"status": "active",
"qualificationType": "dynamicPurchasingSystem",
"id": "244785d441fa4542b1f6d1b9babfc7a1"
}
}
After approving qualification, if it was first active qualification system create agreement with contract otherwise system add contract to agreement.
Let’s check current framework
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2023-01-01-000001",
"title": "updated in draft status",
"description": "Назва предмета закупівлі",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-31T00:00:00+02:00"
},
"qualificationPeriod": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-03-02T00:00:00+02:00"
},
"enquiryPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-01T00:00:01+02:00"
},
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "6506c1853419472abd290579305a0e2e",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/21845f55a6ee465d8eac46416eac4d04?Signature=%2ByHzPawbrLyMfpg8S7X%2Fy09nWyZjWba6dxKkRJa5K%2FY7w3U9nksK1dQbQD5K77Rhh%2FaFnsUGS8QeDuisls8xCA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a4f3e2ef5f6b4d78934f91b1111336b5?Signature=n6xcmIiAoPC7w06h8DGUxDobhsTqkD6xxBU9PyGULVBH2hhH9SZ3oRekYg6O2MG2Pn4PHf7svoq2TKdjn2FADw%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "58b60c5a9fbf4147bcc80eefcedf9d2c",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8f02ae764e8c4eb389cd92c83294f1d4?Signature=msUCyNkYRv64%2BPgFgkZTmEMPEN7xNsSWRpATPCvqfx0mCokSuS%2Bo62e24xZ1OuYSFdNssVF9SfGbtiebc0niBA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
],
"agreementID": "07764e512cfd4004b74989fbab149644",
"id": "866509257c6546a088e0363315140ee0",
"next_check": "2023-01-28T00:00:00+02:00"
},
"config": {
"restrictedDerivatives": false
}
}
You can see that agreementID appeared in current framework, so let’s check that agreement:
GET /api/2.5/agreements/07764e512cfd4004b74989fbab149644 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-01-17-000001",
"status": "active",
"date": "2023-01-17T00:00:00+02:00",
"dateCreated": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"owner": "broker",
"agreementType": "dynamicPurchasingSystem",
"frameworkID": "866509257c6546a088e0363315140ee0",
"period": {
"startDate": "2023-01-17T00:00:00+02:00",
"endDate": "2023-03-02T00:00:00+02:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"contracts": [
{
"id": "ee514fd2ad8c4756b31527c0d91dc86f",
"qualificationID": "244785d441fa4542b1f6d1b9babfc7a1",
"status": "active",
"submissionID": "ebfd95e14c5b4da4b23188bde4945a76",
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
}
}
],
"milestones": [
{
"id": "587ec622cfb34b70b84fd3f8b23ef2b9",
"type": "activation",
"status": "scheduled",
"dueDate": "2023-03-02T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
],
"date": "2023-01-17T00:00:00+02:00"
}
],
"id": "07764e512cfd4004b74989fbab149644",
"next_check": "2023-03-02T00:00:00+02:00"
}
}
As you can see agreement now in active status, and already have contract, so we can see that agreement in agreement feed:
GET /api/2.5/agreements HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-01-17T00:00:00+02:00",
"id": "07764e512cfd4004b74989fbab149644"
}
],
"next_page": {
"offset": 1673906400.0,
"path": "/api/2.5/agreements?offset=1673906400.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?offset=1673906400.0"
}
}
Let’s check what qualification registry contains:
GET /api/2.5/qualifications HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-01-17T00:00:00+02:00",
"id": "e67e3cc511954bc5bdbf5e8d58e27d26"
},
{
"dateModified": "2023-01-17T00:00:00+02:00",
"id": "244785d441fa4542b1f6d1b9babfc7a1"
}
],
"next_page": {
"offset": 1673906400.0,
"path": "/api/2.5/qualifications?offset=1673906400.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?offset=1673906400.0"
}
}
Let’s check all qualifications for current framework:
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0/qualifications HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"submissionID": "82ca7b9acf0c4f7585a682371d6a5b51",
"frameworkID": "866509257c6546a088e0363315140ee0",
"date": "2023-01-17T00:00:00+02:00",
"dateCreated": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"documents": [
{
"id": "06fc6adc81e34049bc0ef77f9346a055",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/076a25851dd849ceb3060d7936d4dc66?Signature=IDYMyuQPlPaD1h3usGKxTKYZ3PK%2BsO8qkQO2dZE4YK1Z%2BefEVvDo7FIF00YosMF0y0LA01NZchEshl1RHOXuCQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
],
"status": "unsuccessful",
"id": "e67e3cc511954bc5bdbf5e8d58e27d26"
},
{
"submissionID": "ebfd95e14c5b4da4b23188bde4945a76",
"frameworkID": "866509257c6546a088e0363315140ee0",
"date": "2023-01-17T00:00:00+02:00",
"dateCreated": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"status": "active",
"id": "244785d441fa4542b1f6d1b9babfc7a1"
}
],
"next_page": {
"offset": 1673906400.0,
"path": "/api/2.5/qualifications?offset=1673906400.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?offset=1673906400.0"
}
}
Framework completing¶
Framework is completed automatically at qualificationPeriod.endDate moment.
PATCH with new qualificationPeriod.endDate allow to complete framework earlier than was planned, but not earlier than 30 full calendar days from change moment.