Туторіал

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

Можна створити три процедури:
  • reporting - процедура звітування про укладений договір (без періоду очікування скарг)
  • negotiation - переговорна процедура з десятиденним періодом очікування скарг перед реєстрацією угоди
  • negotiation.quick - переговорна процедура за нагальною потребою з п’ятиденним періодом очікування скарг перед реєстрацією угоди

Створення закупівлі для процедури звітування про укладений договір

Щоб створити закупівлю за процедурою звітування про укладений договір, потрібно встановити значення reporting для procurementMethodType.

Створимо закупівлю:

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3427
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "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",
    "title": "Послуги шкільних їдалень",
    "procurementMethodType": "reporting",
    "title_en": "Services in school canteens",
    "description_en": "Services in school canteens",
    "procuringEntity": {
      "kind": "special",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "countryName": "Україна",
        "postalCode": "21027",
        "region": "Вінницька область",
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця"
      }
    },
    "title_ru": "Услуги школьных столовых",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "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
      }
    ],
    "owner": "broker",
    "value": {
      "currency": "UAH",
      "amount": 500000,
      "valueAddedTaxIncluded": true
    },
    "description_ru": "Услуги школьных столовых"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce
{
  "access": {
    "transfer": "c96f71ce43434e95bfe40838215d4f21",
    "token": "bc6711b5ba434b92bbba26699dca3104"
  },
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "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": "17f2a088dfd24ab297fbb7bc53d60906"
      }
    ],
    "mainProcurementCategory": "services",
    "title": "Послуги шкільних їдалень",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "3cbf25c0bb094819a3084be21bc85cd7",
        "quantity": 1.0
      }
    ],
    "title_en": "Services in school canteens",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2020-05-15T01:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      }
    },
    "date": "2020-05-15T01:00:00+03:00",
    "procurementMethodType": "reporting",
    "description_en": "Services in school canteens",
    "title_ru": "Услуги школьных столовых",
    "owner": "broker",
    "description_ru": "Услуги школьных столовых",
    "id": "5fb29c8fb65c4a12b69dd3531cfe7bce",
    "tenderID": "UA-2020-05-15-000001"
  }
}

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

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

GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/tenders?offset=2020-05-15T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2020-05-15T01%3A00%3A00%2B03%3A00",
    "offset": "2020-05-15T01:00:00+03:00"
  },
  "data": [
    {
      "id": "5fb29c8fb65c4a12b69dd3531cfe7bce",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

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

Створення закупівлі для переговорної процедури

Щоб створити закупівлю за переговорною процедурою, потрібно встановити значення negotiation для procurementMethodType.

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3974
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "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",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "title": "Послуги шкільних їдалень",
    "title_en": "Services in school canteens",
    "procurementMethodType": "negotiation",
    "description_en": "Services in school canteens",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "causeDescription_en": "original tender has failed twice",
    "procuringEntity": {
      "kind": "special",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "address": {
        "countryName": "Україна",
        "postalCode": "21027",
        "region": "Вінницька область",
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця"
      },
      "name": "ЗОСШ #10 м.Вінниці"
    },
    "title_ru": "Услуги школьных столовых",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "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
      }
    ],
    "owner": "broker",
    "value": {
      "currency": "UAH",
      "amount": 500000,
      "valueAddedTaxIncluded": false
    },
    "description_ru": "Услуги школьных столовых",
    "cause": "twiceUnsuccessful"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976
{
  "access": {
    "transfer": "fefb236552864a109c73337d5b251dce",
    "token": "df3d7d3c62c74918a4905630dbce126b"
  },
  "data": {
    "procurementMethod": "limited",
    "mainProcurementCategory": "services",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      }
    },
    "owner": "broker",
    "id": "26b780552e084bbcb2b53c5383a6e976",
    "title": "Послуги шкільних їдалень",
    "causeDescription_en": "original tender has failed twice",
    "tenderID": "UA-2020-05-15-000001",
    "description_ru": "Услуги школьных столовых",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "status": "active",
    "title_en": "Services in school canteens",
    "procurementMethodType": "negotiation",
    "description_en": "Services in school canteens",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "date": "2020-05-15T01:00:00+03:00",
    "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": "98b06bf4f2ee4e0fa872b6c8841596c4"
      }
    ],
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "08b6cc454279495f8d2a561b50d74611",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": false
    },
    "title_ru": "Услуги школьных столовых",
    "cause": "twiceUnsuccessful"
  }
}

