Туторіал

Створення кваліфікації

Лише майданчики з 5м рівнем аккредитації можуть створювати кваліфікації. ProcuringEntity може бути лише типу central. Кваліфікацію можуть створювати лише активні ЦЗО зі списку: https://prozorroukr.github.io/standards/organizations/authorized_cpb.json

Створимо кваліфікацію:

Request

POST /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "frameworkType": "electronicCatalogue",
    "procuringEntity": {
      "contactPoint": {
        "telephone": "+0440000000",
        "name": "Назва організації(ЦЗО)",
        "email": "aa@aa.com"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "kind": "central",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      },
      "name": "Повна назва юридичної організації."
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "classification": {
      "scheme": "ДК021",
      "description": "Mustard seeds",
      "id": "03111600-8"
    },
    "title": "Узагальнена назва закупівлі",
    "description": "Назва предмета закупівлі",
    "qualificationPeriod": {
      "endDate": "2023-12-09T01:00:00+03:00"
    }
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/7a229c4d310842c39ef98821651b267b

{
  "data": {
    "status": "draft",
    "title": "Узагальнена назва закупівлі",
    "description": "Назва предмета закупівлі",
    "qualificationPeriod": {
      "endDate": "2023-12-09T01:00:00+03:00"
    },
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "frameworkType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "prettyID": "UA-F-2023-10-10-000001",
    "owner": "broker",
    "date": "2023-10-10T01:00:00+03:00",
    "dateCreated": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "id": "7a229c4d310842c39ef98821651b267b"
  },
  "access": {
    "token": "797fdae523914449922546561e43242f",
    "transfer": "a70857eea6424855a90eec83bfe040a4"
  },
  "config": {
    "restrictedDerivatives": false
  }
}

Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.

Кваліфікацію було створено у статусі draft. У цьому статусі будь-яке поле, окрім технічних, може бути змінено.

Request

PATCH /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b?acc_token=797fdae523914449922546561e43242f 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"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "prettyID": "UA-F-2023-10-10-000001",
    "title": "updated in draft status",
    "description": "Назва предмета закупівлі",
    "status": "draft",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "owner": "broker",
    "date": "2023-10-10T01:00:00+03:00",
    "dateCreated": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "qualificationPeriod": {
      "endDate": "2023-12-09T01:00:00+03:00"
    },
    "frameworkType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000001",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "id": "7a229c4d310842c39ef98821651b267b"
  },
  "config": {
    "restrictedDerivatives": false
  }
}

Завантаження документації

Замовник може завантажити PDF файл у створениу кваліфікацію. Завантаження повинно відбуватись згідно правил Завантаження документів.

Request

POST /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b/documents?acc_token=797fdae523914449922546561e43242f 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/e38e94f4fbab44ecb6f74b90a27e6181?Signature=S4ZIJmRAPa9iDj895YM90wsfSUlBfNExiNKevl9fJdtqw9PkVqhLZP4i7c8sxPSUlRFaQu7puJZzjJwxAF%2BfBg%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/7a229c4d310842c39ef98821651b267b/documents/6e3c9989ef844c53b6b202f3c5d3af28

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "framework.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
    "language": "uk",
    "id": "6e3c9989ef844c53b6b202f3c5d3af28",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:

Request

GET /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b/documents?acc_token=797fdae523914449922546561e43242f HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "framework.doc",
      "format": "application/msword",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
      "language": "uk",
      "id": "6e3c9989ef844c53b6b202f3c5d3af28",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}

І знову можна перевірити, що є два завантажених документа.

Request

POST /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b/documents?acc_token=797fdae523914449922546561e43242f 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/dc4a665229114a72993b89bb20d7874b?Signature=Jm4GFi%2B6QNs2HfsaJbxzcUM4LvKg4LV5EqnlplQKL8wXIIFTUt9UUosrTwTZJlIS%2BVTktc8TzCUrffuIxejoCA%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/7a229c4d310842c39ef98821651b267b/documents/1e3e5196731a48e48ca51152eb00c4ba

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "framework_additional_docs.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
    "language": "uk",
    "id": "1e3e5196731a48e48ca51152eb00c4ba",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00"
  }
}

Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:

Request

PUT /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b/documents/1e3e5196731a48e48ca51152eb00c4ba?acc_token=797fdae523914449922546561e43242f 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/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=qk9TBbp52f8gzFVdjIl6Sm4v1myg%2FUxF4n2zhcsUB6YmpifdDt5vTooiZ83jFGBnMjsw6vYlTTvnXk7AEFemDg%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "id": "1e3e5196731a48e48ca51152eb00c4ba",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "hash": "md5:00000000000000000000000000000000",
    "title": "framework_additional_docs.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "language": "uk"
  }
}

І ми бачимо, що вона перекриває оригінальну версію:

Request

GET /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b/documents/1e3e5196731a48e48ca51152eb00c4ba?acc_token=797fdae523914449922546561e43242f HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "id": "1e3e5196731a48e48ca51152eb00c4ba",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "hash": "md5:00000000000000000000000000000000",
    "title": "framework_additional_docs.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "language": "uk",
    "previousVersions": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
        "language": "uk",
        "id": "1e3e5196731a48e48ca51152eb00c4ba",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "dateModified": "2023-10-10T01:00:00+03:00"
      }
    ]
  }
}

Активація кваліфікації

Наступний крок - змінити статус кваліфікації на active.

qualificationPeriod.endDate має бути у проміжку не менш ніж 30 днів і не більш ніж 1095 днів з моменту активації.

Перед активацією до кваліфікації має бути додано хоча б один документ та підпис.

Request

PATCH /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b?acc_token=797fdae523914449922546561e43242f HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "prettyID": "UA-F-2023-10-10-000001",
    "title": "updated in draft status",
    "description": "Назва предмета закупівлі",
    "status": "active",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "documents": [
      {
        "id": "6e3c9989ef844c53b6b202f3c5d3af28",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      },
      {
        "id": "1e3e5196731a48e48ca51152eb00c4ba",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      },
      {
        "id": "1e3e5196731a48e48ca51152eb00c4ba",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      }
    ],
    "owner": "broker",
    "date": "2023-10-10T01:00:00+03:00",
    "dateCreated": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "qualificationPeriod": {
      "endDate": "2023-12-09T01:00:00+03:00",
      "startDate": "2023-10-10T01:00:00+03:00"
    },
    "frameworkType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000001",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "enquiryPeriod": {
      "startDate": "2023-10-10T01:00:00+03:00",
      "endDate": "2023-10-25T00:00:00+03:00",
      "clarificationsUntil": "2023-10-28T00:00:00+03:00"
    },
    "period": {
      "startDate": "2023-10-10T01:00:00+03:00",
      "endDate": "2023-11-09T00:00:00+02:00"
    },
    "next_check": "2023-11-08T00:00:00+02:00",
    "id": "7a229c4d310842c39ef98821651b267b"
  },
  "config": {
    "restrictedDerivatives": false
  }
}

Після активації кваліфікації будуть розраховані періоди:

enquiryPeriod - перші 10 повних робочих днів з моменту активації.

period - період, коли постачальники можуть подавати заявки.

qualificationPeriod - останні 30 повних календарних днів кваліфікації. У цей період постачальники не можуть подавати нові заявки, але ще приймаються рішення щодо попередньо поданих заявок.

Request

GET /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "prettyID": "UA-F-2023-10-10-000001",
    "title": "updated in draft status",
    "description": "Назва предмета закупівлі",
    "status": "active",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "documents": [
      {
        "id": "6e3c9989ef844c53b6b202f3c5d3af28",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      },
      {
        "id": "1e3e5196731a48e48ca51152eb00c4ba",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      },
      {
        "id": "1e3e5196731a48e48ca51152eb00c4ba",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      }
    ],
    "owner": "broker",
    "date": "2023-10-10T01:00:00+03:00",
    "dateCreated": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-26T01:00:00+03:00",
    "qualificationPeriod": {
      "endDate": "2023-12-09T01:00:00+03:00",
      "startDate": "2023-10-10T01:00:00+03:00"
    },
    "frameworkType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000001",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "enquiryPeriod": {
      "startDate": "2023-10-10T01:00:00+03:00",
      "endDate": "2023-10-25T00:00:00+03:00",
      "clarificationsUntil": "2023-10-28T00:00:00+03:00"
    },
    "period": {
      "startDate": "2023-10-10T01:00:00+03:00",
      "endDate": "2023-11-09T00:00:00+02:00"
    },
    "next_check": "2023-11-08T00:00:00+02:00",
    "agreementID": "6d10ffd01e7a4ab8a94915d9f6eebbdb",
    "id": "7a229c4d310842c39ef98821651b267b"
  },
  "config": {
    "restrictedDerivatives": false
  }
}

