Туторіал

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

Наполегливо рекомендуємо створювати плани у статусі draft.

Створимо план:

POST /api/2.5/plans?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3509
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "draft",
    "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": {
          "endDate": "2020-05-30T01: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": {
          "endDate": "2020-05-31T01: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": {
          "endDate": "2020-06-01T01:00:00+03:00"
        },
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000
      }
    ],
    "budget": {
      "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/f580aa1bdcf84194995a102bc3a96d2d
{
  "access": {
    "transfer": "27f37bb326c14b2181fd8cebd6e41dec",
    "token": "ead4319976ca4849973333da0242d440"
  },
  "data": {
    "status": "draft",
    "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": {
          "endDate": "2020-05-30T01:00:00+03:00"
        },
        "id": "c83eb7ab3fa440958a4a0c18ae70dcb3",
        "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": {
          "endDate": "2020-05-31T01:00:00+03:00"
        },
        "id": "ed7a8d82d9814016b3c57cf5174a71dd",
        "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": {
          "endDate": "2020-06-01T01:00:00+03:00"
        },
        "id": "ab1a34aca8e64ee693e8915fa971d20a",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "planID": "UA-P-2020-05-15-000001",
    "budget": {
      "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": "f580aa1bdcf84194995a102bc3a96d2d"
  }
}

Ми отримали код відповіді 201 Created, заголовок Location і тіло з додатковим ідентифікатором id, planID та властивість dateModified - дату, що показує час, коли план закупівлі востаннє модифікувався.

Другий крок - переміщення плану в статус scheduled, щоб опубліковати план:

PATCH /api/2.5/plans/f580aa1bdcf84194995a102bc3a96d2d?acc_token=ead4319976ca4849973333da0242d440 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "scheduled"
  }
}

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": {
          "endDate": "2020-05-30T01:00:00+03:00"
        },
        "id": "c83eb7ab3fa440958a4a0c18ae70dcb3",
        "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": {
          "endDate": "2020-05-31T01:00:00+03:00"
        },
        "id": "ed7a8d82d9814016b3c57cf5174a71dd",
        "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": {
          "endDate": "2020-06-01T01:00:00+03:00"
        },
        "id": "ab1a34aca8e64ee693e8915fa971d20a",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "planID": "UA-P-2020-05-15-000001",
    "budget": {
      "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": "f580aa1bdcf84194995a102bc3a96d2d"
  }
}

Перевіримо, що містить реєстр планів закупівель:

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

Відображається id - внутрішній ідентифікатор (який можна використовувати, щоб побудувати повну URL-адресу, додаючи http://api-sandbox.openprocurement.org/api/0/plans/ на початку) та мітка часу dateModified.

Модифікація плану закупівлі

Оновимо план шляхом надання їй усіх інших важливих властивостей:

PATCH /api/2.5/plans/f580aa1bdcf84194995a102bc3a96d2d?acc_token=ead4319976ca4849973333da0242d440 HTTP/1.0
Authorization: Bearer broker
Content-Length: 652
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "description": "Насіння овочевих культур",
        "classification": {
          "scheme": "ДК021",
          "description": "Vegetable seeds",
          "id": "03111700-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.13.6",
            "description": "Насіння овочевих культур"
          }
        ],
        "deliveryDate": {
          "endDate": "2016-06-01T23:06:30.023018+03:00"
        },
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 5000
      }
    ]
  }
}

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": "Vegetable seeds",
          "id": "03111700-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.13.6",
            "description": "Насіння овочевих культур"
          }
        ],
        "deliveryDate": {
          "endDate": "2016-06-01T23:06:30.023018+03:00"
        },
        "id": "c83eb7ab3fa440958a4a0c18ae70dcb3",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 5000.0
      }
    ],
    "planID": "UA-P-2020-05-15-000001",
    "budget": {
      "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": "f580aa1bdcf84194995a102bc3a96d2d"
  }
}

Ми бачимо, що додаткові властивості об’єднані з існуючими даними плану. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.

Ще одна перевірка списку відображає нову дату модифікації:

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

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