Створення закупівлі для переговорної процедури за нагальною потребою

Щоб створити закупівлю для переговорної процедури за нагальною потребою, потрібно встановити значення negotiation.quick для procurementMethodType.

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3979
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "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",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "title": "Послуги шкільних їдалень",
    "title_en": "Services in school canteens",
    "procurementMethodType": "negotiation.quick",
    "description_en": "Services in school canteens",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "causeDescription_en": "original tender has failed twice",
    "procuringEntity": {
      "kind": "special",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "address": {
        "countryName": "Україна",
        "postalCode": "21027",
        "region": "Вінницька область",
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця"
      },
      "name": "ЗОСШ #10 м.Вінниці"
    },
    "title_ru": "Услуги школьных столовых",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "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
      }
    ],
    "owner": "broker",
    "value": {
      "currency": "UAH",
      "amount": 500000,
      "valueAddedTaxIncluded": true
    },
    "description_ru": "Услуги школьных столовых",
    "cause": "twiceUnsuccessful"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976
{
  "access": {
    "transfer": "fefb236552864a109c73337d5b251dce",
    "token": "df3d7d3c62c74918a4905630dbce126b"
  },
  "data": {
    "procurementMethod": "limited",
    "mainProcurementCategory": "services",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      }
    },
    "owner": "broker",
    "id": "26b780552e084bbcb2b53c5383a6e976",
    "title": "Послуги шкільних їдалень",
    "causeDescription_en": "original tender has failed twice",
    "tenderID": "UA-2020-05-15-000001",
    "description_ru": "Услуги школьных столовых",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "status": "active",
    "title_en": "Services in school canteens",
    "procurementMethodType": "negotiation.quick",
    "description_en": "Services in school canteens",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "date": "2020-05-15T01:00:00+03:00",
    "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": "98b06bf4f2ee4e0fa872b6c8841596c4"
      }
    ],
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "08b6cc454279495f8d2a561b50d74611",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "title_ru": "Услуги школьных столовых",
    "cause": "twiceUnsuccessful"
  }
}

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

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

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 80
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "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": "17f2a088dfd24ab297fbb7bc53d60906"
      }
    ],
    "mainProcurementCategory": "services",
    "title": "Послуги шкільних їдалень",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "3cbf25c0bb094819a3084be21bc85cd7",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9.0
      }
    ],
    "title_en": "Services in school canteens",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2020-05-15T01:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "Вінницька область",
        "locality": "м. Вінниця"
      }
    },
    "date": "2020-05-15T01:00:00+03:00",
    "procurementMethodType": "reporting",
    "description_en": "Services in school canteens",
    "title_ru": "Услуги школьных столовых",
    "owner": "broker",
    "description_ru": "Услуги школьных столовых",
    "id": "5fb29c8fb65c4a12b69dd3531cfe7bce",
    "tenderID": "UA-2020-05-15-000001"
  }
}

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

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

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

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

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

POST /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 142
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Notice.pdf"
Content-Type: application/pdf

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/documents/8f13a8d6f69346d288e0fa0c066d57bc
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0d57ccf75f8c47e6bfbd8f3e166b47de?KeyID=a8968c46&Signature=Cz%252B%2F6DcaCl%2FgYCctZn1TM4SuTct8avcp3J0TDhQYNbAoYl%2FWrHlvJV3OP0odOIbjBqBMhzpAnnRZiaX6MI92Cg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "8f13a8d6f69346d288e0fa0c066d57bc",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено.

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

PUT /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/documents/8f13a8d6f69346d288e0fa0c066d57bc?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 145
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Notice-2.pdf"
Content-Type: application/pdf

