Туторіал

Configuration

The set of possible configuration values:

name

values

default

hasAuction

true

true

hasAwardingOrder

true

true

hasValueRestriction

true

true

valueCurrencyEquality

true

true

hasPrequalification

false

false

minBidsNumber

1

1

hasPreSelectionAgreement

true

true

hasTenderComplaints

false

false

hasAwardComplaints

false

false

hasCancellationComplaints

false

false

restricted

false

false

Ви можете ознайомитись з деталями в секції Конфігурація.

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

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

Request

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

{
  "data": {
    "agreements": [
      {
        "id": "53e68cfa78da42188f99f9e054e0e168"
      }
    ],
    "title": "футляри до державних нагород",
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "procuringEntity": {
      "name": "Державне управління справами",
      "kind": "general",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "locality": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000",
        "availableLanguage": "en"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "telephone": "+0440000000",
          "availableLanguage": "uk"
        }
      ]
    },
    "items": [
      {
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "description": "футляри до державних нагород",
        "description_en": "futliary do derzhavnyh nagorod",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "New Cartons"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "item",
          "code": "KGM",
          "value": {
            "amount": 6
          }
        },
        "quantity": 5,
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "locality": "м. Київ",
          "streetAddress": "вул. Банкова 1"
        },
        "deliveryDate": {
          "startDate": "2023-10-12T01:00:00+03:00",
          "endDate": "2023-10-15T01:00:00+03:00"
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42"
      }
    ],
    "lots": [
      {
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "50fc7d0cb4e3423491c35387a046af42"
      }
    ]
  },
  "config": {
    "hasAuction": true,
    "hasAwardingOrder": true,
    "hasValueRestriction": true,
    "valueCurrencyEquality": true,
    "hasPrequalification": false,
    "minBidsNumber": 1,
    "hasPreSelectionAgreement": true,
    "hasTenderComplaints": false,
    "hasAwardComplaints": false,
    "hasCancellationComplaints": false,
    "restricted": false
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/ba4365d4238e408a8c655d19220b071e

{
  "data": {
    "title": "футляри до державних нагород",
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "awardCriteria": "lowestCost",
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000",
        "availableLanguage": "en"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "telephone": "+0440000000",
          "availableLanguage": "uk"
        }
      ],
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "kind": "general"
    },
    "status": "draft",
    "agreements": [
      {
        "id": "53e68cfa78da42188f99f9e054e0e168"
      }
    ],
    "items": [
      {
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "description": "футляри до державних нагород",
        "description_en": "futliary do derzhavnyh nagorod",
        "quantity": 5.0,
        "classification": {
          "description": "New Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryDate": {
          "startDate": "2023-10-12T01:00:00+03:00",
          "endDate": "2023-10-15T01:00:00+03:00"
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42",
        "unit": {
          "name": "item",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "lots": [
      {
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "50fc7d0cb4e3423491c35387a046af42",
        "status": "active",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "tenderID": "UA-2023-10-10-000001-a",
    "owner": "broker",
    "procurementMethod": "selective",
    "submissionMethod": "electronicAuction",
    "date": "2023-10-10T01:00:00+03:00",
    "dateCreated": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "id": "ba4365d4238e408a8c655d19220b071e"
  },
  "config": {
    "hasAuction": true,
    "hasAwardingOrder": true,
    "hasValueRestriction": true,
    "valueCurrencyEquality": true,
    "hasPrequalification": false,
    "minBidsNumber": 1,
    "hasPreSelectionAgreement": true,
    "hasTenderComplaints": false,
    "hasAwardComplaints": false,
    "hasCancellationComplaints": false,
    "restricted": false
  },
  "access": {
    "token": "d2f4a5cf84ba424d8439f906e5faf58e",
    "transfer": "63abcfbba3c04d1ca5916e634a8ff89c"
  }
}

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

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

Request

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

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "title": "футляри до державних нагород",
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "awardCriteria": "lowestCost",
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000",
        "availableLanguage": "en"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "telephone": "+0440000000",
          "availableLanguage": "uk"
        }
      ],
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "kind": "general"
    },
    "status": "draft",
    "agreements": [
      {
        "id": "53e68cfa78da42188f99f9e054e0e168"
      }
    ],
    "items": [
      {
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "description": "футляри до державних нагород",
        "description_en": "futliary do derzhavnyh nagorod",
        "quantity": 5.0,
        "classification": {
          "description": "New Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryDate": {
          "startDate": "2023-10-12T01:00:00+03:00",
          "endDate": "2023-10-15T01:00:00+03:00"
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42",
        "unit": {
          "name": "item",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "lots": [
      {
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "50fc7d0cb4e3423491c35387a046af42",
        "status": "active",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "tenderID": "UA-2023-10-10-000001-a",
    "owner": "broker",
    "procurementMethod": "selective",
    "submissionMethod": "electronicAuction",
    "date": "2023-10-10T01:00:00+03:00",
    "dateCreated": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "id": "ba4365d4238e408a8c655d19220b071e"
  },
  "config": {
    "hasAuction": true,
    "hasAwardingOrder": true,
    "hasValueRestriction": true,
    "valueCurrencyEquality": true,
    "hasPrequalification": false,
    "minBidsNumber": 1,
    "hasPreSelectionAgreement": true,
    "hasTenderComplaints": false,
    "hasAwardComplaints": false,
    "hasCancellationComplaints": false,
    "restricted": false
  }
}

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

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

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

Request

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

{
  "data": {
    "title": "футляри до державних нагород",
    "title_en": "Cases with state awards",
    "title_ru": "футляры к государственным наградам",
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "locality": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "items": [
      {
        "id": "7cafcae8b551443599f87782cd56a35d",
        "description": "футляри до державних нагород",
        "description_en": "Cases with state awards",
        "description_ru": "футляры к государственным наградам",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кілограм",
          "code": "KGM",
          "value": {
            "amount": 6
          }
        },
        "quantity": 5,
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42"
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "mode": "test",
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "code": "prepayment",
        "type": "financing",
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 0,
        "percentage": 45.55
      },
      {
        "title": "deliveryOfGoods",
        "code": "postpayment",
        "type": "financing",
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 0,
        "percentage": 54.45
      }
    ],
    "mainProcurementCategory": "services",
    "agreements": [
      {
        "id": "53e68cfa78da42188f99f9e054e0e168"
      }
    ],
    "lots": [
      {
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "50fc7d0cb4e3423491c35387a046af42"
      }
    ]
  },
  "config": {
    "hasAuction": true,
    "hasAwardingOrder": true,
    "hasValueRestriction": true,
    "valueCurrencyEquality": true,
    "hasPrequalification": false,
    "minBidsNumber": 1,
    "hasPreSelectionAgreement": true,
    "hasTenderComplaints": false,
    "hasAwardComplaints": false,
    "hasCancellationComplaints": false,
    "restricted": false
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5a7d4e83983f46a9b2a81db15a859b12

{
  "data": {
    "mainProcurementCategory": "services",
    "title_en": "[TESTING] Cases with state awards",
    "title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
    "title": "[ТЕСТУВАННЯ] футляри до державних нагород",
    "mode": "test",
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "awardCriteria": "lowestCost",
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000",
        "availableLanguage": "uk"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "kind": "general"
    },
    "status": "draft",
    "agreements": [
      {
        "id": "53e68cfa78da42188f99f9e054e0e168"
      }
    ],
    "items": [
      {
        "id": "7cafcae8b551443599f87782cd56a35d",
        "description": "футляри до державних нагород",
        "description_en": "Cases with state awards",
        "description_ru": "футляры к государственным наградам",
        "quantity": 5.0,
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42",
        "unit": {
          "name": "кілограм",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        }
      }
    ],
    "lots": [
      {
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "50fc7d0cb4e3423491c35387a046af42",
        "status": "active",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "type": "financing",
        "code": "prepayment",
        "percentage": 45.55,
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 0
      },
      {
        "id": "d79c72a7486b4e38a0522dc466884846",
        "title": "deliveryOfGoods",
        "type": "financing",
        "code": "postpayment",
        "percentage": 54.45,
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 0
      }
    ],
    "tenderID": "UA-2023-10-10-000002-a",
    "owner": "broker",
    "procurementMethod": "selective",
    "submissionMethod": "electronicAuction",
    "date": "2023-10-10T01:00:00+03:00",
    "dateCreated": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "id": "5a7d4e83983f46a9b2a81db15a859b12"
  },
  "config": {
    "hasAuction": true,
    "hasAwardingOrder": true,
    "hasValueRestriction": true,
    "valueCurrencyEquality": true,
    "hasPrequalification": false,
    "minBidsNumber": 1,
    "hasPreSelectionAgreement": true,
    "hasTenderComplaints": false,
    "hasAwardComplaints": false,
    "hasCancellationComplaints": false,
    "restricted": false
  },
  "access": {
    "token": "1508e38e18ae4542b4ef7c569035bcc0",
    "transfer": "3f6763d524f045d9a14e671f1c929110"
  }
}

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

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

Request

PATCH /api/2.5/tenders/ba4365d4238e408a8c655d19220b071e?acc_token=d2f4a5cf84ba424d8439f906e5faf58e HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "draft.pending"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "date": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "dateCreated": "2023-10-10T01:00:00+03:00",
    "tenderID": "UA-2023-10-10-000001-a",
    "owner": "broker",
    "title": "футляри до державних нагород",
    "procurementMethod": "selective",
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "submissionMethod": "electronicAuction",
    "awardCriteria": "lowestCost",
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000",
        "availableLanguage": "en"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "telephone": "+0440000000",
          "availableLanguage": "uk"
        }
      ],
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "kind": "general"
    },
    "status": "draft.pending",
    "agreements": [
      {
        "id": "53e68cfa78da42188f99f9e054e0e168"
      }
    ],
    "items": [
      {
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "description": "футляри до державних нагород",
        "description_en": "futliary do derzhavnyh nagorod",
        "quantity": 5.0,
        "classification": {
          "description": "New Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryDate": {
          "startDate": "2023-10-12T01:00:00+03:00",
          "endDate": "2023-10-15T01:00:00+03:00"
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42",
        "unit": {
          "name": "item",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "lots": [
      {
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "status": "active",
        "date": "2023-10-10T01:00:00+03:00",
        "id": "50fc7d0cb4e3423491c35387a046af42"
      }
    ],
    "enquiryPeriod": {
      "startDate": "2023-10-10T01:00:00+03:00",
      "endDate": "2023-10-12T00:00:00+03:00"
    },
    "tenderPeriod": {
      "startDate": "2023-10-12T00:00:00+03:00",
      "endDate": "2023-10-15T00:00:00+03:00"
    },
    "id": "ba4365d4238e408a8c655d19220b071e"
  },
  "config": {
    "hasAuction": true,
    "hasAwardingOrder": true,
    "hasValueRestriction": true,
    "valueCurrencyEquality": true,
    "hasPrequalification": false,
    "minBidsNumber": 1,
    "hasPreSelectionAgreement": true,
    "hasTenderComplaints": false,
    "hasAwardComplaints": false,
    "hasCancellationComplaints": false,
    "restricted": false
  }
}

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

Request

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

Response

HTTP/1.0 200 OK
Content-Type: application/json

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

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

Request

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

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "dateModified": "2023-10-10T01:00:00+03:00",
      "id": "ba4365d4238e408a8c655d19220b071e"
    }
  ],
  "next_page": {
    "offset": 1696888800.0,
    "path": "/api/2.5/tenders?offset=1696888800.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1696888800.0"
  }
}
При створенні процедури в статусі draft, можна заповнювати наступні поля:
  • у Agreement in frameworks_electroniccatalogue - id

  • у Tender - title, title_en, description, description_en, guarantee, procurementMethodType, procuringEntity

  • у Lot - title, title_en, description, description_en, id, guarantee

  • у Item - description, quantity, relatedLot, unit, description_en, classification, additionalClassifications, deliveryAddress, deliveryDate, deliveryLocation, id

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

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

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

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "tenderPeriod": {
      "startDate": "2023-10-12T00:00:00+03:00",
      "endDate": "2023-10-25T01:00:10+03:00"
    },
    "items": [
      {
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "description": "футляри до державних нагород",
        "description_en": "futliary do derzhavnyh nagorod",
        "quantity": 6,
        "classification": {
          "description": "New Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryDate": {
          "startDate": "2023-10-12T01:00:00+03:00",
          "endDate": "2023-10-15T01:00:00+03:00"
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42",
        "unit": {
          "name": "item",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ]
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

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

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

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

Request

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

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "dateModified": "2023-10-10T01:00:00+03:00",
      "id": "ba4365d4238e408a8c655d19220b071e"
    },
    {
      "dateModified": "2023-10-10T01:00:00+03:00",
      "id": "782a773bcc70490e923de940a94a5ada"
    }
  ],
  "next_page": {
    "offset": 1696888800.0,
    "path": "/api/2.5/tenders?offset=1696888800.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1696888800.0"
  }
}

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

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/lots/50fc7d0cb4e3423491c35387a046af42?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "guarantee": {
      "amount": 8,
      "currency": "USD"
    }
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "title": "Лот №1",
    "description": "Опис Лот №1",
    "status": "active",
    "date": "2023-10-10T01:00:00+03:00",
    "id": "50fc7d0cb4e3423491c35387a046af42",
    "value": {
      "amount": 600.67,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "amount": 2.5,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "guarantee": {
      "amount": 8.0,
      "currency": "USD"
    }
  }
}
Можна редагувати наступні поля на цьому етапі процедури:
  • у Tender - title, title_en, description, description_en, tenderPeriod: endDate

  • у Lot - title, description, title_en, description_en, minimalStep, amount

  • у Item - description, description_en, deliveryAddress, deliveryDate, quantity

  • Guarantee

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

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

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

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

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

Request

POST /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=mjrhcvxfj51xIU2CqbPF%2FzPe%2Bd9FKslP4eiSZXoY%2FMzKo2zEQf5WkBpSQFsYC8wf0lH99XgwPL9nZqe2hhqLBw%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents/bc77152edc4647f4a9ff5b77ea6647c1

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "language": "uk",
    "id": "bc77152edc4647f4a9ff5b77ea6647c1",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "author": "tender_owner"
  }
}

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

Request

GET /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents/bc77152edc4647f4a9ff5b77ea6647c1 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "language": "uk",
    "id": "bc77152edc4647f4a9ff5b77ea6647c1",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "author": "tender_owner"
  }
}

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

