Приклад для угоди

Зміна власника угоди

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

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

Спочатку отримаємо доступ до угоди:

PATCH /api/2.5/agreements/5f2c362583984e0daed42cb21777cee3/credentials?acc_token=66c2955323508410df20289d70d5a479b575f6a04753c0345c58d2ea246cebb8223b7085ab9577fcd74d553eb4e997da9cf761aa0387348f3bdc98d8eeae60cf HTTP/1.0
Authorization: Bearer broker
Content-Length: 12
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": ""
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "5f2c362583984e0daed42cb21777cee3",
    "agreementID": "UA-2018-07-30-000001-afe4b1ed046845bcae5d675b0b8ca5aa1",
    "status": "active",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker",
    "dateSigned": "2021-03-16T00:00:00+02:00",
    "contracts": [
      {
        "id": "d6cd8c3188d74e1481a9cebb57fd9329",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "telephone": "+0440000000"
            }
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 100.0
            }
          }
        ],
        "awardID": "d7406b07c05b4796bb168a7c47ee7d31",
        "bidID": "0a292b6466274139ad3d973fd64830ff",
        "date": "2018-07-30T17:40:15.471158+03:00"
      },
      {
        "id": "c8ef8c0d1cb74528b13335a623225762",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "telephone": "+0440000000"
            }
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 100.0
            }
          }
        ],
        "awardID": "cdb6da320600480d8eaabd8eaa920872",
        "bidID": "d85ef51272f14087abb2eed535340493",
        "date": "2018-07-30T17:40:15.471207+03:00"
      },
      {
        "id": "d925d6c6124447d581f2ae5f52ba710f",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "telephone": "+0440000000"
            }
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 100.0
            }
          }
        ],
        "awardID": "a915a07f7f0b4dafa583cce119bf1823",
        "bidID": "fc02090c338a477f8013156a4fa2da10",
        "date": "2018-07-30T17:40:15.471264+03:00"
      }
    ],
    "items": [
      {
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "KGM"
        },
        "quantity": 5.0,
        "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": "f394ae7a792e404c96103b00547a61d5",
    "numberOfContracts": 3
  },
  "access": {
    "token": "3d0d23b0a5034f3a86bbcec53e5c93e0",
    "transfer": "ee024235f2254c22997aceee23a8fbb3"
  }
}

Майданчик broker є поточним власником owner угоди.

Зверніть увагу, що секція відповіді access містить ключ transfer, який використовується для зміни власника угоди.

Після отрімання доступу до угоди майданчик повинен довести ключ transfer до відома клієнта.

Ініціація зміни власника

Перш за все, необхідно знати ID угоди, власника якого ви хочете змінити.

Майданчик, що стане новим власником угоди, повинен створити об’єкт Transfer.

POST /api/2.5/transfers HTTP/1.0
Authorization: Bearer broker3
Content-Length: 12
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {}
}

Response: 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "date": "2021-03-16T00:00:00+02:00",
    "id": "6db42685af9a45eda91d17077009fee7"
  },
  "access": {
    "token": "cece5928fe0f4a3ba06b1ecb8363d458",
    "transfer": "e3aaf90ea5ed4587ab02bee1fd15a68c"
  }
}

Об’єкт Transfer містить новий ключ доступу token та новий ключ transfer для об’єкта, власник якого буде змінений.

Зміна власника угоди

Можливість зміни власника угоди залежить від статусу угоди:

Дозволено Не дозволено
active

pending

terminated

Щоб змінити власника угоди новий майданчик повинен надіслати POST запит на відповідний /agreements/id/ з секцією data, що міститиме ідентифікатор id для Transfer та ключ transfer отриманий від клієнта:

POST /api/2.5/agreements/5f2c362583984e0daed42cb21777cee3/ownership HTTP/1.0
Authorization: Bearer broker3
Content-Length: 100
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "id": "6db42685af9a45eda91d17077009fee7",
    "transfer": "ee024235f2254c22997aceee23a8fbb3"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "5f2c362583984e0daed42cb21777cee3",
    "agreementID": "UA-2018-07-30-000001-afe4b1ed046845bcae5d675b0b8ca5aa1",
    "status": "active",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker3",
    "dateSigned": "2021-03-16T00:00:00+02:00",
    "contracts": [
      {
        "id": "d6cd8c3188d74e1481a9cebb57fd9329",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "telephone": "+0440000000"
            }
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 100.0
            }
          }
        ],
        "awardID": "d7406b07c05b4796bb168a7c47ee7d31",
        "bidID": "0a292b6466274139ad3d973fd64830ff",
        "date": "2018-07-30T17:40:15.471158+03:00"
      },
      {
        "id": "c8ef8c0d1cb74528b13335a623225762",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "telephone": "+0440000000"
            }
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 100.0
            }
          }
        ],
        "awardID": "cdb6da320600480d8eaabd8eaa920872",
        "bidID": "d85ef51272f14087abb2eed535340493",
        "date": "2018-07-30T17:40:15.471207+03:00"
      },
      {
        "id": "d925d6c6124447d581f2ae5f52ba710f",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "telephone": "+0440000000"
            }
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 100.0
            }
          }
        ],
        "awardID": "a915a07f7f0b4dafa583cce119bf1823",
        "bidID": "fc02090c338a477f8013156a4fa2da10",
        "date": "2018-07-30T17:40:15.471264+03:00"
      }
    ],
    "items": [
      {
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "KGM"
        },
        "quantity": 5.0,
        "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": "f394ae7a792e404c96103b00547a61d5",
    "numberOfContracts": 3
  }
}

