Туторіал
Створення кваліфікації
Створимо кваліфікацію:
POST /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"frameworkType": "internationalFinancialInstitutions",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"name": "Державне управління справами"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2028-02-05T00:00:00+02:00"
}
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/932c7023588f40f4aec26aef109f4998
{
"data": {
"status": "draft",
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2028-02-05T00:00:00+02:00"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"frameworkType": "internationalFinancialInstitutions",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "general"
},
"prettyID": "UA-F-2027-01-01-000001",
"owner": "broker",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "932c7023588f40f4aec26aef109f4998"
},
"access": {
"token": "c029ed2daf2c446a9adf956529cf0bc3",
"transfer": "1ffab0e1154d4a23bf7c3e876c26dbea"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.
Кваліфікацію було створено у статусі draft. У цьому статусі будь-яке поле, окрім технічних, може бути змінено.
PATCH /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"procuringEntity": {
"contactPoint": {
"telephone": "+0440000001"
}
},
"title": "updated in draft status"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2027-01-01-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": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"qualificationPeriod": {
"endDate": "2028-02-05T00:00:00+02:00"
},
"frameworkType": "internationalFinancialInstitutions",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"id": "932c7023588f40f4aec26aef109f4998"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
Завантаження документації
Замовник може завантажити PDF файл у створениу кваліфікацію. Завантаження повинно відбуватись згідно правил Завантаження документів.
POST /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/documents?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "framework.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3d4ffdd9cb3e4b17a82a3c4ff17b9d36?Signature=JelzpZx4DZqA9ARXiecWl7r8bF0KLM5gkLdx3Gn6M880ALIr8YST1jVePz2USu1u70VELnWBdi2HOp0%2Ftlj0Cg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/documents/e99f835519da48e18d0d73857a65d70c
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3d4ffdd9cb3e4b17a82a3c4ff17b9d36?Signature=tIDXH8wnBO3JBgUN3GoSoE4sW4BjxGNxkWSyxNiflNyarXJhL52k9CgC3cpQRNCO0JoJ2nrhXfCkIhHQJVVSCg%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "e99f835519da48e18d0d73857a65d70c",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
}
Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
GET /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/documents?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
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/3d4ffdd9cb3e4b17a82a3c4ff17b9d36?Signature=tIDXH8wnBO3JBgUN3GoSoE4sW4BjxGNxkWSyxNiflNyarXJhL52k9CgC3cpQRNCO0JoJ2nrhXfCkIhHQJVVSCg%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "e99f835519da48e18d0d73857a65d70c",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
]
}
І знову можна перевірити, що є два завантажених документа.
POST /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/documents?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
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/a3b4750dd6e84c9ba06bcca72560bf2d?Signature=U3GdeiB45xfvNAL87CZ8tsA13pCralT8cEgHeTnXh%2FK1UXNwAePEVaruJlUSLXLa5yaNym3XvWgdRQwNwHkWDQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/documents/f6e683bc45f347049d9b9c740170828c
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a3b4750dd6e84c9ba06bcca72560bf2d?Signature=vCJf2VCGiuPf5SeqwD1awYCS9ZTLVHvhV3fzbpHLLC3w3Pr0UVL8oVBxYX8H7abDCBGS%2FLg7mix%2BK8hsWPTgAA%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
PUT /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/documents/f6e683bc45f347049d9b9c740170828c?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
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/2365a5fbfc964de2a60ddfb175a6cc42?Signature=mUmGJC9xL%2Bv4D05v3EfGyP%2B5Kd1JZBrhs4h8IA6Hmd6C03lh7kcEHMLsD2l0VEsg7auhvBlZNXV57gb4zLhIBA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/2365a5fbfc964de2a60ddfb175a6cc42?Signature=EQ2YakEGQeWMwX3tiOKOcxsLShIUEa%2B7bB6wmpMCqaC99IWYdRUihRRIElynMe9Ko105jWenrapYnCDSRhGfDw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
GET /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/documents/f6e683bc45f347049d9b9c740170828c?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/2365a5fbfc964de2a60ddfb175a6cc42?Signature=EQ2YakEGQeWMwX3tiOKOcxsLShIUEa%2B7bB6wmpMCqaC99IWYdRUihRRIElynMe9Ko105jWenrapYnCDSRhGfDw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk",
"previousVersions": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a3b4750dd6e84c9ba06bcca72560bf2d?Signature=vCJf2VCGiuPf5SeqwD1awYCS9ZTLVHvhV3fzbpHLLC3w3Pr0UVL8oVBxYX8H7abDCBGS%2FLg7mix%2BK8hsWPTgAA%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
]
}
}
Активація кваліфікації
Наступний крок - змінити статус кваліфікації на active.
qualificationPeriod.endDate має бути у проміжку не менш ніж 365 днів і не більш ніж 1461 днів з моменту активації.
Перед активацією до кваліфікації має бути додано хоча б один документ та підпис.
PATCH /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2027-01-01-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": "e99f835519da48e18d0d73857a65d70c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3d4ffdd9cb3e4b17a82a3c4ff17b9d36?Signature=tIDXH8wnBO3JBgUN3GoSoE4sW4BjxGNxkWSyxNiflNyarXJhL52k9CgC3cpQRNCO0JoJ2nrhXfCkIhHQJVVSCg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a3b4750dd6e84c9ba06bcca72560bf2d?Signature=vCJf2VCGiuPf5SeqwD1awYCS9ZTLVHvhV3fzbpHLLC3w3Pr0UVL8oVBxYX8H7abDCBGS%2FLg7mix%2BK8hsWPTgAA%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/2365a5fbfc964de2a60ddfb175a6cc42?Signature=EQ2YakEGQeWMwX3tiOKOcxsLShIUEa%2B7bB6wmpMCqaC99IWYdRUihRRIElynMe9Ko105jWenrapYnCDSRhGfDw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
],
"owner": "broker",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
},
"frameworkType": "internationalFinancialInstitutions",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-11T00:00:00+02:00",
"clarificationsUntil": "2027-01-14T00:00:00+02:00"
},
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-01-06T00:00:00+02:00"
},
"next_check": "2027-01-11T00:00:00+02:00",
"id": "932c7023588f40f4aec26aef109f4998"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
Після активації кваліфікації будуть розраховані періоди:
enquiryPeriod - перші 10 повних робочих днів з моменту активації.
period - період, коли постачальники можуть подавати заявки.
qualificationPeriod - останні 30 повних календарних днів кваліфікації. У цей період постачальники не можуть подавати нові заявки, але ще приймаються рішення щодо попередньо поданих заявок.
GET /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2027-01-01-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": "e99f835519da48e18d0d73857a65d70c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3d4ffdd9cb3e4b17a82a3c4ff17b9d36?Signature=tIDXH8wnBO3JBgUN3GoSoE4sW4BjxGNxkWSyxNiflNyarXJhL52k9CgC3cpQRNCO0JoJ2nrhXfCkIhHQJVVSCg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a3b4750dd6e84c9ba06bcca72560bf2d?Signature=vCJf2VCGiuPf5SeqwD1awYCS9ZTLVHvhV3fzbpHLLC3w3Pr0UVL8oVBxYX8H7abDCBGS%2FLg7mix%2BK8hsWPTgAA%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/2365a5fbfc964de2a60ddfb175a6cc42?Signature=EQ2YakEGQeWMwX3tiOKOcxsLShIUEa%2B7bB6wmpMCqaC99IWYdRUihRRIElynMe9Ko105jWenrapYnCDSRhGfDw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
],
"owner": "broker",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
},
"frameworkType": "internationalFinancialInstitutions",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-11T00:00:00+02:00",
"clarificationsUntil": "2027-01-14T00:00:00+02:00"
},
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-01-06T00:00:00+02:00"
},
"next_check": "2027-01-11T00:00:00+02:00",
"agreementID": "4860703af9044dc19e30f45f4e537fb9",
"id": "932c7023588f40f4aec26aef109f4998"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
Перевіримо, що містить реєстр кваліфікації:
GET /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "932c7023588f40f4aec26aef109f4998"
}
],
"next_page": {
"offset": "1800136800.0.1.080c38bb7ac32c32810b3f3e370c08a2",
"path": "/api/2.5/frameworks?offset=1800136800.0.1.080c38bb7ac32c32810b3f3e370c08a2",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/frameworks?offset=1800136800.0.1.080c38bb7ac32c32810b3f3e370c08a2"
}
}
Відображається id - внутрішній ідентифікатор та мітка часу dateModified.
Зміна кваліфікації
У статусі active можна змінювати лише деякі поля: telephone, name, email для procuringEntity.contactPoint, description and documents.
PATCH /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"procuringEntity": {
"contactPoint": {
"telephone": "+0440000002",
"name": "зміна",
"email": "ab@aa.com"
}
},
"description": "Назва предмета закупівлі1"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2027-01-01-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": "e99f835519da48e18d0d73857a65d70c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3d4ffdd9cb3e4b17a82a3c4ff17b9d36?Signature=tIDXH8wnBO3JBgUN3GoSoE4sW4BjxGNxkWSyxNiflNyarXJhL52k9CgC3cpQRNCO0JoJ2nrhXfCkIhHQJVVSCg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a3b4750dd6e84c9ba06bcca72560bf2d?Signature=vCJf2VCGiuPf5SeqwD1awYCS9ZTLVHvhV3fzbpHLLC3w3Pr0UVL8oVBxYX8H7abDCBGS%2FLg7mix%2BK8hsWPTgAA%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/2365a5fbfc964de2a60ddfb175a6cc42?Signature=EQ2YakEGQeWMwX3tiOKOcxsLShIUEa%2B7bB6wmpMCqaC99IWYdRUihRRIElynMe9Ko105jWenrapYnCDSRhGfDw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
],
"agreementID": "4860703af9044dc19e30f45f4e537fb9",
"owner": "broker",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-01-06T00:00:00+02:00"
},
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-11T00:00:00+02:00",
"clarificationsUntil": "2027-01-14T00:00:00+02:00"
},
"next_check": "2027-01-11T00:00:00+02:00",
"frameworkType": "internationalFinancialInstitutions",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "зміна",
"telephone": "+0440000002",
"email": "ab@aa.com"
},
"kind": "general"
},
"id": "932c7023588f40f4aec26aef109f4998"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.
Ще одна перевірка списку відображає нову дату модифікації:
GET /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "932c7023588f40f4aec26aef109f4998"
}
],
"next_page": {
"offset": "1800136800.0.1.080c38bb7ac32c32810b3f3e370c08a2",
"path": "/api/2.5/frameworks?offset=1800136800.0.1.080c38bb7ac32c32810b3f3e370c08a2",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/frameworks?offset=1800136800.0.1.080c38bb7ac32c32810b3f3e370c08a2"
}
}
Зміна qualificationPeriod в активному відборі
Також у статусі active можна замінити endDate поле в qualificationPeriod, але це можна зробити вже через окремий ендпоінт.
Існують наступні валідації для зміни терміну дії відбору qualificationPeriod.endDate:
qualificationPeriod.endDate couldn’t be less than 30 full calendar days from now
qualificationPeriod.endDate couldn’t be more than 1461 full calendar days from now
Зміну терміну дії відбору може виконувати лише framework_owner (власник кваліфікації) використовуючи ченжи.
Поля, які необхідно заповнити для зміни терміну дії відбору:
qualificationPeriod.endDate (in change.modifications)
rationale
rationaleType
documents (optional)
Спробуємо змінити qualificationPeriod.endDate на ранню дату:
POST /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/changes?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"modifications": {
"qualificationPeriod": {
"endDate": "2027-02-01T00:00:00+02:00"
}
},
"rationaleType": "other",
"rationale": "Треба закінчити швидше відбір"
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "modifications.qualificationPeriod",
"description": "qualificationPeriod.endDate couldn't be less than 30 full calendar days from now"
}
]
}
Спробуємо змінити qualificationPeriod.endDate на пізню дату:
POST /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/changes?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"modifications": {
"qualificationPeriod": {
"endDate": "2031-02-25T00:00:00+02:00"
}
},
"rationaleType": "other",
"rationale": "Треба подовжити відбір"
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "modifications.qualificationPeriod",
"description": "qualificationPeriod.endDate couldn't be more than 1461 full calendar days from now"
}
]
}
Успішна зміна терміну дії відбору:
POST /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/changes?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"modifications": {
"qualificationPeriod": {
"endDate": "2027-03-08T00:00:00+02:00"
}
},
"rationaleType": "noDemandFramework",
"rationale": "Відсутня подальша потреба в закупівлі з використанням рамкової угоди"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/changes/35e6d8e24a3d411d9db74f984fecbbd9
{
"data": {
"rationale": "Відсутня подальша потреба в закупівлі з використанням рамкової угоди",
"rationaleType": "noDemandFramework",
"modifications": {
"qualificationPeriod": {
"endDate": "2027-03-08T00:00:00+02:00"
}
},
"id": "35e6d8e24a3d411d9db74f984fecbbd9",
"previous": {
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
}
},
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Необхідно вказати параметр opt_context=true для того, щоб отримати додаткову інформацію з відбору для підписання змін:
GET /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/changes/35e6d8e24a3d411d9db74f984fecbbd9?acc_token=c029ed2daf2c446a9adf956529cf0bc3&opt_context=true HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Відсутня подальша потреба в закупівлі з використанням рамкової угоди",
"rationaleType": "noDemandFramework",
"modifications": {
"qualificationPeriod": {
"endDate": "2027-03-08T00:00:00+02:00"
}
},
"id": "35e6d8e24a3d411d9db74f984fecbbd9",
"previous": {
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
}
},
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
},
"context": {
"framework": {
"prettyID": "UA-F-2027-01-01-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": "e99f835519da48e18d0d73857a65d70c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3d4ffdd9cb3e4b17a82a3c4ff17b9d36?Signature=tIDXH8wnBO3JBgUN3GoSoE4sW4BjxGNxkWSyxNiflNyarXJhL52k9CgC3cpQRNCO0JoJ2nrhXfCkIhHQJVVSCg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a3b4750dd6e84c9ba06bcca72560bf2d?Signature=vCJf2VCGiuPf5SeqwD1awYCS9ZTLVHvhV3fzbpHLLC3w3Pr0UVL8oVBxYX8H7abDCBGS%2FLg7mix%2BK8hsWPTgAA%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/2365a5fbfc964de2a60ddfb175a6cc42?Signature=EQ2YakEGQeWMwX3tiOKOcxsLShIUEa%2B7bB6wmpMCqaC99IWYdRUihRRIElynMe9Ko105jWenrapYnCDSRhGfDw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
],
"agreementID": "4860703af9044dc19e30f45f4e537fb9",
"owner": "broker",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-02-06T00:00:00+02:00"
},
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-03-08T00:00:00+02:00"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-11T00:00:00+02:00",
"clarificationsUntil": "2027-01-14T00:00:00+02:00"
},
"next_check": "2027-01-11T00:00:00+02:00",
"frameworkType": "internationalFinancialInstitutions",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "зміна",
"telephone": "+0440000002",
"email": "ab@aa.com"
},
"kind": "general"
},
"changes": [
{
"rationale": "Відсутня подальша потреба в закупівлі з використанням рамкової угоди",
"rationaleType": "noDemandFramework",
"modifications": {
"qualificationPeriod": {
"endDate": "2027-03-08T00:00:00+02:00"
}
},
"id": "35e6d8e24a3d411d9db74f984fecbbd9",
"previous": {
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
}
},
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
],
"id": "932c7023588f40f4aec26aef109f4998"
}
}
}
Для детальної інформації про відображення інформації для підписів, дивитися тут: Відображення інформації для підписів.
Тепер необхідно додати документ підпису до змін:
POST /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/changes/35e6d8e24a3d411d9db74f984fecbbd9/documents?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "sign.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/894958610c6840238ceec5f7cb544a0c?Signature=vDdyFX4ziW7HMh449tX1ZnzukF%2BZeMtmSgxmJysOPGGIjoFFj720m9Y58okRB3m8PijO7qxUApWV1Pm8d%2FroCw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/changes/35e6d8e24a3d411d9db74f984fecbbd9/documents/3fc3aab850b74e2ab3776d12df5ab437
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/894958610c6840238ceec5f7cb544a0c?Signature=HMPCR%2BXKqM3nPrpTkJ%2FyKDLZOgR%2BDx8EPTKvfykFgHWrtPf1hbGQQZGQBktK6D%2Bz5WK4iulCxJXyHgcHaPu0Bw%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "3fc3aab850b74e2ab3776d12df5ab437",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Якщо було змінено поле qualificationPeriod.endDate - всі періоди будуть перераховані.
Подивимося тепер на відбір:
GET /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2027-01-01-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": "e99f835519da48e18d0d73857a65d70c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3d4ffdd9cb3e4b17a82a3c4ff17b9d36?Signature=tIDXH8wnBO3JBgUN3GoSoE4sW4BjxGNxkWSyxNiflNyarXJhL52k9CgC3cpQRNCO0JoJ2nrhXfCkIhHQJVVSCg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a3b4750dd6e84c9ba06bcca72560bf2d?Signature=vCJf2VCGiuPf5SeqwD1awYCS9ZTLVHvhV3fzbpHLLC3w3Pr0UVL8oVBxYX8H7abDCBGS%2FLg7mix%2BK8hsWPTgAA%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/2365a5fbfc964de2a60ddfb175a6cc42?Signature=EQ2YakEGQeWMwX3tiOKOcxsLShIUEa%2B7bB6wmpMCqaC99IWYdRUihRRIElynMe9Ko105jWenrapYnCDSRhGfDw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
],
"agreementID": "4860703af9044dc19e30f45f4e537fb9",
"owner": "broker",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-02-06T00:00:00+02:00"
},
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-03-08T00:00:00+02:00"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-11T00:00:00+02:00",
"clarificationsUntil": "2027-01-14T00:00:00+02:00"
},
"next_check": "2027-01-11T00:00:00+02:00",
"frameworkType": "internationalFinancialInstitutions",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "зміна",
"telephone": "+0440000002",
"email": "ab@aa.com"
},
"kind": "general"
},
"changes": [
{
"rationale": "Відсутня подальша потреба в закупівлі з використанням рамкової угоди",
"rationaleType": "noDemandFramework",
"modifications": {
"qualificationPeriod": {
"endDate": "2027-03-08T00:00:00+02:00"
}
},
"id": "35e6d8e24a3d411d9db74f984fecbbd9",
"previous": {
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
}
},
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/894958610c6840238ceec5f7cb544a0c?Signature=HMPCR%2BXKqM3nPrpTkJ%2FyKDLZOgR%2BDx8EPTKvfykFgHWrtPf1hbGQQZGQBktK6D%2Bz5WK4iulCxJXyHgcHaPu0Bw%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "3fc3aab850b74e2ab3776d12df5ab437",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
]
}
],
"id": "932c7023588f40f4aec26aef109f4998"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
Тепер у відборі існує новий об’єкт changes з попереднім значенням qualificationPeriod.endDate і новим значенням. Всі зміни терміну дії відбору будуть збережені в цьому об’єкті.
Реєстрація заявки
Після активації кваліфікації, користувачі можуть зареєструвати свої заявки в період з framework.period.startDate до framework.period.endDate:
POST /api/2.5/submissions HTTP/1.0
Authorization: Bearer broker
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": "932c7023588f40f4aec26aef109f4998"
},
"config": {
"restricted": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b
{
"data": {
"tenderers": [
{
"name": "ДКП «Школяр»",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100"
},
"contactPoint": {
"name": "Сергій Олексюк",
"telephone": "+380432216930",
"email": "soleksuk@gmail.com"
}
}
],
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"status": "draft",
"submissionType": "internationalFinancialInstitutions",
"owner": "broker",
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "9c1ec0cf104142db84d35398c609cd4b"
},
"access": {
"token": "2cac1d46cb17481595607b2d32aef48f",
"transfer": "c36f4d407b944435a27a9eeaf46cd62e"
},
"config": {
"restricted": false
}
}
Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.
Завантаження документації по заявці
Документи можливо завантажити/оновити тільки до заявки у статусі draft.
Усі операції над документами такі ж як у кваліфікації:
POST /api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents?acc_token=2cac1d46cb17481595607b2d32aef48f HTTP/1.0
Authorization: Bearer broker
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/07db5aa1fd3447f095c5729879cbba50?Signature=QTKoaklC0sxerp1WsNDLCHHYMzmXzI1z%2BdTJrBjFd1wf9mpsmrMzbW755MNMqV5%2FIcgBxM9rsE7U27PuQwkSDA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents/3c54826fd7094702be0dda50a229e372
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/07db5aa1fd3447f095c5729879cbba50?Signature=NH9XIEgn09VgF1sfuu%2F20ArTAa1mluQh4JRbQwpiui6Zq6KxFlKHN1FWCghmFuRDNHiNvaNLVmZ2UnVgIroZBA%3D%3D&KeyID=a8968c46",
"language": "uk",
"confidentiality": "public",
"id": "3c54826fd7094702be0dda50a229e372",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
GET /api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
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/07db5aa1fd3447f095c5729879cbba50?Signature=NH9XIEgn09VgF1sfuu%2F20ArTAa1mluQh4JRbQwpiui6Zq6KxFlKHN1FWCghmFuRDNHiNvaNLVmZ2UnVgIroZBA%3D%3D&KeyID=a8968c46",
"language": "uk",
"confidentiality": "public",
"id": "3c54826fd7094702be0dda50a229e372",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
]
}
Конфіденційні файли у заявці
Документи можуть бути публічними та конфіденційними.
Приховання (конфіденційність) може бути застосована/змінена для документів у заявці у статусі draft. Обов’язковим є додавання поля обґрунтування confidentialityRationale для confidentiality: buyerOnly.
Додамо документи з confidentiality: buyerOnly і подивимося, що ми маємо:
POST /api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents?acc_token=2cac1d46cb17481595607b2d32aef48f HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "specs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7ff46ca9c18f4d0e8e9b8b6aaf9ad428?Signature=1Z81HgVCf0dTclzR4pS2d9QkblX2WnIeAZY1ncKeC1887DGqGjzo98Z4Y7Q02rC8chJPHJ%2FEGvVwk4aLN%2FdiAQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"documentType": "technicalSpecifications",
"confidentiality": "buyerOnly"
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "confidentialityRationale",
"description": [
"confidentialityRationale is required"
]
}
]
}
Додамо поле обґрунтування confidentialityRational:
POST /api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents?acc_token=2cac1d46cb17481595607b2d32aef48f HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "specs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7f19dbc3120f4fb7b70d566828100d5c?Signature=qhgNS27d3zSXpKIENNezycN9dljIMkXaKNVb9yR9UhIHuBpM8DilYYUCylmmY%2BqyWHTP%2Bnfc5VVBC6tvr5W2AQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"documentType": "technicalSpecifications",
"confidentiality": "buyerOnly",
"confidentialityRationale": "Дуже конфіденційний файл, треба приховати"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents/a4316bb364aa4dc293ec34b88166e417
{
"data": {
"documentType": "technicalSpecifications",
"hash": "md5:00000000000000000000000000000000",
"title": "specs.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents/a4316bb364aa4dc293ec34b88166e417?download=7f19dbc3120f4fb7b70d566828100d5c",
"language": "uk",
"confidentialityRationale": "Дуже конфіденційний файл, треба приховати",
"confidentiality": "buyerOnly",
"id": "a4316bb364aa4dc293ec34b88166e417",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Власник заявки та власник відбору бачить такі документи і може завантажиити їх:
GET /api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents/a4316bb364aa4dc293ec34b88166e417?acc_token=2cac1d46cb17481595607b2d32aef48f HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"documentType": "technicalSpecifications",
"hash": "md5:00000000000000000000000000000000",
"title": "specs.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents/a4316bb364aa4dc293ec34b88166e417?download=7f19dbc3120f4fb7b70d566828100d5c",
"language": "uk",
"confidentialityRationale": "Дуже конфіденційний файл, треба приховати",
"confidentiality": "buyerOnly",
"id": "a4316bb364aa4dc293ec34b88166e417",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Всі інші користувачі не можуть переглянути документ:
GET /api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents/a4316bb364aa4dc293ec34b88166e417 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"documentType": "technicalSpecifications",
"hash": "md5:00000000000000000000000000000000",
"title": "specs.doc",
"format": "application/msword",
"language": "uk",
"confidentialityRationale": "Дуже конфіденційний файл, треба приховати",
"confidentiality": "buyerOnly",
"id": "a4316bb364aa4dc293ec34b88166e417",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Ніхто окрім власника заявки та власника відбору не може викачати документ:
GET /api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents/a4316bb364aa4dc293ec34b88166e417?download=1 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Document download forbidden."
}
]
}
Видалення заявки
Заявка може бути видалена лише у статусі draft:
PATCH /api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b?acc_token=2cac1d46cb17481595607b2d32aef48f HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "deleted"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"tenderers": [
{
"name": "НАЗВА",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100"
},
"contactPoint": {
"name": "Сергій Олексюк",
"telephone": "+380432216930",
"email": "soleksuk@gmail.com"
}
}
],
"documents": [
{
"id": "3c54826fd7094702be0dda50a229e372",
"datePublished": "2027-01-17T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/07db5aa1fd3447f095c5729879cbba50?Signature=NH9XIEgn09VgF1sfuu%2F20ArTAa1mluQh4JRbQwpiui6Zq6KxFlKHN1FWCghmFuRDNHiNvaNLVmZ2UnVgIroZBA%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk",
"confidentiality": "public"
},
{
"documentType": "technicalSpecifications",
"id": "a4316bb364aa4dc293ec34b88166e417",
"datePublished": "2027-01-17T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "specs.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents/a4316bb364aa4dc293ec34b88166e417?download=7f19dbc3120f4fb7b70d566828100d5c",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk",
"confidentiality": "buyerOnly",
"confidentialityRationale": "Дуже конфіденційний файл, треба приховати"
}
],
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"status": "deleted",
"dateModified": "2027-01-17T00:00:00+02:00",
"date": "2027-01-17T00:00:00+02:00",
"owner": "broker",
"submissionType": "internationalFinancialInstitutions",
"id": "9c1ec0cf104142db84d35398c609cd4b"
},
"config": {
"restricted": false
}
}
Оновлення заявки
Заявка може бути оновлена лише у статусі draft:
PATCH /api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b?acc_token=2cac1d46cb17481595607b2d32aef48f HTTP/1.0
Authorization: Bearer broker
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"
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"tenderers": [
{
"name": "НАЗВА",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100"
},
"contactPoint": {
"name": "Сергій Олексюк",
"telephone": "+380432216930",
"email": "soleksuk@gmail.com"
}
}
],
"documents": [
{
"id": "3c54826fd7094702be0dda50a229e372",
"datePublished": "2027-01-17T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/07db5aa1fd3447f095c5729879cbba50?Signature=NH9XIEgn09VgF1sfuu%2F20ArTAa1mluQh4JRbQwpiui6Zq6KxFlKHN1FWCghmFuRDNHiNvaNLVmZ2UnVgIroZBA%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk",
"confidentiality": "public"
},
{
"documentType": "technicalSpecifications",
"id": "a4316bb364aa4dc293ec34b88166e417",
"datePublished": "2027-01-17T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "specs.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/9c1ec0cf104142db84d35398c609cd4b/documents/a4316bb364aa4dc293ec34b88166e417?download=7f19dbc3120f4fb7b70d566828100d5c",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk",
"confidentiality": "buyerOnly",
"confidentialityRationale": "Дуже конфіденційний файл, треба приховати"
}
],
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"status": "draft",
"dateModified": "2027-01-17T00:00:00+02:00",
"date": "2027-01-17T00:00:00+02:00",
"owner": "broker",
"submissionType": "internationalFinancialInstitutions",
"id": "9c1ec0cf104142db84d35398c609cd4b"
},
"config": {
"restricted": false
}
}
Активація заявки
Заявку можна активувати лише до настання period.endDate
PATCH /api/2.5/submissions/39f4e30e72c846039972b697c874c995?acc_token=7a97fc4aafce4fa893212f465a02b4b0 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"tenderers": [
{
"name": "ДКП «Школяр»",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100"
},
"contactPoint": {
"name": "Сергій Олексюк",
"telephone": "+380432216930",
"email": "soleksuk@gmail.com"
}
}
],
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"status": "active",
"dateModified": "2027-01-17T00:00:00+02:00",
"date": "2027-01-17T00:00:00+02:00",
"owner": "broker",
"submissionType": "internationalFinancialInstitutions",
"qualificationID": "61da52d3fbea49129c50b9171ce98c39",
"datePublished": "2027-01-17T00:00:00+02:00",
"id": "39f4e30e72c846039972b697c874c995"
},
"config": {
"restricted": false
}
}
Після активації заявки, автоматично створюється об’єкт рішення по заявці і заповнюється поле qualificationID в заявці.
Перевіримо, що містить реєстр заявки:
GET /api/2.5/submissions HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "39f4e30e72c846039972b697c874c995"
}
],
"next_page": {
"offset": "1800136800.0.1.2f06e4f4e639fe1693205a3328eaaae5",
"path": "/api/2.5/submissions?offset=1800136800.0.1.2f06e4f4e639fe1693205a3328eaaae5",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?offset=1800136800.0.1.2f06e4f4e639fe1693205a3328eaaae5"
}
}
Перевіримо об’єкт рішення по заявці:
GET /api/2.5/qualifications/61da52d3fbea49129c50b9171ce98c39 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"submissionID": "39f4e30e72c846039972b697c874c995",
"qualificationType": "internationalFinancialInstitutions",
"status": "pending",
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "61da52d3fbea49129c50b9171ce98c39"
},
"config": {
"restricted": false,
"qualificationComplainDuration": 0
}
}
Всі операції над об’єктом рішення по заявці може виконувати лише framework_owner (власник кваліфікації).
Завантаження документації до рішення по заявці
Документи можливо завантажити/оновити тільки до рішення у статусі pending.
Усі операції над документами такі ж як у кваліфікації:
POST /api/2.5/qualifications/61da52d3fbea49129c50b9171ce98c39/documents?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "qualification.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5b3f7bd6512745f8aa676efc89dbeb46?Signature=m3Nga%2BoCcJjF5p9vtUmhiMVYYyIy0oIl4uWxbYj8ToXWClty9vuaiqdw12cgP7Tn%2FOKA3ZT8Ttq6DtuCJa%2FxDQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/qualifications/61da52d3fbea49129c50b9171ce98c39/documents/ed3c1836c7c94d9aa02adbe5d6b2ed99
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5b3f7bd6512745f8aa676efc89dbeb46?Signature=HafRwGFXL%2BvgAl%2FkDMzxbaOpoWh3YjZb58%2BkOf6OKFH9XNyUQt7JFWJ0Diz2UNYkRW%2BO%2BlpGTu0uOQ9c2OwsAg%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "ed3c1836c7c94d9aa02adbe5d6b2ed99",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
GET /api/2.5/qualifications/61da52d3fbea49129c50b9171ce98c39/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
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/5b3f7bd6512745f8aa676efc89dbeb46?Signature=HafRwGFXL%2BvgAl%2FkDMzxbaOpoWh3YjZb58%2BkOf6OKFH9XNyUQt7JFWJ0Diz2UNYkRW%2BO%2BlpGTu0uOQ9c2OwsAg%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "ed3c1836c7c94d9aa02adbe5d6b2ed99",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
]
}
Відміна рішення по заявці
Рішення можливо відмінити лише у статусі pending.
Перед відміною рішення необхідно додати файл підпису до кваліфікації. Якщо нема файлу підпису під час відміни, ми побачимо помилку:
PATCH /api/2.5/qualifications/61da52d3fbea49129c50b9171ce98c39?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful"
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'evaluationReports' and format pkcs7-signature is required"
}
]
}
Файл підпису повинен мати documentType: evaluationReports та title: *.p7s. Додамо такий документ:
POST /api/2.5/qualifications/61da52d3fbea49129c50b9171ce98c39/documents?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "sign.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c301888666eb496b836650f2f0c2ff8a?Signature=nU5q91m1UoocPCZHRli0w3PPz59ZvH9VrKriJ0JMe1ufB4QwbxA6U9uVK2jQMlGxukSGwL2wba9EpHu5XcUpAw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature",
"documentType": "evaluationReports"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/qualifications/61da52d3fbea49129c50b9171ce98c39/documents/9f87b10607744a04b926ba01aab3ba85
{
"data": {
"documentType": "evaluationReports",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c301888666eb496b836650f2f0c2ff8a?Signature=wKR0t9cwE1N4k7CgKYjrDNjhHfhkSwDWNFdaLN5QOAD0197N2NUvOTJJBHG0%2Bj3JEauJ3W%2F0kZrt2%2F6F7PIfCA%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "9f87b10607744a04b926ba01aab3ba85",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Тепер можна відмінити рішення по заявці:
PATCH /api/2.5/qualifications/61da52d3fbea49129c50b9171ce98c39?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "unsuccessful"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"documents": [
{
"id": "ed3c1836c7c94d9aa02adbe5d6b2ed99",
"datePublished": "2027-01-17T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/5b3f7bd6512745f8aa676efc89dbeb46?Signature=HafRwGFXL%2BvgAl%2FkDMzxbaOpoWh3YjZb58%2BkOf6OKFH9XNyUQt7JFWJ0Diz2UNYkRW%2BO%2BlpGTu0uOQ9c2OwsAg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
},
{
"documentType": "evaluationReports",
"id": "9f87b10607744a04b926ba01aab3ba85",
"datePublished": "2027-01-17T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c301888666eb496b836650f2f0c2ff8a?Signature=wKR0t9cwE1N4k7CgKYjrDNjhHfhkSwDWNFdaLN5QOAD0197N2NUvOTJJBHG0%2Bj3JEauJ3W%2F0kZrt2%2F6F7PIfCA%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
}
],
"submissionID": "39f4e30e72c846039972b697c874c995",
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"status": "unsuccessful",
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"qualificationType": "internationalFinancialInstitutions",
"id": "61da52d3fbea49129c50b9171ce98c39"
},
"config": {
"restricted": false,
"qualificationComplainDuration": 0
}
}
Після відміни рішення, пов’язана завявка змінює статус з active на complete.
Перевіримо що сталося з заявками після відміни рішення:
GET /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/submissions HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"tenderers": [
{
"name": "ДКП «Школяр»",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100"
},
"contactPoint": {
"name": "Сергій Олексюк",
"telephone": "+380432216930",
"email": "soleksuk@gmail.com"
}
}
],
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"status": "complete",
"dateCreated": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"date": "2027-01-17T00:00:00+02:00",
"qualificationID": "61da52d3fbea49129c50b9171ce98c39",
"datePublished": "2027-01-17T00:00:00+02:00",
"id": "39f4e30e72c846039972b697c874c995"
},
{
"tenderers": [
{
"name": "ДКП «Школяр»",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100"
},
"contactPoint": {
"name": "Сергій Олексюк",
"telephone": "+380432216930",
"email": "soleksuk@gmail.com"
}
}
],
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"status": "complete",
"dateCreated": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"date": "2027-01-17T00:00:00+02:00",
"qualificationID": "78d4a13a5f274438a568fb8e618862a7",
"datePublished": "2027-01-17T00:00:00+02:00",
"id": "46d70854657844d8899811e773f0f410"
}
],
"next_page": {
"offset": "1800136800.0.2.b7841bf97e0f04b04aab57da684d75bf",
"path": "/api/2.5/submissions?offset=1800136800.0.2.b7841bf97e0f04b04aab57da684d75bf",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?offset=1800136800.0.2.b7841bf97e0f04b04aab57da684d75bf"
}
}
Підтвердження рішення по заявці
Рішення можливо погодити лише у статусі pending.
Перед погодженням необхідно додати файл підпису до кваліфікації. Якщо нема файлу підпису під час активації, ми побачимо помилку:
PATCH /api/2.5/qualifications/78d4a13a5f274438a568fb8e618862a7?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "documents",
"description": "Document with type 'evaluationReports' and format pkcs7-signature is required"
}
]
}
Файл підпису повинен мати documentType: evaluationReports та title: *.p7s. Додамо такий документ:
POST /api/2.5/qualifications/78d4a13a5f274438a568fb8e618862a7/documents?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "sign.p7s",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ec07f6afeca649b3a960652cfabb5b92?Signature=OxHbkZHci48PBQedo637HEgZyRzrxw7jHhP8h7aDAIaN0IgVGzcVF6wcgGJnJQ%2Bf5zJ9up%2FtbavEUj9OiQ71Ag%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature",
"documentType": "evaluationReports"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/qualifications/78d4a13a5f274438a568fb8e618862a7/documents/5670c7a685cc4517bcb9a9215019e1e5
{
"data": {
"documentType": "evaluationReports",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ec07f6afeca649b3a960652cfabb5b92?Signature=Mrrs75btJeZAunoMdcHhddBaNf6JNq1ODe1bGxi%2F6qAINmtyZivPLUE0LGmDCHCLgYjdpnNVHT4mhnuxlomuDg%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "5670c7a685cc4517bcb9a9215019e1e5",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Тепер можна підтвердити рішення по заявці:
PATCH /api/2.5/qualifications/78d4a13a5f274438a568fb8e618862a7?acc_token=c029ed2daf2c446a9adf956529cf0bc3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"documents": [
{
"documentType": "evaluationReports",
"id": "5670c7a685cc4517bcb9a9215019e1e5",
"datePublished": "2027-01-17T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ec07f6afeca649b3a960652cfabb5b92?Signature=Mrrs75btJeZAunoMdcHhddBaNf6JNq1ODe1bGxi%2F6qAINmtyZivPLUE0LGmDCHCLgYjdpnNVHT4mhnuxlomuDg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
}
],
"submissionID": "46d70854657844d8899811e773f0f410",
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"status": "active",
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"qualificationType": "internationalFinancialInstitutions",
"id": "78d4a13a5f274438a568fb8e618862a7"
},
"config": {
"restricted": false,
"qualificationComplainDuration": 0
}
}
Після підтвердження рішення по заявці, якщо це було перше затверджене рішення система створює реєстр з контрактом, в іншому випадку система додає контракт до реєстру.
Перевіримо кваліфікацію:
GET /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2027-01-01-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": "e99f835519da48e18d0d73857a65d70c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3d4ffdd9cb3e4b17a82a3c4ff17b9d36?Signature=tIDXH8wnBO3JBgUN3GoSoE4sW4BjxGNxkWSyxNiflNyarXJhL52k9CgC3cpQRNCO0JoJ2nrhXfCkIhHQJVVSCg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a3b4750dd6e84c9ba06bcca72560bf2d?Signature=vCJf2VCGiuPf5SeqwD1awYCS9ZTLVHvhV3fzbpHLLC3w3Pr0UVL8oVBxYX8H7abDCBGS%2FLg7mix%2BK8hsWPTgAA%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "f6e683bc45f347049d9b9c740170828c",
"datePublished": "2027-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/2365a5fbfc964de2a60ddfb175a6cc42?Signature=EQ2YakEGQeWMwX3tiOKOcxsLShIUEa%2B7bB6wmpMCqaC99IWYdRUihRRIElynMe9Ko105jWenrapYnCDSRhGfDw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
],
"owner": "broker",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
},
"frameworkType": "internationalFinancialInstitutions",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-11T00:00:00+02:00",
"clarificationsUntil": "2027-01-14T00:00:00+02:00"
},
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-01-06T00:00:00+02:00"
},
"next_check": "2027-01-11T00:00:00+02:00",
"agreementID": "4860703af9044dc19e30f45f4e537fb9",
"id": "932c7023588f40f4aec26aef109f4998"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
Ви можете побачити, що в кваліфікації з’явилось поле agreementID, тож давайте перевіримо реєстр:
GET /api/2.5/agreements/4860703af9044dc19e30f45f4e537fb9 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2027-01-17-000001",
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"agreementType": "internationalFinancialInstitutions",
"status": "active",
"period": {
"startDate": "2027-01-17T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"contracts": [
{
"id": "7ca7cc6e90f946359a8d2d151793e426",
"qualificationID": "78d4a13a5f274438a568fb8e618862a7",
"submissionID": "46d70854657844d8899811e773f0f410",
"status": "active",
"suppliers": [
{
"name": "ДКП «Школяр»",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100"
},
"contactPoint": {
"name": "Сергій Олексюк",
"telephone": "+380432216930",
"email": "soleksuk@gmail.com"
}
}
],
"milestones": [
{
"id": "53fd5467e77a4aa2b19d3f9c013aadb1",
"status": "scheduled",
"type": "activation",
"dueDate": "2028-02-05T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
],
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
],
"owner": "broker",
"dateModified": "2027-01-17T00:00:00+02:00",
"date": "2027-01-17T00:00:00+02:00",
"next_check": "2028-02-05T00:00:00+02:00",
"dateCreated": "2027-01-17T00:00:00+02:00",
"id": "4860703af9044dc19e30f45f4e537fb9"
},
"config": {
"restricted": false
}
}
Як ви можете побачити реєстр в статусі active та має контракт, щож ми можемо побачити цей реєстр в потоці даних:
GET /api/2.5/agreements HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "4860703af9044dc19e30f45f4e537fb9"
}
],
"next_page": {
"offset": "1800136800.0.1.30289bd45493ff45e04c4a27978b95be",
"path": "/api/2.5/agreements?offset=1800136800.0.1.30289bd45493ff45e04c4a27978b95be",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?offset=1800136800.0.1.30289bd45493ff45e04c4a27978b95be"
}
}
Перевіримо, що містить реєстр рішення по заявці:
GET /api/2.5/qualifications HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "61da52d3fbea49129c50b9171ce98c39"
},
{
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "78d4a13a5f274438a568fb8e618862a7"
}
],
"next_page": {
"offset": "1800136800.0.2.6fa79395b636aedb511058f56a29aa72",
"path": "/api/2.5/qualifications?offset=1800136800.0.2.6fa79395b636aedb511058f56a29aa72",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?offset=1800136800.0.2.6fa79395b636aedb511058f56a29aa72"
}
}
Перевіримо всі рішення по заявці до данної кваліфікації:
GET /api/2.5/frameworks/932c7023588f40f4aec26aef109f4998/qualifications HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"documents": [
{
"id": "ed3c1836c7c94d9aa02adbe5d6b2ed99",
"datePublished": "2027-01-17T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications/61da52d3fbea49129c50b9171ce98c39/documents/ed3c1836c7c94d9aa02adbe5d6b2ed99?download=5b3f7bd6512745f8aa676efc89dbeb46",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
},
{
"documentType": "evaluationReports",
"id": "9f87b10607744a04b926ba01aab3ba85",
"datePublished": "2027-01-17T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications/61da52d3fbea49129c50b9171ce98c39/documents/9f87b10607744a04b926ba01aab3ba85?download=c301888666eb496b836650f2f0c2ff8a",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
}
],
"submissionID": "39f4e30e72c846039972b697c874c995",
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"status": "unsuccessful",
"date": "2027-01-17T00:00:00+02:00",
"dateCreated": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "61da52d3fbea49129c50b9171ce98c39"
},
{
"documents": [
{
"documentType": "evaluationReports",
"id": "5670c7a685cc4517bcb9a9215019e1e5",
"datePublished": "2027-01-17T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications/78d4a13a5f274438a568fb8e618862a7/documents/5670c7a685cc4517bcb9a9215019e1e5?download=ec07f6afeca649b3a960652cfabb5b92",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
}
],
"submissionID": "46d70854657844d8899811e773f0f410",
"frameworkID": "932c7023588f40f4aec26aef109f4998",
"status": "active",
"date": "2027-01-17T00:00:00+02:00",
"dateCreated": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "78d4a13a5f274438a568fb8e618862a7"
}
],
"next_page": {
"offset": "1800136800.0.2.6fa79395b636aedb511058f56a29aa72",
"path": "/api/2.5/qualifications?offset=1800136800.0.2.6fa79395b636aedb511058f56a29aa72",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?offset=1800136800.0.2.6fa79395b636aedb511058f56a29aa72"
}
}
Завершення кваліфікації
Завершення кваліфікації відбувається автоматично після настання дати qualificationPeriod.endDate.
PATCH запит з новим значенням qualificationPeriod.endDate дозволяє завершити фрейморк раніше запланованого часу, але не раніше 30 повних календарних днів з моменту зміни qualificationPeriod.endDate.