Request

POST /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "AwardCriteria.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/dd09c74752f54370b81db56456d4622c?Signature=7EP5UfK%2BI7IT6JR%2FLpnvQa2MEx8B%2BN6CfTM3Rl%2FJy1QIl%2BNJ0A4pQ9uYbN%2BOJQCaVkdGSEMXbfT1qTQF0zqqDg%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents/1d37ebaf83c64c198751e4523dc6780e

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "AwardCriteria.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/dd09c74752f54370b81db56456d4622c?Signature=tSnRb6e0HBpOwpT1iHOjPI9TGBVNiiboyXfwC161eAwy84ICIfE8LARUNwZx50p5QDtRnNFfYqxDJzhn%2FVW%2FDA%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "language": "uk",
    "id": "1d37ebaf83c64c198751e4523dc6780e",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "author": "tender_owner"
  }
}

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

Request

GET /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "documentType": "technicalSpecifications",
      "description": "document description modified",
      "id": "bc77152edc4647f4a9ff5b77ea6647c1",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "hash": "md5:00000000000000000000000000000000",
      "title": "Notice.pdf",
      "format": "application/pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
      "documentOf": "tender",
      "dateModified": "2023-10-10T01:00:00+03:00",
      "author": "tender_owner",
      "language": "uk"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "AwardCriteria.pdf",
      "format": "application/pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/dd09c74752f54370b81db56456d4622c?Signature=tSnRb6e0HBpOwpT1iHOjPI9TGBVNiiboyXfwC161eAwy84ICIfE8LARUNwZx50p5QDtRnNFfYqxDJzhn%2FVW%2FDA%3D%3D&KeyID=a8968c46",
      "documentOf": "tender",
      "language": "uk",
      "id": "1d37ebaf83c64c198751e4523dc6780e",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00",
      "author": "tender_owner"
    }
  ]
}

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

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents/bc77152edc4647f4a9ff5b77ea6647c1?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "documentType": "technicalSpecifications"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "documentType": "technicalSpecifications",
    "id": "bc77152edc4647f4a9ff5b77ea6647c1",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "author": "tender_owner",
    "language": "uk"
  }
}

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

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

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents/bc77152edc4647f4a9ff5b77ea6647c1?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "description": "document description modified"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "documentType": "technicalSpecifications",
    "description": "document description modified",
    "id": "bc77152edc4647f4a9ff5b77ea6647c1",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "author": "tender_owner",
    "language": "uk"
  }
}

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

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

