Туторіал

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

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

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

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

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

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

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

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

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

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

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

GET /api/2.5/tenders/3b7af763f1e2441080bbb1c6bdb75005/agreements/eb35d61e7cde4a008003f5cd17ddb0c7 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "agreementID": "UA-2020-05-15-000001-3a5c4330ac6643cc8ed442175cc20dba1",
    "status": "active",
    "contracts": [
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f875346eda7843a3b3b9fefc28f5662c",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "103a7285c17e4a3a92938b08b51b44c7",
        "id": "edd47e59d168470e9f2ed55517c9fee1"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f552af0c653d4d6a9ece8b678225ca20",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "a5916ee001574ac2a1491c63d8c9e6d6",
        "id": "ee201e03da3140a9929ff4670a73b7de"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "8f15d54cd54a4ea2a61c9d56f0c444da",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "76208648f4a94148b4168b2d16218c72",
        "id": "cbb0e93a778548938332f1b4f6bea6f7"
      }
    ],
    "items": [
      {
        "relatedLot": "2b33a80c73cb4c39957170a963adfe52",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "description_en": "Cases for state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "id": "54eee06ff6d24b12b8e84dfe65d1b6b7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "date": "2020-05-15T01:00:00+03:00",
    "id": "eb35d61e7cde4a008003f5cd17ddb0c7"
  }
}

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

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

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "agreementID": "UA-2020-05-15-000001-3a5c4330ac6643cc8ed442175cc20dba1",
    "status": "active",
    "contracts": [
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f875346eda7843a3b3b9fefc28f5662c",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "103a7285c17e4a3a92938b08b51b44c7",
        "id": "edd47e59d168470e9f2ed55517c9fee1"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f552af0c653d4d6a9ece8b678225ca20",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "a5916ee001574ac2a1491c63d8c9e6d6",
        "id": "ee201e03da3140a9929ff4670a73b7de"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "8f15d54cd54a4ea2a61c9d56f0c444da",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "76208648f4a94148b4168b2d16218c72",
        "id": "cbb0e93a778548938332f1b4f6bea6f7"
      }
    ],
    "items": [
      {
        "relatedLot": "2b33a80c73cb4c39957170a963adfe52",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "description_en": "Cases for state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "id": "54eee06ff6d24b12b8e84dfe65d1b6b7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "id": "eb35d61e7cde4a008003f5cd17ddb0c7",
    "numberOfContracts": 3,
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "contactPoint": {
        "name_en": "State administration",
        "name": "Державне управління справами",
        "availableLanguage": "uk",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "dus.gov.ua",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name_en": "State administration"
    },
    "owner": "broker",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "tender_id": "3b7af763f1e2441080bbb1c6bdb75005"
  }
}

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

