Приклад для плану закупівлі

Зміна власника плану закупівлі

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

Створення плану закупівлі

Спочатку створимо план закупівлі:

POST /api/2.5/plans?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3070
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "buyers": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        },
        "name": "ДУС"
      }
    ],
    "classification": {
      "scheme": "ДК021",
      "description": "Seeds",
      "id": "03111000-2"
    },
    "items": [
      {
        "description": "Насіння гірчиці",
        "classification": {
          "scheme": "ДК021",
          "description": "Mustard seeds",
          "id": "03111600-8"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 1000
      },
      {
        "description": "Насіння соняшнику",
        "classification": {
          "scheme": "ДК021",
          "description": "Sunflower seeds",
          "id": "03111300-5"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.95",
            "description": "Насіння соняшнику"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 2000
      },
      {
        "description": "Насіння бавовнику",
        "classification": {
          "scheme": "ДК021",
          "description": "Cotton seeds",
          "id": "03111400-6"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.84",
            "description": "Насіння бавовнику"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000
      }
    ],
    "budget": {
      "breakdown": [
        {
          "description": "Breakdown other description.",
          "value": {
            "currency": "UAH",
            "amount": 1500
          },
          "title": "other"
        }
      ],
      "amountNet": 12222,
      "description": "budget_description",
      "period": {
        "startDate": "2020-01-01T00:00:00",
        "endDate": "2020-12-31T00:00:00"
      },
      "project": {
        "name": "proj_name",
        "id": "123"
      },
      "currency": "UAH",
      "amount": 10000,
      "id": "12303111000-2"
    },
    "additionalClassifications": [
      {
        "scheme": "КЕКВ",
        "id": "1",
        "description": "-"
      }
    ],
    "procuringEntity": {
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "ДУС"
    },
    "tender": {
      "procurementMethod": "open",
      "procurementMethodType": "belowThreshold",
      "tenderPeriod": {
        "startDate": "2020-05-08T01:00:00+03:00"
      }
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/f0b2403cba3040acaaf3d6d45dc953be
{
  "access": {
    "transfer": "1eb53c2056db4f7295dc001b64d55189",
    "token": "6e891dac35c54b3c9b474544a69ca492"
  },
  "data": {
    "status": "scheduled",
    "buyers": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        },
        "name": "ДУС"
      }
    ],
    "classification": {
      "scheme": "ДК021",
      "description": "Seeds",
      "id": "03111000-2"
    },
    "items": [
      {
        "description": "Насіння гірчиці",
        "classification": {
          "scheme": "ДК021",
          "description": "Mustard seeds",
          "id": "03111600-8"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "099cdfc7ed9842c6b300e3c804d97b77",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 1000.0
      },
      {
        "description": "Насіння соняшнику",
        "classification": {
          "scheme": "ДК021",
          "description": "Sunflower seeds",
          "id": "03111300-5"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.95",
            "description": "Насіння соняшнику"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "d08aa9cd1ae342039affd26af6a622bb",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 2000.0
      },
      {
        "description": "Насіння бавовнику",
        "classification": {
          "scheme": "ДК021",
          "description": "Cotton seeds",
          "id": "03111400-6"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.84",
            "description": "Насіння бавовнику"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "775067ef9cd74cfcb3e2b07ba7f3237c",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "planID": "UA-P-2020-05-01-000001",
    "budget": {
      "breakdown": [
        {
          "title": "other",
          "description": "Breakdown other description.",
          "value": {
            "currency": "UAH",
            "amount": 1500.0
          },
          "id": "6b9885866d3f4488b4aac2dbd7d8ca89"
        }
      ],
      "amountNet": 12222.0,
      "description": "budget_description",
      "period": {
        "startDate": "2020-01-01T00:00:00+02:00",
        "endDate": "2020-12-31T00:00:00+02:00"
      },
      "project": {
        "id": "123",
        "name": "proj_name"
      },
      "currency": "UAH",
      "amount": 10000.0,
      "id": "12303111000-2"
    },
    "datePublished": "2020-05-01T01:00:00+03:00",
    "tender": {
      "procurementMethod": "open",
      "procurementMethodType": "belowThreshold",
      "tenderPeriod": {
        "startDate": "2020-05-08T01:00:00+03:00"
      }
    },
    "additionalClassifications": [
      {
        "scheme": "КЕКВ",
        "id": "1",
        "description": "-"
      }
    ],
    "procuringEntity": {
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "ДУС"
    },
    "owner": "broker",
    "dateModified": "2020-05-01T01:00:00+03:00",
    "id": "f0b2403cba3040acaaf3d6d45dc953be"
  }
}

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

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

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

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

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

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

Response: 201 Created
Content-Type: application/json; charset=UTF-8
{
  "access": {
    "transfer": "953e65ee7aff40008cdcaab6ea01947d",
    "token": "b4f7426efb264f118eb96434dd7f4177"
  },
  "data": {
    "date": "2020-05-01T01:00:00+03:00",
    "id": "cfd9e57ce9704ad2a954a79cbfe78d21"
  }
}

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

Об’єкт Transfer можна переглянути за допомогою ідентифікатора id:

GET /api/2.5/transfers/cfd9e57ce9704ad2a954a79cbfe78d21 HTTP/1.0
Authorization: Bearer broker1
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "date": "2020-05-01T01:00:00+03:00",
    "id": "cfd9e57ce9704ad2a954a79cbfe78d21"
  }
}

Зміна власника плану закупівлі

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

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

draft

cancelled

complete

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

POST /api/2.5/plans/f0b2403cba3040acaaf3d6d45dc953be/ownership HTTP/1.0
Authorization: Bearer broker1
Content-Length: 100
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "transfer": "1eb53c2056db4f7295dc001b64d55189",
    "id": "cfd9e57ce9704ad2a954a79cbfe78d21"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "scheduled",
    "buyers": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        },
        "name": "ДУС"
      }
    ],
    "classification": {
      "scheme": "ДК021",
      "description": "Seeds",
      "id": "03111000-2"
    },
    "items": [
      {
        "description": "Насіння гірчиці",
        "classification": {
          "scheme": "ДК021",
          "description": "Mustard seeds",
          "id": "03111600-8"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "099cdfc7ed9842c6b300e3c804d97b77",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 1000.0
      },
      {
        "description": "Насіння соняшнику",
        "classification": {
          "scheme": "ДК021",
          "description": "Sunflower seeds",
          "id": "03111300-5"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.95",
            "description": "Насіння соняшнику"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "d08aa9cd1ae342039affd26af6a622bb",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 2000.0
      },
      {
        "description": "Насіння бавовнику",
        "classification": {
          "scheme": "ДК021",
          "description": "Cotton seeds",
          "id": "03111400-6"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.84",
            "description": "Насіння бавовнику"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "775067ef9cd74cfcb3e2b07ba7f3237c",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "planID": "UA-P-2020-05-01-000001",
    "budget": {
      "breakdown": [
        {
          "title": "other",
          "description": "Breakdown other description.",
          "value": {
            "currency": "UAH",
            "amount": 1500.0
          },
          "id": "6b9885866d3f4488b4aac2dbd7d8ca89"
        }
      ],
      "amountNet": 12222.0,
      "description": "budget_description",
      "period": {
        "startDate": "2020-01-01T00:00:00+02:00",
        "endDate": "2020-12-31T00:00:00+02:00"
      },
      "project": {
        "id": "123",
        "name": "proj_name"
      },
      "currency": "UAH",
      "amount": 10000.0,
      "id": "12303111000-2"
    },
    "datePublished": "2020-05-01T01:00:00+03:00",
    "tender": {
      "procurementMethod": "open",
      "procurementMethodType": "belowThreshold",
      "tenderPeriod": {
        "startDate": "2020-05-08T01:00:00+03:00"
      }
    },
    "additionalClassifications": [
      {
        "scheme": "КЕКВ",
        "id": "1",
        "description": "-"
      }
    ],
    "procuringEntity": {
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "ДУС"
    },
    "owner": "broker1",
    "dateModified": "2020-05-01T01:00:00+03:00",
    "id": "f0b2403cba3040acaaf3d6d45dc953be"
  }
}

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

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

Після того, як об’єкт Transfer було застосовано, для нього генерується властивість usedFor (вказується шлях до об’єкта, власника якого було змінено):

GET /api/2.5/transfers/cfd9e57ce9704ad2a954a79cbfe78d21 HTTP/1.0
Authorization: Bearer broker1
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "date": "2020-05-01T01:00:00+03:00",
    "id": "cfd9e57ce9704ad2a954a79cbfe78d21",
    "usedFor": "/plans/f0b2403cba3040acaaf3d6d45dc953be"
  }
}

„Використаний“ об’єкт Transfer вже не можна застосувати до іншого об’єкта.

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

PATCH /api/2.5/plans/f0b2403cba3040acaaf3d6d45dc953be?acc_token=b4f7426efb264f118eb96434dd7f4177 HTTP/1.0
Authorization: Bearer broker1
Content-Length: 72
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "budget": {
      "description": "broker1 now can change the plan"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "scheduled",
    "buyers": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        },
        "name": "ДУС"
      }
    ],
    "classification": {
      "scheme": "ДК021",
      "description": "Seeds",
      "id": "03111000-2"
    },
    "items": [
      {
        "description": "Насіння гірчиці",
        "classification": {
          "scheme": "ДК021",
          "description": "Mustard seeds",
          "id": "03111600-8"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "099cdfc7ed9842c6b300e3c804d97b77",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 1000.0
      },
      {
        "description": "Насіння соняшнику",
        "classification": {
          "scheme": "ДК021",
          "description": "Sunflower seeds",
          "id": "03111300-5"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.95",
            "description": "Насіння соняшнику"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "d08aa9cd1ae342039affd26af6a622bb",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 2000.0
      },
      {
        "description": "Насіння бавовнику",
        "classification": {
          "scheme": "ДК021",
          "description": "Cotton seeds",
          "id": "03111400-6"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.84",
            "description": "Насіння бавовнику"
          }
        ],
        "deliveryDate": {
          "startDate": "2020-05-03T01:00:00+03:00",
          "endDate": "2020-05-06T01:00:00+03:00"
        },
        "id": "775067ef9cd74cfcb3e2b07ba7f3237c",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "planID": "UA-P-2020-05-01-000001",
    "budget": {
      "breakdown": [
        {
          "title": "other",
          "description": "Breakdown other description.",
          "value": {
            "currency": "UAH",
            "amount": 1500.0
          },
          "id": "6b9885866d3f4488b4aac2dbd7d8ca89"
        }
      ],
      "amountNet": 12222.0,
      "description": "broker1 now can change the plan",
      "period": {
        "startDate": "2020-01-01T00:00:00+02:00",
        "endDate": "2020-12-31T00:00:00+02:00"
      },
      "project": {
        "id": "123",
        "name": "proj_name"
      },
      "currency": "UAH",
      "amount": 10000.0,
      "id": "12303111000-2"
    },
    "datePublished": "2020-05-01T01:00:00+03:00",
    "tender": {
      "procurementMethod": "open",
      "procurementMethodType": "belowThreshold",
      "tenderPeriod": {
        "startDate": "2020-05-08T01:00:00+03:00"
      }
    },
    "additionalClassifications": [
      {
        "scheme": "КЕКВ",
        "id": "1",
        "description": "-"
      }
    ],
    "procuringEntity": {
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "ДУС"
    },
    "owner": "broker1",
    "dateModified": "2020-05-01T01:00:00+03:00",
    "id": "f0b2403cba3040acaaf3d6d45dc953be"
  }
}

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

POST /api/2.5/plans/f0b2403cba3040acaaf3d6d45dc953be/ownership HTTP/1.0
Authorization: Bearer broker2
Content-Length: 100
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "transfer": "1eb53c2056db4f7295dc001b64d55189",
    "id": "e38e1f0bf67542548a79cd491990e080"
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Broker Accreditation level does not permit ownership change",
      "location": "ownership",
      "name": "accreditation"
    }
  ]
}

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

POST /api/2.5/plans/f0b2403cba3040acaaf3d6d45dc953be/ownership HTTP/1.0
Authorization: Bearer broker
Content-Length: 100
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "transfer": "1eb53c2056db4f7295dc001b64d55189",
    "id": "fcb2aaedc97243a6ab2136de257ce5b7"
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Owner Accreditation level does not permit ownership change",
      "location": "ownership",
      "name": "accreditation"
    }
  ]
}