content2
-----BOUNDARY--


Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice-2.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f59eff37995e4e47aaa0be2d4feef897?KeyID=a8968c46&Signature=2MGxZZTqj%2FC%2F%2FkcDUC99MfhWdYr5OKPyKyPHgLfq6OV4fIKnxZ7Sw8Hw3iGbb4CdrdTVQs76X6pZPEf%252Bk0TRAA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "8f13a8d6f69346d288e0fa0c066d57bc",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

Визначення переможця

Додаємо інформацію про постачальника

Спосіб додавання інформації про постачальника однаковий для всіх процедур.

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

POST /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 877
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "pending",
    "suppliers": [
      {
        "contactPoint": {
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "Вінницька область",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000,
      "valueAddedTaxIncluded": true
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/7957eb73ee0e4bde954e87031a364f27
{
  "data": {
    "status": "pending",
    "date": "2020-05-15T01:00:00+03:00",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "id": "7957eb73ee0e4bde954e87031a364f27",
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    }
  }
}

Замовник реєструє інформацію про постачальника для переговорної процедури:

POST /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 878
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "pending",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "Вінницька область",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000,
      "valueAddedTaxIncluded": false
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards/25e94c29b961421a9128a267c2ffe263
{
  "data": {
    "status": "pending",
    "date": "2020-05-15T01:00:00+03:00",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "id": "25e94c29b961421a9128a267c2ffe263",
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": false
    }
  }
}

Ви можете побачити, що згенеровано запис complaintPeriod із полем startDate.

Замовник реєструє інформацію про постачальника для переговорної процедури за нагальною потребою:

POST /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 878
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "pending",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "Вінницька область",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000,
      "valueAddedTaxIncluded": false
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards/25e94c29b961421a9128a267c2ffe263
{
  "data": {
    "status": "pending",
    "date": "2020-05-15T01:00:00+03:00",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "id": "25e94c29b961421a9128a267c2ffe263",
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": false
    }
  }
}

Визначення переможця для переговорної процедури за нагальною потребою також має запис complaintPeriod із полем startDate.

Завантаження документів щодо визначення переможця

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

POST /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/7957eb73ee0e4bde954e87031a364f27/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 159
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="award_first_document.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/7957eb73ee0e4bde954e87031a364f27/documents/bc1b9ded857f484dba843e9e56fde4ff
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "award_first_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8c8d8ecd2605476c8c80ac3c7f2ed030?KeyID=a8968c46&Signature=PwpB%252Bx1D9CUUV9JX9j3tTebtGVUCOGvnROF7m2Mp6iNqmMdBjKa6lO43%2FnJYyiqbtLxoW4sfNEXePqkR699IAw%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "bc1b9ded857f484dba843e9e56fde4ff",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ додано.

Переглянемо документи пов’язані із визначенням переможця:

GET /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/7957eb73ee0e4bde954e87031a364f27/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "award_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8c8d8ecd2605476c8c80ac3c7f2ed030?KeyID=a8968c46&Signature=PwpB%252Bx1D9CUUV9JX9j3tTebtGVUCOGvnROF7m2Mp6iNqmMdBjKa6lO43%2FnJYyiqbtLxoW4sfNEXePqkR699IAw%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "bc1b9ded857f484dba843e9e56fde4ff",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

Тепер спробуємо додати ще один документ щодо визначення переможця:

POST /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/7957eb73ee0e4bde954e87031a364f27/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 160
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="award_second_document.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/7957eb73ee0e4bde954e87031a364f27/documents/e3df98e85ec74550bde73df99950323b
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "award_second_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3c8115cb8c344150bed5c7401f22cf78?KeyID=a8968c46&Signature=%252BDkRaRbOsmkU0YOyey7YGMPqTIIxcuKHx5MswPiGATKOvC6ATU3Uasab73bV8uTFY8olFq5J2hlvOBQ4BtN%2FAA%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "e3df98e85ec74550bde73df99950323b",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що ще один документ було додано.

