Туторіал

Розглянемо основні правила

Подивимось як працює точка входу /tenders:

GET /api/2.5/tenders 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=",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=",
    "offset": ""
  },
  "data": []
}

При виклику видає пустий набір.

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

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
data

Response: 415 Unsupported Media Type
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Content-Type header should be one of ['application/json']",
      "location": "header",
      "name": "Content-Type"
    }
  ]
}

Помилка вказує, що єдиний прийнятний тип вмісту це application/json.

Задовольнимо вимогу типу вмісту (Content-type):

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 4
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
data

Response: 422 Unprocessable Entity
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "No JSON object could be decoded",
      "location": "body",
      "name": "data"
    }
  ]
}

Помилка вказує, що data не знайдено у тілі JSON.

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

Створимо закупівлю з мінімально допустимим (обовязковим для заповнення) набором даних:

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 2818
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "футляри до державних нагород",
    "lots": [
      {
        "title": "Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "Опис Лот №1"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "New Cartons"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    },
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/c4b851839b51462fbf72e030424fca88
{
  "access": {
    "transfer": "c327b6d901f74ed9b327a8e292394b19",
    "token": "e433ffb60bd04399ba2a3ef727bf1792"
  },
  "data": {
    "status": "draft",
    "procurementMethod": "selective",
    "tenderID": "UA-2020-05-15-000001",
    "title": "футляри до державних нагород",
    "lots": [
      {
        "date": "2020-05-15T01:00:00+03:00",
        "status": "active",
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "submissionMethod": "electronicAuction",
    "date": "2020-05-15T01:00:00+03:00",
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ],
    "awardCriteria": "lowestCost",
    "owner": "broker",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "id": "c4b851839b51462fbf72e030424fca88",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    }
  }
}

Успіх! Тепер ми бачимо, що новий об’єкт було створено. Код відповіді 201 та заголовок відповіді Location вказує місцерозташування створеного об’єкта. Тіло відповіді показує інформацію про створену закупівлю, її внутрішнє id (яке співпадає з сегментом Location), її офіційне tenderID та dateModified дату, що показує час, коли закупівля востаннє модифікувалась. Зверніть увагу на procurementMethodType, а також на те, що закупівля створюється зі статусом draft.

Використаємо URL створеного об’єкта (заголовок відповіді Location):

GET /api/2.5/tenders/c4b851839b51462fbf72e030424fca88 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": "draft",
    "procurementMethod": "selective",
    "tenderID": "UA-2020-05-15-000001",
    "title": "футляри до державних нагород",
    "lots": [
      {
        "date": "2020-05-15T01:00:00+03:00",
        "status": "active",
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "submissionMethod": "electronicAuction",
    "date": "2020-05-15T01:00:00+03:00",
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ],
    "awardCriteria": "lowestCost",
    "owner": "broker",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "id": "c4b851839b51462fbf72e030424fca88",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    }
  }
}

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

Ми бачимо внутрішнє id закупівлі (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/»-«tenders/) та її dateModified дату.

Попередня закупівля була створена лише з обов’язковими полями. Тепер додамо закупівлю з максимально допустимим набором даних при створенні (тендер повинен бути у статусі created):

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3032
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",
    "title": "футляри до державних нагород",
    "lots": [
      {
        "title": "Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "Опис Лот №1"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_ru": "футляры к государственным наградам",
        "id": "21931e47b924425cba629f01ff15f044",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "mode": "test",
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ],
    "title_ru": "футляры к государственным наградам",
    "title_en": "Cases with state awards",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/bb5d83ccdd124232987d417d1966bbff
{
  "access": {
    "transfer": "b96177a00aeb4fb0827989272da143fe",
    "token": "f93cb6502e344f4cbb7e7389870287af"
  },
  "data": {
    "status": "draft",
    "procurementMethod": "selective",
    "tenderID": "UA-2020-05-15-000002",
    "title": "[ТЕСТУВАННЯ] футляри до державних нагород",
    "lots": [
      {
        "date": "2020-05-15T01:00:00+03:00",
        "status": "active",
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_ru": "футляры к государственным наградам",
        "id": "21931e47b924425cba629f01ff15f044",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "title_en": "[TESTING] Cases with state awards",
    "submissionMethod": "electronicAuction",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "date": "2020-05-15T01:00:00+03:00",
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "awardCriteria": "lowestCost",
    "title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
    "owner": "broker",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "mode": "test",
    "id": "bb5d83ccdd124232987d417d1966bbff",
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ]
  }
}

І знову код відповіді 201 Created, заголовок Location і тіло з додатковим id, tenderID, та властивість dateModified.

Для того, щоб перейти далі, треба змінити статус процедури на draft.pending. Це дозволить боту наповнити Agreement in cfaua і перевести тендер у наступний статус. Якщо надана інформація відповідає всім вимогам, бот переводить процедуру в статус active.enquiries, інакше в статус draft.unsuccessful.

PATCH /api/2.5/tenders/c4b851839b51462fbf72e030424fca88?acc_token=e433ffb60bd04399ba2a3ef727bf1792 HTTP/1.0
Authorization: Bearer broker
Content-Length: 37
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "draft.pending"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "draft.pending",
    "procurementMethod": "selective",
    "tenderID": "UA-2020-05-15-000001",
    "title": "футляри до державних нагород",
    "lots": [
      {
        "date": "2020-05-15T01:00:00+03:00",
        "status": "active",
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "submissionMethod": "electronicAuction",
    "date": "2020-05-15T01:00:00+03:00",
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ],
    "awardCriteria": "lowestCost",
    "owner": "broker",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "id": "c4b851839b51462fbf72e030424fca88",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    }
  }
}

Бачимо, що наш тендер відповідає всім вимогам, бот наповнив Agreement in cfaua і змінив статус тендера на active.enquiries.

