Procuring Entity Operations

Registration of the Tender

Tender registration consists of primary record creation and documentation uploading.

Creating primary Tender record

When registering tender in the database, one has provide all primary tender details (except binary documents) in payload of request.

POST /tenders HTTP/1.1

The produced response will contain URL of the created tender in Location header of response, and in data.id of body.

HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1

Uploading documentation

All tender documentation should be uploaded with the following request - one request per document. You can see supported request types in Documents Uploading section.

POST /tenders/64e93250be76435397e8c992ed4214d1/documents HTTP/1.1

The response produced will have URL of the tender uploaded document in Location header of response and in data.id of body.

HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/documents/6a7d13bd8ec449e08882aeb92180d938

Example request:

Request

POST /api/2.5/tenders/f135bade563d49fc9233e1f1d37fdcf0/documents?acc_token=dc92946b9e4b4ea583fcb7d1136d6cc8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/325d0d7a8e034710bf0f2fdfb91712c5?Signature=o4TxnA%2BJQEYIAK0n1c%2B6r4571MQlQb6fneG7Qw2dygBov9yg%2FlqHyBiZeEaEXKMOzUklyQ6YBJunU5RKwqb6AQ%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f135bade563d49fc9233e1f1d37fdcf0/documents/c8d64dfb8acb418297db4b41a849885f

{
  "data": {
    "confidentiality": "public",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/325d0d7a8e034710bf0f2fdfb91712c5?Signature=iiX0fHzPf9KaOdu%2FjOWJEQLrGxiuLxf34yzcBvHEQu5zF0wQauBfsYPexgAZx7V940YScpEO%2BObVJJx1RkDmDQ%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "language": "uk",
    "id": "c8d64dfb8acb418297db4b41a849885f",
    "datePublished": "2023-10-10T01:00:01+03:00",
    "dateModified": "2023-10-10T01:00:01+03:00",
    "author": "tender_owner"
  }
}

Changing the Tender

Procuring Entity can change both the primary record and associated documentation.

Changing primary Tender Record

Procuring Entity can change the Tender properties with the following request. Data to change should be in payload of the message.

PATCH /tenders/64e93250be76435397e8c992ed4214d1 HTTP/1.1

HTTP/1.1 200 OK

Changing existing documents

Procuring Entity can upload new versions of the tender documentation. You can see supported request types in Documents Uploading section.

PUT /tenders/64e93250be76435397e8c992ed4214d1/documents/6a7d13bd8ec449e08882aeb92180d938 HTTP/1.1

HTTP/1.1 200 OK

Example request:

Request

PUT /api/2.5/tenders/f135bade563d49fc9233e1f1d37fdcf0/documents/219c08f909904568b9a726d99fe509f2?acc_token=dc92946b9e4b4ea583fcb7d1136d6cc8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "AwardCriteria.pdf",
    "description": "Нова версія AwardCriteria документу",
    "description_en": "new version of the AwardCriteria document",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/50ef0208169a47979218f1f8919a46c6?Signature=96VxXWMjGaWNL1XkH%2FhkpQwfViejnFYpH1jzBqgjKSz3jdB3RnhCKinuy7XQdBc7zJ5aMzv85Y0Sz31sd%2BZGBw%3D%3D&KeyID=a8968c46",
    "hash": "md5:11111111111111111111111111111111",
    "format": "application/pdf",
    "language": "en"
  }
}

Response

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

{
  "data": {
    "confidentiality": "public",
    "description": "Нова версія AwardCriteria документу",
    "description_en": "new version of the AwardCriteria document",
    "id": "219c08f909904568b9a726d99fe509f2",
    "datePublished": "2023-10-10T01:10:05+03:00",
    "hash": "md5:11111111111111111111111111111111",
    "title": "AwardCriteria.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/50ef0208169a47979218f1f8919a46c6?Signature=epfCSA6FbFLil0mdrT2fGD9HH1Cb6YvKWDe025wBAAKayzHMzuAiy5fycJgQXHuU1ASOy6QroiPWtGNgiyjWBQ%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "dateModified": "2023-10-10T01:10:05+03:00",
    "author": "tender_owner",
    "language": "en"
  }
}

Uploading additional documents

The same as Uploading documentation.