Туторіал

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

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

GET /api/2.3/contracts HTTP/1.0
Host: api-sandbox.openprocurement.org

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

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

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

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

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

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

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

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

GET /api/2.3/tenders/7dc086c4a213492ab9c43b95b43bd817/contracts/bebdbaf7777d4bd39756f3e8872c1f46 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "f8a311c2c9a34ff08bdf59bbc8092348",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      },
      {
        "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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "c008a4d57c584dafa187ea72647e3cb7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "name": "Державне управління справами",
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-06-21T17:53:04.594612+03:00",
    "date": "2017-06-21T17:53:04.600513+03:00",
    "awardID": "2f549474497c475b8023d51845cbb2bd",
    "id": "bebdbaf7777d4bd39756f3e8872c1f46",
    "contractID": "UA-2017-06-21-000001-1"
  }
}

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

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

GET /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46 HTTP/1.0
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "f8a311c2c9a34ff08bdf59bbc8092348",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      },
      {
        "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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "c008a4d57c584dafa187ea72647e3cb7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "name": "Державне управління справами",
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "dateSigned": "2017-06-21T17:53:04.594612+03:00",
    "dateModified": "2017-06-21T17:53:04.877904+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": "м. Київ"
      }
    },
    "contractID": "UA-2017-06-21-000001-1",
    "owner": "broker",
    "awardID": "2f549474497c475b8023d51845cbb2bd",
    "id": "bebdbaf7777d4bd39756f3e8872c1f46",
    "tender_id": "7dc086c4a213492ab9c43b95b43bd817"
  }
}

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

Для того, щоб отримати права для майбутнього редагування договору, необхідно використати таку в’юшку 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.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/credentials?acc_token=7d16511a9bb949ad9df35d12de325162 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 0
Content-Type: application/json
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "access": {
    "token": "2f1294ae618e49219d85607d17afabf6"
  },
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "f8a311c2c9a34ff08bdf59bbc8092348",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      },
      {
        "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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "c008a4d57c584dafa187ea72647e3cb7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "name": "Державне управління справами",
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "dateSigned": "2017-06-21T17:53:04.594612+03:00",
    "dateModified": "2017-06-21T17:53:04.954121+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": "м. Київ"
      }
    },
    "contractID": "UA-2017-06-21-000001-1",
    "owner": "broker",
    "awardID": "2f549474497c475b8023d51845cbb2bd",
    "id": "bebdbaf7777d4bd39756f3e8872c1f46",
    "tender_id": "7dc086c4a213492ab9c43b95b43bd817"
  }
}

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

GET /api/2.3/contracts HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.3/contracts?offset=2017-06-21T17%3A53%3A04.954121%2B03%3A00",
    "uri": "http://api-sandbox.openprocurement.org/api/2.3/contracts?offset=2017-06-21T17%3A53%3A04.954121%2B03%3A00",
    "offset": "2017-06-21T17:53:04.954121+03:00"
  },
  "data": [
    {
      "id": "bebdbaf7777d4bd39756f3e8872c1f46",
      "dateModified": "2017-06-21T17:53:04.954121+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.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/changes?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 267
Content-Type: application/json
Host: api-sandbox.openprocurement.org
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": "2017-06-21T17:53:05.109702+03:00",
    "id": "c382f2a7da3647bbb4e8fea2af514157"
  }
}

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

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

GET /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/changes/c382f2a7da3647bbb4e8fea2af514157 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

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

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

PATCH /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/changes/c382f2a7da3647bbb4e8fea2af514157?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 255
Content-Type: application/json
Host: api-sandbox.openprocurement.org
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": "2017-06-21T17:53:05.109702+03:00",
    "id": "c382f2a7da3647bbb4e8fea2af514157"
  }
}

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

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

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

  • ви повинні завантажити документ

POST /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 199
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy995442828706$
Host: api-sandbox.openprocurement.org

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/853ad85f888c403eb64b3db2ce16fed7
{
  "data": {
    "title": "contract_changes.doc",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/853ad85f888c403eb64b3db2ce16fed7?download=6b9d115c4fa94edb8d1f07615ed5b85c",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2017-06-21T17:53:05.477533+03:00",
    "id": "853ad85f888c403eb64b3db2ce16fed7",
    "dateModified": "2017-06-21T17:53:05.477575+03:00"
  }
}
  • ви повинні задати властивості документа: "documentOf": "change" та "relatedItem": "{change.id}", щоб “прив’язати” завантажений документ до зміни change:

