Туторіал
Створення кваліфікації
Лише майданчики з 5м рівнем аккредитації можуть створювати кваліфікації. ProcuringEntity може бути лише типу central. Кваліфікацію можуть створювати лише активні ЦЗО зі списку: https://prozorroukr.github.io/standards/organizations/authorized_cpb.json
Створимо кваліфікацію:
Request
POST /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Content-Length: 1831
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"frameworkType": "electronicCatalogue",
"procuringEntity": {
"contactPoint": {
"telephone": "+0440000000",
"name": "Назва організації(ЦЗО)",
"email": "aa@aa.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "40996564",
"legalName": "Назва організації(ЦЗО)"
},
"kind": "central",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
},
"name": "Повна назва юридичної організації."
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2023-12-09T01:00:00+03:00"
}
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c
{
"data": {
"status": "draft",
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2023-12-09T01:00:00+03:00"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"frameworkType": "electronicCatalogue",
"procuringEntity": {
"name": "Повна назва юридичної організації.",
"identifier": {
"scheme": "UA-EDR",
"id": "40996564",
"legalName": "Назва організації(ЦЗО)"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Назва організації(ЦЗО)",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "central"
},
"prettyID": "UA-F-2023-10-10-000001",
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "1b70e498d27e4c1dba8838d6807dac0c"
},
"access": {
"token": "a7c5e242dae046dcbf238ba184295e8c",
"transfer": "1244f5ae7e994bc8a3b44b1004d5b808"
},
"config": {}
}
Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.
Кваліфікацію було створено у статусі draft. У цьому статусі будь-яке поле, окрім технічних, може бути змінено.
Request
PATCH /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c?acc_token=a7c5e242dae046dcbf238ba184295e8c 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-10-10-000001",
"title": "updated in draft status",
"description": "Назва предмета закупівлі",
"status": "draft",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"qualificationPeriod": {
"endDate": "2023-12-09T01:00:00+03:00"
},
"frameworkType": "electronicCatalogue",
"procuringEntity": {
"name": "Повна назва юридичної організації.",
"identifier": {
"scheme": "UA-EDR",
"id": "40996564",
"legalName": "Назва організації(ЦЗО)"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Назва організації(ЦЗО)",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "central"
},
"id": "1b70e498d27e4c1dba8838d6807dac0c"
},
"config": {}
}
Завантаження документації
Замовник може завантажити PDF файл у створениу кваліфікацію. Завантаження повинно відбуватись згідно правил Завантаження документів.
Request
POST /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c/documents?acc_token=a7c5e242dae046dcbf238ba184295e8c HTTP/1.0
Authorization: Bearer broker
Content-Length: 326
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "framework.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=S4ZIJmRAPa9iDj895YM90wsfSUlBfNExiNKevl9fJdtqw9PkVqhLZP4i7c8sxPSUlRFaQu7puJZzjJwxAF%2BfBg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c/documents/7137fa5d73c64e8ba56d6ea099e6059c
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "7137fa5d73c64e8ba56d6ea099e6059c",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
Request
GET /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c/documents?acc_token=a7c5e242dae046dcbf238ba184295e8c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "7137fa5d73c64e8ba56d6ea099e6059c",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
І знову можна перевірити, що є два завантажених документа.
Request
POST /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c/documents?acc_token=a7c5e242dae046dcbf238ba184295e8c HTTP/1.0
Authorization: Bearer broker
Content-Length: 344
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "framework_additional_docs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=Jm4GFi%2B6QNs2HfsaJbxzcUM4LvKg4LV5EqnlplQKL8wXIIFTUt9UUosrTwTZJlIS%2BVTktc8TzCUrffuIxejoCA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c/documents/3a01f49d8fc64d7d8b8b42d9d70b000e
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
Request
PUT /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c/documents/3a01f49d8fc64d7d8b8b42d9d70b000e?acc_token=a7c5e242dae046dcbf238ba184295e8c HTTP/1.0
Authorization: Bearer broker
Content-Length: 342
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "framework_additional_docs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=qk9TBbp52f8gzFVdjIl6Sm4v1myg%2FUxF4n2zhcsUB6YmpifdDt5vTooiZ83jFGBnMjsw6vYlTTvnXk7AEFemDg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
Request
GET /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c/documents/3a01f49d8fc64d7d8b8b42d9d70b000e?acc_token=a7c5e242dae046dcbf238ba184295e8c 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": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk",
"previousVersions": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
}
Активація кваліфікації
Наступний крок - змінити статус кваліфікації на active.
qualificationPeriod.endDate має бути у проміжку не менш ніж 30 днів і не більш ніж 1095 днів з моменту активації.
Перед активацією до кваліфікації має бути додано хоча б один документ та підпис.
Request
PATCH /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c?acc_token=a7c5e242dae046dcbf238ba184295e8c 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-10-10-000001",
"title": "updated in draft status",
"description": "Назва предмета закупівлі",
"status": "active",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "7137fa5d73c64e8ba56d6ea099e6059c",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
},
{
"id": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
},
{
"id": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
}
],
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"qualificationPeriod": {
"endDate": "2023-12-09T01:00:00+03:00",
"startDate": "2023-10-10T01:00:00+03:00"
},
"frameworkType": "electronicCatalogue",
"procuringEntity": {
"name": "Повна назва юридичної організації.",
"identifier": {
"scheme": "UA-EDR",
"id": "40996564",
"legalName": "Назва організації(ЦЗО)"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Назва організації(ЦЗО)",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "central"
},
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-25T00:00:00+03:00",
"clarificationsUntil": "2023-10-28T00:00:00+03:00"
},
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T00:00:00+02:00"
},
"next_check": "2023-11-08T00:00:00+03:00",
"id": "1b70e498d27e4c1dba8838d6807dac0c"
},
"config": {}
}
Після активації кваліфікації будуть розраховані періоди:
enquiryPeriod - перші 10 повних робочих днів з моменту активації.
period - період, коли постачальники можуть подавати заявки.
qualificationPeriod - останні 30 повних календарних днів кваліфікації. У цей період постачальники не можуть подавати нові заявки, але ще приймаються рішення щодо попередньо поданих заявок.
Request
GET /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c 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-10-10-000001",
"title": "updated in draft status",
"description": "Назва предмета закупівлі",
"status": "active",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "7137fa5d73c64e8ba56d6ea099e6059c",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
},
{
"id": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
},
{
"id": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
}
],
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T00:00:00+02:00"
},
"qualificationPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-12-09T01:00:00+03:00"
},
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-25T00:00:00+03:00",
"clarificationsUntil": "2023-10-28T00:00:00+03:00"
},
"next_check": "2023-11-08T00:00:00+03:00",
"frameworkType": "electronicCatalogue",
"procuringEntity": {
"name": "Повна назва юридичної організації.",
"identifier": {
"scheme": "UA-EDR",
"id": "40996564",
"legalName": "Назва організації(ЦЗО)"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Назва організації(ЦЗО)",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "central"
},
"agreementID": "79dd1754fcce4d448546c348a418c1da",
"id": "1b70e498d27e4c1dba8838d6807dac0c"
},
"config": {}
}
Перевіримо, що містить реєстр кваліфікації:
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-10-26T01:00:00+03:00",
"id": "1b70e498d27e4c1dba8838d6807dac0c"
}
],
"next_page": {
"offset": 1698271200.0,
"path": "/api/2.5/frameworks?offset=1698271200.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/frameworks?offset=1698271200.0"
}
}
Відображається id - внутрішній ідентифікатор та мітка часу dateModified.
Зміна кваліфікації
У статусі active можна змінювати лише деякі поля: telephone, name, email для procuringEntity.contactPoint, endDate для qualificationPeriod, description and documents.
Якщо було змінено поле qualificationPeriod.endDate - всі періоди будуть перераховані.
Request
PATCH /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c?acc_token=a7c5e242dae046dcbf238ba184295e8c 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-12-24T01:00:00+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2023-10-10-000001",
"title": "updated in draft status",
"description": "Назва предмета закупівлі1",
"status": "active",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "7137fa5d73c64e8ba56d6ea099e6059c",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
},
{
"id": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
},
{
"id": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
}
],
"agreementID": "79dd1754fcce4d448546c348a418c1da",
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-24T00:00:00+02:00"
},
"qualificationPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-12-24T01:00:00+03:00"
},
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-25T00:00:00+03:00",
"clarificationsUntil": "2023-10-28T00:00:00+03:00"
},
"next_check": "2023-11-08T00:00:00+03:00",
"frameworkType": "electronicCatalogue",
"procuringEntity": {
"name": "Повна назва юридичної організації.",
"identifier": {
"scheme": "UA-EDR",
"id": "40996564",
"legalName": "Назва організації(ЦЗО)"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "зміна",
"telephone": "+0440000002",
"email": "ab@aa.com"
},
"kind": "central"
},
"id": "1b70e498d27e4c1dba8838d6807dac0c"
},
"config": {}
}
Додатково оновлена властивість 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-10-26T01:00:00+03:00",
"id": "1b70e498d27e4c1dba8838d6807dac0c"
}
],
"next_page": {
"offset": 1698271200.0,
"path": "/api/2.5/frameworks?offset=1698271200.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/frameworks?offset=1698271200.0"
}
}
Реєстрація заявки
Після активації кваліфікації, користувачі можуть зареєструвати свої заявки в період з framework.period.startDate до framework.period.endDate:
Request
POST /api/2.5/submissions HTTP/1.0
Authorization: Bearer broker
Content-Length: 1204
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": "1b70e498d27e4c1dba8838d6807dac0c"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/438590c36742473c9858b8b466e0dde5
{
"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": "1b70e498d27e4c1dba8838d6807dac0c",
"status": "draft",
"submissionType": "electronicCatalogue",
"owner": "broker",
"date": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00",
"id": "438590c36742473c9858b8b466e0dde5"
},
"access": {
"token": "83f957759f394a5bbe3742699f503760",
"transfer": "df7fe9de29df41e3b1e7f79939326868"
},
"config": {}
}
Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.
Завантаження документації по заявці
Документи можливо завантажити/оновити тільки до заявки у статусі draft.
Усі операції над документами такі ж як у кваліфікації:
Request
POST /api/2.5/submissions/438590c36742473c9858b8b466e0dde5/documents?acc_token=83f957759f394a5bbe3742699f503760 HTTP/1.0
Authorization: Bearer broker
Content-Length: 332
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "submission_docs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d9006a35da3b4389bf1be5cd34a3071a?Signature=AAVs8klPItfOgpXmSLKSdPVkqkyurE0Cb6Ert1YivEQN3KXJ33xrlDNzdtvxaxnnzkmwnZThFNaJoHXuxs4%2FBQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/438590c36742473c9858b8b466e0dde5/documents/e1a378fd7df247249af772576e1f1154
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d9006a35da3b4389bf1be5cd34a3071a?Signature=i8SHbMgp8F%2BDTPKCmPFxk0f7CTww8xsbmAdwhOky%2FgyFcAIuTveMDAT69TBjFyLOOYgdCosl%2FL%2FQ6JWzoPq%2BCA%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "e1a378fd7df247249af772576e1f1154",
"datePublished": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00"
}
}
Request
GET /api/2.5/submissions/438590c36742473c9858b8b466e0dde5/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d9006a35da3b4389bf1be5cd34a3071a?Signature=i8SHbMgp8F%2BDTPKCmPFxk0f7CTww8xsbmAdwhOky%2FgyFcAIuTveMDAT69TBjFyLOOYgdCosl%2FL%2FQ6JWzoPq%2BCA%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "e1a378fd7df247249af772576e1f1154",
"datePublished": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00"
}
]
}
Видалення заявки
Заявка може бути видалена лише у статусі draft:
Request
PATCH /api/2.5/submissions/438590c36742473c9858b8b466e0dde5?acc_token=83f957759f394a5bbe3742699f503760 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": "e1a378fd7df247249af772576e1f1154",
"datePublished": "2023-10-26T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d9006a35da3b4389bf1be5cd34a3071a?Signature=i8SHbMgp8F%2BDTPKCmPFxk0f7CTww8xsbmAdwhOky%2FgyFcAIuTveMDAT69TBjFyLOOYgdCosl%2FL%2FQ6JWzoPq%2BCA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-26T01:00:00+03:00",
"language": "uk"
}
],
"frameworkID": "1b70e498d27e4c1dba8838d6807dac0c",
"status": "deleted",
"dateModified": "2023-10-26T01:00:00+03:00",
"date": "2023-10-26T01:00:00+03:00",
"owner": "broker",
"submissionType": "electronicCatalogue",
"id": "438590c36742473c9858b8b466e0dde5"
},
"config": {}
}
Оновлення заявки
Заявка може бути оновлена лише у статусі draft:
Request
PATCH /api/2.5/submissions/438590c36742473c9858b8b466e0dde5?acc_token=83f957759f394a5bbe3742699f503760 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": "e1a378fd7df247249af772576e1f1154",
"datePublished": "2023-10-26T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d9006a35da3b4389bf1be5cd34a3071a?Signature=i8SHbMgp8F%2BDTPKCmPFxk0f7CTww8xsbmAdwhOky%2FgyFcAIuTveMDAT69TBjFyLOOYgdCosl%2FL%2FQ6JWzoPq%2BCA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-26T01:00:00+03:00",
"language": "uk"
}
],
"frameworkID": "1b70e498d27e4c1dba8838d6807dac0c",
"status": "draft",
"dateModified": "2023-10-26T01:00:00+03:00",
"date": "2023-10-26T01:00:00+03:00",
"owner": "broker",
"submissionType": "electronicCatalogue",
"id": "438590c36742473c9858b8b466e0dde5"
},
"config": {}
}
Активація заявки
Заявку можна активувати лише до настання period.endDate
Request
PATCH /api/2.5/submissions/8b8465c39dc3471ba57b324f2ed988fa?acc_token=159eea746141421f80c576dda32161e2 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"
}
}
],
"frameworkID": "1b70e498d27e4c1dba8838d6807dac0c",
"status": "active",
"dateModified": "2023-10-26T01:00:00+03:00",
"date": "2023-10-26T01:00:00+03:00",
"owner": "broker",
"submissionType": "electronicCatalogue",
"datePublished": "2023-10-26T01:00:00+03:00",
"qualificationID": "838474d50c0a49d79fe82febe17a3c1e",
"id": "8b8465c39dc3471ba57b324f2ed988fa"
},
"config": {}
}
Після активації заявки, автоматично створюється об’єкт рішення по заявці і заповнюється поле 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-10-26T01:00:00+03:00",
"id": "8b8465c39dc3471ba57b324f2ed988fa"
}
],
"next_page": {
"offset": 1698271200.0,
"path": "/api/2.5/submissions?offset=1698271200.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?offset=1698271200.0"
}
}
Перевіримо об’єкт рішення по заявці:
Request
GET /api/2.5/qualifications/838474d50c0a49d79fe82febe17a3c1e 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": "8b8465c39dc3471ba57b324f2ed988fa",
"frameworkID": "1b70e498d27e4c1dba8838d6807dac0c",
"status": "pending",
"date": "2023-10-26T01:00:00+03:00",
"qualificationType": "electronicCatalogue",
"dateModified": "2023-10-26T01:00:00+03:00",
"id": "838474d50c0a49d79fe82febe17a3c1e"
},
"config": {}
}
Всі операції над об’єктом рішення по заявці може виконувати лише framework_owner (власник кваліфікації).
Завантаження документації до рішення по заявці
Документи можливо завантажити/оновити тільки до рішення у статусі pending.
Усі операції над документами такі ж як у кваліфікації:
Request
POST /api/2.5/qualifications/838474d50c0a49d79fe82febe17a3c1e/documents?acc_token=a7c5e242dae046dcbf238ba184295e8c HTTP/1.0
Authorization: Bearer broker
Content-Length: 340
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "qualification.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3cd211e97f284e79b39a6dbba518a484?Signature=G0iQnXOb8ERMANs4d%2F1v67Ah85fwi%2BBr3e40dr3%2Fufmg3O%2BN1dgK%2FmScN%2F7KWFMzOUReuDcqRdenVrM0o5ewCw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/qualifications/838474d50c0a49d79fe82febe17a3c1e/documents/c03b20fc63b44ed99250c3b8fa3cd7f0
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3cd211e97f284e79b39a6dbba518a484?Signature=L6flukUBvXZ%2F18tixcMYbXP%2F1CyvbCcYjz6wA0fqGvgls51%2BUXwcEHzTFtNicsz8iz2sObTsvwwOOOQ7bW7NDA%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "c03b20fc63b44ed99250c3b8fa3cd7f0",
"datePublished": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00"
}
}
Request
GET /api/2.5/qualifications/838474d50c0a49d79fe82febe17a3c1e/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3cd211e97f284e79b39a6dbba518a484?Signature=L6flukUBvXZ%2F18tixcMYbXP%2F1CyvbCcYjz6wA0fqGvgls51%2BUXwcEHzTFtNicsz8iz2sObTsvwwOOOQ7bW7NDA%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "c03b20fc63b44ed99250c3b8fa3cd7f0",
"datePublished": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00"
}
]
}
Відміна рішення по заявці
Рішення можливо відмінити лише у статусі pending:
Request
PATCH /api/2.5/qualifications/838474d50c0a49d79fe82febe17a3c1e?acc_token=a7c5e242dae046dcbf238ba184295e8c 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": {
"documents": [
{
"id": "c03b20fc63b44ed99250c3b8fa3cd7f0",
"datePublished": "2023-10-26T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3cd211e97f284e79b39a6dbba518a484?Signature=L6flukUBvXZ%2F18tixcMYbXP%2F1CyvbCcYjz6wA0fqGvgls51%2BUXwcEHzTFtNicsz8iz2sObTsvwwOOOQ7bW7NDA%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-26T01:00:00+03:00",
"language": "uk"
}
],
"submissionID": "8b8465c39dc3471ba57b324f2ed988fa",
"frameworkID": "1b70e498d27e4c1dba8838d6807dac0c",
"status": "unsuccessful",
"date": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00",
"qualificationType": "electronicCatalogue",
"id": "838474d50c0a49d79fe82febe17a3c1e"
},
"config": {}
}
Після відміни рішення, пов’язана завявка змінює статус з active на complete.
Перевіримо що сталося з заявками після відміни рішення:
Request
GET /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c/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": "838474d50c0a49d79fe82febe17a3c1e",
"frameworkID": "1b70e498d27e4c1dba8838d6807dac0c",
"status": "complete",
"dateCreated": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00",
"date": "2023-10-26T01:00:00+03:00",
"datePublished": "2023-10-26T01:00:00+03:00",
"id": "8b8465c39dc3471ba57b324f2ed988fa"
},
{
"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": "520521800ae94c52b85de3898d2c1a84",
"frameworkID": "1b70e498d27e4c1dba8838d6807dac0c",
"status": "complete",
"dateCreated": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00",
"date": "2023-10-26T01:00:00+03:00",
"datePublished": "2023-10-26T01:00:00+03:00",
"id": "c032bcbca6d942d88bfa243b8b266b15"
}
],
"next_page": {
"offset": 1698271200.0,
"path": "/api/2.5/submissions?offset=1698271200.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?offset=1698271200.0"
}
}
Підтвердження рішення по заявці
Рішення можливо погодити лише у статусі pending:
Request
PATCH /api/2.5/qualifications/520521800ae94c52b85de3898d2c1a84?acc_token=a7c5e242dae046dcbf238ba184295e8c 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": "c032bcbca6d942d88bfa243b8b266b15",
"frameworkID": "1b70e498d27e4c1dba8838d6807dac0c",
"status": "active",
"date": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00",
"qualificationType": "electronicCatalogue",
"id": "520521800ae94c52b85de3898d2c1a84"
},
"config": {}
}
Після підтвердження рішення по заявці, якщо це було перше затверджене рішення система створює реєстр з контрактом, в іншому випадку система додає контракт до реєстру.
Перевіримо кваліфікацію:
Request
GET /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c 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-10-10-000001",
"title": "updated in draft status",
"description": "Назва предмета закупівлі",
"status": "active",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "7137fa5d73c64e8ba56d6ea099e6059c",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
},
{
"id": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
},
{
"id": "3a01f49d8fc64d7d8b8b42d9d70b000e",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
"dateModified": "2023-10-10T01:00:00+03:00",
"language": "uk"
}
],
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T00:00:00+02:00"
},
"qualificationPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-12-09T01:00:00+03:00"
},
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-25T00:00:00+03:00",
"clarificationsUntil": "2023-10-28T00:00:00+03:00"
},
"next_check": "2023-11-08T00:00:00+03:00",
"frameworkType": "electronicCatalogue",
"procuringEntity": {
"name": "Повна назва юридичної організації.",
"identifier": {
"scheme": "UA-EDR",
"id": "40996564",
"legalName": "Назва організації(ЦЗО)"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Назва організації(ЦЗО)",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "central"
},
"agreementID": "79dd1754fcce4d448546c348a418c1da",
"id": "1b70e498d27e4c1dba8838d6807dac0c"
},
"config": {}
}
Ви можете побачити, що в кваліфікації з’явилось поле agreementID, тож давайте перевіримо реєстр:
Request
GET /api/2.5/agreements/79dd1754fcce4d448546c348a418c1da HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2023-10-26-000001",
"status": "active",
"period": {
"startDate": "2023-10-26T01:00:00+03:00",
"endDate": "2023-12-09T01:00:00+03:00"
},
"contracts": [
{
"id": "7407b24d82f448a299f6cd77f4e38c12",
"qualificationID": "520521800ae94c52b85de3898d2c1a84",
"status": "active",
"submissionID": "c032bcbca6d942d88bfa243b8b266b15",
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"scale": "micro",
"contactPoint": {
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com",
"telephone": "+380432216930"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
}
}
],
"milestones": [
{
"id": "a9d6e91f6b8646959772df4ef205282d",
"type": "activation",
"status": "scheduled",
"dueDate": "2023-12-09T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00"
}
],
"date": "2023-10-26T01:00:00+03:00"
}
],
"dateCreated": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00",
"date": "2023-10-26T01:00:00+03:00",
"owner": "broker",
"agreementType": "electronicCatalogue",
"procuringEntity": {
"name": "Повна назва юридичної організації.",
"identifier": {
"scheme": "UA-EDR",
"id": "40996564",
"legalName": "Назва організації(ЦЗО)"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Назва організації(ЦЗО)",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "central"
},
"frameworkID": "1b70e498d27e4c1dba8838d6807dac0c",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"next_check": "2023-12-09T01:00:00+03:00",
"id": "79dd1754fcce4d448546c348a418c1da"
},
"config": {}
}
Як ви можете побачити реєстр в статусі 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-10-26T01:00:00+03:00",
"id": "79dd1754fcce4d448546c348a418c1da"
}
],
"next_page": {
"offset": 1698271200.0,
"path": "/api/2.5/agreements?offset=1698271200.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?offset=1698271200.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-10-26T01:00:00+03:00",
"id": "838474d50c0a49d79fe82febe17a3c1e"
},
{
"dateModified": "2023-10-26T01:00:00+03:00",
"id": "520521800ae94c52b85de3898d2c1a84"
}
],
"next_page": {
"offset": 1698271200.0,
"path": "/api/2.5/qualifications?offset=1698271200.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?offset=1698271200.0"
}
}
Перевіримо всі рішення по заявці до данної кваліфікації:
Request
GET /api/2.5/frameworks/1b70e498d27e4c1dba8838d6807dac0c/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": [
{
"documents": [
{
"id": "c03b20fc63b44ed99250c3b8fa3cd7f0",
"datePublished": "2023-10-26T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications/838474d50c0a49d79fe82febe17a3c1e/documents/c03b20fc63b44ed99250c3b8fa3cd7f0?download=3cd211e97f284e79b39a6dbba518a484",
"dateModified": "2023-10-26T01:00:00+03:00",
"language": "uk"
}
],
"submissionID": "8b8465c39dc3471ba57b324f2ed988fa",
"frameworkID": "1b70e498d27e4c1dba8838d6807dac0c",
"status": "unsuccessful",
"date": "2023-10-26T01:00:00+03:00",
"dateCreated": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00",
"id": "838474d50c0a49d79fe82febe17a3c1e"
},
{
"submissionID": "c032bcbca6d942d88bfa243b8b266b15",
"frameworkID": "1b70e498d27e4c1dba8838d6807dac0c",
"status": "active",
"date": "2023-10-26T01:00:00+03:00",
"dateCreated": "2023-10-26T01:00:00+03:00",
"dateModified": "2023-10-26T01:00:00+03:00",
"id": "520521800ae94c52b85de3898d2c1a84"
}
],
"next_page": {
"offset": 1698271200.0,
"path": "/api/2.5/qualifications?offset=1698271200.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?offset=1698271200.0"
}
}
Завершення кваліфікації
Завершення кваліфікації відбувається автоматично після настання дати qualificationPeriod.endDate.
PATCH запит з новим значенням qualificationPeriod.endDate дозволяє завершити фрейморк раніше запланованого часу, але не раніше 30 повних календарних днів з моменту зміни qualificationPeriod.endDate.