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

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

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

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

  1. Приватність документа можна змінити тільки для останньої версії.
  2. При завантаженні нової версії, налаштування приватності копіюються з попередньої версії документа.
  3. Налаштування приватності можна міняти тільки під час періоду подання пропозицій (зі статусом active.tendering).
  4. Якщо закупівля має статус active.qualification, переможець може завантажувати тільки публічні документи.

Туторіал

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

POST /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/930c04e6be2946bfa41898d03dec400e/documents?acc_token=dd8db01099664827aa1826260c296fa8 HTTP/1.0
Authorization: Bearer broker
Content-Length: 462
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "confidentiality": "buyerOnly",
    "title": "private.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a80b88c2517343558b6e061f834130a6?KeyID=a8968c46&Signature=HIm0blH%2BhAke1zBWo25GwhAsfq%2BSc%2FG532m%2BIIPcnJw4iaHt2cPyPfq6Wn1Dnowa10yu%2Fe7daveFu0G1PJQ%2FDw%3D%3D",
    "confidentialityRationale": "This document contains some secret data that shouldn't be public",
    "format": "application/msword"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/930c04e6be2946bfa41898d03dec400e/documents/dbabb976fd0f4592b76f90ee9ec281a3
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "confidentiality": "buyerOnly",
    "title": "private.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/930c04e6be2946bfa41898d03dec400e/documents/dbabb976fd0f4592b76f90ee9ec281a3?download=a80b88c2517343558b6e061f834130a6",
    "confidentialityRationale": "This document contains some secret data that shouldn't be public",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "dbabb976fd0f4592b76f90ee9ec281a3",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

PATCH /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/930c04e6be2946bfa41898d03dec400e/documents/facc91ddd3184f379736baed56674c62?acc_token=dd8db01099664827aa1826260c296fa8 HTTP/1.0
Authorization: Bearer broker
Content-Length: 178
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality",
    "confidentiality": "buyerOnly"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "confidentiality": "buyerOnly",
    "title": "public-to-private.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/930c04e6be2946bfa41898d03dec400e/documents/facc91ddd3184f379736baed56674c62?download=284617724bff4ff6bd1023f665da3b47",
    "confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "facc91ddd3184f379736baed56674c62",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

GET /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/930c04e6be2946bfa41898d03dec400e/documents HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "confidentiality": "buyerOnly",
      "title": "public-to-private.doc",
      "confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "dateModified": "2020-05-15T01:00:00+03:00",
      "id": "facc91ddd3184f379736baed56674c62"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "public.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/aef3d5621c2b4f80ba8bad34c4e234be?KeyID=a8968c46&Signature=ecMxMkHmJGMdBO%2FRF%2FheD0B4yPa%252B5rAxpglLW5ZBltgJNrGY%2F3Zko8oL117%252BQ95Eossv5LcWOR1mC%252BDBEcBQDg%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "09145e1e417b4ebb9188580fda24600b",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "confidentiality": "buyerOnly",
      "title": "private.doc",
      "confidentialityRationale": "This document contains some secret data that shouldn't be public",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "dateModified": "2020-05-15T01:00:00+03:00",
      "id": "dbabb976fd0f4592b76f90ee9ec281a3"
    }
  ]
}

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

GET /api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/930c04e6be2946bfa41898d03dec400e/documents?acc_token=62607c36ce4a4d64961ecc0d0a21540e HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "confidentiality": "buyerOnly",
      "title": "public-to-private.doc",
      "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/930c04e6be2946bfa41898d03dec400e/documents/facc91ddd3184f379736baed56674c62?download=284617724bff4ff6bd1023f665da3b47",
      "confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "facc91ddd3184f379736baed56674c62",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "public.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/aef3d5621c2b4f80ba8bad34c4e234be?KeyID=a8968c46&Signature=ecMxMkHmJGMdBO%2FRF%2FheD0B4yPa%252B5rAxpglLW5ZBltgJNrGY%2F3Zko8oL117%252BQ95Eossv5LcWOR1mC%252BDBEcBQDg%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "09145e1e417b4ebb9188580fda24600b",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "confidentiality": "buyerOnly",
      "title": "private.doc",
      "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/7898ec9992af47ccbc9b8bf1b8539660/bids/930c04e6be2946bfa41898d03dec400e/documents/dbabb976fd0f4592b76f90ee9ec281a3?download=a80b88c2517343558b6e061f834130a6",
      "confidentialityRationale": "This document contains some secret data that shouldn't be public",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "dbabb976fd0f4592b76f90ee9ec281a3",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}