Перевіримо, що містить реєстр кваліфікації:

Request

GET /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "dateModified": "2023-10-26T01:00:00+03:00",
      "id": "7a229c4d310842c39ef98821651b267b"
    }
  ],
  "next_page": {
    "offset": 1698271200.0,
    "path": "/api/2.5/frameworks?offset=1698271200.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/frameworks?offset=1698271200.0"
  }
}

Відображається id - внутрішній ідентифікатор та мітка часу dateModified.

Зміна кваліфікації

У статусі active можна змінювати лише деякі поля: telephone, name, email для procuringEntity.contactPoint, endDate для qualificationPeriod, description and documents.

Якщо було змінено поле qualificationPeriod.endDate - всі періоди будуть перераховані.

Request

PATCH /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b?acc_token=797fdae523914449922546561e43242f 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",
    "qualificationPeriod": {
      "endDate": "2023-12-24T01:00:00+03:00"
    }
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "prettyID": "UA-F-2023-10-10-000001",
    "title": "updated in draft status",
    "description": "Назва предмета закупівлі1",
    "status": "active",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "documents": [
      {
        "id": "6e3c9989ef844c53b6b202f3c5d3af28",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      },
      {
        "id": "1e3e5196731a48e48ca51152eb00c4ba",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      },
      {
        "id": "1e3e5196731a48e48ca51152eb00c4ba",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      }
    ],
    "agreementID": "6d10ffd01e7a4ab8a94915d9f6eebbdb",
    "owner": "broker",
    "date": "2023-10-10T01:00:00+03:00",
    "dateCreated": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-26T01:00:00+03:00",
    "period": {
      "startDate": "2023-10-10T01:00:00+03:00",
      "endDate": "2023-11-24T00:00:00+02:00"
    },
    "qualificationPeriod": {
      "startDate": "2023-10-10T01:00:00+03:00",
      "endDate": "2023-12-24T01:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2023-10-10T01:00:00+03:00",
      "endDate": "2023-10-25T00:00:00+03:00",
      "clarificationsUntil": "2023-10-28T00:00:00+03:00"
    },
    "next_check": "2023-11-08T00:00:00+02:00",
    "frameworkType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "зміна",
        "telephone": "+0440000002",
        "email": "ab@aa.com"
      },
      "kind": "central"
    },
    "id": "7a229c4d310842c39ef98821651b267b"
  },
  "config": {
    "restrictedDerivatives": false
  }
}

Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.

Ще одна перевірка списку відображає нову дату модифікації:

Request

GET /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "dateModified": "2023-10-26T01:00:00+03:00",
      "id": "7a229c4d310842c39ef98821651b267b"
    }
  ],
  "next_page": {
    "offset": 1698271200.0,
    "path": "/api/2.5/frameworks?offset=1698271200.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/frameworks?offset=1698271200.0"
  }
}

Реєстрація заявки

Після активації кваліфікації, користувачі можуть зареєструвати свої заявки в період з framework.period.startDate до framework.period.endDate:

Request

POST /api/2.5/submissions HTTP/1.0
Authorization: Bearer broker
Content-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": "7a229c4d310842c39ef98821651b267b"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/7c37a548e4db48a0ac3c1b4d9ead2c5f

