Туторіал

Базові правила

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

GET /api/2.5/agreements 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/agreements?offset=",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements?offset="
  }
}

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

Угода автоматично переноситься з модуля тендера.

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

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

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

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

Угода в модулі тендера

GET /api/2.5/tenders/8689dc9146384e6d9697b796fad83213/agreements/1746cfba69864f7d996e4bd000858884 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": "1746cfba69864f7d996e4bd000858884",
    "agreementID": "UA-2021-03-16-000001-8053c38b861e4d27b6375ab5eb93cc1c1",
    "date": "2021-03-16T00:00:00+02:00",
    "items": [
      {
        "id": "26d1888c829a4db4b883061b2b327288",
        "description": "футляри до державних нагород",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "quantity": 5.0,
        "relatedLot": "27c4a15dce034406ba16156354632d9b",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "description_en": "Cases for state awards",
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "unit": {
          "name": "item",
          "code": "KGM"
        }
      }
    ],
    "status": "active",
    "contracts": [
      {
        "id": "ab9b0f04fe08458ab0ea443c5744cb1d",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "146d55f13a704b11b95275254e00fef4",
        "bidID": "a4aaf72182904a549e80dc4d765040a2",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "cee7f5c4218c4fd085672d17d4785c01",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "88f3ec5213a7405a92b7bd353549edb1",
        "bidID": "2269d0f299644a87bfd73ac8a065c501",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "ce463db3a53c494897d98b47064e3ad5",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "f8a353351f6449128fc5be8abba6e67f",
        "bidID": "5aa54309d515431f8edb45ca63c1d1cd",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ]
  }
}

Ідентифікатор угоди є тим самим і в модулі тендера, і в модулі угод.

Звернемося до URL-адреси створеного об’єкта в модулі угод:

GET /api/2.5/agreements/1746cfba69864f7d996e4bd000858884 HTTP/1.0
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "1746cfba69864f7d996e4bd000858884",
    "agreementID": "UA-2021-03-16-000001-8053c38b861e4d27b6375ab5eb93cc1c1",
    "status": "active",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker",
    "contracts": [
      {
        "id": "ab9b0f04fe08458ab0ea443c5744cb1d",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "146d55f13a704b11b95275254e00fef4",
        "bidID": "a4aaf72182904a549e80dc4d765040a2",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "cee7f5c4218c4fd085672d17d4785c01",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "88f3ec5213a7405a92b7bd353549edb1",
        "bidID": "2269d0f299644a87bfd73ac8a065c501",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "ce463db3a53c494897d98b47064e3ad5",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "f8a353351f6449128fc5be8abba6e67f",
        "bidID": "5aa54309d515431f8edb45ca63c1d1cd",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ],
    "items": [
      {
        "id": "26d1888c829a4db4b883061b2b327288",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "KGM"
        },
        "quantity": 5.0,
        "relatedLot": "27c4a15dce034406ba16156354632d9b",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_en": "Cases for state awards",
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "procuringEntity": {
      "name": "Державне управління справами",
      "name_en": "State administration",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName_en": "dus.gov.ua",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "kind": "general",
      "contactPoint": {
        "name": "Державне управління справами",
        "name_en": "State administration",
        "telephone": "+0440000000",
        "availableLanguage": "uk"
      }
    },
    "tender_id": "8689dc9146384e6d9697b796fad83213",
    "numberOfContracts": 3
  }
}

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

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

У PATCH: /agreements/{id}/credentials?acc_token={tender_token}:

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

Відповідь міститиме access.token для угоди, який можна використовувати для майбутнього редагування угоди.

