Приклад для закупівлі¶
Зміна власника закупівлі¶
Переглянемо приклад зміни власника для закупівлі.
Створення закупівлі¶
Спочатку створимо закупівлю:
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
}
}
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 є поточним власником owner
закупівлі.
Зверніть увагу, що секція відповіді access містить ключ transfer
, який використовується для зміни власника закупівлі.
Після реєстрація закупівлі в ЦБД майданчик повинен довести ключ transfer
до відома клієнта.
Ініціація зміни власника¶
Майданчик, що стане новим власником закупівлі, повинен створити об’єкт Transfer.
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": {}
}
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 містить новий ключ доступу token
та новий ключ transfer
для об’єкта, власник якого буде змінений.
Об’єкт Transfer можна переглянути за допомогою ідентифікатора id:
GET /api/2.5/transfers/e1f545dc62744379af62821162c43008 HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-01-01T00:00:00+02:00",
"id": "e1f545dc62744379af62821162c43008"
}
}
Зміна власника закупівлі¶
Можливість зміни власника закупівлі залежить від статусу закупівлі:
Дозволено | Не дозволено |
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 |
Щоб змінити власника закупівлі новий майданчик повинен надіслати POST запит на відповідний /tenders/id/ з секцією data, що міститиме ідентифікатор id
для Transfer та ключ transfer
отриманий від клієнта:
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"
}
}
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
}
}
Оновлене значення властивості owner
вказує, що власник був успішно змінений.
Зверніть увагу, що новий майданчик повинен довести до відома клієнта новий ключ transfer
(згенерований в об’єкті Transfer).
Після того, як об’єкт Transfer було застосовано, для нього генерується властивість usedFor
(вказується шлях до об’єкта, власника якого було змінено):
GET /api/2.5/transfers/e1f545dc62744379af62821162c43008 HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"date": "2023-01-01T00:00:00+02:00",
"usedFor": "/tenders/8d381bc0bece4cccb42d5b415bc7fec8",
"id": "e1f545dc62744379af62821162c43008"
}
}
„Використаний“ об’єкт Transfer вже не можна застосувати до іншого об’єкта.
Спробуємо змінити закупівлю за допомогою ключа token
, отриманого при створенні об’єкта Transfer.
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"
}
}
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
}
}
Зверніть увагу, що тільки майданчик з відповідним рівнем акредитації може стати новим власником. В іншому випадку майданчику така дія буде заборонена.
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"
}
}
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"
}
]
}
Зміна власника дозволена тільки якщо поточний власник тендера має спеціальний рівень акредетації, що дозволяє зміну:
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"
}
}
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"
}
]
}