Етапи (Умови) оплати
Інформація про оплату може бути зазначена за допомогою поля milestones що містить об’єкти Milestone
Request
POST /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
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/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"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-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T01:00:00+03:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T01:00:00+03:00"
},
"procurementMethodType": "belowThreshold",
"milestones": [
{
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 5,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 7,
"type": "calendar"
},
"sequenceNumber": 1,
"percentage": 54.45
}
],
"contractTemplateName": "00000000.0002.01"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/fc330bfd80e44365b8a127c12bbf9a1a
{
"data": {
"mainProcurementCategory": "goods",
"contractTemplateName": "00000000.0002.01",
"title": "футляри до державних нагород",
"status": "draft",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T01:00:00+03:00",
"endDate": "2023-10-24T01:00:00+03:00"
},
"milestones": [
{
"id": "39aa1d1c9c8f48e8a0fcc405fb1aeb81",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 5,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "c864d56996a0466c96e92283150cc506",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 7,
"type": "calendar"
},
"sequenceNumber": 1
}
],
"procurementMethodType": "belowThreshold",
"enquiryPeriod": {
"endDate": "2023-10-17T01:00:00+03:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-19T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "fc330bfd80e44365b8a127c12bbf9a1a"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false
},
"access": {
"token": "3c1eccac9dc948528b14a5a86a4438ab",
"transfer": "27c6a211b05148aaa7ceda71c081001b"
}
}
Давайте оновимо milestones:
Request
PATCH /api/2.5/tenders/fc330bfd80e44365b8a127c12bbf9a1a?acc_token=3c1eccac9dc948528b14a5a86a4438ab HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"milestones": [
{
"id": "39aa1d1c9c8f48e8a0fcc405fb1aeb81",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 5,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "c864d56996a0466c96e92283150cc506",
"title": "anotherEvent",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 7,
"type": "calendar"
},
"sequenceNumber": 1,
"description": "Підозрілий опис"
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"status": "draft",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T01:00:00+03:00",
"endDate": "2023-10-24T01:00:00+03:00"
},
"milestones": [
{
"id": "39aa1d1c9c8f48e8a0fcc405fb1aeb81",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 5,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "c864d56996a0466c96e92283150cc506",
"title": "anotherEvent",
"description": "Підозрілий опис",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 7,
"type": "calendar"
},
"sequenceNumber": 1
}
],
"procurementMethodType": "belowThreshold",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-19T00:00:00+03:00",
"endDate": "2023-10-17T01:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"id": "fc330bfd80e44365b8a127c12bbf9a1a"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Для мультилотових тендерів кожен об’єкт Milestone може відноситись до конретного лоту
Request
PATCH /api/2.5/tenders/fc330bfd80e44365b8a127c12bbf9a1a?acc_token=3c1eccac9dc948528b14a5a86a4438ab HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"milestones": [
{
"id": "39aa1d1c9c8f48e8a0fcc405fb1aeb81",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 5,
"type": "banking"
},
"sequenceNumber": 0,
"relatedLot": "c6ee20adc9dd4d8ca172d4b91db92240"
},
{
"id": "c864d56996a0466c96e92283150cc506",
"title": "anotherEvent",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 7,
"type": "calendar"
},
"sequenceNumber": 1,
"description": "Підозрілий опис",
"relatedLot": "c6ee20adc9dd4d8ca172d4b91db92240"
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"status": "draft",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T01:00:00+03:00",
"endDate": "2023-10-24T01:00:00+03:00"
},
"lots": [
{
"title": "Лот №1",
"description": "Опис Лот №1",
"status": "active",
"id": "c6ee20adc9dd4d8ca172d4b91db92240",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 5.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"milestones": [
{
"id": "39aa1d1c9c8f48e8a0fcc405fb1aeb81",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 5,
"type": "banking"
},
"sequenceNumber": 0,
"relatedLot": "c6ee20adc9dd4d8ca172d4b91db92240"
},
{
"id": "c864d56996a0466c96e92283150cc506",
"title": "anotherEvent",
"description": "Підозрілий опис",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 7,
"type": "calendar"
},
"sequenceNumber": 1,
"relatedLot": "c6ee20adc9dd4d8ca172d4b91db92240"
}
],
"procurementMethodType": "belowThreshold",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-19T00:00:00+03:00",
"endDate": "2023-10-17T01:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"id": "fc330bfd80e44365b8a127c12bbf9a1a"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Будте обачні, об’єкт lot не може бути видалено, якщо в нього вказані етапи оплати
Request
DELETE /api/2.5/tenders/fc330bfd80e44365b8a127c12bbf9a1a/lots/c6ee20adc9dd4d8ca172d4b91db92240?acc_token=3c1eccac9dc948528b14a5a86a4438ab HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Cannot delete lot with related milestones"
}
]
}
Поле sequenceNumber має бути послідовним від 1 до n, без пропусків і дублів для кожного лоту окремо або загалом для тендеру. Якщо вказано неправильне значення, то буде помилка:
Request
PATCH /api/2.5/tenders/fc330bfd80e44365b8a127c12bbf9a1a?acc_token=3c1eccac9dc948528b14a5a86a4438ab HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"milestones": [
{
"id": "39aa1d1c9c8f48e8a0fcc405fb1aeb81",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 5,
"type": "banking"
},
"sequenceNumber": 0,
"relatedLot": "c6ee20adc9dd4d8ca172d4b91db92240"
},
{
"id": "c864d56996a0466c96e92283150cc506",
"title": "anotherEvent",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 7,
"type": "calendar"
},
"sequenceNumber": 3,
"description": "Підозрілий опис",
"relatedLot": "c6ee20adc9dd4d8ca172d4b91db92240"
}
]
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "milestones",
"description": [
{
"sequenceNumber": "Field should contain incrementing sequence numbers starting from 1 for tender/lot separately"
}
]
}
]
}
Всі майлстоуни в закупівлі повинні мати однакову логіку, вони всі мають посилатися на лот або всі мають посилатися на тендер. Якщо майлстоуни мають різну логіку посилання, то буде помилка:
Request
PATCH /api/2.5/tenders/fc330bfd80e44365b8a127c12bbf9a1a?acc_token=3c1eccac9dc948528b14a5a86a4438ab HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"milestones": [
{
"id": "39aa1d1c9c8f48e8a0fcc405fb1aeb81",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 5,
"type": "banking"
},
"sequenceNumber": 1,
"relatedLot": "c6ee20adc9dd4d8ca172d4b91db92240"
},
{
"id": "c864d56996a0466c96e92283150cc506",
"title": "anotherEvent",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 7,
"type": "calendar"
},
"sequenceNumber": 2,
"description": "Підозрілий опис"
}
]
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "milestones",
"description": [
{
"relatedLot": "Related lot must be set in all milestones or all milestones should be related to tender"
}
]
}
]
}