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.
Creating contract
Let’s say that we have conducted tender and it has complete status. When the tender is completed, contract (that has been created in the tender system) is transferred to the contract system automatically.
Brokers (eMalls) can’t create contracts in the contract system.
Getting contract
Contract in the tender system
Request
GET /api/2.5/tenders/9edb2de5d15247d485a377e07702bc83/contracts/e07c2e4ee19e43c5bce75b127566b232 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": "e07c2e4ee19e43c5bce75b127566b232",
"awardID": "d64f2e4a9a0e43a093a29c203ad56b71",
"contractID": "UA-2023-01-01-000001-a-1",
"contractNumber": "contract #13111",
"status": "active",
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2024-01-01T00:00:01+02:00"
},
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"items": [
{
"id": "b5ff13b59b7e4f2495ec32bda0e78958",
"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-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "64da1c2d32904c7780c7a080c03b9058",
"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-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:01+02:00",
"documents": [
{
"id": "e0dbb5b1ba48444caa87e74919f15684",
"datePublished": "2023-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fd05000cea6644509133d7a55a6d0eb6?Signature=BGFjPoS7Fy6SJmiIpVychi4qX2I%2FLWV1%2Bq5Hj2XRrdRyYCMhO2KkHlHjL5DS8QqeV38n2bjWlho1wM03cTe6AQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:01+02:00",
"language": "uk"
},
{
"id": "a5eda0ad89cd4f5eb58da1a4840c0239",
"datePublished": "2023-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7b57c09aa077422282cf6ef8753e3812?Signature=loqXGLRZ6q7oNmHis9gM8i0hhPHnbyFLL8%2FuhAi2fzy85szHT3mTZKW4RNCOVszftzu7ATdFx89ccnO0RmaUBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:01+02:00",
"language": "uk"
}
],
"dateSigned": "2023-01-01T00:00:01+02:00"
}
}
Contract id is the same in both tender and contract system.
Let’s access the URL of the created object:
Request
GET /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "d64f2e4a9a0e43a093a29c203ad56b71",
"contractID": "UA-2023-01-01-000001-a-1",
"contractNumber": "contract #13111",
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2024-01-01T00:00:01+02:00"
},
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"items": [
{
"id": "b5ff13b59b7e4f2495ec32bda0e78958",
"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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
},
{
"id": "64da1c2d32904c7780c7a080c03b9058",
"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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
}
],
"documents": [
{
"language": "uk",
"id": "e0dbb5b1ba48444caa87e74919f15684",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fd05000cea6644509133d7a55a6d0eb6?Signature=BGFjPoS7Fy6SJmiIpVychi4qX2I%2FLWV1%2Bq5Hj2XRrdRyYCMhO2KkHlHjL5DS8QqeV38n2bjWlho1wM03cTe6AQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"language": "uk",
"id": "a5eda0ad89cd4f5eb58da1a4840c0239",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7b57c09aa077422282cf6ef8753e3812?Signature=loqXGLRZ6q7oNmHis9gM8i0hhPHnbyFLL8%2FuhAi2fzy85szHT3mTZKW4RNCOVszftzu7ATdFx89ccnO0RmaUBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"owner": "broker",
"tender_id": "9edb2de5d15247d485a377e07702bc83",
"status": "active",
"dateSigned": "2023-01-01T00:00:01+02:00",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"dateCreated": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"id": "e07c2e4ee19e43c5bce75b127566b232"
},
"config": {
"restricted": false
}
}
Getting access
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/e07c2e4ee19e43c5bce75b127566b232/credentials?acc_token=b335e5d31c7b4c8291d7a477b18ec529 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": "d64f2e4a9a0e43a093a29c203ad56b71",
"contractID": "UA-2023-01-01-000001-a-1",
"contractNumber": "contract #13111",
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2024-01-01T00:00:01+02:00"
},
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"items": [
{
"id": "b5ff13b59b7e4f2495ec32bda0e78958",
"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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
},
{
"id": "64da1c2d32904c7780c7a080c03b9058",
"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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
}
],
"documents": [
{
"language": "uk",
"id": "e0dbb5b1ba48444caa87e74919f15684",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fd05000cea6644509133d7a55a6d0eb6?Signature=BGFjPoS7Fy6SJmiIpVychi4qX2I%2FLWV1%2Bq5Hj2XRrdRyYCMhO2KkHlHjL5DS8QqeV38n2bjWlho1wM03cTe6AQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"language": "uk",
"id": "a5eda0ad89cd4f5eb58da1a4840c0239",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7b57c09aa077422282cf6ef8753e3812?Signature=loqXGLRZ6q7oNmHis9gM8i0hhPHnbyFLL8%2FuhAi2fzy85szHT3mTZKW4RNCOVszftzu7ATdFx89ccnO0RmaUBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
],
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"owner": "broker",
"tender_id": "9edb2de5d15247d485a377e07702bc83",
"status": "active",
"dateSigned": "2023-01-01T00:00:01+02:00",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"dateCreated": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"id": "e07c2e4ee19e43c5bce75b127566b232"
},
"config": {
"restricted": false
},
"access": {
"token": "062c12970e6f4412910d3e057cf91972",
"transfer": "41e63f1f116c49a7a92b92b09c6884ee"
}
}
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-01-01T00:00:01+02:00",
"id": "e07c2e4ee19e43c5bce75b127566b232"
}
],
"next_page": {
"offset": 1672524001.0,
"path": "/api/2.5/contracts?offset=1672524001.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=1672524001.0"
}
}
We do see the internal id of a contract (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/contracts/) and its dateModified datestamp.
Modifying 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/e07c2e4ee19e43c5bce75b127566b232/changes?acc_token=062c12970e6f4412910d3e057cf91972 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": "1a129a39cd1743cfabd30481bbd04c61",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00"
}
}
Note that you can provide more than one value in rationaleTypes field.
You can view the change:
Request
GET /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/changes/1a129a39cd1743cfabd30481bbd04c61 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": "1a129a39cd1743cfabd30481bbd04c61",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00"
}
}
Change can be modified while it is in the pending status:
Request
PATCH /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/changes/1a129a39cd1743cfabd30481bbd04c61?acc_token=062c12970e6f4412910d3e057cf91972 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": "1a129a39cd1743cfabd30481bbd04c61",
"status": "pending",
"date": "2023-01-01T00:00:01+02: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/e07c2e4ee19e43c5bce75b127566b232/documents?acc_token=062c12970e6f4412910d3e057cf91972 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/0d99c24f1f224e35ae9a11b101f38e20?Signature=BRGDeri7Q8t8DU3AdjZG6kbAIMzD13bxyYUCLpntZeSZAJ5VOQNP5mDDFLwJFjevwRslbeAk8D9osSOn3a6JDA%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/e07c2e4ee19e43c5bce75b127566b232/documents/6d33a714149d4018b4bfe5b84d60ee97
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0d99c24f1f224e35ae9a11b101f38e20?Signature=frmPNGoQqoxxO6DV2U9E%2F6UlY988%2Bq%2BUeV3Bi%2FxPKhoA4%2FXFO60iLCQJeGwqnD7hxsQzuV4jUS08Nwfj%2BrhOAw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "6d33a714149d4018b4bfe5b84d60ee97",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02: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/e07c2e4ee19e43c5bce75b127566b232/documents/6d33a714149d4018b4bfe5b84d60ee97?acc_token=062c12970e6f4412910d3e057cf91972 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"documentOf": "change",
"relatedItem": "1a129a39cd1743cfabd30481bbd04c61"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"relatedItem": "1a129a39cd1743cfabd30481bbd04c61",
"id": "6d33a714149d4018b4bfe5b84d60ee97",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0d99c24f1f224e35ae9a11b101f38e20?Signature=frmPNGoQqoxxO6DV2U9E%2F6UlY988%2Bq%2BUeV3Bi%2FxPKhoA4%2FXFO60iLCQJeGwqnD7hxsQzuV4jUS08Nwfj%2BrhOAw%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
}
Updating contract properties
Now you can update contract properties which belong to the change.
You can update value amount and amountNet following next rules:
valueAddedTaxIncluded |
Validation |
true |
Amount should be greater than amountNet and differ by no more than 20% |
false |
Amount and amountNet should be equal |
Request
PATCH /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232?acc_token=062c12970e6f4412910d3e057cf91972 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 438,
"amountNet": 430
},
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-01-31T00:00:01+02:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "d64f2e4a9a0e43a093a29c203ad56b71",
"contractID": "UA-2023-01-01-000001-a-1",
"contractNumber": "contract #13111",
"dateSigned": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"dateCreated": "2023-01-01T00:00:01+02:00",
"items": [
{
"id": "b5ff13b59b7e4f2495ec32bda0e78958",
"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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
},
{
"id": "64da1c2d32904c7780c7a080c03b9058",
"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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
}
],
"tender_id": "9edb2de5d15247d485a377e07702bc83",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-01-31T00:00:01+02:00"
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "1a129a39cd1743cfabd30481bbd04c61",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00"
}
],
"documents": [
{
"language": "uk",
"id": "e0dbb5b1ba48444caa87e74919f15684",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fd05000cea6644509133d7a55a6d0eb6?Signature=BGFjPoS7Fy6SJmiIpVychi4qX2I%2FLWV1%2Bq5Hj2XRrdRyYCMhO2KkHlHjL5DS8QqeV38n2bjWlho1wM03cTe6AQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"language": "uk",
"id": "a5eda0ad89cd4f5eb58da1a4840c0239",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7b57c09aa077422282cf6ef8753e3812?Signature=loqXGLRZ6q7oNmHis9gM8i0hhPHnbyFLL8%2FuhAi2fzy85szHT3mTZKW4RNCOVszftzu7ATdFx89ccnO0RmaUBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"relatedItem": "1a129a39cd1743cfabd30481bbd04c61",
"id": "6d33a714149d4018b4bfe5b84d60ee97",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/6d33a714149d4018b4bfe5b84d60ee97?download=0d99c24f1f224e35ae9a11b101f38e20",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"id": "e07c2e4ee19e43c5bce75b127566b232"
},
"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/e07c2e4ee19e43c5bce75b127566b232?acc_token=062c12970e6f4412910d3e057cf91972 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "b5ff13b59b7e4f2495ec32bda0e78958",
"description": "футляри до державних нагород",
"unit": {
"name": "кг",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 2,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
},
{
"id": "64da1c2d32904c7780c7a080c03b9058",
"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-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
]
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "d64f2e4a9a0e43a093a29c203ad56b71",
"contractID": "UA-2023-01-01-000001-a-1",
"contractNumber": "contract #13111",
"dateSigned": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"dateCreated": "2023-01-01T00:00:01+02:00",
"items": [
{
"id": "b5ff13b59b7e4f2495ec32bda0e78958",
"description": "футляри до державних нагород",
"quantity": 2.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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
},
{
"id": "64da1c2d32904c7780c7a080c03b9058",
"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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
}
],
"tender_id": "9edb2de5d15247d485a377e07702bc83",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-01-31T00:00:01+02:00"
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"id": "1a129a39cd1743cfabd30481bbd04c61",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00"
}
],
"documents": [
{
"language": "uk",
"id": "e0dbb5b1ba48444caa87e74919f15684",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fd05000cea6644509133d7a55a6d0eb6?Signature=BGFjPoS7Fy6SJmiIpVychi4qX2I%2FLWV1%2Bq5Hj2XRrdRyYCMhO2KkHlHjL5DS8QqeV38n2bjWlho1wM03cTe6AQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"language": "uk",
"id": "a5eda0ad89cd4f5eb58da1a4840c0239",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7b57c09aa077422282cf6ef8753e3812?Signature=loqXGLRZ6q7oNmHis9gM8i0hhPHnbyFLL8%2FuhAi2fzy85szHT3mTZKW4RNCOVszftzu7ATdFx89ccnO0RmaUBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"relatedItem": "1a129a39cd1743cfabd30481bbd04c61",
"id": "6d33a714149d4018b4bfe5b84d60ee97",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/6d33a714149d4018b4bfe5b84d60ee97?download=0d99c24f1f224e35ae9a11b101f38e20",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"id": "e07c2e4ee19e43c5bce75b127566b232"
},
"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/e07c2e4ee19e43c5bce75b127566b232/changes/1a129a39cd1743cfabd30481bbd04c61?acc_token=062c12970e6f4412910d3e057cf91972 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"dateSigned": "2023-01-01T00:00:01+02:00"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00",
"id": "1a129a39cd1743cfabd30481bbd04c61",
"status": "active",
"date": "2023-01-01T00:00:01+02: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/e07c2e4ee19e43c5bce75b127566b232/changes HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00",
"id": "1a129a39cd1743cfabd30481bbd04c61",
"status": "active",
"date": "2023-01-01T00:00:01+02:00"
}
]
}
All changes are also listed on the contract view.
Request
GET /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232 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": "d64f2e4a9a0e43a093a29c203ad56b71",
"contractID": "UA-2023-01-01-000001-a-1",
"contractNumber": "contract #13111",
"dateSigned": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"dateCreated": "2023-01-01T00:00:01+02:00",
"items": [
{
"id": "b5ff13b59b7e4f2495ec32bda0e78958",
"description": "футляри до державних нагород",
"quantity": 2.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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
},
{
"id": "64da1c2d32904c7780c7a080c03b9058",
"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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
}
],
"tender_id": "9edb2de5d15247d485a377e07702bc83",
"owner": "broker",
"status": "active",
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-01-31T00:00:01+02:00"
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00",
"id": "1a129a39cd1743cfabd30481bbd04c61",
"status": "active",
"date": "2023-01-01T00:00:01+02:00"
}
],
"documents": [
{
"language": "uk",
"id": "e0dbb5b1ba48444caa87e74919f15684",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fd05000cea6644509133d7a55a6d0eb6?Signature=BGFjPoS7Fy6SJmiIpVychi4qX2I%2FLWV1%2Bq5Hj2XRrdRyYCMhO2KkHlHjL5DS8QqeV38n2bjWlho1wM03cTe6AQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"language": "uk",
"id": "a5eda0ad89cd4f5eb58da1a4840c0239",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7b57c09aa077422282cf6ef8753e3812?Signature=loqXGLRZ6q7oNmHis9gM8i0hhPHnbyFLL8%2FuhAi2fzy85szHT3mTZKW4RNCOVszftzu7ATdFx89ccnO0RmaUBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"relatedItem": "1a129a39cd1743cfabd30481bbd04c61",
"id": "6d33a714149d4018b4bfe5b84d60ee97",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/6d33a714149d4018b4bfe5b84d60ee97?download=0d99c24f1f224e35ae9a11b101f38e20",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
],
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"id": "e07c2e4ee19e43c5bce75b127566b232"
},
"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/e07c2e4ee19e43c5bce75b127566b232/documents?acc_token=062c12970e6f4412910d3e057cf91972 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/e13edfd2b47b4517b2c666fd6b7c3196?Signature=YDlJ9n4HdHHLgMhCGFqk0foOvdQn3HIwSXXS%2Fln0kj9Bo3ntj6kdXwSwIwffSJSycGHKeI8dmViS9sZQ1HwUAw%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/e07c2e4ee19e43c5bce75b127566b232/documents/96f96b08147a4844838acce45361d315
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e13edfd2b47b4517b2c666fd6b7c3196?Signature=IYfzAIAKvHzmmhP7RsgXgW0YWTYEblqVeDFlOlJIub5upZTOhnVFjLlHy54NP9A%2BVXa4dkw91bvR0nCCqIaQBg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "96f96b08147a4844838acce45361d315",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02: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/e07c2e4ee19e43c5bce75b127566b232/documents?acc_token=062c12970e6f4412910d3e057cf91972 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"language": "uk",
"id": "e0dbb5b1ba48444caa87e74919f15684",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fd05000cea6644509133d7a55a6d0eb6?Signature=BGFjPoS7Fy6SJmiIpVychi4qX2I%2FLWV1%2Bq5Hj2XRrdRyYCMhO2KkHlHjL5DS8QqeV38n2bjWlho1wM03cTe6AQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"language": "uk",
"id": "a5eda0ad89cd4f5eb58da1a4840c0239",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7b57c09aa077422282cf6ef8753e3812?Signature=loqXGLRZ6q7oNmHis9gM8i0hhPHnbyFLL8%2FuhAi2fzy85szHT3mTZKW4RNCOVszftzu7ATdFx89ccnO0RmaUBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"relatedItem": "1a129a39cd1743cfabd30481bbd04c61",
"id": "6d33a714149d4018b4bfe5b84d60ee97",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/0d99c24f1f224e35ae9a11b101f38e20?Signature=frmPNGoQqoxxO6DV2U9E%2F6UlY988%2Bq%2BUeV3Bi%2FxPKhoA4%2FXFO60iLCQJeGwqnD7hxsQzuV4jUS08Nwfj%2BrhOAw%3D%3D&KeyID=a8968c46",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/e13edfd2b47b4517b2c666fd6b7c3196?Signature=IYfzAIAKvHzmmhP7RsgXgW0YWTYEblqVeDFlOlJIub5upZTOhnVFjLlHy54NP9A%2BVXa4dkw91bvR0nCCqIaQBg%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "96f96b08147a4844838acce45361d315",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
]
}
And again we can confirm that there are two documents uploaded.
Request
POST /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents?acc_token=062c12970e6f4412910d3e057cf91972 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/621afd2fea2e451ea7e9a1f1477026f1?Signature=wz5jWWnxgZruWntGzXN8hZ0Jeo1kypuumxSX6meuw46NI%2Fm6xLy6MTlGGNANBrp70OY199WtfiqPlvieCfBCCg%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/e07c2e4ee19e43c5bce75b127566b232/documents/3c69e744f94c4208b85ba6181f916659
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/621afd2fea2e451ea7e9a1f1477026f1?Signature=WyayoKqVaq3XFMI5pQDqrVIoENeDKjOy6aeOUJl5X37YjF0HR3z4ClC0l1yS0FGSH1vuMBdr1zItM9%2BvTlTpCw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "3c69e744f94c4208b85ba6181f916659",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
}
In case we made an error, we can reupload the document over the older version:
Request
PUT /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/3c69e744f94c4208b85ba6181f916659?acc_token=062c12970e6f4412910d3e057cf91972 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/add37452a76c4d0c8d0a94b0bdcc9d60?Signature=xmf6K9TQPgkuD7V0Cb9cj40tlmn9wS3eZv0Fyo2Di89rhH7bbXM%2FEEjMiCNorWd3%2FJlNK83LktF4O1R050AFAg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "3c69e744f94c4208b85ba6181f916659",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/add37452a76c4d0c8d0a94b0bdcc9d60?Signature=oH1nWqinLpNoS94ZQ1k9CL%2BODC6HsfwYQaZRtnjr0kYQxoViP69dcPLp1nzR6UwSLS8cqx1YFhVjnJXvB2JWCw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
}
And we can see that it is overriding the original version:
Request
GET /api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/3c69e744f94c4208b85ba6181f916659?acc_token=062c12970e6f4412910d3e057cf91972 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": "3c69e744f94c4208b85ba6181f916659",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/add37452a76c4d0c8d0a94b0bdcc9d60?Signature=oH1nWqinLpNoS94ZQ1k9CL%2BODC6HsfwYQaZRtnjr0kYQxoViP69dcPLp1nzR6UwSLS8cqx1YFhVjnJXvB2JWCw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"previousVersions": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/621afd2fea2e451ea7e9a1f1477026f1?Signature=WyayoKqVaq3XFMI5pQDqrVIoENeDKjOy6aeOUJl5X37YjF0HR3z4ClC0l1yS0FGSH1vuMBdr1zItM9%2BvTlTpCw%3D%3D&KeyID=a8968c46",
"documentOf": "contract",
"id": "3c69e744f94c4208b85ba6181f916659",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02: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/e07c2e4ee19e43c5bce75b127566b232?acc_token=062c12970e6f4412910d3e057cf91972 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "terminated",
"amountPaid": {
"amount": 430,
"amountNet": 420,
"valueAddedTaxIncluded": true
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"awardID": "d64f2e4a9a0e43a093a29c203ad56b71",
"contractID": "UA-2023-01-01-000001-a-1",
"contractNumber": "contract #13111",
"dateSigned": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"dateCreated": "2023-01-01T00:00:01+02:00",
"items": [
{
"id": "b5ff13b59b7e4f2495ec32bda0e78958",
"description": "футляри до державних нагород",
"quantity": 2.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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
},
{
"id": "64da1c2d32904c7780c7a080c03b9058",
"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": true
},
"code": "KGM"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"deliveryDate": {
"startDate": "2023-01-03T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
}
],
"tender_id": "9edb2de5d15247d485a377e07702bc83",
"owner": "broker",
"status": "terminated",
"period": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-01-31T00:00:01+02:00"
},
"suppliers": [
{
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
}
],
"changes": [
{
"rationale": "Друга і третя поставка має бути розфасована",
"rationale_en": "Contract change cause",
"rationaleTypes": [
"volumeCuts",
"priceReduction"
],
"dateSigned": "2023-01-01T00:00:01+02:00",
"id": "1a129a39cd1743cfabd30481bbd04c61",
"status": "active",
"date": "2022-12-31T22:00:01"
}
],
"documents": [
{
"language": "uk",
"id": "e0dbb5b1ba48444caa87e74919f15684",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/fd05000cea6644509133d7a55a6d0eb6?Signature=BGFjPoS7Fy6SJmiIpVychi4qX2I%2FLWV1%2Bq5Hj2XRrdRyYCMhO2KkHlHjL5DS8QqeV38n2bjWlho1wM03cTe6AQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"language": "uk",
"id": "a5eda0ad89cd4f5eb58da1a4840c0239",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/7b57c09aa077422282cf6ef8753e3812?Signature=loqXGLRZ6q7oNmHis9gM8i0hhPHnbyFLL8%2FuhAi2fzy85szHT3mTZKW4RNCOVszftzu7ATdFx89ccnO0RmaUBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"relatedItem": "1a129a39cd1743cfabd30481bbd04c61",
"id": "6d33a714149d4018b4bfe5b84d60ee97",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_changes.doc",
"format": "application/msword",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/6d33a714149d4018b4bfe5b84d60ee97?download=0d99c24f1f224e35ae9a11b101f38e20",
"documentOf": "change",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"id": "96f96b08147a4844838acce45361d315",
"hash": "md5:00000000000000000000000000000000",
"title": "contract.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/96f96b08147a4844838acce45361d315?download=e13edfd2b47b4517b2c666fd6b7c3196",
"documentOf": "contract",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"id": "3c69e744f94c4208b85ba6181f916659",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/3c69e744f94c4208b85ba6181f916659?download=621afd2fea2e451ea7e9a1f1477026f1",
"documentOf": "contract",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"id": "3c69e744f94c4208b85ba6181f916659",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_additional_docs.doc",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/e07c2e4ee19e43c5bce75b127566b232/documents/3c69e744f94c4208b85ba6181f916659?download=add37452a76c4d0c8d0a94b0bdcc9d60",
"documentOf": "contract",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
],
"amountPaid": {
"amount": 430.0,
"currency": "UAH",
"amountNet": 420.0,
"valueAddedTaxIncluded": true
},
"value": {
"amount": 438.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 430.0
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Державне управління справами",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"kind": "general",
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
}
},
"id": "e07c2e4ee19e43c5bce75b127566b232"
},
"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.