{
  "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": "7a229c4d310842c39ef98821651b267b",
    "status": "draft",
    "submissionType": "electronicCatalogue",
    "owner": "broker",
    "date": "2023-10-26T01:00:00+03:00",
    "dateModified": "2023-10-26T01:00:00+03:00",
    "id": "7c37a548e4db48a0ac3c1b4d9ead2c5f"
  },
  "access": {
    "token": "680e74861490448a9177bf199cb6395b",
    "transfer": "2c7416d6b206452588a7e3956cad175d"
  },
  "config": {
    "restricted": false
  }
}

Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковими полями.

Завантаження документації по заявці

Документи можливо завантажити/оновити тільки до заявки у статусі draft.

Усі операції над документами такі ж як у кваліфікації:

Request

POST /api/2.5/submissions/7c37a548e4db48a0ac3c1b4d9ead2c5f/documents?acc_token=680e74861490448a9177bf199cb6395b 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/d9006a35da3b4389bf1be5cd34a3071a?Signature=AAVs8klPItfOgpXmSLKSdPVkqkyurE0Cb6Ert1YivEQN3KXJ33xrlDNzdtvxaxnnzkmwnZThFNaJoHXuxs4%2FBQ%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/7c37a548e4db48a0ac3c1b4d9ead2c5f/documents/51eb561eb78c4fa49dad5d1097e9c7cc

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "submission_docs.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d9006a35da3b4389bf1be5cd34a3071a?Signature=i8SHbMgp8F%2BDTPKCmPFxk0f7CTww8xsbmAdwhOky%2FgyFcAIuTveMDAT69TBjFyLOOYgdCosl%2FL%2FQ6JWzoPq%2BCA%3D%3D&KeyID=a8968c46",
    "language": "uk",
    "id": "51eb561eb78c4fa49dad5d1097e9c7cc",
    "datePublished": "2023-10-26T01:00:00+03:00",
    "dateModified": "2023-10-26T01:00:00+03:00"
  }
}

Request

GET /api/2.5/submissions/7c37a548e4db48a0ac3c1b4d9ead2c5f/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "submission_docs.doc",
      "format": "application/msword",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d9006a35da3b4389bf1be5cd34a3071a?Signature=i8SHbMgp8F%2BDTPKCmPFxk0f7CTww8xsbmAdwhOky%2FgyFcAIuTveMDAT69TBjFyLOOYgdCosl%2FL%2FQ6JWzoPq%2BCA%3D%3D&KeyID=a8968c46",
      "language": "uk",
      "id": "51eb561eb78c4fa49dad5d1097e9c7cc",
      "datePublished": "2023-10-26T01:00:00+03:00",
      "dateModified": "2023-10-26T01:00:00+03:00"
    }
  ]
}

Видалення заявки

Заявка може бути видалена лише у статусі draft:

Request

PATCH /api/2.5/submissions/7c37a548e4db48a0ac3c1b4d9ead2c5f?acc_token=680e74861490448a9177bf199cb6395b HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "deleted"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "tenderers": [
      {
        "name": "НАЗВА",
        "scale": "micro",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "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": "51eb561eb78c4fa49dad5d1097e9c7cc",
        "datePublished": "2023-10-26T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "submission_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d9006a35da3b4389bf1be5cd34a3071a?Signature=i8SHbMgp8F%2BDTPKCmPFxk0f7CTww8xsbmAdwhOky%2FgyFcAIuTveMDAT69TBjFyLOOYgdCosl%2FL%2FQ6JWzoPq%2BCA%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-26T01:00:00+03:00",
        "language": "uk"
      }
    ],
    "frameworkID": "7a229c4d310842c39ef98821651b267b",
    "status": "deleted",
    "dateModified": "2023-10-26T01:00:00+03:00",
    "date": "2023-10-26T01:00:00+03:00",
    "owner": "broker",
    "submissionType": "electronicCatalogue",
    "id": "7c37a548e4db48a0ac3c1b4d9ead2c5f"
  },
  "config": {
    "restricted": false
  }
}

Оновлення заявки

Заявка може бути оновлена лише у статусі draft:

Request

PATCH /api/2.5/submissions/7c37a548e4db48a0ac3c1b4d9ead2c5f?acc_token=680e74861490448a9177bf199cb6395b 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"
      }
    ]
  }
}