Request

PUT /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents/1d37ebaf83c64c198751e4523dc6780e?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "AwardCriteria-2.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1c680c5a847e47d397d53c35cd19ac5f?Signature=inZVNXt6PbjQoJ30QUEAQ%2FTXOEsq1Bbum27TIfYSNTQccgQDHHNMYN1Iut%2BI4BBgyGBjm%2BEfOouHKLepDLGkDw%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "id": "1d37ebaf83c64c198751e4523dc6780e",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "hash": "md5:00000000000000000000000000000000",
    "title": "AwardCriteria-2.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1c680c5a847e47d397d53c35cd19ac5f?Signature=4DY%2BwYwk31zBKOw4YNVvCqHePAJpPICn5kDOkt%2Bg%2FZf8q%2FaArkqgD7xFV10WPeHL74r1s3mG4FD5Y%2F%2BSXDKaBg%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "author": "tender_owner",
    "language": "uk"
  }
}

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

Request

GET /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "documentType": "technicalSpecifications",
      "description": "document description modified",
      "id": "bc77152edc4647f4a9ff5b77ea6647c1",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "hash": "md5:00000000000000000000000000000000",
      "title": "Notice.pdf",
      "format": "application/pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/d351393c1280494ba80f9ffa0b2345f7?Signature=pjE0GKDow2IhqnpZvpSXzjckw%2FfmzKn9av6v5zsel8b7aOVuccX%2BkVAVvextRKgot2qX2Z0HJOocOSfv1qOuAA%3D%3D&KeyID=a8968c46",
      "documentOf": "tender",
      "dateModified": "2023-10-10T01:00:00+03:00",
      "author": "tender_owner",
      "language": "uk"
    },
    {
      "id": "1d37ebaf83c64c198751e4523dc6780e",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "hash": "md5:00000000000000000000000000000000",
      "title": "AwardCriteria-2.pdf",
      "format": "application/pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1c680c5a847e47d397d53c35cd19ac5f?Signature=4DY%2BwYwk31zBKOw4YNVvCqHePAJpPICn5kDOkt%2Bg%2FZf8q%2FaArkqgD7xFV10WPeHL74r1s3mG4FD5Y%2F%2BSXDKaBg%3D%3D&KeyID=a8968c46",
      "documentOf": "tender",
      "dateModified": "2023-10-10T01:00:00+03:00",
      "author": "tender_owner",
      "language": "uk"
    }
  ]
}

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

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

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

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

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

