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

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

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

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

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

POST /api/2.5/plans?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3744
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "buyers": [
      {
        "kind": "general",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        },
        "name": "ДУС",
        "address": {
          "countryName": "Україна",
          "postalCode": "01220",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ"
        }
      }
    ],
    "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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01: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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01: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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01: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": {
      "kind": "general",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "ДУС",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "tender": {
      "procurementMethod": "open",
      "procurementMethodType": "belowThreshold",
      "tenderPeriod": {
        "startDate": "2020-05-22T01: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": [
      {
        "kind": "general",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        },
        "name": "ДУС",
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "3b769e31f1b34febb698f583d5e264cd",
        "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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "88433532a143404988f063275f2a32a2",
        "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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "70f99b652a404d8e861f7c06543dd125",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "planID": "UA-P-2020-05-15-000001",
    "budget": {
      "breakdown": [
        {
          "title": "other",
          "description": "Breakdown other description.",
          "value": {
            "currency": "UAH",
            "amount": 1500.0
          },
          "id": "73d48f06e2124fbdbffe23cb37a0c417"
        }
      ],
      "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-15T01:00:00+03:00",
    "tender": {
      "procurementMethod": "open",
      "procurementMethodType": "belowThreshold",
      "tenderPeriod": {
        "startDate": "2020-05-22T01:00:00+03:00"
      }
    },
    "additionalClassifications": [
      {
        "scheme": "КЕКВ",
        "id": "1",
        "description": "-"
      }
    ],
    "procuringEntity": {
      "kind": "general",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "ДУС",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker",
    "dateModified": "2020-05-15T01: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": "6109ccb1b9d44715876fcef5701b3260",
    "token": "6827cd0ece6f4891a00cf118b33268e3"
  },
  "data": {
    "date": "2020-05-15T01: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-15T01: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": [
      {
        "kind": "general",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        },
        "name": "ДУС",
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "3b769e31f1b34febb698f583d5e264cd",
        "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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "88433532a143404988f063275f2a32a2",
        "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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "70f99b652a404d8e861f7c06543dd125",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "planID": "UA-P-2020-05-15-000001",
    "budget": {
      "breakdown": [
        {
          "title": "other",
          "description": "Breakdown other description.",
          "value": {
            "currency": "UAH",
            "amount": 1500.0
          },
          "id": "73d48f06e2124fbdbffe23cb37a0c417"
        }
      ],
      "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-15T01:00:00+03:00",
    "tender": {
      "procurementMethod": "open",
      "procurementMethodType": "belowThreshold",
      "tenderPeriod": {
        "startDate": "2020-05-22T01:00:00+03:00"
      }
    },
    "additionalClassifications": [
      {
        "scheme": "КЕКВ",
        "id": "1",
        "description": "-"
      }
    ],
    "procuringEntity": {
      "kind": "general",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "ДУС",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker1",
    "dateModified": "2020-05-15T01: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-15T01:00:00+03:00",
    "id": "cfd9e57ce9704ad2a954a79cbfe78d21",
    "usedFor": "/plans/f0b2403cba3040acaaf3d6d45dc953be"
  }
}

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

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

PATCH /api/2.5/plans/f0b2403cba3040acaaf3d6d45dc953be?acc_token=6827cd0ece6f4891a00cf118b33268e3 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": [
      {
        "kind": "general",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        },
        "name": "ДУС",
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "3b769e31f1b34febb698f583d5e264cd",
        "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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "88433532a143404988f063275f2a32a2",
        "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-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "70f99b652a404d8e861f7c06543dd125",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "planID": "UA-P-2020-05-15-000001",
    "budget": {
      "breakdown": [
        {
          "title": "other",
          "description": "Breakdown other description.",
          "value": {
            "currency": "UAH",
            "amount": 1500.0
          },
          "id": "73d48f06e2124fbdbffe23cb37a0c417"
        }
      ],
      "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-15T01:00:00+03:00",
    "tender": {
      "procurementMethod": "open",
      "procurementMethodType": "belowThreshold",
      "tenderPeriod": {
        "startDate": "2020-05-22T01:00:00+03:00"
      }
    },
    "additionalClassifications": [
      {
        "scheme": "КЕКВ",
        "id": "1",
        "description": "-"
      }
    ],
    "procuringEntity": {
      "kind": "general",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "ДУС",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker1",
    "dateModified": "2020-05-15T01: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"
    }
  ]
}