GET /api/2.5/tenders/c4b851839b51462fbf72e030424fca88 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": "active.enquiries",
    "procurementMethod": "selective",
    "tenderID": "UA-2020-05-15-000001",
    "tenderPeriod": {
      "startDate": "2020-05-17T00:00:00+03:00",
      "endDate": "2020-05-20T00:00:00+03:00"
    },
    "title": "футляри до державних нагород",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "title": "Лот №1",
        "minimalStep": {
          "currency": "UAH",
          "amount": 2.5,
          "valueAddedTaxIncluded": true
        },
        "value": {
          "currency": "UAH",
          "amount": 500.56,
          "valueAddedTaxIncluded": true
        },
        "date": "2020-05-15T01:00:00+03:00",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "value": {
      "currency": "UAH",
      "amount": 500.56,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2020-05-15T01:00:00+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 2.5,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2020-05-15T01:00:00+03:00",
    "next_check": "2020-05-17T00:00:00+03:00",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    },
    "awardCriteria": "lowestCost",
    "enquiryPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-17T00:00:00+03:00"
    },
    "owner": "broker",
    "agreements": [
      {
        "agreementID": "UA-2018-09-11-000002-1",
        "status": "active",
        "features": [
          {
            "code": "OCDS-123454-AIR-INTAKE",
            "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
            "title": "Потужність всмоктування",
            "enum": [
              {
                "value": 0.1,
                "title": "До 1000 Вт"
              },
              {
                "value": 0.15,
                "title": "Більше 1000 Вт"
              }
            ],
            "title_en": "Air Intake",
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "featureOf": "item"
          },
          {
            "code": "OCDS-123454-YEARS",
            "description": "Кількість років, які організація учасник працює на ринку",
            "title": "Років на ринку",
            "enum": [
              {
                "value": 0.05,
                "title": "До 3 років"
              },
              {
                "value": 0.1,
                "title": "Більше 3 років, менше 5 років"
              },
              {
                "value": 0.15,
                "title": "Більше 5 років"
              }
            ],
            "title_en": "Years trading",
            "featureOf": "tenderer"
          }
        ],
        "title": "[ТЕСТУВАННЯ] ",
        "contracts": [
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "large",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037256",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 500.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "0a292b6466274139ad3d973fd64830ff",
            "date": "2018-07-30T17:40:15.471158+03:00",
            "awardID": "d7406b07c05b4796bb168a7c47ee7d31",
            "id": "d6cd8c3188d74e1481a9cebb57fd9329"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037257",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 500.56,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "unsuccessful",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами 1",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами 1",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037251",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 500.56,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037258",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 500.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "fc02090c338a477f8013156a4fa2da10",
            "date": "2018-07-30T17:40:15.471264+03:00",
            "awardID": "a915a07f7f0b4dafa583cce119bf1823",
            "id": "d925d6c6124447d581f2ae5f52ba710f"
          }
        ],
        "items": [
          {
            "description": "футляри до державних нагород",
            "classification": {
              "scheme": "ДК021",
              "description": "Cartons",
              "id": "44617100-9"
            },
            "description_en": "Cases for state awards",
            "additionalClassifications": [
              {
                "scheme": "ДКПП",
                "id": "17.21.1",
                "description": "папір і картон гофровані, паперова й картонна тара"
              }
            ],
            "deliveryAddress": {
              "postalCode": "79000",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "deliveryDate": {
              "startDate": "2018-06-27T13:39:09.362837+03:00",
              "endDate": "2018-06-30T13:39:09.362837+03:00"
            },
            "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "unit": {
              "code": "44617100-9",
              "name": "item"
            },
            "quantity": 5.0
          }
        ],
        "title_en": "[TESTING] ",
        "period": {
          "startDate": "2018-09-11T11:23:20.418390+03:00",
          "endDate": "2022-01-23T11:23:20.418436+03:00"
        },
        "dateSigned": "2018-09-11T11:23:23.220310+03:00",
        "id": "106468013e6f47398b6f2f4da3bdeba6",
        "procuringEntity": {
          "kind": "general",
          "name": "Шевченківська районна в місті Києві державна адміністрація",
          "address": {
            "postalCode": "01030",
            "countryName": "Україна",
            "streetAddress": "Богдана Хмельницького вулиця, 21-29",
            "region": "Київська область",
            "locality": "Переяслав-Хмельницький"
          },
          "contactPoint": {
            "name": "Ліповець Євген Іванович",
            "url": "http://www.shev.gov.ua/",
            "telephone": "2341170",
            "faxNumber": "2343591",
            "name_en": "Gregory Gillespie",
            "email": "buh510@ukr.net",
            "availableLanguage": "en"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\"",
            "id": "00037256",
            "legalName": "Шевченківська районна в місті Києві державна адміністрація"
          },
          "name_en": "Angelica Davis"
        },
        "numberOfContracts": 3,
        "mode": "test",
        "title_ru": "[ТЕСТИРОВАНИЕ] ",
        "owner": "broker",
        "dateModified": "2018-09-17T16:26:31.372995+03:00",
        "tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32"
      }
    ],
    "id": "c4b851839b51462fbf72e030424fca88",
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "featureOf": "item"
      },
      {
        "code": "OCDS-123454-YEARS",
        "description": "Кількість років, які організація учасник працює на ринку",
        "title": "Років на ринку",
        "enum": [
          {
            "value": 0.05,
            "title": "До 3 років"
          },
          {
            "value": 0.1,
            "title": "Більше 3 років, менше 5 років"
          },
          {
            "value": 0.15,
            "title": "Більше 5 років"
          }
        ],
        "title_en": "Years trading",
        "featureOf": "tenderer"
      }
    ]
  }
}

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

GET /api/2.5/tenders 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": "c4b851839b51462fbf72e030424fca88",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}
При створенні процедури в статусі draft, можна заповнювати наступні поля:
  • у Agreement in cfaua - id
  • у Tender - title, title_en, description, description_en, guarantee, procurementMethodType, procuringEntity
  • у Lot - title, title_en, description, description_en, id, guarantee
  • у Item - description, quantity, relatedLot, unit, description_en, classification, additionalClassifications, deliveryAddress, deliveryDate, deliveryLocation, id