PATCH /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/853ad85f888c403eb64b3db2ce16fed7?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 85
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "documentOf": "change",
    "relatedItem": "c382f2a7da3647bbb4e8fea2af514157"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "title": "contract_changes.doc",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/853ad85f888c403eb64b3db2ce16fed7?download=6b9d115c4fa94edb8d1f07615ed5b85c",
    "format": "application/msword",
    "documentOf": "change",
    "datePublished": "2017-06-21T17:53:05.477533+03:00",
    "id": "853ad85f888c403eb64b3db2ce16fed7",
    "relatedItem": "c382f2a7da3647bbb4e8fea2af514157",
    "dateModified": "2017-06-21T17:53:05.477575+03:00"
  }
}

Оновлення властивостей зміни

Тепер ви можете оновити властивості договору, що стосуються зміни.

PATCH /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 144
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "period": {
      "startDate": "2017-06-21T17:53:05.582663+03:00",
      "endDate": "2017-07-21T17:53:05.582718+03:00"
    },
    "value": {
      "amount": 438
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "valueAddedTaxIncluded": true
    },
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/853ad85f888c403eb64b3db2ce16fed7?download=6b9d115c4fa94edb8d1f07615ed5b85c",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2017-06-21T17:53:05.477533+03:00",
        "id": "853ad85f888c403eb64b3db2ce16fed7",
        "relatedItem": "c382f2a7da3647bbb4e8fea2af514157",
        "dateModified": "2017-06-21T17:53:05.477575+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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "f8a311c2c9a34ff08bdf59bbc8092348",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      },
      {
        "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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "c008a4d57c584dafa187ea72647e3cb7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "name": "Державне управління справами",
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2017-06-21T17:53:05.582663+03:00",
      "endDate": "2017-07-21T17:53:05.582718+03:00"
    },
    "dateSigned": "2017-06-21T17:53:04.594612+03:00",
    "id": "bebdbaf7777d4bd39756f3e8872c1f46",
    "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": "м. Київ"
      }
    },
    "contractID": "UA-2017-06-21-000001-1",
    "owner": "broker",
    "awardID": "2f549474497c475b8023d51845cbb2bd",
    "changes": [
      {
        "status": "pending",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2017-06-21T17:53:05.109702+03:00",
        "id": "c382f2a7da3647bbb4e8fea2af514157"
      }
    ],
    "dateModified": "2017-06-21T17:53:05.673576+03:00",
    "tender_id": "7dc086c4a213492ab9c43b95b43bd817"
  }
}

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

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

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

  • оновити елемент (items):

PATCH /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 42
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "items": [
      {
        "quantity": 2
      },
      {}
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "valueAddedTaxIncluded": true
    },
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/853ad85f888c403eb64b3db2ce16fed7?download=6b9d115c4fa94edb8d1f07615ed5b85c",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2017-06-21T17:53:05.477533+03:00",
        "id": "853ad85f888c403eb64b3db2ce16fed7",
        "relatedItem": "c382f2a7da3647bbb4e8fea2af514157",
        "dateModified": "2017-06-21T17:53:05.477575+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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "f8a311c2c9a34ff08bdf59bbc8092348",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2
      },
      {
        "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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "c008a4d57c584dafa187ea72647e3cb7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "name": "Державне управління справами",
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2017-06-21T17:53:05.582663+03:00",
      "endDate": "2017-07-21T17:53:05.582718+03:00"
    },
    "dateSigned": "2017-06-21T17:53:04.594612+03:00",
    "id": "bebdbaf7777d4bd39756f3e8872c1f46",
    "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": "м. Київ"
      }
    },
    "contractID": "UA-2017-06-21-000001-1",
    "owner": "broker",
    "awardID": "2f549474497c475b8023d51845cbb2bd",
    "changes": [
      {
        "status": "pending",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2017-06-21T17:53:05.109702+03:00",
        "id": "c382f2a7da3647bbb4e8fea2af514157"
      }
    ],
    "dateModified": "2017-06-21T17:53:05.807714+03:00",
    "tender_id": "7dc086c4a213492ab9c43b95b43bd817"
  }
}
  • видалити елемент (items):

Request example for cases when contract has several items:

PATCH /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1160
Content-Type: application/json
Host: api-sandbox.openprocurement.org
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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "f8a311c2c9a34ff08bdf59bbc8092348",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "valueAddedTaxIncluded": true
    },
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/853ad85f888c403eb64b3db2ce16fed7?download=6b9d115c4fa94edb8d1f07615ed5b85c",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2017-06-21T17:53:05.477533+03:00",
        "id": "853ad85f888c403eb64b3db2ce16fed7",
        "relatedItem": "c382f2a7da3647bbb4e8fea2af514157",
        "dateModified": "2017-06-21T17:53:05.477575+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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "f8a311c2c9a34ff08bdf59bbc8092348",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "name": "Державне управління справами",
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2017-06-21T17:53:05.582663+03:00",
      "endDate": "2017-07-21T17:53:05.582718+03:00"
    },
    "dateSigned": "2017-06-21T17:53:04.594612+03:00",
    "id": "bebdbaf7777d4bd39756f3e8872c1f46",
    "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": "м. Київ"
      }
    },
    "contractID": "UA-2017-06-21-000001-1",
    "owner": "broker",
    "awardID": "2f549474497c475b8023d51845cbb2bd",
    "changes": [
      {
        "status": "pending",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2017-06-21T17:53:05.109702+03:00",
        "id": "c382f2a7da3647bbb4e8fea2af514157"
      }
    ],
    "dateModified": "2017-06-21T17:53:05.942313+03:00",
    "tender_id": "7dc086c4a213492ab9c43b95b43bd817"
  }
}

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

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

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

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

PATCH /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/changes/c382f2a7da3647bbb4e8fea2af514157?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 80
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "active",
    "dateSigned": "2017-06-21T17:53:05.978602+03:00"
  }
}

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

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

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

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

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

GET /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/changes HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

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

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

GET /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "valueAddedTaxIncluded": true
    },
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/853ad85f888c403eb64b3db2ce16fed7?download=6b9d115c4fa94edb8d1f07615ed5b85c",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2017-06-21T17:53:05.477533+03:00",
        "id": "853ad85f888c403eb64b3db2ce16fed7",
        "relatedItem": "c382f2a7da3647bbb4e8fea2af514157",
        "dateModified": "2017-06-21T17:53:05.477575+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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "f8a311c2c9a34ff08bdf59bbc8092348",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "name": "Державне управління справами",
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2017-06-21T17:53:05.582663+03:00",
      "endDate": "2017-07-21T17:53:05.582718+03:00"
    },
    "dateSigned": "2017-06-21T17:53:04.594612+03:00",
    "id": "bebdbaf7777d4bd39756f3e8872c1f46",
    "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": "м. Київ"
      }
    },
    "contractID": "UA-2017-06-21-000001-1",
    "owner": "broker",
    "awardID": "2f549474497c475b8023d51845cbb2bd",
    "changes": [
      {
        "status": "active",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "dateSigned": "2017-06-21T17:53:05.978602+03:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2017-06-21T17:53:06.002992+03:00",
        "id": "c382f2a7da3647bbb4e8fea2af514157"
      }
    ],
    "dateModified": "2017-06-21T17:53:06.006808+03:00",
    "tender_id": "7dc086c4a213492ab9c43b95b43bd817"
  }
}

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

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

POST /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 191
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy679645668448$
Host: api-sandbox.openprocurement.org

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/398c861329694c5fb8aad22169159606
{
  "data": {
    "title": "contract.doc",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/398c861329694c5fb8aad22169159606?download=a0d8357d8aca4a81aafce6912df0a6f7",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2017-06-21T17:53:06.124541+03:00",
    "id": "398c861329694c5fb8aad22169159606",
    "dateModified": "2017-06-21T17:53:06.124581+03:00"
  }
}

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

GET /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "contract_changes.doc",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/853ad85f888c403eb64b3db2ce16fed7?download=6b9d115c4fa94edb8d1f07615ed5b85c",
      "format": "application/msword",
      "documentOf": "change",
      "datePublished": "2017-06-21T17:53:05.477533+03:00",
      "id": "853ad85f888c403eb64b3db2ce16fed7",
      "relatedItem": "c382f2a7da3647bbb4e8fea2af514157",
      "dateModified": "2017-06-21T17:53:05.477575+03:00"
    },
    {
      "title": "contract.doc",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/398c861329694c5fb8aad22169159606?download=a0d8357d8aca4a81aafce6912df0a6f7",
      "format": "application/msword",
      "documentOf": "contract",
      "datePublished": "2017-06-21T17:53:06.124541+03:00",
      "id": "398c861329694c5fb8aad22169159606",
      "dateModified": "2017-06-21T17:53:06.124581+03:00"
    }
  ]
}

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

POST /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 215
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy730885500672$
Host: api-sandbox.openprocurement.org

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/167427d8f0ed431784f1a9b7dafe91b1
{
  "data": {
    "title": "contract_additional_docs.doc",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/167427d8f0ed431784f1a9b7dafe91b1?download=e071206d6e464a2590fa505a5ba91c3d",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2017-06-21T17:53:06.232704+03:00",
    "id": "167427d8f0ed431784f1a9b7dafe91b1",
    "dateModified": "2017-06-21T17:53:06.232747+03:00"
  }
}

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