Для того, щоб отримати права для редагування угоди в майбутньому, вам потрібно виконати 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/eb35d61e7cde4a008003f5cd17ddb0c7/credentials?acc_token=113d359719654baa8660704cc68f4d21 HTTP/1.0
Authorization: Bearer broker
Content-Length: 0
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "access": {
    "transfer": "a9a0150a69cf4d248e9408dac484ea31",
    "token": "76b0c07026994e7089d5f9716acfc3e7"
  },
  "data": {
    "agreementID": "UA-2020-05-15-000001-3a5c4330ac6643cc8ed442175cc20dba1",
    "status": "active",
    "contracts": [
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f875346eda7843a3b3b9fefc28f5662c",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "103a7285c17e4a3a92938b08b51b44c7",
        "id": "edd47e59d168470e9f2ed55517c9fee1"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f552af0c653d4d6a9ece8b678225ca20",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "a5916ee001574ac2a1491c63d8c9e6d6",
        "id": "ee201e03da3140a9929ff4670a73b7de"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "8f15d54cd54a4ea2a61c9d56f0c444da",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "76208648f4a94148b4168b2d16218c72",
        "id": "cbb0e93a778548938332f1b4f6bea6f7"
      }
    ],
    "items": [
      {
        "relatedLot": "2b33a80c73cb4c39957170a963adfe52",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "description_en": "Cases for state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "id": "54eee06ff6d24b12b8e84dfe65d1b6b7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "id": "eb35d61e7cde4a008003f5cd17ddb0c7",
    "numberOfContracts": 3,
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "contactPoint": {
        "name_en": "State administration",
        "name": "Державне управління справами",
        "availableLanguage": "uk",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "dus.gov.ua",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name_en": "State administration"
    },
    "owner": "broker",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "tender_id": "3b7af763f1e2441080bbb1c6bdb75005"
  }
}

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

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; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/agreements?offset=2020-05-15T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements?offset=2020-05-15T01%3A00%3A00%2B03%3A00",
    "offset": "2020-05-15T01:00:00+03:00"
  },
  "data": [
    {
      "id": "eb35d61e7cde4a008003f5cd17ddb0c7",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

Бачимо внутрішні 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/eb35d61e7cde4a008003f5cd17ddb0c7/changes?acc_token=76b0c07026994e7089d5f9716acfc3e7 HTTP/1.0
Authorization: Bearer broker
Content-Length: 244
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "rationaleType": "taxRate",
    "rationale_en": "Agreement change cause",
    "rationale": "Опис причини змін егріменту"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "rationaleType": "taxRate",
    "rationale_en": "Agreement change cause",
    "rationale": "Опис причини змін егріменту",
    "date": "2020-05-15T01:00:00+03:00",
    "id": "5937223446a044e689f16dc9912fed8b"
  }
}

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

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

GET /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/changes/5937223446a044e689f16dc9912fed8b HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "rationaleType": "taxRate",
    "rationale_en": "Agreement change cause",
    "rationale": "Опис причини змін егріменту",
    "date": "2020-05-15T01:00:00+03:00",
    "id": "5937223446a044e689f16dc9912fed8b"
  }
}

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

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "rationaleType": "taxRate",
    "rationale_en": "Agreement change cause",
    "rationale": "Друга і третя поставка має бути розфасована",
    "date": "2020-05-15T01:00:00+03:00",
    "id": "5937223446a044e689f16dc9912fed8b"
  }
}

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

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

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

  • завантажте документ
POST /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/documents?acc_token=76b0c07026994e7089d5f9716acfc3e7 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; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/documents/b8f02cdfc2cc43c2a6a5f014d524afc6
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_changes.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a51bbc22366e41c6b012eeb99b212994?KeyID=a8968c46&Signature=6dYoov%252BfN7fg0%252BkmGHAQPvWlPvpf%2Fj1WIfx5e1YWZhoA7APSP60DFNJ5upL34Ckd3f9JCbUJrK2aR00ums%252BPAA%253D%253D",
    "format": "application/msword",
    "documentOf": "agreement",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "b8f02cdfc2cc43c2a6a5f014d524afc6",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}
  • налаштуйте властивості документу "documentOf": "change" і "relatedItem": "{change.id}" для того, щоб підв’язати заватажений документ до об’єкту change:
PATCH /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/documents/b8f02cdfc2cc43c2a6a5f014d524afc6?acc_token=76b0c07026994e7089d5f9716acfc3e7 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": "5937223446a044e689f16dc9912fed8b"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_changes.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a51bbc22366e41c6b012eeb99b212994?KeyID=a8968c46&Signature=6dYoov%252BfN7fg0%252BkmGHAQPvWlPvpf%2Fj1WIfx5e1YWZhoA7APSP60DFNJ5upL34Ckd3f9JCbUJrK2aR00ums%252BPAA%253D%253D",
    "format": "application/msword",
    "documentOf": "change",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "b8f02cdfc2cc43c2a6a5f014d524afc6",
    "relatedItem": "5937223446a044e689f16dc9912fed8b",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

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

