Confidential documents¶
Confidential documents are supported for bids in the above threshold procedures.
Confidentiality¶
Documents can be either public or private:
- Privacy settings can be changed only for the latest version of the document.
- When you upload new version of the document, privacy settings are copied from the previous version.
- Privacy settings can be changed only during tenderPeriod (with active.tendering status).
- If tender has status active.qualification winner can upload only public documents.
Tutorial¶
Let’s upload a private document
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"
}
}
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/81b15b1242d24d9daa7ea82c67636d8b
{
"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/81b15b1242d24d9daa7ea82c67636d8b?download=bed8dcbd27644f418f3d0645d955859a",
"documentOf": "tender",
"confidentiality": "buyerOnly",
"confidentialityRationale": "This document contains some secret data that shouldn't be public",
"id": "81b15b1242d24d9daa7ea82c67636d8b",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
}
confidentiality can be changed during active.tendering tender status
PATCH /api/2.5/tenders/2a5accd9090044dfba8773895b0bff51/bids/5cff484ac52046ce96d713e75a6af577/documents/ac06ecba81dd44309d96e7324a43d22f?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"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "ac06ecba81dd44309d96e7324a43d22f",
"datePublished": "2023-01-01T00:00:00+02: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/ac06ecba81dd44309d96e7324a43d22f?download=48945373accd4d29ba34ccdf21d9804a",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"confidentiality": "buyerOnly",
"confidentialityRationale": "Lol, this document contains some secret data that shouldn't be public, I'm changing it's confidentiality"
}
}
The confidential documents shown without the url field
GET /api/2.5/tenders/2a5accd9090044dfba8773895b0bff51/bids/5cff484ac52046ce96d713e75a6af577/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "private.doc",
"format": "application/msword",
"documentOf": "tender",
"confidentiality": "buyerOnly",
"confidentialityRationale": "This document contains some secret data that shouldn't be public",
"id": "81b15b1242d24d9daa7ea82c67636d8b",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "ac06ecba81dd44309d96e7324a43d22f",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "public-to-private.doc",
"format": "application/msword",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"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",
"confidentiality": "public",
"id": "6863b3ba7a15405da0e0276f446e38f2",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
]
}
Only tender and bid owner should see the url fields and be able to download confidential documents
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
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/81b15b1242d24d9daa7ea82c67636d8b?download=bed8dcbd27644f418f3d0645d955859a",
"documentOf": "tender",
"confidentiality": "buyerOnly",
"confidentialityRationale": "This document contains some secret data that shouldn't be public",
"id": "81b15b1242d24d9daa7ea82c67636d8b",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "ac06ecba81dd44309d96e7324a43d22f",
"datePublished": "2023-01-01T00:00:00+02: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/ac06ecba81dd44309d96e7324a43d22f?download=48945373accd4d29ba34ccdf21d9804a",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"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",
"confidentiality": "public",
"id": "6863b3ba7a15405da0e0276f446e38f2",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
]
}