Туторіал

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

Подивимось як працює точка входу /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/7fdaa184f29b435fad1d7bb372142d6e/agreements/6305e36dbee94cfd9dd0bab9039a9265 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": "6305e36dbee94cfd9dd0bab9039a9265",
    "agreementID": "UA-2021-03-16-000001-f37dae8cfa4445f6aa54e7c7c747028f1",
    "date": "2021-03-16T00:00:00+02:00",
    "items": [
      {
        "id": "a7cc533337f24b6cb447f0dc09bbacd4",
        "description": "футляри до державних нагород",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "quantity": 5.0,
        "relatedLot": "785a1618ca644330941dcddb347a091b",
        "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": "44617100-9"
        }
      }
    ],
    "status": "active",
    "contracts": [
      {
        "id": "1c2e73a922054dd78e5b67e112a1ea96",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "e4d81f4d34aa4e00af3a9fbd22c872f0",
        "bidID": "6589a3c89ec14718b4f9fe14391112e9",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "4af43d836c2240788d74d3d6d7d89f20",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "5a661ac88fc8473b908629ec59493459",
        "bidID": "0562c5b9accd48cabf0b89f3c89f65c7",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "c8a433dd1798496e8f7be65622ea3215",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "393acf447fd546438a38be2ab8ca0c76",
        "bidID": "f1301daefed749be8ed4010e7e78190a",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ]
  }
}

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

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

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

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "6305e36dbee94cfd9dd0bab9039a9265",
    "agreementID": "UA-2021-03-16-000001-f37dae8cfa4445f6aa54e7c7c747028f1",
    "status": "active",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker",
    "contracts": [
      {
        "id": "1c2e73a922054dd78e5b67e112a1ea96",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "e4d81f4d34aa4e00af3a9fbd22c872f0",
        "bidID": "6589a3c89ec14718b4f9fe14391112e9",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "4af43d836c2240788d74d3d6d7d89f20",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "5a661ac88fc8473b908629ec59493459",
        "bidID": "0562c5b9accd48cabf0b89f3c89f65c7",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "c8a433dd1798496e8f7be65622ea3215",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "393acf447fd546438a38be2ab8ca0c76",
        "bidID": "f1301daefed749be8ed4010e7e78190a",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ],
    "items": [
      {
        "id": "a7cc533337f24b6cb447f0dc09bbacd4",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "44617100-9"
        },
        "quantity": 5.0,
        "relatedLot": "785a1618ca644330941dcddb347a091b",
        "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": "7fdaa184f29b435fad1d7bb372142d6e",
    "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/6305e36dbee94cfd9dd0bab9039a9265/credentials?acc_token=39aaa5fe60cc4b4cbbc825411ced9250 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": "6305e36dbee94cfd9dd0bab9039a9265",
    "agreementID": "UA-2021-03-16-000001-f37dae8cfa4445f6aa54e7c7c747028f1",
    "status": "active",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker",
    "contracts": [
      {
        "id": "1c2e73a922054dd78e5b67e112a1ea96",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "e4d81f4d34aa4e00af3a9fbd22c872f0",
        "bidID": "6589a3c89ec14718b4f9fe14391112e9",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "4af43d836c2240788d74d3d6d7d89f20",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "5a661ac88fc8473b908629ec59493459",
        "bidID": "0562c5b9accd48cabf0b89f3c89f65c7",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "c8a433dd1798496e8f7be65622ea3215",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 93
            }
          }
        ],
        "awardID": "393acf447fd546438a38be2ab8ca0c76",
        "bidID": "f1301daefed749be8ed4010e7e78190a",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ],
    "items": [
      {
        "id": "a7cc533337f24b6cb447f0dc09bbacd4",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "44617100-9"
        },
        "quantity": 5.0,
        "relatedLot": "785a1618ca644330941dcddb347a091b",
        "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": "7fdaa184f29b435fad1d7bb372142d6e",
    "numberOfContracts": 3
  },
  "access": {
    "token": "9202afaa0bda4d5a8d604c4bac984417",
    "transfer": "f30c377aab134cb48bc631f6bf8633f4"
  }
}

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

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": "6305e36dbee94cfd9dd0bab9039a9265",
      "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/6305e36dbee94cfd9dd0bab9039a9265/changes?acc_token=9202afaa0bda4d5a8d604c4bac984417 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": "42b702292a4947b6b3872286c6b12996",
    "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/6305e36dbee94cfd9dd0bab9039a9265/changes/42b702292a4947b6b3872286c6b12996 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": "42b702292a4947b6b3872286c6b12996",
    "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/6305e36dbee94cfd9dd0bab9039a9265/changes/42b702292a4947b6b3872286c6b12996?acc_token=9202afaa0bda4d5a8d604c4bac984417 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": "42b702292a4947b6b3872286c6b12996",
    "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/6305e36dbee94cfd9dd0bab9039a9265/documents?acc_token=9202afaa0bda4d5a8d604c4bac984417 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/6305e36dbee94cfd9dd0bab9039a9265/documents/0f0e62d22bfb487f862147c5e6574a9f
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "0f0e62d22bfb487f862147c5e6574a9f",
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_changes.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/942027dcdf104710ae89a8b24ad17b2f?Signature=QeOTNEJAy61PDdhoPsFB05UN76DqJVhf3QNEEkUq0v3EhCCG9czKUpWuTjQWEHRe0ghB6zx8WGIW%2B9wviyqoDQ%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/6305e36dbee94cfd9dd0bab9039a9265/documents/0f0e62d22bfb487f862147c5e6574a9f?acc_token=9202afaa0bda4d5a8d604c4bac984417 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": "42b702292a4947b6b3872286c6b12996"
  }
}

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

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

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

