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

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

Конфіденційність в пропозиціях

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

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

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

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

Якщо закупівля має статус 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/58ca9b186c2846f688eaecf8f821fc09

{
  "data": {
    "confidentiality": "buyerOnly",
    "confidentialityRationale": "This document contains some secret data that shouldn't be public",
    "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/58ca9b186c2846f688eaecf8f821fc09?download=bed8dcbd27644f418f3d0645d955859a",
    "documentOf": "tender",
    "language": "uk",
    "id": "58ca9b186c2846f688eaecf8f821fc09",
    "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/eacab77ac2764525bdd60be58412b3bf?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": {
    "confidentiality": "buyerOnly",
    "confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality",
    "id": "eacab77ac2764525bdd60be58412b3bf",
    "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/eacab77ac2764525bdd60be58412b3bf?download=48945373accd4d29ba34ccdf21d9804a",
    "documentOf": "tender",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "language": "uk"
  }
}

Конфіденційні документи показані без поля “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": [
    {
      "confidentiality": "buyerOnly",
      "confidentialityRationale": "This document contains some secret data that shouldn't be public",
      "hash": "md5:00000000000000000000000000000000",
      "title": "private.doc",
      "format": "application/msword",
      "documentOf": "tender",
      "language": "uk",
      "id": "58ca9b186c2846f688eaecf8f821fc09",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    },
    {
      "confidentiality": "buyerOnly",
      "confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality",
      "id": "eacab77ac2764525bdd60be58412b3bf",
      "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": "public",
      "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": "c0d10ee6633241e09d2984001f3e7aa5",
      "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": [
    {
      "confidentiality": "buyerOnly",
      "confidentialityRationale": "This document contains some secret data that shouldn't be public",
      "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/58ca9b186c2846f688eaecf8f821fc09?download=bed8dcbd27644f418f3d0645d955859a",
      "documentOf": "tender",
      "language": "uk",
      "id": "58ca9b186c2846f688eaecf8f821fc09",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    },
    {
      "confidentiality": "buyerOnly",
      "confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality",
      "id": "eacab77ac2764525bdd60be58412b3bf",
      "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/eacab77ac2764525bdd60be58412b3bf?download=48945373accd4d29ba34ccdf21d9804a",
      "documentOf": "tender",
      "dateModified": "2023-10-10T01:00:00+03:00",
      "language": "uk"
    },
    {
      "confidentiality": "public",
      "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": "c0d10ee6633241e09d2984001f3e7aa5",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}