PATCH /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/changes/5937223446a044e689f16dc9912fed8b?acc_token=76b0c07026994e7089d5f9716acfc3e7 HTTP/1.0
Authorization: Bearer broker
Content-Length: 95
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "modifications": [
      {
        "itemId": "54eee06ff6d24b12b8e84dfe65d1b6b7",
        "factor": 0.1605
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "modifications": [
      {
        "itemId": "54eee06ff6d24b12b8e84dfe65d1b6b7",
        "factor": 0.1605
      }
    ],
    "rationaleType": "taxRate",
    "rationale_en": "Agreement change cause",
    "rationale": "Друга і третя поставка має бути розфасована",
    "date": "2020-05-15T01:00:00+03:00",
    "id": "5937223446a044e689f16dc9912fed8b"
  }
}

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

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

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

GET /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/preview?acc_token=76b0c07026994e7089d5f9716acfc3e7 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "agreementID": "UA-2020-05-15-000001-3a5c4330ac6643cc8ed442175cc20dba1",
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_changes.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a51bbc22366e41c6b012eeb99b212994?KeyID=a8968c46&Signature=6dYoov%252BfN7fg0%252BkmGHAQPvWlPvpf%2Fj1WIfx5e1YWZhoA7APSP60DFNJ5upL34Ckd3f9JCbUJrK2aR00ums%252BPAA%253D%253D",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "b8f02cdfc2cc43c2a6a5f014d524afc6",
        "relatedItem": "5937223446a044e689f16dc9912fed8b",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "contracts": [
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 14.93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f875346eda7843a3b3b9fefc28f5662c",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "103a7285c17e4a3a92938b08b51b44c7",
        "id": "edd47e59d168470e9f2ed55517c9fee1"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 14.93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f552af0c653d4d6a9ece8b678225ca20",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "a5916ee001574ac2a1491c63d8c9e6d6",
        "id": "ee201e03da3140a9929ff4670a73b7de"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 14.93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "8f15d54cd54a4ea2a61c9d56f0c444da",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "76208648f4a94148b4168b2d16218c72",
        "id": "cbb0e93a778548938332f1b4f6bea6f7"
      }
    ],
    "items": [
      {
        "relatedLot": "2b33a80c73cb4c39957170a963adfe52",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "description_en": "Cases for state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "id": "54eee06ff6d24b12b8e84dfe65d1b6b7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "id": "eb35d61e7cde4a008003f5cd17ddb0c7",
    "numberOfContracts": 3,
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "contactPoint": {
        "name_en": "State administration",
        "name": "Державне управління справами",
        "availableLanguage": "uk",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "dus.gov.ua",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name_en": "State administration"
    },
    "owner": "broker",
    "changes": [
      {
        "status": "pending",
        "modifications": [
          {
            "itemId": "54eee06ff6d24b12b8e84dfe65d1b6b7",
            "factor": 0.1605
          }
        ],
        "rationaleType": "taxRate",
        "rationale_en": "Agreement change cause",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2020-05-15T01:00:00+03:00",
        "id": "5937223446a044e689f16dc9912fed8b"
      }
    ],
    "dateModified": "2020-05-15T01:00:00+03:00",
    "tender_id": "3b7af763f1e2441080bbb1c6bdb75005"
  }
}

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

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

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

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

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