Єдине поле, яке можна редагувати Tender: status.

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

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

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 96
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "quantity": 6
      }
    ],
    "tenderPeriod": {
      "endDate": "2020-05-30T01:00:10+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active.enquiries",
    "procurementMethod": "selective",
    "tenderID": "UA-2020-05-15-000004",
    "tenderPeriod": {
      "startDate": "2020-05-17T00:00:00+03:00",
      "endDate": "2020-05-30T01:00:10+03:00"
    },
    "title": "футляри до державних нагород",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "title": "Лот №1",
        "minimalStep": {
          "currency": "UAH",
          "amount": 2.5,
          "valueAddedTaxIncluded": true
        },
        "value": {
          "currency": "UAH",
          "amount": 600.67,
          "valueAddedTaxIncluded": true
        },
        "date": "2020-05-15T01:00:00+03:00",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 6.0
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "value": {
      "currency": "UAH",
      "amount": 600.67,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2020-05-15T01:00:00+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 2.5,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2020-05-15T01:00:00+03:00",
    "next_check": "2020-05-17T00:00:00+03:00",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    },
    "awardCriteria": "lowestCost",
    "enquiryPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-17T00:00:00+03:00"
    },
    "owner": "broker",
    "agreements": [
      {
        "agreementID": "UA-2018-09-11-000002-1",
        "status": "active",
        "features": [
          {
            "code": "OCDS-123454-AIR-INTAKE",
            "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
            "title": "Потужність всмоктування",
            "enum": [
              {
                "value": 0.1,
                "title": "До 1000 Вт"
              },
              {
                "value": 0.15,
                "title": "Більше 1000 Вт"
              }
            ],
            "title_en": "Air Intake",
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "featureOf": "item"
          },
          {
            "code": "OCDS-123454-YEARS",
            "description": "Кількість років, які організація учасник працює на ринку",
            "title": "Років на ринку",
            "enum": [
              {
                "value": 0.05,
                "title": "До 3 років"
              },
              {
                "value": 0.1,
                "title": "Більше 3 років, менше 5 років"
              },
              {
                "value": 0.15,
                "title": "Більше 5 років"
              }
            ],
            "title_en": "Years trading",
            "featureOf": "tenderer"
          }
        ],
        "title": "[ТЕСТУВАННЯ] ",
        "contracts": [
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "large",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037256",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "0a292b6466274139ad3d973fd64830ff",
            "date": "2018-07-30T17:40:15.471158+03:00",
            "awardID": "d7406b07c05b4796bb168a7c47ee7d31",
            "id": "d6cd8c3188d74e1481a9cebb57fd9329"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037257",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.67,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "unsuccessful",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами 1",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами 1",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037251",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.67,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037258",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "fc02090c338a477f8013156a4fa2da10",
            "date": "2018-07-30T17:40:15.471264+03:00",
            "awardID": "a915a07f7f0b4dafa583cce119bf1823",
            "id": "d925d6c6124447d581f2ae5f52ba710f"
          }
        ],
        "items": [
          {
            "description": "футляри до державних нагород",
            "classification": {
              "scheme": "ДК021",
              "description": "Cartons",
              "id": "44617100-9"
            },
            "description_en": "Cases for state awards",
            "additionalClassifications": [
              {
                "scheme": "ДКПП",
                "id": "17.21.1",
                "description": "папір і картон гофровані, паперова й картонна тара"
              }
            ],
            "deliveryAddress": {
              "postalCode": "79000",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "deliveryDate": {
              "startDate": "2018-06-27T13:39:09.362837+03:00",
              "endDate": "2018-06-30T13:39:09.362837+03:00"
            },
            "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "unit": {
              "code": "44617100-9",
              "name": "item"
            },
            "quantity": 5.0
          }
        ],
        "title_en": "[TESTING] ",
        "period": {
          "startDate": "2018-09-11T11:23:20.418390+03:00",
          "endDate": "2022-01-23T11:23:20.418436+03:00"
        },
        "dateSigned": "2018-09-11T11:23:23.220310+03:00",
        "id": "106468013e6f47398b6f2f4da3bdeba6",
        "procuringEntity": {
          "kind": "general",
          "name": "Шевченківська районна в місті Києві державна адміністрація",
          "address": {
            "postalCode": "01030",
            "countryName": "Україна",
            "streetAddress": "Богдана Хмельницького вулиця, 21-29",
            "region": "Київська область",
            "locality": "Переяслав-Хмельницький"
          },
          "contactPoint": {
            "name": "Ліповець Євген Іванович",
            "url": "http://www.shev.gov.ua/",
            "telephone": "2341170",
            "faxNumber": "2343591",
            "name_en": "Gregory Gillespie",
            "email": "buh510@ukr.net",
            "availableLanguage": "en"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\"",
            "id": "00037256",
            "legalName": "Шевченківська районна в місті Києві державна адміністрація"
          },
          "name_en": "Angelica Davis"
        },
        "numberOfContracts": 3,
        "mode": "test",
        "title_ru": "[ТЕСТИРОВАНИЕ] ",
        "owner": "broker",
        "dateModified": "2018-09-17T16:26:31.372995+03:00",
        "tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32"
      }
    ],
    "id": "6ccc95c340c94e32bcf0b8c2183e62f7",
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "featureOf": "item"
      },
      {
        "code": "OCDS-123454-YEARS",
        "description": "Кількість років, які організація учасник працює на ринку",
        "title": "Років на ринку",
        "enum": [
          {
            "value": 0.05,
            "title": "До 3 років"
          },
          {
            "value": 0.1,
            "title": "Більше 3 років, менше 5 років"
          },
          {
            "value": 0.15,
            "title": "Більше 5 років"
          }
        ],
        "title_en": "Years trading",
        "featureOf": "tenderer"
      }
    ]
  }
}

Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість 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": "6ccc95c340c94e32bcf0b8c2183e62f7",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "id": "c4b851839b51462fbf72e030424fca88",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

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

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/lots/1b75c06ee58f4909a4201255b4ba5831?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 57
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "guarantee": {
      "currency": "USD",
      "amount": 8
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "description": "Опис Лот №1",
    "title": "Лот №1",
    "minimalStep": {
      "currency": "UAH",
      "amount": 2.5,
      "valueAddedTaxIncluded": true
    },
    "value": {
      "currency": "UAH",
      "amount": 600.67,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:00+03:00",
    "id": "1b75c06ee58f4909a4201255b4ba5831",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    }
  }
}
Можна редагувати наступні поля на цьому етапі процедури:
  • у Tender - title, title_en, description, description_en, tenderPeriod: endDate
  • у Lot - title, description, title_en, description_en, minimalStep, amount
  • у Item - description, description_en, deliveryAddress, deliveryDate, quantity
  • Guarantee

Різниця між tenderPeriod:endDate і датою публікації тендера має бути не менше трьох днів.

Можливість редагувати ці залишається, якщо задано декілька Item.

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

Замовник має завантажувати тільки ЕЦП на цьому етапі процедури.

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

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 320
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=8uDRYbZKOz9FMsekzty6ZteEOx0OVkSKwr%2FZ4YgohXFmWDjHEt4rF3UT5uKcrNwmpuMm4kPGf955nkzQbuBtAg%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/e1361638f83e4a6ab2b160639b5264c8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "e1361638f83e4a6ab2b160639b5264c8",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/e1361638f83e4a6ab2b160639b5264c8 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",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "previousVersions": [],
    "id": "e1361638f83e4a6ab2b160639b5264c8",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

