Обмежений доступ

Фреймворк може мати обмежений доступ з наступними правилами

Object

Публічний API

Приватний API (Замовник)

Приватний API (Учасник)

framework

перегляд

перегляд/редагування

перегляд

submission

перегляд (всі)

перегляд/редагування (власні)

qualification

перегляд/редагування (всі)

перегляд (власні)

agreement

перегляд/редагування (всі)

Домовимось, що Замовник та Учасники будуть використовувати різних брокерів для роботи з API:

  • Замовник використовує Broker

  • Учасник 1 використовує Broker 1

  • Учасник 2 використовує Broker 2

Створення фреймворку з обмеженим доступом

Спочатку створимо фреймворк з обмеженим доступом за допомогою Broker. Для цього нам потрібно встановити restricted_derivatives поле в true в config розділі запиту на створення фреймворку.

Request

POST /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Content-Length: 1873
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": "defense",
      "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": "2023-03-02T00:00:00+02:00"
    }
  },
  "config": {
    "restrictedDerivatives": true
  }
}

Response

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

{
  "data": {
    "status": "draft",
    "title": "Узагальнена назва закупівлі",
    "description": "Назва предмета закупівлі",
    "qualificationPeriod": {
      "endDate": "2023-03-02T00: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": "defense"
    },
    "prettyID": "UA-F-2023-01-01-000001",
    "owner": "broker",
    "date": "2023-01-01T00:00:00+02:00",
    "dateCreated": "2023-01-01T00:00:00+02:00",
    "dateModified": "2023-01-01T00:00:00+02:00",
    "id": "6f4f10deaaae4f8b9d117837474a9333"
  },
  "access": {
    "token": "a2ff40fa3e7143baa0a0b38805036fe7",
    "transfer": "0b5fce6b65e4463aa9ec39a7dea1aeb9"
  },
  "config": {
    "restrictedDerivatives": true
  }
}

Цей фреймворк сам по собі видно всім в публічному API.

Примітка

Для ProcuringEntity з kind defense поле restricted_derivatives буде встановлено в true автоматично.

Другий крок - перехід фреймворку в статус active:

Request

PATCH /api/2.5/frameworks/6f4f10deaaae4f8b9d117837474a9333?acc_token=a2ff40fa3e7143baa0a0b38805036fe7 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

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

Response

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

{
  "data": {
    "prettyID": "UA-F-2023-01-01-000001",
    "title": "Узагальнена назва закупівлі",
    "description": "Назва предмета закупівлі",
    "status": "active",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "owner": "broker",
    "date": "2023-01-01T00:00:00+02:00",
    "dateCreated": "2023-01-01T00:00:00+02:00",
    "dateModified": "2023-01-01T00:00:00+02:00",
    "qualificationPeriod": {
      "endDate": "2023-03-02T00:00:00+02:00",
      "startDate": "2023-01-01T00: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": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "defense"
    },
    "enquiryPeriod": {
      "startDate": "2023-01-01T00:00:00+02:00",
      "endDate": "2023-01-14T00:00:00+02:00",
      "clarificationsUntil": "2023-01-19T00:00:00+02:00"
    },
    "period": {
      "startDate": "2023-01-01T00:00:00+02:00",
      "endDate": "2023-01-31T00:00:00+02:00"
    },
    "next_check": "2023-01-28T00:00:00+02:00",
    "id": "6f4f10deaaae4f8b9d117837474a9333"
  },
  "config": {
    "restrictedDerivatives": true
  }
}

Уточнення

У учасника є можливість звернутися до адміністратора (ЦЗО) через електронну систему закупівель щодо перегляду вимог до учасника, зазначених в оголошенні про проведення кваліфікації до електронного каталогу, протягом десяти робочих днів з дня його оприлюднення.

Під час enquiryPeriod зацікавлені сторони можуть задавати питання:

Request

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

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність",
    "author": {
      "address": {
        "countryName": "Україна",
        "locality": "м. Львів",
        "postalCode": "79013",
        "region": "Львівська область",
        "streetAddress": "вул. Островського, 34"
      },
      "contactPoint": {
        "email": "aagt@gmail.com",
        "name": "Андрій Олексюк",
        "telephone": "+380322916930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
        "id": "00137226",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Книга»"
    }
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/6f4f10deaaae4f8b9d117837474a9333/questions/bfbf3b0718564cc1b1d4dab56c4d796f

{
  "data": {
    "author": {
      "name": "ДКП «Книга»",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00137226",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
        "uri": "http://www.sc.gov.ua/"
      },
      "contactPoint": {
        "name": "Андрій Олексюк",
        "email": "aagt@gmail.com",
        "telephone": "+380322916930"
      },
      "address": {
        "streetAddress": "вул. Островського, 34",
        "locality": "м. Львів",
        "region": "Львівська область",
        "postalCode": "79013",
        "countryName": "Україна"
      }
    },
    "title": "Калорійність",
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "id": "bfbf3b0718564cc1b1d4dab56c4d796f",
    "date": "2023-01-01T00:00:00+02:00"
  }
}

Замовник може на них відповісти:

Request

PATCH /api/2.5/frameworks/6f4f10deaaae4f8b9d117837474a9333/questions/bfbf3b0718564cc1b1d4dab56c4d796f?acc_token=a2ff40fa3e7143baa0a0b38805036fe7 HTTP/1.0
Authorization: Bearer broker
Content-Length: 141
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "answer": "Таблицю додано в файлі"
  }
}

Response

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

{
  "data": {
    "id": "bfbf3b0718564cc1b1d4dab56c4d796f",
    "author": {
      "name": "ДКП «Книга»",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00137226",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
        "uri": "http://www.sc.gov.ua/"
      },
      "contactPoint": {
        "name": "Андрій Олексюк",
        "email": "aagt@gmail.com",
        "telephone": "+380322916930"
      },
      "address": {
        "streetAddress": "вул. Островського, 34",
        "locality": "м. Львів",
        "region": "Львівська область",
        "postalCode": "79013",
        "countryName": "Україна"
      }
    },
    "title": "Калорійність",
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "date": "2023-01-01T00:00:00+02:00",
    "answer": "Таблицю додано в файлі",
    "dateAnswered": "2023-01-01T00:00:00+02:00"
  }
}

Надавати замовникам відповіді на questions дозволено протягом всього enquiryPeriod, а також до enquiryPeriod.clarificationsUntil. У випадку, якщо замовник надасть відповідь після закінчення enquiryPeriod.clarificationUntil, буде помилка:

Request

PATCH /api/2.5/frameworks/6f4f10deaaae4f8b9d117837474a9333/questions/bfbf3b0718564cc1b1d4dab56c4d796f?acc_token=a2ff40fa3e7143baa0a0b38805036fe7 HTTP/1.0
Authorization: Bearer broker
Content-Length: 103
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "answer": "Таблицю додано"
  }
}

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Allowed to update question only before enquiryPeriod.clarificationsUntil"
    }
  ]
}

Тільки замовник має право відповідати на питання:

Request

PATCH /api/2.5/frameworks/6f4f10deaaae4f8b9d117837474a9333/questions/bfbf3b0718564cc1b1d4dab56c4d796f HTTP/1.0
Authorization: Bearer broker
Content-Length: 141
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "answer": "Таблицю додано в файлі"
  }
}

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "url",
      "name": "permission",
      "description": "Forbidden"
    }
  ]
}

Можна отримати список запитань:

Request

GET /api/2.5/frameworks/6f4f10deaaae4f8b9d117837474a9333/questions 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": "bfbf3b0718564cc1b1d4dab56c4d796f",
      "author": {
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
          "uri": "http://www.sc.gov.ua/"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380322916930"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        }
      },
      "title": "Калорійність",
      "description": "Просимо додати таблицю потрібної калорійності харчування",
      "date": "2023-01-01T00:00:00+02:00",
      "answer": "Таблицю додано в файлі",
      "dateAnswered": "2023-01-01T00:00:00+02:00"
    }
  ]
}

та окрему відповідь:

Request

GET /api/2.5/frameworks/6f4f10deaaae4f8b9d117837474a9333/questions/bfbf3b0718564cc1b1d4dab56c4d796f 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": "bfbf3b0718564cc1b1d4dab56c4d796f",
    "author": {
      "name": "ДКП «Книга»",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00137226",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
        "uri": "http://www.sc.gov.ua/"
      },
      "contactPoint": {
        "name": "Андрій Олексюк",
        "email": "aagt@gmail.com",
        "telephone": "+380322916930"
      },
      "address": {
        "streetAddress": "вул. Островського, 34",
        "locality": "м. Львів",
        "region": "Львівська область",
        "postalCode": "79013",
        "countryName": "Україна"
      }
    },
    "title": "Калорійність",
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "date": "2023-01-01T00:00:00+02:00",
    "answer": "Таблицю додано в файлі",
    "dateAnswered": "2023-01-01T00:00:00+02:00"
  }
}

