Туторіал

Розглянемо основні правила

Подивимось як працює точка входу /contracts:

GET /api/2.5/contracts HTTP/1.0
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/contracts?offset=",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=",
    "offset": ""
  },
  "data": []
}

При виклику видає пустий набір.

Перенесенням договору із системи закупівель займається автоматизований процес.

Створення договору

Нехай у нас відбулась закупівля і вона є в статусі complete. Після цього договір, створений в системі закупівель, потрапляє в систему договорів.

Майданчики (брокери) не мають можливості створювати договори в системі договорів.

Отримання договору

Договір в системі закупівель

GET /api/2.5/tenders/ffa3d33ea0004692a4a30af55a8f6a5b/contracts/05870adde49c424db6a2dba280ea90ab HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      },
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "5266f95b8c684790890c7d2923546a9d",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "amountNet": 490.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "date": "2020-05-01T01:00:01+03:00",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "id": "05870adde49c424db6a2dba280ea90ab",
    "contractID": "UA-2020-05-01-000001-1"
  }
}

Ідентифікатор `id` договору однаковий в системах закупівель та договорів.

Спробуємо доступитись до URL створеного об’єкта:

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab HTTP/1.0
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      },
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "5266f95b8c684790890c7d2923546a9d",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "dateModified": "2020-05-01T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "amountNet": 490.0,
      "valueAddedTaxIncluded": true
    },
    "contractID": "UA-2020-05-01-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

Отримання доступу

Для того, щоб отримати права для майбутнього редагування договору, необхідно використати таку в’юшку PATCH: /contracts/{id}/credentials?acc_token={tender_token} з API ключем майданчика, де була згенерована закупівля.

В PATCH: /contracts/{id}/credentials?acc_token={tender_token}:

  • id - це ідентифікатор договору,
  • tender_token - це токен закупівлі (використовується для генерування токена договору).

У відповіді буде access.token для договору, який буде використовуватись для модифікації договору.

PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/credentials?acc_token=b9646ca4bdf64fc9a724c708b72a1c38 HTTP/1.0
Authorization: Bearer broker
Content-Length: 0
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "access": {
    "transfer": "46a94f59cf264e9fb4264dd30c38e236",
    "token": "9e4e9f4da0514309b6c79bbafb5b59c3"
  },
  "data": {
    "status": "active",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      },
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "5266f95b8c684790890c7d2923546a9d",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "dateModified": "2020-05-01T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "amountNet": 490.0,
      "valueAddedTaxIncluded": true
    },
    "contractID": "UA-2020-05-01-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

Переглянемо договори.

GET /api/2.5/contracts HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/contracts?offset=2020-05-01T01%3A00%3A01%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=2020-05-01T01%3A00%3A01%2B03%3A00",
    "offset": "2020-05-01T01:00:01+03:00"
  },
  "data": [
    {
      "id": "05870adde49c424db6a2dba280ea90ab",
      "dateModified": "2020-05-01T01:00:01+03:00"
    }
  ]
}

Ми бачимо внутрішнє id договору (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/contracts/) та його dateModified дату.

Редагування договору

Внесення змін до істотних умов договору можливі у випадках, описаних частиною четвертою статті 36 Закону України “Про публічні закупівлі”.

Істотні умови договору можуть бути змінені поданням нового об’єкта Change в котейнер Contract.changes.

Всі зміни change обробляються точкою входу (endpoint) /contracts/{id}/changes.

Подання зміни

Додамо нову зміну change до договору:

POST /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/changes?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 267
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ],
    "rationale_en": "Contract change cause",
    "rationale": "Опис причини змін контракту"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ],
    "rationale_en": "Contract change cause",
    "rationale": "Опис причини змін контракту",
    "date": "2020-05-01T01:00:01+03:00",
    "id": "f3fe39d5213d4a029212ff4f1151cf40"
  }
}

Зверніть увагу на те, що ви можете надати більше ніж одне значення для поля rationaleTypes.

Ви можете переглянути зміну change:

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/changes/f3fe39d5213d4a029212ff4f1151cf40 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ],
    "rationale_en": "Contract change cause",
    "rationale": "Опис причини змін контракту",
    "date": "2020-05-01T01:00:01+03:00",
    "id": "f3fe39d5213d4a029212ff4f1151cf40"
  }
}

Зміну change можна модифікувати доки вона має статус pending.

PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/changes/f3fe39d5213d4a029212ff4f1151cf40?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 255
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "rationale": "Друга і третя поставка має бути розфасована"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ],
    "rationale_en": "Contract change cause",
    "rationale": "Друга і третя поставка має бути розфасована",
    "date": "2020-05-01T01:00:01+03:00",
    "id": "f3fe39d5213d4a029212ff4f1151cf40"
  }
}

Завантаження документа зміни

Документ можна додати доки зміна change має статус pending.

Документ додається в два етапи:

  • ви повинні завантажити документ
