Example for Tender¶
Tender ownership change¶
Let’s view transfer example for tender.
Tender creation¶
At first let’s create a tender:
Request
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 4251
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"value": {
"amount": 500,
"currency": "UAH"
},
"minimalStep": {
"amount": 15,
"currency": "UAH"
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
}
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
}
}
],
"enquiryPeriod": {
"endDate": "2023-01-08T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-01-15T00:00:00+02:00"
},
"procurementMethodType": "belowThreshold",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/8d381bc0bece4cccb42d5b415bc7fec8
{
"data": {
"mainProcurementCategory": "goods",
"title": "футляри до державних нагород",
"status": "draft",
"procurementMethod": "open",
"awardCriteria": "lowestCost",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-01-08T00:00:00+02:00",
"endDate": "2023-01-15T00:00:00+02:00"
},
"items": [
{
"id": "58e7e07a6b6f4ba784c525f0dc76f195",
"description": "футляри до державних нагород",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "e349a32ccde84b8186a9f58cf14aae60",
"description": "футляри до державних нагород",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "f62b46ce98424cd8a038a68d55904815",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procurementMethodType": "belowThreshold",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"kind": "general"
},
"enquiryPeriod": {
"endDate": "2023-01-08T00:00:00+02:00",
"startDate": "2023-01-01T00:00:00+02:00",
"clarificationsUntil": "2023-01-09T00:00:00+02:00"
},
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"submissionMethod": "electronicAuction",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"id": "8d381bc0bece4cccb42d5b415bc7fec8"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
},
"access": {
"token": "38d83099eb3847f3ac1094c10d6d0a71",
"transfer": "4927ec57876f42529e73b0c81a89e457"
}
}
broker is current tender’s owner.
Note that response’s access section contains a transfer key which is used to change tender ownership.
After tender’s registration in CDB broker has to provide its customer with transfer key.
Transfer creation¶
Broker that is going to become new tender owner should create a Transfer.
Request
POST /api/2.5/transfers HTTP/1.0
Authorization: Bearer broker1
Content-Length: 12
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"date": "2023-01-01T00:00:00+02:00",
"id": "e1f545dc62744379af62821162c43008"
},
"access": {
"token": "4696e849bf0b47eeaebd2d632abcecd4",
"transfer": "6b37d20e97844361969a510909ed60c5"
}
}
Transfer object contains new access token and new transfer token for the object that will be transferred to new broker.
Transfer can be retrieved by id:
Request
GET /api/2.5/transfers/e1f545dc62744379af62821162c43008 HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-01-01T00:00:00+02:00",
"id": "e1f545dc62744379af62821162c43008"
}
}
Changing tender’s owner¶
An ability to change tender’s ownership depends on tender’s status:
| Allowed | Not Alowwed |
| belowThreshold | |
active.enquiries active.tendering active.auction active.qualification active.awarded |
complete cancelled unsuccessful |
| aboveThresholdUA | |
active.tendering active.auction active.qualification active.awarded |
complete cancelled unsuccessful |
| aboveThresholdEU | |
active.tendering active.pre-qualification active.pre-qualification.stand-still active.auction active.qualification active.awarded |
complete cancelled unsuccessful |
| aboveThresholdUA.defense | |
active.tendering active.auction active.qualification active.awarded |
complete cancelled unsuccessful |
| competitiveDialogueUA | |
active.tendering active.pre-qualification active.pre-qualification.stand-still active.stage2.pending |
active.stage2.waiting complete unsuccessful cancelled |
| competitiveDialogueUA.stage2 | |
draft.stage2 active.tendering active.auction active.qualification active.awarded |
complete unsuccessful cancelled |
| competitiveDialogueEU | |
active.tendering active.pre-qualification active.pre-qualification.stand-still active.stage2.pending |
active.stage2.waiting complete unsuccessful cancelled |
| competitiveDialogueEU.stage2 | |
draft.stage2 active.tendering active.pre-qualification active.pre-qualification.stand-still active.auction active.qualification active.awarded |
complete unsuccessful cancelled |
| esco | |
active.tendering active.pre-qualification active.pre-qualification.stand-still active.auction active.qualification active.awarded |
complete unsuccessful cancelled |
| closeFrameworkAgreementUA | |
active.tendering active.pre-qualification active.pre-qualification.stand-still active.auction active.qualification active.qualification.stand-still active.awarded |
complete unsuccessful cancelled |
| closeFrameworkAgreementSelectionUA | |
draftactive.enquiries active.tendering active.auction active.qualification active.awarded |
draft.pending draft.unsuccessful complete unsuccessful cancelled |
| reporting | |
| active | complete cancelled |
| negotiation | |
| active | complete cancelled |
| negotiation.quick | |
| active | complete |
To change tender’s ownership new broker should send POST request to appropriate /tenders/id/ with data section containing id of Transfer and transfer token received from customer:
Request
POST /api/2.5/tenders/8d381bc0bece4cccb42d5b415bc7fec8/ownership HTTP/1.0
Authorization: Bearer broker1
Content-Length: 100
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"id": "e1f545dc62744379af62821162c43008",
"transfer": "4927ec57876f42529e73b0c81a89e457"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title": "футляри до державних нагород",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker1",
"mainProcurementCategory": "goods",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "f62b46ce98424cd8a038a68d55904815",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procurementMethod": "open",
"awardCriteria": "lowestCost",
"submissionMethod": "electronicAuction",
"status": "draft",
"items": [
{
"id": "58e7e07a6b6f4ba784c525f0dc76f195",
"description": "футляри до державних нагород",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
},
{
"id": "e349a32ccde84b8186a9f58cf14aae60",
"description": "футляри до державних нагород",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
}
],
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"enquiryPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-08T00:00:00+02:00",
"clarificationsUntil": "2023-01-09T00:00:00+02:00"
},
"tenderPeriod": {
"startDate": "2023-01-08T00:00:00+02:00",
"endDate": "2023-01-15T00:00:00+02:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general"
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"procurementMethodType": "belowThreshold",
"id": "8d381bc0bece4cccb42d5b415bc7fec8",
"numberOfBids": 0
}
}
Updated owner value indicates that ownership is successfully changed.
Note that new broker has to provide its customer with new transfer key (generated in Transfer object).
After Transfer is applied it stores tender path in usedFor property:
Request
GET /api/2.5/transfers/e1f545dc62744379af62821162c43008 HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-01-01T00:00:00+02:00",
"usedFor": "/tenders/8d381bc0bece4cccb42d5b415bc7fec8",
"id": "e1f545dc62744379af62821162c43008"
}
}
‘Used’ Transfer can’t be applied to any other object.
Let’s try to change the tender using token received on Transfer creation:
Request
PATCH /api/2.5/tenders/8d381bc0bece4cccb42d5b415bc7fec8?acc_token=4696e849bf0b47eeaebd2d632abcecd4 HTTP/1.0
Authorization: Bearer broker1
Content-Length: 62
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"description": "broker1 now can change the tender"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"description": "broker1 now can change the tender",
"date": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"tenderID": "UA-2023-01-01-000001-a",
"status": "draft",
"owner": "broker1",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"submissionMethod": "electronicAuction",
"procurementMethod": "open",
"awardCriteria": "lowestCost",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"startDate": "2023-01-08T00:00:00+02:00",
"endDate": "2023-01-15T00:00:00+02:00"
},
"items": [
{
"id": "58e7e07a6b6f4ba784c525f0dc76f195",
"description": "футляри до державних нагород",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "e349a32ccde84b8186a9f58cf14aae60",
"description": "футляри до державних нагород",
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "f62b46ce98424cd8a038a68d55904815",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procurementMethodType": "belowThreshold",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"kind": "general"
},
"enquiryPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"clarificationsUntil": "2023-01-09T00:00:00+02:00",
"endDate": "2023-01-08T00:00:00+02:00"
},
"id": "8d381bc0bece4cccb42d5b415bc7fec8"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
}
}
Pay attention that only broker with appropriate accreditation level can become new owner. Otherwise broker will be forbidden from this action.
Request
POST /api/2.5/tenders/8d381bc0bece4cccb42d5b415bc7fec8/ownership HTTP/1.0
Authorization: Bearer broker2
Content-Length: 100
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"id": "684d7086a86746f8a6f36ce53a7fa4a8",
"transfer": "4927ec57876f42529e73b0c81a89e457"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "url",
"name": "accreditation",
"description": "Broker Accreditation level does not permit ownership change"
}
]
}
Also ownership change is allowed only if current owner has a special accreditation level that allows ownership change:
Request
POST /api/2.5/tenders/8d381bc0bece4cccb42d5b415bc7fec8/ownership HTTP/1.0
Authorization: Bearer broker
Content-Length: 100
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"id": "3046190b1751457bad9b61394701494e",
"transfer": "4927ec57876f42529e73b0c81a89e457"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "url",
"name": "accreditation",
"description": "Owner Accreditation level does not permit ownership change"
}
]
}