PATCH /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/changes/5937223446a044e689f16dc9912fed8b?acc_token=76b0c07026994e7089d5f9716acfc3e7 HTTP/1.0
Authorization: Bearer broker
Content-Length: 73
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active",
    "dateSigned": "2020-05-15T01:00:00+03:00"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "modifications": [
      {
        "itemId": "54eee06ff6d24b12b8e84dfe65d1b6b7",
        "factor": 0.1605
      }
    ],
    "rationaleType": "taxRate",
    "rationale_en": "Agreement change cause",
    "dateSigned": "2020-05-15T01:00:00+03:00",
    "rationale": "Друга і третя поставка має бути розфасована",
    "date": "2020-05-15T01:00:00+03:00",
    "id": "5937223446a044e689f16dc9912fed8b"
  }
}

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

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

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

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "status": "active",
      "modifications": [
        {
          "itemId": "54eee06ff6d24b12b8e84dfe65d1b6b7",
          "factor": 0.1605
        }
      ],
      "rationaleType": "taxRate",
      "rationale_en": "Agreement change cause",
      "dateSigned": "2020-05-15T01:00:00+03:00",
      "rationale": "Друга і третя поставка має бути розфасована",
      "date": "2020-05-15T01:00:00+03:00",
      "id": "5937223446a044e689f16dc9912fed8b"
    }
  ]
}

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

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "agreementID": "UA-2020-05-15-000001-3a5c4330ac6643cc8ed442175cc20dba1",
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_changes.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a51bbc22366e41c6b012eeb99b212994?KeyID=a8968c46&Signature=6dYoov%252BfN7fg0%252BkmGHAQPvWlPvpf%2Fj1WIfx5e1YWZhoA7APSP60DFNJ5upL34Ckd3f9JCbUJrK2aR00ums%252BPAA%253D%253D",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "b8f02cdfc2cc43c2a6a5f014d524afc6",
        "relatedItem": "5937223446a044e689f16dc9912fed8b",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "contracts": [
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 14.93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f875346eda7843a3b3b9fefc28f5662c",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "103a7285c17e4a3a92938b08b51b44c7",
        "id": "edd47e59d168470e9f2ed55517c9fee1"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 14.93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f552af0c653d4d6a9ece8b678225ca20",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "a5916ee001574ac2a1491c63d8c9e6d6",
        "id": "ee201e03da3140a9929ff4670a73b7de"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 14.93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "8f15d54cd54a4ea2a61c9d56f0c444da",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "76208648f4a94148b4168b2d16218c72",
        "id": "cbb0e93a778548938332f1b4f6bea6f7"
      }
    ],
    "items": [
      {
        "relatedLot": "2b33a80c73cb4c39957170a963adfe52",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "description_en": "Cases for state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "id": "54eee06ff6d24b12b8e84dfe65d1b6b7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "id": "eb35d61e7cde4a008003f5cd17ddb0c7",
    "numberOfContracts": 3,
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "contactPoint": {
        "name_en": "State administration",
        "name": "Державне управління справами",
        "availableLanguage": "uk",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "dus.gov.ua",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name_en": "State administration"
    },
    "owner": "broker",
    "changes": [
      {
        "status": "active",
        "modifications": [
          {
            "itemId": "54eee06ff6d24b12b8e84dfe65d1b6b7",
            "factor": 0.1605
          }
        ],
        "rationaleType": "taxRate",
        "rationale_en": "Agreement change cause",
        "dateSigned": "2020-05-15T01:00:00+03:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2020-05-15T01:00:00+03:00",
        "id": "5937223446a044e689f16dc9912fed8b"
      }
    ],
    "dateModified": "2020-05-15T01:00:00+03:00",
    "tender_id": "3b7af763f1e2441080bbb1c6bdb75005"
  }
}

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

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

POST /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/documents?acc_token=76b0c07026994e7089d5f9716acfc3e7 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; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/documents/06b952bff38e4fc1ac0c02e300258b31
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/b9e59cc37f3b4ea482720fdcd52663fd?KeyID=a8968c46&Signature=tB3dzahvI1nyoMMK1C4j%252BTtfGcfWnAHbVpNVgsAbLzeG0c6Yxg88SXWtNpFEd88xSlrC2XmDD8u7JyxyWWu8Aw%253D%253D",
    "format": "application/msword",
    "documentOf": "agreement",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "06b952bff38e4fc1ac0c02e300258b31",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