Наявність звернення не блокує перехід оголошення про кваліфікацію у наступний статус.

Наявність або відсутність відповіді на звернення не блокує перехід оголошення про кваліфікацію у наступний статус.

Період, протягом якого Учасник може звернутися до адміністратора (ЦЗО) через електронну систему закупівель щодо перегляду вимог до учасника: дата оприлюднення оголошення + 10 робочих днів.

Не можна створювати або редагувати звернення за межами enquiryPeriod:

Request

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

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність",
    "author": {
      "address": {
        "countryName": "Україна",
        "locality": "м. Львів",
        "postalCode": "79013",
        "region": "Львівська область",
        "streetAddress": "вул. Островського, 34"
      },
      "contactPoint": {
        "email": "aagt@gmail.com",
        "name": "Андрій Олексюк",
        "telephone": "+380322916930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
        "id": "00137226",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Книга»"
    }
  }
}

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Question can be add only during the enquiry period: from (2023-01-01T00:00:00+02:00) to (2023-01-14T00:00:00+02:00)."
    }
  ]
}

Створення та активація пропозицій з обмеженим доступом

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

Зареєструємо пропозицію за допомогою Broker 1:

Request

POST /api/2.5/submissions HTTP/1.0
Authorization: Bearer broker1
Content-Length: 1236
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": "6f4f10deaaae4f8b9d117837474a9333"
  },
  "config": {
    "restricted": true
  }
}

Response

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

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "scale": "micro",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        }
      }
    ],
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "status": "draft",
    "submissionType": "dynamicPurchasingSystem",
    "owner": "broker1",
    "date": "2023-01-20T00:00:00+02:00",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "id": "fd9a2e1f2e674531813756d4d0aaa351"
  },
  "access": {
    "token": "25410576c6124986aa4e5dc47fa262bc",
    "transfer": "b031ac75f72541439c08e6cfbb74ff10"
  },
  "config": {
    "restricted": true
  }
}

Ви можете побачити, що поле restricted було встановлено в true в розділі config відповіді на створення пропозиції.

Далі активуємо пропозицію за допомогою Broker 1:

Request

PATCH /api/2.5/submissions/fd9a2e1f2e674531813756d4d0aaa351?acc_token=25410576c6124986aa4e5dc47fa262bc HTTP/1.0
Authorization: Bearer broker1
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

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

Response

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

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

Додамо ще одну пропозицію за допомогою Broker 2:

Request

POST /api/2.5/submissions HTTP/1.0
Authorization: Bearer broker2
Content-Length: 1214
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "tenderers": [
      {
        "address": {
          "countryName": "Україна",
          "locality": "м. Львів",
          "postalCode": "79013",
          "region": "Львівська область",
          "streetAddress": "вул. Островського, 34"
        },
        "contactPoint": {
          "email": "aagt@gmail.com",
          "name": "Андрій Олексюк",
          "telephone": "+380322916930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "scale": "sme"
      }
    ],
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333"
  },
  "config": {
    "restricted": true
  }
}

Response

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

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Книга»",
        "scale": "sme",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380322916930"
        }
      }
    ],
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "status": "draft",
    "submissionType": "dynamicPurchasingSystem",
    "owner": "broker2",
    "date": "2023-01-20T00:00:00+02:00",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "id": "e0fc16d4a32e49bbb327106221ee3afe"
  },
  "access": {
    "token": "7547e10a63d2426a89db2abd0d195c7a",
    "transfer": "01e8c57c0d744464a6bd17d497ec4c9c"
  },
  "config": {
    "restricted": true
  }
}

І активуємо її:

Request

PATCH /api/2.5/submissions/e0fc16d4a32e49bbb327106221ee3afe?acc_token=7547e10a63d2426a89db2abd0d195c7a HTTP/1.0
Authorization: Bearer broker2
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

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

