Туторіал¶
Створення кваліфікації¶
Лише майданчики з 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-03-02T00:00:00+02:00"
}
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/19554516edc64b80ad4a2834f4505fbe
{
"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": "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"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"id": "19554516edc64b80ad4a2834f4505fbe"
},
"access": {
"token": "5f94ccea4dfb4cdebd5de69ecd449013",
"transfer": "6f6038c2516d49c3921309a580209b71"
}
}
Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.
Кваліфікацію було створено у статусі draft. У цьому статусі будь-яке поле, окрім технічних, може бути змінено.
Request
PATCH /api/2.5/frameworks/19554516edc64b80ad4a2834f4505fbe?acc_token=5f94ccea4dfb4cdebd5de69ecd449013 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": "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"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"id": "19554516edc64b80ad4a2834f4505fbe"
}
}
Завантаження документації¶
Замовник може завантажити PDF файл у створениу кваліфікацію. Завантаження повинно відбуватись згідно правил Завантаження документів.
Request
POST /api/2.5/frameworks/19554516edc64b80ad4a2834f4505fbe/documents?acc_token=5f94ccea4dfb4cdebd5de69ecd449013 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/19554516edc64b80ad4a2834f4505fbe/documents/021bc47f454a4a3fa991e99268ca6148
{
"data": {
"id": "021bc47f454a4a3fa991e99268ca6148",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ae2f8182de904eef92f691e3043c4698?Signature=oDn9Tb4uL9HVxmdblzzP3ua2XJCOBnQPVthbjYy%2FrwLJ7g8mgOVRPHDO5xl4ar%2BTLHvRUbJE54VlISi6fUEICA%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/19554516edc64b80ad4a2834f4505fbe/documents?acc_token=5f94ccea4dfb4cdebd5de69ecd449013 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": "021bc47f454a4a3fa991e99268ca6148",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ae2f8182de904eef92f691e3043c4698?Signature=oDn9Tb4uL9HVxmdblzzP3ua2XJCOBnQPVthbjYy%2FrwLJ7g8mgOVRPHDO5xl4ar%2BTLHvRUbJE54VlISi6fUEICA%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/19554516edc64b80ad4a2834f4505fbe/documents?acc_token=5f94ccea4dfb4cdebd5de69ecd449013 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/19554516edc64b80ad4a2834f4505fbe/documents/d220eb62f60a4ae88103b7369be80fdb
{
"data": {
"id": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9391730d81504cb1a89d902205585047?Signature=GckTmK4GCug67LIfPCU5zhGbAKD24V4ie%2BSNl6gGpSA6PRHJFj58oE%2F4pKEWp2r4%2FeKKYwu4Ir4lH3kk%2Bbv5CQ%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/19554516edc64b80ad4a2834f4505fbe/documents/d220eb62f60a4ae88103b7369be80fdb?acc_token=5f94ccea4dfb4cdebd5de69ecd449013 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": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f0c1e419fc8f4a92b7a4d02d6bc44504?Signature=QwHlQqaj1YoV9Hj13rib4fRT3TA85dvzgEobHEOxSJ59%2FROoBNsLtX1wv91KhTzDuNWjbiWjfvopEEu1Cj5VAA%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/19554516edc64b80ad4a2834f4505fbe/documents/d220eb62f60a4ae88103b7369be80fdb?acc_token=5f94ccea4dfb4cdebd5de69ecd449013 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": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f0c1e419fc8f4a92b7a4d02d6bc44504?Signature=QwHlQqaj1YoV9Hj13rib4fRT3TA85dvzgEobHEOxSJ59%2FROoBNsLtX1wv91KhTzDuNWjbiWjfvopEEu1Cj5VAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"previousVersions": [
{
"id": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9391730d81504cb1a89d902205585047?Signature=GckTmK4GCug67LIfPCU5zhGbAKD24V4ie%2BSNl6gGpSA6PRHJFj58oE%2F4pKEWp2r4%2FeKKYwu4Ir4lH3kk%2Bbv5CQ%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/19554516edc64b80ad4a2834f4505fbe?acc_token=5f94ccea4dfb4cdebd5de69ecd449013 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": "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"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "021bc47f454a4a3fa991e99268ca6148",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ae2f8182de904eef92f691e3043c4698?Signature=oDn9Tb4uL9HVxmdblzzP3ua2XJCOBnQPVthbjYy%2FrwLJ7g8mgOVRPHDO5xl4ar%2BTLHvRUbJE54VlISi6fUEICA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9391730d81504cb1a89d902205585047?Signature=GckTmK4GCug67LIfPCU5zhGbAKD24V4ie%2BSNl6gGpSA6PRHJFj58oE%2F4pKEWp2r4%2FeKKYwu4Ir4lH3kk%2Bbv5CQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f0c1e419fc8f4a92b7a4d02d6bc44504?Signature=QwHlQqaj1YoV9Hj13rib4fRT3TA85dvzgEobHEOxSJ59%2FROoBNsLtX1wv91KhTzDuNWjbiWjfvopEEu1Cj5VAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
],
"id": "19554516edc64b80ad4a2834f4505fbe",
"next_check": "2023-01-28T00:00:00+02:00"
}
}
Після активації кваліфікації будуть розраховані періоди:
enquiryPeriod - перші 10 повних робочих днів з моменту активації.
period - період, коли постачальники можуть подавати заявки (окрім періоду enquiryPeriod).
qualificationPeriod - останні 30 повних календарних днів кваліфікації. У цей період постачальники не можуть подавати нові заявки, але ще приймаються рішення щодо попередньо поданих заявок.
Request
GET /api/2.5/frameworks/19554516edc64b80ad4a2834f4505fbe 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": "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"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "021bc47f454a4a3fa991e99268ca6148",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ae2f8182de904eef92f691e3043c4698?Signature=oDn9Tb4uL9HVxmdblzzP3ua2XJCOBnQPVthbjYy%2FrwLJ7g8mgOVRPHDO5xl4ar%2BTLHvRUbJE54VlISi6fUEICA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9391730d81504cb1a89d902205585047?Signature=GckTmK4GCug67LIfPCU5zhGbAKD24V4ie%2BSNl6gGpSA6PRHJFj58oE%2F4pKEWp2r4%2FeKKYwu4Ir4lH3kk%2Bbv5CQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f0c1e419fc8f4a92b7a4d02d6bc44504?Signature=QwHlQqaj1YoV9Hj13rib4fRT3TA85dvzgEobHEOxSJ59%2FROoBNsLtX1wv91KhTzDuNWjbiWjfvopEEu1Cj5VAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
],
"agreementID": "aee921790b7e4aa499579e35356db752",
"id": "19554516edc64b80ad4a2834f4505fbe",
"next_check": "2023-01-28T00:00:00+02:00"
}
}
Перевіримо, що містить реєстр кваліфікації:
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": "19554516edc64b80ad4a2834f4505fbe"
}
],
"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/19554516edc64b80ad4a2834f4505fbe?acc_token=5f94ccea4dfb4cdebd5de69ecd449013 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": "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"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "021bc47f454a4a3fa991e99268ca6148",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ae2f8182de904eef92f691e3043c4698?Signature=oDn9Tb4uL9HVxmdblzzP3ua2XJCOBnQPVthbjYy%2FrwLJ7g8mgOVRPHDO5xl4ar%2BTLHvRUbJE54VlISi6fUEICA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9391730d81504cb1a89d902205585047?Signature=GckTmK4GCug67LIfPCU5zhGbAKD24V4ie%2BSNl6gGpSA6PRHJFj58oE%2F4pKEWp2r4%2FeKKYwu4Ir4lH3kk%2Bbv5CQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f0c1e419fc8f4a92b7a4d02d6bc44504?Signature=QwHlQqaj1YoV9Hj13rib4fRT3TA85dvzgEobHEOxSJ59%2FROoBNsLtX1wv91KhTzDuNWjbiWjfvopEEu1Cj5VAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
],
"agreementID": "aee921790b7e4aa499579e35356db752",
"id": "19554516edc64b80ad4a2834f4505fbe",
"next_check": "2023-01-28T00:00:00+02:00"
}
}
Додатково оновлена властивість 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": "19554516edc64b80ad4a2834f4505fbe"
}
],
"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: 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": "19554516edc64b80ad4a2834f4505fbe"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/84fede82657a4f8b803500d0174ad041
{
"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": "19554516edc64b80ad4a2834f4505fbe",
"dateModified": "2023-01-17T00:00:00+02:00",
"date": "2023-01-17T00:00:00+02:00",
"owner": "broker",
"status": "draft",
"submissionType": "electronicCatalogue",
"id": "84fede82657a4f8b803500d0174ad041"
},
"access": {
"token": "0ef94fed717045cfa5ddcdda2d637d0e",
"transfer": "bebf514624f8429792fa79d9c1d49749"
}
}
Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.
Завантаження документації по заявці¶
Документи можливо завантажити/оновити тільки до заявки у статусі draft.
Усі операції над документами такі ж як у кваліфікації:
Request
POST /api/2.5/submissions/84fede82657a4f8b803500d0174ad041/documents?acc_token=0ef94fed717045cfa5ddcdda2d637d0e 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/84fede82657a4f8b803500d0174ad041/documents/50c1703ec3cd450fa45c6e4fe2ec63f8
{
"data": {
"id": "50c1703ec3cd450fa45c6e4fe2ec63f8",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4d1beea6916647c2957e61e7da9663e7?Signature=lMoye8i4aQqe2y8llAEDo1gXSGIc7EgLHJEHui4DNJsZYxhdENtropziSvTs8omT50S4ui29ddJtYmiR09L6Dg%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/84fede82657a4f8b803500d0174ad041/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": "50c1703ec3cd450fa45c6e4fe2ec63f8",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4d1beea6916647c2957e61e7da9663e7?Signature=lMoye8i4aQqe2y8llAEDo1gXSGIc7EgLHJEHui4DNJsZYxhdENtropziSvTs8omT50S4ui29ddJtYmiR09L6Dg%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/84fede82657a4f8b803500d0174ad041?acc_token=0ef94fed717045cfa5ddcdda2d637d0e 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": "50c1703ec3cd450fa45c6e4fe2ec63f8",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4d1beea6916647c2957e61e7da9663e7?Signature=lMoye8i4aQqe2y8llAEDo1gXSGIc7EgLHJEHui4DNJsZYxhdENtropziSvTs8omT50S4ui29ddJtYmiR09L6Dg%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
],
"frameworkID": "19554516edc64b80ad4a2834f4505fbe",
"dateModified": "2023-01-17T00:00:00+02:00",
"date": "2023-01-17T00:00:00+02:00",
"owner": "broker",
"status": "deleted",
"submissionType": "electronicCatalogue",
"id": "84fede82657a4f8b803500d0174ad041"
}
}
Оновлення заявки¶
Заявка може бути оновлена лише у статусі draft:
Request
PATCH /api/2.5/submissions/84fede82657a4f8b803500d0174ad041?acc_token=0ef94fed717045cfa5ddcdda2d637d0e 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": "50c1703ec3cd450fa45c6e4fe2ec63f8",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4d1beea6916647c2957e61e7da9663e7?Signature=lMoye8i4aQqe2y8llAEDo1gXSGIc7EgLHJEHui4DNJsZYxhdENtropziSvTs8omT50S4ui29ddJtYmiR09L6Dg%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
],
"frameworkID": "19554516edc64b80ad4a2834f4505fbe",
"dateModified": "2023-01-17T00:00:00+02:00",
"date": "2023-01-17T00:00:00+02:00",
"owner": "broker",
"status": "draft",
"submissionType": "electronicCatalogue",
"id": "84fede82657a4f8b803500d0174ad041"
}
}
Активація заявки¶
Заявку можна активувати лише до настання period.endDate
Request
PATCH /api/2.5/submissions/6fd0a56be1b540369988bd3cb725e6c7?acc_token=ba0f943b290e4929928a8e62be7a2108 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": "4bba1d35a1a3403cad249cfd0534b366",
"frameworkID": "19554516edc64b80ad4a2834f4505fbe",
"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": "electronicCatalogue",
"id": "6fd0a56be1b540369988bd3cb725e6c7"
}
}
Після активації заявки, автоматично створюється об’єкт рішення по заявці і заповнюється поле 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": "6fd0a56be1b540369988bd3cb725e6c7"
}
],
"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/4bba1d35a1a3403cad249cfd0534b366 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": "6fd0a56be1b540369988bd3cb725e6c7",
"frameworkID": "19554516edc64b80ad4a2834f4505fbe",
"date": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"status": "pending",
"qualificationType": "electronicCatalogue",
"id": "4bba1d35a1a3403cad249cfd0534b366"
}
}
Всі операції над об’єктом рішення по заявці може виконувати лише framework_owner (власник кваліфікації).
Завантаження документації до рішення по заявці¶
Документи можливо завантажити/оновити тільки до рішення у статусі pending.
Усі операції над документами такі ж як у кваліфікації:
Request
POST /api/2.5/qualifications/4bba1d35a1a3403cad249cfd0534b366/documents?acc_token=5f94ccea4dfb4cdebd5de69ecd449013 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/4bba1d35a1a3403cad249cfd0534b366/documents/642ad11189114d48b938810bb7515869
{
"data": {
"id": "642ad11189114d48b938810bb7515869",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/24c87269d662445eb0d26fdf2409afab?Signature=%2F0ZD7Wx%2FXaHvZCfnBLrzD7vOeX2zwkI8BdSooyVvBJasmjDazWhEKiuJ7j8gMhfR1LBonbIHe0yEIOKs4tWoDA%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/4bba1d35a1a3403cad249cfd0534b366/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": "642ad11189114d48b938810bb7515869",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/24c87269d662445eb0d26fdf2409afab?Signature=%2F0ZD7Wx%2FXaHvZCfnBLrzD7vOeX2zwkI8BdSooyVvBJasmjDazWhEKiuJ7j8gMhfR1LBonbIHe0yEIOKs4tWoDA%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/4bba1d35a1a3403cad249cfd0534b366?acc_token=5f94ccea4dfb4cdebd5de69ecd449013 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": "6fd0a56be1b540369988bd3cb725e6c7",
"frameworkID": "19554516edc64b80ad4a2834f4505fbe",
"date": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"documents": [
{
"id": "642ad11189114d48b938810bb7515869",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/24c87269d662445eb0d26fdf2409afab?Signature=%2F0ZD7Wx%2FXaHvZCfnBLrzD7vOeX2zwkI8BdSooyVvBJasmjDazWhEKiuJ7j8gMhfR1LBonbIHe0yEIOKs4tWoDA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
],
"status": "unsuccessful",
"qualificationType": "electronicCatalogue",
"id": "4bba1d35a1a3403cad249cfd0534b366"
}
}
Після відміни рішення, пов’язана завявка змінює статус з active на complete.
Перевіримо що сталося з заявками після відміни рішення:
Request
GET /api/2.5/frameworks/19554516edc64b80ad4a2834f4505fbe/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": "4bba1d35a1a3403cad249cfd0534b366",
"frameworkID": "19554516edc64b80ad4a2834f4505fbe",
"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": "6fd0a56be1b540369988bd3cb725e6c7"
},
{
"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": "7f9989cca2bd45d99a498754bd5aa6e4",
"frameworkID": "19554516edc64b80ad4a2834f4505fbe",
"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": "2424b8b0c5ba45688a777cdca4f1f698"
}
],
"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/7f9989cca2bd45d99a498754bd5aa6e4?acc_token=5f94ccea4dfb4cdebd5de69ecd449013 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": "2424b8b0c5ba45688a777cdca4f1f698",
"frameworkID": "19554516edc64b80ad4a2834f4505fbe",
"date": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00",
"status": "active",
"qualificationType": "electronicCatalogue",
"id": "7f9989cca2bd45d99a498754bd5aa6e4"
}
}
Після підтвердження рішення по заявці, якщо це було перше затверджене рішення система створює реєстр з контрактом, в іншому випадку система додає контракт до реєстру.
Перевіримо кваліфікацію:
Request
GET /api/2.5/frameworks/19554516edc64b80ad4a2834f4505fbe 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": "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"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"documents": [
{
"id": "021bc47f454a4a3fa991e99268ca6148",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ae2f8182de904eef92f691e3043c4698?Signature=oDn9Tb4uL9HVxmdblzzP3ua2XJCOBnQPVthbjYy%2FrwLJ7g8mgOVRPHDO5xl4ar%2BTLHvRUbJE54VlISi6fUEICA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9391730d81504cb1a89d902205585047?Signature=GckTmK4GCug67LIfPCU5zhGbAKD24V4ie%2BSNl6gGpSA6PRHJFj58oE%2F4pKEWp2r4%2FeKKYwu4Ir4lH3kk%2Bbv5CQ%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "d220eb62f60a4ae88103b7369be80fdb",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f0c1e419fc8f4a92b7a4d02d6bc44504?Signature=QwHlQqaj1YoV9Hj13rib4fRT3TA85dvzgEobHEOxSJ59%2FROoBNsLtX1wv91KhTzDuNWjbiWjfvopEEu1Cj5VAA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
],
"agreementID": "aee921790b7e4aa499579e35356db752",
"id": "19554516edc64b80ad4a2834f4505fbe",
"next_check": "2023-01-28T00:00:00+02:00"
}
}
Ви можете побачити, що в кваліфікації з’явилось поле agreementID, тож давайте перевіримо реєстр:
Request
GET /api/2.5/agreements/aee921790b7e4aa499579e35356db752 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": "electronicCatalogue",
"frameworkID": "19554516edc64b80ad4a2834f4505fbe",
"period": {
"startDate": "2023-01-17T00:00:00+02:00",
"endDate": "2023-03-02T00:00:00+02:00"
},
"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"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"contracts": [
{
"id": "44bb648f8cff41b3b6a376d302a8088c",
"qualificationID": "7f9989cca2bd45d99a498754bd5aa6e4",
"status": "active",
"submissionID": "2424b8b0c5ba45688a777cdca4f1f698",
"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": "bf4a154a262d41cdbf6d9410172fa89a",
"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": "aee921790b7e4aa499579e35356db752",
"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": "aee921790b7e4aa499579e35356db752"
}
],
"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": "4bba1d35a1a3403cad249cfd0534b366"
},
{
"dateModified": "2023-01-17T00:00:00+02:00",
"id": "7f9989cca2bd45d99a498754bd5aa6e4"
}
],
"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/19554516edc64b80ad4a2834f4505fbe/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": "6fd0a56be1b540369988bd3cb725e6c7",
"frameworkID": "19554516edc64b80ad4a2834f4505fbe",
"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": "642ad11189114d48b938810bb7515869",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/24c87269d662445eb0d26fdf2409afab?Signature=%2F0ZD7Wx%2FXaHvZCfnBLrzD7vOeX2zwkI8BdSooyVvBJasmjDazWhEKiuJ7j8gMhfR1LBonbIHe0yEIOKs4tWoDA%3D%3D&KeyID=a8968c46",
"datePublished": "2023-01-17T00:00:00+02:00",
"dateModified": "2023-01-17T00:00:00+02:00"
}
],
"status": "unsuccessful",
"id": "4bba1d35a1a3403cad249cfd0534b366"
},
{
"submissionID": "2424b8b0c5ba45688a777cdca4f1f698",
"frameworkID": "19554516edc64b80ad4a2834f4505fbe",
"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": "7f9989cca2bd45d99a498754bd5aa6e4"
}
],
"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.