Туторіал

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

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

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

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [],
  "next_page": {
    "offset": "",
    "path": "/api/2.5/contracts",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts"
  }
}

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

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

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

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

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

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

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

GET /api/2.5/tenders/59190c68cfa14b0595a6e1395c43a06b/contracts/38da025ae53f4e0d8fa4474bb5923d12 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "38da025ae53f4e0d8fa4474bb5923d12",
    "awardID": "ce59dcbd1325456cbd1d1632ef5cfb09",
    "contractID": "UA-2023-01-01-000001-a-1",
    "status": "active",
    "value": {
      "amount": 500.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 490.0
    },
    "items": [
      {
        "id": "27d065dad2f843fcaa08ce47d150ff58",
        "description": "футляри до державних нагород",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      },
      {
        "id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
        "description": "футляри до державних нагород",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "telephone": "+0440000000",
          "name": "Державне управління справами"
        },
        "scale": "micro"
      }
    ],
    "date": "2023-01-01T00:00:01+02:00",
    "dateSigned": "2023-01-01T00:00:01+02:00"
  }
}

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

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

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

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "awardID": "ce59dcbd1325456cbd1d1632ef5cfb09",
    "contractID": "UA-2023-01-01-000001-a-1",
    "dateSigned": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "dateCreated": "2023-01-01T00:00:01+02:00",
    "items": [
      {
        "id": "27d065dad2f843fcaa08ce47d150ff58",
        "description": "футляри до державних нагород",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      },
      {
        "id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
        "description": "футляри до державних нагород",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      }
    ],
    "tender_id": "59190c68cfa14b0595a6e1395c43a06b",
    "owner": "broker",
    "status": "active",
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "scale": "micro",
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        }
      }
    ],
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Державне управління справами",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "value": {
      "amount": 500.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 490.0
    },
    "id": "38da025ae53f4e0d8fa4474bb5923d12"
  }
}

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

Для того, щоб отримати права для майбутнього редагування договору, необхідно використати таку в’юшку 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/38da025ae53f4e0d8fa4474bb5923d12/credentials?acc_token=630976cee1134f91b7c0be7bd287d383 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
X-Content-Type-Options: nosniff
{
  "data": {
    "awardID": "ce59dcbd1325456cbd1d1632ef5cfb09",
    "contractID": "UA-2023-01-01-000001-a-1",
    "dateSigned": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "dateCreated": "2023-01-01T00:00:01+02:00",
    "items": [
      {
        "id": "27d065dad2f843fcaa08ce47d150ff58",
        "description": "футляри до державних нагород",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      },
      {
        "id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
        "description": "футляри до державних нагород",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      }
    ],
    "tender_id": "59190c68cfa14b0595a6e1395c43a06b",
    "owner": "broker",
    "status": "active",
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "scale": "micro",
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        }
      }
    ],
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Державне управління справами",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "value": {
      "amount": 500.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 490.0
    },
    "id": "38da025ae53f4e0d8fa4474bb5923d12"
  },
  "access": {
    "token": "a0e030a63cbe4390a164f7dee4f37dc9",
    "transfer": "153b6181be8f4e1bafe830d5f61b5c21"
  }
}

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

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
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "dateModified": "2023-01-01T00:00:01+02:00",
      "id": "38da025ae53f4e0d8fa4474bb5923d12"
    }
  ],
  "next_page": {
    "offset": 1672524001.0,
    "path": "/api/2.5/contracts?offset=1672524001.0",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=1672524001.0"
  }
}

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

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

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

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

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

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

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

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

Response: 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "9b42f245308547cc9d4f760dda1dc15c",
    "status": "pending",
    "date": "2023-01-01T00:00:01+02:00",
    "rationale": "Опис причини змін контракту",
    "rationale_en": "Contract change cause",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ]
  }
}

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

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

GET /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/changes/9b42f245308547cc9d4f760dda1dc15c HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "9b42f245308547cc9d4f760dda1dc15c",
    "status": "pending",
    "date": "2023-01-01T00:00:01+02:00",
    "rationale": "Опис причини змін контракту",
    "rationale_en": "Contract change cause",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ]
  }
}

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