Один елемент масиву описує завантажений документ. Ми можемо завантажити більше документів:

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 333
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5b9474dc1ef04f6cb854b9b7ece6a280?KeyID=a8968c46&Signature=JYS%2FNI86r2%2F%2BEPzCFYwiT%2BmnLmSlbQfejWEFKw3bNhqIz8rFUe6fTh86EAYHpNeBjjHy8DTtyeDiGfkoIIcPCA%3D%3D",
    "title": "AwardCriteria.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/d44dae4e682c4fb6ad546dc2f164f2c4
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "AwardCriteria.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5b9474dc1ef04f6cb854b9b7ece6a280?KeyID=a8968c46&Signature=q0nnIB4up5R30F0Rq98CvwEfE0M%2Fz0VgC1PpU161Z9rl%2FC52mSAwa6LR57d1PaLEH%252Bpe4HBBdMSGGlY9hOxXCg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "d44dae4e682c4fb6ad546dc2f164f2c4",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

І знову можна підтвердити, що два документи завантажені.

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents 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",
      "description": "document description modified",
      "title": "Notice.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "author": "tender_owner",
      "documentType": "technicalSpecifications",
      "id": "e1361638f83e4a6ab2b160639b5264c8",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "AwardCriteria.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5b9474dc1ef04f6cb854b9b7ece6a280?KeyID=a8968c46&Signature=q0nnIB4up5R30F0Rq98CvwEfE0M%2Fz0VgC1PpU161Z9rl%2FC52mSAwa6LR57d1PaLEH%252Bpe4HBBdMSGGlY9hOxXCg%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "d44dae4e682c4fb6ad546dc2f164f2c4",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

Додамо новий documentType з пареметром technicalSpecifications до попередньо завантаженого документа:

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/e1361638f83e4a6ab2b160639b5264c8?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "documentType": "technicalSpecifications"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "documentType": "technicalSpecifications",
    "id": "e1361638f83e4a6ab2b160639b5264c8",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

Успіх! Код відповіді 200 OK і це підтверджує, що поле documentType з параметром technicalSpecifications було додано.

Тепер спробуємо відредагувати будь-яке поле в документі. Наприклад, description:

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/e1361638f83e4a6ab2b160639b5264c8?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 58
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "description": "document description modified"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description modified",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "author": "tender_owner",
    "documentType": "technicalSpecifications",
    "id": "e1361638f83e4a6ab2b160639b5264c8",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

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

PUT /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/d44dae4e682c4fb6ad546dc2f164f2c4?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 335
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/47d4864c89104801b7903301080f2b67?KeyID=a8968c46&Signature=Hco27SOxEFWNRg15WQtbku%2BRHvrF71z%2F4EwBEx9Q4g5LFQjByRABi4MWl%2BAEF%2FtfKIIfzigRC9EsE5SKKf0GBQ%3D%3D",
    "title": "AwardCriteria-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "AwardCriteria-2.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/47d4864c89104801b7903301080f2b67?KeyID=a8968c46&Signature=e3FMzyWIbV16OyRubrjsJYuYsFSTPG91PjuH8hiqKO1kbwM4tlroiQgICT4uTQPVHcC%2FdPtdLmNh0EgObct0CA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "d44dae4e682c4fb6ad546dc2f164f2c4",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

І можна побачити, що цей документ переважає оригінальну версію:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents 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",
      "description": "document description modified",
      "title": "Notice.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "author": "tender_owner",
      "documentType": "technicalSpecifications",
      "id": "e1361638f83e4a6ab2b160639b5264c8",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "AwardCriteria-2.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/47d4864c89104801b7903301080f2b67?KeyID=a8968c46&Signature=e3FMzyWIbV16OyRubrjsJYuYsFSTPG91PjuH8hiqKO1kbwM4tlroiQgICT4uTQPVHcC%2FdPtdLmNh0EgObct0CA%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "d44dae4e682c4fb6ad546dc2f164f2c4",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

Реєстрація пропозиції

Покроковий режим реєстрації

Коли приходить Tender.tenderingPeriod.startDate, Закупівля отримує статус active.tendering, що дозволяє реєстрацію пропозицій.

Учасник може зареєструвати пропозицію у статусі draft (чернетка):

Неможливо подати ставку зі значенням вищим, ніж agreement.contract.value. Також, постачальник не може подати ставку, якщо він не є учасником цієї Рамкової угоди (Agreement in cfaua).

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 1000
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "draft",
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "value": {
          "amount": 500
        }
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "tenderers": [
      {
        "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": "м. Вінниця"
        }
      }
    ]
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Bid is not a member of agreement",
      "location": "body",
      "name": "data"
    }
  ]
}
POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 1058
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "draft",
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "value": {
          "amount": 500
        }
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "large",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/436a89f5f496498fa9134f3caedb168d
{
  "access": {
    "transfer": "65bb6d881aa348afa3de97420545b5a3",
    "token": "ebff7d432d3d4d0a8756f67f9bb07ef5"
  },
  "data": {
    "status": "draft",
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "date": "2020-05-15T01:00:00+03:00",
        "value": {
          "currency": "UAH",
          "amount": 500.0,
          "valueAddedTaxIncluded": true
        }
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "large",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "date": "2020-05-15T01:00:00+03:00",
    "id": "436a89f5f496498fa9134f3caedb168d"
  }
}

Та активувати пропозицію:

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/436a89f5f496498fa9134f3caedb168d?acc_token=ebff7d432d3d4d0a8756f67f9bb07ef5 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",
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "date": "2020-05-15T01:00:00+03:00",
        "value": {
          "currency": "UAH",
          "amount": 500.0,
          "valueAddedTaxIncluded": true
        }
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "large",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "date": "2020-05-15T01:00:00+03:00",
    "id": "436a89f5f496498fa9134f3caedb168d"
  }
}

Учасник має завантажувати тільки ЕЦП на цьому етапі процедури.

І завантажити документ пропозиції:

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/436a89f5f496498fa9134f3caedb168d/documents?acc_token=ebff7d432d3d4d0a8756f67f9bb07ef5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 328
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/396c2bbf6e0c4ea1aa1292ff2f195d11?KeyID=a8968c46&Signature=cnar%2FZgM4vfn7TicnryGD60z0vXD34ooZcKdAi%2BKTOZZNVOahjEOyOo2d6LUiQvPxO%2FwfL1fB%2FBTXknWPTepCg%3D%3D",
    "title": "Proposal.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/436a89f5f496498fa9134f3caedb168d/documents/ec90a6e35c674a8eafa7fe0958a50a8c
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Proposal.pdf",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/436a89f5f496498fa9134f3caedb168d/documents/ec90a6e35c674a8eafa7fe0958a50a8c?download=396c2bbf6e0c4ea1aa1292ff2f195d11",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "ec90a6e35c674a8eafa7fe0958a50a8c",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/436a89f5f496498fa9134f3caedb168d/documents?acc_token=ebff7d432d3d4d0a8756f67f9bb07ef5 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": "Proposal.pdf",
      "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/436a89f5f496498fa9134f3caedb168d/documents/ec90a6e35c674a8eafa7fe0958a50a8c?download=396c2bbf6e0c4ea1aa1292ff2f195d11",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "ec90a6e35c674a8eafa7fe0958a50a8c",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