Закупівля може бути створена з відповідного їй плану закупівлі. Закупівля буде пов’язана з планом за допомогою полів plans тендеру і tender_id плану.

Примітка

Системні збої під час створення закупівлі з плану можуть призвести до закупівель, які не пов’язані з їхніми планами по tender_id.
Переконайтеся, що ви використовуєте Двофазний коміт і не проводте ці помилкові закупівлі (створюйте нові натомість).

Для зменшення шансів зробити помилку та зв’язати закупівлю з неправильним планом, встановлені правила валідації

POST /api/2.5/plans/f580aa1bdcf84194995a102bc3a96d2d/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 4115
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing"
      }
    ],
    "mainProcurementCategory": "services",
    "tenderPeriod": {
      "endDate": "2020-06-15T00:00:00+02:00"
    },
    "title": "Послуги шкільних їдалень",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "id": "37810000-9",
          "description": "Test"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "quantity": 1
      },
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "id": "37810000-9",
          "description": "Test"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "quantity": 1
      }
    ],
    "procurementMethodType": "aboveThresholdEU",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "kind": "general",
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "countryName": "Україна",
        "postalCode": "21027",
        "region": "Вінницька область",
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця"
      },
      "name_en": "School #10 of Vinnytsia",
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name_en": "Kutsa Svitlana V.",
        "name": "Куца Світлана Валентинівна",
        "availableLanguage": "uk",
        "telephone": "+380 (432) 46-53-02"
      }
    },
    "title_en": "Services in school canteens"
  }
}

Response: 422 Unprocessable Entity
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "procurementMethodType doesn't match: belowThreshold != aboveThresholdEU",
      "location": "data",
      "name": "procurementMethodType"
    }
  ]
}

Усього їх три:

  • procurementMethodType - відповідність типу процедури плана і тендера
  • procuringEntity.identifier - відповідність полів id і scheme для плана і тендера
  • classification.id - відповідність перших 4-х цифр кодів класифікатора плана і тендера (336 виняток - відповідність перших 3-х цифр)

План має містити джерела фінансування, інакше буде отрімано помилку під час створення тендеру:

POST /api/2.5/plans/f580aa1bdcf84194995a102bc3a96d2d/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 3376
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "draft",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing"
      }
    ],
    "mainProcurementCategory": "goods",
    "tenderPeriod": {
      "endDate": "2020-06-05T01:00:00+03:00"
    },
    "title": "Насіння",
    "minimalStep": {
      "currency": "UAH",
      "amount": 15
    },
    "enquiryPeriod": {
      "endDate": "2020-05-29T01:00:00+03:00"
    },
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "Насіння гірчиці",
        "classification": {
          "scheme": "ДК021",
          "description": "Mustard seeds",
          "id": "03111600-8"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "deliveryDate": {
          "endDate": "2020-05-30T01: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": {
          "endDate": "2020-05-31T01: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": {
          "endDate": "2020-06-01T01:00:00+03:00"
        },
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000
      }
    ]
  }
}

Response: 422 Unprocessable Entity
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Plan should contain budget breakdown",
      "location": "data",
      "name": "budget.breakdown"
    }
  ]
}

Додамо джерело фінансування до плану:

PATCH /api/2.5/plans/f580aa1bdcf84194995a102bc3a96d2d?acc_token=ead4319976ca4849973333da0242d440 HTTP/1.0
Authorization: Bearer broker
Content-Length: 150
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "budget": {
      "breakdown": [
        {
          "description": "Breakdown other description.",
          "value": {
            "currency": "UAH",
            "amount": 1500
          },
          "title": "other"
        }
      ]
    }
  }
}

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": "Vegetable seeds",
          "id": "03111700-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.13.6",
            "description": "Насіння овочевих культур"
          }
        ],
        "deliveryDate": {
          "endDate": "2016-06-01T23:06:30.023018+03:00"
        },
        "id": "c83eb7ab3fa440958a4a0c18ae70dcb3",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 5000.0
      }
    ],
    "planID": "UA-P-2020-05-15-000001",
    "budget": {
      "breakdown": [
        {
          "title": "other",
          "description": "Breakdown other description.",
          "value": {
            "currency": "UAH",
            "amount": 1500.0
          },
          "id": "9e9302b002f943278d76a5610e0e3bac"
        }
      ],
      "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": "f580aa1bdcf84194995a102bc3a96d2d"
  }
}

