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": [],
"next_page": {
"offset": "",
"path": "/api/2.5/contracts",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts"
}
}
Just invoking it reveals an empty set.
Contract is transferred from the tender system by an automated process. The circumstances under which this happens are described below.
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(id, awardID, status, date, value) 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.
A contract is created with additional fields:
contractTemplateName - copied from tender if exists (more about it in Providing contract template)
A PQ contract is created with additional fields:
attributes - formed from requirements and responses in tender
Getting contract
Contract in the tender system
Request
GET /api/2.5/tenders/19e4c71b4b4b4595a5bb125c6c5e2df7/contracts/78fd8d7877d74b0dbc9c605462545e1c 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": "78fd8d7877d74b0dbc9c605462545e1c",
"status": "pending",
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
}
}
}
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/78fd8d7877d74b0dbc9c605462545e1c HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"contractTemplateName": "00000000.0002.01",
"status": "pending",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
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/78fd8d7877d74b0dbc9c605462545e1c/credentials?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 500.0
},
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"owner": "broker",
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"contractTemplateName": "00000000.0002.01",
"status": "pending",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
},
"access": {
"token": "1344415aa4374b9eae0f2d8d129e5fcf",
"transfer": "99cf2e14d9ed4bf9bbedfcc3a06ab917"
}
}
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-10-10T01:00:00+03:00",
"id": "78fd8d7877d74b0dbc9c605462545e1c"
}
],
"next_page": {
"offset": "1696888800.0.1.f9f768d0faee0847eefffbf52378bea6",
"path": "/api/2.5/contracts?offset=1696888800.0.1.f9f768d0faee0847eefffbf52378bea6",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=1696888800.0.1.f9f768d0faee0847eefffbf52378bea6"
}
}
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
When contract in pending status buyer can update those fields:
title
description
status
items
value
contractNumber
dateSigned
period
implementation
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 or amountNet field(for all procedures except esco).
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
200 OK response was returned. The value was modified successfully.
Setting value per item’s unit
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 12,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
200 OK response was returned with successfully set item.unit.value structure.
Item.unit.value.currency must correspond to the value of contract.value.currency. Item.unit.value.valueAddedTaxIncluded should be False.
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/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"dateSigned": "2023-10-10T01:00:00+03:00"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"dateSigned": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
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/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"dateSigned": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "pending",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Uploading contract documentation
Contract documents can be uploaded only to contract in pending and active statuses. Let’s add contract document:
Request
POST /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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/3ef4769b01194c3fb9b85667d21a1307?Signature=alYGlD2G7te8QYpzmUVDauwxpWBFKMtCRdiesch53QHtduDhE3vUadOwjDo%2BCbbhdWMVsTJ7nXe5%2FAInEk4iAQ%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/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ef4769b01194c3fb9b85667d21a1307?Signature=XNfN9287glUx98JoNYH%2Bne8dovYn47EntsAtHWHxtjFnovk%2FoG3koXt4fR7W6PG9Z24BoGB8Opg9%2Fu3TJN4TAQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01: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/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ef4769b01194c3fb9b85667d21a1307?Signature=XNfN9287glUx98JoNYH%2Bne8dovYn47EntsAtHWHxtjFnovk%2FoG3koXt4fR7W6PG9Z24BoGB8Opg9%2Fu3TJN4TAQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
We can add another contract document:
Request
POST /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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/fc53e793a7ae423e9d0b454a353d6e3e?Signature=QcI4C0zdNzsb8dSegN%2Ft5%2B0w7gpy6wld0nJYy8Co3siTzz2j%2BoPgPjAJjOGfQrB33%2BRToXIb%2F8i1oAY4Tk%2BABA%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/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fc53e793a7ae423e9d0b454a353d6e3e?Signature=pVHG1VDCQuzW7OsW0Qsglecdr1%2FxzfKAxMfnQFFhH7%2B1T%2BlKG9UwLceeVCuywd5Z17w2wYQqFB3fOcyzOaZ0DQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01: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/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ef4769b01194c3fb9b85667d21a1307?Signature=XNfN9287glUx98JoNYH%2Bne8dovYn47EntsAtHWHxtjFnovk%2FoG3koXt4fR7W6PG9Z24BoGB8Opg9%2Fu3TJN4TAQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fc53e793a7ae423e9d0b454a353d6e3e?Signature=pVHG1VDCQuzW7OsW0Qsglecdr1%2FxzfKAxMfnQFFhH7%2B1T%2BlKG9UwLceeVCuywd5Z17w2wYQqFB3fOcyzOaZ0DQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01: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/19e4c71b4b4b4595a5bb125c6c5e2df7/awards/765d1e83c038413ab7717ec5e820fdfd?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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/19e4c71b4b4b4595a5bb125c6c5e2df7/awards/2c31244c27874e13b5e97bdab8a6b7e0
{
"data": {
"id": "765d1e83c038413ab7717ec5e820fdfd",
"status": "cancelled",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"bid_id": "5e818bcf21be4d18a84f29d3c85326f7",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "1c04209a75564f6c9800996eff78af44",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/19490ea9427f4458b9607cd94d20b5e3?Signature=yCoELtqowpqESVTm03OLr9Gm%2B9kkSxZUiUcpD3rkM7e6gsTbJJd0t1YVxjXL3eWFweY%2B0Ocl48YHMi6cJCJPDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"qualified": true
}
}
Tender contract automatically turned to cancelled
Request
GET /api/2.5/tenders/19e4c71b4b4b4595a5bb125c6c5e2df7/contracts/78fd8d7877d74b0dbc9c605462545e1c 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": "78fd8d7877d74b0dbc9c605462545e1c",
"status": "cancelled",
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
}
}
}
Contract in contracting also automatically turned to cancelled
Request
GET /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c 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": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"dateSigned": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "cancelled",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"date": "2023-10-10T01:00:00+03:00",
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
Cancelling from contract
If you try to patch contract in pending to cancelled you’ll get error:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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
If tender has contractTemplateName set (more about it in Providing contract template), it will be used as contractTemplateName for contract. If contractTemplateName is set for contract, signer information is required for activation. Let’s look at tender with contractTemplateName set:
Request
GET /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c 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": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"dateSigned": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 18,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "pending",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"documents": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"date": "2023-10-10T01:00:00+03:00",
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
If you try activate contract without signer information you’ll get error:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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": "contractNumber is required for contract in `active` status"
}
]
}
Buyer fill signer information using contract_token or tender_token:
Request
PUT /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/buyer/signer_info?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
null
Supplier fill signer information using bid_token, for limited procedure that request, make buyer using contract_token or tender_token:
Request
PUT /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/suppliers/signer_info?acc_token=fa9c9d9f37b94e2fa1a6b6c9053b5cdc HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
null
You can update signer information using same method:
Request
PUT /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/buyer/signer_info?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "234234234234234",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
If you try activate contract without required fields (contractNumber, period.startDate, etc.) you’ll get error:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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": "contractNumber is required for contract in `active` status"
}
]
}
After signer information and all required fields added you can activate contract:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"contractNumber": "contract #13111"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract #13111",
"dateSigned": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 18.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2024-10-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"documents": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
After activating contract, tender contract automatically switch to active and tender to complete:
Request
GET /api/2.5/tenders/19e4c71b4b4b4595a5bb125c6c5e2df7 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",
"procurementMethod": "selective",
"contractTemplateName": "00000000.0002.01",
"title": "Комп’ютерне обладнання",
"procurementMethodType": "priceQuotation",
"awardCriteria": "lowestCost",
"status": "complete",
"agreement": {
"id": "2e14a78a2074952d5a2d256c3c004dda"
},
"value": {
"amount": 22000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"tenderPeriod": {
"endDate": "2023-10-09T01:00:00+03:00",
"startDate": "2023-09-30T01:00:00+03:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
},
"kind": "general"
},
"items": [
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
},
{
"profile": "655360-30230000-889652-40000777",
"category": "655360-30230000-889652",
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
}
}
],
"criteria": [
{
"id": "605d6f36cba14950899281036bbcfef1",
"description": "Форма випуску",
"source": "tenderer",
"relatesTo": "item",
"relatedItem": "5b122642e8964f00a1535be1d2b2270a",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
},
"title": "Форма випуску",
"legislation": [
{
"version": "2020-04-19",
"identifier": {
"id": "922-VIII",
"legalName": "Закон України \"Про публічні закупівлі\"",
"uri": "https://zakon.rada.gov.ua/laws/show/922-19"
},
"type": "NATIONAL_LEGISLATION"
}
],
"requirementGroups": [
{
"id": "979cdf512e0b4899ba29043c24949c05",
"description": "Форма випуску",
"requirements": [
{
"id": "bb9de124c05a44f881f07b4ed442ae7c",
"title": "Форма випуску",
"dataType": "string",
"status": "active",
"expectedValues": [
"Розчин для інфузій"
],
"expectedMinItems": 1,
"datePublished": "2023-10-10T01:00:00+03:00"
},
{
"id": "0a66cb3354964fe4a6e1eb5e028f2196",
"title": "Доза діючої речовини",
"dataType": "integer",
"status": "active",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"minValue": 5,
"datePublished": "2023-10-10T01:00:00+03:00"
},
{
"id": "88359f2bf06f4fd9bfa9b8f70bb9b227",
"title": "Форма випуску 1",
"dataType": "string",
"status": "active",
"expectedValues": [
"Відповідь1",
"Відповідь2",
"Відповідь3",
"Відповідь4"
],
"expectedMinItems": 1,
"expectedMaxItems": 3,
"datePublished": "2023-10-10T01:00:00+03:00"
}
]
}
]
}
],
"tenderID": "UA-2023-10-10-000001-a",
"owner": "broker",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"auctionPeriod": {
"startDate": "2023-10-20T01:00:00+03:00"
},
"bids": [
{
"id": "5e818bcf21be4d18a84f29d3c85326f7",
"date": "2023-10-10T01:00:00+03:00",
"tenderers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"requirementResponses": [
{
"requirement": {
"id": "bb9de124c05a44f881f07b4ed442ae7c",
"title": "Форма випуску"
},
"values": [
"Розчин для інфузій"
],
"id": "eb529a29bf9f40afb4cbb6eac3a05909",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "0a66cb3354964fe4a6e1eb5e028f2196",
"title": "Доза діючої речовини"
},
"value": 5,
"id": "9fbee8839d1443ce8c411170f3ff8e64",
"unit": {
"code": "KGM",
"name": "кілограми"
},
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
},
{
"requirement": {
"id": "88359f2bf06f4fd9bfa9b8f70bb9b227",
"title": "Форма випуску 1"
},
"values": [
"Відповідь1",
"Відповідь2"
],
"id": "2057cf7fb70d4373a9ffb2f2b469d640",
"classification": {
"scheme": "ESPD211",
"id": "CRITERION.OTHER.SUBJECT_OF_PROCUREMENT.TECHNICAL_FEATURES"
}
}
],
"status": "active",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"unit": {
"name": "кг",
"value": {
"amount": 40.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 10.0
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 5.0
}
],
"submissionDate": "2023-10-10T01:00:00+03:00",
"initialValue": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"awardPeriod": {
"startDate": "2023-10-10T01:00:00+03:00"
},
"awards": [
{
"id": "765d1e83c038413ab7717ec5e820fdfd",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"bid_id": "5e818bcf21be4d18a84f29d3c85326f7",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "1c04209a75564f6c9800996eff78af44",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/19490ea9427f4458b9607cd94d20b5e3?Signature=yCoELtqowpqESVTm03OLr9Gm%2B9kkSxZUiUcpD3rkM7e6gsTbJJd0t1YVxjXL3eWFweY%2B0Ocl48YHMi6cJCJPDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"qualified": true
},
{
"id": "2c31244c27874e13b5e97bdab8a6b7e0",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"bid_id": "5e818bcf21be4d18a84f29d3c85326f7",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-18T00:00:00+03:00"
}
}
],
"contracts": [
{
"id": "78fd8d7877d74b0dbc9c605462545e1c",
"status": "active",
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
}
}
],
"id": "19e4c71b4b4b4595a5bb125c6c5e2df7"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": true,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 0,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 0,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": false,
"minEnquiriesDuration": 0,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
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/78fd8d7877d74b0dbc9c605462545e1c/changes?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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": "68c208e991674fcfb5853d81817fd6e9",
"status": "pending",
"date": "2023-10-10T01: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/78fd8d7877d74b0dbc9c605462545e1c/changes/68c208e991674fcfb5853d81817fd6e9 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": "68c208e991674fcfb5853d81817fd6e9",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
}
Change can be modified while it is in the pending status:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/changes/68c208e991674fcfb5853d81817fd6e9?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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": "68c208e991674fcfb5853d81817fd6e9",
"status": "pending",
"date": "2023-10-10T01: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/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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/8951da71589746199cc3c8345d51fe37?Signature=JzikcIXL71sjvVRTa1TTU0jFJz8Bk%2BR8C6J4i7rTY6Wxt3eJE6bxsA5Rl98Ilcdc23lfJ5hvw4CboS1OrZdBCQ%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/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8951da71589746199cc3c8345d51fe37?Signature=Eh6fL9ydZXf0LJtuYMxpGuv%2FXHFQXYwZm%2B8DvyXhiFKzbCN6MaGp5L%2B8E8onS82JHdVQMGE0KmXixTr7DS5lBQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01: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/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentOf": "change",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8951da71589746199cc3c8345d51fe37?Signature=Eh6fL9ydZXf0LJtuYMxpGuv%2FXHFQXYwZm%2B8DvyXhiFKzbCN6MaGp5L%2B8E8onS82JHdVQMGE0KmXixTr7DS5lBQ%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01: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% (but Amount and amountNet can be equal) |
false |
Amount and amountNet should be equal |
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 240,
"amountNet": 200
},
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract #13111",
"dateSigned": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 18.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3?download=8951da71589746199cc3c8345d51fe37",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"value": {
"amount": 240.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 200.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
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/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 20,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract #13111",
"dateSigned": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 20.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3?download=8951da71589746199cc3c8345d51fe37",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"value": {
"amount": 240.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 200.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
add new item:
It is allowed to add new items, but the main fields should be the same as in one of previous item in contact.
Fields that can not be changed:
classification
relatedLot
relatedBuyer
additionalClassifications
Let’s try to add new item with new classification and we will see an error:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 20,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
},
{
"description": "Картон ручного виготовлення",
"quantity": 20,
"classification": {
"id": "22992000-0",
"scheme": "ДК021",
"description": "Папір або картон ручного виготовлення"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
}
]
}
}
Response
HTTP/1.0 403 Forbidden
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "Forbidden to add new items main information in contract, all main fields should be the same as in previous items: classification, relatedLot, relatedBuyer, additionalClassifications"
}
]
}
For example, we can split first item into two new items.
But there is still a validation for unit prices of all items:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 20,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
},
{
"description": "Картон ручного виготовлення",
"quantity": 20,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 4.5,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
}
]
}
}
Response
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "items",
"description": "Total amount of unit values must be no more than contract.value.amount and no less than net contract amount"
}
]
}
Let’s update quantity in first item and add new item with correct unit.value:
Request
PATCH /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
},
{
"description": "Картон ручного виготовлення",
"quantity": 20,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 4.5,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract #13111",
"dateSigned": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
},
{
"id": "4a0124d7eb8d4fe3b391a39808b1a2ee",
"description": "Картон ручного виготовлення",
"quantity": 20.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 4.5,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "pending",
"date": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3?download=8951da71589746199cc3c8345d51fe37",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"value": {
"amount": 240.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 200.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
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/78fd8d7877d74b0dbc9c605462545e1c/changes/68c208e991674fcfb5853d81817fd6e9?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"dateSigned": "2023-10-10T01:00:00+03:00"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"dateSigned": "2023-10-10T01: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/78fd8d7877d74b0dbc9c605462545e1c/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"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"dateSigned": "2023-10-10T01:00:00+03:00"
}
]
}
All changes are also listed on the contract view.
Request
GET /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c 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": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract #13111",
"dateSigned": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
},
{
"id": "4a0124d7eb8d4fe3b391a39808b1a2ee",
"description": "Картон ручного виготовлення",
"quantity": 20.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 4.5,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"dateSigned": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3?download=8951da71589746199cc3c8345d51fe37",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"value": {
"amount": 240.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 200.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
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/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d2dfb81496b645a9ad5080512e3c40f4?Signature=hpjTZhVhbq2MrC%2FX6EKUXeWJrFZBNTd5NlN4bZuWSI3KU8z6axhA3l14BxuW8%2FiNK86MwBhaKBzY78XcbZkJBQ%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/78fd8d7877d74b0dbc9c605462545e1c/documents/6a8a54759fce4d3fa3d2bec918423646
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d2dfb81496b645a9ad5080512e3c40f4?Signature=IHNzhEfMRmx22zABcPM6Zp4H1R396AMEglrbLvpoS12nE5caPCSmtg15%2FdPJH%2FM9EZpiVS9BwsAgvvPDKSl7CA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "6a8a54759fce4d3fa3d2bec918423646",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01: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/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/3ef4769b01194c3fb9b85667d21a1307?Signature=XNfN9287glUx98JoNYH%2Bne8dovYn47EntsAtHWHxtjFnovk%2FoG3koXt4fR7W6PG9Z24BoGB8Opg9%2Fu3TJN4TAQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fc53e793a7ae423e9d0b454a353d6e3e?Signature=pVHG1VDCQuzW7OsW0Qsglecdr1%2FxzfKAxMfnQFFhH7%2B1T%2BlKG9UwLceeVCuywd5Z17w2wYQqFB3fOcyzOaZ0DQ%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/8951da71589746199cc3c8345d51fe37?Signature=Eh6fL9ydZXf0LJtuYMxpGuv%2FXHFQXYwZm%2B8DvyXhiFKzbCN6MaGp5L%2B8E8onS82JHdVQMGE0KmXixTr7DS5lBQ%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/d2dfb81496b645a9ad5080512e3c40f4?Signature=IHNzhEfMRmx22zABcPM6Zp4H1R396AMEglrbLvpoS12nE5caPCSmtg15%2FdPJH%2FM9EZpiVS9BwsAgvvPDKSl7CA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "6a8a54759fce4d3fa3d2bec918423646",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
]
}
And again we can confirm that there are two documents uploaded.
Request
POST /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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/ef2fb5872c82422ca7d0ece4f4a3e8ed?Signature=%2BvzOYKZNkTfFJt61jxCUm9XQ0hyi6Of8RquzLHmqHBCcqnV%2BfLntiPcbLQGahp4FDpjaYOYPzt0HOoyWsuj7Cg%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/78fd8d7877d74b0dbc9c605462545e1c/documents/8ebfb8c02bac4da99c4c82a17c10d8f8
{
"data": {
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ef2fb5872c82422ca7d0ece4f4a3e8ed?Signature=I8gJNoDiXD6FQ7BeRWhIrPoEI9fuGvOVZ7TdmhrsxYLNoArvD6V39NiH79jqI0YTHQApHrbvnGq1Z9dYnDHzDA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01: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/78fd8d7877d74b0dbc9c605462545e1c/documents/8ebfb8c02bac4da99c4c82a17c10d8f8?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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/a9311975ab314480acfbb59c2e09b9a8?Signature=TSm%2Fw%2Bzt758HDLOe7W8OXqCY756K%2B5hSYeYBkrQAaNCaO9SX%2Fh3ToWDwvLHOKfPMxJPsOkLWq6Guu116hWtMCg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a9311975ab314480acfbb59c2e09b9a8?Signature=eLLNv1wdCAVGGf7H9Hwp21H7crlhV%2B%2Fq4mOML4yjIThwAfk7XkkajH0O39kI9meZU68FWK6qokxpJAhZxRBCCw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
}
And we can see that it is overriding the original version:
Request
GET /api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/8ebfb8c02bac4da99c4c82a17c10d8f8?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"confidentiality": "public",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a9311975ab314480acfbb59c2e09b9a8?Signature=eLLNv1wdCAVGGf7H9Hwp21H7crlhV%2B%2Fq4mOML4yjIThwAfk7XkkajH0O39kI9meZU68FWK6qokxpJAhZxRBCCw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"previousVersions": [
{
"confidentiality": "public",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/ef2fb5872c82422ca7d0ece4f4a3e8ed?Signature=I8gJNoDiXD6FQ7BeRWhIrPoEI9fuGvOVZ7TdmhrsxYLNoArvD6V39NiH79jqI0YTHQApHrbvnGq1Z9dYnDHzDA%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01: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/78fd8d7877d74b0dbc9c605462545e1c?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "terminated",
"amountPaid": {
"amount": 240,
"amountNet": 200,
"valueAddedTaxIncluded": true
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "765d1e83c038413ab7717ec5e820fdfd",
"contractID": "UA-2023-10-10-000001-a-1",
"contractNumber": "contract #13111",
"dateSigned": "2023-10-10T01:00:00+03:00",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "5b122642e8964f00a1535be1d2b2270a",
"description": "Комп’ютерне обладнання для біда",
"quantity": 10.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 9.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
},
{
"id": "ce44a97bd43a49069c1cb60ef789199e",
"description": "Комп’ютерне обладнання",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
}
},
{
"id": "4a0124d7eb8d4fe3b391a39808b1a2ee",
"description": "Картон ручного виготовлення",
"quantity": 20.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "INN",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 4.5,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"attributes": [
{
"name": "Форма випуску",
"values": [
"Розчин для інфузій"
]
},
{
"name": "Доза діючої речовини",
"unit": {
"name": "кілограми",
"code": "KGM"
},
"value": 5
},
{
"name": "Форма випуску 1",
"values": [
"Відповідь1",
"Відповідь2"
]
}
]
}
],
"tender_id": "19e4c71b4b4b4595a5bb125c6c5e2df7",
"owner": "broker",
"status": "terminated",
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-11-09T01:00:00+03:00"
},
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037257",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "234234234234234",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000-0.0002.01",
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "68c208e991674fcfb5853d81817fd6e9",
"status": "active",
"date": "2023-10-09T22:00:00",
"dateSigned": "2023-10-10T01:00:00+03:00"
}
],
"documents": [
{
"confidentiality": "public",
"id": "b4f19ca568224409866b1f00feaa8cd7",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/b4f19ca568224409866b1f00feaa8cd7?download=3ef4769b01194c3fb9b85667d21a1307",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "f70a81f193c94c91ba26c27b13349e9d",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/f70a81f193c94c91ba26c27b13349e9d?download=fc53e793a7ae423e9d0b454a353d6e3e",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"relatedItem": "68c208e991674fcfb5853d81817fd6e9",
"id": "bd7168ca198e414a8c27f8511d95e9d3",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/bd7168ca198e414a8c27f8511d95e9d3?download=8951da71589746199cc3c8345d51fe37",
"documentOf": "change",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "6a8a54759fce4d3fa3d2bec918423646",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/6a8a54759fce4d3fa3d2bec918423646?download=d2dfb81496b645a9ad5080512e3c40f4",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/8ebfb8c02bac4da99c4c82a17c10d8f8?download=ef2fb5872c82422ca7d0ece4f4a3e8ed",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
},
{
"confidentiality": "public",
"id": "8ebfb8c02bac4da99c4c82a17c10d8f8",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/78fd8d7877d74b0dbc9c605462545e1c/documents/8ebfb8c02bac4da99c4c82a17c10d8f8?download=a9311975ab314480acfbb59c2e09b9a8",
"documentOf": "contract",
"datePublished": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00"
}
],
"amountPaid": {
"amount": 240.0,
"currency": "UAH",
"amountNet": 200.0,
"valueAddedTaxIncluded": true
},
"value": {
"amount": 240.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 200.0
},
"id": "78fd8d7877d74b0dbc9c605462545e1c"
},
"config": {
"restricted": false
}
}
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.
Aggregate contracts
Creation of aggregate contracts
For each buyer object in tender system is creating separate contract respectively when award become active.
Create tender with several buyers, each item should be assigned to related buyer using relatedBuyer field :
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-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"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": [
{
"description": "телевізори",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"relatedBuyer": "11111111111111111111111111111111"
},
{
"description": "портфелі",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"relatedBuyer": "22222222222222222222222222222222"
},
{
"description": "портфелі",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
},
"relatedBuyer": "22222222222222222222222222222222"
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T01:00:00+03:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T01:00:00+03:00"
},
"procurementMethodType": "belowThreshold",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45
}
],
"contractTemplateName": "00000000.0002.01",
"buyers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
},
"id": "11111111111111111111111111111111"
},
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037254",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
},
"id": "22222222222222222222222222222222"
}
]
},
"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/493cc77e367e48e9b931dcc640be6399
{
"data": {
"mainProcurementCategory": "goods",
"buyers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"id": "11111111111111111111111111111111",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037254",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"id": "22222222222222222222222222222222",
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"title": "футляри до державних нагород",
"status": "draft",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"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": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "726b0d1e63f942f69f5c05a55228dffa",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"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": "19cd4e67d5d74d72b02bbe74396528b4",
"description": "телевізори",
"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"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "11111111111111111111111111111111"
},
{
"id": "772f78cfff9a4b819afe5600198aa064",
"description": "портфелі",
"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"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
},
{
"id": "a002ecdf57284cda954a229f1e80d6b0",
"description": "портфелі",
"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"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"relatedBuyer": "22222222222222222222222222222222"
}
],
"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": "493cc77e367e48e9b931dcc640be6399"
},
"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": "50c8dbad7b0c4fd49d4a96be7c4355af",
"transfer": "a88d15516aa948d68b5cba7058d07cb6"
}
}
Move forward as usual, activate award:
Request
PATCH /api/2.5/tenders/19e9963bdfcc4808a9b31fd3ef480e61/awards/8facda3d30224909895aa678c5ecbdac?acc_token=0aff03b619d44f96b3106053625a7357 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "8facda3d30224909895aa678c5ecbdac",
"status": "active",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"bid_id": "4e7b81b085a44b5da48c147911cdbcaa",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "eb1c69ba603f4aa49eb7748457bfe653",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/9510b53f5dd74081b27efe3ab282827a?Signature=moE%2BdidrjsIRZCl20pGYWsIxkuqGVj1s9t06NnjCxPGmg0L38%2FFmWUu4vMdhQIEetzu9wDwRyTduzZlZFdeqCQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"period": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-18T00:00:00+03:00"
},
"qualified": true,
"complaintPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"endDate": "2023-10-13T00:00:00+03:00"
}
}
}
After activating award system is creating such amount of contracts that corresponds to the amount of buyers
Request
GET /api/2.5/tenders/493cc77e367e48e9b931dcc640be6399/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": [
{
"id": "790377c1e17d4a10956295b8430efb4a",
"status": "pending",
"awardID": "35d712ce71d44d0581150ef3f9cbfa3f",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000001-a-1",
"value": {
"amount": 0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0
}
},
{
"id": "ccced68340f74973894bcfbbac2d355b",
"status": "pending",
"awardID": "35d712ce71d44d0581150ef3f9cbfa3f",
"date": "2023-10-10T01:00:00+03:00",
"contractID": "UA-2023-10-10-000001-a-2",
"value": {
"amount": 0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0
}
}
]
}
Update Amount.Value of each contract considering the sum of product of Unit.Value by Quantity for each item in contract.
Request
PATCH /api/2.5/contracts/bf2f401c12e7476986fd5008fd191ee3?acc_token=0aff03b619d44f96b3106053625a7357 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 100,
"amountNet": 95
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"buyerID": "11111111111111111111111111111111",
"awardID": "8facda3d30224909895aa678c5ecbdac",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "076cc611ad7f4f779c67f5eefaa4fa8c",
"description": "телевізори",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "11111111111111111111111111111111"
}
],
"tender_id": "19e9963bdfcc4808a9b31fd3ef480e61",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 100.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 95.0
},
"id": "bf2f401c12e7476986fd5008fd191ee3"
},
"config": {
"restricted": false
}
}
Request
PATCH /api/2.5/contracts/66570cc698414ed6a3d9f41e21430ffd?acc_token=0aff03b619d44f96b3106053625a7357 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 200,
"amountNet": 190
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"buyerID": "22222222222222222222222222222222",
"awardID": "8facda3d30224909895aa678c5ecbdac",
"contractID": "UA-2023-10-10-000001-a-2",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "8e022f41db5141c28550be76bbbd600a",
"description": "портфелі",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "22222222222222222222222222222222"
},
{
"id": "32a3cfc4a06d4962b4c998c340e399c5",
"description": "портфелі",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "22222222222222222222222222222222"
}
],
"tender_id": "19e9963bdfcc4808a9b31fd3ef480e61",
"owner": "broker",
"status": "pending",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037254",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 200.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 190.0
},
"id": "66570cc698414ed6a3d9f41e21430ffd"
},
"config": {
"restricted": false
}
}
You can activate or terminate each contract as usual. If there are not contracts in pending status and at least one contract became active tender is becoming complete
If award was cancelled, all contracts related to this awardID become in cancelled status.
Cancellation of aggregate contracts
Contracts can be cancelled:
Request
PATCH /api/2.5/contracts/790377c1e17d4a10956295b8430efb4a?acc_token=50c8dbad7b0c4fd49d4a96be7c4355af HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "cancelled"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"buyerID": "11111111111111111111111111111111",
"awardID": "35d712ce71d44d0581150ef3f9cbfa3f",
"contractID": "UA-2023-10-10-000001-a-1",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"items": [
{
"id": "19cd4e67d5d74d72b02bbe74396528b4",
"description": "телевізори",
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-10-12T01:00:00+03:00",
"endDate": "2023-10-15T01:00:00+03:00"
},
"relatedBuyer": "11111111111111111111111111111111"
}
],
"tender_id": "493cc77e367e48e9b931dcc640be6399",
"owner": "broker",
"status": "cancelled",
"buyer": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"contractTemplateName": "00000000.0002.01",
"value": {
"amount": 0.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 0.0
},
"date": "2023-10-10T01:00:01+03:00",
"id": "790377c1e17d4a10956295b8430efb4a"
},
"config": {
"restricted": false
}
}
Except when contract is the last not cancelled contract:
Request
PATCH /api/2.5/contracts/ccced68340f74973894bcfbbac2d355b?acc_token=50c8dbad7b0c4fd49d4a96be7c4355af HTTP/1.0
Authorization: Bearer broker
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 from pending to cancelled for last not cancelled contract. Cancel award instead."
}
]
}
In that case related award should be cancelled:
Request
PATCH /api/2.5/tenders/19e4c71b4b4b4595a5bb125c6c5e2df7/awards/765d1e83c038413ab7717ec5e820fdfd?acc_token=05e4dac70d1f462296b4d441345fbc83 HTTP/1.0
Authorization: Bearer broker
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/19e4c71b4b4b4595a5bb125c6c5e2df7/awards/2c31244c27874e13b5e97bdab8a6b7e0
{
"data": {
"id": "765d1e83c038413ab7717ec5e820fdfd",
"status": "cancelled",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-IPN",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
}
],
"bid_id": "5e818bcf21be4d18a84f29d3c85326f7",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "1c04209a75564f6c9800996eff78af44",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/19490ea9427f4458b9607cd94d20b5e3?Signature=yCoELtqowpqESVTm03OLr9Gm%2B9kkSxZUiUcpD3rkM7e6gsTbJJd0t1YVxjXL3eWFweY%2B0Ocl48YHMi6cJCJPDQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"qualified": true
}
}
Let’s check all contracts are cancelled:
Request
GET /api/2.5/contracts?opt_fields=status 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-10-10T01:00:01+03:00",
"status": "cancelled",
"id": "790377c1e17d4a10956295b8430efb4a"
},
{
"status": "cancelled",
"dateModified": "2023-10-10T01:00:01+03:00",
"id": "ccced68340f74973894bcfbbac2d355b"
}
],
"next_page": {
"offset": "1696888801.0.2.69b1d97d9650b9547b86af9bf51c65ad",
"path": "/api/2.5/contracts?opt_fields=status&offset=1696888801.0.2.69b1d97d9650b9547b86af9bf51c65ad",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?opt_fields=status&offset=1696888801.0.2.69b1d97d9650b9547b86af9bf51c65ad"
}
}