Пакетний режим реєстрації

У пакетному режимі (batch-mode) є можливість зареєструвати пропозицію одним запитом:

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 1702
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "documents": [
      {
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f4853348bbbc4a6faa08d0e2891ea2e8?KeyID=a8968c46&Signature=7oKZXvaJ1DSjHrye7Vper58fwy6SgxlPENkC8Dp%2BE%2FOdlns3tx9gSDonjNtipPzuXjfjbMkQzsQ1pK%2FkJp%2FgCg%3D%3D",
        "format": "application/pdf",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part1.pdf"
      },
      {
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e8f2a6a130ba44bb8e93f4056a8dbab7?KeyID=a8968c46&Signature=vDgXtbdz7NMXj2A8EujrSzjYTDZsd3d9TbAgAkG66CBgJJAuJ3z9jwF6R3M2tFHG7Evit2visH%2FEzt%2FDqmmABw%3D%3D",
        "format": "application/pdf",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf"
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "value": {
          "amount": 499
        }
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3232808966140b4817970455ae7c99e
{
  "access": {
    "transfer": "9ae4e56edcfb4eb69c010689a3f89041",
    "token": "8c1be9249ea8445480b4c4e3ec6ee974"
  },
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part1.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3232808966140b4817970455ae7c99e/documents/62d42fd055ad4447b9025faab11e1af1?download=f4853348bbbc4a6faa08d0e2891ea2e8",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "62d42fd055ad4447b9025faab11e1af1",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3232808966140b4817970455ae7c99e/documents/a88535d579b44921bd723845d97bdb5c?download=e8f2a6a130ba44bb8e93f4056a8dbab7",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "a88535d579b44921bd723845d97bdb5c",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "date": "2020-05-15T01:00:00+03:00",
        "value": {
          "currency": "UAH",
          "amount": 499.0,
          "valueAddedTaxIncluded": true
        }
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "date": "2020-05-15T01:00:00+03:00",
    "id": "d3232808966140b4817970455ae7c99e"
  }
}

Аукціон

Після того, як аукціон заплановано, будь-хто може його відвідати для перегляду. Аукціон можна подивитись за допомогою Tender.auctionUrl:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "selective",
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "featureOf": "item"
      },
      {
        "code": "OCDS-123454-YEARS",
        "description": "Кількість років, які організація учасник працює на ринку",
        "title": "Років на ринку",
        "enum": [
          {
            "value": 0.05,
            "title": "До 3 років"
          },
          {
            "value": 0.1,
            "title": "Більше 3 років, менше 5 років"
          },
          {
            "value": 0.15,
            "title": "Більше 5 років"
          }
        ],
        "title_en": "Years trading",
        "featureOf": "tenderer"
      }
    ],
    "enquiryPeriod": {
      "startDate": "2020-05-09T01:00:00+03:00",
      "endDate": "2020-05-11T01:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-05-15T01:42:00+03:00",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    },
    "owner": "broker",
    "id": "6ccc95c340c94e32bcf0b8c2183e62f7",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    },
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description modified",
        "title": "Notice.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "author": "tender_owner",
        "documentType": "technicalSpecifications",
        "id": "e1361638f83e4a6ab2b160639b5264c8",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5b9474dc1ef04f6cb854b9b7ece6a280?KeyID=a8968c46&Signature=q0nnIB4up5R30F0Rq98CvwEfE0M%2Fz0VgC1PpU161Z9rl%2FC52mSAwa6LR57d1PaLEH%252Bpe4HBBdMSGGlY9hOxXCg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "d44dae4e682c4fb6ad546dc2f164f2c4",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/47d4864c89104801b7903301080f2b67?KeyID=a8968c46&Signature=e3FMzyWIbV16OyRubrjsJYuYsFSTPG91PjuH8hiqKO1kbwM4tlroiQgICT4uTQPVHcC%2FdPtdLmNh0EgObct0CA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "d44dae4e682c4fb6ad546dc2f164f2c4",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "title": "футляри до державних нагород",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "title": "Лот №1",
        "auctionUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/6ccc95c340c94e32bcf0b8c2183e62f7_1b75c06ee58f4909a4201255b4ba5831",
        "auctionPeriod": {
          "startDate": "2020-05-15T01:00:00+03:00",
          "shouldStartAfter": "2020-05-16T00:00:00+03:00"
        },
        "value": {
          "currency": "UAH",
          "amount": 600.666,
          "valueAddedTaxIncluded": true
        },
        "minimalStep": {
          "currency": "UAH",
          "amount": 3.0033300000000005,
          "valueAddedTaxIncluded": true
        },
        "date": "2020-05-15T01:00:00+03:00",
        "id": "1b75c06ee58f4909a4201255b4ba5831",
        "guarantee": {
          "currency": "USD",
          "amount": 8.0
        }
      }
    ],
    "tenderID": "UA-2020-05-15-000004",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "agreements": [
      {
        "agreementID": "UA-2018-09-11-000002-1",
        "status": "active",
        "features": [
          {
            "code": "OCDS-123454-AIR-INTAKE",
            "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
            "title": "Потужність всмоктування",
            "enum": [
              {
                "value": 0.1,
                "title": "До 1000 Вт"
              },
              {
                "value": 0.15,
                "title": "Більше 1000 Вт"
              }
            ],
            "title_en": "Air Intake",
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "featureOf": "item"
          },
          {
            "code": "OCDS-123454-YEARS",
            "description": "Кількість років, які організація учасник працює на ринку",
            "title": "Років на ринку",
            "enum": [
              {
                "value": 0.05,
                "title": "До 3 років"
              },
              {
                "value": 0.1,
                "title": "Більше 3 років, менше 5 років"
              },
              {
                "value": 0.15,
                "title": "Більше 5 років"
              }
            ],
            "title_en": "Years trading",
            "featureOf": "tenderer"
          }
        ],
        "title": "[ТЕСТУВАННЯ] ",
        "contracts": [
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "large",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037256",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "0a292b6466274139ad3d973fd64830ff",
            "date": "2018-07-30T17:40:15.471158+03:00",
            "awardID": "d7406b07c05b4796bb168a7c47ee7d31",
            "id": "d6cd8c3188d74e1481a9cebb57fd9329"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037257",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.666,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "unsuccessful",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами 1",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами 1",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037251",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.666,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037258",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "fc02090c338a477f8013156a4fa2da10",
            "date": "2018-07-30T17:40:15.471264+03:00",
            "awardID": "a915a07f7f0b4dafa583cce119bf1823",
            "id": "d925d6c6124447d581f2ae5f52ba710f"
          }
        ],
        "items": [
          {
            "description": "футляри до державних нагород",
            "classification": {
              "scheme": "ДК021",
              "description": "Cartons",
              "id": "44617100-9"
            },
            "description_en": "Cases for state awards",
            "additionalClassifications": [
              {
                "scheme": "ДКПП",
                "id": "17.21.1",
                "description": "папір і картон гофровані, паперова й картонна тара"
              }
            ],
            "deliveryAddress": {
              "postalCode": "79000",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "deliveryDate": {
              "startDate": "2018-06-27T13:39:09.362837+03:00",
              "endDate": "2018-06-30T13:39:09.362837+03:00"
            },
            "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "unit": {
              "code": "44617100-9",
              "name": "item"
            },
            "quantity": 5.0
          }
        ],
        "title_en": "[TESTING] ",
        "period": {
          "startDate": "2018-09-11T11:23:20.418390+03:00",
          "endDate": "2022-01-23T11:23:20.418436+03:00"
        },
        "dateSigned": "2018-09-11T11:23:23.220310+03:00",
        "id": "106468013e6f47398b6f2f4da3bdeba6",
        "procuringEntity": {
          "kind": "general",
          "name": "Шевченківська районна в місті Києві державна адміністрація",
          "address": {
            "postalCode": "01030",
            "countryName": "Україна",
            "streetAddress": "Богдана Хмельницького вулиця, 21-29",
            "region": "Київська область",
            "locality": "Переяслав-Хмельницький"
          },
          "contactPoint": {
            "name": "Ліповець Євген Іванович",
            "url": "http://www.shev.gov.ua/",
            "telephone": "2341170",
            "faxNumber": "2343591",
            "name_en": "Gregory Gillespie",
            "email": "buh510@ukr.net",
            "availableLanguage": "en"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\"",
            "id": "00037256",
            "legalName": "Шевченківська районна в місті Києві державна адміністрація"
          },
          "name_en": "Angelica Davis"
        },
        "numberOfContracts": 3,
        "mode": "test",
        "title_ru": "[ТЕСТИРОВАНИЕ] ",
        "owner": "broker",
        "dateModified": "2018-09-17T16:26:31.372995+03:00",
        "tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32"
      }
    ],
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2020-05-11T01:00:00+03:00",
      "endDate": "2020-05-15T01:00:00+03:00"
    },
    "auctionPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00"
    },
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "date": "2020-05-15T01:00:00+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 3.0033300000000005,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 6.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 600.666,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