PATCH /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/credentials?acc_token=f545d23d96fe4b00995363ba42cfe618 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": {
    "id": "1746cfba69864f7d996e4bd000858884",
    "agreementID": "UA-2021-03-16-000001-8053c38b861e4d27b6375ab5eb93cc1c1",
    "status": "active",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker",
    "contracts": [
      {
        "id": "ab9b0f04fe08458ab0ea443c5744cb1d",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "146d55f13a704b11b95275254e00fef4",
        "bidID": "a4aaf72182904a549e80dc4d765040a2",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "cee7f5c4218c4fd085672d17d4785c01",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "88f3ec5213a7405a92b7bd353549edb1",
        "bidID": "2269d0f299644a87bfd73ac8a065c501",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "ce463db3a53c494897d98b47064e3ad5",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "f8a353351f6449128fc5be8abba6e67f",
        "bidID": "5aa54309d515431f8edb45ca63c1d1cd",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ],
    "items": [
      {
        "id": "26d1888c829a4db4b883061b2b327288",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "KGM"
        },
        "quantity": 5.0,
        "relatedLot": "27c4a15dce034406ba16156354632d9b",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_en": "Cases for state awards",
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "procuringEntity": {
      "name": "Державне управління справами",
      "name_en": "State administration",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName_en": "dus.gov.ua",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "kind": "general",
      "contactPoint": {
        "name": "Державне управління справами",
        "name_en": "State administration",
        "telephone": "+0440000000",
        "availableLanguage": "uk"
      }
    },
    "tender_id": "8689dc9146384e6d9697b796fad83213",
    "numberOfContracts": 3
  },
  "access": {
    "token": "2f325f620dd24a4d8dd8c5aca839a7cc",
    "transfer": "23cd413754934cb3a562c24a42cbd4b0"
  }
}

Подивимось на угоди.

GET /api/2.5/agreements 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": "1746cfba69864f7d996e4bd000858884",
      "dateModified": "2021-03-16T00:00:00+02:00"
    }
  ],
  "next_page": {
    "offset": "2021-03-16T00:00:00+02:00",
    "path": "/api/2.5/agreements?offset=2021-03-16T00%3A00%3A00%2B02%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements?offset=2021-03-16T00%3A00%3A00%2B02%3A00"
  }
}

Бачимо внутрішні id угоди, який може бути використаний для побудови повної URL-адреси за допомогою додавання http://api-sandbox.openprocurement.org/api/0/agreements/, а також дату dateModified.

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

Основні умови договору можуть бути модифіковані поданням нових об’єктів change у контейнер Agreement.changes. Change може бути таких типів: ChangeTaxRate in cfaua, ChangeItemPriceVariation in cfaua, ChangePartyWithdrawal in cfaua або ChangeThirdParty in cfaua

Усі об’єкти changes обробляються точкою входу /agreement/{id}/changes.

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

Додамо новий change до угоди:

POST /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/changes?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc HTTP/1.0
Authorization: Bearer broker
Content-Length: 244
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "rationale": "Опис причини змін егріменту",
    "rationale_en": "Agreement change cause",
    "rationaleType": "taxRate"
  }
}

Response: 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "eb59804a712942e89f57217f6537364e",
    "status": "pending",
    "date": "2021-03-16T00:00:00+02:00",
    "rationale": "Опис причини змін егріменту",
    "rationale_en": "Agreement change cause",
    "rationaleType": "taxRate"
  }
}

Візьміть до уваги, потрібно заповнити обов’язкове поле rationaleType.

Подивимось на change:

GET /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/changes/eb59804a712942e89f57217f6537364e 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": "eb59804a712942e89f57217f6537364e",
    "status": "pending",
    "date": "2021-03-16T00:00:00+02:00",
    "rationale": "Опис причини змін егріменту",
    "rationale_en": "Agreement change cause",
    "rationaleType": "taxRate"
  }
}

Change може бути модифікований, поки об’єкт в статусі pending:

PATCH /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/changes/eb59804a712942e89f57217f6537364e?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc 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": "eb59804a712942e89f57217f6537364e",
    "status": "pending",
    "date": "2021-03-16T00:00:00+02:00",
    "rationale": "Друга і третя поставка має бути розфасована",
    "rationale_en": "Agreement change cause",
    "rationaleType": "taxRate"
  }
}

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

Документ може бути доданий тільки тоді, коли change в статусі pending.

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

  • завантажте документ
POST /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/documents?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc HTTP/1.0
Authorization: Bearer broker
Content-Length: 156
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="agreement_changes.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/1746cfba69864f7d996e4bd000858884/documents/366b4dd595b549ffae8d3896242fb0ea
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "366b4dd595b549ffae8d3896242fb0ea",
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_changes.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4cb784af37bd4d94a8d3875046842d4b?Signature=0HtxZXtlj2RHoKC6ircAx4wnTWueeXzryd2GWLGtMSs2HlkvMxofDAdRSagQqa%2FbSYKDRadpMuiHV9tTI14OCw%3D%3D&KeyID=a8968c46",
    "datePublished": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "documentOf": "agreement"
  }
}
  • налаштуйте властивості документу "documentOf": "change" і "relatedItem": "{change.id}" для того, щоб підв’язати заватажений документ до об’єкту change:
PATCH /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/documents/366b4dd595b549ffae8d3896242fb0ea?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc 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": "eb59804a712942e89f57217f6537364e"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "366b4dd595b549ffae8d3896242fb0ea",
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_changes.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4cb784af37bd4d94a8d3875046842d4b?Signature=0HtxZXtlj2RHoKC6ircAx4wnTWueeXzryd2GWLGtMSs2HlkvMxofDAdRSagQqa%2FbSYKDRadpMuiHV9tTI14OCw%3D%3D&KeyID=a8968c46",
    "datePublished": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "relatedItem": "eb59804a712942e89f57217f6537364e",
    "documentOf": "change"
  }
}

Оновлення властивостей угоди

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

PATCH /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/changes/eb59804a712942e89f57217f6537364e?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc HTTP/1.0
Authorization: Bearer broker
Content-Length: 95
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "modifications": [
      {
        "itemId": "26d1888c829a4db4b883061b2b327288",
        "factor": 0.1605
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "eb59804a712942e89f57217f6537364e",
    "status": "pending",
    "date": "2021-03-16T00:00:00+02:00",
    "rationale": "Друга і третя поставка має бути розфасована",
    "rationale_en": "Agreement change cause",
    "rationaleType": "taxRate",
    "modifications": [
      {
        "itemId": "26d1888c829a4db4b883061b2b327288",
        "factor": 0.1605
      }
    ]
  }
}

Є можливість змінювати кожен factor в modifications у випадку декількох Item.

Попередній перегляд угоди

Також, поки change в статусі pending, можна бачити угоду, оскільки зміни будуть застосовані. Необхідно використати GET: /agreements/{id}/preview?acc_token={agreement_token}.

GET /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/preview?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc 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": "1746cfba69864f7d996e4bd000858884",
    "agreementID": "UA-2021-03-16-000001-8053c38b861e4d27b6375ab5eb93cc1c1",
    "status": "active",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker",
    "changes": [
      {
        "id": "eb59804a712942e89f57217f6537364e",
        "status": "pending",
        "date": "2021-03-16T00:00:00+02:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "rationale_en": "Agreement change cause",
        "rationaleType": "taxRate",
        "modifications": [
          {
            "itemId": "26d1888c829a4db4b883061b2b327288",
            "factor": 0.1605
          }
        ]
      }
    ],
    "documents": [
      {
        "id": "366b4dd595b549ffae8d3896242fb0ea",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_changes.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4cb784af37bd4d94a8d3875046842d4b?Signature=0HtxZXtlj2RHoKC6ircAx4wnTWueeXzryd2GWLGtMSs2HlkvMxofDAdRSagQqa%2FbSYKDRadpMuiHV9tTI14OCw%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "relatedItem": "eb59804a712942e89f57217f6537364e",
        "documentOf": "change"
      }
    ],
    "contracts": [
      {
        "id": "ab9b0f04fe08458ab0ea443c5744cb1d",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "146d55f13a704b11b95275254e00fef4",
        "bidID": "a4aaf72182904a549e80dc4d765040a2",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "cee7f5c4218c4fd085672d17d4785c01",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "88f3ec5213a7405a92b7bd353549edb1",
        "bidID": "2269d0f299644a87bfd73ac8a065c501",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "ce463db3a53c494897d98b47064e3ad5",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "f8a353351f6449128fc5be8abba6e67f",
        "bidID": "5aa54309d515431f8edb45ca63c1d1cd",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ],
    "items": [
      {
        "id": "26d1888c829a4db4b883061b2b327288",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "KGM"
        },
        "quantity": 5.0,
        "relatedLot": "27c4a15dce034406ba16156354632d9b",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_en": "Cases for state awards",
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "procuringEntity": {
      "name": "Державне управління справами",
      "name_en": "State administration",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName_en": "dus.gov.ua",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "kind": "general",
      "contactPoint": {
        "name": "Державне управління справами",
        "name_en": "State administration",
        "telephone": "+0440000000",
        "availableLanguage": "uk"
      }
    },
    "tender_id": "8689dc9146384e6d9697b796fad83213",
    "numberOfContracts": 3
  }
}

Як бачимо, value.amount на unitPrices об’єкту contracts змінюється після прийняття змін. Тож, якщо ці зміни - це те, що вам потрібно, то ви можете подати об’єкт change.

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

Change може бути застосована після переходу в статус active.

Для того, щоб застосувати статус active, має бути налаштоване поле dateSigned.

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