PATCH /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/changes/9b42f245308547cc9d4f760dda1dc15c?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "9b42f245308547cc9d4f760dda1dc15c",
    "status": "pending",
    "date": "2023-01-01T00:00:01+02:00",
    "rationale": "Друга і третя поставка має бути розфасована",
    "rationale_en": "Contract change cause",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ]
  }
}

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

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

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

  • ви повинні завантажити документ
POST /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Content-Length: 339
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "contract_changes.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=zs%2FqPiheOiDm1x6q43ctYZNYrwUm6reLF%2F09Ls5WtBbmnb4g%2B09oOdRoLAvJAPEUPlxqg%2FR87F4bF2GB5pQnCA%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents/1c4e25349f5a4506a469810d1e65ab7a
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "1c4e25349f5a4506a469810d1e65ab7a",
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_changes.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
    "datePublished": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "documentOf": "contract"
  }
}
  • ви повинні задати властивості документа: "documentOf": "change" та "relatedItem": "{change.id}", щоб «прив’язати» завантажений документ до зміни change:
PATCH /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents/1c4e25349f5a4506a469810d1e65ab7a?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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": "9b42f245308547cc9d4f760dda1dc15c"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "1c4e25349f5a4506a469810d1e65ab7a",
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_changes.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
    "datePublished": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
    "documentOf": "change"
  }
}

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

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

Ви можете встановити нові значення для полів 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/38da025ae53f4e0d8fa4474bb5923d12?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Content-Length: 148
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "value": {
      "amount": 438,
      "amountNet": 430
    },
    "period": {
      "startDate": "2023-01-01T00:00:01+02:00",
      "endDate": "2023-01-31T00:00:01+02:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "awardID": "ce59dcbd1325456cbd1d1632ef5cfb09",
    "contractID": "UA-2023-01-01-000001-a-1",
    "period": {
      "startDate": "2023-01-01T00:00:01+02:00",
      "endDate": "2023-01-31T00:00:01+02:00"
    },
    "dateSigned": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "dateCreated": "2023-01-01T00:00:01+02:00",
    "items": [
      {
        "id": "27d065dad2f843fcaa08ce47d150ff58",
        "description": "футляри до державних нагород",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      },
      {
        "id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
        "description": "футляри до державних нагород",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      }
    ],
    "tender_id": "59190c68cfa14b0595a6e1395c43a06b",
    "owner": "broker",
    "status": "active",
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "scale": "micro",
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        }
      }
    ],
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Державне управління справами",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "changes": [
      {
        "id": "9b42f245308547cc9d4f760dda1dc15c",
        "status": "pending",
        "date": "2023-01-01T00:00:01+02:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "rationale_en": "Contract change cause",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ]
      }
    ],
    "documents": [
      {
        "id": "1c4e25349f5a4506a469810d1e65ab7a",
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_changes.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
        "datePublished": "2023-01-01T00:00:01+02:00",
        "dateModified": "2023-01-01T00:00:01+02:00",
        "relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
        "documentOf": "change"
      }
    ],
    "value": {
      "amount": 438.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 430.0
    },
    "id": "38da025ae53f4e0d8fa4474bb5923d12"
  }
}

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

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

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

  • оновити елемент (items):
PATCH /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Content-Length: 2427
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "id": "27d065dad2f843fcaa08ce47d150ff58",
        "description": "футляри до державних нагород",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "quantity": 2,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      },
      {
        "id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
        "description": "футляри до державних нагород",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "awardID": "ce59dcbd1325456cbd1d1632ef5cfb09",
    "contractID": "UA-2023-01-01-000001-a-1",
    "period": {
      "startDate": "2023-01-01T00:00:01+02:00",
      "endDate": "2023-01-31T00:00:01+02:00"
    },
    "dateSigned": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "dateCreated": "2023-01-01T00:00:01+02:00",
    "items": [
      {
        "id": "27d065dad2f843fcaa08ce47d150ff58",
        "description": "футляри до державних нагород",
        "quantity": 2.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      },
      {
        "id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
        "description": "футляри до державних нагород",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      }
    ],
    "tender_id": "59190c68cfa14b0595a6e1395c43a06b",
    "owner": "broker",
    "status": "active",
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "scale": "micro",
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        }
      }
    ],
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Державне управління справами",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "changes": [
      {
        "id": "9b42f245308547cc9d4f760dda1dc15c",
        "status": "pending",
        "date": "2023-01-01T00:00:01+02:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "rationale_en": "Contract change cause",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ]
      }
    ],
    "documents": [
      {
        "id": "1c4e25349f5a4506a469810d1e65ab7a",
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_changes.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
        "datePublished": "2023-01-01T00:00:01+02:00",
        "dateModified": "2023-01-01T00:00:01+02:00",
        "relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
        "documentOf": "change"
      }
    ],
    "value": {
      "amount": 438.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 430.0
    },
    "id": "38da025ae53f4e0d8fa4474bb5923d12"
  }
}

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

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

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

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