GET /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/documents?acc_token=76b0c07026994e7089d5f9716acfc3e7 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "agreement.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/b9e59cc37f3b4ea482720fdcd52663fd?KeyID=a8968c46&Signature=tB3dzahvI1nyoMMK1C4j%252BTtfGcfWnAHbVpNVgsAbLzeG0c6Yxg88SXWtNpFEd88xSlrC2XmDD8u7JyxyWWu8Aw%253D%253D",
      "format": "application/msword",
      "documentOf": "agreement",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "06b952bff38e4fc1ac0c02e300258b31",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "agreement_changes.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a51bbc22366e41c6b012eeb99b212994?KeyID=a8968c46&Signature=6dYoov%252BfN7fg0%252BkmGHAQPvWlPvpf%2Fj1WIfx5e1YWZhoA7APSP60DFNJ5upL34Ckd3f9JCbUJrK2aR00ums%252BPAA%253D%253D",
      "format": "application/msword",
      "documentOf": "change",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "b8f02cdfc2cc43c2a6a5f014d524afc6",
      "relatedItem": "5937223446a044e689f16dc9912fed8b",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

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

POST /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/documents?acc_token=76b0c07026994e7089d5f9716acfc3e7 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; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/documents/29c3149772784d53925c9e7a92100127
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_additional_docs.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/969a6a3afa2f4ab4bb509b879677b524?KeyID=a8968c46&Signature=jlyxJA4vfD9CFkAuK7tRqSwSDowOqG93YM9JBLMijslAGYKlj1YVEVJa4Vh6ocN%252BwRaNoVS2cW1pjHMw89g3Cw%253D%253D",
    "format": "application/msword",
    "documentOf": "agreement",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "29c3149772784d53925c9e7a92100127",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

PUT /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/documents/29c3149772784d53925c9e7a92100127?acc_token=76b0c07026994e7089d5f9716acfc3e7 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; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_additional_docs.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/c07ec373bb544ebd9a72d671c047f8e2?KeyID=a8968c46&Signature=%252Bz1cAt5Xysyr6pqW5eT1tRGwShFPsqzsdvecZRqEYpp7INNmpI68BtHdNLA9M6yH9dIgAJF967e8AGr6gkE9Aw%253D%253D",
    "format": "application/msword",
    "documentOf": "agreement",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "29c3149772784d53925c9e7a92100127",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

GET /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7/documents/29c3149772784d53925c9e7a92100127?acc_token=76b0c07026994e7089d5f9716acfc3e7 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "agreement_additional_docs.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/c07ec373bb544ebd9a72d671c047f8e2?KeyID=a8968c46&Signature=%252Bz1cAt5Xysyr6pqW5eT1tRGwShFPsqzsdvecZRqEYpp7INNmpI68BtHdNLA9M6yH9dIgAJF967e8AGr6gkE9Aw%253D%253D",
    "format": "application/msword",
    "documentOf": "agreement",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "previousVersions": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_additional_docs.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/969a6a3afa2f4ab4bb509b879677b524?KeyID=a8968c46&Signature=jlyxJA4vfD9CFkAuK7tRqSwSDowOqG93YM9JBLMijslAGYKlj1YVEVJa4Vh6ocN%252BwRaNoVS2cW1pjHMw89g3Cw%253D%253D",
        "format": "application/msword",
        "documentOf": "agreement",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "29c3149772784d53925c9e7a92100127",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "id": "29c3149772784d53925c9e7a92100127",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

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

