Туторіал

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

Подивимось як працює точка входу /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: 2949
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": "goods",
    "tenderPeriod": {
      "endDate": "2020-05-29T01:00:00+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 15
    },
    "enquiryPeriod": {
      "endDate": "2020-05-22T01:00:00+03:00"
    },
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне управління справами",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "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"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680
{
  "access": {
    "transfer": "4ae74e3cbdfe48b9bd446eb70fcee238",
    "token": "e6bb69a4c5474e4987130585951b6f3e"
  },
  "data": {
    "procurementMethod": "open",
    "status": "active.enquiries",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "af069a25c8f94e74a8b2428b51bcd1a7"
      }
    ],
    "mainProcurementCategory": "goods",
    "tenderPeriod": {
      "startDate": "2020-05-22T01:00:00+03:00",
      "endDate": "2020-05-29T01:00:00+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 15.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "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": "53de0c90af0e430ea270c5970351ba0c",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2020-05-15T01:00:00+03:00",
    "next_check": "2020-05-22T01:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне управління справами",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "awardCriteria": "lowestCost",
    "enquiryPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-22T01:00:00+03:00"
    },
    "owner": "broker",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "id": "bc3a9016b29d4fed894cc62d3ff59680",
    "tenderID": "UA-2020-05-15-000001"
  }
}

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

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

GET /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680 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": "open",
    "status": "active.enquiries",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "af069a25c8f94e74a8b2428b51bcd1a7"
      }
    ],
    "mainProcurementCategory": "goods",
    "tenderPeriod": {
      "startDate": "2020-05-22T01:00:00+03:00",
      "endDate": "2020-05-29T01:00:00+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 15.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "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": "53de0c90af0e430ea270c5970351ba0c",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2020-05-15T01:00:00+03:00",
    "next_check": "2020-05-22T01:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне управління справами",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "awardCriteria": "lowestCost",
    "enquiryPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-22T01:00:00+03:00"
    },
    "owner": "broker",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "id": "bc3a9016b29d4fed894cc62d3ff59680",
    "tenderID": "UA-2020-05-15-000001"
  }
}

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

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

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": "bc3a9016b29d4fed894cc62d3ff59680",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

Ми бачимо внутрішнє 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: 4584
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing"
      }
    ],
    "mainProcurementCategory": "services",
    "tenderPeriod": {
      "endDate": "2020-05-29T00:00:00+02:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "enquiryPeriod": {
      "endDate": "2020-05-22T00:00:00+02:00"
    },
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "mode": "test",
    "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": "м. Київ"
      }
    },
    "title_ru": "футляры к государственным наградам",
    "items": [
      {
        "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": "2f4859b56059422a99bc049e22039809",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "title_en": "Cases with state awards",
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "2f4859b56059422a99bc049e22039809",
        "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"
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/17edf8a737ff45e19054a293f439f8f7
{
  "access": {
    "transfer": "84f61b780ca744ad8bf1bafc44cf9a0a",
    "token": "8b6dbf231e4c4f00a98b3abdede1c370"
  },
  "data": {
    "procurementMethod": "open",
    "mainProcurementCategory": "services",
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "2f4859b56059422a99bc049e22039809",
        "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-15T01:00:00+03:00",
      "endDate": "2020-05-22T00:00:00+02:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-05-22T01:00:00+03:00",
    "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": "м. Київ"
      }
    },
    "owner": "broker",
    "id": "17edf8a737ff45e19054a293f439f8f7",
    "title": "[ТЕСТУВАННЯ] футляри до державних нагород",
    "tenderID": "UA-2020-05-15-000002",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "status": "active.enquiries",
    "tenderPeriod": {
      "startDate": "2020-05-22T00:00:00+02:00",
      "endDate": "2020-05-29T00:00:00+02:00"
    },
    "procurementMethodType": "belowThreshold",
    "title_en": "[TESTING] Cases with state awards",
    "date": "2020-05-15T01:00:00+03:00",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "bd1562f18e7845369bf252e44b20d082"
      }
    ],
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "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": "2f4859b56059422a99bc049e22039809",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "mode": "test",
    "title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
    "awardCriteria": "lowestCost"
  }
}

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

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

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": "0549e39f4516448292c53e3e4b30e141",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "id": "360cfcaeb0ec43948ba2c03584e41ea0",
      "dateModified": "2020-05-15T01:00:00+03:00"
    },
    {
      "id": "bc3a9016b29d4fed894cc62d3ff59680",
      "dateModified": "2020-05-15T01:00:00+03:00"
    }
  ]
}

Дійсно, в нас зараз є дві закупівлі.

