Tutorial¶
Exploring basic rules¶
Let’s try exploring the /contracts endpoint:
Request
GET /api/2.5/contracts HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-09-01T01:00:00+03:00",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
],
"next_page": {
"offset": 1693519200.0,
"path": "/api/2.5/contracts?offset=1693519200.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=1693519200.0"
}
}
Just invoking it reveals an empty set.
Contract is transferred from the tender system by an automated process.
Creating contract¶
Let’s say that we have conducted tender with award. When the award is activated, a contract is automatically created in the tender (with a limited set of fields) and in the contracting module with a full set of fields(EContract) in pending status.
Brokers (eMalls) can’t create contracts in the contract system.
Getting contract¶
Contract in the tender system
Request
GET /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/contracts/0df8cf97d5cb4ba98a7355f981e0afd2 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0df8cf97d5cb4ba98a7355f981e0afd2",
"status": "pending",
"awardID": "c220713cbd024586b6382ef97a852dc7",
"date": "2023-09-01T01:00:00+03:00"
}
}
Contract id is the same in both tender and contract system.
Let’s access the URL of the created object:
Request
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"owner": "broker",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"contractTemplateUri": "templates/contracts/test.html",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"bid_owner": "broker",
"status": "pending",
"dateCreated": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Getting access¶
WARNING:
Now that method is deprecated(later it will be deleted), you can use for all contract operation tender_token.
In order to get rights for future contract editing, you need to use this view PATCH: /contracts/{id}/credentials?acc_token={tender_token} with the API key of the eMall (broker), where tender was generated.
In the PATCH: /contracts/{id}/credentials?acc_token={tender_token}:
idstands for contract id,tender_tokenis tender’s token (is used for contract token generation).
Response will contain access.token for the contract that can be used for further contract modification.
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/credentials?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 0
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2024-08-31T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
},
"access": {
"token": "84ff84eadc46497bbc8eae97c3dacdf0",
"transfer": "17dc1fcad66b41d5882c4699f481a977"
}
}
Let’s view contracts.
Request
GET /api/2.5/contracts HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-09-01T01:00:00+03:00",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
],
"next_page": {
"offset": 1693519200.0,
"path": "/api/2.5/contracts?offset=1693519200.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=1693519200.0"
}
}
We do see the internal id of a contract (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/contracts/) and its dateModified datestamp.
Modifying pending contract¶
Setting contract value¶
By default contract value is set based on the award, but there is a possibility to set custom contract value.
If you want to lower contract value, you can insert new one into the amount field.
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 238,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
200 OK response was returned. The value was modified successfully.
Setting value per item’s unit¶
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1364
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
200 OK response was returned with successfully set item.unit.value structure.
Item.unit.value.currency and Item.unit.value.valueAddedTaxIncluded are created using contract.value(if exists), otherwise using tender.value data
Setting contract signature date¶
There is a possibility to set custom contract signature date. You can insert appropriate date into the dateSigned field.
If this date is not set, it will be auto-generated on the date of contract registration.
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"dateSigned": "2023-09-01T01:00:00+03:00"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"dateSigned": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Setting contract validity period¶
Setting contract validity period is optional, but if it is needed, you can set appropriate startDate and endDate.
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2024-08-31T01:00:00+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2024-08-31T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Uploading contract documentation¶
Contract documents can be uploaded only up until conclusion of the agreement. Let’s add contract document:
Request
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 340
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_first_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=fcU8fQotbTE1nxHUmBfCgrwjfNjcDiJJA89ynym%2FRoye5cKevbbMvWzJadlyW1KJlrIEimpkzWeEDVhj85zUBA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
201 Created response code and Location header confirm that document has been added.
Let’s see the list of contract documents:
Request
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
]
}
We can add another contract document:
Request
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 351
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_second_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=y%2Bc%2FV%2BSIqnf36NvLLrimQyaWUtCCEZEgtEl%2FsALE5XH5bqEoXwnwNhAkhsKg1JfVY9%2BEwvXxHKhaD5p%2BZBhCBw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=x6tzZwzV4d5DGLeiqvD%2Bm0EdAUGgzUmYnoQ4AjImnxjQRU49JnE3aq50UHtPUVvIRfF5JSrLqmyF3tssHOT%2BCA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
201 Created response code and Location header confirm second document has been added.
Let’s see the list of all uploaded contract documents:
Request
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=x6tzZwzV4d5DGLeiqvD%2Bm0EdAUGgzUmYnoQ4AjImnxjQRU49JnE3aq50UHtPUVvIRfF5JSrLqmyF3tssHOT%2BCA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
]
}
Cancelling contract¶
There are two ways for cancelling contract:
- PATCH award status from active to cancelled
- PATCH contract status from “pending” to “cancelled” (this can only work if this contract is not the last active contract)
Cancelling from award¶
All you need, it’s just patch award status to cancelled
Request
PATCH /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/awards/c220713cbd024586b6382ef97a852dc7?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/awards/a3771b096c9644c5ba09fe6f9c9cb091
{
"data": {
"id": "c220713cbd024586b6382ef97a852dc7",
"status": "cancelled",
"date": "2023-09-01T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "5324d8e7db1c4a3baf5456140f128229"
}
}
Tender contract automatically turned to cancelled
Request
GET /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b/contracts/0df8cf97d5cb4ba98a7355f981e0afd2 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "0df8cf97d5cb4ba98a7355f981e0afd2",
"status": "cancelled",
"awardID": "c220713cbd024586b6382ef97a852dc7",
"date": "2023-09-01T01:00:00+03:00"
}
}
Contract in contracting also automatically turned to cancelled
Request
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2024-08-31T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "cancelled",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"id": "0042d18dfb254f4a8a0c166f1e980196",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"id": "9202cd64da8f42a5942c68dc14bf534a",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"date": "2023-09-01T01:00:00+03:00",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Cancelling from contract¶
If you try to patch last contract in pending to cancelled you’ll get error:
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Can't update contract status"
}
]
}
Activating contract¶
For activating contract, at first buyer and supplier should fill signer information. If you try activate contract without that information you’ll get error:
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "signerInfo field for buyer and suppliers is required for contract in `active` status"
}
]
}
Buyer fill signer information using contract_token or tender_token:
Request
PUT /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/buyer/signer_info?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 354
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
Supplier fill signer information using bid_token:
Request
PUT /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/suppliers/signer_info?acc_token=31267088715c49d384894418a74fb4b6 HTTP/1.0
Authorization: Bearer broker
Content-Length: 354
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
After that actions you can activate contract:
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2024-08-31T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"date": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
After activating contract, tender contract automatically switch to active and tender to complete:
Request
GET /api/2.5/tenders/26fe592e6eb4454fb91865f39117fe4b HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"mainProcurementCategory": "goods",
"title": "Комп’ютерне обладнання",
"procurementMethodDetails": "quick, accelerator=1440",
"procurementMethodType": "priceQuotation",
"procurementMethod": "selective",
"awardCriteria": "lowestCost",
"status": "complete",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 2500,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"endDate": "2023-09-01T00:59:00+03:00",
"startDate": "2023-09-01T00:50:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"kind": "general"
},
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"profile": "655360-30230000-889652-40000777"
}
],
"criteria": [
{
"id": "e232a0b37a0041cdb58916e9550102c8",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "f23eb66e67f74ead9d79edc0b42e71c0",
"description": "Форма випуску",
"requirements": [
{
"id": "e6f9be7a505143948d92a687c03d24b5",
"title": "Форма випуску",
"dataType": "string",
"expectedValue": "Розчин для інфузій"
}
]
}
]
},
{
"id": "58e197cbf866429196799d8e290a783c",
"title": "Доза діючої речовини",
"description": "Доза діючої речовини",
"requirementGroups": [
{
"id": "f5c97b40f7914db1975cfe728ebd0ca4",
"description": "Доза діючої речовини",
"requirements": [
{
"id": "d8cce89c0dcb4748828ccf2a141554bb",
"title": "Доза діючої речовини",
"dataType": "integer",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5
}
]
}
]
},
{
"id": "108107e8f8a04ed8884e899d96007806",
"title": "Форма випуску",
"description": "Форма випуску",
"requirementGroups": [
{
"id": "dc1f3f74ad8146fd9703b7582e3de385",
"description": "Форма випуску",
"requirements": [
{
"id": "f9d6ad9094d746ffb048ec5d42fb4f9e",
"title": "Форма випуску",
"dataType": "string",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 2,
"expectedMaxItems": 3
}
]
}
]
}
],
"contractTemplateUri": "templates/contracts/test.html",
"tenderID": "UA-2023-09-01-000001-a",
"owner": "broker",
"date": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"shortlistedFirms": [
{
"address": {
"countryName": "Україна",
"locality": "м.Київ",
"postalCode": "01100",
"region": "Київська область",
"streetAddress": "бул.Дружби Народів, 8"
},
"contactPoint": {
"email": "contact@pixel.pix",
"name": "Оксана Піксель",
"telephone": "+0671234567"
},
"id": "UA-EDR-12345678",
"identifier": {
"id": "00037256",
"legalName": "Товариство з обмеженою відповідальністю «Пікселі»",
"scheme": "UA-EDR"
},
"name": "Товариство з обмеженою відповідальністю «Пікселі»",
"scale": "large",
"status": "active"
},
{
"address": {
"countryName": "Україна",
"locality": "м.Тернопіль",
"postalCode": "46000",
"region": "Тернопільська область",
"streetAddress": "вул. Кластерна, 777-К"
},
"contactPoint": {
"email": "info@shteker.pek",
"name": "Олег Штекер",
"telephone": "+0951234567"
},
"id": "UA-EDR-87654321",
"identifier": {
"id": "87654321",
"legalName": "Товариство з обмеженою відповідальністю «Штекер-Пекер»",
"scheme": "UA-EDR"
},
"name": "Товариство з обмеженою відповідальністю «Штекер-Пекер»",
"scale": "large",
"status": "active"
}
],
"auctionPeriod": {
"startDate": "2023-09-11T01:00:00+03:00"
},
"bids": [
{
"id": "5324d8e7db1c4a3baf5456140f128229",
"date": "2023-09-01T01:00:00+03:00",
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"id": "585ff3cc25684deba52def8cbabef863",
"requirement": {
"id": "e6f9be7a505143948d92a687c03d24b5"
},
"value": "Розчин для інфузій"
},
{
"id": "3a792c49a8cd4188aee2e87af1b8f25d",
"requirement": {
"id": "d8cce89c0dcb4748828ccf2a141554bb"
},
"value": 5
},
{
"id": "315577b4a97c46b5836595e9dafb424a",
"requirement": {
"id": "f9d6ad9094d746ffb048ec5d42fb4f9e"
},
"values": [
"Відповідь1",
"Відповідь2"
]
}
],
"status": "active"
}
],
"awardPeriod": {
"startDate": "2023-09-01T01:00:00+03:00"
},
"awards": [
{
"id": "c220713cbd024586b6382ef97a852dc7",
"status": "active",
"date": "2023-09-01T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "5324d8e7db1c4a3baf5456140f128229"
},
{
"id": "a3771b096c9644c5ba09fe6f9c9cb091",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+0440000000",
"name": "Державне управління справами"
},
"scale": "micro"
}
],
"bid_id": "5324d8e7db1c4a3baf5456140f128229"
}
],
"contracts": [
{
"id": "0df8cf97d5cb4ba98a7355f981e0afd2",
"status": "active",
"awardID": "c220713cbd024586b6382ef97a852dc7",
"date": "2023-09-01T01:00:00+03:00"
}
],
"id": "26fe592e6eb4454fb91865f39117fe4b"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1
}
}
Modifying active contract¶
You can make changes to the contract in cases described in the 4th part of Article 36 of the Law “On the Public Procurement”.
Essential contract terms can be modified by the submission of a new Change object to the Contract.changes container.
All changes are processed by the endpoint /contracts/{id}/changes.
Submitting a change¶
Let’s add new change to the contract:
Request
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/changes?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 267
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
]
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
{
"data": {
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00"
}
}
Note that you can provide more than one value in rationaleTypes field.
You can view the change:
Request
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/changes/b9887678ba3c448b977467c0fe3ada31 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Опис причини змін контракту",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00"
}
}
Change can be modified while it is in the pending status:
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/changes/b9887678ba3c448b977467c0fe3ada31?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 255
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00"
}
}
Uploading change document¶
Document can be added only while change is in the pending status.
Document has to be added in two stages:
- you should upload document
Request
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 333
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_changes.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=mFBbg4SYLP%2BQk4Cn6xwFtFp2XKpLLLIQmIqKvBsiciOF6nuiH7Gw9Wmk0IsPpNVvMLNn21PDO0c5XMfjxxX5Dw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=cG1JU%2F1r%2B2jlQbXxJsq3HCYzzTi9mderkkqPwomMk34J6oAJ%2B7GRNC3kUgPO3zskbNjKkMkhiaJY2PmkUlOkBA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
- you should set document properties
"documentOf": "change"and"relatedItem": "{change.id}"in order to bind the uploaded document to the change:
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 85
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentOf": "change",
"relatedItem": "b9887678ba3c448b977467c0fe3ada31"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=cG1JU%2F1r%2B2jlQbXxJsq3HCYzzTi9mderkkqPwomMk34J6oAJ%2B7GRNC3kUgPO3zskbNjKkMkhiaJY2PmkUlOkBA%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
Updating contract properties¶
Now you can update contract properties which belong to the change.
You can update value amount and amountNet following next rules:
| valueAddedTaxIncluded | Validation |
| true | Amount should be greater than amountNet and differ by no more than 20% |
| false | Amount and amountNet should be equal |
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 148
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 438,
"amountNet": 430
},
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2023-10-01T01:00:00+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2023-10-01T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"date": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 5.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
We see the added properties have merged with existing contract data. Additionally, the dateModified property was updated to reflect the last modification datestamp.
Fields that can be modified: title, description, status, value.amount, value.amountNet, period, items, amountPaid.amount, amountPaid.amountNet, terminationDetails.
See examples of items customization below. You can:
- update item:
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1363
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 2,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2023-10-01T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"date": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "pending",
"date": "2023-09-01T01:00:00+03:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Applying the change¶
Change can be applied by switching to the active status.
In order to apply active status dateSigned field must be set.
After this change can’t be modified anymore.
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/changes/b9887678ba3c448b977467c0fe3ada31?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 73
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"dateSigned": "2023-09-01T01:00:00+03:00"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-09-01T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-09-01T01:00:00+03:00"
}
}
dateSigned field validation:
- for the first contract change date should be after contract.dateSigned;
- for all next change objects date should be after the previous change.dateSigned.
You can view all changes:
Request
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/changes HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-09-01T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-09-01T01:00:00+03:00"
}
]
}
All changes are also listed on the contract view.
Request
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2023-10-01T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"date": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-09-01T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-09-01T01:00:00+03:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"status": "active",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Uploading documentation¶
Procuring entity can upload PDF files into the created contract. Uploading should follow the Documents Uploading rules.
Request
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 324
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc4cd1ee0c1d481d806feb638548e63b?Signature=bnjqiaGHrMcDhc5nxcKQAB7BmArrmXPmJQhahGGze6DVP39jk4gkNyTnhDnnDVbZFeTaNvrNF2rZGp%2Bx%2BBoLDg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/93f808adc3a84ee9b750119a797ed776
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc4cd1ee0c1d481d806feb638548e63b?Signature=C4ypZjunX6e74XGpYj6RLaNEEy%2BfU2mJomhLN9kphQzrRlcRhDIasEB3GcRqbctnAHP%2FjeTcdCVvVOzP2N4zCg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "93f808adc3a84ee9b750119a797ed776",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
201 Created response code and Location header confirm document creation. We can additionally query the documents collection API endpoint to confirm the action:
Request
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351f09369034d459a5cd87583381c73?Signature=8p9mN2f1Dk06z3oLNH%2B1MUf0ZjBtPhTeaYQfDngeDioPs8%2FVYtElp3rMQf3U294OjDnOC1E1VOuG5dbqcydmAA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1ea9c5fa82c84b2a8206318bc86360df?Signature=x6tzZwzV4d5DGLeiqvD%2Bm0EdAUGgzUmYnoQ4AjImnxjQRU49JnE3aq50UHtPUVvIRfF5JSrLqmyF3tssHOT%2BCA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/34862599de094db7a8c9c37996ea4847?Signature=cG1JU%2F1r%2B2jlQbXxJsq3HCYzzTi9mderkkqPwomMk34J6oAJ%2B7GRNC3kUgPO3zskbNjKkMkhiaJY2PmkUlOkBA%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cc4cd1ee0c1d481d806feb638548e63b?Signature=C4ypZjunX6e74XGpYj6RLaNEEy%2BfU2mJomhLN9kphQzrRlcRhDIasEB3GcRqbctnAHP%2FjeTcdCVvVOzP2N4zCg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "93f808adc3a84ee9b750119a797ed776",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
]
}
And again we can confirm that there are two documents uploaded.
Request
POST /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 342
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_additional_docs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/277f219d159f45e1a11923c8b637d463?Signature=VgL3ykVviPI8bAuDmSwq5ViKMXnEfl0hg3JoFdsMGGWxqX9OMdhV6O2XqEatVTRggQhpT1%2BM%2BTWfKpl6%2BrdPBw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/e3a0c2f53a544b8f8f300200e400f460
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/277f219d159f45e1a11923c8b637d463?Signature=EnWBAbSpO74ppQPPbWr9QNTYM%2Fyee5mRc0iwX3fdwZkdZhmNY0oLP6uLF4v9XyU4ouyIjcTdltumSlUyu4%2B4Bg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "e3a0c2f53a544b8f8f300200e400f460",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
In case we made an error, we can reupload the document over the older version:
Request
PUT /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/e3a0c2f53a544b8f8f300200e400f460?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 336
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_additional_docs.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c2fbdf60afd54cf3acdc89af698f87d2?Signature=juo4JvJjP1B3TgmfhUaFNRnKeufTb15Tcc6ecSZ1DYPMGLeG8hfQbgo2h1bRygiwiWmepBWtvuz5z5GqC7bTAw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c2fbdf60afd54cf3acdc89af698f87d2?Signature=kkWFx7aNWwgD%2F3KSmjbnzA%2BYzH4PvTJL1XRiDauwDPCQRsMHTfnUXxTygRpeggxjBENLuks5YIdiYyxxv6yBDg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
}
And we can see that it is overriding the original version:
Request
GET /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/e3a0c2f53a544b8f8f300200e400f460?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/c2fbdf60afd54cf3acdc89af698f87d2?Signature=kkWFx7aNWwgD%2F3KSmjbnzA%2BYzH4PvTJL1XRiDauwDPCQRsMHTfnUXxTygRpeggxjBENLuks5YIdiYyxxv6yBDg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"previousVersions": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/277f219d159f45e1a11923c8b637d463?Signature=EnWBAbSpO74ppQPPbWr9QNTYM%2Fyee5mRc0iwX3fdwZkdZhmNY0oLP6uLF4v9XyU4ouyIjcTdltumSlUyu4%2B4Bg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "e3a0c2f53a544b8f8f300200e400f460",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
]
}
}
Completing contract¶
Before contract can be completed amountPaid field value should be set (regardless whether the contract was successful or unsuccessful).
Contract can be completed by switching to terminated status.
Let’s perform these actions in single request:
Request
PATCH /api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2?acc_token=1981a3b3a85d4159aabe55f5be082fd5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 114
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "terminated",
"amountPaid": {
"amount": 430,
"amountNet": 420,
"valueAddedTaxIncluded": true
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "c220713cbd024586b6382ef97a852dc7",
"contractID": "UA-2023-09-01-000001-a-1",
"period": {
"startDate": "2023-09-01T01:00:00+03:00",
"endDate": "2023-10-01T01:00:00+03:00"
},
"dateSigned": "2023-09-01T01:00:00+03:00",
"date": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00",
"dateCreated": "2023-09-01T01:00:00+03:00",
"tender_id": "26fe592e6eb4454fb91865f39117fe4b",
"owner": "broker",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-09-01T01:00:00+03:00",
"id": "b9887678ba3c448b977467c0fe3ada31",
"status": "active",
"date": "2023-08-31T22:00:00"
}
],
"documents": [
{
"id": "0042d18dfb254f4a8a0c166f1e980196",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/0042d18dfb254f4a8a0c166f1e980196?download=d351f09369034d459a5cd87583381c73",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "9202cd64da8f42a5942c68dc14bf534a",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/9202cd64da8f42a5942c68dc14bf534a?download=1ea9c5fa82c84b2a8206318bc86360df",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"relatedItem": "b9887678ba3c448b977467c0fe3ada31",
"id": "32ec55c6c6144f7a8fceea1ed68a5290",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/32ec55c6c6144f7a8fceea1ed68a5290?download=34862599de094db7a8c9c37996ea4847",
"documentOf": "change",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "93f808adc3a84ee9b750119a797ed776",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/93f808adc3a84ee9b750119a797ed776?download=cc4cd1ee0c1d481d806feb638548e63b",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/e3a0c2f53a544b8f8f300200e400f460?download=277f219d159f45e1a11923c8b637d463",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
},
{
"id": "e3a0c2f53a544b8f8f300200e400f460",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/0df8cf97d5cb4ba98a7355f981e0afd2/documents/e3a0c2f53a544b8f8f300200e400f460?download=c2fbdf60afd54cf3acdc89af698f87d2",
"documentOf": "contract",
"datePublished": "2023-09-01T01:00:00+03:00",
"dateModified": "2023-09-01T01:00:00+03:00"
}
],
"amountPaid": {
"amount": 430.0,
"currency": "UAH",
"amountNet": 420.0,
"valueAddedTaxIncluded": true
},
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"status": "terminated",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"basisOf": "Статут компанії",
"position": "Генеральний директор"
}
}
],
"items": [
{
"id": "c6c6e8ed4b1542e4bf13d3f98ec5ab59",
"description": "футляри до державних нагород",
"quantity": 2.0,
"deliveryDate": {
"startDate": "2016-03-20T18:47:47.136678+02:00",
"endDate": "2016-03-23T18:47:47.136678+02:00"
},
"classification": {
"description": "Комп’ютерне обладнанн",
"scheme": "ДК021",
"id": "30230000-0"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "штук",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "H87"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"contractTemplateUri": "templates/contracts/test.html",
"bid_owner": "broker",
"id": "0df8cf97d5cb4ba98a7355f981e0afd2"
}
}
Note that you can set/change amountPaid.amount, amountPaid.amountNet, amountPaid.valueAddedTaxIncluded values. amountPaid.currency field value is generated from Contract.value field.
If contract is unsuccessful reasons for termination terminationDetails should be specified.
Any future modification to the contract are not allowed.