Тепер переглянемо знову усі документи пов’язані із визначенням переможця:

GET /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/7957eb73ee0e4bde954e87031a364f27/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "award_second_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3c8115cb8c344150bed5c7401f22cf78?KeyID=a8968c46&Signature=%252BDkRaRbOsmkU0YOyey7YGMPqTIIxcuKHx5MswPiGATKOvC6ATU3Uasab73bV8uTFY8olFq5J2hlvOBQ4BtN%2FAA%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "e3df98e85ec74550bde73df99950323b",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "award_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8c8d8ecd2605476c8c80ac3c7f2ed030?KeyID=a8968c46&Signature=PwpB%252Bx1D9CUUV9JX9j3tTebtGVUCOGvnROF7m2Mp6iNqmMdBjKa6lO43%2FnJYyiqbtLxoW4sfNEXePqkR699IAw%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "bc1b9ded857f484dba843e9e56fde4ff",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

Підтвердження переможця процедури

Замовник повинен підтвердити своє рішення про визначення переможця:

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/7957eb73ee0e4bde954e87031a364f27?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "award_first_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8c8d8ecd2605476c8c80ac3c7f2ed030?KeyID=a8968c46&Signature=PwpB%252Bx1D9CUUV9JX9j3tTebtGVUCOGvnROF7m2Mp6iNqmMdBjKa6lO43%2FnJYyiqbtLxoW4sfNEXePqkR699IAw%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "bc1b9ded857f484dba843e9e56fde4ff",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "award_second_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3c8115cb8c344150bed5c7401f22cf78?KeyID=a8968c46&Signature=%252BDkRaRbOsmkU0YOyey7YGMPqTIIxcuKHx5MswPiGATKOvC6ATU3Uasab73bV8uTFY8olFq5J2hlvOBQ4BtN%2FAA%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "e3df98e85ec74550bde73df99950323b",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:00+03:00",
    "id": "7957eb73ee0e4bde954e87031a364f27"
  }
}

Підтвердження визначення переможця для переговорної процедури:

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards/25e94c29b961421a9128a267c2ffe263?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 49
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active",
    "qualified": true
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "complaintPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-26T00:00:00+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": false
    },
    "qualified": true,
    "date": "2020-05-15T01:00:00+03:00",
    "id": "25e94c29b961421a9128a267c2ffe263"
  }
}

Різниця між початковою (startDate) та кінцевою (endDate) датою запису complaintPeriod для переговорної процедури становить 10 днів.

Підтвердження визначення переможця для переговорної процедури за нагальною потребою процедури:

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards/25e94c29b961421a9128a267c2ffe263?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 49
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active",
    "qualified": true
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "complaintPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-21T00:00:00+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": false
    },
    "qualified": true,
    "date": "2020-05-15T01:00:00+03:00",
    "id": "25e94c29b961421a9128a267c2ffe263"
  }
}

Різниця між початковою ( startDate) та кінцевою (endDate) датою запису complaintPeriod для переговорної процедури за нагальною потребою становить 5 днів.

Встановлення вартості угоди

За замовчуванням вартість угоди встановлюється на основі рішення про визначення переможця, але є можливість змінити це значення.

