Туторіал
Розглянемо основні правила
Подивимось як працює точка входу /contracts:
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"
}
}
При виклику видає пустий набір.
Перенесенням договору із системи закупівель займається автоматизований процес.
Створення договору
Нехай у нас відбулась закупівля і вона є в статусі complete. Після цього договір, створений в системі закупівель, потрапляє в систему договорів.
Майданчики (брокери) не мають можливості створювати договори в системі договорів.
Отримання договору
Договір в системі закупівель
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"
}
}
Ідентифікатор `id` договору однаковий в системах закупівель та договорів.
Спробуємо доступитись до URL створеного об’єкта:
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
}
}
Отримання доступу
Для того, щоб отримати права для майбутнього редагування договору, необхідно використати таку в’юшку PATCH: /contracts/{id}/credentials?acc_token={tender_token} з API ключем майданчика, де була згенерована закупівля.
В PATCH: /contracts/{id}/credentials?acc_token={tender_token}:
id- це ідентифікатор договору,tender_token- це токен закупівлі (використовується для генерування токена договору).
У відповіді буде access.token для договору, який буде використовуватись для модифікації договору.
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"
}
}
Переглянемо договори.
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"
}
}
Ми бачимо внутрішнє id договору (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/contracts/) та його dateModified дату.
Редагування договору
Внесення змін до істотних умов договору можливі у випадках, описаних частиною четвертою статті 36 Закону України “Про публічні закупівлі”.
Істотні умови договору можуть бути змінені поданням нового об’єкта Change в котейнер Contract.changes.
Всі зміни change обробляються точкою входу (endpoint) /contracts/{id}/changes.
Подання зміни
Додамо нову зміну change до договору:
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"
}
}
Зверніть увагу на те, що ви можете надати більше ніж одне значення для поля rationaleTypes.
Ви можете переглянути зміну 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 можна модифікувати доки вона має статус pending.
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"
}
}
Завантаження документа зміни
Документ можна додати доки зміна change має статус pending.
Документ додається в два етапи:
ви повинні завантажити документ
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"
}
}
ви повинні задати властивості документа:
"documentOf": "change"та"relatedItem": "{change.id}", щоб «прив’язати» завантажений документ до зміни 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"
}
}
Оновлення властивостей зміни
Тепер ви можете оновити властивості договору, що стосуються зміни.
Ви можете встановити нові значення для полів amount та amountNet керуючись наступними правилами:
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
}
}
Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.
Поля, які можна модифікувати: title, description, status, value.amount, value.amountNet, period, items, amountPaid.amount, amountPaid.amountТуе, terminationDetails.
Дивіться приклади зміни елемента (items) нижче. Ви можете:
оновити елемент (items):
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
}
}
Застосування зміни
Зміна change застосовується при переключенні в статус active.
Щоб застосувати статус active потрібно встановити поле dateSigned.
ПІсля цього модифікувати зміну change вже не можна.
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:
для першої зміни change договору дата повинна бути після contract.dateSigned;
для всіх наступних змін change договору дата повинна бути після попередньої дати change.dateSigned.
Ви можете переглянути всі зміни:
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"
}
]
}
Всі зміни присутні при перегляді контракту.
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
}
}
Завантаження документації
Замовник може завантажити PDF файл у створений договір. Завантаження повинно відбуватись згідно правил Завантаження документів.
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 та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:
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"
}
]
}
І знову можна перевірити, що є два завантажених документа.
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"
}
}
Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:
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"
}
}
І ми бачимо, що вона перекриває оригінальну версію:
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"
}
]
}
}
Завершення договору
Перед завершенням договору необхідно встановити значення поля amountPaid (незалежно від того успішний договір чи ні). Договір можна завершити переключенням у статус terminated. Виконаємо ці дії єдиним запитом:
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
}
}
Зверніть увагу, що ви можете встановлювати/змінювати значення amountPaid.amount, amountPaid.amountNet, amountPaid.valueAddedTaxIncluded. А значення поля amountPaid.currency генеруються з поля Contract.value.
Якщо договір неуспішний, то потрібно вказати причини його припинення terminationDetails.
Після цього додання змін до договору не дозволяється.