Можливо створювати закупівлю з полем funders, яке є необов’язковим:

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3975
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "funders": [
      {
        "additionalIdentifiers": [],
        "contactPoint": {
          "url": "https://www.theglobalfund.org/en/",
          "faxNumber": "+41 44 580 6820",
          "telephone": "+41 58 791 1700",
          "name": "",
          "email": "ccm@theglobalfund.org"
        },
        "identifier": {
          "scheme": "XM-DAC",
          "id": "47045",
          "legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
        },
        "name": "Глобальний фонд",
        "address": {
          "countryName": "Швейцарська Конфедерація",
          "postalCode": "1218",
          "region": "Grand-Saconnex",
          "streetAddress": "Global Health Campus, Chemin du Pommier 40",
          "locality": "Geneva"
        }
      }
    ],
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing"
      }
    ],
    "mainProcurementCategory": "goods",
    "tenderPeriod": {
      "endDate": "2020-05-29T01:00:00+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 15
    },
    "enquiryPeriod": {
      "endDate": "2020-05-22T01:00:00+03:00"
    },
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/",
        "legalName": "Державне управління справами"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "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"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/360cfcaeb0ec43948ba2c03584e41ea0
{
  "access": {
    "transfer": "0842188b93a94bfda035c3fb6c97c59a",
    "token": "b04f8dbb303a4d1a9f6eaca0b322a8b8"
  },
  "data": {
    "funders": [
      {
        "contactPoint": {
          "url": "https://www.theglobalfund.org/en/",
          "email": "ccm@theglobalfund.org",
          "telephone": "+41 58 791 1700",
          "name": "",
          "faxNumber": "+41 44 580 6820"
        },
        "identifier": {
          "scheme": "XM-DAC",
          "id": "47045",
          "legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
        },
        "name": "Глобальний фонд",
        "address": {
          "postalCode": "1218",
          "countryName": "Швейцарська Конфедерація",
          "streetAddress": "Global Health Campus, Chemin du Pommier 40",
          "region": "Grand-Saconnex",
          "locality": "Geneva"
        }
      }
    ],
    "procurementMethod": "open",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "94f9e1dd7ea74d2a99d4eff7a488a4a4"
      }
    ],
    "mainProcurementCategory": "goods",
    "tenderPeriod": {
      "startDate": "2020-05-22T01:00:00+03:00",
      "endDate": "2020-05-29T01:00:00+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 15.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "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": "e36f862d48e0411c8390ea7a8811c0de",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2020-05-15T01:00:00+03:00",
    "dateModified": "2020-05-15T01:00:00+03:00",
    "status": "active.enquiries",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне управління справами",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "awardCriteria": "lowestCost",
    "enquiryPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-22T01:00:00+03:00"
    },
    "owner": "broker",
    "next_check": "2020-05-22T01:00:00+03:00",
    "id": "360cfcaeb0ec43948ba2c03584e41ea0",
    "tenderID": "UA-2020-05-15-000003"
  }
}

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

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

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680?acc_token=e6bb69a4c5474e4987130585951b6f3e HTTP/1.0
Authorization: Bearer broker
Content-Length: 68
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "tenderPeriod": {
      "endDate": "2020-05-30T01:00:11+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "status": "active.enquiries",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "af069a25c8f94e74a8b2428b51bcd1a7"
      }
    ],
    "mainProcurementCategory": "goods",
    "tenderPeriod": {
      "startDate": "2020-05-22T01:00:00+03:00",
      "endDate": "2020-05-30T01:00:11+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 15.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "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": "53de0c90af0e430ea270c5970351ba0c",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2020-05-15T01:00:00+03:00",
    "next_check": "2020-05-22T01:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне управління справами",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "awardCriteria": "lowestCost",
    "enquiryPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-22T01:00:00+03:00"
    },
    "owner": "broker",
    "dateModified": "2020-05-15T01:00:01+03:00",
    "id": "bc3a9016b29d4fed894cc62d3ff59680",
    "tenderID": "UA-2020-05-15-000001"
  }
}

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

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

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

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

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

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680?acc_token=e6bb69a4c5474e4987130585951b6f3e 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": {
    "funders": [
      {
        "contactPoint": {
          "url": "https://www.theglobalfund.org/en/",
          "email": "ccm@theglobalfund.org",
          "telephone": "+41 58 791 1700",
          "name": "",
          "faxNumber": "+41 44 580 6820"
        },
        "identifier": {
          "scheme": "XM-DAC",
          "id": "47045",
          "legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
        },
        "name": "Глобальний фонд",
        "address": {
          "postalCode": "1218",
          "countryName": "Швейцарська Конфедерація",
          "streetAddress": "Global Health Campus, Chemin du Pommier 40",
          "region": "Grand-Saconnex",
          "locality": "Geneva"
        }
      }
    ],
    "procurementMethod": "open",
    "mainProcurementCategory": "goods",
    "enquiryPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-22T01:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-05-22T01:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне управління справами",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker",
    "id": "bc3a9016b29d4fed894cc62d3ff59680",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    },
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-15-000001",
    "dateModified": "2020-05-15T01:00:01+03:00",
    "status": "active.enquiries",
    "tenderPeriod": {
      "startDate": "2020-05-22T01:00:00+03:00",
      "endDate": "2020-05-30T01:00:11+03:00"
    },
    "procurementMethodType": "belowThreshold",
    "date": "2020-05-15T01:00:00+03:00",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "af069a25c8f94e74a8b2428b51bcd1a7"
      }
    ],
    "minimalStep": {
      "currency": "UAH",
      "amount": 15.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "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": "53de0c90af0e430ea270c5970351ba0c",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

Також можна оновлювати закупівлю шляхом додавання поля funders:

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680?acc_token=e6bb69a4c5474e4987130585951b6f3e HTTP/1.0
Authorization: Bearer broker
Content-Length: 1036
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "funders": [
      {
        "additionalIdentifiers": [],
        "contactPoint": {
          "url": "https://www.theglobalfund.org/en/",
          "faxNumber": "+41 44 580 6820",
          "telephone": "+41 58 791 1700",
          "name": "",
          "email": "ccm@theglobalfund.org"
        },
        "identifier": {
          "scheme": "XM-DAC",
          "id": "47045",
          "legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
        },
        "name": "Глобальний фонд",
        "address": {
          "countryName": "Швейцарська Конфедерація",
          "postalCode": "1218",
          "region": "Grand-Saconnex",
          "streetAddress": "Global Health Campus, Chemin du Pommier 40",
          "locality": "Geneva"
        }
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "funders": [
      {
        "contactPoint": {
          "url": "https://www.theglobalfund.org/en/",
          "email": "ccm@theglobalfund.org",
          "telephone": "+41 58 791 1700",
          "name": "",
          "faxNumber": "+41 44 580 6820"
        },
        "identifier": {
          "scheme": "XM-DAC",
          "id": "47045",
          "legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
        },
        "name": "Глобальний фонд",
        "address": {
          "postalCode": "1218",
          "countryName": "Швейцарська Конфедерація",
          "streetAddress": "Global Health Campus, Chemin du Pommier 40",
          "region": "Grand-Saconnex",
          "locality": "Geneva"
        }
      }
    ],
    "procurementMethod": "open",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "af069a25c8f94e74a8b2428b51bcd1a7"
      }
    ],
    "mainProcurementCategory": "goods",
    "tenderPeriod": {
      "startDate": "2020-05-22T01:00:00+03:00",
      "endDate": "2020-05-30T01:00:11+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 15.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "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": "53de0c90af0e430ea270c5970351ba0c",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "belowThreshold",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2020-05-15T01:00:00+03:00",
    "dateModified": "2020-05-15T01:00:01+03:00",
    "status": "active.enquiries",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне управління справами",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "awardCriteria": "lowestCost",
    "enquiryPeriod": {
      "startDate": "2020-05-15T01:00:00+03:00",
      "endDate": "2020-05-22T01:00:00+03:00"
    },
    "owner": "broker",
    "next_check": "2020-05-22T01:00:00+03:00",
    "id": "bc3a9016b29d4fed894cc62d3ff59680",
    "tenderID": "UA-2020-05-15-000001"
  }
}

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

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