Якщо ви хочете знизити вартість угоди, ви можете встановити нове значення для поля amount.

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 54
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "value": {
      "amount": 238,
      "amountNet": 230
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "3cbf25c0bb094819a3084be21bc85cd7",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:00+03:00",
    "awardID": "7957eb73ee0e4bde954e87031a364f27",
    "id": "ec50d5084bd940d68482479c4834cdf4",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

Було повернуто код відповіді 200 OK. Значення змінено успішно.

Setting value per item’s unit

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 58
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "unit": {
          "value": {
            "amount": 12
          }
        }
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "3cbf25c0bb094819a3084be21bc85cd7",
        "unit": {
          "code": "MON",
          "name": "month",
          "value": {
            "currency": "UAH",
            "amount": 12.0,
            "valueAddedTaxIncluded": true
          }
        },
        "quantity": 9.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:00+03:00",
    "awardID": "7957eb73ee0e4bde954e87031a364f27",
    "id": "ec50d5084bd940d68482479c4834cdf4",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

200 OK response was returned with successfully set item.unit.value structure.

Встановлення дати підписання угоди

Є можливість встановити дату підписання угоди. Для цього вставте відповідну дату в поле dateSigned.

Якщо ви не встановите дату підписання, то вона буде згенерована автоматично під час реєстрації угоди.

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "dateSigned": "2020-05-15T01:00:00+03:00"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "3cbf25c0bb094819a3084be21bc85cd7",
        "unit": {
          "code": "MON",
          "name": "month",
          "value": {
            "currency": "UAH",
            "amount": 12.0,
            "valueAddedTaxIncluded": true
          }
        },
        "quantity": 9.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2020-05-15T01:00:00+03:00",
    "date": "2020-05-15T01:00:00+03:00",
    "awardID": "7957eb73ee0e4bde954e87031a364f27",
    "id": "ec50d5084bd940d68482479c4834cdf4",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

Встановлення терміну дії угоди

Встановлення терміну дії угоди необов’язкове, але, якщо є необхідність, ви можете встановити відповідну дату початку startDate та кінця endDate терміну дії.

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "period": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2021-05-15T01:00:00+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "3cbf25c0bb094819a3084be21bc85cd7",
        "unit": {
          "code": "MON",
          "name": "month",
          "value": {
            "currency": "UAH",
            "amount": 12.0,
            "valueAddedTaxIncluded": true
          }
        },
        "quantity": 9.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "period": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2021-05-15T01:00:00+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2020-05-15T01:00:00+03:00",
    "date": "2020-05-15T01:00:00+03:00",
    "awardID": "7957eb73ee0e4bde954e87031a364f27",
    "id": "ec50d5084bd940d68482479c4834cdf4",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

Завантаження документів щодо укладання угоди

Документи пов’язані з угодою можна завантажувати лише до укладання угоди. Спробуємо додати такий документ:

POST /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 162
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract_first_document.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents/5b4bf70c7bbf4c42b9f2f9e5078c2244
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_first_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3062b577f0bd41aeb70990e8500c20c0?KeyID=a8968c46&Signature=Si3%2FyBiCdCoNEcYeF01MWpUNYzB6HeCKBZNbRQ1NFP83ikmrt1fiIr%252BijgEHyjuqw5CCXKk%2F7cZzBFtD%252BEXtDQ%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "5b4bf70c7bbf4c42b9f2f9e5078c2244",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ додано.

Переглянемо список завантажених документів:

GET /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3062b577f0bd41aeb70990e8500c20c0?KeyID=a8968c46&Signature=Si3%2FyBiCdCoNEcYeF01MWpUNYzB6HeCKBZNbRQ1NFP83ikmrt1fiIr%252BijgEHyjuqw5CCXKk%2F7cZzBFtD%252BEXtDQ%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "5b4bf70c7bbf4c42b9f2f9e5078c2244",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

Тепер спробуємо додати ще один документ щодо укладанням угоди:

POST /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 163
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract_second_document.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents/07538d9599d148f3933b7fc55d682a69
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_second_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/31b100f444a843b39e370557224ad9d3?KeyID=a8968c46&Signature=cwW9rXu0GKHBbhRxIRzS8iWjQOYYqc%252BPWdkJPi0G93FVip96AICUOnx0mtaHHw1A6IJrM3%2Fhx6wF6QgRCmfuBA%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "07538d9599d148f3933b7fc55d682a69",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що ще один документ було додано.

Тепер переглянемо знову усі документи пов’язані із укладанням угоди:

GET /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3062b577f0bd41aeb70990e8500c20c0?KeyID=a8968c46&Signature=Si3%2FyBiCdCoNEcYeF01MWpUNYzB6HeCKBZNbRQ1NFP83ikmrt1fiIr%252BijgEHyjuqw5CCXKk%2F7cZzBFtD%252BEXtDQ%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "5b4bf70c7bbf4c42b9f2f9e5078c2244",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_second_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/31b100f444a843b39e370557224ad9d3?KeyID=a8968c46&Signature=cwW9rXu0GKHBbhRxIRzS8iWjQOYYqc%252BPWdkJPi0G93FVip96AICUOnx0mtaHHw1A6IJrM3%2Fhx6wF6QgRCmfuBA%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "07538d9599d148f3933b7fc55d682a69",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

Реєстрація угоди

Угода про закупівлю за процедурою звітування про укладений договір може бути зареєстрована одразу після підтвердження визначення переможця:

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_first_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3062b577f0bd41aeb70990e8500c20c0?KeyID=a8968c46&Signature=Si3%2FyBiCdCoNEcYeF01MWpUNYzB6HeCKBZNbRQ1NFP83ikmrt1fiIr%252BijgEHyjuqw5CCXKk%2F7cZzBFtD%252BEXtDQ%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "5b4bf70c7bbf4c42b9f2f9e5078c2244",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_second_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/31b100f444a843b39e370557224ad9d3?KeyID=a8968c46&Signature=cwW9rXu0GKHBbhRxIRzS8iWjQOYYqc%252BPWdkJPi0G93FVip96AICUOnx0mtaHHw1A6IJrM3%2Fhx6wF6QgRCmfuBA%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "07538d9599d148f3933b7fc55d682a69",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "3cbf25c0bb094819a3084be21bc85cd7",
        "unit": {
          "code": "MON",
          "name": "month",
          "value": {
            "currency": "UAH",
            "amount": 12.0,
            "valueAddedTaxIncluded": true
          }
        },
        "quantity": 9.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "period": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2021-05-15T01:00:00+03:00"
    },
    "dateSigned": "2020-05-15T01:00:00+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:01+03:00",
    "awardID": "7957eb73ee0e4bde954e87031a364f27",
    "id": "ec50d5084bd940d68482479c4834cdf4",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