Response

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

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Книга»",
        "scale": "sme",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380322916930"
        }
      }
    ],
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "status": "active",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "date": "2023-01-20T00:00:00+02:00",
    "owner": "broker2",
    "submissionType": "dynamicPurchasingSystem",
    "datePublished": "2023-01-20T00:00:00+02:00",
    "qualificationID": "7f54f20afbae46de95952e02da039fd8",
    "id": "e0fc16d4a32e49bbb327106221ee3afe"
  },
  "config": {
    "restricted": true
  }
}

Запит пропозицій з обмеженим доступом

Перевіримо пропозиції всіх учасників:

Broker (Замовник)

Перевіримо фід пропозицій для Broker, який є Замовником та має доступ до всіх пропозицій фреймворку:

Request

GET /api/2.5/submissions?opt_fields=frameworkID,status 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": "6f4f10deaaae4f8b9d117837474a9333",
      "status": "active",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "fd9a2e1f2e674531813756d4d0aaa351"
    },
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "status": "active",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "e0fc16d4a32e49bbb327106221ee3afe"
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1674165600.0"
  }
}

Тепер зробимо запит за допомогою Broker для пропозиції, створеної Broker 1:

Request

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

Response

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

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

Тепер зробимо запит за допомогою Broker для пропозиції, створеної Broker 2:

Request

GET /api/2.5/submissions/e0fc16d4a32e49bbb327106221ee3afe 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": "sme",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380322916930"
        }
      }
    ],
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "status": "active",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "date": "2023-01-20T00:00:00+02:00",
    "owner": "broker2",
    "submissionType": "dynamicPurchasingSystem",
    "datePublished": "2023-01-20T00:00:00+02:00",
    "qualificationID": "7f54f20afbae46de95952e02da039fd8",
    "id": "e0fc16d4a32e49bbb327106221ee3afe"
  },
  "config": {
    "restricted": true
  }
}

Broker 1 (Учасник 1)

Перевіримо фід пропозицій для Broker 1, який є Учасником 1 та має доступ тільки до власних пропозицій:

Request

GET /api/2.5/submissions?opt_fields=frameworkID,status HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": [
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "status": "active",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "fd9a2e1f2e674531813756d4d0aaa351"
    },
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "e0fc16d4a32e49bbb327106221ee3afe",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1674165600.0"
  }
}

Ми бачимо, що друга пропозиція частково видна в фіді і позначена полем restricted, встановленим в true.

Тепер зробимо запит за допомогою Broker 1 для пропозиції, створеної Broker 1:

Request

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

Response

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

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

Тепер зробимо запит за допомогою Broker 1 для пропозиції, створеної Broker 2:

Request

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

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for submission object"
    }
  ]
}

Ми бачимо повідомлення про помилку, що пропозиція обмежена для Broker 1.

Broker 2 (Учасник 2)

Перевіримо фід пропозицій для Broker 2, який є Учасником 2 та має доступ тільки до власних пропозицій:

Request

GET /api/2.5/submissions?opt_fields=frameworkID,status HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": [
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "status": "active",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "fd9a2e1f2e674531813756d4d0aaa351"
    },
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "e0fc16d4a32e49bbb327106221ee3afe",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1674165600.0"
  }
}

Тепер зробимо запит за допомогою Broker 2 для пропозиції, створеної Broker 1:

Request

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

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for submission object"
    }
  ]
}

Тепер зробимо запит за допомогою Broker 2 для пропозиції, створеної Broker 2:

Request

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

Response

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

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Книга»",
        "scale": "sme",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380322916930"
        }
      }
    ],
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "status": "active",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "date": "2023-01-20T00:00:00+02:00",
    "owner": "broker2",
    "submissionType": "dynamicPurchasingSystem",
    "datePublished": "2023-01-20T00:00:00+02:00",
    "qualificationID": "7f54f20afbae46de95952e02da039fd8",
    "id": "e0fc16d4a32e49bbb327106221ee3afe"
  },
  "config": {
    "restricted": true
  }
}

Анонімно

Перевіримо фід пропозицій з анонімним запитом (або будь-яким брокером, який не є Broker або Broker 1):

Request

GET /api/2.5/submissions?opt_fields=frameworkID,status HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": [
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "fd9a2e1f2e674531813756d4d0aaa351",
      "restricted": true
    },
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "e0fc16d4a32e49bbb327106221ee3afe",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1674165600.0"
  }
}