Успішний приклад виглядає так:

POST /api/2.5/plans/f580aa1bdcf84194995a102bc3a96d2d/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 3376
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "draft",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing"
      }
    ],
    "mainProcurementCategory": "goods",
    "tenderPeriod": {
      "endDate": "2020-06-05T01:00:00+03:00"
    },
    "title": "Насіння",
    "minimalStep": {
      "currency": "UAH",
      "amount": 15
    },
    "enquiryPeriod": {
      "endDate": "2020-05-29T01:00:00+03:00"
    },
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "Насіння гірчиці",
        "classification": {
          "scheme": "ДК021",
          "description": "Mustard seeds",
          "id": "03111600-8"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "deliveryDate": {
          "endDate": "2020-05-30T01: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": {
          "endDate": "2020-05-31T01: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": {
          "endDate": "2020-06-01T01:00:00+03:00"
        },
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/821592d97e83442cbb6f2aee3a5367b1
{
  "access": {
    "transfer": "5be584eac3ef4e32809a084b2b49f2ba",
    "token": "1e87f2df8def4c3c83ae0890a9038210"
  },
  "data": {
    "procurementMethod": "open",
    "status": "draft",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "10bc97f3d7d842e79ec67890aa152d92"
      }
    ],
    "mainProcurementCategory": "goods",
    "tenderPeriod": {
      "startDate": "2020-05-29T01:00:00+03:00",
      "endDate": "2020-06-05T01:00:00+03:00"
    },
    "title": "Насіння",
    "minimalStep": {
      "currency": "UAH",
      "amount": 15.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Насіння гірчиці",
        "classification": {
          "scheme": "ДК021",
          "description": "Mustard seeds",
          "id": "03111600-8"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "deliveryDate": {
          "endDate": "2020-05-30T01:00:00+03:00"
        },
        "id": "16055704c1d645788f69e15e2de1e163",
        "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": {
          "endDate": "2020-05-31T01:00:00+03:00"
        },
        "id": "780f097c6daf4c919259a08babc0a36f",
        "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": {
          "endDate": "2020-06-01T01:00:00+03:00"
        },
        "id": "5117c7514a494959afc386f26535883c",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2020-05-15T01:00:00+03:00",
    "tenderID": "UA-2020-05-15-000001",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "awardCriteria": "lowestCost",
    "enquiryPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-29T01:00:00+03:00"
    },
    "owner": "broker",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "id": "821592d97e83442cbb6f2aee3a5367b1",
    "plans": [
      {
        "id": "f580aa1bdcf84194995a102bc3a96d2d"
      }
    ]
  }
}

Перевіримо, чи стан плану було перемкнено на complete:

GET /api/2.5/plans/f580aa1bdcf84194995a102bc3a96d2d 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": "complete",
    "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": "Vegetable seeds",
          "id": "03111700-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.13.6",
            "description": "Насіння овочевих культур"
          }
        ],
        "deliveryDate": {
          "endDate": "2016-06-01T23:06:30.023018+03:00"
        },
        "id": "c83eb7ab3fa440958a4a0c18ae70dcb3",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 5000.0
      }
    ],
    "planID": "UA-P-2020-05-15-000001",
    "budget": {
      "breakdown": [
        {
          "title": "other",
          "description": "Breakdown other description.",
          "value": {
            "currency": "UAH",
            "amount": 1500.0
          },
          "id": "9e9302b002f943278d76a5610e0e3bac"
        }
      ],
      "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": "f580aa1bdcf84194995a102bc3a96d2d",
    "tender_id": "821592d97e83442cbb6f2aee3a5367b1"
  }
}

Після створення закупівлі з плану змінити план більше неможливо:

PATCH /api/2.5/plans/f580aa1bdcf84194995a102bc3a96d2d?acc_token=ead4319976ca4849973333da0242d440 HTTP/1.0
Authorization: Bearer broker
Content-Length: 301
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "procuringEntity": {
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111983",
        "legalName": "ДП Державне Управління Справами"
      },
      "name": "ДУС"
    }
  }
}