POST /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 155
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract_changes.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c
{
  "data": {
    "title": "contract_changes.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2020-05-01T01:00:01+03:00",
    "id": "de3004e5b9844707bb35405277043c7c",
    "dateModified": "2020-05-01T01:00:01+03:00"
  }
}
  • ви повинні задати властивості документа: "documentOf": "change" та "relatedItem": "{change.id}", щоб «прив’язати» завантажений документ до зміни change:
PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 85
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "documentOf": "change",
    "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "title": "contract_changes.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
    "format": "application/msword",
    "documentOf": "change",
    "datePublished": "2020-05-01T01:00:01+03:00",
    "id": "de3004e5b9844707bb35405277043c7c",
    "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
    "dateModified": "2020-05-01T01:00:01+03: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
PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 148
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "period": {
      "startDate": "2020-05-01T01:00:01+03:00",
      "endDate": "2020-05-31T01:00:01+03:00"
    },
    "value": {
      "amount": 438,
      "amountNet": 430
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "de3004e5b9844707bb35405277043c7c",
        "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
        "dateModified": "2020-05-01T01:00:01+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      },
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "5266f95b8c684790890c7d2923546a9d",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2020-05-01T01:00:01+03:00",
      "endDate": "2020-05-31T01:00:01+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "amountNet": 430.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2020-05-01T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "contractID": "UA-2020-05-01-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "changes": [
      {
        "status": "pending",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2020-05-01T01:00:01+03:00",
        "id": "f3fe39d5213d4a029212ff4f1151cf40"
      }
    ],
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.

Поля, які можна модифікувати: title, description, status, value.amount, value.amountNet, period, items, amountPaid.amount, amountPaid.amountТуе, terminationDetails.

Дивіться приклади зміни елемента (items) нижче. Ви можете:

  • оновити елемент (items):
PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 42
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "quantity": 2
      },
      {}
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "de3004e5b9844707bb35405277043c7c",
        "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
        "dateModified": "2020-05-01T01:00:01+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2.0
      },
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "5266f95b8c684790890c7d2923546a9d",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2020-05-01T01:00:01+03:00",
      "endDate": "2020-05-31T01:00:01+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "amountNet": 430.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2020-05-01T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "contractID": "UA-2020-05-01-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "changes": [
      {
        "status": "pending",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2020-05-01T01:00:01+03:00",
        "id": "f3fe39d5213d4a029212ff4f1151cf40"
      }
    ],
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}
  • видалити елемент (items):

Request example for cases when contract has several items:

PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1148
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2.0
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "de3004e5b9844707bb35405277043c7c",
        "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
        "dateModified": "2020-05-01T01:00:01+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2020-05-01T01:00:01+03:00",
      "endDate": "2020-05-31T01:00:01+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "amountNet": 430.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2020-05-01T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "contractID": "UA-2020-05-01-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "changes": [
      {
        "status": "pending",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2020-05-01T01:00:01+03:00",
        "id": "f3fe39d5213d4a029212ff4f1151cf40"
      }
    ],
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

Застосування зміни

Зміна change застосовується при переключенні в статус active.

Щоб застосувати статус active потрібно встановити поле dateSigned.

ПІсля цього модифікувати зміну change вже не можна.

PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/changes/f3fe39d5213d4a029212ff4f1151cf40?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 73
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active",
    "dateSigned": "2020-05-01T01:00:01+03:00"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ],
    "rationale_en": "Contract change cause",
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "rationale": "Друга і третя поставка має бути розфасована",
    "date": "2020-05-01T01:00:01+03:00",
    "id": "f3fe39d5213d4a029212ff4f1151cf40"
  }
}

Валідація поля dateSigned:

  • для першої зміни change договору дата повинна бути після contract.dateSigned;
  • для всіх наступних змін change договору дата повинна бути після попередньої дати change.dateSigned.

Ви можете переглянути всі зміни:

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/changes HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "status": "active",
      "rationaleTypes": [
        "volumeCuts",
        "priceReduction"
      ],
      "rationale_en": "Contract change cause",
      "dateSigned": "2020-05-01T01:00:01+03:00",
      "rationale": "Друга і третя поставка має бути розфасована",
      "date": "2020-05-01T01:00:01+03:00",
      "id": "f3fe39d5213d4a029212ff4f1151cf40"
    }
  ]
}

Всі зміни присутні при перегляді контракту.

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "de3004e5b9844707bb35405277043c7c",
        "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
        "dateModified": "2020-05-01T01:00:01+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2020-05-01T01:00:01+03:00",
      "endDate": "2020-05-31T01:00:01+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "amountNet": 430.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2020-05-01T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "contractID": "UA-2020-05-01-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "changes": [
      {
        "status": "active",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "dateSigned": "2020-05-01T01:00:01+03:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2020-05-01T01:00:01+03:00",
        "id": "f3fe39d5213d4a029212ff4f1151cf40"
      }
    ],
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

Завантаження документації

Замовник може завантажити PDF файл у створений договір. Завантаження повинно відбуватись згідно правил Завантаження документів.