PATCH /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/changes/eb59804a712942e89f57217f6537364e?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc 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": "2021-03-16T00:00:00+02:00"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "eb59804a712942e89f57217f6537364e",
    "status": "active",
    "date": "2021-03-16T00:00:00+02:00",
    "rationale": "Друга і третя поставка має бути розфасована",
    "rationale_en": "Agreement change cause",
    "dateSigned": "2021-03-16T00:00:00+02:00",
    "rationaleType": "taxRate",
    "modifications": [
      {
        "itemId": "26d1888c829a4db4b883061b2b327288",
        "factor": 0.1605
      }
    ]
  }
}

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

  • для першої change в угоді, дата повинна бути після agreement.dateSigned;
  • для всіх наступних об’єктів change, дата повинна бути після попередньої change.dateSigned.

Подивимось на всі зміни:

GET /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/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": "eb59804a712942e89f57217f6537364e",
      "status": "active",
      "date": "2021-03-16T00:00:00+02:00",
      "rationale": "Друга і третя поставка має бути розфасована",
      "rationale_en": "Agreement change cause",
      "dateSigned": "2021-03-16T00:00:00+02:00",
      "rationaleType": "taxRate",
      "modifications": [
        {
          "itemId": "26d1888c829a4db4b883061b2b327288",
          "factor": 0.1605
        }
      ]
    }
  ]
}

Всі зміни також перераховані у view угоди.

GET /api/2.5/agreements/1746cfba69864f7d996e4bd000858884 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": "1746cfba69864f7d996e4bd000858884",
    "agreementID": "UA-2021-03-16-000001-8053c38b861e4d27b6375ab5eb93cc1c1",
    "status": "active",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker",
    "changes": [
      {
        "id": "eb59804a712942e89f57217f6537364e",
        "status": "active",
        "date": "2021-03-16T00:00:00+02:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "rationale_en": "Agreement change cause",
        "dateSigned": "2021-03-16T00:00:00+02:00",
        "rationaleType": "taxRate",
        "modifications": [
          {
            "itemId": "26d1888c829a4db4b883061b2b327288",
            "factor": 0.1605
          }
        ]
      }
    ],
    "documents": [
      {
        "id": "366b4dd595b549ffae8d3896242fb0ea",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_changes.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4cb784af37bd4d94a8d3875046842d4b?Signature=0HtxZXtlj2RHoKC6ircAx4wnTWueeXzryd2GWLGtMSs2HlkvMxofDAdRSagQqa%2FbSYKDRadpMuiHV9tTI14OCw%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "relatedItem": "eb59804a712942e89f57217f6537364e",
        "documentOf": "change"
      }
    ],
    "contracts": [
      {
        "id": "ab9b0f04fe08458ab0ea443c5744cb1d",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "146d55f13a704b11b95275254e00fef4",
        "bidID": "a4aaf72182904a549e80dc4d765040a2",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "cee7f5c4218c4fd085672d17d4785c01",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "88f3ec5213a7405a92b7bd353549edb1",
        "bidID": "2269d0f299644a87bfd73ac8a065c501",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "ce463db3a53c494897d98b47064e3ad5",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "f8a353351f6449128fc5be8abba6e67f",
        "bidID": "5aa54309d515431f8edb45ca63c1d1cd",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ],
    "items": [
      {
        "id": "26d1888c829a4db4b883061b2b327288",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "KGM"
        },
        "quantity": 5.0,
        "relatedLot": "27c4a15dce034406ba16156354632d9b",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_en": "Cases for state awards",
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "procuringEntity": {
      "name": "Державне управління справами",
      "name_en": "State administration",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName_en": "dus.gov.ua",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "kind": "general",
      "contactPoint": {
        "name": "Державне управління справами",
        "name_en": "State administration",
        "telephone": "+0440000000",
        "availableLanguage": "uk"
      }
    },
    "tender_id": "8689dc9146384e6d9697b796fad83213",
    "numberOfContracts": 3
  }
}

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

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

POST /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/documents?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc HTTP/1.0
Authorization: Bearer broker
Content-Length: 148
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="agreement.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/1746cfba69864f7d996e4bd000858884/documents/91359234533e49c79c42142056f8fac7
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "91359234533e49c79c42142056f8fac7",
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/c6e4ee9665bc469fa4d14fcd35513942?Signature=aABQcl023w5EmJAjOj4oaIwWhz6%2BcSM49Keb1aXFhA8sjm%2BLe8mSfJYgy2g1GE3ozVL40VhGD66ZS9IjDIwkDQ%3D%3D&KeyID=a8968c46",
    "datePublished": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "documentOf": "agreement"
  }
}

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