Оновлене значення властивості owner вказує, що власник був успішно змінений.

Зверніть увагу, що новий майданчик повинен довести до відома клієнта новий ключ transfer (згенерований в об’єкті Transfer).

Можна перевірити чи після застосування об’єкта Transfer шлях до угоди зберігається у властивості usedFor.

GET /api/2.5/transfers/6db42685af9a45eda91d17077009fee7 HTTP/1.0
Authorization: Bearer broker3
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "date": "2021-03-16T00:00:00+02:00",
    "usedFor": "/agreements/5f2c362583984e0daed42cb21777cee3",
    "id": "6db42685af9a45eda91d17077009fee7"
  }
}

Спробуємо змінити угоду за допомогою ключа token, отриманого при створенні об’єкта Transfer.

PATCH /api/2.5/agreements/5f2c362583984e0daed42cb21777cee3?acc_token=cece5928fe0f4a3ba06b1ecb8363d458 HTTP/1.0
Authorization: Bearer broker3
Content-Length: 71
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "terminationDetails": "broker3 now can change the contract"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "5f2c362583984e0daed42cb21777cee3",
    "agreementID": "UA-2018-07-30-000001-afe4b1ed046845bcae5d675b0b8ca5aa1",
    "status": "active",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "owner": "broker3",
    "dateSigned": "2021-03-16T00:00:00+02:00",
    "contracts": [
      {
        "id": "d6cd8c3188d74e1481a9cebb57fd9329",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "telephone": "+0440000000"
            }
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 100.0
            }
          }
        ],
        "awardID": "d7406b07c05b4796bb168a7c47ee7d31",
        "bidID": "0a292b6466274139ad3d973fd64830ff",
        "date": "2018-07-30T17:40:15.471158+03:00"
      },
      {
        "id": "c8ef8c0d1cb74528b13335a623225762",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "telephone": "+0440000000"
            }
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 100.0
            }
          }
        ],
        "awardID": "cdb6da320600480d8eaabd8eaa920872",
        "bidID": "d85ef51272f14087abb2eed535340493",
        "date": "2018-07-30T17:40:15.471207+03:00"
      },
      {
        "id": "d925d6c6124447d581f2ae5f52ba710f",
        "status": "active",
        "suppliers": [
          {
            "name": "Державне управління справами",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00037256",
              "uri": "http://www.dus.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Банкова, 11, корпус 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "01220",
              "countryName": "Україна"
            },
            "contactPoint": {
              "name": "Державне управління справами",
              "telephone": "+0440000000"
            }
          }
        ],
        "unitPrices": [
          {
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 100.0
            }
          }
        ],
        "awardID": "a915a07f7f0b4dafa583cce119bf1823",
        "bidID": "fc02090c338a477f8013156a4fa2da10",
        "date": "2018-07-30T17:40:15.471264+03:00"
      }
    ],
    "items": [
      {
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "description": "футляри до державних нагород",
        "unit": {
          "name": "item",
          "code": "KGM"
        },
        "quantity": 5.0,
        "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"
      }
    },
    "terminationDetails": "broker3 now can change the contract",
    "tender_id": "f394ae7a792e404c96103b00547a61d5",
    "numberOfContracts": 3
  }
}

Зверніть увагу, що тільки майданчик з відповідним рівнем акредитації може стати новим власником. В іншому випадку майданчику така дія буде заборонена.

POST /api/2.5/agreements/5f2c362583984e0daed42cb21777cee3/ownership HTTP/1.0
Authorization: Bearer broker2
Content-Length: 100
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "id": "77c12e537eb44ca5a272bfb05c1ee588",
    "transfer": "ee024235f2254c22997aceee23a8fbb3"
  }
}

Response: 403 Forbidden
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "status": "error",
  "errors": [
    {
      "location": "url",
      "name": "accreditation",
      "description": "Broker Accreditation level does not permit ownership change"
    }
  ]
}

Зміна власника дозволена тільки якщо поточний власник тендера має спеціальний рівень акредетації, що дозволяє зміну:

POST /api/2.5/agreements/5f2c362583984e0daed42cb21777cee3/ownership HTTP/1.0
Authorization: Bearer broker
Content-Length: 100
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "id": "f397e8985ab840fabf1a859c447e69f4",
    "transfer": "ee024235f2254c22997aceee23a8fbb3"
  }
}

Response: 403 Forbidden
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "status": "error",
  "errors": [
    {
      "location": "url",
      "name": "accreditation",
      "description": "Owner Accreditation level does not permit ownership change"
    }
  ]
}