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

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

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

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

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

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

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

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

Туторіал

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

Request

POST /api/2.5/tenders/a450405f3c6840318420a210894cccb1/bids/de4909199c1440ca809e98f0538e3064/documents?acc_token=6dd6b053002e43938d257bd007d873c2 HTTP/1.0
Authorization: Bearer broker
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/a450405f3c6840318420a210894cccb1/bids/de4909199c1440ca809e98f0538e3064/documents/f6b43126ac6541b09aa78052ad667158

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

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

Request

PATCH /api/2.5/tenders/a450405f3c6840318420a210894cccb1/bids/de4909199c1440ca809e98f0538e3064/documents/d21dc81bb3944e39b39703c4cb3ddbe1?acc_token=6dd6b053002e43938d257bd007d873c2 HTTP/1.0
Authorization: Bearer broker
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": "d21dc81bb3944e39b39703c4cb3ddbe1",
    "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/a450405f3c6840318420a210894cccb1/bids/de4909199c1440ca809e98f0538e3064/documents/d21dc81bb3944e39b39703c4cb3ddbe1?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/a450405f3c6840318420a210894cccb1/bids/de4909199c1440ca809e98f0538e3064/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",
      "id": "f6b43126ac6541b09aa78052ad667158",
      "confidentiality": "buyerOnly",
      "confidentialityRationale": "This document contains some secret data that shouldn't be public",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    },
    {
      "id": "d21dc81bb3944e39b39703c4cb3ddbe1",
      "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",
      "id": "6730de047ffd46e18ca23c684477914e",
      "confidentiality": "public",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}

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

Request

GET /api/2.5/tenders/a450405f3c6840318420a210894cccb1/bids/de4909199c1440ca809e98f0538e3064/documents?acc_token=b67eb5061d5445afa4ea2a1bffb1ee5a 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/a450405f3c6840318420a210894cccb1/bids/de4909199c1440ca809e98f0538e3064/documents/f6b43126ac6541b09aa78052ad667158?download=bed8dcbd27644f418f3d0645d955859a",
      "documentOf": "tender",
      "language": "uk",
      "id": "f6b43126ac6541b09aa78052ad667158",
      "confidentiality": "buyerOnly",
      "confidentialityRationale": "This document contains some secret data that shouldn't be public",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    },
    {
      "id": "d21dc81bb3944e39b39703c4cb3ddbe1",
      "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/a450405f3c6840318420a210894cccb1/bids/de4909199c1440ca809e98f0538e3064/documents/d21dc81bb3944e39b39703c4cb3ddbe1?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",
      "id": "6730de047ffd46e18ca23c684477914e",
      "confidentiality": "public",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}