Учасники можуть дізнатись свої URL-адреси для участі через свої пропозиції:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/436a89f5f496498fa9134f3caedb168d?acc_token=ebff7d432d3d4d0a8756f67f9bb07ef5 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": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/436a89f5f496498fa9134f3caedb168d/documents/ec90a6e35c674a8eafa7fe0958a50a8c?download=396c2bbf6e0c4ea1aa1292ff2f195d11",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "ec90a6e35c674a8eafa7fe0958a50a8c",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "date": "2020-05-15T01:00:00+03:00",
        "value": {
          "currency": "UAH",
          "amount": 500.0,
          "valueAddedTaxIncluded": true
        },
        "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/6ccc95c340c94e32bcf0b8c2183e62f7_1b75c06ee58f4909a4201255b4ba5831?key_for_bid=436a89f5f496498fa9134f3caedb168d"
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "large",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "date": "2020-05-15T01:00:00+03:00",
    "id": "436a89f5f496498fa9134f3caedb168d"
  }
}

Дивіться на Bid.participationUrl у відповіді. Схожу, але іншу, URL-адресу можна отримати для інших учасників:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3232808966140b4817970455ae7c99e?acc_token=8c1be9249ea8445480b4c4e3ec6ee974 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": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part1.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3232808966140b4817970455ae7c99e/documents/62d42fd055ad4447b9025faab11e1af1?download=f4853348bbbc4a6faa08d0e2891ea2e8",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "62d42fd055ad4447b9025faab11e1af1",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3232808966140b4817970455ae7c99e/documents/a88535d579b44921bd723845d97bdb5c?download=e8f2a6a130ba44bb8e93f4056a8dbab7",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "a88535d579b44921bd723845d97bdb5c",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "date": "2020-05-15T01:00:00+03:00",
        "value": {
          "currency": "UAH",
          "amount": 499.0,
          "valueAddedTaxIncluded": true
        },
        "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/6ccc95c340c94e32bcf0b8c2183e62f7_1b75c06ee58f4909a4201255b4ba5831?key_for_bid=d3232808966140b4817970455ae7c99e"
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "date": "2020-05-15T01:00:00+03:00",
    "id": "d3232808966140b4817970455ae7c99e"
  }
}

Список awards

Cписок аwards в статусі pending можна отримати за запитом:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards 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": "pending",
      "lotID": "1b75c06ee58f4909a4201255b4ba5831",
      "suppliers": [
        {
          "contactPoint": {
            "name": "Державне управління справами",
            "telephone": "0440000000"
          },
          "scale": "micro",
          "name": "Державне управління справами",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00037257",
            "uri": "http://www.dus.gov.ua/"
          },
          "address": {
            "postalCode": "01220",
            "countryName": "Україна",
            "streetAddress": "вул. Банкова, 11, корпус 1",
            "region": "м. Київ",
            "locality": "м. Київ"
          }
        }
      ],
      "bid_id": "d3232808966140b4817970455ae7c99e",
      "value": {
        "currency": "UAH",
        "amount": 499.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2020-05-15T01:00:00+03:00",
      "id": "d08a35e2285e472b96759a1401934d88"
    }
  ]
}

Підтвердження кваліфікації

Спробуємо дискваліфікувати award, перевівши його зі статусу pending в unsuccessful.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/d08a35e2285e472b96759a1401934d88?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 36
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "unsuccessful"
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Can't update award status to unsuccessful, if tender status is active.qualification and there is no cancelled award with the same bid_id",
      "location": "body",
      "name": "data"
    }
  ]
}