PATCH /api/2.5/agreements/6305e36dbee94cfd9dd0bab9039a9265/changes/42b702292a4947b6b3872286c6b12996?acc_token=9202afaa0bda4d5a8d604c4bac984417 HTTP/1.0
Authorization: Bearer broker
Content-Length: 95
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "modifications": [
      {
        "itemId": "a7cc533337f24b6cb447f0dc09bbacd4",
        "factor": 0.1605
      }
    ]
  }
}

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

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

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

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

GET /api/2.5/agreements/6305e36dbee94cfd9dd0bab9039a9265/preview?acc_token=9202afaa0bda4d5a8d604c4bac984417 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": "6305e36dbee94cfd9dd0bab9039a9265",
    "agreementID": "UA-2021-03-16-000001-f37dae8cfa4445f6aa54e7c7c747028f1",
    "status": "active",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker",
    "changes": [
      {
        "id": "42b702292a4947b6b3872286c6b12996",
        "status": "pending",
        "date": "2021-03-16T00:00:00+02:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "rationale_en": "Agreement change cause",
        "rationaleType": "taxRate",
        "modifications": [
          {
            "itemId": "a7cc533337f24b6cb447f0dc09bbacd4",
            "factor": 0.1605
          }
        ]
      }
    ],
    "documents": [
      {
        "id": "0f0e62d22bfb487f862147c5e6574a9f",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_changes.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/942027dcdf104710ae89a8b24ad17b2f?Signature=QeOTNEJAy61PDdhoPsFB05UN76DqJVhf3QNEEkUq0v3EhCCG9czKUpWuTjQWEHRe0ghB6zx8WGIW%2B9wviyqoDQ%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "relatedItem": "42b702292a4947b6b3872286c6b12996",
        "documentOf": "change"
      }
    ],
    "contracts": [
      {
        "id": "1c2e73a922054dd78e5b67e112a1ea96",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "e4d81f4d34aa4e00af3a9fbd22c872f0",
        "bidID": "6589a3c89ec14718b4f9fe14391112e9",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "4af43d836c2240788d74d3d6d7d89f20",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "5a661ac88fc8473b908629ec59493459",
        "bidID": "0562c5b9accd48cabf0b89f3c89f65c7",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "c8a433dd1798496e8f7be65622ea3215",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "393acf447fd546438a38be2ab8ca0c76",
        "bidID": "f1301daefed749be8ed4010e7e78190a",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ],
    "items": [
      {
        "id": "a7cc533337f24b6cb447f0dc09bbacd4",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "44617100-9"
        },
        "quantity": 5.0,
        "relatedLot": "785a1618ca644330941dcddb347a091b",
        "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": "7fdaa184f29b435fad1d7bb372142d6e",
    "numberOfContracts": 3
  }
}

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

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

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

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

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

PATCH /api/2.5/agreements/6305e36dbee94cfd9dd0bab9039a9265/changes/42b702292a4947b6b3872286c6b12996?acc_token=9202afaa0bda4d5a8d604c4bac984417 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": "42b702292a4947b6b3872286c6b12996",
    "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": "a7cc533337f24b6cb447f0dc09bbacd4",
        "factor": 0.1605
      }
    ]
  }
}

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

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

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

GET /api/2.5/agreements/6305e36dbee94cfd9dd0bab9039a9265/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": "42b702292a4947b6b3872286c6b12996",
      "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": "a7cc533337f24b6cb447f0dc09bbacd4",
          "factor": 0.1605
        }
      ]
    }
  ]
}

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