PATCH /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/changes/9b42f245308547cc9d4f760dda1dc15c?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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": "2023-01-01T00:00:01+02:00"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "9b42f245308547cc9d4f760dda1dc15c",
    "status": "active",
    "date": "2023-01-01T00:00:01+02:00",
    "rationale": "Друга і третя поставка має бути розфасована",
    "rationale_en": "Contract change cause",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ],
    "dateSigned": "2023-01-01T00:00:01+02:00"
  }
}

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

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

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

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

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "9b42f245308547cc9d4f760dda1dc15c",
      "status": "active",
      "date": "2023-01-01T00:00:01+02:00",
      "rationale": "Друга і третя поставка має бути розфасована",
      "rationale_en": "Contract change cause",
      "rationaleTypes": [
        "volumeCuts",
        "priceReduction"
      ],
      "dateSigned": "2023-01-01T00:00:01+02:00"
    }
  ]
}

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

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

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "awardID": "ce59dcbd1325456cbd1d1632ef5cfb09",
    "contractID": "UA-2023-01-01-000001-a-1",
    "period": {
      "startDate": "2023-01-01T00:00:01+02:00",
      "endDate": "2023-01-31T00:00:01+02:00"
    },
    "dateSigned": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "dateCreated": "2023-01-01T00:00:01+02:00",
    "items": [
      {
        "id": "27d065dad2f843fcaa08ce47d150ff58",
        "description": "футляри до державних нагород",
        "quantity": 2.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      },
      {
        "id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
        "description": "футляри до державних нагород",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      }
    ],
    "tender_id": "59190c68cfa14b0595a6e1395c43a06b",
    "owner": "broker",
    "status": "active",
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "scale": "micro",
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        }
      }
    ],
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Державне управління справами",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "changes": [
      {
        "id": "9b42f245308547cc9d4f760dda1dc15c",
        "status": "active",
        "date": "2023-01-01T00:00:01+02:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "rationale_en": "Contract change cause",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "dateSigned": "2023-01-01T00:00:01+02:00"
      }
    ],
    "documents": [
      {
        "id": "1c4e25349f5a4506a469810d1e65ab7a",
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_changes.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
        "datePublished": "2023-01-01T00:00:01+02:00",
        "dateModified": "2023-01-01T00:00:01+02:00",
        "relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
        "documentOf": "change"
      }
    ],
    "value": {
      "amount": 438.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 430.0
    },
    "id": "38da025ae53f4e0d8fa4474bb5923d12"
  }
}

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

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

POST /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Content-Length: 324
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "contract.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b559700bb5245049bdee88a6b887e04?Signature=iK5BqT8DBd6EmNJwkh%2B8qZNfPGVub8YGuJM58munUZv4jm%2FLDGxFutNvGIGQKCjXhK0SYc3KvLR0fDdWGOlIDA%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents/94cc85afb51346ab95e007a303753924
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "94cc85afb51346ab95e007a303753924",
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract.doc",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b559700bb5245049bdee88a6b887e04?Signature=V%2FKGkbsShKDpTJYKPSWbL3h72mRJO%2F6uOi8x6DX1AJxypK7%2FopQidX%2BYz%2BddFJG4BR1KqDCgwBsNe4Xz0kwgBA%3D%3D&KeyID=a8968c46",
    "datePublished": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "documentOf": "contract"
  }
}

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