PATCH /api/2.5/agreements/eb35d61e7cde4a008003f5cd17ddb0c7?acc_token=76b0c07026994e7089d5f9716acfc3e7 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; charset=UTF-8
{
  "data": {
    "agreementID": "UA-2020-05-15-000001-3a5c4330ac6643cc8ed442175cc20dba1",
    "status": "terminated",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_changes.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a51bbc22366e41c6b012eeb99b212994?KeyID=a8968c46&Signature=6dYoov%252BfN7fg0%252BkmGHAQPvWlPvpf%2Fj1WIfx5e1YWZhoA7APSP60DFNJ5upL34Ckd3f9JCbUJrK2aR00ums%252BPAA%253D%253D",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "b8f02cdfc2cc43c2a6a5f014d524afc6",
        "relatedItem": "5937223446a044e689f16dc9912fed8b",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/b9e59cc37f3b4ea482720fdcd52663fd?KeyID=a8968c46&Signature=tB3dzahvI1nyoMMK1C4j%252BTtfGcfWnAHbVpNVgsAbLzeG0c6Yxg88SXWtNpFEd88xSlrC2XmDD8u7JyxyWWu8Aw%253D%253D",
        "format": "application/msword",
        "documentOf": "agreement",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "06b952bff38e4fc1ac0c02e300258b31",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_additional_docs.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/969a6a3afa2f4ab4bb509b879677b524?KeyID=a8968c46&Signature=jlyxJA4vfD9CFkAuK7tRqSwSDowOqG93YM9JBLMijslAGYKlj1YVEVJa4Vh6ocN%252BwRaNoVS2cW1pjHMw89g3Cw%253D%253D",
        "format": "application/msword",
        "documentOf": "agreement",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "29c3149772784d53925c9e7a92100127",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "agreement_additional_docs.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/c07ec373bb544ebd9a72d671c047f8e2?KeyID=a8968c46&Signature=%252Bz1cAt5Xysyr6pqW5eT1tRGwShFPsqzsdvecZRqEYpp7INNmpI68BtHdNLA9M6yH9dIgAJF967e8AGr6gkE9Aw%253D%253D",
        "format": "application/msword",
        "documentOf": "agreement",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "29c3149772784d53925c9e7a92100127",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "contracts": [
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 14.93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f875346eda7843a3b3b9fefc28f5662c",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "103a7285c17e4a3a92938b08b51b44c7",
        "id": "edd47e59d168470e9f2ed55517c9fee1"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 14.93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "f552af0c653d4d6a9ece8b678225ca20",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "a5916ee001574ac2a1491c63d8c9e6d6",
        "id": "ee201e03da3140a9929ff4670a73b7de"
      },
      {
        "status": "active",
        "unitPrices": [
          {
            "value": {
              "currency": "UAH",
              "amount": 14.93,
              "valueAddedTaxIncluded": true
            },
            "relatedItem": "54eee06ff6d24b12b8e84dfe65d1b6b7"
          }
        ],
        "suppliers": [
          {
            "scale": "micro",
            "name": "Державне управління справами",
            "address": {
              "postalCode": "01220",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "name_en": "State administration",
            "identifier": {
              "scheme": "UA-EDR",
              "legalName_en": "dus.gov.ua",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "contactPoint": {
              "name_en": "State administration",
              "name": "Державне управління справами",
              "telephone": "0440000000"
            }
          }
        ],
        "bidID": "8f15d54cd54a4ea2a61c9d56f0c444da",
        "date": "2020-05-15T01:00:00+03:00",
        "awardID": "76208648f4a94148b4168b2d16218c72",
        "id": "cbb0e93a778548938332f1b4f6bea6f7"
      }
    ],
    "items": [
      {
        "relatedLot": "2b33a80c73cb4c39957170a963adfe52",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "description_en": "Cases for state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2018-06-27T13:39:09.362837+03:00",
          "endDate": "2018-06-30T13:39:09.362837+03:00"
        },
        "id": "54eee06ff6d24b12b8e84dfe65d1b6b7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "id": "eb35d61e7cde4a008003f5cd17ddb0c7",
    "numberOfContracts": 3,
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "contactPoint": {
        "name_en": "State administration",
        "name": "Державне управління справами",
        "availableLanguage": "uk",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "dus.gov.ua",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name_en": "State administration"
    },
    "owner": "broker",
    "changes": [
      {
        "status": "active",
        "modifications": [
          {
            "itemId": "54eee06ff6d24b12b8e84dfe65d1b6b7",
            "factor": 0.1605
          }
        ],
        "rationaleType": "taxRate",
        "rationale_en": "Agreement change cause",
        "dateSigned": "2020-05-15T01:00:00+03:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2020-05-15T01:00:00+03:00",
        "id": "5937223446a044e689f16dc9912fed8b"
      }
    ],
    "dateModified": "2020-05-15T01:00:00+03:00",
    "tender_id": "3b7af763f1e2441080bbb1c6bdb75005"
  }
}

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

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

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