Response

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": "51eb561eb78c4fa49dad5d1097e9c7cc",
        "datePublished": "2023-10-26T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "submission_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d9006a35da3b4389bf1be5cd34a3071a?Signature=i8SHbMgp8F%2BDTPKCmPFxk0f7CTww8xsbmAdwhOky%2FgyFcAIuTveMDAT69TBjFyLOOYgdCosl%2FL%2FQ6JWzoPq%2BCA%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-26T01:00:00+03:00",
        "language": "uk"
      }
    ],
    "frameworkID": "7a229c4d310842c39ef98821651b267b",
    "status": "draft",
    "dateModified": "2023-10-26T01:00:00+03:00",
    "date": "2023-10-26T01:00:00+03:00",
    "owner": "broker",
    "submissionType": "electronicCatalogue",
    "id": "7c37a548e4db48a0ac3c1b4d9ead2c5f"
  },
  "config": {
    "restricted": false
  }
}

Активація заявки

Заявку можна активувати лише до настання period.endDate

Request

PATCH /api/2.5/submissions/5e1269d73d184f65bf1f889a1abc9974?acc_token=b30af78ba8964a839295518c1e083123 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "scale": "micro",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
        },
        "address": {
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "telephone": "+380432216930",
          "email": "soleksuk@gmail.com"
        }
      }
    ],
    "frameworkID": "7a229c4d310842c39ef98821651b267b",
    "status": "active",
    "dateModified": "2023-10-26T01:00:00+03:00",
    "date": "2023-10-26T01:00:00+03:00",
    "owner": "broker",
    "submissionType": "electronicCatalogue",
    "qualificationID": "6fce332a98dc49939a6a6f0dc2fa33c6",
    "datePublished": "2023-10-26T01:00:00+03:00",
    "id": "5e1269d73d184f65bf1f889a1abc9974"
  },
  "config": {
    "restricted": false
  }
}

Після активації заявки, автоматично створюється об’єкт рішення по заявці і заповнюється поле qualificationID в заявці.

Перевіримо, що містить реєстр заявки:

Request

GET /api/2.5/submissions HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "dateModified": "2023-10-26T01:00:00+03:00",
      "id": "5e1269d73d184f65bf1f889a1abc9974"
    }
  ],
  "next_page": {
    "offset": 1698271200.0,
    "path": "/api/2.5/submissions?offset=1698271200.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?offset=1698271200.0"
  }
}

Перевіримо об’єкт рішення по заявці:

Request

GET /api/2.5/qualifications/6fce332a98dc49939a6a6f0dc2fa33c6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "frameworkID": "7a229c4d310842c39ef98821651b267b",
    "submissionID": "5e1269d73d184f65bf1f889a1abc9974",
    "qualificationType": "electronicCatalogue",
    "status": "pending",
    "date": "2023-10-26T01:00:00+03:00",
    "dateModified": "2023-10-26T01:00:00+03:00",
    "id": "6fce332a98dc49939a6a6f0dc2fa33c6"
  },
  "config": {
    "restricted": false
  }
}

Всі операції над об’єктом рішення по заявці може виконувати лише framework_owner (власник кваліфікації).

Завантаження документації до рішення по заявці

Документи можливо завантажити/оновити тільки до рішення у статусі pending.

Усі операції над документами такі ж як у кваліфікації:

Request

POST /api/2.5/qualifications/6fce332a98dc49939a6a6f0dc2fa33c6/documents?acc_token=797fdae523914449922546561e43242f 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/3cd211e97f284e79b39a6dbba518a484?Signature=G0iQnXOb8ERMANs4d%2F1v67Ah85fwi%2BBr3e40dr3%2Fufmg3O%2BN1dgK%2FmScN%2F7KWFMzOUReuDcqRdenVrM0o5ewCw%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/qualifications/6fce332a98dc49939a6a6f0dc2fa33c6/documents/29d3b10680d242959acdfc88d5a205c5

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "qualification.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3cd211e97f284e79b39a6dbba518a484?Signature=L6flukUBvXZ%2F18tixcMYbXP%2F1CyvbCcYjz6wA0fqGvgls51%2BUXwcEHzTFtNicsz8iz2sObTsvwwOOOQ7bW7NDA%3D%3D&KeyID=a8968c46",
    "language": "uk",
    "id": "29d3b10680d242959acdfc88d5a205c5",
    "datePublished": "2023-10-26T01:00:00+03:00",
    "dateModified": "2023-10-26T01:00:00+03:00"
  }
}