POST /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 147
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/e280bc973d5b4ce284dd152f15ae24f4
{
  "data": {
    "title": "contract.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/e280bc973d5b4ce284dd152f15ae24f4?download=5311a5f7a2dc43d68092e08adad8737b",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2020-05-01T01:00:01+03:00",
    "id": "e280bc973d5b4ce284dd152f15ae24f4",
    "dateModified": "2020-05-01T01:00:01+03:00"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "contract.doc",
      "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/e280bc973d5b4ce284dd152f15ae24f4?download=5311a5f7a2dc43d68092e08adad8737b",
      "format": "application/msword",
      "documentOf": "contract",
      "datePublished": "2020-05-01T01:00:01+03:00",
      "id": "e280bc973d5b4ce284dd152f15ae24f4",
      "dateModified": "2020-05-01T01:00:01+03:00"
    },
    {
      "title": "contract_changes.doc",
      "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
      "format": "application/msword",
      "documentOf": "change",
      "datePublished": "2020-05-01T01:00:01+03:00",
      "id": "de3004e5b9844707bb35405277043c7c",
      "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
      "dateModified": "2020-05-01T01:00:01+03:00"
    }
  ]
}

І знову можна перевірити, що є два завантажених документа.

POST /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 171
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract_additional_docs.doc"
Content-Type: application/msword

additional info
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860
{
  "data": {
    "title": "contract_additional_docs.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=54f475dac20b45d0aefff43fc60f1822",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2020-05-01T01:00:01+03:00",
    "id": "884f1aed57d741a7a8011e28edc20860",
    "dateModified": "2020-05-01T01:00:01+03:00"
  }
}

Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:

PUT /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 180
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract_additional_docs.doc"
Content-Type: application/msword

extended additional info
-----BOUNDARY--


Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "title": "contract_additional_docs.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=2562188623c64e25967736fbcc3a38d2",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2020-05-01T01:00:01+03:00",
    "id": "884f1aed57d741a7a8011e28edc20860",
    "dateModified": "2020-05-01T01:00:01+03:00"
  }
}

І ми бачимо, що вона перекриває оригінальну версію:

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "title": "contract_additional_docs.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=2562188623c64e25967736fbcc3a38d2",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2020-05-01T01:00:01+03:00",
    "previousVersions": [
      {
        "title": "contract_additional_docs.doc",
        "url": "/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=54f475dac20b45d0aefff43fc60f1822",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "884f1aed57d741a7a8011e28edc20860",
        "dateModified": "2020-05-01T01:00:01+03:00"
      }
    ],
    "id": "884f1aed57d741a7a8011e28edc20860",
    "dateModified": "2020-05-01T01:00:01+03:00"
  }
}

Завершення договору

Перед завершенням договору необхідно встановити значення поля amountPaid (незалежно від того успішний договір чи ні). Договір можна завершити переключенням у статус terminated. Виконаємо ці дії єдиним запитом:

PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 83
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "terminated",
    "amountPaid": {
      "amount": 430,
      "amountNet": 420
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "terminated",
    "changes": [
      {
        "status": "active",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "dateSigned": "2020-05-01T01:00:01+03:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2020-05-01T01:00:01+03:00",
        "id": "f3fe39d5213d4a029212ff4f1151cf40"
      }
    ],
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "de3004e5b9844707bb35405277043c7c",
        "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
        "dateModified": "2020-05-01T01:00:01+03:00"
      },
      {
        "title": "contract.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/e280bc973d5b4ce284dd152f15ae24f4?download=5311a5f7a2dc43d68092e08adad8737b",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "e280bc973d5b4ce284dd152f15ae24f4",
        "dateModified": "2020-05-01T01:00:01+03:00"
      },
      {
        "title": "contract_additional_docs.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=54f475dac20b45d0aefff43fc60f1822",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "884f1aed57d741a7a8011e28edc20860",
        "dateModified": "2020-05-01T01:00:01+03:00"
      },
      {
        "title": "contract_additional_docs.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=2562188623c64e25967736fbcc3a38d2",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2020-05-01T01:00:01+03:00",
        "id": "884f1aed57d741a7a8011e28edc20860",
        "dateModified": "2020-05-01T01:00:01+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2020-05-01T01:00:01+03:00",
      "endDate": "2020-05-31T01:00:01+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "amountNet": 430.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2020-05-01T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dateSigned": "2020-05-01T01:00:01+03:00",
    "contractID": "UA-2020-05-01-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "amountPaid": {
      "currency": "UAH",
      "amount": 430.0,
      "amountNet": 420.0,
      "valueAddedTaxIncluded": true
    },
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

Зверніть увагу, що ви можете встановлювати/змінювати значення amountPaid.amount. А значення полів amountPaid.currency і amountPaid.valueAddedTaxIncluded генеруються з поля Contract.value.

Якщо договір неуспішний, то потрібно вказати причини його припинення terminationDetails.

Після цього додання змін до договору не дозволяється.