Бачимо, що це неможливо. Замовник спочатку має активувати award в статусі pending, а потім перевести його в статус cancelled.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/d08a35e2285e472b96759a1401934d88?acc_token=794fefa6abd34c81a289161fadb1feb4 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",
    "lotID": "1b75c06ee58f4909a4201255b4ba5831",
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "bid_id": "d3232808966140b4817970455ae7c99e",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:00+03:00",
    "id": "d08a35e2285e472b96759a1401934d88"
  }
}

Скасовуємо активний award.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/d08a35e2285e472b96759a1401934d88?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "cancelled"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/19ec6d107424404daa2b35ae7a2d2c17
{
  "data": {
    "status": "cancelled",
    "lotID": "1b75c06ee58f4909a4201255b4ba5831",
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "bid_id": "d3232808966140b4817970455ae7c99e",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:00+03:00",
    "id": "d08a35e2285e472b96759a1401934d88"
  }
}

Бачимо, що згенеровано новий award в статусі pending для того ж Учасника. Тепер Замовник може успішно перевести award з статусу pending в unsuccessful.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/19ec6d107424404daa2b35ae7a2d2c17?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 36
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "unsuccessful"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/1c87ef6c69a34696b307f78e1d9839e7
{
  "data": {
    "status": "unsuccessful",
    "lotID": "1b75c06ee58f4909a4201255b4ba5831",
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "bid_id": "d3232808966140b4817970455ae7c99e",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:00+03:00",
    "id": "19ec6d107424404daa2b35ae7a2d2c17"
  }
}

Спробуємо завантажити документ пов’язаний з контрактом

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/19ec6d107424404daa2b35ae7a2d2c17/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 327
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1addeea14e464014a69fc26373ed4ce7?KeyID=a8968c46&Signature=g3SinQzaISnyJ4e7X8K4Z%2FVqYvM4ZWY0FbYCDZEG2futZNssj%2BsGwtbiZkrrbJBpRZjugaWzQgQX2aBrnUt6Cw%3D%3D",
    "title": "explanation.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/19ec6d107424404daa2b35ae7a2d2c17/documents/c439f494fdd44059b2688d79f9d32a04
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "explanation.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1addeea14e464014a69fc26373ed4ce7?KeyID=a8968c46&Signature=cFYAgXTGMi6MvJJXxnFQ89WDxivteFxIDAS16fb1M9b11BvxQuV32fIuXGGM8lm3JXP6xXMqSsV5FZvJ2PKtDQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "c439f494fdd44059b2688d79f9d32a04",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

Кваліфікаційна комісія реєструє своє рішення через такий виклик:

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/1c87ef6c69a34696b307f78e1d9839e7?acc_token=794fefa6abd34c81a289161fadb1feb4 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",
    "lotID": "1b75c06ee58f4909a4201255b4ba5831",
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037258",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "bid_id": "8b1da1dc1b524064a338596d48503f66",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:00+03:00",
    "id": "1c87ef6c69a34696b307f78e1d9839e7"
  }
}

Замовник має заповнити інформацію про продовження терміну дії Учасника в полі description.

Встановлення вартості контракту

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

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

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 91
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "contractNumber": "contract #13111",
    "value": {
      "amount": 238,
      "amountNet": 230
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 6.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037258",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:00+03:00",
    "awardID": "1c87ef6c69a34696b307f78e1d9839e7",
    "id": "632f182366214a9aa18a7cbe72724559",
    "contractID": "UA-2020-05-15-000004-2"
  }
}

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

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

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

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

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559?acc_token=794fefa6abd34c81a289161fadb1feb4 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
null

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

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

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559?acc_token=794fefa6abd34c81a289161fadb1feb4 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": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 6.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037258",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "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:00+03:00",
    "awardID": "1c87ef6c69a34696b307f78e1d9839e7",
    "id": "632f182366214a9aa18a7cbe72724559",
    "contractID": "UA-2020-05-15-000004-2"
  }
}

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

Спробуємо завантажити документ пов’язаний з контрактом:

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 338
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f746bb86abe44069b70422d6460b960?KeyID=a8968c46&Signature=GWgm3s9sT2xN6SXHM4C6PzpgGMUgV69PdCwE3MKfp1Vckf4rqPP1BwSutTIkpQuFcn00ktU543itmxYgkFxgCA%3D%3D",
    "title": "contract_first_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents/9902e5df539b4e97a6da5707e6a3d77f
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_first_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f746bb86abe44069b70422d6460b960?KeyID=a8968c46&Signature=pSYFHP3nW5EEk%2FIRb2QtEpFxYLsjj6qRelcysPR0of3o%2Fw7RiugEvP0mQ0%252BTwF%2FI9tUIUc6MDtRrLGReXyaRCw%253D%253D",
    "format": "application/msword",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "9902e5df539b4e97a6da5707e6a3d77f",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

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

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents 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/0f746bb86abe44069b70422d6460b960?KeyID=a8968c46&Signature=pSYFHP3nW5EEk%2FIRb2QtEpFxYLsjj6qRelcysPR0of3o%2Fw7RiugEvP0mQ0%252BTwF%2FI9tUIUc6MDtRrLGReXyaRCw%253D%253D",
      "format": "application/msword",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "9902e5df539b4e97a6da5707e6a3d77f",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

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

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 347
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/99561094e8ff41baa176155995a9e23c?KeyID=a8968c46&Signature=XR7Q0FBAjJfMChcHbnJayqL5nEDZrd7%2BQbj2eXFhKfFOnwpkv%2Bsj2brsD%2FVglEK%2BaSQFyxr7Bmf0VaCqFmpJDw%3D%3D",
    "title": "contract_second_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents/8dc5f3262f44446b969c08dcd70d64d7
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_second_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/99561094e8ff41baa176155995a9e23c?KeyID=a8968c46&Signature=ecUmeR1kbP138C3RdAt76nq%2FPC6qYvVU9Kei5DuhrS72l%252BFJQh4GqCxMJAslC1VhN391Az%2FifrpGFIfPIgJmAQ%253D%253D",
    "format": "application/msword",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "8dc5f3262f44446b969c08dcd70d64d7",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

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

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents 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_second_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/99561094e8ff41baa176155995a9e23c?KeyID=a8968c46&Signature=ecUmeR1kbP138C3RdAt76nq%2FPC6qYvVU9Kei5DuhrS72l%252BFJQh4GqCxMJAslC1VhN391Az%2FifrpGFIfPIgJmAQ%253D%253D",
      "format": "application/msword",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "8dc5f3262f44446b969c08dcd70d64d7",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f746bb86abe44069b70422d6460b960?KeyID=a8968c46&Signature=pSYFHP3nW5EEk%2FIRb2QtEpFxYLsjj6qRelcysPR0of3o%2Fw7RiugEvP0mQ0%252BTwF%2FI9tUIUc6MDtRrLGReXyaRCw%253D%253D",
      "format": "application/msword",
      "datePublished": "2020-05-15T01:00:00+03:00",
      "id": "9902e5df539b4e97a6da5707e6a3d77f",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