POST /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/documents?acc_token=e6bb69a4c5474e4987130585951b6f3e HTTP/1.0
Authorization: Bearer broker
Content-Length: 326
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4d52879c11df4aa7ae80d3b6c4a274ce?KeyID=a8968c46&Signature=7a%2BQeAFuPxM%2BlBzTbtjmyV6b7yao2q9L6FPe2GinRg2MZjCXq%2FgudCuxpGsndtgnWoZS16e8z%2BtIfvjZTN2FDQ%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/bc3a9016b29d4fed894cc62d3ff59680/documents/8924acf921d645b7bce35748c4f9e237
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4d52879c11df4aa7ae80d3b6c4a274ce?KeyID=a8968c46&Signature=BiR23Y26fUFdAaBBqxSqN2Lv29UkW8VjpoZA0NLoVj2cgKeSq3J%2FiuGzva%252Bl0R6wpgLbA2zfat9mNkErf3HjAg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:01+03:00",
    "id": "8924acf921d645b7bce35748c4f9e237",
    "dateModified": "2020-05-15T01:00:01+03:00"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:

GET /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/documents/8924acf921d645b7bce35748c4f9e237 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/4d52879c11df4aa7ae80d3b6c4a274ce?KeyID=a8968c46&Signature=BiR23Y26fUFdAaBBqxSqN2Lv29UkW8VjpoZA0NLoVj2cgKeSq3J%2FiuGzva%252Bl0R6wpgLbA2zfat9mNkErf3HjAg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:01+03:00",
    "previousVersions": [],
    "id": "8924acf921d645b7bce35748c4f9e237",
    "dateModified": "2020-05-15T01:00:01+03:00"
  }
}

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

POST /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/documents?acc_token=e6bb69a4c5474e4987130585951b6f3e HTTP/1.0
Authorization: Bearer broker
Content-Length: 337
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/55286412717f4997b35cde1cdc8ca4a3?KeyID=a8968c46&Signature=ph9Z8mccKFxaveM6%2Bn3A%2B4%2FZ4Q%2B5s5%2FnC9ftrwOszdJCAwzBxYsx3in%2BPQjAv7rX6m0ci969F1Sk6I7fvsfKAw%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/bc3a9016b29d4fed894cc62d3ff59680/documents/f05f28fd104147beb09d8b4f7bbcbd2b
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "AwardCriteria.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/55286412717f4997b35cde1cdc8ca4a3?KeyID=a8968c46&Signature=SLJwlJyNeYyhfqlj5fjfDUM5HpgwZKwSFTALjLjeIuv5mzql8Jjjua0WO8iNogqE6c0DA0%252BkyD8utzz3zI27BA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:01+03:00",
    "id": "f05f28fd104147beb09d8b4f7bbcbd2b",
    "dateModified": "2020-05-15T01:00:01+03:00"
  }
}

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

GET /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/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",
      "author": "tender_owner",
      "title": "AwardCriteria.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/55286412717f4997b35cde1cdc8ca4a3?KeyID=a8968c46&Signature=SLJwlJyNeYyhfqlj5fjfDUM5HpgwZKwSFTALjLjeIuv5mzql8Jjjua0WO8iNogqE6c0DA0%252BkyD8utzz3zI27BA%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:01+03:00",
      "id": "f05f28fd104147beb09d8b4f7bbcbd2b",
      "dateModified": "2020-05-15T01:00:01+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description modified",
      "title": "Notice.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4d52879c11df4aa7ae80d3b6c4a274ce?KeyID=a8968c46&Signature=BiR23Y26fUFdAaBBqxSqN2Lv29UkW8VjpoZA0NLoVj2cgKeSq3J%2FiuGzva%252Bl0R6wpgLbA2zfat9mNkErf3HjAg%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:01+03:00",
      "author": "tender_owner",
      "documentType": "technicalSpecifications",
      "id": "8924acf921d645b7bce35748c4f9e237",
      "dateModified": "2020-05-15T01:00:01+03:00"
    }
  ]
}