GET /api/2.5/agreements/6305e36dbee94cfd9dd0bab9039a9265 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": "6305e36dbee94cfd9dd0bab9039a9265",
    "agreementID": "UA-2021-03-16-000001-f37dae8cfa4445f6aa54e7c7c747028f1",
    "status": "active",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker",
    "changes": [
      {
        "id": "42b702292a4947b6b3872286c6b12996",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "factor": 0.1605
          }
        ]
      }
    ],
    "documents": [
      {
        "id": "0f0e62d22bfb487f862147c5e6574a9f",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_changes.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/942027dcdf104710ae89a8b24ad17b2f?Signature=QeOTNEJAy61PDdhoPsFB05UN76DqJVhf3QNEEkUq0v3EhCCG9czKUpWuTjQWEHRe0ghB6zx8WGIW%2B9wviyqoDQ%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "relatedItem": "42b702292a4947b6b3872286c6b12996",
        "documentOf": "change"
      }
    ],
    "contracts": [
      {
        "id": "1c2e73a922054dd78e5b67e112a1ea96",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "e4d81f4d34aa4e00af3a9fbd22c872f0",
        "bidID": "6589a3c89ec14718b4f9fe14391112e9",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "4af43d836c2240788d74d3d6d7d89f20",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "5a661ac88fc8473b908629ec59493459",
        "bidID": "0562c5b9accd48cabf0b89f3c89f65c7",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "c8a433dd1798496e8f7be65622ea3215",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "393acf447fd546438a38be2ab8ca0c76",
        "bidID": "f1301daefed749be8ed4010e7e78190a",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ],
    "items": [
      {
        "id": "a7cc533337f24b6cb447f0dc09bbacd4",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "44617100-9"
        },
        "quantity": 5.0,
        "relatedLot": "785a1618ca644330941dcddb347a091b",
        "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": "7fdaa184f29b435fad1d7bb372142d6e",
    "numberOfContracts": 3
  }
}

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

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

