Payment milestones
Payment information can be specified via tender milestones list of Milestone objects
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",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"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"
}
}
Let’s update 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",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"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
}
}
For multi-lot tenders every Milestone object can be connected to a specific lot
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": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"minimalStep": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 5.0
}
}
],
"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
}
}
Be careful, lot objects cannot be deleted while there are any connected milestones
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"
}
]
}
Field sequenceNumber should be sequence for every lot or generally for tender. If there is incorrect number in this field we will see the error:
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"
}
]
}
]
}
All milestones in tender should have the same logic, they all should be related to lots or all should be related to tender. If milestones have different relation logic, we will see the error:
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"
}
]
}
]
}