Request

POST /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "tenderers": [
      {
        "address": {
          "countryName": "Україна",
          "locality": "м. Вінниця",
          "postalCode": "21100",
          "region": "Вінницька область",
          "streetAddress": "вул. Островського, 33"
        },
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "name": "Сергій Олексюк",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "scale": "micro"
      }
    ],
    "status": "draft",
    "lotValues": [
      {
        "value": {
          "amount": 500
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42"
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ]
  }
}

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Bid is not a member of agreement"
    }
  ]
}

Request

POST /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "tenderers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "large",
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        }
      }
    ],
    "status": "draft",
    "lotValues": [
      {
        "value": {
          "amount": 500
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42"
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ]
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/bids/086af210a2bc41908a0dd9988134a118

{
  "data": {
    "tenderers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "large"
      }
    ],
    "status": "draft",
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "status": "pending",
        "value": {
          "amount": 500.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "id": "086af210a2bc41908a0dd9988134a118",
    "date": "2023-10-10T01:00:00+03:00"
  },
  "access": {
    "token": "7483e385045b4fdbbc4a88bf724bbcee",
    "transfer": "a84c04ecd5ec4683b9ee6af37c0d90cd"
  }
}

і підтвердити її, перевівши у pending статус:

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/bids/086af210a2bc41908a0dd9988134a118?acc_token=7483e385045b4fdbbc4a88bf724bbcee HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "pending"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "tenderers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "large"
      }
    ],
    "status": "pending",
    "id": "086af210a2bc41908a0dd9988134a118",
    "date": "2023-10-10T01:00:00+03:00",
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "value": {
          "amount": 500.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42",
        "status": "pending",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ]
  }
}

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

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

Request

POST /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/bids/086af210a2bc41908a0dd9988134a118/documents?acc_token=7483e385045b4fdbbc4a88bf724bbcee HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Proposal.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e5d937aec73f4c07aec4e91e7de7d0c0?Signature=ThEuR34wf1tPqsNQroLH8otCJkwtR0BMJRBO%2BudrVDjRl85gUk6YcvjYxwBJPN0MXyGwn2jG51RrcgCPxHZHAA%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/bids/086af210a2bc41908a0dd9988134a118/documents/b336781d876d47e281e111bf33ffd16b

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Proposal.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e5d937aec73f4c07aec4e91e7de7d0c0?Signature=i1QFE0pwj%2BuQT99%2FY4GX2uZghCioK2WSMSpY6%2BMlXr1TETaF6FoXkWJE5ceSIenvOO9CMxJTx4kTn5aoga4JAw%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "language": "uk",
    "id": "b336781d876d47e281e111bf33ffd16b",
    "confidentiality": "public",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00"
  }
}

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

Request

GET /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/bids/086af210a2bc41908a0dd9988134a118/documents?acc_token=7483e385045b4fdbbc4a88bf724bbcee HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "Proposal.pdf",
      "format": "application/pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e5d937aec73f4c07aec4e91e7de7d0c0?Signature=i1QFE0pwj%2BuQT99%2FY4GX2uZghCioK2WSMSpY6%2BMlXr1TETaF6FoXkWJE5ceSIenvOO9CMxJTx4kTn5aoga4JAw%3D%3D&KeyID=a8968c46",
      "documentOf": "tender",
      "language": "uk",
      "id": "b336781d876d47e281e111bf33ffd16b",
      "confidentiality": "public",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}

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

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

Request