Response: 422 Unprocessable Entity
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Can't update plan in 'complete' status",
      "location": "data",
      "name": "status"
    }
  ]
}

Завершення плану без торгів

Існує спосіб завершити план без створення тендеру:

PATCH /api/2.5/plans/c6255f3084f0409cb80fe4220c16c2ae?acc_token=19733fa509ed45a28b78466169f978c6 HTTP/1.0
Authorization: Bearer broker
Content-Length: 32
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "complete"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "complete",
    "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": {
          "endDate": "2020-05-30T01:00:00+03:00"
        },
        "id": "4eda329bf7f448b8a6079ef67fa59574",
        "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": {
          "endDate": "2020-05-31T01:00:00+03:00"
        },
        "id": "795342d7820543d4b1f69cf2acd00cdf",
        "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": {
          "endDate": "2020-06-01T01:00:00+03:00"
        },
        "id": "7c8012eb2b19489fa8a704dbe996344f",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "planID": "UA-P-2020-05-15-000002",
    "budget": {
      "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": "c6255f3084f0409cb80fe4220c16c2ae"
  }
}

Це працює лише в тому випадку, якщо procurementMethodType є одним із наступних:

  • belowThreshold
  • reporting
  • порожній рядок

Скасування плану

План можна скасувати за допомогою PlanCancellation:

PATCH /api/2.5/plans/4689139ff34a42b09939fc6e030ecdcc?acc_token=3ba3dae0ce4444538dd8784e3ecce947 HTTP/1.0
Authorization: Bearer broker
Content-Length: 213
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "cancellation": {
      "reason": "Підстава для скасування",
      "reason_en": "Reason of the cancellation"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "scheduled",
    "cancellation": {
      "date": "2020-05-15T01:00:00+03:00",
      "status": "pending",
      "reason": "Підстава для скасування",
      "reason_en": "Reason of the cancellation",
      "id": "2b2e6ce04a064c9eb5f7e02fd90a82a1"
    },
    "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": {
          "endDate": "2020-05-30T01:00:00+03:00"
        },
        "id": "db625f93faef43e4ba2e05a892e01822",
        "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": {
          "endDate": "2020-05-31T01:00:00+03:00"
        },
        "id": "b5dc327654764d098563e95836fc6416",
        "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": {
          "endDate": "2020-06-01T01:00:00+03:00"
        },
        "id": "ca0860a5660643c5b5966626a3de9a3c",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "planID": "UA-P-2020-05-15-000003",
    "budget": {
      "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"
    },
    "dateModified": "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",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "4689139ff34a42b09939fc6e030ecdcc"
  }
}

Зміна статуса об’єкта скасування на active скасовує план:

PATCH /api/2.5/plans/4689139ff34a42b09939fc6e030ecdcc?acc_token=3ba3dae0ce4444538dd8784e3ecce947 HTTP/1.0
Authorization: Bearer broker
Content-Length: 48
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "cancellation": {
      "status": "active"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "cancelled",
    "cancellation": {
      "date": "2020-05-15T01:00:00+03:00",
      "status": "active",
      "reason": "Підстава для скасування",
      "reason_en": "Reason of the cancellation",
      "id": "2b2e6ce04a064c9eb5f7e02fd90a82a1"
    },
    "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": {
          "endDate": "2020-05-30T01:00:00+03:00"
        },
        "id": "db625f93faef43e4ba2e05a892e01822",
        "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": {
          "endDate": "2020-05-31T01:00:00+03:00"
        },
        "id": "b5dc327654764d098563e95836fc6416",
        "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": {
          "endDate": "2020-06-01T01:00:00+03:00"
        },
        "id": "ca0860a5660643c5b5966626a3de9a3c",
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "quantity": 3000.0
      }
    ],
    "planID": "UA-P-2020-05-15-000003",
    "budget": {
      "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"
    },
    "dateModified": "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",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "4689139ff34a42b09939fc6e030ecdcc"
  }
}