Угода про закупівлю за переговорною процедурою може бути зареєстрована одразу після періоду очікування скарг (десятиденний період після підтвердження визначення переможця):

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/contracts/961703907d164d1185e860612c0a8fc8?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "08b6cc454279495f8d2a561b50d74611",
        "quantity": 1.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "amountNet": 475000.0,
      "valueAddedTaxIncluded": false
    },
    "dateSigned": "2020-05-15T01:00:01+03:00",
    "date": "2020-05-15T01:00:01+03:00",
    "awardID": "25e94c29b961421a9128a267c2ffe263",
    "id": "961703907d164d1185e860612c0a8fc8",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

GET /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976 HTTP/1.0
Authorization: Bearer chronograph
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "awards": [
      {
        "status": "active",
        "complaintPeriod": {
          "startDate": "2020-05-15T01:00:00+03:00",
          "endDate": "2020-05-15T01:00:00+03:00"
        },
        "suppliers": [
          {
            "contactPoint": {
              "email": "soleksuk@gmail.com",
              "telephone": "+380 (432) 21-69-30",
              "name": "Сергій Олексюк"
            },
            "scale": "micro",
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "uri": "http://www.sc.gov.ua/"
            },
            "address": {
              "postalCode": "21100",
              "countryName": "Україна",
              "streetAddress": "вул. Островського, 33",
              "region": "Вінницька область",
              "locality": "м. Вінниця"
            }
          }
        ],
        "value": {
          "currency": "UAH",
          "amount": 475000.0,
          "valueAddedTaxIncluded": false
        },
        "qualified": true,
        "date": "2020-05-15T01:00:00+03:00",
        "id": "25e94c29b961421a9128a267c2ffe263"
      }
    ],
    "id": "26b780552e084bbcb2b53c5383a6e976"
  }
}