POST /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/bids HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "tenderers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro",
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        }
      }
    ],
    "lotValues": [
      {
        "value": {
          "amount": 499
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42"
      }
    ],
    "documents": [
      {
        "title": "Proposal_part1.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6f5d54d6f96e4f93bb84aaf2005ecd74?Signature=Mo04A31PiR8t5ZU5YIge%2B%2FKNq930zaj52Y%2BQgdtIdmq1y1E%2BB5O5O8rWiWpgAR0VXxDd1FCp7nVSJLsKg3RhCQ%3D%3D&KeyID=a8968c46",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      },
      {
        "title": "Proposal_part2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7c465d3486b487db509f0e8482bcafd?Signature=hMKg5q0zUd5uHXOeMKHBLUxB4hjVOc9ILgQz2ZSbyqNPqsb7QEVoTlMJDNL15wFmJrKNyZWBGFf5bFYE5HPnDg%3D%3D&KeyID=a8968c46",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ]
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/bids/5e3e02b6dd9849d98c48bf9d741a036e

{
  "data": {
    "tenderers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "status": "draft",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part1.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6f5d54d6f96e4f93bb84aaf2005ecd74?Signature=gWkknoOyOQh2cpnX6nZmhLZJrFxulp8qPlSiERXttONVOcfK8ZCL1ksm1AQp292iAQqY6uzphnL10nz8PEnlAA%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "language": "uk",
        "id": "a203d9a0cbf14608b5c4b00138da513f",
        "confidentiality": "public",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "dateModified": "2023-10-10T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7c465d3486b487db509f0e8482bcafd?Signature=Dt0bUdqRLCf5ENnzoOZDqA6XZdViV36%2BLgE4rzqjUtBbVG0krDrux7p3D7C45U3%2BZaqfHqB1ntI9LVS%2F6PoeCg%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "language": "uk",
        "id": "fd4040a443574d50b13ffdd5c99ac6b2",
        "confidentiality": "public",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "dateModified": "2023-10-10T01:00:00+03:00"
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "status": "pending",
        "value": {
          "amount": 499.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "id": "5e3e02b6dd9849d98c48bf9d741a036e",
    "date": "2023-10-10T01:00:00+03:00"
  },
  "access": {
    "token": "c690cc2a16bb4052bcba2502d07449d6",
    "transfer": "447d880a006641f0aacbb5f0a8747828"
  }
}

Аукціон

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

Request

GET /api/2.5/tenders/782a773bcc70490e923de940a94a5ada HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "date": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "dateCreated": "2023-10-10T01:00:00+03:00",
    "tenderID": "UA-2023-10-10-000004-a",
    "owner": "broker",
    "title": "футляри до державних нагород",
    "procurementMethod": "selective",
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "submissionMethod": "electronicAuction",
    "awardCriteria": "lowestCost",
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000",
        "availableLanguage": "en"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "telephone": "+0440000000",
          "availableLanguage": "uk"
        }
      ],
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "kind": "general"
    },
    "status": "active.auction",
    "agreements": [
      {
        "agreementID": "UA-2018-09-11-000002-1",
        "dateSigned": "2018-09-11T11:23:23.220310+03:00",
        "features": [
          {
            "code": "OCDS-123454-AIR-INTAKE",
            "featureOf": "item",
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "title": "Потужність всмоктування",
            "title_en": "Air Intake",
            "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
            "enum": [
              {
                "title": "До 1000 Вт",
                "value": 0.1
              },
              {
                "title": "Більше 1000 Вт",
                "value": 0.15
              }
            ]
          },
          {
            "code": "OCDS-123454-YEARS",
            "featureOf": "tenderer",
            "title": "Років на ринку",
            "title_en": "Years trading",
            "description": "Кількість років, які організація учасник працює на ринку",
            "enum": [
              {
                "title": "До 3 років",
                "value": 0.05
              },
              {
                "title": "Більше 3 років, менше 5 років",
                "value": 0.1
              },
              {
                "title": "Більше 5 років",
                "value": 0.15
              }
            ]
          }
        ],
        "items": [
          {
            "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "description": "футляри до державних нагород",
            "description_en": "Cases for state awards",
            "quantity": 5.0,
            "classification": {
              "description": "Cartons",
              "scheme": "ДК021",
              "id": "44617100-9"
            },
            "additionalClassifications": [
              {
                "scheme": "ДКПП",
                "id": "17.21.1",
                "description": "папір і картон гофровані, паперова й картонна тара"
              }
            ],
            "deliveryDate": {
              "startDate": "2018-06-27T13:39:09.362837+03:00",
              "endDate": "2018-06-30T13:39:09.362837+03:00"
            },
            "unit": {
              "name": "item",
              "code": "KGM"
            },
            "deliveryAddress": {
              "streetAddress": "вул. Банкова 1",
              "locality": "м. Київ",
              "region": "м. Київ",
              "postalCode": "79000",
              "countryName": "Україна"
            }
          }
        ],
        "period": {
          "startDate": "2018-09-11T11:23:20.418390+03:00",
          "endDate": "2222-01-23T11:23:20.418436+03:00"
        },
        "status": "active",
        "contracts": [
          {
            "id": "d6cd8c3188d74e1481a9cebb57fd9329",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "status": "active",
            "suppliers": [
              {
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037256",
                  "uri": "http://www.dus.gov.ua/"
                },
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "+0440000000"
                },
                "scale": "large",
                "address": {
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "locality": "м. Київ",
                  "region": "м. Київ",
                  "postalCode": "01220",
                  "countryName": "Україна"
                }
              }
            ],
            "unitPrices": [
              {
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
                "value": {
                  "currency": "UAH",
                  "valueAddedTaxIncluded": true,
                  "amount": 100.0
                }
              }
            ],
            "awardID": "d7406b07c05b4796bb168a7c47ee7d31",
            "bidID": "0a292b6466274139ad3d973fd64830ff",
            "date": "2018-07-30T17:40:15.471158+03:00",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 600.0
            }
          },
          {
            "id": "c8ef8c0d1cb74528b13335a623225762",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "status": "active",
            "suppliers": [
              {
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037257",
                  "uri": "http://www.dus.gov.ua/"
                },
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "+0440000000"
                },
                "scale": "micro",
                "address": {
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "locality": "м. Київ",
                  "region": "м. Київ",
                  "postalCode": "01220",
                  "countryName": "Україна"
                }
              }
            ],
            "unitPrices": [
              {
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
                "value": {
                  "currency": "UAH",
                  "valueAddedTaxIncluded": true,
                  "amount": 100.111
                }
              }
            ],
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 600.666
            }
          },
          {
            "id": "c8ef8c0d1cb74528b13335a623225762",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "status": "unsuccessful",
            "suppliers": [
              {
                "name": "Державне управління справами 1",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037251",
                  "uri": "http://www.dus.gov.ua/"
                },
                "contactPoint": {
                  "name": "Державне управління справами 1",
                  "telephone": "+0440000000"
                },
                "scale": "micro",
                "address": {
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "locality": "м. Київ",
                  "region": "м. Київ",
                  "postalCode": "01220",
                  "countryName": "Україна"
                }
              }
            ],
            "unitPrices": [
              {
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
                "value": {
                  "currency": "UAH",
                  "valueAddedTaxIncluded": true,
                  "amount": 100.111
                }
              }
            ],
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 600.666
            }
          },
          {
            "id": "d925d6c6124447d581f2ae5f52ba710f",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "status": "active",
            "suppliers": [
              {
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037258",
                  "uri": "http://www.dus.gov.ua/"
                },
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "+0440000000"
                },
                "scale": "micro",
                "address": {
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "locality": "м. Київ",
                  "region": "м. Київ",
                  "postalCode": "01220",
                  "countryName": "Україна"
                }
              }
            ],
            "unitPrices": [
              {
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
                "value": {
                  "currency": "UAH",
                  "valueAddedTaxIncluded": true,
                  "amount": 100.0
                }
              }
            ],
            "awardID": "a915a07f7f0b4dafa583cce119bf1823",
            "bidID": "fc02090c338a477f8013156a4fa2da10",
            "date": "2018-07-30T17:40:15.471264+03:00",
            "value": {
              "currency": "UAH",
              "valueAddedTaxIncluded": true,
              "amount": 600.0
            }
          }
        ],
        "title": "[ТЕСТУВАННЯ] ",
        "title_en": "[TESTING] ",
        "title_ru": "[ТЕСТИРОВАНИЕ] ",
        "tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32",
        "dateModified": "2018-09-17T16:26:31.372995+03:00",
        "mode": "test",
        "numberOfContracts": 3,
        "owner": "broker",
        "procuringEntity": {
          "name": "Шевченківська районна в місті Києві державна адміністрація",
          "name_en": "Angelica Davis",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00037256",
            "legalName": "Шевченківська районна в місті Києві державна адміністрація",
            "legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\""
          },
          "contactPoint": {
            "name": "Ліповець Євген Іванович",
            "name_en": "Gregory Gillespie",
            "email": "buh510@ukr.net",
            "telephone": "+2341170",
            "faxNumber": "2343591",
            "url": "http://www.shev.gov.ua/",
            "availableLanguage": "en"
          },
          "address": {
            "streetAddress": "Богдана Хмельницького вулиця, 21-29",
            "locality": "Переяслав-Хмельницький",
            "region": "Київська область",
            "postalCode": "01030",
            "countryName": "Україна"
          },
          "kind": "general"
        },
        "id": "53e68cfa78da42188f99f9e054e0e168"
      }
    ],
    "items": [
      {
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "description": "футляри до державних нагород",
        "description_en": "futliary do derzhavnyh nagorod",
        "quantity": 6.0,
        "classification": {
          "description": "New Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryDate": {
          "startDate": "2023-10-12T01:00:00+03:00",
          "endDate": "2023-10-15T01:00:00+03:00"
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42",
        "unit": {
          "name": "item",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        }
      }
    ],
    "lots": [
      {
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "status": "active",
        "date": "2023-10-10T01:00:00+03:00",
        "id": "50fc7d0cb4e3423491c35387a046af42",
        "value": {
          "currency": "UAH",
          "valueAddedTaxIncluded": true,
          "amount": 600.666
        },
        "minimalStep": {
          "currency": "UAH",
          "valueAddedTaxIncluded": true,
          "amount": 3.0033300000000005
        },
        "guarantee": {
          "amount": 8.0,
          "currency": "USD"
        },
        "auctionPeriod": {
          "startDate": "2023-10-10T01:00:00+03:00",
          "shouldStartAfter": "2023-10-11T00:00:00+03:00"
        },
        "auctionUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/782a773bcc70490e923de940a94a5ada_50fc7d0cb4e3423491c35387a046af42"
      }
    ],
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "featureOf": "item",
        "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "title": "Потужність всмоктування",
        "title_en": "Air Intake",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "enum": [
          {
            "title": "До 1000 Вт",
            "value": 0.1
          },
          {
            "title": "Більше 1000 Вт",
            "value": 0.15
          }
        ]
      },
      {
        "code": "OCDS-123454-YEARS",
        "featureOf": "tenderer",
        "title": "Років на ринку",
        "title_en": "Years trading",
        "description": "Кількість років, які організація учасник працює на ринку",
        "enum": [
          {
            "title": "До 3 років",
            "value": 0.05
          },
          {
            "title": "Більше 3 років, менше 5 років",
            "value": 0.1
          },
          {
            "title": "Більше 5 років",
            "value": 0.15
          }
        ]
      }
    ],
    "tenderPeriod": {
      "startDate": "2023-10-06T01:00:00+03:00",
      "endDate": "2023-10-10T01:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2023-10-04T01:00:00+03:00",
      "endDate": "2023-10-06T01:00:00+03:00"
    },
    "minimalStep": {
      "amount": 3.0033300000000005,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "value": {
      "amount": 600.666,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "next_check": "2023-10-10T01:42:00+03:00",
    "guarantee": {
      "amount": 8.0,
      "currency": "USD"
    },
    "documents": [
      {
        "documentType": "technicalSpecifications",
        "description": "document description modified",
        "id": "bc77152edc4647f4a9ff5b77ea6647c1",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Notice.pdf",
        "format": "application/pdf",
        "url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents/bc77152edc4647f4a9ff5b77ea6647c1?download=d351393c1280494ba80f9ffa0b2345f7",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "author": "tender_owner",
        "language": "uk"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "AwardCriteria.pdf",
        "format": "application/pdf",
        "url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents/1d37ebaf83c64c198751e4523dc6780e?download=dd09c74752f54370b81db56456d4622c",
        "documentOf": "tender",
        "language": "uk",
        "id": "1d37ebaf83c64c198751e4523dc6780e",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "author": "tender_owner"
      },
      {
        "id": "1d37ebaf83c64c198751e4523dc6780e",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "AwardCriteria-2.pdf",
        "format": "application/pdf",
        "url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/documents/1d37ebaf83c64c198751e4523dc6780e?download=1c680c5a847e47d397d53c35cd19ac5f",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "author": "tender_owner",
        "language": "uk"
      }
    ],
    "auctionPeriod": {
      "startDate": "2023-10-10T01:00:00+03:00"
    },
    "id": "782a773bcc70490e923de940a94a5ada"
  },
  "config": {
    "hasAuction": true,
    "hasAwardingOrder": true,
    "hasValueRestriction": true,
    "valueCurrencyEquality": true,
    "hasPrequalification": false,
    "minBidsNumber": 1,
    "hasPreSelectionAgreement": true,
    "hasTenderComplaints": false,
    "hasAwardComplaints": false,
    "hasCancellationComplaints": false,
    "restricted": false
  }
}

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