Request

GET /api/2.5/qualifications/6fce332a98dc49939a6a6f0dc2fa33c6/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "qualification.doc",
      "format": "application/msword",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3cd211e97f284e79b39a6dbba518a484?Signature=L6flukUBvXZ%2F18tixcMYbXP%2F1CyvbCcYjz6wA0fqGvgls51%2BUXwcEHzTFtNicsz8iz2sObTsvwwOOOQ7bW7NDA%3D%3D&KeyID=a8968c46",
      "language": "uk",
      "id": "29d3b10680d242959acdfc88d5a205c5",
      "datePublished": "2023-10-26T01:00:00+03:00",
      "dateModified": "2023-10-26T01:00:00+03:00"
    }
  ]
}

Відміна рішення по заявці

Рішення можливо відмінити лише у статусі pending:

Request

PATCH /api/2.5/qualifications/6fce332a98dc49939a6a6f0dc2fa33c6?acc_token=797fdae523914449922546561e43242f HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "unsuccessful"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "documents": [
      {
        "id": "29d3b10680d242959acdfc88d5a205c5",
        "datePublished": "2023-10-26T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "qualification.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3cd211e97f284e79b39a6dbba518a484?Signature=L6flukUBvXZ%2F18tixcMYbXP%2F1CyvbCcYjz6wA0fqGvgls51%2BUXwcEHzTFtNicsz8iz2sObTsvwwOOOQ7bW7NDA%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-26T01:00:00+03:00",
        "language": "uk"
      }
    ],
    "submissionID": "5e1269d73d184f65bf1f889a1abc9974",
    "frameworkID": "7a229c4d310842c39ef98821651b267b",
    "status": "unsuccessful",
    "date": "2023-10-26T01:00:00+03:00",
    "dateModified": "2023-10-26T01:00:00+03:00",
    "qualificationType": "electronicCatalogue",
    "id": "6fce332a98dc49939a6a6f0dc2fa33c6"
  },
  "config": {
    "restricted": false
  }
}

Після відміни рішення, пов’язана завявка змінює статус з active на complete.

Перевіримо що сталося з заявками після відміни рішення:

Request

GET /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b/submissions HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "tenderers": [
        {
          "name": "ДКП «Школяр»",
          "scale": "micro",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137256",
            "uri": "http://www.sc.gov.ua/",
            "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
          },
          "address": {
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "locality": "м. Вінниця",
            "region": "Вінницька область",
            "postalCode": "21100"
          },
          "contactPoint": {
            "name": "Сергій Олексюк",
            "telephone": "+380432216930",
            "email": "soleksuk@gmail.com"
          }
        }
      ],
      "frameworkID": "7a229c4d310842c39ef98821651b267b",
      "status": "complete",
      "dateCreated": "2023-10-26T01:00:00+03:00",
      "dateModified": "2023-10-26T01:00:00+03:00",
      "date": "2023-10-26T01:00:00+03:00",
      "qualificationID": "6fce332a98dc49939a6a6f0dc2fa33c6",
      "datePublished": "2023-10-26T01:00:00+03:00",
      "id": "5e1269d73d184f65bf1f889a1abc9974"
    },
    {
      "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": "7a229c4d310842c39ef98821651b267b",
      "status": "complete",
      "dateCreated": "2023-10-26T01:00:00+03:00",
      "dateModified": "2023-10-26T01:00:00+03:00",
      "date": "2023-10-26T01:00:00+03:00",
      "qualificationID": "2efd8f11d2914763ab331e36e358d306",
      "datePublished": "2023-10-26T01:00:00+03:00",
      "id": "4693711d52b14347b47af79c501fbd5f"
    }
  ],
  "next_page": {
    "offset": 1698271200.0,
    "path": "/api/2.5/submissions?offset=1698271200.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?offset=1698271200.0"
  }
}