Угода про закупівлю для переговорної процедури за нагальною потребою може бути зареєстрована одразу після періоду очікування скарг (п’ятиденний період після підтвердження визначення переможця):

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/contracts/0b3c1a9fcf054fa98d15801d166c4c87?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-06-04T00:00:00+02:00",
          "endDate": "2020-07-04T00:00:00+02:00"
        },
        "id": "08b6cc454279495f8d2a561b50d74611",
        "quantity": 1.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "amountNet": 475000.0,
      "valueAddedTaxIncluded": false
    },
    "dateSigned": "2020-05-15T01:00:01+03:00",
    "date": "2020-05-15T01:00:01+03:00",
    "awardID": "25e94c29b961421a9128a267c2ffe263",
    "id": "0b3c1a9fcf054fa98d15801d166c4c87",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

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

Замовник може скасувати закупівлю у будь-який момент (крім закупівель у статусі active.auction чи у кінцевому стані, наприклад, usuccesfull, canceled, complete).

Для цього потрібно виконати наступні кроки:

  1. Приготуйте запит на скасування
  2. Заповніть його протоколом про причини скасування
    1. Проходження періоду оскарження(триває 10 днів), тільки для negotiation та negotiation.quick
  3. Скасуйте закупівлю через подані причини

Запит на скасування, який не пройшов активації (4-й крок), не матиме сили, тобто, для скасування закупівлі буде обов’язковим не тільки створити заявку, але і активувати її.

Для відміни скасування закупівлі, вам потрібно оновоить статус скасування до unsuccessful з draft чи pending

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

Формування запиту на скасування для reporting процедури

Ви повинні передати змінні reason та reasonType, status у стані draft.

При скасуванні, замовник має визначити один з чотирьох типів reasonType: noDemand, unFixable, forceMajeure aбо expensesCut.

id генерується автоматично і повертається у додатковому заголовку відповіді Location:

POST /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/cancellations?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 69
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reason": "cancellation reason",
    "reasonType": "noDemand"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/cancellations/efdf6c101c54481eb17df7c76a8a9e0c
{
  "data": {
    "status": "draft",
    "reason": "cancellation reason",
    "reasonType": "noDemand",
    "date": "2020-05-15T01:00:01+03:00",
    "cancellationOf": "tender",
    "id": "efdf6c101c54481eb17df7c76a8a9e0c"
  }
}

Ви можете виправити тип на будь-який що вказаний вище.

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/cancellations/efdf6c101c54481eb17df7c76a8a9e0c?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 37
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reasonType": "unFixable"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "draft",
    "reason": "cancellation reason",
    "reasonType": "unFixable",
    "date": "2020-05-15T01:00:01+03:00",
    "cancellationOf": "tender",
    "id": "efdf6c101c54481eb17df7c76a8a9e0c"
  }
}

Формування запиту на скасування для negotiation та negotiation.quick процедури

При скасуванні, замовник має визначити один з п’яти типів reasonType: noObjectiveness, unFixable, noDemand, expensesCut та dateViolation

POST /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/cancellations?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 69
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reason": "cancellation reason",
    "reasonType": "noDemand"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/cancellations/e57e4f5a014e4f3aad51281fcafb24a8
{
  "data": {
    "status": "draft",
    "reason": "cancellation reason",
    "reasonType": "noDemand",
    "date": "2020-05-15T01:00:00+03:00",
    "cancellationOf": "tender",
    "id": "e57e4f5a014e4f3aad51281fcafb24a8"
  }
}

Ви можете виправити тип на будь-який що вказаний вище.

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/cancellations/e57e4f5a014e4f3aad51281fcafb24a8?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 41
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reasonType": "dateViolation"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "draft",
    "reason": "cancellation reason",
    "reasonType": "dateViolation",
    "date": "2020-05-15T01:00:00+03:00",
    "cancellationOf": "tender",
    "id": "e57e4f5a014e4f3aad51281fcafb24a8"
  }
}

Наповнення протоколом та іншою супровідною документацією

Цей крок обов’язковий. Без документів ви не можете оновити статус скарги.

Завантажте зміст файлу