Додамо нове поле documentType з параметром technicalSpecifications до вже завантаженого документа.

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/documents/8924acf921d645b7bce35748c4f9e237?acc_token=e6bb69a4c5474e4987130585951b6f3e 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/4d52879c11df4aa7ae80d3b6c4a274ce?KeyID=a8968c46&Signature=BiR23Y26fUFdAaBBqxSqN2Lv29UkW8VjpoZA0NLoVj2cgKeSq3J%2FiuGzva%252Bl0R6wpgLbA2zfat9mNkErf3HjAg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:01+03:00",
    "documentType": "technicalSpecifications",
    "id": "8924acf921d645b7bce35748c4f9e237",
    "dateModified": "2020-05-15T01:00:01+03:00"
  }
}

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

Можна змінити будь-яке поле в документі. Наприклад, description (опис):

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/documents/8924acf921d645b7bce35748c4f9e237?acc_token=e6bb69a4c5474e4987130585951b6f3e 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/4d52879c11df4aa7ae80d3b6c4a274ce?KeyID=a8968c46&Signature=BiR23Y26fUFdAaBBqxSqN2Lv29UkW8VjpoZA0NLoVj2cgKeSq3J%2FiuGzva%252Bl0R6wpgLbA2zfat9mNkErf3HjAg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:01+03:00",
    "author": "tender_owner",
    "documentType": "technicalSpecifications",
    "id": "8924acf921d645b7bce35748c4f9e237",
    "dateModified": "2020-05-15T01:00:01+03:00"
  }
}

Повернено код 200 OK, тобто опис було успішно відредаговано.

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

PUT /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/documents/f05f28fd104147beb09d8b4f7bbcbd2b?acc_token=e6bb69a4c5474e4987130585951b6f3e HTTP/1.0
Authorization: Bearer broker
Content-Length: 329
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5d1c2cddad3f45a3aac16cb29b81f97f?KeyID=a8968c46&Signature=npRUbqoHqffRhVY5qBagTtnjaBAGXjyYajsdTW3GZUyGT2F%2BxlRNzWG1gny1EIyXTMYSKKgafH485STIakQiBg%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/5d1c2cddad3f45a3aac16cb29b81f97f?KeyID=a8968c46&Signature=E3RouA49wKUWYJ7BPlrzsmaNUW69ZPMHhlKAAOoUy3gSRyJaA98YqWOvmbQ30Z0oCAQ44WCDW4wlwGZV0RXjCA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:01+03:00",
    "id": "f05f28fd104147beb09d8b4f7bbcbd2b",
    "dateModified": "2020-05-15T01:00:01+03:00"
  }
}

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

GET /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/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",
      "author": "tender_owner",
      "title": "AwardCriteria-2.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5d1c2cddad3f45a3aac16cb29b81f97f?KeyID=a8968c46&Signature=E3RouA49wKUWYJ7BPlrzsmaNUW69ZPMHhlKAAOoUy3gSRyJaA98YqWOvmbQ30Z0oCAQ44WCDW4wlwGZV0RXjCA%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:01+03:00",
      "id": "f05f28fd104147beb09d8b4f7bbcbd2b",
      "dateModified": "2020-05-15T01:00:01+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description modified",
      "title": "Notice.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4d52879c11df4aa7ae80d3b6c4a274ce?KeyID=a8968c46&Signature=BiR23Y26fUFdAaBBqxSqN2Lv29UkW8VjpoZA0NLoVj2cgKeSq3J%2FiuGzva%252Bl0R6wpgLbA2zfat9mNkErf3HjAg%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:01+03:00",
      "author": "tender_owner",
      "documentType": "technicalSpecifications",
      "id": "8924acf921d645b7bce35748c4f9e237",
      "dateModified": "2020-05-15T01:00:01+03:00"
    }
  ]
}

Уточнення

Коли закупівля має статус active.enquiry, зацікавлені сторони можуть задавати питання:

POST /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/questions HTTP/1.0
Authorization: Bearer broker
Content-Length: 1147
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "author": {
      "contactPoint": {
        "email": "aagt@gmail.com",
        "telephone": "+380 (322) 91-69-30",
        "name": "Андрій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00137226",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Книга»",
      "address": {
        "countryName": "Україна",
        "postalCode": "79013",
        "region": "Львівська область",
        "streetAddress": "вул. Островського, 34",
        "locality": "м. Львів"
      }
    },
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/questions/3f751fcae5fa40be86e8b38392376e1c
{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "author": {
      "contactPoint": {
        "email": "aagt@gmail.com",
        "telephone": "+380 (322) 91-69-30",
        "name": "Андрій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00137226",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Книга»",
      "address": {
        "postalCode": "79013",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 34",
        "region": "Львівська область",
        "locality": "м. Львів"
      }
    },
    "title": "Калорійність",
    "date": "2020-05-15T01:00:01+03:00",
    "id": "3f751fcae5fa40be86e8b38392376e1c",
    "questionOf": "tender"
  }
}

Замовник може на них відповісти:

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/questions/3f751fcae5fa40be86e8b38392376e1c?acc_token=e6bb69a4c5474e4987130585951b6f3e HTTP/1.0
Authorization: Bearer broker
Content-Length: 162
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "dateAnswered": "2020-05-15T01:00:01+03:00",
    "title": "Калорійність",
    "date": "2020-05-15T01:00:01+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "3f751fcae5fa40be86e8b38392376e1c",
    "questionOf": "tender"
  }
}

Можна отримати список запитань:

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "description": "Просимо додати таблицю потрібної калорійності харчування",
      "dateAnswered": "2020-05-15T01:00:01+03:00",
      "title": "Калорійність",
      "date": "2020-05-15T01:00:01+03:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "id": "3f751fcae5fa40be86e8b38392376e1c",
      "questionOf": "tender"
    }
  ]
}

та окрему відповідь:

GET /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/questions/3f751fcae5fa40be86e8b38392376e1c HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "dateAnswered": "2020-05-15T01:00:01+03:00",
    "title": "Калорійність",
    "date": "2020-05-15T01:00:01+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "3f751fcae5fa40be86e8b38392376e1c",
    "questionOf": "tender"
  }
}

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

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

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

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

POST /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 822
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "draft",
    "value": {
      "amount": 500
    },
    "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: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids/74c272933f3046b0a4cdcc7036b67323
{
  "access": {
    "transfer": "60daccc06c3b4e6e99bdc2cab5c0cf3b",
    "token": "7a7e299c46ba4430a2a63af9bf91af30"
  },
  "data": {
    "date": "2020-05-15T01:00:01+03:00",
    "status": "draft",
    "id": "74c272933f3046b0a4cdcc7036b67323",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "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": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ]
  }
}

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

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids/74c272933f3046b0a4cdcc7036b67323?acc_token=7a7e299c46ba4430a2a63af9bf91af30 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": {
    "date": "2020-05-15T01:00:01+03:00",
    "status": "active",
    "id": "74c272933f3046b0a4cdcc7036b67323",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "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": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ]
  }
}

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

POST /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids/74c272933f3046b0a4cdcc7036b67323/documents?acc_token=7a7e299c46ba4430a2a63af9bf91af30 HTTP/1.0
Authorization: Bearer broker
Content-Length: 326
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/748412273ae54b27a3606febdfe1bc93?KeyID=a8968c46&Signature=0gHtzFKeoxkECnFoc0HuU%2F%2FHQpTQYqVVBHaCchfOuSs81NZZk%2FBtrnD9flS1KvtbmKujffPZjY9fqK97ISGZAA%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/bc3a9016b29d4fed894cc62d3ff59680/bids/74c272933f3046b0a4cdcc7036b67323/documents/a37bf33d76374160ba0da18168a744ca
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Proposal.pdf",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids/74c272933f3046b0a4cdcc7036b67323/documents/a37bf33d76374160ba0da18168a744ca?download=748412273ae54b27a3606febdfe1bc93",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:01+03:00",
    "id": "a37bf33d76374160ba0da18168a744ca",
    "dateModified": "2020-05-15T01:00:01+03:00"
  }
}

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

GET /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids/74c272933f3046b0a4cdcc7036b67323/documents?acc_token=7a7e299c46ba4430a2a63af9bf91af30 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/bc3a9016b29d4fed894cc62d3ff59680/bids/74c272933f3046b0a4cdcc7036b67323/documents/a37bf33d76374160ba0da18168a744ca?download=748412273ae54b27a3606febdfe1bc93",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:01+03:00",
      "id": "a37bf33d76374160ba0da18168a744ca",
      "dateModified": "2020-05-15T01:00:01+03:00"
    }
  ]
}

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

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

POST /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 1438
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "documents": [
      {
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/9152e77768004ab1ba6b843902ac3f12?KeyID=a8968c46&Signature=3H0tSgzex8XiKB4e4Nh9ZHKW%2F9u4%2F6Cd2UVGNv1u4QxLxVTRzIYWJU7zUv5IpvsR5YDPEpPrjchy6WOtvXYHBQ%3D%3D",
        "title": "Proposal_part1.pdf",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      },
      {
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/99993315a2cd472f9387941fe22ee6d5?KeyID=a8968c46&Signature=JC61gfgroCheOPgh8ZAwt9xaK3RFgepC%2FJZoBm5B85D4LmmF8%2FPEzhDSakryyJnhFVnlSvMo4f3PwswdPyCgBA%3D%3D",
        "title": "Proposal_part2.pdf",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      }
    ],
    "value": {
      "amount": 499
    },
    "tenderers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "79013",
          "region": "Львівська область",
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів"
        }
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids/b55f6c618ce54efe885dd3202eff3e94
{
  "access": {
    "transfer": "8992310021484143abd2c8a8f5e7a13a",
    "token": "cfa7d625bdd049c79e3dfa84d8835a53"
  },
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part1.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids/b55f6c618ce54efe885dd3202eff3e94/documents/22691d63a4694ac18fa7317ebd185da1?download=9152e77768004ab1ba6b843902ac3f12",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "id": "22691d63a4694ac18fa7317ebd185da1",
        "dateModified": "2020-05-15T01:00:01+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids/b55f6c618ce54efe885dd3202eff3e94/documents/7c11a21581814a23ae4a7e83dd30ae10?download=99993315a2cd472f9387941fe22ee6d5",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "id": "7c11a21581814a23ae4a7e83dd30ae10",
        "dateModified": "2020-05-15T01:00:01+03:00"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "tenderers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "date": "2020-05-15T01:00:01+03:00",
    "id": "b55f6c618ce54efe885dd3202eff3e94"
  }
}