Підтвердження рішення по заявці

Рішення можливо погодити лише у статусі pending:

Request

PATCH /api/2.5/qualifications/2efd8f11d2914763ab331e36e358d306?acc_token=797fdae523914449922546561e43242f HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "submissionID": "4693711d52b14347b47af79c501fbd5f",
    "frameworkID": "7a229c4d310842c39ef98821651b267b",
    "status": "active",
    "date": "2023-10-26T01:00:00+03:00",
    "dateModified": "2023-10-26T01:00:00+03:00",
    "qualificationType": "electronicCatalogue",
    "id": "2efd8f11d2914763ab331e36e358d306"
  },
  "config": {
    "restricted": false
  }
}

Після підтвердження рішення по заявці, якщо це було перше затверджене рішення система створює реєстр з контрактом, в іншому випадку система додає контракт до реєстру.

Перевіримо кваліфікацію:

Request

GET /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "prettyID": "UA-F-2023-10-10-000001",
    "title": "updated in draft status",
    "description": "Назва предмета закупівлі",
    "status": "active",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "documents": [
      {
        "id": "6e3c9989ef844c53b6b202f3c5d3af28",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e38e94f4fbab44ecb6f74b90a27e6181?Signature=eYTcMLrU9pbzXw3zQawemAR2B5P4wH7q9Oi%2BaSrfd8yz0GREYrG3PD2aGzaBcLE443%2FXz7h48KBhMQ9rMl8HDw%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      },
      {
        "id": "1e3e5196731a48e48ca51152eb00c4ba",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/dc4a665229114a72993b89bb20d7874b?Signature=cdTNyz3oB7rPP2%2Fou8SnYPoxabwo%2BQcAzgKapCGy9PY%2Fo3NSfRnJlvm9jzPX3Maq8xi6wTSODTEEEXWyEhYpCg%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      },
      {
        "id": "1e3e5196731a48e48ca51152eb00c4ba",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "framework_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f4300d9a1594cfc800f2ea11c9a38d1?Signature=%2FEIDl4zhMc%2FQIlBBsuAcBovf0l1hIzOWn0E%2BS7E45QoXJ0ZAOOPKXmO2jUWxMhgObJloZ9%2FVLIiar4eop2K7Dg%3D%3D&KeyID=a8968c46",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      }
    ],
    "owner": "broker",
    "date": "2023-10-10T01:00:00+03:00",
    "dateCreated": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-26T01:00:00+03:00",
    "qualificationPeriod": {
      "endDate": "2023-12-09T01:00:00+03:00",
      "startDate": "2023-10-10T01:00:00+03:00"
    },
    "frameworkType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000001",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "enquiryPeriod": {
      "startDate": "2023-10-10T01:00:00+03:00",
      "endDate": "2023-10-25T00:00:00+03:00",
      "clarificationsUntil": "2023-10-28T00:00:00+03:00"
    },
    "period": {
      "startDate": "2023-10-10T01:00:00+03:00",
      "endDate": "2023-11-09T00:00:00+02:00"
    },
    "next_check": "2023-11-08T00:00:00+02:00",
    "agreementID": "6d10ffd01e7a4ab8a94915d9f6eebbdb",
    "id": "7a229c4d310842c39ef98821651b267b"
  },
  "config": {
    "restrictedDerivatives": false
  }
}

Ви можете побачити, що в кваліфікації з’явилось поле agreementID, тож давайте перевіримо реєстр:

Request