GET /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "1c4e25349f5a4506a469810d1e65ab7a",
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_changes.doc",
      "format": "application/msword",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
      "datePublished": "2023-01-01T00:00:01+02:00",
      "dateModified": "2023-01-01T00:00:01+02:00",
      "relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
      "documentOf": "change"
    },
    {
      "id": "94cc85afb51346ab95e007a303753924",
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract.doc",
      "format": "application/pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b559700bb5245049bdee88a6b887e04?Signature=V%2FKGkbsShKDpTJYKPSWbL3h72mRJO%2F6uOi8x6DX1AJxypK7%2FopQidX%2BYz%2BddFJG4BR1KqDCgwBsNe4Xz0kwgBA%3D%3D&KeyID=a8968c46",
      "datePublished": "2023-01-01T00:00:01+02:00",
      "dateModified": "2023-01-01T00:00:01+02:00",
      "documentOf": "contract"
    }
  ]
}

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

POST /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Content-Length: 344
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "contract_additional_docs.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/bdd3fb01fd5543dcb7c49a037c335baf?Signature=yor3BJmbDFsR%2FF3sKWKVbFvIKRxGyk4%2Bq4%2FUYYLNax8qJSzr0JueHukHNruZ4dqs6ooC44CFb%2BIKZW86XsSjDQ%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents/1b01c96d4c284ceebf9b115101b31fa0
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "1b01c96d4c284ceebf9b115101b31fa0",
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_additional_docs.doc",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/bdd3fb01fd5543dcb7c49a037c335baf?Signature=UWVFw1k3kphG%2BaNjhh5PLf5%2B3QJiv%2FRICggmV01tLe47AT5l0xsRv%2Bn4pmBQNBQ%2BelTVOkDPRsg%2BjZlc4UQUBw%3D%3D&KeyID=a8968c46",
    "datePublished": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "documentOf": "contract"
  }
}

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

PUT /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents/1b01c96d4c284ceebf9b115101b31fa0?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Content-Length: 340
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "contract_additional_docs.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3dc187c0d95d4d9aaf3954aed82eb6fe?Signature=0P7pQiY6OJUKRXb%2FZ8d6xfKTohAvlySDm8MPE3mWp7eMxSRXKIvLYlsNrQSOvKAyk0v%2BIhGmq8bWNtJmNupBBA%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "1b01c96d4c284ceebf9b115101b31fa0",
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_additional_docs.doc",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3dc187c0d95d4d9aaf3954aed82eb6fe?Signature=hZosigHskiVw%2BVRXxgwRiq8GV8IEJk0s9GHzLWchLg4iuHpeBb2bUIvJRORVEc8CWfGyK9MN0r4fWsF2fnU1Dw%3D%3D&KeyID=a8968c46",
    "datePublished": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "documentOf": "contract"
  }
}

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

GET /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12/documents/1b01c96d4c284ceebf9b115101b31fa0?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "1b01c96d4c284ceebf9b115101b31fa0",
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_additional_docs.doc",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3dc187c0d95d4d9aaf3954aed82eb6fe?Signature=hZosigHskiVw%2BVRXxgwRiq8GV8IEJk0s9GHzLWchLg4iuHpeBb2bUIvJRORVEc8CWfGyK9MN0r4fWsF2fnU1Dw%3D%3D&KeyID=a8968c46",
    "datePublished": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "documentOf": "contract",
    "previousVersions": [
      {
        "id": "1b01c96d4c284ceebf9b115101b31fa0",
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_additional_docs.doc",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/bdd3fb01fd5543dcb7c49a037c335baf?Signature=UWVFw1k3kphG%2BaNjhh5PLf5%2B3QJiv%2FRICggmV01tLe47AT5l0xsRv%2Bn4pmBQNBQ%2BelTVOkDPRsg%2BjZlc4UQUBw%3D%3D&KeyID=a8968c46",
        "datePublished": "2023-01-01T00:00:01+02:00",
        "dateModified": "2023-01-01T00:00:01+02:00",
        "documentOf": "contract"
      }
    ]
  }
}

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

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