POST /api/2.5/agreements/6305e36dbee94cfd9dd0bab9039a9265/documents?acc_token=9202afaa0bda4d5a8d604c4bac984417 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/6305e36dbee94cfd9dd0bab9039a9265/documents/b6d6203d1d7441d7a882d833cf65d99e
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "b6d6203d1d7441d7a882d833cf65d99e",
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f405a07f9bde4172a0e0aae66b334735?Signature=WzT2qvX2qAj8EpcjXb7dzmLf1DJ1ok00el6Wm7%2FhRvbgIkg0S07uRnOC6m1qhbfrmngRbrBnBtVwlbD7Ju9yCA%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/6305e36dbee94cfd9dd0bab9039a9265/documents?acc_token=9202afaa0bda4d5a8d604c4bac984417 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": "0f0e62d22bfb487f862147c5e6574a9f",
      "hash": "md5:00000000000000000000000000000000",
      "title": "agreement_changes.doc",
      "format": "application/msword",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/942027dcdf104710ae89a8b24ad17b2f?Signature=QeOTNEJAy61PDdhoPsFB05UN76DqJVhf3QNEEkUq0v3EhCCG9czKUpWuTjQWEHRe0ghB6zx8WGIW%2B9wviyqoDQ%3D%3D&KeyID=a8968c46",
      "datePublished": "2021-03-16T00:00:00+02:00",
      "dateModified": "2021-03-16T00:00:00+02:00",
      "relatedItem": "42b702292a4947b6b3872286c6b12996",
      "documentOf": "change"
    },
    {
      "id": "b6d6203d1d7441d7a882d833cf65d99e",
      "hash": "md5:00000000000000000000000000000000",
      "title": "agreement.doc",
      "format": "application/msword",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f405a07f9bde4172a0e0aae66b334735?Signature=WzT2qvX2qAj8EpcjXb7dzmLf1DJ1ok00el6Wm7%2FhRvbgIkg0S07uRnOC6m1qhbfrmngRbrBnBtVwlbD7Ju9yCA%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/6305e36dbee94cfd9dd0bab9039a9265/documents?acc_token=9202afaa0bda4d5a8d604c4bac984417 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/6305e36dbee94cfd9dd0bab9039a9265/documents/a85a83f6c640400c9c8351479b86d65c
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "a85a83f6c640400c9c8351479b86d65c",
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_additional_docs.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0e5d12d4f9e44445a5ecee831a941a60?Signature=EqP2yNjIx7vCUfWZcTLnD6Dt%2FQ1A5omJUmOsWk%2BXPpoObVJJ5ovi7LZ%2FOKJV4OjzFAL6xt5V4iyzen1CmUngBQ%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/6305e36dbee94cfd9dd0bab9039a9265/documents/a85a83f6c640400c9c8351479b86d65c?acc_token=9202afaa0bda4d5a8d604c4bac984417 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": "a85a83f6c640400c9c8351479b86d65c",
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_additional_docs.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/c7d8d9fcba46464dafd460c73945ddfc?Signature=QW3Xm4t6y64HqLl%2BVMhLFIy1jL0Kb5eJvYFq7aJIRVagziWkYyOTouCW9O5WqvNpPUDSbCJq%2Foa3HDMjEuAZCw%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/6305e36dbee94cfd9dd0bab9039a9265/documents/a85a83f6c640400c9c8351479b86d65c?acc_token=9202afaa0bda4d5a8d604c4bac984417 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": "a85a83f6c640400c9c8351479b86d65c",
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_additional_docs.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/c7d8d9fcba46464dafd460c73945ddfc?Signature=QW3Xm4t6y64HqLl%2BVMhLFIy1jL0Kb5eJvYFq7aJIRVagziWkYyOTouCW9O5WqvNpPUDSbCJq%2Foa3HDMjEuAZCw%3D%3D&KeyID=a8968c46",
    "datePublished": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "documentOf": "agreement",
    "previousVersions": [
      {
        "id": "a85a83f6c640400c9c8351479b86d65c",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0e5d12d4f9e44445a5ecee831a941a60?Signature=EqP2yNjIx7vCUfWZcTLnD6Dt%2FQ1A5omJUmOsWk%2BXPpoObVJJ5ovi7LZ%2FOKJV4OjzFAL6xt5V4iyzen1CmUngBQ%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/6305e36dbee94cfd9dd0bab9039a9265?acc_token=9202afaa0bda4d5a8d604c4bac984417 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": "6305e36dbee94cfd9dd0bab9039a9265",
    "agreementID": "UA-2021-03-16-000001-f37dae8cfa4445f6aa54e7c7c747028f1",
    "status": "terminated",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker",
    "changes": [
      {
        "id": "42b702292a4947b6b3872286c6b12996",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "factor": 0.1605
          }
        ]
      }
    ],
    "documents": [
      {
        "id": "0f0e62d22bfb487f862147c5e6574a9f",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_changes.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/942027dcdf104710ae89a8b24ad17b2f?Signature=QeOTNEJAy61PDdhoPsFB05UN76DqJVhf3QNEEkUq0v3EhCCG9czKUpWuTjQWEHRe0ghB6zx8WGIW%2B9wviyqoDQ%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "relatedItem": "42b702292a4947b6b3872286c6b12996",
        "documentOf": "change"
      },
      {
        "id": "b6d6203d1d7441d7a882d833cf65d99e",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f405a07f9bde4172a0e0aae66b334735?Signature=WzT2qvX2qAj8EpcjXb7dzmLf1DJ1ok00el6Wm7%2FhRvbgIkg0S07uRnOC6m1qhbfrmngRbrBnBtVwlbD7Ju9yCA%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "documentOf": "agreement"
      },
      {
        "id": "a85a83f6c640400c9c8351479b86d65c",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0e5d12d4f9e44445a5ecee831a941a60?Signature=EqP2yNjIx7vCUfWZcTLnD6Dt%2FQ1A5omJUmOsWk%2BXPpoObVJJ5ovi7LZ%2FOKJV4OjzFAL6xt5V4iyzen1CmUngBQ%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "documentOf": "agreement"
      },
      {
        "id": "a85a83f6c640400c9c8351479b86d65c",
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_additional_docs.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/c7d8d9fcba46464dafd460c73945ddfc?Signature=QW3Xm4t6y64HqLl%2BVMhLFIy1jL0Kb5eJvYFq7aJIRVagziWkYyOTouCW9O5WqvNpPUDSbCJq%2Foa3HDMjEuAZCw%3D%3D&KeyID=a8968c46",
        "datePublished": "2021-03-16T00:00:00+02:00",
        "dateModified": "2021-03-16T00:00:00+02:00",
        "documentOf": "agreement"
      }
    ],
    "contracts": [
      {
        "id": "1c2e73a922054dd78e5b67e112a1ea96",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "e4d81f4d34aa4e00af3a9fbd22c872f0",
        "bidID": "6589a3c89ec14718b4f9fe14391112e9",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "4af43d836c2240788d74d3d6d7d89f20",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "5a661ac88fc8473b908629ec59493459",
        "bidID": "0562c5b9accd48cabf0b89f3c89f65c7",
        "date": "2021-03-16T00:00:00+02:00"
      },
      {
        "id": "c8a433dd1798496e8f7be65622ea3215",
        "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": "a7cc533337f24b6cb447f0dc09bbacd4",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 14.93
            }
          }
        ],
        "awardID": "393acf447fd546438a38be2ab8ca0c76",
        "bidID": "f1301daefed749be8ed4010e7e78190a",
        "date": "2021-03-16T00:00:00+02:00"
      }
    ],
    "items": [
      {
        "id": "a7cc533337f24b6cb447f0dc09bbacd4",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "44617100-9"
        },
        "quantity": 5.0,
        "relatedLot": "785a1618ca644330941dcddb347a091b",
        "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": "7fdaa184f29b435fad1d7bb372142d6e",
    "numberOfContracts": 3
  }
}

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

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

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