Аукціон

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

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "funders": [
      {
        "contactPoint": {
          "url": "https://www.theglobalfund.org/en/",
          "email": "ccm@theglobalfund.org",
          "telephone": "+41 58 791 1700",
          "name": "",
          "faxNumber": "+41 44 580 6820"
        },
        "identifier": {
          "scheme": "XM-DAC",
          "id": "47045",
          "legalName": "Глобальний Фонд для боротьби зі СНІДом, туберкульозом і малярією"
        },
        "name": "Глобальний фонд",
        "address": {
          "postalCode": "1218",
          "countryName": "Швейцарська Конфедерація",
          "streetAddress": "Global Health Campus, Chemin du Pommier 40",
          "region": "Grand-Saconnex",
          "locality": "Geneva"
        }
      }
    ],
    "procurementMethod": "open",
    "mainProcurementCategory": "goods",
    "auctionUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/bc3a9016b29d4fed894cc62d3ff59680",
    "enquiryPeriod": {
      "startDate": "2020-05-01T01:00:01+03:00",
      "endDate": "2020-05-08T01:00:01+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2020-05-15T01:36:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне управління справами",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "dateAnswered": "2020-05-15T01:00:01+03:00",
        "title": "Калорійність",
        "date": "2020-05-15T01:00:01+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "3f751fcae5fa40be86e8b38392376e1c",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "id": "bc3a9016b29d4fed894cc62d3ff59680",
    "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/4d52879c11df4aa7ae80d3b6c4a274ce?KeyID=a8968c46&Signature=BiR23Y26fUFdAaBBqxSqN2Lv29UkW8VjpoZA0NLoVj2cgKeSq3J%2FiuGzva%252Bl0R6wpgLbA2zfat9mNkErf3HjAg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "author": "tender_owner",
        "documentType": "technicalSpecifications",
        "id": "8924acf921d645b7bce35748c4f9e237",
        "dateModified": "2020-05-15T01:00:01+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/55286412717f4997b35cde1cdc8ca4a3?KeyID=a8968c46&Signature=SLJwlJyNeYyhfqlj5fjfDUM5HpgwZKwSFTALjLjeIuv5mzql8Jjjua0WO8iNogqE6c0DA0%252BkyD8utzz3zI27BA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "id": "f05f28fd104147beb09d8b4f7bbcbd2b",
        "dateModified": "2020-05-15T01:00:01+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5d1c2cddad3f45a3aac16cb29b81f97f?KeyID=a8968c46&Signature=E3RouA49wKUWYJ7BPlrzsmaNUW69ZPMHhlKAAOoUy3gSRyJaA98YqWOvmbQ30Z0oCAQ44WCDW4wlwGZV0RXjCA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "id": "f05f28fd104147beb09d8b4f7bbcbd2b",
        "dateModified": "2020-05-15T01:00:01+03:00"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderID": "UA-2020-05-15-000001",
    "dateModified": "2020-05-15T01:00:01+03:00",
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2020-05-08T01:00:01+03:00",
      "endDate": "2020-05-15T01:00:01+03:00"
    },
    "auctionPeriod": {
      "startDate": "2020-05-15T01:00:01+03:00",
      "shouldStartAfter": "2020-05-16T00:00:00+03:00"
    },
    "procurementMethodType": "belowThreshold",
    "date": "2020-05-15T01:00:00+03:00",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "af069a25c8f94e74a8b2428b51bcd1a7"
      }
    ],
    "minimalStep": {
      "currency": "UAH",
      "amount": 15.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "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": "53de0c90af0e430ea270c5970351ba0c",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

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

GET /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids/74c272933f3046b0a4cdcc7036b67323?acc_token=7a7e299c46ba4430a2a63af9bf91af30 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/bc3a9016b29d4fed894cc62d3ff59680/bids/74c272933f3046b0a4cdcc7036b67323/documents/a37bf33d76374160ba0da18168a744ca?download=748412273ae54b27a3606febdfe1bc93",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "id": "a37bf33d76374160ba0da18168a744ca",
        "dateModified": "2020-05-15T01:00:01+03:00"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "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": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "Вінницька область",
          "locality": "м. Вінниця"
        }
      }
    ],
    "date": "2020-05-15T01:00:01+03:00",
    "id": "74c272933f3046b0a4cdcc7036b67323",
    "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/bc3a9016b29d4fed894cc62d3ff59680?key_for_bid=74c272933f3046b0a4cdcc7036b67323"
  }
}

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

GET /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids/b55f6c618ce54efe885dd3202eff3e94?acc_token=cfa7d625bdd049c79e3dfa84d8835a53 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/bc3a9016b29d4fed894cc62d3ff59680/bids/b55f6c618ce54efe885dd3202eff3e94/documents/22691d63a4694ac18fa7317ebd185da1?download=9152e77768004ab1ba6b843902ac3f12",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "id": "22691d63a4694ac18fa7317ebd185da1",
        "dateModified": "2020-05-15T01:00:01+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/bids/b55f6c618ce54efe885dd3202eff3e94/documents/7c11a21581814a23ae4a7e83dd30ae10?download=99993315a2cd472f9387941fe22ee6d5",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:01+03:00",
        "id": "7c11a21581814a23ae4a7e83dd30ae10",
        "dateModified": "2020-05-15T01:00:01+03:00"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "tenderers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "date": "2020-05-15T01:00:01+03:00",
    "id": "b55f6c618ce54efe885dd3202eff3e94",
    "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/bc3a9016b29d4fed894cc62d3ff59680?key_for_bid=b55f6c618ce54efe885dd3202eff3e94"
  }
}

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

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

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/awards/898563864e114bff9ca304570bfc199e?acc_token=e6bb69a4c5474e4987130585951b6f3e 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",
    "complaintPeriod": {
      "startDate": "2020-05-15T01:00:01+03:00",
      "endDate": "2020-05-20T00:00:00+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "bid_id": "b55f6c618ce54efe885dd3202eff3e94",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:01+03:00",
    "id": "898563864e114bff9ca304570bfc199e"
  }
}

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

Переглянемо створений контракт використовуючи наступний запит:

GET /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3 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",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "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": "53de0c90af0e430ea270c5970351ba0c",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "amountNet": 499.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:01+03:00",
    "awardID": "898563864e114bff9ca304570bfc199e",
    "id": "4f7b2b4c16f24c66897d0d18d57c05f3",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

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

Ви можете встановити нові значення для полів amount та amountNet керуючись наступними правилами:

valueAddedTaxIncluded Validation
contract award
true true/false Amount should be greater than amountNet and differ by no more than 20%
true Amount should be less or equal to awarded amount
false AmountNet should be less or equal to awarded amount
false true/false Amount and amountNet should be equal
true/false Amount should be less or equal to awarded amount

Встановимо нові значення для поля value використовуючи наступний запит:

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3?acc_token=e6bb69a4c5474e4987130585951b6f3e 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": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "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": "53de0c90af0e430ea270c5970351ba0c",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:01+03:00",
    "awardID": "898563864e114bff9ca304570bfc199e",
    "id": "4f7b2b4c16f24c66897d0d18d57c05f3",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

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

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

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

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

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3?acc_token=e6bb69a4c5474e4987130585951b6f3e 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:03+03:00"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
null

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

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

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3?acc_token=e6bb69a4c5474e4987130585951b6f3e 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:03+03:00",
      "endDate": "2021-05-15T01:00:03+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "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": "53de0c90af0e430ea270c5970351ba0c",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "period": {
      "startDate": "2020-05-15T01:00:03+03:00",
      "endDate": "2021-05-15T01:00:03+03:00"
    },
    "dateSigned": "2020-05-15T01:00:03+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:01+03:00",
    "awardID": "898563864e114bff9ca304570bfc199e",
    "id": "4f7b2b4c16f24c66897d0d18d57c05f3",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

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

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

POST /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3/documents?acc_token=e6bb69a4c5474e4987130585951b6f3e HTTP/1.0
Authorization: Bearer broker
Content-Length: 348
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/b97562e3f33c493297fd14dd6d8c50f0?KeyID=a8968c46&Signature=3OV7QC7f%2ByfcGTvpy0tf%2FaM%2BFRI6kkg1ImfEJlfAx5qi%2FLY7IIj7TFqtxgaPrzdd%2BWIOCe3O5Q7WhXkOdCB9CQ%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/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3/documents/0fcd9edc0b0544c19fbc11c5f9c372dd
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_first_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/b97562e3f33c493297fd14dd6d8c50f0?KeyID=a8968c46&Signature=dQMvA4OqNyUhOiqC5GLb4uSEt49HDaSNcEbdsglo9C4Wq8XJDos68B7pBOwMEiRZWStfSwxaG5Hf8DZduhr9DA%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:03+03:00",
    "id": "0fcd9edc0b0544c19fbc11c5f9c372dd",
    "dateModified": "2020-05-15T01:00:03+03:00"
  }
}

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

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

GET /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3/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/b97562e3f33c493297fd14dd6d8c50f0?KeyID=a8968c46&Signature=dQMvA4OqNyUhOiqC5GLb4uSEt49HDaSNcEbdsglo9C4Wq8XJDos68B7pBOwMEiRZWStfSwxaG5Hf8DZduhr9DA%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:03+03:00",
      "id": "0fcd9edc0b0544c19fbc11c5f9c372dd",
      "dateModified": "2020-05-15T01:00:03+03:00"
    }
  ]
}

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

POST /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3/documents?acc_token=e6bb69a4c5474e4987130585951b6f3e 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/a2aa5b35517c445ca3778b7b25560cc9?KeyID=a8968c46&Signature=zj7WEkFY43cHRXABDNCQqrUFkuol7wJYMfiHE5o%2FXjgO%2Fp4vQlCK9ShocdlceSYRjZz%2FehAyLf%2BLlEzvxPJWBA%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/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3/documents/1b567d8562a54b8dbed747e3f604cf6f
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_second_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a2aa5b35517c445ca3778b7b25560cc9?KeyID=a8968c46&Signature=VkkdjRhMvrxZzXFjmULpNVxzcq52P09KEEXjD2Fe%252BBMNBH9FUupk0ZN6hHIwAFGr5lYmPcm2HzuX83tijpfOBw%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:03+03:00",
    "id": "1b567d8562a54b8dbed747e3f604cf6f",
    "dateModified": "2020-05-15T01:00:03+03:00"
  }
}

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

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

GET /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3/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/a2aa5b35517c445ca3778b7b25560cc9?KeyID=a8968c46&Signature=VkkdjRhMvrxZzXFjmULpNVxzcq52P09KEEXjD2Fe%252BBMNBH9FUupk0ZN6hHIwAFGr5lYmPcm2HzuX83tijpfOBw%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:03+03:00",
      "id": "1b567d8562a54b8dbed747e3f604cf6f",
      "dateModified": "2020-05-15T01:00:03+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/b97562e3f33c493297fd14dd6d8c50f0?KeyID=a8968c46&Signature=dQMvA4OqNyUhOiqC5GLb4uSEt49HDaSNcEbdsglo9C4Wq8XJDos68B7pBOwMEiRZWStfSwxaG5Hf8DZduhr9DA%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2020-05-15T01:00:03+03:00",
      "id": "0fcd9edc0b0544c19fbc11c5f9c372dd",
      "dateModified": "2020-05-15T01:00:03+03:00"
    }
  ]
}

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

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

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3?acc_token=e6bb69a4c5474e4987130585951b6f3e 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:03+03:00"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
null

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

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/contracts/4f7b2b4c16f24c66897d0d18d57c05f3?acc_token=e6bb69a4c5474e4987130585951b6f3e 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/b97562e3f33c493297fd14dd6d8c50f0?KeyID=a8968c46&Signature=dQMvA4OqNyUhOiqC5GLb4uSEt49HDaSNcEbdsglo9C4Wq8XJDos68B7pBOwMEiRZWStfSwxaG5Hf8DZduhr9DA%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:03+03:00",
        "id": "0fcd9edc0b0544c19fbc11c5f9c372dd",
        "dateModified": "2020-05-15T01:00:03+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_second_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a2aa5b35517c445ca3778b7b25560cc9?KeyID=a8968c46&Signature=VkkdjRhMvrxZzXFjmULpNVxzcq52P09KEEXjD2Fe%252BBMNBH9FUupk0ZN6hHIwAFGr5lYmPcm2HzuX83tijpfOBw%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:03+03:00",
        "id": "1b567d8562a54b8dbed747e3f604cf6f",
        "dateModified": "2020-05-15T01:00:03+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "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": "53de0c90af0e430ea270c5970351ba0c",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "scale": "sme",
        "name": "ДКП «Книга»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "Львівська область",
          "locality": "м. Львів"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "period": {
      "startDate": "2020-05-15T01:00:03+03:00",
      "endDate": "2021-05-15T01:00:03+03:00"
    },
    "dateSigned": "2020-05-15T01:00:03+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2020-05-15T01:00:03+03:00",
    "awardID": "898563864e114bff9ca304570bfc199e",
    "id": "4f7b2b4c16f24c66897d0d18d57c05f3",
    "contractID": "UA-2020-05-15-000001-1"
  }
}

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

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

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

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

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

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

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

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

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

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

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

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

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