Тепер зробимо запит для пропозиції, створеної Broker 1:

Request

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

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for submission object"
    }
  ]
}

Тепер зробимо запит для пропозиції, створеної Broker 2:

Request

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

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for submission object"
    }
  ]
}

Запит кваліфікацій з обмеженим доступом

Перевіримо кваліфікації всіх учасників:

Broker (Замовник)

Перевіримо фід кваліфікацій для Broker, який є Замовником та має доступ до всіх кваліфікацій фреймворку:

Request

GET /api/2.5/submissions?opt_fields=frameworkID,status 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": "6f4f10deaaae4f8b9d117837474a9333",
      "status": "active",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "fd9a2e1f2e674531813756d4d0aaa351"
    },
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "status": "active",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "e0fc16d4a32e49bbb327106221ee3afe"
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1674165600.0"
  }
}

Тепер зробимо запит за допомогою Broker для кваліфікації пропозиції, створеної Broker 1:

Request

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

Response

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

{
  "data": {
    "submissionID": "fd9a2e1f2e674531813756d4d0aaa351",
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "status": "pending",
    "date": "2023-01-20T00:00:00+02:00",
    "qualificationType": "dynamicPurchasingSystem",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "id": "f72e3f40acc64e4085046733e60d7ebb"
  },
  "config": {
    "restricted": true
  }
}

Тепер зробимо запит за допомогою Broker для кваліфікації пропозиції, створеної Broker 2:

Request

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

Response

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

{
  "data": {
    "submissionID": "e0fc16d4a32e49bbb327106221ee3afe",
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "status": "pending",
    "date": "2023-01-20T00:00:00+02:00",
    "qualificationType": "dynamicPurchasingSystem",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "id": "7f54f20afbae46de95952e02da039fd8"
  },
  "config": {
    "restricted": true
  }
}

Broker 1 (Учасник 1)

Перевіримо фід кваліфікацій для Broker 1, який є Учасником 1 та має доступ тільки до власних кваліфікацій:

Request

GET /api/2.5/qualifications?opt_fields=frameworkID,status HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": [
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "status": "pending",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "f72e3f40acc64e4085046733e60d7ebb"
    },
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "7f54f20afbae46de95952e02da039fd8",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1674165600.0"
  }
}

Ми бачимо, що друга кваліфікація частково видна в фіді і позначена полем restricted, встановленим в true.

Тепер зробимо запит за допомогою Broker 1 для кваліфікації пропозиції, створеної Broker 1:

Request

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

Response

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

{
  "data": {
    "submissionID": "fd9a2e1f2e674531813756d4d0aaa351",
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "status": "pending",
    "date": "2023-01-20T00:00:00+02:00",
    "qualificationType": "dynamicPurchasingSystem",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "id": "f72e3f40acc64e4085046733e60d7ebb"
  },
  "config": {
    "restricted": true
  }
}

Потім зробимо запит за допомогою Broker 1 для кваліфікації пропозиції, створеної Broker 2:

Request

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

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for qualification object"
    }
  ]
}

Ми бачимо повідомлення про помилку, що кваліфікація обмежена для Broker 1.

Broker 2 (Учасник 2)

Перевіримо фід кваліфікацій для Broker 2, який є Учасником 2 та має доступ тільки до власних кваліфікацій:

Request

GET /api/2.5/qualifications?opt_fields=frameworkID,status HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": [
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "status": "pending",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "f72e3f40acc64e4085046733e60d7ebb"
    },
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "7f54f20afbae46de95952e02da039fd8",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1674165600.0"
  }
}

Тепер зробимо запит за допомогою Broker 2 для кваліфікації пропозиції, створеної Broker 1:

Request

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

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for qualification object"
    }
  ]
}

Потім зробимо запит за допомогою Broker 2 для кваліфікації пропозиції, створеної Broker 2:

Request

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

Response

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

{
  "data": {
    "submissionID": "e0fc16d4a32e49bbb327106221ee3afe",
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "status": "pending",
    "date": "2023-01-20T00:00:00+02:00",
    "qualificationType": "dynamicPurchasingSystem",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "id": "7f54f20afbae46de95952e02da039fd8"
  },
  "config": {
    "restricted": true
  }
}