Request

GET /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/bids/086af210a2bc41908a0dd9988134a118?acc_token=7483e385045b4fdbbc4a88bf724bbcee HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "tenderers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "large"
      }
    ],
    "status": "active",
    "id": "086af210a2bc41908a0dd9988134a118",
    "date": "2023-10-10T01:00:00+03:00",
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "value": {
          "amount": 500.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42",
        "status": "active",
        "date": "2023-10-10T01:00:00+03:00",
        "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/782a773bcc70490e923de940a94a5ada_50fc7d0cb4e3423491c35387a046af42?key_for_bid=086af210a2bc41908a0dd9988134a118"
      }
    ],
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e5d937aec73f4c07aec4e91e7de7d0c0?Signature=i1QFE0pwj%2BuQT99%2FY4GX2uZghCioK2WSMSpY6%2BMlXr1TETaF6FoXkWJE5ceSIenvOO9CMxJTx4kTn5aoga4JAw%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "language": "uk",
        "id": "b336781d876d47e281e111bf33ffd16b",
        "confidentiality": "public",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "dateModified": "2023-10-10T01:00:00+03:00"
      }
    ]
  }
}

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

Request

GET /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/bids/5e3e02b6dd9849d98c48bf9d741a036e?acc_token=c690cc2a16bb4052bcba2502d07449d6 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "tenderers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "status": "active",
    "id": "5e3e02b6dd9849d98c48bf9d741a036e",
    "date": "2023-10-10T01:00:00+03:00",
    "documents": [
      {
        "id": "a203d9a0cbf14608b5c4b00138da513f",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part1.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6f5d54d6f96e4f93bb84aaf2005ecd74?Signature=gWkknoOyOQh2cpnX6nZmhLZJrFxulp8qPlSiERXttONVOcfK8ZCL1ksm1AQp292iAQqY6uzphnL10nz8PEnlAA%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk",
        "confidentiality": "public"
      },
      {
        "id": "fd4040a443574d50b13ffdd5c99ac6b2",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7c465d3486b487db509f0e8482bcafd?Signature=Dt0bUdqRLCf5ENnzoOZDqA6XZdViV36%2BLgE4rzqjUtBbVG0krDrux7p3D7C45U3%2BZaqfHqB1ntI9LVS%2F6PoeCg%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk",
        "confidentiality": "public"
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "value": {
          "amount": 499.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "50fc7d0cb4e3423491c35387a046af42",
        "status": "active",
        "date": "2023-10-10T01:00:00+03:00",
        "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/782a773bcc70490e923de940a94a5ada_50fc7d0cb4e3423491c35387a046af42?key_for_bid=5e3e02b6dd9849d98c48bf9d741a036e"
      }
    ]
  }
}