POST /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/cancellations/442eab37b845408d81ed635c8d8ebadb/documents?acc_token=e6bb69a4c5474e4987130585951b6f3e HTTP/1.0
Authorization: Bearer broker
Content-Length: 326
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/888a378eb7764d1693a1fec763cb806f?KeyID=a8968c46&Signature=9c%2FJ2EfltaUdi%2BpNDw1HtgmyohZJzPpKwUQN%2BUj09y8CXJooKvp9Uz5VdCVxu0RN%2FLl23ZruKnfbg1GnRNUSCQ%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/bc3a9016b29d4fed894cc62d3ff59680/cancellations/442eab37b845408d81ed635c8d8ebadb/documents/ada2083ffec749c5ae3c8fc110e1fb3b
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/888a378eb7764d1693a1fec763cb806f?KeyID=a8968c46&Signature=66iYlHWRzl%252BEJRqmPqx781kVoy2WJlTVVKmZsNxrbNcxI0ib35aJ507wHARZ0lNebq9cfxuwi161lXFPn2NEAw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:03+03:00",
    "id": "ada2083ffec749c5ae3c8fc110e1fb3b",
    "dateModified": "2020-05-15T01:00:03+03:00"
  }
}

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

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/cancellations/442eab37b845408d81ed635c8d8ebadb/documents/ada2083ffec749c5ae3c8fc110e1fb3b?acc_token=e6bb69a4c5474e4987130585951b6f3e 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/888a378eb7764d1693a1fec763cb806f?KeyID=a8968c46&Signature=66iYlHWRzl%252BEJRqmPqx781kVoy2WJlTVVKmZsNxrbNcxI0ib35aJ507wHARZ0lNebq9cfxuwi161lXFPn2NEAw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:03+03:00",
    "id": "ada2083ffec749c5ae3c8fc110e1fb3b",
    "dateModified": "2020-05-15T01:00:03+03:00"
  }
}

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

PUT /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/cancellations/442eab37b845408d81ed635c8d8ebadb/documents/ada2083ffec749c5ae3c8fc110e1fb3b?acc_token=e6bb69a4c5474e4987130585951b6f3e HTTP/1.0
Authorization: Bearer broker
Content-Length: 322
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/c9f250e2f74e4e8e95a882add5b4401a?KeyID=a8968c46&Signature=olmGp62cfDiMz2KwUy1L4L94bu84DcReTmsfX%2B8IkNJ3itZ82ueChK1XAoVElBceg0eEeDePjwnVWimNRNuPAQ%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/c9f250e2f74e4e8e95a882add5b4401a?KeyID=a8968c46&Signature=zr1a4Vd8WIGqoGAskp1DDf5%252BQzA6WJ5nV1uzXJIgIc3nK%2FJFCw%252BGK4aIT7vCv8qv8WTHWJ4%252BN%2Fb5gGIWIzYKAQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2020-05-15T01:00:03+03:00",
    "id": "ada2083ffec749c5ae3c8fc110e1fb3b",
    "dateModified": "2020-05-15T01:00:03+03:00"
  }
}

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

PATCH /api/2.5/tenders/bc3a9016b29d4fed894cc62d3ff59680/cancellations/442eab37b845408d81ed635c8d8ebadb?acc_token=e6bb69a4c5474e4987130585951b6f3e 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/888a378eb7764d1693a1fec763cb806f?KeyID=a8968c46&Signature=66iYlHWRzl%252BEJRqmPqx781kVoy2WJlTVVKmZsNxrbNcxI0ib35aJ507wHARZ0lNebq9cfxuwi161lXFPn2NEAw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:03+03:00",
        "id": "ada2083ffec749c5ae3c8fc110e1fb3b",
        "dateModified": "2020-05-15T01:00:03+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/c9f250e2f74e4e8e95a882add5b4401a?KeyID=a8968c46&Signature=zr1a4Vd8WIGqoGAskp1DDf5%252BQzA6WJ5nV1uzXJIgIc3nK%2FJFCw%252BGK4aIT7vCv8qv8WTHWJ4%252BN%2Fb5gGIWIzYKAQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2020-05-15T01:00:03+03:00",
        "id": "ada2083ffec749c5ae3c8fc110e1fb3b",
        "dateModified": "2020-05-15T01:00:03+03:00"
      }
    ],
    "reason": "cancellation reason",
    "reasonType": "noDemand",
    "date": "2020-05-15T01:00:03+03:00",
    "cancellationOf": "tender",
    "id": "442eab37b845408d81ed635c8d8ebadb"
  }
}