Анонімно

Перевіримо фід кваліфікацій з анонімним запитом (або будь-яким брокером, який не є Broker або Broker 1):

Request

GET /api/2.5/qualifications?opt_fields=frameworkID,status HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": [
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "f72e3f40acc64e4085046733e60d7ebb",
      "restricted": true
    },
    {
      "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "7f54f20afbae46de95952e02da039fd8",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1674165600.0"
  }
}

Тепер зробимо запит для кваліфікації пропозиції, створеної Broker 1:

Request

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

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for qualification object"
    }
  ]
}

Потім зробимо запит для кваліфікації пропозиції, створеної Broker 2:

Request

GET /api/2.5/qualifications/7f54f20afbae46de95952e02da039fd8 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for qualification object"
    }
  ]
}

Активуція кваліфікації з обмеженим доступом

Активуємо всі кваліфікації за допомогою Broker:

Request

PATCH /api/2.5/qualifications/f72e3f40acc64e4085046733e60d7ebb?acc_token=a2ff40fa3e7143baa0a0b38805036fe7 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

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

Response

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

{
  "data": {
    "submissionID": "fd9a2e1f2e674531813756d4d0aaa351",
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "status": "active",
    "date": "2023-01-20T00:00:00+02:00",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "qualificationType": "dynamicPurchasingSystem",
    "id": "f72e3f40acc64e4085046733e60d7ebb"
  },
  "config": {
    "restricted": true
  }
}

Request

PATCH /api/2.5/qualifications/7f54f20afbae46de95952e02da039fd8?acc_token=a2ff40fa3e7143baa0a0b38805036fe7 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

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

Response

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

{
  "data": {
    "submissionID": "e0fc16d4a32e49bbb327106221ee3afe",
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "status": "active",
    "date": "2023-01-20T00:00:00+02:00",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "qualificationType": "dynamicPurchasingSystem",
    "id": "7f54f20afbae46de95952e02da039fd8"
  },
  "config": {
    "restricted": true
  }
}

Перевіримо поточний фреймворк

Request

GET /api/2.5/frameworks/6f4f10deaaae4f8b9d117837474a9333 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": {
    "prettyID": "UA-F-2023-01-01-000001",
    "title": "Узагальнена назва закупівлі",
    "description": "Назва предмета закупівлі",
    "status": "active",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "questions": [
      {
        "id": "bfbf3b0718564cc1b1d4dab56c4d796f",
        "author": {
          "name": "ДКП «Книга»",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137226",
            "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
            "uri": "http://www.sc.gov.ua/"
          },
          "contactPoint": {
            "name": "Андрій Олексюк",
            "email": "aagt@gmail.com",
            "telephone": "+380322916930"
          },
          "address": {
            "streetAddress": "вул. Островського, 34",
            "locality": "м. Львів",
            "region": "Львівська область",
            "postalCode": "79013",
            "countryName": "Україна"
          }
        },
        "title": "Калорійність",
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "date": "2023-01-01T00:00:00+02:00",
        "answer": "Таблицю додано в файлі",
        "dateAnswered": "2023-01-01T00:00:00+02:00"
      }
    ],
    "owner": "broker",
    "date": "2023-01-01T00:00:00+02:00",
    "dateCreated": "2023-01-01T00:00:00+02:00",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "period": {
      "startDate": "2023-01-01T00:00:00+02:00",
      "endDate": "2023-01-31T00:00:00+02:00"
    },
    "qualificationPeriod": {
      "startDate": "2023-01-01T00:00:00+02:00",
      "endDate": "2023-03-02T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2023-01-01T00:00:00+02:00",
      "endDate": "2023-01-14T00:00:00+02:00",
      "clarificationsUntil": "2023-01-19T00:00:00+02:00"
    },
    "next_check": "2023-01-28T00: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": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "defense"
    },
    "agreementID": "d99f25c41f374c55854ba197e2e4c560",
    "id": "6f4f10deaaae4f8b9d117837474a9333"
  },
  "config": {
    "restrictedDerivatives": true
  }
}

Ви можете побачити, що agreementID з’явився в поточному фреймворку, тому перевіримо цю угоду.

Запит угоди з обмеженим доступом

Перевіримо угоду всіма учасниками:

Broker (Замовник)

