Туторіал
Створення кваліфікації
Створимо кваліфікацію:
POST /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"name": "Державне управління справами"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "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/79215d0ea54f4a04b04d7fadf4090ca1
{
"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": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "general"
},
"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": "79215d0ea54f4a04b04d7fadf4090ca1"
},
"access": {
"token": "2a5f07868aed43bfb10588a5ac40185a",
"transfer": "a19350b7650a4ec093181f37c590a6de"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.
Кваліфікацію було створено у статусі draft. У цьому статусі будь-яке поле, окрім технічних, може бути змінено.
PATCH /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1?acc_token=2a5f07868aed43bfb10588a5ac40185a 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": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"id": "79215d0ea54f4a04b04d7fadf4090ca1"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
Завантаження документації
Замовник може завантажити PDF файл у створениу кваліфікацію. Завантаження повинно відбуватись згідно правил Завантаження документів.
POST /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1/documents?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/f5cb842886f141e681b47175faee1ea1?Signature=pHqDG1lqYutJy8U7HPCCyc8uax0f19KdoWORHwN5qVLAew5b0Hp96XPiixj3voULdWbi6yws6Dun%2BLrAjxL9CA%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/79215d0ea54f4a04b04d7fadf4090ca1/documents/fa81182a8ca44a08bcbca5d7128c8640
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "framework.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/f5cb842886f141e681b47175faee1ea1?Signature=G7BvnAz3bGtcoEJQ4VMw2s9ARIPKFD0ZsNnTzvkGoYumAUv61r%2BTP0NXiTQhwebXxqUJM1d5aNg5AU8LtKBSCw%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "fa81182a8ca44a08bcbca5d7128c8640",
"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/79215d0ea54f4a04b04d7fadf4090ca1/documents?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/f5cb842886f141e681b47175faee1ea1?Signature=G7BvnAz3bGtcoEJQ4VMw2s9ARIPKFD0ZsNnTzvkGoYumAUv61r%2BTP0NXiTQhwebXxqUJM1d5aNg5AU8LtKBSCw%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "fa81182a8ca44a08bcbca5d7128c8640",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
]
}
І знову можна перевірити, що є два завантажених документа.
POST /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1/documents?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/beda32f664fb459291d362e650147d5d?Signature=bYb8hxPMbpbofg8oIwNNwb9BUp9reoraHXU6GZblP7s7Pu8S4DU6fPKo1JCRGsJIZPd1fiAqqwl1k%2FCvpDTSBQ%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/79215d0ea54f4a04b04d7fadf4090ca1/documents/1e1af8dcdca84f1488d5cbcd78cc0466
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "framework_additional_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/beda32f664fb459291d362e650147d5d?Signature=pcYNBP%2FAj04nzgykslGVmqMOd3wtV9PptoB5NuzsDBne78GS2HGn9hmq%2ByTIhaYOr%2Bdtv6mO63IBY8NkQ3jrAg%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"datePublished": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
PUT /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1/documents/1e1af8dcdca84f1488d5cbcd78cc0466?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/d369fa8572584fffba4fe7fb70daffe2?Signature=EmZiy1sJbyF%2B57PZ0EQiXmY%2BJlmcJialbXCJQKobt8GnBP%2BEE7hUt5RTQRWEDahAni80wQNTaqc6IzQZvDYNDw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/d369fa8572584fffba4fe7fb70daffe2?Signature=%2B8G4s2LtJtEl9ij7xF17ayvO5H1BxrBWc7bAMhNt6pn9JkPAOCocA1BAkf3wIPgRzu8bKDe4qvayMpJcnL%2FlAQ%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
GET /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1/documents/1e1af8dcdca84f1488d5cbcd78cc0466?acc_token=2a5f07868aed43bfb10588a5ac40185a HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/d369fa8572584fffba4fe7fb70daffe2?Signature=%2B8G4s2LtJtEl9ij7xF17ayvO5H1BxrBWc7bAMhNt6pn9JkPAOCocA1BAkf3wIPgRzu8bKDe4qvayMpJcnL%2FlAQ%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/beda32f664fb459291d362e650147d5d?Signature=pcYNBP%2FAj04nzgykslGVmqMOd3wtV9PptoB5NuzsDBne78GS2HGn9hmq%2ByTIhaYOr%2Bdtv6mO63IBY8NkQ3jrAg%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/79215d0ea54f4a04b04d7fadf4090ca1?acc_token=2a5f07868aed43bfb10588a5ac40185a 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": "fa81182a8ca44a08bcbca5d7128c8640",
"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/f5cb842886f141e681b47175faee1ea1?Signature=G7BvnAz3bGtcoEJQ4VMw2s9ARIPKFD0ZsNnTzvkGoYumAUv61r%2BTP0NXiTQhwebXxqUJM1d5aNg5AU8LtKBSCw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/beda32f664fb459291d362e650147d5d?Signature=pcYNBP%2FAj04nzgykslGVmqMOd3wtV9PptoB5NuzsDBne78GS2HGn9hmq%2ByTIhaYOr%2Bdtv6mO63IBY8NkQ3jrAg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/d369fa8572584fffba4fe7fb70daffe2?Signature=%2B8G4s2LtJtEl9ij7xF17ayvO5H1BxrBWc7bAMhNt6pn9JkPAOCocA1BAkf3wIPgRzu8bKDe4qvayMpJcnL%2FlAQ%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": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-15T00:00:00+02:00",
"clarificationsUntil": "2027-01-20T00: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-16T00:00:00+02:00",
"id": "79215d0ea54f4a04b04d7fadf4090ca1"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
Після активації кваліфікації будуть розраховані періоди:
enquiryPeriod - перші 10 повних робочих днів з моменту активації.
period - період, коли постачальники можуть подавати заявки.
qualificationPeriod - останні 30 повних календарних днів кваліфікації. У цей період постачальники не можуть подавати нові заявки, але ще приймаються рішення щодо попередньо поданих заявок.
GET /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1 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": "fa81182a8ca44a08bcbca5d7128c8640",
"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/f5cb842886f141e681b47175faee1ea1?Signature=G7BvnAz3bGtcoEJQ4VMw2s9ARIPKFD0ZsNnTzvkGoYumAUv61r%2BTP0NXiTQhwebXxqUJM1d5aNg5AU8LtKBSCw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/beda32f664fb459291d362e650147d5d?Signature=pcYNBP%2FAj04nzgykslGVmqMOd3wtV9PptoB5NuzsDBne78GS2HGn9hmq%2ByTIhaYOr%2Bdtv6mO63IBY8NkQ3jrAg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/d369fa8572584fffba4fe7fb70daffe2?Signature=%2B8G4s2LtJtEl9ij7xF17ayvO5H1BxrBWc7bAMhNt6pn9JkPAOCocA1BAkf3wIPgRzu8bKDe4qvayMpJcnL%2FlAQ%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": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-15T00:00:00+02:00",
"clarificationsUntil": "2027-01-20T00: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-16T00:00:00+02:00",
"agreementID": "2c50602a5c214dfba111d06f8a79565f",
"id": "79215d0ea54f4a04b04d7fadf4090ca1"
},
"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": "79215d0ea54f4a04b04d7fadf4090ca1"
}
],
"next_page": {
"offset": "1800136800.0.1.7dc43bf19eebf6067fbefcaeda130c7e",
"path": "/api/2.5/frameworks?offset=1800136800.0.1.7dc43bf19eebf6067fbefcaeda130c7e",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/frameworks?offset=1800136800.0.1.7dc43bf19eebf6067fbefcaeda130c7e"
}
}
Відображається id - внутрішній ідентифікатор та мітка часу dateModified.
Зміна кваліфікації
У статусі active можна змінювати лише деякі поля: telephone, name, email для procuringEntity.contactPoint, description and documents.
PATCH /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1?acc_token=2a5f07868aed43bfb10588a5ac40185a 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": "fa81182a8ca44a08bcbca5d7128c8640",
"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/f5cb842886f141e681b47175faee1ea1?Signature=G7BvnAz3bGtcoEJQ4VMw2s9ARIPKFD0ZsNnTzvkGoYumAUv61r%2BTP0NXiTQhwebXxqUJM1d5aNg5AU8LtKBSCw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/beda32f664fb459291d362e650147d5d?Signature=pcYNBP%2FAj04nzgykslGVmqMOd3wtV9PptoB5NuzsDBne78GS2HGn9hmq%2ByTIhaYOr%2Bdtv6mO63IBY8NkQ3jrAg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/d369fa8572584fffba4fe7fb70daffe2?Signature=%2B8G4s2LtJtEl9ij7xF17ayvO5H1BxrBWc7bAMhNt6pn9JkPAOCocA1BAkf3wIPgRzu8bKDe4qvayMpJcnL%2FlAQ%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
],
"agreementID": "2c50602a5c214dfba111d06f8a79565f",
"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-15T00:00:00+02:00",
"clarificationsUntil": "2027-01-20T00:00:00+02:00"
},
"next_check": "2027-01-16T00:00:00+02:00",
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "зміна",
"telephone": "+0440000002",
"email": "ab@aa.com"
},
"kind": "general"
},
"id": "79215d0ea54f4a04b04d7fadf4090ca1"
},
"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": "79215d0ea54f4a04b04d7fadf4090ca1"
}
],
"next_page": {
"offset": "1800136800.0.1.7dc43bf19eebf6067fbefcaeda130c7e",
"path": "/api/2.5/frameworks?offset=1800136800.0.1.7dc43bf19eebf6067fbefcaeda130c7e",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/frameworks?offset=1800136800.0.1.7dc43bf19eebf6067fbefcaeda130c7e"
}
}
Зміна 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/79215d0ea54f4a04b04d7fadf4090ca1/changes?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/79215d0ea54f4a04b04d7fadf4090ca1/changes?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/79215d0ea54f4a04b04d7fadf4090ca1/changes?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/79215d0ea54f4a04b04d7fadf4090ca1/changes/ebfecaa7b5e549afaa31883a22e390f3
{
"data": {
"rationale": "Відсутня подальша потреба в закупівлі з використанням рамкової угоди",
"rationaleType": "noDemandFramework",
"modifications": {
"qualificationPeriod": {
"endDate": "2027-03-08T00:00:00+02:00"
}
},
"id": "ebfecaa7b5e549afaa31883a22e390f3",
"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/79215d0ea54f4a04b04d7fadf4090ca1/changes/ebfecaa7b5e549afaa31883a22e390f3?acc_token=2a5f07868aed43bfb10588a5ac40185a&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": "ebfecaa7b5e549afaa31883a22e390f3",
"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": "fa81182a8ca44a08bcbca5d7128c8640",
"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/f5cb842886f141e681b47175faee1ea1?Signature=G7BvnAz3bGtcoEJQ4VMw2s9ARIPKFD0ZsNnTzvkGoYumAUv61r%2BTP0NXiTQhwebXxqUJM1d5aNg5AU8LtKBSCw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/beda32f664fb459291d362e650147d5d?Signature=pcYNBP%2FAj04nzgykslGVmqMOd3wtV9PptoB5NuzsDBne78GS2HGn9hmq%2ByTIhaYOr%2Bdtv6mO63IBY8NkQ3jrAg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/d369fa8572584fffba4fe7fb70daffe2?Signature=%2B8G4s2LtJtEl9ij7xF17ayvO5H1BxrBWc7bAMhNt6pn9JkPAOCocA1BAkf3wIPgRzu8bKDe4qvayMpJcnL%2FlAQ%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
],
"agreementID": "2c50602a5c214dfba111d06f8a79565f",
"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-15T00:00:00+02:00",
"clarificationsUntil": "2027-01-20T00:00:00+02:00"
},
"next_check": "2027-01-16T00:00:00+02:00",
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "зміна",
"telephone": "+0440000002",
"email": "ab@aa.com"
},
"kind": "general"
},
"changes": [
{
"rationale": "Відсутня подальша потреба в закупівлі з використанням рамкової угоди",
"rationaleType": "noDemandFramework",
"modifications": {
"qualificationPeriod": {
"endDate": "2027-03-08T00:00:00+02:00"
}
},
"id": "ebfecaa7b5e549afaa31883a22e390f3",
"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": "79215d0ea54f4a04b04d7fadf4090ca1"
}
}
}
Для детальної інформації про відображення інформації для підписів, дивитися тут: Відображення інформації для підписів.
Тепер необхідно додати документ підпису до змін:
POST /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1/changes/ebfecaa7b5e549afaa31883a22e390f3/documents?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/b918ae66049e4e8fab32e44e60b0da36?Signature=jmONBbsibRy7MU8wSa2pVOOJCZn%2FlpcTC45OzNdYpAnWQfbKGod5C2wSswLmnZK5S7h9rNPL8iXJK9XZlgKgBw%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/79215d0ea54f4a04b04d7fadf4090ca1/changes/ebfecaa7b5e549afaa31883a22e390f3/documents/eef89e73389b4214a3d0cae6e04b233b
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/b918ae66049e4e8fab32e44e60b0da36?Signature=t6oKKlAjwt2pMqT%2FvFNVTUpcSGKbSnBE1fdIKj5KJNePGQTbXS9FTDRTjwILv7uvBjlT5qoyjBgNnfOURSDFDw%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "eef89e73389b4214a3d0cae6e04b233b",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Якщо було змінено поле qualificationPeriod.endDate - всі періоди будуть перераховані.
Подивимося тепер на відбір:
GET /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1?acc_token=2a5f07868aed43bfb10588a5ac40185a 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": "fa81182a8ca44a08bcbca5d7128c8640",
"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/f5cb842886f141e681b47175faee1ea1?Signature=G7BvnAz3bGtcoEJQ4VMw2s9ARIPKFD0ZsNnTzvkGoYumAUv61r%2BTP0NXiTQhwebXxqUJM1d5aNg5AU8LtKBSCw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/beda32f664fb459291d362e650147d5d?Signature=pcYNBP%2FAj04nzgykslGVmqMOd3wtV9PptoB5NuzsDBne78GS2HGn9hmq%2ByTIhaYOr%2Bdtv6mO63IBY8NkQ3jrAg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/d369fa8572584fffba4fe7fb70daffe2?Signature=%2B8G4s2LtJtEl9ij7xF17ayvO5H1BxrBWc7bAMhNt6pn9JkPAOCocA1BAkf3wIPgRzu8bKDe4qvayMpJcnL%2FlAQ%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
}
],
"agreementID": "2c50602a5c214dfba111d06f8a79565f",
"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-15T00:00:00+02:00",
"clarificationsUntil": "2027-01-20T00:00:00+02:00"
},
"next_check": "2027-01-16T00:00:00+02:00",
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "зміна",
"telephone": "+0440000002",
"email": "ab@aa.com"
},
"kind": "general"
},
"changes": [
{
"rationale": "Відсутня подальша потреба в закупівлі з використанням рамкової угоди",
"rationaleType": "noDemandFramework",
"modifications": {
"qualificationPeriod": {
"endDate": "2027-03-08T00:00:00+02:00"
}
},
"id": "ebfecaa7b5e549afaa31883a22e390f3",
"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/b918ae66049e4e8fab32e44e60b0da36?Signature=t6oKKlAjwt2pMqT%2FvFNVTUpcSGKbSnBE1fdIKj5KJNePGQTbXS9FTDRTjwILv7uvBjlT5qoyjBgNnfOURSDFDw%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "eef89e73389b4214a3d0cae6e04b233b",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
]
}
],
"id": "79215d0ea54f4a04b04d7fadf4090ca1"
},
"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": "79215d0ea54f4a04b04d7fadf4090ca1"
},
"config": {
"restricted": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/da4552d132e14fd19dc2d64f1438a0d1
{
"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": "79215d0ea54f4a04b04d7fadf4090ca1",
"status": "draft",
"submissionType": "dynamicPurchasingSystem",
"owner": "broker",
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "da4552d132e14fd19dc2d64f1438a0d1"
},
"access": {
"token": "c495172bd73f464e8d3b724b58bf84a8",
"transfer": "9baefde558414364bb00ac0783abe77b"
},
"config": {
"restricted": false
}
}
Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.
Завантаження документації по заявці
Документи можливо завантажити/оновити тільки до заявки у статусі draft.
Усі операції над документами такі ж як у кваліфікації:
POST /api/2.5/submissions/da4552d132e14fd19dc2d64f1438a0d1/documents?acc_token=c495172bd73f464e8d3b724b58bf84a8 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/46a9cf8cd1034d57b7e550b1c7bb0339?Signature=m8pEjAMzTTzsk4We7njaIzWu9J7f31SKITtDf15DVWrmfUh1Jth0BLO0NBGomcyDNmOyHrg%2F3Cjc%2F3yuIba%2FBA%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/da4552d132e14fd19dc2d64f1438a0d1/documents/1655f2ede7344a8a89fcae1d7c7f32d7
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "submission_docs.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/46a9cf8cd1034d57b7e550b1c7bb0339?Signature=CV6toqmVNh7aYzT8Sn0JjsdtsYR66FqDDLdqXszr49BvU7fkKFV59qITAmgwNxHwaNZ3mGH6rZH5LtzNFshCAQ%3D%3D&KeyID=a8968c46",
"language": "uk",
"confidentiality": "public",
"id": "1655f2ede7344a8a89fcae1d7c7f32d7",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
GET /api/2.5/submissions/da4552d132e14fd19dc2d64f1438a0d1/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/46a9cf8cd1034d57b7e550b1c7bb0339?Signature=CV6toqmVNh7aYzT8Sn0JjsdtsYR66FqDDLdqXszr49BvU7fkKFV59qITAmgwNxHwaNZ3mGH6rZH5LtzNFshCAQ%3D%3D&KeyID=a8968c46",
"language": "uk",
"confidentiality": "public",
"id": "1655f2ede7344a8a89fcae1d7c7f32d7",
"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/da4552d132e14fd19dc2d64f1438a0d1/documents?acc_token=c495172bd73f464e8d3b724b58bf84a8 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/7150a692fd2b402d92a484375bfb60db?Signature=BHAhapA8GQgB5S4z2V%2FLFj2oxynHkeaZ1k1R1dzr7ai2QM7MXF8c2hn6sbzQmVl0nbvTKYzc02wYRktMZijSAg%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/da4552d132e14fd19dc2d64f1438a0d1/documents?acc_token=c495172bd73f464e8d3b724b58bf84a8 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/abddfc43e82f4085a26ecce77f495ef7?Signature=xDGe%2Bn9Xa9TzPVV1z9tcQnqb%2Fi%2B1F9PnlrIrkw6rmYMQUzpc5lncA8FUAnB5sNj4ws0nL1Ls9k0gN5O4%2FjwDCA%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/da4552d132e14fd19dc2d64f1438a0d1/documents/95897799b92c4866b2e932206f8cf013
{
"data": {
"documentType": "technicalSpecifications",
"hash": "md5:00000000000000000000000000000000",
"title": "specs.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/da4552d132e14fd19dc2d64f1438a0d1/documents/95897799b92c4866b2e932206f8cf013?download=abddfc43e82f4085a26ecce77f495ef7",
"language": "uk",
"confidentialityRationale": "Дуже конфіденційний файл, треба приховати",
"confidentiality": "buyerOnly",
"id": "95897799b92c4866b2e932206f8cf013",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Власник заявки та власник відбору бачить такі документи і може завантажиити їх:
GET /api/2.5/submissions/da4552d132e14fd19dc2d64f1438a0d1/documents/95897799b92c4866b2e932206f8cf013?acc_token=c495172bd73f464e8d3b724b58bf84a8 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/da4552d132e14fd19dc2d64f1438a0d1/documents/95897799b92c4866b2e932206f8cf013?download=abddfc43e82f4085a26ecce77f495ef7",
"language": "uk",
"confidentialityRationale": "Дуже конфіденційний файл, треба приховати",
"confidentiality": "buyerOnly",
"id": "95897799b92c4866b2e932206f8cf013",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Всі інші користувачі не можуть переглянути документ:
GET /api/2.5/submissions/da4552d132e14fd19dc2d64f1438a0d1/documents/95897799b92c4866b2e932206f8cf013 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": "95897799b92c4866b2e932206f8cf013",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Ніхто окрім власника заявки та власника відбору не може викачати документ:
GET /api/2.5/submissions/da4552d132e14fd19dc2d64f1438a0d1/documents/95897799b92c4866b2e932206f8cf013?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/da4552d132e14fd19dc2d64f1438a0d1?acc_token=c495172bd73f464e8d3b724b58bf84a8 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": "1655f2ede7344a8a89fcae1d7c7f32d7",
"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/46a9cf8cd1034d57b7e550b1c7bb0339?Signature=CV6toqmVNh7aYzT8Sn0JjsdtsYR66FqDDLdqXszr49BvU7fkKFV59qITAmgwNxHwaNZ3mGH6rZH5LtzNFshCAQ%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk",
"confidentiality": "public"
},
{
"documentType": "technicalSpecifications",
"id": "95897799b92c4866b2e932206f8cf013",
"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/da4552d132e14fd19dc2d64f1438a0d1/documents/95897799b92c4866b2e932206f8cf013?download=abddfc43e82f4085a26ecce77f495ef7",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk",
"confidentiality": "buyerOnly",
"confidentialityRationale": "Дуже конфіденційний файл, треба приховати"
}
],
"frameworkID": "79215d0ea54f4a04b04d7fadf4090ca1",
"status": "deleted",
"dateModified": "2027-01-17T00:00:00+02:00",
"date": "2027-01-17T00:00:00+02:00",
"owner": "broker",
"submissionType": "dynamicPurchasingSystem",
"id": "da4552d132e14fd19dc2d64f1438a0d1"
},
"config": {
"restricted": false
}
}
Оновлення заявки
Заявка може бути оновлена лише у статусі draft:
PATCH /api/2.5/submissions/da4552d132e14fd19dc2d64f1438a0d1?acc_token=c495172bd73f464e8d3b724b58bf84a8 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": "1655f2ede7344a8a89fcae1d7c7f32d7",
"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/46a9cf8cd1034d57b7e550b1c7bb0339?Signature=CV6toqmVNh7aYzT8Sn0JjsdtsYR66FqDDLdqXszr49BvU7fkKFV59qITAmgwNxHwaNZ3mGH6rZH5LtzNFshCAQ%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk",
"confidentiality": "public"
},
{
"documentType": "technicalSpecifications",
"id": "95897799b92c4866b2e932206f8cf013",
"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/da4552d132e14fd19dc2d64f1438a0d1/documents/95897799b92c4866b2e932206f8cf013?download=abddfc43e82f4085a26ecce77f495ef7",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk",
"confidentiality": "buyerOnly",
"confidentialityRationale": "Дуже конфіденційний файл, треба приховати"
}
],
"frameworkID": "79215d0ea54f4a04b04d7fadf4090ca1",
"status": "draft",
"dateModified": "2027-01-17T00:00:00+02:00",
"date": "2027-01-17T00:00:00+02:00",
"owner": "broker",
"submissionType": "dynamicPurchasingSystem",
"id": "da4552d132e14fd19dc2d64f1438a0d1"
},
"config": {
"restricted": false
}
}
Активація заявки
Заявку можна активувати лише до настання period.endDate
PATCH /api/2.5/submissions/2653e869246f4cb6900d45568c0a7e2b?acc_token=229f55581e454056a19a3a5af43ddb15 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": "79215d0ea54f4a04b04d7fadf4090ca1",
"status": "active",
"dateModified": "2027-01-17T00:00:00+02:00",
"date": "2027-01-17T00:00:00+02:00",
"owner": "broker",
"submissionType": "dynamicPurchasingSystem",
"qualificationID": "6dc22ab2c87f41bb91375ca71951687c",
"datePublished": "2027-01-17T00:00:00+02:00",
"id": "2653e869246f4cb6900d45568c0a7e2b"
},
"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": "2653e869246f4cb6900d45568c0a7e2b"
}
],
"next_page": {
"offset": "1800136800.0.1.759212e3a291198d8d875d47fa3bca6d",
"path": "/api/2.5/submissions?offset=1800136800.0.1.759212e3a291198d8d875d47fa3bca6d",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?offset=1800136800.0.1.759212e3a291198d8d875d47fa3bca6d"
}
}
Перевіримо об’єкт рішення по заявці:
GET /api/2.5/qualifications/6dc22ab2c87f41bb91375ca71951687c HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"frameworkID": "79215d0ea54f4a04b04d7fadf4090ca1",
"submissionID": "2653e869246f4cb6900d45568c0a7e2b",
"qualificationType": "dynamicPurchasingSystem",
"status": "pending",
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "6dc22ab2c87f41bb91375ca71951687c"
},
"config": {
"restricted": false,
"qualificationComplainDuration": 0
}
}
Всі операції над об’єктом рішення по заявці може виконувати лише framework_owner (власник кваліфікації).
Завантаження документації до рішення по заявці
Документи можливо завантажити/оновити тільки до рішення у статусі pending.
Усі операції над документами такі ж як у кваліфікації:
POST /api/2.5/qualifications/6dc22ab2c87f41bb91375ca71951687c/documents?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/261302c61582415fa7ca7a5348f275ba?Signature=9C54MEHP91VYDZ%2Fru%2BC%2BgJ08QlGpaQuBlVBecpWtiqAjmial4uS9%2BDhNJHuUSKsKzCg4bQgTmuyoNx9T7n2bBg%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/6dc22ab2c87f41bb91375ca71951687c/documents/7ec09bfc14fe4ccda58d49c40c7d7616
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "qualification.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/261302c61582415fa7ca7a5348f275ba?Signature=E9HlVatPIhsGKNuKl097CdZOL0JHUYJkzbzZUpTeYmKpK1ZwoLNg1HPXDA4HZ9N2BWQ8NplM3Mzql3%2BA0eF0Ag%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "7ec09bfc14fe4ccda58d49c40c7d7616",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
GET /api/2.5/qualifications/6dc22ab2c87f41bb91375ca71951687c/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/261302c61582415fa7ca7a5348f275ba?Signature=E9HlVatPIhsGKNuKl097CdZOL0JHUYJkzbzZUpTeYmKpK1ZwoLNg1HPXDA4HZ9N2BWQ8NplM3Mzql3%2BA0eF0Ag%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "7ec09bfc14fe4ccda58d49c40c7d7616",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
]
}
Відміна рішення по заявці
Рішення можливо відмінити лише у статусі pending.
Перед відміною рішення необхідно додати файл підпису до кваліфікації. Якщо нема файлу підпису під час відміни, ми побачимо помилку:
PATCH /api/2.5/qualifications/6dc22ab2c87f41bb91375ca71951687c?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/6dc22ab2c87f41bb91375ca71951687c/documents?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/9227b1be6f824b27a68117b66cb4d996?Signature=1ZpmJ5SbPuHSZUCrvzdEky40tLFy2w1%2BUyf29B07VTm4P5dOlrgQbY5hPmmNh00M40cyhjf6b6DCe2VZikZ%2BAQ%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/6dc22ab2c87f41bb91375ca71951687c/documents/20ff860f52c541a995707c9bceea4d56
{
"data": {
"documentType": "evaluationReports",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9227b1be6f824b27a68117b66cb4d996?Signature=nvmAmH6K0SBSaeYdFOJ6A8%2FGur4kbrQgb3bcL%2FK5g5K8NJ3WyTesgbLhzXvW%2FQ6gbUoBPnUcRRSOy%2FF5HvXnBg%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "20ff860f52c541a995707c9bceea4d56",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Тепер можна відмінити рішення по заявці:
PATCH /api/2.5/qualifications/6dc22ab2c87f41bb91375ca71951687c?acc_token=2a5f07868aed43bfb10588a5ac40185a 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": "7ec09bfc14fe4ccda58d49c40c7d7616",
"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/261302c61582415fa7ca7a5348f275ba?Signature=E9HlVatPIhsGKNuKl097CdZOL0JHUYJkzbzZUpTeYmKpK1ZwoLNg1HPXDA4HZ9N2BWQ8NplM3Mzql3%2BA0eF0Ag%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
},
{
"documentType": "evaluationReports",
"id": "20ff860f52c541a995707c9bceea4d56",
"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/9227b1be6f824b27a68117b66cb4d996?Signature=nvmAmH6K0SBSaeYdFOJ6A8%2FGur4kbrQgb3bcL%2FK5g5K8NJ3WyTesgbLhzXvW%2FQ6gbUoBPnUcRRSOy%2FF5HvXnBg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
}
],
"submissionID": "2653e869246f4cb6900d45568c0a7e2b",
"frameworkID": "79215d0ea54f4a04b04d7fadf4090ca1",
"status": "unsuccessful",
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"qualificationType": "dynamicPurchasingSystem",
"id": "6dc22ab2c87f41bb91375ca71951687c"
},
"config": {
"restricted": false,
"qualificationComplainDuration": 0
}
}
Після відміни рішення, пов’язана завявка змінює статус з active на complete.
Перевіримо що сталося з заявками після відміни рішення:
GET /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1/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": "79215d0ea54f4a04b04d7fadf4090ca1",
"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": "6dc22ab2c87f41bb91375ca71951687c",
"datePublished": "2027-01-17T00:00:00+02:00",
"id": "2653e869246f4cb6900d45568c0a7e2b"
},
{
"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": "79215d0ea54f4a04b04d7fadf4090ca1",
"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": "37edcfe4b6484dee80eecfdb03a03a08",
"datePublished": "2027-01-17T00:00:00+02:00",
"id": "0c3ac4255ccc46e4b317616f23fa6766"
}
],
"next_page": {
"offset": "1800136800.0.2.8cec0c0133c83aba3557062ef7fdcccc",
"path": "/api/2.5/submissions?offset=1800136800.0.2.8cec0c0133c83aba3557062ef7fdcccc",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?offset=1800136800.0.2.8cec0c0133c83aba3557062ef7fdcccc"
}
}
Підтвердження рішення по заявці
Рішення можливо погодити лише у статусі pending.
Перед погодженням необхідно додати файл підпису до кваліфікації. Якщо нема файлу підпису під час активації, ми побачимо помилку:
PATCH /api/2.5/qualifications/37edcfe4b6484dee80eecfdb03a03a08?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/37edcfe4b6484dee80eecfdb03a03a08/documents?acc_token=2a5f07868aed43bfb10588a5ac40185a 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/8395d296066f4991a7f59f6f38e8134d?Signature=%2BPpek%2BzYAp6N18iPFj1FfF9tqIvfFstxp0%2FN%2B71iXiHPu9Ox5Q3XQO53ym31M%2BJC9xTpou6Kh3m3RPSnT3J5Ag%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/37edcfe4b6484dee80eecfdb03a03a08/documents/4d55d049e17441a0ac19cc90014e181c
{
"data": {
"documentType": "evaluationReports",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8395d296066f4991a7f59f6f38e8134d?Signature=ZirsijPraaCgfVEEV8p6Pztlb1uMjmnYg%2FJxOlcBnLiIlvgCEhX8ZEQwQ2lcu6nKKS7XBc8vD%2FYLDXeQBS7TAw%3D%3D&KeyID=a8968c46",
"language": "uk",
"id": "4d55d049e17441a0ac19cc90014e181c",
"datePublished": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00"
}
}
Тепер можна підтвердити рішення по заявці:
PATCH /api/2.5/qualifications/37edcfe4b6484dee80eecfdb03a03a08?acc_token=2a5f07868aed43bfb10588a5ac40185a 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": "4d55d049e17441a0ac19cc90014e181c",
"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/8395d296066f4991a7f59f6f38e8134d?Signature=ZirsijPraaCgfVEEV8p6Pztlb1uMjmnYg%2FJxOlcBnLiIlvgCEhX8ZEQwQ2lcu6nKKS7XBc8vD%2FYLDXeQBS7TAw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
}
],
"submissionID": "0c3ac4255ccc46e4b317616f23fa6766",
"frameworkID": "79215d0ea54f4a04b04d7fadf4090ca1",
"status": "active",
"date": "2027-01-17T00:00:00+02:00",
"dateModified": "2027-01-17T00:00:00+02:00",
"qualificationType": "dynamicPurchasingSystem",
"id": "37edcfe4b6484dee80eecfdb03a03a08"
},
"config": {
"restricted": false,
"qualificationComplainDuration": 0
}
}
Після підтвердження рішення по заявці, якщо це було перше затверджене рішення система створює реєстр з контрактом, в іншому випадку система додає контракт до реєстру.
Перевіримо кваліфікацію:
GET /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1 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": "fa81182a8ca44a08bcbca5d7128c8640",
"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/f5cb842886f141e681b47175faee1ea1?Signature=G7BvnAz3bGtcoEJQ4VMw2s9ARIPKFD0ZsNnTzvkGoYumAUv61r%2BTP0NXiTQhwebXxqUJM1d5aNg5AU8LtKBSCw%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/beda32f664fb459291d362e650147d5d?Signature=pcYNBP%2FAj04nzgykslGVmqMOd3wtV9PptoB5NuzsDBne78GS2HGn9hmq%2ByTIhaYOr%2Bdtv6mO63IBY8NkQ3jrAg%3D%3D&KeyID=a8968c46",
"dateModified": "2027-01-01T00:00:00+02:00",
"language": "uk"
},
{
"id": "1e1af8dcdca84f1488d5cbcd78cc0466",
"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/d369fa8572584fffba4fe7fb70daffe2?Signature=%2B8G4s2LtJtEl9ij7xF17ayvO5H1BxrBWc7bAMhNt6pn9JkPAOCocA1BAkf3wIPgRzu8bKDe4qvayMpJcnL%2FlAQ%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": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000001",
"email": "aa@aa.com"
},
"kind": "general"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-15T00:00:00+02:00",
"clarificationsUntil": "2027-01-20T00: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-16T00:00:00+02:00",
"agreementID": "2c50602a5c214dfba111d06f8a79565f",
"id": "79215d0ea54f4a04b04d7fadf4090ca1"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
Ви можете побачити, що в кваліфікації з’явилось поле agreementID, тож давайте перевіримо реєстр:
GET /api/2.5/agreements/2c50602a5c214dfba111d06f8a79565f 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": "79215d0ea54f4a04b04d7fadf4090ca1",
"agreementType": "dynamicPurchasingSystem",
"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": "209af725e14a4ede8edc1720b0f84d65",
"qualificationID": "37edcfe4b6484dee80eecfdb03a03a08",
"submissionID": "0c3ac4255ccc46e4b317616f23fa6766",
"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": "75dd72d8712449c6b4ca3adb2dd7c11d",
"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": "2c50602a5c214dfba111d06f8a79565f"
},
"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": "2c50602a5c214dfba111d06f8a79565f"
}
],
"next_page": {
"offset": "1800136800.0.1.d67300db087544aa93bc187cc364c9ea",
"path": "/api/2.5/agreements?offset=1800136800.0.1.d67300db087544aa93bc187cc364c9ea",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?offset=1800136800.0.1.d67300db087544aa93bc187cc364c9ea"
}
}
Перевіримо, що містить реєстр рішення по заявці:
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": "6dc22ab2c87f41bb91375ca71951687c"
},
{
"dateModified": "2027-01-17T00:00:00+02:00",
"id": "37edcfe4b6484dee80eecfdb03a03a08"
}
],
"next_page": {
"offset": "1800136800.0.2.fb6eed4e4087874621b93ee8732091fe",
"path": "/api/2.5/qualifications?offset=1800136800.0.2.fb6eed4e4087874621b93ee8732091fe",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?offset=1800136800.0.2.fb6eed4e4087874621b93ee8732091fe"
}
}
Перевіримо всі рішення по заявці до данної кваліфікації:
GET /api/2.5/frameworks/79215d0ea54f4a04b04d7fadf4090ca1/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": "7ec09bfc14fe4ccda58d49c40c7d7616",
"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/6dc22ab2c87f41bb91375ca71951687c/documents/7ec09bfc14fe4ccda58d49c40c7d7616?download=261302c61582415fa7ca7a5348f275ba",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
},
{
"documentType": "evaluationReports",
"id": "20ff860f52c541a995707c9bceea4d56",
"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/6dc22ab2c87f41bb91375ca71951687c/documents/20ff860f52c541a995707c9bceea4d56?download=9227b1be6f824b27a68117b66cb4d996",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
}
],
"submissionID": "2653e869246f4cb6900d45568c0a7e2b",
"frameworkID": "79215d0ea54f4a04b04d7fadf4090ca1",
"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": "6dc22ab2c87f41bb91375ca71951687c"
},
{
"documents": [
{
"documentType": "evaluationReports",
"id": "4d55d049e17441a0ac19cc90014e181c",
"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/37edcfe4b6484dee80eecfdb03a03a08/documents/4d55d049e17441a0ac19cc90014e181c?download=8395d296066f4991a7f59f6f38e8134d",
"dateModified": "2027-01-17T00:00:00+02:00",
"language": "uk"
}
],
"submissionID": "0c3ac4255ccc46e4b317616f23fa6766",
"frameworkID": "79215d0ea54f4a04b04d7fadf4090ca1",
"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": "37edcfe4b6484dee80eecfdb03a03a08"
}
],
"next_page": {
"offset": "1800136800.0.2.fb6eed4e4087874621b93ee8732091fe",
"path": "/api/2.5/qualifications?offset=1800136800.0.2.fb6eed4e4087874621b93ee8732091fe",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?offset=1800136800.0.2.fb6eed4e4087874621b93ee8732091fe"
}
}
Завершення кваліфікації
Завершення кваліфікації відбувається автоматично після настання дати qualificationPeriod.endDate.
PATCH запит з новим значенням qualificationPeriod.endDate дозволяє завершити фрейморк раніше запланованого часу, але не раніше 30 повних календарних днів з моменту зміни qualificationPeriod.endDate.