GET /api/2.5/agreements/6d10ffd01e7a4ab8a94915d9f6eebbdb HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "agreementID": "UA-2023-10-26-000001",
    "frameworkID": "7a229c4d310842c39ef98821651b267b",
    "agreementType": "electronicCatalogue",
    "status": "active",
    "period": {
      "startDate": "2023-10-26T01:00:00+03:00",
      "endDate": "2023-12-09T01:00:00+03:00"
    },
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000001",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "contracts": [
      {
        "id": "835a18a5042142a1b24c75b5e938446e",
        "qualificationID": "2efd8f11d2914763ab331e36e358d306",
        "submissionID": "4693711d52b14347b47af79c501fbd5f",
        "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": "c2fe71f3d39b44068cc0a2d10cfb61fc",
            "status": "scheduled",
            "type": "activation",
            "dueDate": "2023-12-09T01:00:00+03:00",
            "dateModified": "2023-10-26T01:00:00+03:00"
          }
        ],
        "date": "2023-10-26T01:00:00+03:00"
      }
    ],
    "owner": "broker",
    "dateModified": "2023-10-26T01:00:00+03:00",
    "date": "2023-10-26T01:00:00+03:00",
    "next_check": "2023-12-09T01:00:00+03:00",
    "dateCreated": "2023-10-26T01:00:00+03:00",
    "id": "6d10ffd01e7a4ab8a94915d9f6eebbdb"
  },
  "config": {
    "restricted": false
  }
}

Як ви можете побачити реєстр в статусі active та має контракт, щож ми можемо побачити цей реєстр в потоці даних:

Request

GET /api/2.5/agreements HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "dateModified": "2023-10-26T01:00:00+03:00",
      "id": "6d10ffd01e7a4ab8a94915d9f6eebbdb"
    }
  ],
  "next_page": {
    "offset": 1698271200.0,
    "path": "/api/2.5/agreements?offset=1698271200.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?offset=1698271200.0"
  }
}

Перевіримо, що містить реєстр рішення по заявці:

Request

GET /api/2.5/qualifications HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "dateModified": "2023-10-26T01:00:00+03:00",
      "id": "6fce332a98dc49939a6a6f0dc2fa33c6"
    },
    {
      "dateModified": "2023-10-26T01:00:00+03:00",
      "id": "2efd8f11d2914763ab331e36e358d306"
    }
  ],
  "next_page": {
    "offset": 1698271200.0,
    "path": "/api/2.5/qualifications?offset=1698271200.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?offset=1698271200.0"
  }
}

Перевіримо всі рішення по заявці до данної кваліфікації:

Request

GET /api/2.5/frameworks/7a229c4d310842c39ef98821651b267b/qualifications HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "documents": [
        {
          "id": "29d3b10680d242959acdfc88d5a205c5",
          "datePublished": "2023-10-26T01:00:00+03:00",
          "hash": "md5:00000000000000000000000000000000",
          "title": "qualification.doc",
          "format": "application/msword",
          "url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications/6fce332a98dc49939a6a6f0dc2fa33c6/documents/29d3b10680d242959acdfc88d5a205c5?download=3cd211e97f284e79b39a6dbba518a484",
          "dateModified": "2023-10-26T01:00:00+03:00",
          "language": "uk"
        }
      ],
      "submissionID": "5e1269d73d184f65bf1f889a1abc9974",
      "frameworkID": "7a229c4d310842c39ef98821651b267b",
      "status": "unsuccessful",
      "date": "2023-10-26T01:00:00+03:00",
      "dateCreated": "2023-10-26T01:00:00+03:00",
      "dateModified": "2023-10-26T01:00:00+03:00",
      "id": "6fce332a98dc49939a6a6f0dc2fa33c6"
    },
    {
      "submissionID": "4693711d52b14347b47af79c501fbd5f",
      "frameworkID": "7a229c4d310842c39ef98821651b267b",
      "status": "active",
      "date": "2023-10-26T01:00:00+03:00",
      "dateCreated": "2023-10-26T01:00:00+03:00",
      "dateModified": "2023-10-26T01:00:00+03:00",
      "id": "2efd8f11d2914763ab331e36e358d306"
    }
  ],
  "next_page": {
    "offset": 1698271200.0,
    "path": "/api/2.5/qualifications?offset=1698271200.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?offset=1698271200.0"
  }
}

Завершення кваліфікації

Завершення кваліфікації відбувається автоматично після настання дати qualificationPeriod.endDate.

PATCH запит з новим значенням qualificationPeriod.endDate дозволяє завершити фрейморк раніше запланованого часу, але не раніше 30 повних календарних днів з моменту зміни qualificationPeriod.endDate.