POST /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/cancellations/efdf6c101c54481eb17df7c76a8a9e0c/documents?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 142
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Notice.pdf"
Content-Type: application/pdf

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/cancellations/efdf6c101c54481eb17df7c76a8a9e0c/documents/7ce706c799a7481990ed0e68090d431d
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7673f6d0f7e4738bdc6dba22b565ff4?KeyID=a8968c46&Signature=21W%252B2LEqYOX%2FHJMrB%252Bb6I2M31ms6J3bUKiEq5vndvP4NMgy5tE2SnhcqqS3FMvkemWAlvqbW8JDkw9UfGn5yDQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:01+03:00",
    "id": "7ce706c799a7481990ed0e68090d431d",
    "dateModified": "2020-05-15T01:00:01+03:00"
  }
}

Якщо потрібно, змініть опис документа та інші властивості

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/cancellations/efdf6c101c54481eb17df7c76a8a9e0c/documents/7ce706c799a7481990ed0e68090d431d?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 48
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "description": "Changed description"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7673f6d0f7e4738bdc6dba22b565ff4?KeyID=a8968c46&Signature=21W%252B2LEqYOX%2FHJMrB%252Bb6I2M31ms6J3bUKiEq5vndvP4NMgy5tE2SnhcqqS3FMvkemWAlvqbW8JDkw9UfGn5yDQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:01+03:00",
    "id": "7ce706c799a7481990ed0e68090d431d",
    "dateModified": "2020-05-15T01:00:01+03:00"
  }
}

Завантажте нову версію документа

PUT /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/cancellations/efdf6c101c54481eb17df7c76a8a9e0c/documents/7ce706c799a7481990ed0e68090d431d?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 145
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Notice-2.pdf"
Content-Type: application/pdf

content2
-----BOUNDARY--


Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "title": "Notice-2.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1d6a86e5eaf9475f82f9ba263f30390c?KeyID=a8968c46&Signature=8JoY534LWjk682eHLVzgIw9QaTN3HvvLEvxU8ui52Uv%252Bg7IKxfGaneHWv%252Bkm9Xvg6j7Yjwv5%2FTej2bF7d6%252BQBA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:01+03:00",
    "id": "7ce706c799a7481990ed0e68090d431d",
    "dateModified": "2020-05-15T01:00:01+03:00"
  }
}

Проходження періоду оскарження(тільки для negotiation та negotiation.quick)

Для того щоб перейти до періоду оскарження потрібно змінити стаутс скасування з draft на pending.

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/cancellations/efdf6c101c54481eb17df7c76a8a9e0c?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 31
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "pending"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7673f6d0f7e4738bdc6dba22b565ff4?KeyID=a8968c46&Signature=21W%252B2LEqYOX%2FHJMrB%252Bb6I2M31ms6J3bUKiEq5vndvP4NMgy5tE2SnhcqqS3FMvkemWAlvqbW8JDkw9UfGn5yDQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "id": "7ce706c799a7481990ed0e68090d431d",
        "dateModified": "2020-05-15T01:00:01+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1d6a86e5eaf9475f82f9ba263f30390c?KeyID=a8968c46&Signature=8JoY534LWjk682eHLVzgIw9QaTN3HvvLEvxU8ui52Uv%252Bg7IKxfGaneHWv%252Bkm9Xvg6j7Yjwv5%2FTej2bF7d6%252BQBA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "id": "7ce706c799a7481990ed0e68090d431d",
        "dateModified": "2020-05-15T01:00:01+03:00"
      }
    ],
    "complaintPeriod": {
      "startDate": "2020-05-15T01:00:01+03:00",
      "endDate": "2020-05-26T00:00:00+03:00"
    },
    "reason": "cancellation reason",
    "reasonType": "unFixable",
    "date": "2020-05-15T01:00:01+03:00",
    "cancellationOf": "tender",
    "id": "efdf6c101c54481eb17df7c76a8a9e0c"
  }
}

Коли скасування закупівлі в статусі pending замовнику зобороняються всі дії по закупівлі.

Активація запиту та скасування закупівлі

Якщо період оскарження(триває 10 днів) скінчився та не було ніяких скарг на скасування закупівлі або скарги були скасовані, то скасування автоматично зміює статус на active.