Перевіримо фід угод для Broker, який є Замовником та має доступ до угоди фреймворку:

Request

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

Response

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

{
  "data": [
    {
      "status": "active",
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "d99f25c41f374c55854ba197e2e4c560"
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/agreements?opt_fields=status&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?opt_fields=status&offset=1674165600.0"
  }
}

Тепер зробимо запит за допомогою Broker для угоди:

Request

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

Response

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

{
  "data": {
    "agreementID": "UA-2023-01-20-000001",
    "status": "active",
    "period": {
      "startDate": "2023-01-20T00:00:00+02:00",
      "endDate": "2023-03-02T00:00:00+02:00"
    },
    "contracts": [
      {
        "id": "71db124af9ca43028e5ea65abbbfee2b",
        "qualificationID": "f72e3f40acc64e4085046733e60d7ebb",
        "status": "active",
        "submissionID": "fd9a2e1f2e674531813756d4d0aaa351",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "96b66040100f4816bcb1ce812a3f2746",
            "type": "activation",
            "status": "scheduled",
            "dueDate": "2023-03-02T00:00:00+02:00",
            "dateModified": "2023-01-20T00:00:00+02:00"
          }
        ],
        "date": "2023-01-20T00:00:00+02:00"
      },
      {
        "id": "17d17b140f1e4aedaf9e5378a40ce8ab",
        "qualificationID": "7f54f20afbae46de95952e02da039fd8",
        "status": "active",
        "submissionID": "e0fc16d4a32e49bbb327106221ee3afe",
        "suppliers": [
          {
            "name": "ДКП «Книга»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137226",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "sme",
            "contactPoint": {
              "name": "Андрій Олексюк",
              "email": "aagt@gmail.com",
              "telephone": "+380322916930"
            },
            "address": {
              "streetAddress": "вул. Островського, 34",
              "locality": "м. Львів",
              "region": "Львівська область",
              "postalCode": "79013",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "aed449f019bd4f828af68cec547119fe",
            "type": "activation",
            "status": "scheduled",
            "dueDate": "2023-03-02T00:00:00+02:00",
            "dateModified": "2023-01-20T00:00:00+02:00"
          }
        ],
        "date": "2023-01-20T00:00:00+02:00"
      }
    ],
    "dateCreated": "2023-01-20T00:00:00+02:00",
    "dateModified": "2023-01-20T00:00:00+02:00",
    "date": "2023-01-20T00:00:00+02:00",
    "owner": "broker",
    "agreementType": "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": "defense"
    },
    "frameworkID": "6f4f10deaaae4f8b9d117837474a9333",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "next_check": "2023-03-02T00:00:00+02:00",
    "id": "d99f25c41f374c55854ba197e2e4c560"
  },
  "config": {
    "restricted": true
  }
}

Broker 1 (Учасник 1)

Перевіримо фід угод для Broker 1:

Request

GET /api/2.5/agreements?opt_fields=status HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": [
    {
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "d99f25c41f374c55854ba197e2e4c560",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/agreements?opt_fields=status&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?opt_fields=status&offset=1674165600.0"
  }
}

Тепер зробимо запит за допомогою Broker 1 для угоди:

Request

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

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for agreement object"
    }
  ]
}

Broker 2 (Учасник 2)

Перевіримо фід угод для Broker 2:

Request

GET /api/2.5/agreements?opt_fields=status HTTP/1.0
Authorization: Bearer broker2
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": [
    {
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "d99f25c41f374c55854ba197e2e4c560",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/agreements?opt_fields=status&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?opt_fields=status&offset=1674165600.0"
  }
}

Тепер зробимо запит за допомогою Broker 2 для угоди:

Request

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

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for agreement object"
    }
  ]
}

Анонімно

Перевіримо фід угод з анонімним запитом (або будь-яким брокером, який не є Broker або Broker 1):

Request

GET /api/2.5/agreements?opt_fields=status HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": [
    {
      "dateModified": "2023-01-20T00:00:00+02:00",
      "id": "d99f25c41f374c55854ba197e2e4c560",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1674165600.0,
    "path": "/api/2.5/agreements?opt_fields=status&offset=1674165600.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?opt_fields=status&offset=1674165600.0"
  }
}

Тепер зробимо запит для угоди:

Request

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

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for agreement object"
    }
  ]
}