Встановити дату підписання контракту

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

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559?acc_token=794fefa6abd34c81a289161fadb1feb4 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
null

Реєстрація контракту

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559?acc_token=794fefa6abd34c81a289161fadb1feb4 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/0f746bb86abe44069b70422d6460b960?KeyID=a8968c46&Signature=pSYFHP3nW5EEk%2FIRb2QtEpFxYLsjj6qRelcysPR0of3o%2Fw7RiugEvP0mQ0%252BTwF%2FI9tUIUc6MDtRrLGReXyaRCw%253D%253D",
        "format": "application/msword",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "9902e5df539b4e97a6da5707e6a3d77f",
        "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/99561094e8ff41baa176155995a9e23c?KeyID=a8968c46&Signature=ecUmeR1kbP138C3RdAt76nq%2FPC6qYvVU9Kei5DuhrS72l%252BFJQh4GqCxMJAslC1VhN391Az%2FifrpGFIfPIgJmAQ%253D%253D",
        "format": "application/msword",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "8dc5f3262f44446b969c08dcd70d64d7",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2020-05-17T01:00:00+03:00",
          "endDate": "2020-05-20T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 6.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037258",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "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:00+03:00",
    "awardID": "1c87ef6c69a34696b307f78e1d9839e7",
    "id": "632f182366214a9aa18a7cbe72724559",
    "contractID": "UA-2020-05-15-000004-2"
  }
}

Більше інформації про поведінку контрактів можна побачити тут: Contracting API для реєстрації даних пов’язаних з договором.

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

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

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

  1. Приготуйте запит на скасування
  2. Наповніть його протоколом про причини скасування
  3. Скасуйте закупівлю через подані причини.

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

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

Формування запиту на скасування

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

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

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

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations?acc_token=794fefa6abd34c81a289161fadb1feb4 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/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/be7b1bfcbe9a4d6abca8dd39e5e1caf3
{
  "data": {
    "status": "draft",
    "reason": "cancellation reason",
    "reasonType": "noDemand",
    "date": "2020-05-15T01:00:00+03:00",
    "cancellationOf": "tender",
    "id": "be7b1bfcbe9a4d6abca8dd39e5e1caf3"
  }
}

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

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

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

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/be7b1bfcbe9a4d6abca8dd39e5e1caf3/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 324
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4bc35d2c863844b4a951f9ad7a7c3422?KeyID=a8968c46&Signature=ay27Vp7P3jwF2D6XQmxeUkF7gRhhqMfPq%2FWi2aaO70I2E%2Fj0PPPrAVFYMcT4PUpxP8gu%2FXP3Wi37qI2bnIR6BA%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/be7b1bfcbe9a4d6abca8dd39e5e1caf3/documents/e0a0e3e67b6243db85c6a4800eacc365
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4bc35d2c863844b4a951f9ad7a7c3422?KeyID=a8968c46&Signature=vVwW2Pnc5ejmkSqNdboN37wa3V4ltqaQZu2pY0usENv209SCO8ToI%2FSyx9uGjZ5%2FNLA6V8HfpSxOghFgK0ssDg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "e0a0e3e67b6243db85c6a4800eacc365",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

Зміна опису документа та інших властивостей

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/be7b1bfcbe9a4d6abca8dd39e5e1caf3/documents/e0a0e3e67b6243db85c6a4800eacc365?acc_token=794fefa6abd34c81a289161fadb1feb4 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/4bc35d2c863844b4a951f9ad7a7c3422?KeyID=a8968c46&Signature=vVwW2Pnc5ejmkSqNdboN37wa3V4ltqaQZu2pY0usENv209SCO8ToI%2FSyx9uGjZ5%2FNLA6V8HfpSxOghFgK0ssDg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "e0a0e3e67b6243db85c6a4800eacc365",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

PUT /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/be7b1bfcbe9a4d6abca8dd39e5e1caf3/documents/e0a0e3e67b6243db85c6a4800eacc365?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 320
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/7f0db24e96b840119a36e08f003d9268?KeyID=a8968c46&Signature=CB1XYNG1ENUU8GBBhDrWdNITTC7YmKyitZ8aXWbYWKZPNHMVW9zFhnAeOG8rgR3GHtZNXl7WJ7xP2TGVHDjbBg%3D%3D",
    "title": "Notice-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

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/7f0db24e96b840119a36e08f003d9268?KeyID=a8968c46&Signature=22jMWSDGxJLq9%252BWiDY2%252BZ4%2FJVxRWKdEG6A6NB%252BCVi%2FkxEbGhpnmbsTS%252BQ4tf3jSVKG%2FHtZRY77p3F4dzeGiJCg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:00+03:00",
    "id": "e0a0e3e67b6243db85c6a4800eacc365",
    "dateModified": "2020-05-15T01:00:00+03:00"
  }
}

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

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/be7b1bfcbe9a4d6abca8dd39e5e1caf3?acc_token=794fefa6abd34c81a289161fadb1feb4 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",
        "description": "Changed description",
        "title": "Notice.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4bc35d2c863844b4a951f9ad7a7c3422?KeyID=a8968c46&Signature=vVwW2Pnc5ejmkSqNdboN37wa3V4ltqaQZu2pY0usENv209SCO8ToI%2FSyx9uGjZ5%2FNLA6V8HfpSxOghFgK0ssDg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "e0a0e3e67b6243db85c6a4800eacc365",
        "dateModified": "2020-05-15T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/7f0db24e96b840119a36e08f003d9268?KeyID=a8968c46&Signature=22jMWSDGxJLq9%252BWiDY2%252BZ4%2FJVxRWKdEG6A6NB%252BCVi%2FkxEbGhpnmbsTS%252BQ4tf3jSVKG%2FHtZRY77p3F4dzeGiJCg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:00+03:00",
        "id": "e0a0e3e67b6243db85c6a4800eacc365",
        "dateModified": "2020-05-15T01:00:00+03:00"
      }
    ],
    "reason": "cancellation reason",
    "reasonType": "noDemand",
    "date": "2020-05-15T01:00:00+03:00",
    "cancellationOf": "tender",
    "id": "be7b1bfcbe9a4d6abca8dd39e5e1caf3"
  }
}

Можливо, буде корисно побачити актуальні вимоги: Сценарії ручного тестування для III рівня акредитації і Сценарії ручного тестування для IV рівня акредитації.