Список awards

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

Request

GET /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/awards HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "id": "6671c674a42e455c887070851a9d944f",
      "status": "pending",
      "date": "2023-10-10T01:00:00+03:00",
      "value": {
        "amount": 499.0,
        "currency": "UAH",
        "valueAddedTaxIncluded": true
      },
      "weightedValue": {
        "amount": 388.11,
        "currency": "UAH",
        "valueAddedTaxIncluded": true,
        "denominator": 1.286
      },
      "suppliers": [
        {
          "name": "Державне управління справами",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00037257",
            "uri": "http://www.dus.gov.ua/"
          },
          "address": {
            "streetAddress": "вул. Банкова, 11, корпус 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "01220",
            "countryName": "Україна"
          },
          "contactPoint": {
            "name": "Державне управління справами",
            "telephone": "+0440000000"
          },
          "scale": "micro"
        }
      ],
      "bid_id": "5e3e02b6dd9849d98c48bf9d741a036e",
      "lotID": "50fc7d0cb4e3423491c35387a046af42"
    }
  ]
}

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

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

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/awards/6671c674a42e455c887070851a9d944f?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "unsuccessful"
  }
}

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Can't update award status to unsuccessful, if tender status is active.qualification and there is no cancelled award with the same bid_id"
    }
  ]
}

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

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/awards/6671c674a42e455c887070851a9d944f?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "id": "6671c674a42e455c887070851a9d944f",
    "status": "active",
    "date": "2023-10-10T01:00:00+03:00",
    "value": {
      "amount": 499.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "weightedValue": {
      "amount": 388.11,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "denominator": 1.286
    },
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "bid_id": "5e3e02b6dd9849d98c48bf9d741a036e",
    "lotID": "50fc7d0cb4e3423491c35387a046af42"
  }
}

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

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/awards/6671c674a42e455c887070851a9d944f?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "cancelled"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/awards/f91dd540f6b946ca886d8d456a20de0a