GET /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/documents?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc 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": "366b4dd595b549ffae8d3896242fb0ea",
      "hash": "md5:00000000000000000000000000000000",
      "title": "agreement_changes.doc",
      "format": "application/msword",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4cb784af37bd4d94a8d3875046842d4b?Signature=0HtxZXtlj2RHoKC6ircAx4wnTWueeXzryd2GWLGtMSs2HlkvMxofDAdRSagQqa%2FbSYKDRadpMuiHV9tTI14OCw%3D%3D&KeyID=a8968c46",
      "datePublished": "2021-03-16T00:00:00+02:00",
      "dateModified": "2021-03-16T00:00:00+02:00",
      "relatedItem": "eb59804a712942e89f57217f6537364e",
      "documentOf": "change"
    },
    {
      "id": "91359234533e49c79c42142056f8fac7",
      "hash": "md5:00000000000000000000000000000000",
      "title": "agreement.doc",
      "format": "application/msword",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/c6e4ee9665bc469fa4d14fcd35513942?Signature=aABQcl023w5EmJAjOj4oaIwWhz6%2BcSM49Keb1aXFhA8sjm%2BLe8mSfJYgy2g1GE3ozVL40VhGD66ZS9IjDIwkDQ%3D%3D&KeyID=a8968c46",
      "datePublished": "2021-03-16T00:00:00+02:00",
      "dateModified": "2021-03-16T00:00:00+02:00",
      "documentOf": "agreement"
    }
  ]
}

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

POST /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/documents?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc HTTP/1.0
Authorization: Bearer broker
Content-Length: 172
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="agreement_additional_docs.doc"
Content-Type: application/msword

additional info
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/1746cfba69864f7d996e4bd000858884/documents/8484ad3ad2fa45b0b1581df51c719150
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "8484ad3ad2fa45b0b1581df51c719150",
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_additional_docs.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/7e1fbc7765224b379a71cf5f88dba115?Signature=Ye8FMfV32HhKpNwnk5wvVnT5wl8penAbf27iVJL5tpwRoe9ZLWon9A7WFmmTRbGayNUmWiqxcJ9mfWfQK%2BgqBg%3D%3D&KeyID=a8968c46",
    "datePublished": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "documentOf": "agreement"
  }
}

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

PUT /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/documents/8484ad3ad2fa45b0b1581df51c719150?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc HTTP/1.0
Authorization: Bearer broker
Content-Length: 181
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="agreement_additional_docs.doc"
Content-Type: application/msword

extended additional info
-----BOUNDARY--


Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "8484ad3ad2fa45b0b1581df51c719150",
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_additional_docs.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/b0c7a13efed343bab3ba9a2ef66603e3?Signature=%2FM2OwyxMcqZVIvLSaTfBLdHLqC9InW3SdBx80E0WgeZAIrS3YrR6dLPfj9lN1tUFdcV7CXGJVJ%2FZU1ICfBX4BA%3D%3D&KeyID=a8968c46",
    "datePublished": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "documentOf": "agreement"
  }
}

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

GET /api/2.5/agreements/1746cfba69864f7d996e4bd000858884/documents/8484ad3ad2fa45b0b1581df51c719150?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc 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": "8484ad3ad2fa45b0b1581df51c719150",
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_additional_docs.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/b0c7a13efed343bab3ba9a2ef66603e3?Signature=%2FM2OwyxMcqZVIvLSaTfBLdHLqC9InW3SdBx80E0WgeZAIrS3YrR6dLPfj9lN1tUFdcV7CXGJVJ%2FZU1ICfBX4BA%3D%3D&KeyID=a8968c46",
    "datePublished": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "documentOf": "agreement",
    "previousVersions": [
      {
        "id": "8484ad3ad2fa45b0b1581df51c719150",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/7e1fbc7765224b379a71cf5f88dba115?Signature=Ye8FMfV32HhKpNwnk5wvVnT5wl8penAbf27iVJL5tpwRoe9ZLWon9A7WFmmTRbGayNUmWiqxcJ9mfWfQK%2BgqBg%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "documentOf": "agreement"
      }
    ]
  }
}

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