PATCH /api/2.5/contracts/38da025ae53f4e0d8fa4474bb5923d12?acc_token=a0e030a63cbe4390a164f7dee4f37dc9 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
X-Content-Type-Options: nosniff
{
  "data": {
    "awardID": "ce59dcbd1325456cbd1d1632ef5cfb09",
    "contractID": "UA-2023-01-01-000001-a-1",
    "period": {
      "startDate": "2023-01-01T00:00:01+02:00",
      "endDate": "2023-01-31T00:00:01+02:00"
    },
    "dateSigned": "2023-01-01T00:00:01+02:00",
    "dateModified": "2023-01-01T00:00:01+02:00",
    "dateCreated": "2023-01-01T00:00:01+02:00",
    "items": [
      {
        "id": "27d065dad2f843fcaa08ce47d150ff58",
        "description": "футляри до державних нагород",
        "quantity": 2.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      },
      {
        "id": "ebbe3cdc3877415898b85d6b8bd0e6d1",
        "description": "футляри до державних нагород",
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2023-01-03T00:00:00+02:00",
          "endDate": "2023-01-06T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      }
    ],
    "tender_id": "59190c68cfa14b0595a6e1395c43a06b",
    "owner": "broker",
    "status": "terminated",
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "scale": "micro",
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        }
      }
    ],
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Державне управління справами",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "changes": [
      {
        "id": "9b42f245308547cc9d4f760dda1dc15c",
        "status": "active",
        "date": "2023-01-01T00:00:01+02:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "rationale_en": "Contract change cause",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "dateSigned": "2023-01-01T00:00:01+02:00"
      }
    ],
    "documents": [
      {
        "id": "1c4e25349f5a4506a469810d1e65ab7a",
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_changes.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f63818a2a95e4f2ab5e07260dfe16911?Signature=AIUP5kGnx%2BOdbPRF%2B0t6WebywkPEF8BHamAxW9BXr224HyI%2BSXYFxn6QzmhVRFlpv08gR6kyoyAjzLIo6xcVAA%3D%3D&KeyID=a8968c46",
        "datePublished": "2023-01-01T00:00:01+02:00",
        "dateModified": "2023-01-01T00:00:01+02:00",
        "relatedItem": "9b42f245308547cc9d4f760dda1dc15c",
        "documentOf": "change"
      },
      {
        "id": "94cc85afb51346ab95e007a303753924",
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract.doc",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b559700bb5245049bdee88a6b887e04?Signature=V%2FKGkbsShKDpTJYKPSWbL3h72mRJO%2F6uOi8x6DX1AJxypK7%2FopQidX%2BYz%2BddFJG4BR1KqDCgwBsNe4Xz0kwgBA%3D%3D&KeyID=a8968c46",
        "datePublished": "2023-01-01T00:00:01+02:00",
        "dateModified": "2023-01-01T00:00:01+02:00",
        "documentOf": "contract"
      },
      {
        "id": "1b01c96d4c284ceebf9b115101b31fa0",
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_additional_docs.doc",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/bdd3fb01fd5543dcb7c49a037c335baf?Signature=UWVFw1k3kphG%2BaNjhh5PLf5%2B3QJiv%2FRICggmV01tLe47AT5l0xsRv%2Bn4pmBQNBQ%2BelTVOkDPRsg%2BjZlc4UQUBw%3D%3D&KeyID=a8968c46",
        "datePublished": "2023-01-01T00:00:01+02:00",
        "dateModified": "2023-01-01T00:00:01+02:00",
        "documentOf": "contract"
      },
      {
        "id": "1b01c96d4c284ceebf9b115101b31fa0",
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_additional_docs.doc",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3dc187c0d95d4d9aaf3954aed82eb6fe?Signature=hZosigHskiVw%2BVRXxgwRiq8GV8IEJk0s9GHzLWchLg4iuHpeBb2bUIvJRORVEc8CWfGyK9MN0r4fWsF2fnU1Dw%3D%3D&KeyID=a8968c46",
        "datePublished": "2023-01-01T00:00:01+02:00",
        "dateModified": "2023-01-01T00:00:01+02:00",
        "documentOf": "contract"
      }
    ],
    "amountPaid": {
      "amount": 430.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 420.0
    },
    "value": {
      "amount": 438.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 430.0
    },
    "id": "38da025ae53f4e0d8fa4474bb5923d12"
  }
}

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

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

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