Конфіденційні документи

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

Конфіденційність

Документи можуть бути публічними або приватними:

Приватність документа можна змінити тільки для останньої версії.

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

Налаштування приватності можна міняти тільки під час періоду подання пропозицій (зі статусом active.tendering).

Якщо закупівля має статус active.qualification, переможець може завантажувати тільки публічні документи.

Туторіал

Завантажимо приватний документ

Request

POST /api/2.5/tenders/2a5accd9090044dfba8773895b0bff51/bids/5cff484ac52046ce96d713e75a6af577/documents?acc_token=7e5769dd84b844439dd9a0fce43ff6bc HTTP/1.0
Authorization: Bearer broker
Content-Length: 460
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "private.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/bed8dcbd27644f418f3d0645d955859a?Signature=%2Fma7ckwkj4u2vxw38wJe6aAc7icF62FDOqSZY4U5Y9WFIWaPGjqxOAUwIPI7II%2BEWBotNb5%2FNSbZ%2FU9ekic%2BAA%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword",
    "confidentiality": "buyerOnly",
    "confidentialityRationale": "This document contains some secret data that shouldn't be public"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a5accd9090044dfba8773895b0bff51/bids/5cff484ac52046ce96d713e75a6af577/documents/792b94edcc1645558285a6e53a6566db

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "private.doc",
    "format": "application/msword",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a5accd9090044dfba8773895b0bff51/bids/5cff484ac52046ce96d713e75a6af577/documents/792b94edcc1645558285a6e53a6566db?download=bed8dcbd27644f418f3d0645d955859a",
    "documentOf": "tender",
    "language": "uk",
    "confidentiality": "buyerOnly",
    "confidentialityRationale": "This document contains some secret data that shouldn't be public",
    "id": "792b94edcc1645558285a6e53a6566db",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00"
  }
}

“конфіденційність” може бути змінена під час періоду подання пропозицій

Request

PATCH /api/2.5/tenders/2a5accd9090044dfba8773895b0bff51/bids/5cff484ac52046ce96d713e75a6af577/documents/09de207106af4254ae4b30471ffb7e21?acc_token=7e5769dd84b844439dd9a0fce43ff6bc HTTP/1.0
Authorization: Bearer broker
Content-Length: 178
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "confidentiality": "buyerOnly",
    "confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality"
  }
}

Response

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

{
  "data": {
    "id": "09de207106af4254ae4b30471ffb7e21",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "hash": "md5:00000000000000000000000000000000",
    "title": "public-to-private.doc",
    "format": "application/msword",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a5accd9090044dfba8773895b0bff51/bids/5cff484ac52046ce96d713e75a6af577/documents/09de207106af4254ae4b30471ffb7e21?download=48945373accd4d29ba34ccdf21d9804a",
    "documentOf": "tender",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "language": "uk",
    "confidentiality": "buyerOnly",
    "confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality"
  }
}

Конфіденційні документи показані без поля “url”

Request

GET /api/2.5/tenders/2a5accd9090044dfba8773895b0bff51/bids/5cff484ac52046ce96d713e75a6af577/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": "private.doc",
      "format": "application/msword",
      "documentOf": "tender",
      "language": "uk",
      "confidentiality": "buyerOnly",
      "confidentialityRationale": "This document contains some secret data that shouldn't be public",
      "id": "792b94edcc1645558285a6e53a6566db",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    },
    {
      "id": "09de207106af4254ae4b30471ffb7e21",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "hash": "md5:00000000000000000000000000000000",
      "title": "public-to-private.doc",
      "format": "application/msword",
      "documentOf": "tender",
      "dateModified": "2023-10-10T01:00:00+03:00",
      "language": "uk",
      "confidentiality": "buyerOnly",
      "confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "public.doc",
      "format": "application/msword",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b685322d12b4938a1485f15d7b8055c?Signature=Gqk57hUOrPwtwykDL1i7JDzVqpuQJOvTiHQ3vw9152GolAqDD10cXonoHkNGN%2Byv054UsWYfd33%2Bgze1Mo3EDg%3D%3D&KeyID=a8968c46",
      "documentOf": "tender",
      "language": "uk",
      "confidentiality": "public",
      "id": "ee649ceb45ab4e82be7e294f047fde7f",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}

Тільки власник тендерів та торгів повинен бачити поля ‘url’ та мати можливість завантажувати конфіденційні документи

Request

GET /api/2.5/tenders/2a5accd9090044dfba8773895b0bff51/bids/5cff484ac52046ce96d713e75a6af577/documents?acc_token=897e40cd3d56497e91e02203d74510ee 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": "private.doc",
      "format": "application/msword",
      "url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a5accd9090044dfba8773895b0bff51/bids/5cff484ac52046ce96d713e75a6af577/documents/792b94edcc1645558285a6e53a6566db?download=bed8dcbd27644f418f3d0645d955859a",
      "documentOf": "tender",
      "language": "uk",
      "confidentiality": "buyerOnly",
      "confidentialityRationale": "This document contains some secret data that shouldn't be public",
      "id": "792b94edcc1645558285a6e53a6566db",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    },
    {
      "id": "09de207106af4254ae4b30471ffb7e21",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "hash": "md5:00000000000000000000000000000000",
      "title": "public-to-private.doc",
      "format": "application/msword",
      "url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a5accd9090044dfba8773895b0bff51/bids/5cff484ac52046ce96d713e75a6af577/documents/09de207106af4254ae4b30471ffb7e21?download=48945373accd4d29ba34ccdf21d9804a",
      "documentOf": "tender",
      "dateModified": "2023-10-10T01:00:00+03:00",
      "language": "uk",
      "confidentiality": "buyerOnly",
      "confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "public.doc",
      "format": "application/msword",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b685322d12b4938a1485f15d7b8055c?Signature=Gqk57hUOrPwtwykDL1i7JDzVqpuQJOvTiHQ3vw9152GolAqDD10cXonoHkNGN%2Byv054UsWYfd33%2Bgze1Mo3EDg%3D%3D&KeyID=a8968c46",
      "documentOf": "tender",
      "language": "uk",
      "confidentiality": "public",
      "id": "ee649ceb45ab4e82be7e294f047fde7f",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}