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:
POST /api/2.5/tenders/2f5e224866d0459cbaa950a15be70946/documents?acc_token=f220033fc2004e90a9398defdea66c9f 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/6d5acc9f6744445090ee6163719b792e?Signature=xpZcFTPGJQ8J6leBYaQWYeW0CyQyt1SG%2F6EugQxRyxlFu7XmMlj%2BasCkDKsxWXiGZUTnRU%2BOkiJsST%2B0myYDDw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2f5e224866d0459cbaa950a15be70946/documents/dcc28f9e5b0a4475ae1511c9195924ba
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6d5acc9f6744445090ee6163719b792e?Signature=sgMJT6uclURHXV1QkzMq700s6436i6ynr4LaZyZf5B4O1Sn6ed7A8ogX5x1LCHhuC5HKuPrXHgPRYIyDC6H%2BDg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"language": "uk",
"id": "dcc28f9e5b0a4475ae1511c9195924ba",
"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:
PUT /api/2.5/tenders/2f5e224866d0459cbaa950a15be70946/documents/9e36c772ea13480da2398a2c2bd63fe5?acc_token=f220033fc2004e90a9398defdea66c9f HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "AwardCriteria-2.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc7c2e1fbe6a49fea049b4173a46deb0?Signature=KpP9ZLwq%2F6bffcCLhZesC8VhW4hB2b8DGT07M5tz87n07cIHWwvac8nmke8%2FIOG0Je4QE6I77kkjKRPj86SzAQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "9e36c772ea13480da2398a2c2bd63fe5",
"datePublished": "2023-10-10T01:00:01+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "AwardCriteria-2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc7c2e1fbe6a49fea049b4173a46deb0?Signature=Ll9xBeKOaMIyV4Pevgb8PUnKFy7IdwbH4qx5dP82%2F1xZyRrLncOjRe9WiUndVv31OgIMb7ENLhVIa0omK%2BNGAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:01+03:00",
"author": "tender_owner",
"language": "uk"
}
}
Uploading additional documents
The same as Uploading documentation.