PUT /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/167427d8f0ed431784f1a9b7dafe91b1?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 226
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy0158879343206$
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "title": "contract_additional_docs.doc",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/167427d8f0ed431784f1a9b7dafe91b1?download=f9f4d77eb7fb4dfba28f96e89993e75e",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2017-06-21T17:53:06.232704+03:00",
    "id": "167427d8f0ed431784f1a9b7dafe91b1",
    "dateModified": "2017-06-21T17:53:06.301704+03:00"
  }
}

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

GET /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/167427d8f0ed431784f1a9b7dafe91b1?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "title": "contract_additional_docs.doc",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/167427d8f0ed431784f1a9b7dafe91b1?download=f9f4d77eb7fb4dfba28f96e89993e75e",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2017-06-21T17:53:06.232704+03:00",
    "previousVersions": [
      {
        "title": "contract_additional_docs.doc",
        "url": "/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/167427d8f0ed431784f1a9b7dafe91b1?download=e071206d6e464a2590fa505a5ba91c3d",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2017-06-21T17:53:06.232704+03:00",
        "id": "167427d8f0ed431784f1a9b7dafe91b1",
        "dateModified": "2017-06-21T17:53:06.232747+03:00"
      }
    ],
    "id": "167427d8f0ed431784f1a9b7dafe91b1",
    "dateModified": "2017-06-21T17:53:06.301704+03:00"
  }
}

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

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

PATCH /api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46?acc_token=2f1294ae618e49219d85607d17afabf6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 65
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "terminated",
    "amountPaid": {
      "amount": 430
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "terminated",
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "valueAddedTaxIncluded": true
    },
    "changes": [
      {
        "status": "active",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "dateSigned": "2017-06-21T17:53:05.978602+03:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2017-06-21T17:53:06.002992+03:00",
        "id": "c382f2a7da3647bbb4e8fea2af514157"
      }
    ],
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/853ad85f888c403eb64b3db2ce16fed7?download=6b9d115c4fa94edb8d1f07615ed5b85c",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2017-06-21T17:53:05.477533+03:00",
        "id": "853ad85f888c403eb64b3db2ce16fed7",
        "relatedItem": "c382f2a7da3647bbb4e8fea2af514157",
        "dateModified": "2017-06-21T17:53:05.477575+03:00"
      },
      {
        "title": "contract.doc",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/398c861329694c5fb8aad22169159606?download=a0d8357d8aca4a81aafce6912df0a6f7",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2017-06-21T17:53:06.124541+03:00",
        "id": "398c861329694c5fb8aad22169159606",
        "dateModified": "2017-06-21T17:53:06.124581+03:00"
      },
      {
        "title": "contract_additional_docs.doc",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/167427d8f0ed431784f1a9b7dafe91b1?download=e071206d6e464a2590fa505a5ba91c3d",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2017-06-21T17:53:06.232704+03:00",
        "id": "167427d8f0ed431784f1a9b7dafe91b1",
        "dateModified": "2017-06-21T17:53:06.232747+03:00"
      },
      {
        "title": "contract_additional_docs.doc",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/contracts/bebdbaf7777d4bd39756f3e8872c1f46/documents/167427d8f0ed431784f1a9b7dafe91b1?download=f9f4d77eb7fb4dfba28f96e89993e75e",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2017-06-21T17:53:06.232704+03:00",
        "id": "167427d8f0ed431784f1a9b7dafe91b1",
        "dateModified": "2017-06-21T17:53:06.301704+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": "2017-06-23T17:53:02.070092+03:00",
          "endDate": "2017-06-26T17:53:02.070092+03:00"
        },
        "id": "f8a311c2c9a34ff08bdf59bbc8092348",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "name": "Державне управління справами",
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2017-06-21T17:53:05.582663+03:00",
      "endDate": "2017-07-21T17:53:05.582718+03:00"
    },
    "dateSigned": "2017-06-21T17:53:04.594612+03:00",
    "id": "bebdbaf7777d4bd39756f3e8872c1f46",
    "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": "м. Київ"
      }
    },
    "contractID": "UA-2017-06-21-000001-1",
    "owner": "broker",
    "awardID": "2f549474497c475b8023d51845cbb2bd",
    "amountPaid": {
      "currency": "UAH",
      "amount": 430.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2017-06-21T17:53:06.561834+03:00",
    "tender_id": "7dc086c4a213492ab9c43b95b43bd817"
  }
}

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

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

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