Угода може бути завершена переходом в статус terminated. Давайте виконаємо ці дії одним запитом:

PATCH /api/2.5/agreements/1746cfba69864f7d996e4bd000858884?acc_token=2f325f620dd24a4d8dd8c5aca839a7cc HTTP/1.0
Authorization: Bearer broker
Content-Length: 34
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "terminated"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "1746cfba69864f7d996e4bd000858884",
    "agreementID": "UA-2021-03-16-000001-8053c38b861e4d27b6375ab5eb93cc1c1",
    "status": "terminated",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker",
    "changes": [
      {
        "id": "eb59804a712942e89f57217f6537364e",
        "status": "active",
        "date": "2021-03-16T00:00:00+02:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "rationale_en": "Agreement change cause",
        "dateSigned": "2021-03-16T00:00:00+02:00",
        "rationaleType": "taxRate",
        "modifications": [
          {
            "itemId": "26d1888c829a4db4b883061b2b327288",
            "factor": 0.1605
          }
        ]
      }
    ],
    "documents": [
      {
        "id": "366b4dd595b549ffae8d3896242fb0ea",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_changes.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4cb784af37bd4d94a8d3875046842d4b?Signature=0HtxZXtlj2RHoKC6ircAx4wnTWueeXzryd2GWLGtMSs2HlkvMxofDAdRSagQqa%2FbSYKDRadpMuiHV9tTI14OCw%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "relatedItem": "eb59804a712942e89f57217f6537364e",
        "documentOf": "change"
      },
      {
        "id": "91359234533e49c79c42142056f8fac7",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/c6e4ee9665bc469fa4d14fcd35513942?Signature=aABQcl023w5EmJAjOj4oaIwWhz6%2BcSM49Keb1aXFhA8sjm%2BLe8mSfJYgy2g1GE3ozVL40VhGD66ZS9IjDIwkDQ%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "documentOf": "agreement"
      },
      {
        "id": "8484ad3ad2fa45b0b1581df51c719150",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/7e1fbc7765224b379a71cf5f88dba115?Signature=Ye8FMfV32HhKpNwnk5wvVnT5wl8penAbf27iVJL5tpwRoe9ZLWon9A7WFmmTRbGayNUmWiqxcJ9mfWfQK%2BgqBg%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "documentOf": "agreement"
      },
      {
        "id": "8484ad3ad2fa45b0b1581df51c719150",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/b0c7a13efed343bab3ba9a2ef66603e3?Signature=%2FM2OwyxMcqZVIvLSaTfBLdHLqC9InW3SdBx80E0WgeZAIrS3YrR6dLPfj9lN1tUFdcV7CXGJVJ%2FZU1ICfBX4BA%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "documentOf": "agreement"
      }
    ],
    "contracts": [
      {
        "id": "ab9b0f04fe08458ab0ea443c5744cb1d",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "146d55f13a704b11b95275254e00fef4",
        "bidID": "a4aaf72182904a549e80dc4d765040a2",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "cee7f5c4218c4fd085672d17d4785c01",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "88f3ec5213a7405a92b7bd353549edb1",
        "bidID": "2269d0f299644a87bfd73ac8a065c501",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "ce463db3a53c494897d98b47064e3ad5",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "legalName_en": "dus.gov.ua",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "name_en": "State administration",
              "telephone": "+0440000000"
            },
            "scale": "micro"
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "26d1888c829a4db4b883061b2b327288",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "f8a353351f6449128fc5be8abba6e67f",
        "bidID": "5aa54309d515431f8edb45ca63c1d1cd",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ],
    "items": [
      {
        "id": "26d1888c829a4db4b883061b2b327288",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "KGM"
        },
        "quantity": 5.0,
        "relatedLot": "27c4a15dce034406ba16156354632d9b",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_en": "Cases for state awards",
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "procuringEntity": {
      "name": "Державне управління справами",
      "name_en": "State administration",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName_en": "dus.gov.ua",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "kind": "general",
      "contactPoint": {
        "name": "Державне управління справами",
        "name_en": "State administration",
        "telephone": "+0440000000",
        "availableLanguage": "uk"
      }
    },
    "tender_id": "8689dc9146384e6d9697b796fad83213",
    "numberOfContracts": 3
  }
}

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

Будь-які майбутні зміни в угоді не дозволяються.

Можливо, буде корисно побачити актуальні вимоги: Сценарії ручного тестування для III рівня акредитації і Сценарії ручного тестування для IV рівня акредитації.