Туторіал¶
Створення кваліфікації¶
Створимо кваліфікацію:
Request
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
}
}
Response
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
}
}
Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.
Кваліфікацію було створено у статусі draft. У цьому статусі будь-яке поле, окрім технічних, може бути змінено.
Request
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"
}
}
Response
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
}
}
Завантаження документації¶
Замовник може завантажити PDF файл у створениу кваліфікацію. Завантаження повинно відбуватись згідно правил Завантаження документів.
Request
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--
Response
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 та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
Request
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0/documents?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 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": "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"
}
]
}
І знову можна перевірити, що є два завантажених документа.
Request
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--
Response
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"
}
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
Request
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--
Response
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"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
Request
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0/documents/58b60c5a9fbf4147bcc80eefcedf9d2c?acc_token=7b5fe43c1f3c4574982dcb841c9ef301 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": "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"
}
]
}
}
Активація кваліфікації¶
Наступний крок - змінити статус кваліфікації на active.
qualificationPeriod.endDate має бути у проміжку не менш ніж 30 днів і не більш ніж 1095 днів з моменту активації.
Перед активацією до кваліфікації має бути додано хоча б один документ та підпис.
Request
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"
}
}
Response
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
}
}
Після активації кваліфікації будуть розраховані періоди:
enquiryPeriod - перші 10 повних робочих днів з моменту активації.
period - період, коли постачальники можуть подавати заявки (окрім періоду enquiryPeriod).
qualificationPeriod - останні 30 повних календарних днів кваліфікації. У цей період постачальники не можуть подавати нові заявки, але ще приймаються рішення щодо попередньо поданих заявок.
Request
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
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
}
}
Перевіримо, що містить реєстр кваліфікації:
Request
GET /api/2.5/frameworks 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-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"
}
}
Відображається id - внутрішній ідентифікатор та мітка часу dateModified.
Зміна кваліфікації¶
У статусі active можна змінювати лише деякі поля: telephone, name, email для procuringEntity.contactPoint, endDate для qualificationPeriod, description and documents.
Якщо було змінено поле qualificationPeriod.endDate - всі періоди будуть перераховані.
Request
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"
}
}
}
Response
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
}
}
Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.
Ще одна перевірка списку відображає нову дату модифікації:
Request
GET /api/2.5/frameworks 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-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"
}
}
Реєстрація заявки¶
Після активації кваліфікації, користувачі можуть зареєструвати свої заявки в період з framework.enquiryPeriod.endDate до period.Date:
Request
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
}
}
Response
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
}
}
Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.
Завантаження документації по заявці¶
Документи можливо завантажити/оновити тільки до заявки у статусі draft.
Усі операції над документами такі ж як у кваліфікації:
Request
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--
Response
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"
}
}
Request
GET /api/2.5/submissions/bcd3769e525d45fd96d69d57e88c7aaf/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": [
{
"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"
}
]
}
Видалення заявки¶
Заявка може бути видалена лише у статусі draft:
Request
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"
}
}
Response
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
}
}
Оновлення заявки¶
Заявка може бути оновлена лише у статусі draft:
Request
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": "НАЗВА"
}
]
}
}
Response
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
}
}
Активація заявки¶
Заявку можна активувати лише до настання period.endDate
Request
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"
}
}
Response
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
}
}
Після активації заявки, автоматично створюється об’єкт рішення по заявці і заповнюється поле qualificationID в заявці.
Перевіримо, що містить реєстр заявки:
Request
GET /api/2.5/submissions 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-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"
}
}
Перевіримо об’єкт рішення по заявці:
Request
GET /api/2.5/qualifications/e67e3cc511954bc5bdbf5e8d58e27d26 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
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"
}
}
Всі операції над об’єктом рішення по заявці може виконувати лише framework_owner (власник кваліфікації).
Завантаження документації до рішення по заявці¶
Документи можливо завантажити/оновити тільки до рішення у статусі pending.
Усі операції над документами такі ж як у кваліфікації:
Request
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--
Response
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"
}
}
Request
GET /api/2.5/qualifications/e67e3cc511954bc5bdbf5e8d58e27d26/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": [
{
"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"
}
]
}
Відміна рішення по заявці¶
Рішення можливо відмінити лише у статусі pending:
Request
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"
}
}
Response
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"
}
}
Після відміни рішення, пов’язана завявка змінює статус з active на complete.
Перевіримо що сталося з заявками після відміни рішення:
Request
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0/submissions 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": "ДКП «Школяр»",
"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"
}
}
Підтвердження рішення по заявці¶
Рішення можливо погодити лише у статусі pending:
Request
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"
}
}
Response
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"
}
}
Після підтвердження рішення по заявці, якщо це було перше затверджене рішення система створює реєстр з контрактом, в іншому випадку система додає контракт до реєстру.
Перевіримо кваліфікацію:
Request
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
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
}
}
Ви можете побачити, що в кваліфікації з’явилось поле agreementID, тож давайте перевіримо реєстр:
Request
GET /api/2.5/agreements/07764e512cfd4004b74989fbab149644 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-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"
}
}
Як ви можете побачити реєстр в статусі active та має контракт, щож ми можемо побачити цей реєстр в потоці даних:
Request
GET /api/2.5/agreements 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-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"
}
}
Перевіримо, що містить реєстр рішення по заявці:
Request
GET /api/2.5/qualifications 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-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"
}
}
Перевіримо всі рішення по заявці до данної кваліфікації:
Request
GET /api/2.5/frameworks/866509257c6546a088e0363315140ee0/qualifications HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
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"
}
}
Завершення кваліфікації¶
Завершення кваліфікації відбувається автоматично після настання дати qualificationPeriod.endDate.
PATCH запит з новим значенням qualificationPeriod.endDate дозволяє завершити фрейморк раніше запланованого часу, але не раніше 30 повних календарних днів з моменту зміни qualificationPeriod.endDate.