{
  "data": {
    "id": "6671c674a42e455c887070851a9d944f",
    "status": "cancelled",
    "date": "2023-10-10T01:00:00+03:00",
    "value": {
      "amount": 499.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "weightedValue": {
      "amount": 388.11,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "denominator": 1.286
    },
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "bid_id": "5e3e02b6dd9849d98c48bf9d741a036e",
    "lotID": "50fc7d0cb4e3423491c35387a046af42"
  }
}

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

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/awards/f91dd540f6b946ca886d8d456a20de0a?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "unsuccessful"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/awards/e12ce2ce3df94f858ad5e9b5d82d198e

{
  "data": {
    "id": "f91dd540f6b946ca886d8d456a20de0a",
    "status": "unsuccessful",
    "date": "2023-10-10T01:00:00+03:00",
    "value": {
      "amount": 499.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "weightedValue": {
      "amount": 388.11,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "denominator": 1.286
    },
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "bid_id": "5e3e02b6dd9849d98c48bf9d741a036e",
    "lotID": "50fc7d0cb4e3423491c35387a046af42"
  }
}

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

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/awards/e12ce2ce3df94f858ad5e9b5d82d198e?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "id": "e12ce2ce3df94f858ad5e9b5d82d198e",
    "status": "active",
    "date": "2023-10-10T01:00:00+03:00",
    "value": {
      "amount": 499.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "weightedValue": {
      "amount": 388.11,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "denominator": 1.286
    },
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037258",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "bid_id": "4e311c4d009d49778d713542b06cefa4",
    "lotID": "50fc7d0cb4e3423491c35387a046af42"
  }
}

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

Налаштування угоди

Є два режими контрактування в залежності від конфігурації системи:

Контрактінг

В режимі звичайного контрактінгу угода буде створена спочатку в системі закупівель.

Більше дізнатись про роботу з контрактінгом в системі закупівель можна в розділі Туторіал (Реєстрація угоди).

Коли закупівля завершена (після активації угод), угода (яка була створена в системі закупівель) автоматично переноситься до системи угод.

Більше дізнатись про роботу з контрактінгом в системі угод можна в розділі Туторіал.

Е-Контрактінг

В режимі Е-Контрактінгу угода створюється безпосередньо в системі угод.

Примітка

Деякі дані для забезпечення сумісності будуть дублюватись в закупівлі до тих пір, поки угода не буде активована.

Більше дізнатись про роботу з Е-Контрактінгом в системі угод можна в розділі Туторіал.

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

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

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

  1. Приготуйте запит на скасування

  2. Наповніть його протоколом про причини скасування

  3. Скасуйте закупівлю через подані причини.

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

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

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

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

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

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

Request

POST /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/cancellations?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "reason": "cancellation reason",
    "reasonType": "noDemand"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/cancellations/08f6451bcfcd450a91d812798971e820

{
  "data": {
    "reasonType": "noDemand",
    "reason": "cancellation reason",
    "id": "08f6451bcfcd450a91d812798971e820",
    "date": "2023-10-10T01:00:00+03:00",
    "cancellationOf": "tender",
    "status": "draft"
  }
}

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

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

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

Request

POST /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/cancellations/08f6451bcfcd450a91d812798971e820/documents?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a83f0a33f5af423ca2e0d30d39935784?Signature=TmZlsGA0myFb5UYGdwSF0BgZO%2BcYz4NZl4srBStswad93jDjgNRS6TFpTSTK9yXuw7wurF2iZSOgM68G%2B917CA%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/782a773bcc70490e923de940a94a5ada/cancellations/08f6451bcfcd450a91d812798971e820/documents/f625585c8ef5479b9674d874bfb91c95

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a83f0a33f5af423ca2e0d30d39935784?Signature=9jE1X0uFLKzjDVyMW6miRQjQ79QgJ8%2BNMMIBhQ2PUz3vSPdXimT3XHkjNowMCwcuziKASLF7HZ%2FH%2FbRX8zWEDQ%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "language": "uk",
    "id": "f625585c8ef5479b9674d874bfb91c95",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00"
  }
}

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

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/cancellations/08f6451bcfcd450a91d812798971e820/documents/f625585c8ef5479b9674d874bfb91c95?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "description": "Changed description"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "description": "Changed description",
    "id": "f625585c8ef5479b9674d874bfb91c95",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a83f0a33f5af423ca2e0d30d39935784?Signature=9jE1X0uFLKzjDVyMW6miRQjQ79QgJ8%2BNMMIBhQ2PUz3vSPdXimT3XHkjNowMCwcuziKASLF7HZ%2FH%2FbRX8zWEDQ%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "language": "uk"
  }
}

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

Request

PUT /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/cancellations/08f6451bcfcd450a91d812798971e820/documents/f625585c8ef5479b9674d874bfb91c95?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Notice-2.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/52885cec7411475ea472a5688d3739f9?Signature=6vsSN7PC7P0QepWvmz5xQ0QltP9f6c0hgg5sHvKaxOGaCFpDL%2FGzTPQ4PUfB5ZGhKqqF60J0xigyxfD0sKEcDg%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "description": "Changed description",
    "id": "f625585c8ef5479b9674d874bfb91c95",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice-2.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/52885cec7411475ea472a5688d3739f9?Signature=eCACfBQqTNvM5orOFP9q1lq7%2Bo0kIVneUJC3Hd7cnFgS0ngh8QxWFf3CvXLgVOuLK2jYZLSSwJ2KaPDNI7fcCA%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "language": "uk"
  }
}

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

Request

PATCH /api/2.5/tenders/782a773bcc70490e923de940a94a5ada/cancellations/08f6451bcfcd450a91d812798971e820?acc_token=ee095d9d556042c3afc71a91cc4b9236 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "id": "08f6451bcfcd450a91d812798971e820",
    "status": "active",
    "date": "2023-10-10T01:00:00+03:00",
    "reasonType": "noDemand",
    "reason": "cancellation reason",
    "cancellationOf": "tender",
    "documents": [
      {
        "description": "Changed description",
        "id": "f625585c8ef5479b9674d874bfb91c95",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Notice.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/a83f0a33f5af423ca2e0d30d39935784?Signature=9jE1X0uFLKzjDVyMW6miRQjQ79QgJ8%2BNMMIBhQ2PUz3vSPdXimT3XHkjNowMCwcuziKASLF7HZ%2FH%2FbRX8zWEDQ%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      },
      {
        "description": "Changed description",
        "id": "f625585c8ef5479b9674d874bfb91c95",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Notice-2.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/52885cec7411475ea472a5688d3739f9?Signature=eCACfBQqTNvM5orOFP9q1lq7%2Bo0kIVneUJC3Hd7cnFgS0ngh8QxWFf3CvXLgVOuLK2jYZLSSwJ2KaPDNI7fcCA%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk"
      }
    ]
  }
}

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