Criteria Basic Operation

Criteria data schema

Criteria is part of tender documentation, so all operation with criteria make tender owner.

Create Tender Criteria

Criteria exist in procedures: belowThreshold, aboveThreshold, aboveThresholdUA, aboveThresholdEU, competitiveOrdering, competitiveDialogueUA, competitiveDialogueEU, competitiveDialogueUA.stage2, competitiveDialogueEU.stage2, esco, closeFrameworkAgreementUA, closeFrameworkAgreementSelectionUA

Criteria can be related to tenderer, lot, item and tender. You cannot cancel lot or item if there is at least one related criterion with requirement in active status. To cancel lot or set item quantity to 0 you should set cancelled status to all active requirements in related criterion or delete criterion (only in draft tender).

You can create few criteria in one request with complete set of data.

Request

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

{
  "data": [
    {
      "requirementGroups": [
        {
          "requirements": [
            {
              "dataType": "boolean",
              "eligibleEvidences": [
                {
                  "title": "Документальне підтвердження",
                  "description": "Довідка в довільній формі",
                  "type": "document"
                }
              ],
              "expectedValue": true,
              "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів"
            }
          ],
          "description": "Підтверджується, що"
        }
      ],
      "description": "Cуб’єкт господарювання (учасник) протягом останніх трьох років притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів",
      "classification": {
        "scheme": "ESPD211",
        "id": "CRITERION.SELECTION.TECHNICAL_PROFESSIONAL_ABILITY.TECHNICAL.ENVIRONMENTAL_MANAGEMENT_MEASURES"
      },
      "title": "Вчинення економічних правопорушень",
      "relatesTo": "tender",
      "legislation": [
        {
          "version": "2024-10-23",
          "identifier": {
            "id": "922-VIII",
            "legalName": "Закон України \"Про публічні закупівлі\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1261"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "17.1.4"
        },
        {
          "version": "2024-05-16",
          "identifier": {
            "id": "2210-III",
            "legalName": "Закон України \"Про захист економічної конкуренції\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n46"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "6.2.4"
        },
        {
          "version": "2024-05-16",
          "identifier": {
            "id": "2210-III",
            "legalName": "Закон України \"Про захист економічної конкуренції\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n456"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "50.1"
        }
      ],
      "source": "tenderer"
    }
  ]
}

Response

HTTP/1.0 201 Created
Content-Type: application/json

{
  "data": [
    {
      "id": "bbff38f98f1c45deb2a2d3c28ed1224f",
      "description": "Cуб’єкт господарювання (учасник) протягом останніх трьох років притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів",
      "source": "tenderer",
      "relatesTo": "tender",
      "classification": {
        "scheme": "ESPD211",
        "id": "CRITERION.SELECTION.TECHNICAL_PROFESSIONAL_ABILITY.TECHNICAL.ENVIRONMENTAL_MANAGEMENT_MEASURES"
      },
      "title": "Вчинення економічних правопорушень",
      "legislation": [
        {
          "version": "2024-10-23",
          "identifier": {
            "id": "922-VIII",
            "legalName": "Закон України \"Про публічні закупівлі\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1261"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "17.1.4"
        },
        {
          "version": "2024-05-16",
          "identifier": {
            "id": "2210-III",
            "legalName": "Закон України \"Про захист економічної конкуренції\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n46"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "6.2.4"
        },
        {
          "version": "2024-05-16",
          "identifier": {
            "id": "2210-III",
            "legalName": "Закон України \"Про захист економічної конкуренції\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n456"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "50.1"
        }
      ],
      "requirementGroups": [
        {
          "id": "bad719a980bf4d5c939a4aa0106784ed",
          "description": "Підтверджується, що",
          "requirements": [
            {
              "id": "d394af35f58042b6a57575e1f1ed2767",
              "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів",
              "dataType": "boolean",
              "eligibleEvidences": [
                {
                  "title": "Документальне підтвердження",
                  "description": "Довідка в довільній формі",
                  "type": "document",
                  "id": "8c8f9af9e5244464bbe7f9c7ac648d30"
                }
              ],
              "status": "active",
              "expectedValue": true,
              "datePublished": "2023-10-10T01:00:00+03:00"
            }
          ]
        }
      ]
    }
  ]
}

Update Tender Criteria

Request

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

{
  "data": {
    "title": "Updated title"
  }
}

Response

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

{
  "data": {
    "id": "bbff38f98f1c45deb2a2d3c28ed1224f",
    "description": "Cуб’єкт господарювання (учасник) протягом останніх трьох років притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів",
    "source": "tenderer",
    "relatesTo": "tender",
    "classification": {
      "scheme": "ESPD211",
      "id": "CRITERION.SELECTION.TECHNICAL_PROFESSIONAL_ABILITY.TECHNICAL.ENVIRONMENTAL_MANAGEMENT_MEASURES"
    },
    "title": "Updated title",
    "legislation": [
      {
        "version": "2024-10-23",
        "identifier": {
          "id": "922-VIII",
          "legalName": "Закон України \"Про публічні закупівлі\"",
          "uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1261"
        },
        "type": "NATIONAL_LEGISLATION",
        "article": "17.1.4"
      },
      {
        "version": "2024-05-16",
        "identifier": {
          "id": "2210-III",
          "legalName": "Закон України \"Про захист економічної конкуренції\"",
          "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n46"
        },
        "type": "NATIONAL_LEGISLATION",
        "article": "6.2.4"
      },
      {
        "version": "2024-05-16",
        "identifier": {
          "id": "2210-III",
          "legalName": "Закон України \"Про захист економічної конкуренції\"",
          "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n456"
        },
        "type": "NATIONAL_LEGISLATION",
        "article": "50.1"
      }
    ],
    "requirementGroups": [
      {
        "id": "bad719a980bf4d5c939a4aa0106784ed",
        "description": "Підтверджується, що",
        "requirements": [
          {
            "id": "d394af35f58042b6a57575e1f1ed2767",
            "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів",
            "dataType": "boolean",
            "eligibleEvidences": [
              {
                "title": "Документальне підтвердження",
                "description": "Довідка в довільній формі",
                "type": "document",
                "id": "8c8f9af9e5244464bbe7f9c7ac648d30"
              }
            ],
            "status": "active",
            "expectedValue": true,
            "datePublished": "2023-10-10T01:00:00+03:00"
          }
        ]
      }
    ]
  }
}

Get Tender Criteria

Request

GET /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria 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": "bbff38f98f1c45deb2a2d3c28ed1224f",
      "description": "Cуб’єкт господарювання (учасник) протягом останніх трьох років притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів",
      "source": "tenderer",
      "relatesTo": "tender",
      "classification": {
        "scheme": "ESPD211",
        "id": "CRITERION.SELECTION.TECHNICAL_PROFESSIONAL_ABILITY.TECHNICAL.ENVIRONMENTAL_MANAGEMENT_MEASURES"
      },
      "title": "Updated title",
      "legislation": [
        {
          "version": "2024-10-23",
          "identifier": {
            "id": "922-VIII",
            "legalName": "Закон України \"Про публічні закупівлі\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1261"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "17.1.4"
        },
        {
          "version": "2024-05-16",
          "identifier": {
            "id": "2210-III",
            "legalName": "Закон України \"Про захист економічної конкуренції\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n46"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "6.2.4"
        },
        {
          "version": "2024-05-16",
          "identifier": {
            "id": "2210-III",
            "legalName": "Закон України \"Про захист економічної конкуренції\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n456"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "50.1"
        }
      ],
      "requirementGroups": [
        {
          "id": "bad719a980bf4d5c939a4aa0106784ed",
          "description": "Updated description",
          "requirements": [
            {
              "id": "d394af35f58042b6a57575e1f1ed2767",
              "title": "Updated title",
              "dataType": "boolean",
              "eligibleEvidences": [
                {
                  "title": "Документальне підтвердження",
                  "description": "Довідка в довільній формі",
                  "type": "document",
                  "id": "b6d489e6b1a44bcbbdb511ce307d773b"
                },
                {
                  "title": "Документальне підтвердження",
                  "description": "Довідка в довільній формі",
                  "type": "statement",
                  "id": "04f5c92847364679ad700e5fef2065c9"
                }
              ],
              "expectedValue": true,
              "datePublished": "2023-10-10T01:00:00+03:00",
              "status": "active"
            },
            {
              "id": "081dceb6c124494cbdf71784175644c6",
              "title": "Another characteristic",
              "dataType": "boolean",
              "eligibleEvidences": [
                {
                  "title": "Документальне підтвердження",
                  "description": "Довідка в довільній формі",
                  "type": "document",
                  "id": "468c0f9fbb884f65ab2b562ede73b234"
                }
              ],
              "status": "active",
              "expectedValue": true,
              "datePublished": "2023-10-10T01:00:00+03:00"
            }
          ]
        },
        {
          "id": "434e2574301a467e8328a7d6a8ce6916",
          "description": "Підтверджується, що",
          "requirements": [
            {
              "id": "a2b9d85ba13d4d49a04c89f71f1f8c33",
              "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів",
              "dataType": "boolean",
              "eligibleEvidences": [
                {
                  "title": "Документальне підтвердження",
                  "description": "Довідка в довільній формі",
                  "type": "document",
                  "id": "2b4fc422cc294678bc01063173bb8535"
                }
              ],
              "status": "active",
              "expectedValue": true,
              "datePublished": "2023-10-10T01:00:00+03:00"
            }
          ]
        }
      ]
    },
    {
      "id": "2c882107c3df4accb409505309fc598d",
      "description": "Cуб’єкт господарювання (учасник) протягом останніх трьох років притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів",
      "source": "tenderer",
      "relatesTo": "tender",
      "classification": {
        "scheme": "ESPD211",
        "id": "CRITERION.EXCLUSION.CONVICTIONS.FRAUD"
      },
      "title": "Вчинення економічних правопорушень",
      "legislation": [
        {
          "version": "2024-10-23",
          "identifier": {
            "id": "922-VIII",
            "legalName": "Закон України \"Про публічні закупівлі\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1261"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "17.1.4"
        },
        {
          "version": "2024-05-16",
          "identifier": {
            "id": "2210-III",
            "legalName": "Закон України \"Про захист економічної конкуренції\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n46"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "6.2.4"
        },
        {
          "version": "2024-05-16",
          "identifier": {
            "id": "2210-III",
            "legalName": "Закон України \"Про захист економічної конкуренції\"",
            "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n456"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "50.1"
        }
      ],
      "requirementGroups": [
        {
          "id": "c3bd4e33d8f548db973c4a48df01a298",
          "description": "Підтверджується, що",
          "requirements": [
            {
              "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
              "title": "Updated title",
              "dataType": "boolean",
              "eligibleEvidences": [
                {
                  "title": "Документальне підтвердження",
                  "description": "Довідка в довільній формі",
                  "type": "document",
                  "id": "04cd6b2f592e423fb3e8ebca48d236e7"
                }
              ],
              "expectedValue": false,
              "datePublished": "2023-10-10T01:00:00+03:00",
              "status": "active"
            },
            {
              "id": "16d7f233a6cb4503b6baf8273871732c",
              "title": "Another characteristic",
              "dataType": "boolean",
              "eligibleEvidences": [
                {
                  "title": "Документальне підтвердження",
                  "description": "Довідка в довільній формі",
                  "type": "document",
                  "id": "cd1adfae4f234af7b62dc0992ce4028d"
                }
              ],
              "status": "active",
              "expectedValue": true,
              "datePublished": "2023-10-10T01:00:00+03:00"
            }
          ]
        }
      ]
    }
  ]
}

Request

GET /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f 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": "bbff38f98f1c45deb2a2d3c28ed1224f",
    "description": "Cуб’єкт господарювання (учасник) протягом останніх трьох років притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів",
    "source": "tenderer",
    "relatesTo": "tender",
    "classification": {
      "scheme": "ESPD211",
      "id": "CRITERION.SELECTION.TECHNICAL_PROFESSIONAL_ABILITY.TECHNICAL.ENVIRONMENTAL_MANAGEMENT_MEASURES"
    },
    "title": "Updated title",
    "legislation": [
      {
        "version": "2024-10-23",
        "identifier": {
          "id": "922-VIII",
          "legalName": "Закон України \"Про публічні закупівлі\"",
          "uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1261"
        },
        "type": "NATIONAL_LEGISLATION",
        "article": "17.1.4"
      },
      {
        "version": "2024-05-16",
        "identifier": {
          "id": "2210-III",
          "legalName": "Закон України \"Про захист економічної конкуренції\"",
          "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n46"
        },
        "type": "NATIONAL_LEGISLATION",
        "article": "6.2.4"
      },
      {
        "version": "2024-05-16",
        "identifier": {
          "id": "2210-III",
          "legalName": "Закон України \"Про захист економічної конкуренції\"",
          "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n456"
        },
        "type": "NATIONAL_LEGISLATION",
        "article": "50.1"
      }
    ],
    "requirementGroups": [
      {
        "id": "bad719a980bf4d5c939a4aa0106784ed",
        "description": "Updated description",
        "requirements": [
          {
            "id": "d394af35f58042b6a57575e1f1ed2767",
            "title": "Updated title",
            "dataType": "boolean",
            "eligibleEvidences": [
              {
                "title": "Документальне підтвердження",
                "description": "Довідка в довільній формі",
                "type": "document",
                "id": "b6d489e6b1a44bcbbdb511ce307d773b"
              },
              {
                "title": "Документальне підтвердження",
                "description": "Довідка в довільній формі",
                "type": "statement",
                "id": "04f5c92847364679ad700e5fef2065c9"
              }
            ],
            "expectedValue": true,
            "datePublished": "2023-10-10T01:00:00+03:00",
            "status": "active"
          },
          {
            "id": "081dceb6c124494cbdf71784175644c6",
            "title": "Another characteristic",
            "dataType": "boolean",
            "eligibleEvidences": [
              {
                "title": "Документальне підтвердження",
                "description": "Довідка в довільній формі",
                "type": "document",
                "id": "468c0f9fbb884f65ab2b562ede73b234"
              }
            ],
            "status": "active",
            "expectedValue": true,
            "datePublished": "2023-10-10T01:00:00+03:00"
          }
        ]
      },
      {
        "id": "434e2574301a467e8328a7d6a8ce6916",
        "description": "Підтверджується, що",
        "requirements": [
          {
            "id": "a2b9d85ba13d4d49a04c89f71f1f8c33",
            "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів",
            "dataType": "boolean",
            "eligibleEvidences": [
              {
                "title": "Документальне підтвердження",
                "description": "Довідка в довільній формі",
                "type": "document",
                "id": "2b4fc422cc294678bc01063173bb8535"
              }
            ],
            "status": "active",
            "expectedValue": true,
            "datePublished": "2023-10-10T01:00:00+03:00"
          }
        ]
      }
    ]
  }
}

Delete Tender Criteria

When tender is in draft status it is allowed to delete criterion by id using DELETE endpoint:

Request

DELETE /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": {
    "id": "bbff38f98f1c45deb2a2d3c28ed1224f",
    "description": "Cуб’єкт господарювання (учасник) протягом останніх трьох років притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів",
    "source": "tenderer",
    "relatesTo": "tender",
    "classification": {
      "scheme": "ESPD211",
      "id": "CRITERION.SELECTION.TECHNICAL_PROFESSIONAL_ABILITY.TECHNICAL.ENVIRONMENTAL_MANAGEMENT_MEASURES"
    },
    "title": "Updated title",
    "legislation": [
      {
        "version": "2024-10-23",
        "identifier": {
          "id": "922-VIII",
          "legalName": "Закон України \"Про публічні закупівлі\"",
          "uri": "https://zakon.rada.gov.ua/laws/show/922-19#n1261"
        },
        "type": "NATIONAL_LEGISLATION",
        "article": "17.1.4"
      },
      {
        "version": "2024-05-16",
        "identifier": {
          "id": "2210-III",
          "legalName": "Закон України \"Про захист економічної конкуренції\"",
          "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n46"
        },
        "type": "NATIONAL_LEGISLATION",
        "article": "6.2.4"
      },
      {
        "version": "2024-05-16",
        "identifier": {
          "id": "2210-III",
          "legalName": "Закон України \"Про захист економічної конкуренції\"",
          "uri": "https://zakon.rada.gov.ua/laws/show/2210-14#n456"
        },
        "type": "NATIONAL_LEGISLATION",
        "article": "50.1"
      }
    ],
    "requirementGroups": [
      {
        "id": "bad719a980bf4d5c939a4aa0106784ed",
        "description": "Updated description",
        "requirements": [
          {
            "id": "d394af35f58042b6a57575e1f1ed2767",
            "title": "Updated title",
            "dataType": "boolean",
            "eligibleEvidences": [
              {
                "title": "Документальне підтвердження",
                "description": "Довідка в довільній формі",
                "type": "document",
                "id": "b6d489e6b1a44bcbbdb511ce307d773b"
              },
              {
                "title": "Документальне підтвердження",
                "description": "Довідка в довільній формі",
                "type": "statement",
                "id": "04f5c92847364679ad700e5fef2065c9"
              }
            ],
            "expectedValue": true,
            "datePublished": "2023-10-10T01:00:00+03:00",
            "status": "active"
          },
          {
            "id": "081dceb6c124494cbdf71784175644c6",
            "title": "Another characteristic",
            "dataType": "boolean",
            "eligibleEvidences": [
              {
                "title": "Документальне підтвердження",
                "description": "Довідка в довільній формі",
                "type": "document",
                "id": "468c0f9fbb884f65ab2b562ede73b234"
              }
            ],
            "status": "active",
            "expectedValue": true,
            "datePublished": "2023-10-10T01:00:00+03:00"
          }
        ]
      },
      {
        "id": "434e2574301a467e8328a7d6a8ce6916",
        "description": "Підтверджується, що",
        "requirements": [
          {
            "id": "a2b9d85ba13d4d49a04c89f71f1f8c33",
            "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів",
            "dataType": "boolean",
            "eligibleEvidences": [
              {
                "title": "Документальне підтвердження",
                "description": "Довідка в довільній формі",
                "type": "document",
                "id": "2b4fc422cc294678bc01063173bb8535"
              }
            ],
            "status": "active",
            "expectedValue": true,
            "datePublished": "2023-10-10T01:00:00+03:00"
          }
        ]
      }
    ]
  }
}

Let’s try to delete criterion when tender doesn’t have draft status:

Request

DELETE /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response

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

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Only allowed in draft tender status"
    }
  ]
}

Requirement Group basic operation

Requirement group schema

Requirement group that’s object that contain requirements, and sets the rules for how to respond to requirements.

Inside requirement groups you must gave response to all requirements(that’s mean gave response to requirement group). If criterion have more than one requirement groups you must gave response only to one requirement group. If you try to gave responses to few requirement groups system will be returned error.

There you can see how it works on practice.

Create Criteria Requirement Group

Request

POST /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "requirements": [
      {
        "dataType": "boolean",
        "eligibleEvidences": [
          {
            "title": "Документальне підтвердження",
            "description": "Довідка в довільній формі",
            "type": "document"
          }
        ],
        "expectedValue": true,
        "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів"
      }
    ],
    "description": "Підтверджується, що"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json

{
  "data": {
    "id": "434e2574301a467e8328a7d6a8ce6916",
    "description": "Підтверджується, що",
    "requirements": [
      {
        "id": "a2b9d85ba13d4d49a04c89f71f1f8c33",
        "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів",
        "dataType": "boolean",
        "eligibleEvidences": [
          {
            "title": "Документальне підтвердження",
            "description": "Довідка в довільній формі",
            "type": "document",
            "id": "2b4fc422cc294678bc01063173bb8535"
          }
        ],
        "status": "active",
        "expectedValue": true,
        "datePublished": "2023-10-10T01:00:00+03:00"
      }
    ]
  }
}

Update Criteria Requirement Group

Request

PATCH /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "description": "Updated description"
  }
}

Response

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

{
  "data": {
    "id": "bad719a980bf4d5c939a4aa0106784ed",
    "description": "Updated description",
    "requirements": [
      {
        "id": "d394af35f58042b6a57575e1f1ed2767",
        "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів",
        "dataType": "boolean",
        "eligibleEvidences": [
          {
            "title": "Документальне підтвердження",
            "description": "Довідка в довільній формі",
            "type": "document",
            "id": "8c8f9af9e5244464bbe7f9c7ac648d30"
          }
        ],
        "status": "active",
        "expectedValue": true,
        "datePublished": "2023-10-10T01:00:00+03:00"
      }
    ]
  }
}

Get Criteria Requirement Group

Request

GET /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups 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": "bad719a980bf4d5c939a4aa0106784ed",
      "description": "Updated description",
      "requirements": [
        {
          "id": "d394af35f58042b6a57575e1f1ed2767",
          "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів",
          "dataType": "boolean",
          "eligibleEvidences": [
            {
              "title": "Документальне підтвердження",
              "description": "Довідка в довільній формі",
              "type": "document",
              "id": "8c8f9af9e5244464bbe7f9c7ac648d30"
            }
          ],
          "status": "active",
          "expectedValue": true,
          "datePublished": "2023-10-10T01:00:00+03:00"
        }
      ]
    },
    {
      "id": "434e2574301a467e8328a7d6a8ce6916",
      "description": "Підтверджується, що",
      "requirements": [
        {
          "id": "a2b9d85ba13d4d49a04c89f71f1f8c33",
          "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів",
          "dataType": "boolean",
          "eligibleEvidences": [
            {
              "title": "Документальне підтвердження",
              "description": "Довідка в довільній формі",
              "type": "document",
              "id": "2b4fc422cc294678bc01063173bb8535"
            }
          ],
          "status": "active",
          "expectedValue": true,
          "datePublished": "2023-10-10T01:00:00+03:00"
        }
      ]
    }
  ]
}

Request

GET /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed 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": "bad719a980bf4d5c939a4aa0106784ed",
    "description": "Updated description",
    "requirements": [
      {
        "id": "d394af35f58042b6a57575e1f1ed2767",
        "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів",
        "dataType": "boolean",
        "eligibleEvidences": [
          {
            "title": "Документальне підтвердження",
            "description": "Довідка в довільній формі",
            "type": "document",
            "id": "8c8f9af9e5244464bbe7f9c7ac648d30"
          }
        ],
        "status": "active",
        "expectedValue": true,
        "datePublished": "2023-10-10T01:00:00+03:00"
      }
    ]
  }
}

Requirement basic operation

Requirement model schema

Create Requirement

Request

POST /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "dataType": "boolean",
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document"
      }
    ],
    "expectedValue": true,
    "title": "Another characteristic"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements/081dceb6c124494cbdf71784175644c6

{
  "data": {
    "id": "081dceb6c124494cbdf71784175644c6",
    "title": "Another characteristic",
    "dataType": "boolean",
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document",
        "id": "468c0f9fbb884f65ab2b562ede73b234"
      }
    ],
    "status": "active",
    "expectedValue": true,
    "datePublished": "2023-10-10T01:00:00+03:00"
  }
}

Update Requirement

You can use PATCH method to update requirements for tenders in draft statuses.

Request

PATCH /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements/d394af35f58042b6a57575e1f1ed2767?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Updated title",
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document"
      }
    ]
  }
}

Response

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

{
  "data": {
    "id": "d394af35f58042b6a57575e1f1ed2767",
    "title": "Updated title",
    "dataType": "boolean",
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document",
        "id": "e6be23f5106e4fc6a52ee53f52fe3d14"
      }
    ],
    "expectedValue": true,
    "datePublished": "2023-10-10T01:00:00+03:00",
    "status": "active"
  }
}

To update requirement in non-draft status of tender you should use PUT method. New version with status active will be created. Status of old version of requirement will be changed to cancelled.

Request

PUT /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d/requirement_groups/c3bd4e33d8f548db973c4a48df01a298/requirements/bb11c06fbd5545ccb0284ff39aa2d6cc?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document"
      }
    ]
  }
}

Response

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

{
  "data": [
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "title": "Updated title",
      "dataType": "boolean",
      "eligibleEvidences": [
        {
          "title": "Документальне підтвердження",
          "description": "Довідка в довільній формі",
          "type": "document",
          "id": "2da609e556044832b40ee0980665ddb5"
        }
      ],
      "expectedValue": false,
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "active"
    },
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "cancelled",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}

Request

GET /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements 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": "d394af35f58042b6a57575e1f1ed2767",
      "title": "Updated title",
      "dataType": "boolean",
      "eligibleEvidences": [
        {
          "title": "Документальне підтвердження",
          "description": "Довідка в довільній формі",
          "type": "document",
          "id": "e6be23f5106e4fc6a52ee53f52fe3d14"
        }
      ],
      "expectedValue": true,
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "active"
    },
    {
      "id": "081dceb6c124494cbdf71784175644c6",
      "title": "Another characteristic",
      "dataType": "boolean",
      "eligibleEvidences": [
        {
          "title": "Документальне підтвердження",
          "description": "Довідка в довільній формі",
          "type": "document",
          "id": "468c0f9fbb884f65ab2b562ede73b234"
        }
      ],
      "status": "active",
      "expectedValue": true,
      "datePublished": "2023-10-10T01:00:00+03:00"
    }
  ]
}

Delete Requirement

To delete requirement from requirement group you can set status cancelled to this requirement.

Request

PUT /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d/requirement_groups/c3bd4e33d8f548db973c4a48df01a298/requirements/bb11c06fbd5545ccb0284ff39aa2d6cc?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 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

{
  "data": [
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "title": "Updated title",
      "dataType": "boolean",
      "expectedValue": false,
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "cancelled",
      "dateModified": "2023-10-10T01:00:00+03:00"
    },
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "cancelled",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}

Get Requirement

Request

GET /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements 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": "d394af35f58042b6a57575e1f1ed2767",
      "title": "Updated title",
      "dataType": "boolean",
      "eligibleEvidences": [
        {
          "title": "Документальне підтвердження",
          "description": "Довідка в довільній формі",
          "type": "document",
          "id": "e6be23f5106e4fc6a52ee53f52fe3d14"
        }
      ],
      "expectedValue": true,
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "active"
    },
    {
      "id": "081dceb6c124494cbdf71784175644c6",
      "title": "Another characteristic",
      "dataType": "boolean",
      "eligibleEvidences": [
        {
          "title": "Документальне підтвердження",
          "description": "Довідка в довільній формі",
          "type": "document",
          "id": "468c0f9fbb884f65ab2b562ede73b234"
        }
      ],
      "status": "active",
      "expectedValue": true,
      "datePublished": "2023-10-10T01:00:00+03:00"
    }
  ]
}

Request

GET /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements/d394af35f58042b6a57575e1f1ed2767 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": "d394af35f58042b6a57575e1f1ed2767",
    "title": "Updated title",
    "dataType": "boolean",
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document",
        "id": "e6be23f5106e4fc6a52ee53f52fe3d14"
      }
    ],
    "expectedValue": true,
    "datePublished": "2023-10-10T01:00:00+03:00",
    "status": "active"
  }
}

Eligible Evidence basic operation

Eligible Evidence model schema

Create Eligible Evidence

You can use POST method to add evidence for tenders in draft statuses.

Request

POST /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements/d394af35f58042b6a57575e1f1ed2767/evidences?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Документальне підтвердження",
    "description": "Довідка в довільній формі",
    "type": "document"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements/d394af35f58042b6a57575e1f1ed2767/evidences/e79b57e7321c4d7f93879c86c4bdbc63

{
  "data": {
    "title": "Документальне підтвердження",
    "description": "Довідка в довільній формі",
    "type": "document",
    "id": "e79b57e7321c4d7f93879c86c4bdbc63"
  }
}

To add evidence(s) in non-draft status of tender you should use PUT method on Requirement level with extended eligibleEvidences array. New version or Requirement with status active and with extended eligibleEvidences array will be created.

Request

PUT /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d/requirement_groups/c3bd4e33d8f548db973c4a48df01a298/requirements/bb11c06fbd5545ccb0284ff39aa2d6cc?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document"
      },
      {
        "title": "new, added by requirement PUT",
        "description": "Довідка в довільній формі",
        "type": "document"
      }
    ]
  }
}

Response

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

{
  "data": [
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "title": "Updated title",
      "dataType": "boolean",
      "eligibleEvidences": [
        {
          "title": "Документальне підтвердження",
          "description": "Довідка в довільній формі",
          "type": "document",
          "id": "409e775b7be2450489aee8f90d9cee47"
        },
        {
          "title": "new, added by requirement PUT",
          "description": "Довідка в довільній формі",
          "type": "document",
          "id": "f639f1c99f6c4f2e9067597b63b88309"
        }
      ],
      "expectedValue": false,
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "active"
    },
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "cancelled",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}

Update Eligible Evidence

You can use PATCH method to update evidence for tenders in draft statuses.

Request

PATCH /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements/d394af35f58042b6a57575e1f1ed2767/evidences/e79b57e7321c4d7f93879c86c4bdbc63?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title_en": "Documented approve"
  }
}

Response

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

{
  "data": {
    "title": "Документальне підтвердження",
    "title_en": "Documented approve",
    "description": "Довідка в довільній формі",
    "type": "document",
    "id": "e79b57e7321c4d7f93879c86c4bdbc63"
  }
}

To update evidence(s) in non-draft status of tender you should use PUT method on Requirement level with updated evidence(s) in eligibleEvidences array. New version or Requirement with status active and with changed eligibleEvidences array will be created.

Request

PUT /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d/requirement_groups/c3bd4e33d8f548db973c4a48df01a298/requirements/bb11c06fbd5545ccb0284ff39aa2d6cc?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document"
      },
      {
        "title": "changed_new, changed by requirement PUT",
        "description": "Довідка в довільній формі",
        "type": "document"
      }
    ]
  }
}

Response

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

{
  "data": [
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "title": "Updated title",
      "dataType": "boolean",
      "eligibleEvidences": [
        {
          "title": "Документальне підтвердження",
          "description": "Довідка в довільній формі",
          "type": "document",
          "id": "6d5c66dfef5f498188ab0f30242de1a0"
        },
        {
          "title": "changed_new, changed by requirement PUT",
          "description": "Довідка в довільній формі",
          "type": "document",
          "id": "70df1ad35ad74842b33bd3a5152cf02b"
        }
      ],
      "expectedValue": false,
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "active"
    },
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "cancelled",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}

Delete Eligible Evidence

You can use DELETE method to delete evidence for tenders in draft statuses.

Request

DELETE /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements/d394af35f58042b6a57575e1f1ed2767/evidences/e79b57e7321c4d7f93879c86c4bdbc63?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": {
    "title": "Документальне підтвердження",
    "title_en": "Documented approve",
    "description": "Довідка в довільній формі",
    "type": "document",
    "id": "e79b57e7321c4d7f93879c86c4bdbc63"
  }
}

For tenders in non-draft statuses evidence(s) can be deleted from Requirement only by using PUT method on Requirement level. Use eligibleEvidences array without some evidence(s) to delete them from Requirement. To delete all evidences from Requirement use empty array for eligibleEvidences field.

Request

PUT /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d/requirement_groups/c3bd4e33d8f548db973c4a48df01a298/requirements/bb11c06fbd5545ccb0284ff39aa2d6cc?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "eligibleEvidences": []
  }
}

Response

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

{
  "data": [
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "title": "Updated title",
      "dataType": "boolean",
      "expectedValue": false,
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "active"
    },
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "cancelled",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}

For tenders in draft statuses there is possibility to create, update and delete eligibleEvidences, make PATCH request to requirement and send new list of eligibleEvidences:

Request

PATCH /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements/d394af35f58042b6a57575e1f1ed2767?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document"
      },
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "statement"
      }
    ]
  }
}

Response

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

{
  "data": {
    "id": "d394af35f58042b6a57575e1f1ed2767",
    "title": "Updated title",
    "dataType": "boolean",
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document",
        "id": "20c84440c512429eac7c051d0403109d"
      },
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "statement",
        "id": "803904d3b27c4220b62d2b9e62ebe919"
      }
    ],
    "expectedValue": true,
    "datePublished": "2023-10-10T01:00:00+03:00",
    "status": "active"
  }
}

Request

PATCH /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements/d394af35f58042b6a57575e1f1ed2767?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "statement",
        "id": "803904d3b27c4220b62d2b9e62ebe919"
      }
    ]
  }
}

Response

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

{
  "data": {
    "id": "d394af35f58042b6a57575e1f1ed2767",
    "title": "Updated title",
    "dataType": "boolean",
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "statement",
        "id": "803904d3b27c4220b62d2b9e62ebe919"
      }
    ],
    "expectedValue": true,
    "datePublished": "2023-10-10T01:00:00+03:00",
    "status": "active"
  }
}

Retrieve Eligible Evidence

Request

GET /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements/d394af35f58042b6a57575e1f1ed2767/evidences 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": "Документальне підтвердження",
      "description": "Довідка в довільній формі",
      "type": "document",
      "id": "b6d489e6b1a44bcbbdb511ce307d773b"
    },
    {
      "title": "Документальне підтвердження",
      "description": "Довідка в довільній формі",
      "type": "statement",
      "id": "04f5c92847364679ad700e5fef2065c9"
    },
    {
      "title": "Документальне підтвердження",
      "title_en": "Documented approve",
      "description": "Довідка в довільній формі",
      "type": "document",
      "id": "e79b57e7321c4d7f93879c86c4bdbc63"
    }
  ]
}

Request

GET /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/bbff38f98f1c45deb2a2d3c28ed1224f/requirement_groups/bad719a980bf4d5c939a4aa0106784ed/requirements/d394af35f58042b6a57575e1f1ed2767/evidences/e79b57e7321c4d7f93879c86c4bdbc63 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": "Документальне підтвердження",
    "title_en": "Documented approve",
    "description": "Довідка в довільній формі",
    "type": "document",
    "id": "e79b57e7321c4d7f93879c86c4bdbc63"
  }
}

Exclusion criteria

Exclusion criteria are required for the following procedures: aboveThreshold, aboveThresholdUA, aboveThresholdEU, competitiveOrdering, competitiveDialogueUA, competitiveDialogueEU, esco, closeFrameworkAgreementUA, simple.defense.

Standard data, you could get here

You can’t update tender to status active.tendering without 11 EXCLUSION and OTHER required criteria:

Request

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

{
  "data": {
    "status": "active.tendering"
  }
}

Response

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

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Tender must contain all required criteria: CRITERION.EXCLUSION.BUSINESS.BANKRUPTCY, CRITERION.EXCLUSION.CONFLICT_OF_INTEREST.EARLY_TERMINATION, CRITERION.EXCLUSION.CONFLICT_OF_INTEREST.MISINTERPRETATION, CRITERION.EXCLUSION.CONTRIBUTIONS.PAYMENT_OF_TAXES, CRITERION.EXCLUSION.CONVICTIONS.CHILD_LABOUR-HUMAN_TRAFFICKING, CRITERION.EXCLUSION.CONVICTIONS.CORRUPTION, CRITERION.EXCLUSION.CONVICTIONS.FRAUD, CRITERION.EXCLUSION.CONVICTIONS.PARTICIPATION_IN_CRIMINAL_ORGANISATION, CRITERION.EXCLUSION.CONVICTIONS.TERRORIST_OFFENCES, CRITERION.EXCLUSION.MISCONDUCT.MARKET_DISTORTION, CRITERION.EXCLUSION.NATIONAL.OTHER, CRITERION.OTHER.BID.LANGUAGE, CRITERION.OTHER.BID.VALIDITY_PERIOD, CRITERION.SELECTION.TECHNICAL_PROFESSIONAL_ABILITY.MANAGEMENT.SUBCONTRACTING_PROPORTION"
    }
  ]
}

For aboveThreshold, aboveThresholdEU you can’t update tender to status active.tendering without 10 EXCLUSION and OTHER required criteria:

Request

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

{
  "data": {
    "status": "active.tendering"
  }
}

Response

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

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Tender must contain all required criteria: CRITERION.EXCLUSION.BUSINESS.BANKRUPTCY, CRITERION.EXCLUSION.CONFLICT_OF_INTEREST.EARLY_TERMINATION, CRITERION.EXCLUSION.CONFLICT_OF_INTEREST.MISINTERPRETATION, CRITERION.EXCLUSION.CONVICTIONS.CHILD_LABOUR-HUMAN_TRAFFICKING, CRITERION.EXCLUSION.CONVICTIONS.CORRUPTION, CRITERION.EXCLUSION.CONVICTIONS.FRAUD, CRITERION.EXCLUSION.CONVICTIONS.PARTICIPATION_IN_CRIMINAL_ORGANISATION, CRITERION.EXCLUSION.CONVICTIONS.TERRORIST_OFFENCES, CRITERION.EXCLUSION.MISCONDUCT.MARKET_DISTORTION, CRITERION.EXCLUSION.NATIONAL.OTHER, CRITERION.OTHER.BID.LANGUAGE, CRITERION.OTHER.BID.VALIDITY_PERIOD, CRITERION.SELECTION.TECHNICAL_PROFESSIONAL_ABILITY.MANAGEMENT.SUBCONTRACTING_PROPORTION"
    }
  ]
}

EXCLUSION criteria and all criteria objects are unchangeable:

Request

PATCH /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Updated title"
  }
}

Response

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

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Can't update exclusion ecriteria objects"
    }
  ]
}

Request

POST /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d/requirement_groups?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "requirements": [
      {
        "dataType": "boolean",
        "eligibleEvidences": [
          {
            "title": "Документальне підтвердження",
            "description": "Довідка в довільній формі",
            "type": "document"
          }
        ],
        "expectedValue": true,
        "title": "Учасник процедури закупівлі протягом останніх трьох років не притягувався до відповідальності за порушення у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів торгів, аукціонів, конкурсів, тендерів"
      }
    ],
    "description": "Підтверджується, що"
  }
}

Response

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

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Can't update exclusion ecriteria objects"
    }
  ]
}

Request

PATCH /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d/requirement_groups/c3bd4e33d8f548db973c4a48df01a298?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "description": "Updated description"
  }
}

Response

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

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Can't update exclusion ecriteria objects"
    }
  ]
}

For tenders іn draft statuses you can post exclusion requirement:

Request

POST /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d/requirement_groups/c3bd4e33d8f548db973c4a48df01a298/requirements?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "dataType": "boolean",
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document"
      }
    ],
    "expectedValue": true,
    "title": "Another characteristic"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d/requirement_groups/c3bd4e33d8f548db973c4a48df01a298/requirements/16d7f233a6cb4503b6baf8273871732c

{
  "data": {
    "id": "16d7f233a6cb4503b6baf8273871732c",
    "title": "Another characteristic",
    "dataType": "boolean",
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document",
        "id": "cd1adfae4f234af7b62dc0992ce4028d"
      }
    ],
    "status": "active",
    "expectedValue": true,
    "datePublished": "2023-10-10T01:00:00+03:00"
  }
}

For tenders in draft statuses you can use PATCH method to update requirements for exclusion criteria:

Request

PATCH /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d/requirement_groups/c3bd4e33d8f548db973c4a48df01a298/requirements/bb11c06fbd5545ccb0284ff39aa2d6cc?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Updated title",
    "expectedValue": false,
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document"
      }
    ]
  }
}

Response

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

{
  "data": {
    "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
    "title": "Updated title",
    "dataType": "boolean",
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document",
        "id": "04cd6b2f592e423fb3e8ebca48d236e7"
      }
    ],
    "expectedValue": false,
    "datePublished": "2023-10-10T01:00:00+03:00",
    "status": "active"
  }
}

For tenders in non-draft statuses you can PUT exclusion requirement, but you can change only status and eligibleEvidences

Request

PUT /api/2.5/tenders/d62f91e236e14e5da1b00c2ff89b753b/criteria/2c882107c3df4accb409505309fc598d/requirement_groups/c3bd4e33d8f548db973c4a48df01a298/requirements/bb11c06fbd5545ccb0284ff39aa2d6cc?acc_token=b1a7c4a35e744a1c91a58030c417f5a8 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "eligibleEvidences": [
      {
        "title": "Документальне підтвердження",
        "description": "Довідка в довільній формі",
        "type": "document"
      }
    ]
  }
}

Response

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

{
  "data": [
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "title": "Updated title",
      "dataType": "boolean",
      "eligibleEvidences": [
        {
          "title": "Документальне підтвердження",
          "description": "Довідка в довільній формі",
          "type": "document",
          "id": "2da609e556044832b40ee0980665ddb5"
        }
      ],
      "expectedValue": false,
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "active"
    },
    {
      "id": "bb11c06fbd5545ccb0284ff39aa2d6cc",
      "datePublished": "2023-10-10T01:00:00+03:00",
      "status": "cancelled",
      "dateModified": "2023-10-10T01:00:00+03:00"
    }
  ]
}

Language criterion workflow

Language criterion creates as other and could be presented in bulk request with other criteria. Language should be specified in title

Request

POST /api/2.5/tenders/fb07ce223a754201a341023b86d832ef/criteria?acc_token=056f6edd10e84810b429550ae3a12f86 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1332
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": [
    {
        "title": "Мова (мови), якою (якими) повинні готуватися тендерні пропозиції",
        "source": "tenderer",
        "classification": {
            "scheme": " ESPD211",
            "id": "CRITERION.OTHER.BID.LANGUAGE"
        },
        "relatesTo": "tenderer",
        "legislation": [
            {
                "version": "2020-04-19",
                "identifier": {
                    "id": "922-VIII",
                    "legalName": "Закон України \"Про публічні закупівлі\"",
                    "uri": "https://zakon.rada.gov.ua/laws/show/922-19"
                },
                "type": "NATIONAL_LEGISLATION"
            }
        ],
        "requirementGroups": [
            {
                "description": "Учасник фізична особа підтверджує, що",
                "requirements": [
                    {
                        "title": "Мова тендерної пропозиції українська",
                        "dataType": "boolean",
                        "expectedValue": "true"
                    }
                ]
            }
        ]
    }
  ]
}

Response

HTTP/1.0 201 Created
Content-Type: application/json; charset=UTF-8

{
    "data": [
        {
            "requirementGroups": [
                {
                    "requirements": [
                        {
                            "dataType": "boolean",
                            "id": "5caf18cb9564436992d9c4d6a9a435de",
                            "expectedValue": "true",
                            "title": "Мова тендерної пропозиції українська"
                        }
                    ],
                    "id": "908f1976f2e24246b30b711c3fb12b32",
                    "description": "Учасник фізична особа підтверджує, що"
                }
            ],
            "classification": {
                "scheme": " GENERAL",
                "id": "CRITERION.OTHER.BID.LANGUAGE"
            },
            "title": "Мова (мови), якою (якими) повинні готуватися тендерні пропозиції",
            "relatesTo": "tenderer",
            "legislation": [
                {
                    "version": "2020-04-19",
                    "type": "NATIONAL_LEGISLATION",
                    "identifier": {
                        "uri": "https://zakon.rada.gov.ua/laws/show/922-19",
                        "id": "922-VIII",
                        "legalName": "Закон України \"Про публічні закупівлі\""
                    }
                }
            ],
            "source": "tenderer",
            "id": "1cbf6bce07ae4474856908846baa5b90"
        }
    ]
}

But field eligibleEvidences is forbidden

Request

PATCH /api/2.5/tenders/fb07ce223a754201a341023b86d832ef/criteria/1cbf6bce07ae4474856908846baa5b90?acc_token=056f6edd10e84810b429550ae3a12f86 HTTP/1.0
Authorization: Bearer broker
Content-Length: 40
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data":
    {
      "requirementGroups": [
        {
          "requirements": [
            {
              "dataType": "boolean",
              "expectedValue": "true",
              "title": "Мова тендерної пропозиції українська",
              "eligibleEvidences": [
                            {
                                "description": "Довідка в довільній формі",
                                "type": "document",
                                "title": "Документальне підтвердження"
                            }
                        ]
            }
          ],
          "description": "Учасник фізична особа підтверджує, що"
        }
      ],
      "classification": {
        "scheme": " GENERAL",
        "id": "CRITERION.OTHER.BID.LANGUAGE"
      },
      "title": "Мова (мови), якою (якими) повинні готуватися тендерні пропозиції",
      "relatesTo": "tenderer",
      "legislation": [
            {
                "version": "2020-04-19",
                "identifier": {
                    "id": "922-VIII",
                    "legalName": "Закон України \"Про публічні закупівлі\"",
                    "uri": "https://zakon.rada.gov.ua/laws/show/922-19"
                },
                "type": "NATIONAL_LEGISLATION"
            }
      ],
      "source": "tenderer"
    }
}

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json; charset=UTF-8

{
    "status": "error",
    "errors": [
        {
            "location": "body",
            "name": "requirementGroups",
            "description": [
                {
                    "requirements": [
                        {
                            "eligibleEvidences": [
                                "This field is forbidden for current criterion"
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

expectedValue must be only true

Request

PATCH /api/2.5/tenders/fb07ce223a754201a341023b86d832ef/criteria/1cbf6bce07ae4474856908846baa5b90?acc_token=056f6edd10e84810b429550ae3a12f86 HTTP/1.0
Authorization: Bearer broker
Content-Length: 40
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data":
    {
      "requirementGroups": [
        {
          "requirements": [
            {
              "dataType": "boolean",
              "expectedValue": "false",
              "title": "Мова тендерної пропозиції українська"
          ],
          "description": "Учасник фізична особа підтверджує, що"
        }
      ],
      "classification": {
        "scheme": " GENERAL",
        "id": "CRITERION.OTHER.BID.LANGUAGE"
      },
      "title": "Мова (мови), якою (якими) повинні готуватися тендерні пропозиції",
      "relatesTo": "tenderer",
      "legislation": [
            {
                "version": "2020-04-19",
                "identifier": {
                    "id": "922-VIII",
                    "legalName": "Закон України \"Про публічні закупівлі\"",
                    "uri": "https://zakon.rada.gov.ua/laws/show/922-19"
                },
                "type": "NATIONAL_LEGISLATION"
            }
      ],
      "source": "tenderer"
    }
}

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json; charset=UTF-8

{
    "status": "error",
    "errors": [
        {
            "location": "body",
            "name": "requirementGroups",
            "description": [
                {
                    "requirements": [
                        {
                            "expectedValue": [
                                "Value must be true"
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

Guarantee criteria workflow

Bid guarantee criterion available for tenders: belowThreshold, competitiveOrdering, aboveThreshold, aboveThresholdUA, aboveThresholdEU, esco, competitiveDialogueUA.stage2, competitiveDialogueEU.stage2, closeFrameworkAgreementUA, closeFrameworkAgreementSelectionUA, requestForProposal, simple.defense.

If specified, should be also specified guarantee for tender if criterion relatesTo = ‘tender’ or guarantee for lot if relatesTo = ‘lot’

Request

POST /api/2.5/tenders/fb07ce223a754201a341023b86d832ef/criteria?acc_token=056f6edd10e84810b429550ae3a12f86 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1332
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": [
    {
        "title": "Вид та умови надання забезпечення тендерних пропозицій",
        "source": "tenderer",
        "classification": {
            "scheme": "ESPD211",
            "id": "CRITERION.OTHER.BID.GUARANTEE"
        },
        "relatesTo": "tender",
        "legislation": [
            {
                "version": "2020-04-19",
                "identifier": {
                    "id": "922-VIII",
                    "legalName": "Закон України \"Про публічні закупівлі\"",
                    "uri": "https://zakon.rada.gov.ua/laws/show/922-19"
                },
                "type": "NATIONAL_LEGISLATION",
                "article": "21.2.9"
            }
    ],
           "requirementGroups": [
            {
                "description": "Учасник підтверджує, що",
                "requirements": [
                  {
                        "title": "вид та умови надання забезпечення тендерних пропозицій",
                        "description": "Умови забезпечення тендерної пропозиції: строк дії забезпечення тендерної пропозиції повинен бути протягом строку дії тендерної пропозиції, не менше ніж 90 днів з дати розкриття тендерних пропозицій електронною системою закупівель (відповідно до ст. 253 Цивільного кодексу України розраховується з наступного дня після розкриття тендерних пропозицій електронною системою закупівель), вид банківська гарантія",
                        "dataType": "boolean",
                        "expectedValue": "true",
                        "eligibleEvidences": [
                          {
                            "description": "Різнокольоровий скан у форматі pdf",
                            "type": "document",
                            "title": "Підтвердження банківської гарантії"
                          }
                          ]
                    }
                    ]

            }
        ]
    }
]

Response

HTTP/1.0 201 Created
Content-Type: application/json; charset=UTF-8

{
    "data": [
        {
            "id": "359bc0b02fa3422996d8e736e7f8357e",
            "title": "Вид та умови надання забезпечення тендерних пропозицій",
            "source": "tenderer",
            "relatesTo": "tender",
            "classification": {
                "scheme": "ESPD211",
                "id": "CRITERION.OTHER.BID.GUARANTEE"
            },
            "legislation": [
                {
                    "version": "2020-04-19",
                    "identifier": {
                        "id": "922-VIII",
                        "legalName": "Закон України \"Про публічні закупівлі\"",
                        "uri": "https://zakon.rada.gov.ua/laws/show/922-19"
                    },
                    "type": "NATIONAL_LEGISLATION",
                    "article": "21.2.9"
                }
            ],
            "requirementGroups": [
                {
                    "id": "ae218136516248078aca856334720f31",
                    "description": "Учасник підтверджує, що",
                    "requirements": [
                        {
                            "id": "a10274a2aa7a49a3863d028ca44773d0",
                            "title": "вид та умови надання забезпечення тендерних пропозицій",
                            "description": "Умови забезпечення тендерної пропозиції: строк дії забезпечення тендерної пропозиції повинен бути протягом строку дії тендерної пропозиції, не менше ніж 90 днів з дати розкриття тендерних пропозицій електронною системою закупівель (відповідно до ст. 253 Цивільного кодексу України розраховується з наступного дня після розкриття тендерних пропозицій електронною системою закупівель), вид банківська гарантія",
                            "dataType": "boolean",
                            "eligibleEvidences": [
                                {
                                    "id": "e1debf099224493f9dc4b8701dd993a8",
                                    "title": "Підтвердження банківської гарантії",
                                    "description": "Різнокольоровий скан у форматі pdf",
                                    "type": "document"
                                }
                            ],
                            "expectedValue": "true",
                            "status": "active",
                            "datePublished": "2021-03-14T21:59:25.725232+02:00"
                        }
                    ]
                }
            ]
        }
    ]
}

Contract guarantee criterion available for tenders: belowThreshold, competitiveOrdering, aboveThreshold, aboveThresholdUA, aboveThresholdEU, esco, competitiveDialogueUA, competitiveDialogueEU, competitiveDialogueUA.stage2, competitiveDialogueEU.stage2, priceQuotation, closeFrameworkAgreementSelectionUA, requestForProposal, simple.defense.

For current criterion could be set only source = ‘winner’. eligibleEvidences could be added according to Bidder Operations

Request

POST /api/2.5/tenders/fb07ce223a754201a341023b86d832ef/criteria?acc_token=056f6edd10e84810b429550ae3a12f86 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1332
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": [
    {
        "title": "Вид та умови надання забезпечення тендерних пропозицій",
        "source": "winner",
        "classification": {
            "scheme": "ESPD211",
            "id": "CRITERION.OTHER.CONTRACT.GUARANTEE"
        },
        "relatesTo": "tender",
        "legislation": [
            {
                "version": "2020-04-19",
                "identifier": {
                    "id": "922-VIII",
                    "legalName": "Закон України \"Про публічні закупівлі\"",
                    "uri": "https://zakon.rada.gov.ua/laws/show/922-19"
                },
                "type": "NATIONAL_LEGISLATION",
                "article": "21.2.9"
            }
    ],
           "requirementGroups": [
            {
                "description": "Учасник підтверджує, що",
                "requirements": [
                  {
                        "title": "вид та умови надання забезпечення тендерних пропозицій",
                        "description": "Умови забезпечення тендерної пропозиції: строк дії забезпечення тендерної пропозиції повинен бути протягом строку дії тендерної пропозиції, не менше ніж 90 днів з дати розкриття тендерних пропозицій електронною системою закупівель (відповідно до ст. 253 Цивільного кодексу України розраховується з наступного дня після розкриття тендерних пропозицій електронною системою закупівель), вид банківська гарантія",
                        "dataType": "boolean",
                        "expectedValue": "true",
                        "eligibleEvidences": [
                          {
                            "description": "Різнокольоровий скан у форматі pdf",
                            "type": "document",
                            "title": "Підтвердження банківської гарантії"
                          }
                          ]
                    }
                    ]

            }
        ]
    }
]

Response

HTTP/1.0 201 Created
Content-Type: application/json; charset=UTF-8

{
    "data": [
        {
            "id": "990fb5d782a943fe805bc8e40e632573",
            "title": "Вид та умови надання забезпечення тендерних пропозицій",
            "source": "winner",
            "relatesTo": "tender",
            "classification": {
                "scheme": "ESPD211",
                "id": "CRITERION.OTHER.CONTRACT.GUARANTEE"
            },
            "legislation": [
                {
                    "version": "2020-04-19",
                    "identifier": {
                        "id": "922-VIII",
                        "legalName": "Закон України \"Про публічні закупівлі\"",
                        "uri": "https://zakon.rada.gov.ua/laws/show/922-19"
                    },
                    "type": "NATIONAL_LEGISLATION",
                    "article": "21.2.9"
                }
            ],
            "requirementGroups": [
                {
                    "id": "acdda0a0eb054636b36930235f13335a",
                    "description": "Учасник підтверджує, що",
                    "requirements": [
                        {
                            "id": "781bb46e2e5840dfa954564a52e438fe",
                            "title": "вид та умови надання забезпечення тендерних пропозицій",
                            "description": "Умови забезпечення тендерної пропозиції: строк дії забезпечення тендерної пропозиції повинен бути протягом строку дії тендерної пропозиції, не менше ніж 90 днів з дати розкриття тендерних пропозицій електронною системою закупівель (відповідно до ст. 253 Цивільного кодексу України розраховується з наступного дня після розкриття тендерних пропозицій електронною системою закупівель), вид банківська гарантія",
                            "dataType": "boolean",
                            "eligibleEvidences": [
                                {
                                    "id": "5003840a832a4b489fe7782cfe5d76c2",
                                    "title": "Підтвердження банківської гарантії",
                                    "description": "Різнокольоровий скан у форматі pdf",
                                    "type": "document"
                                }
                            ],
                            "expectedValue": "true",
                            "status": "active",
                            "datePublished": "2021-03-14T22:31:17.206820+02:00"
                        }
                    ]
                }
            ]
        }
    ]
}

Exclusion criteria workflow

digraph G {
    rankdir = LR


    tender_draft [
        label = "draft*"
        shape = circle
        fixedsize = true
        width = .9
    ]

    tender_active_tendering [
        label = "active.\ntendering"
        shape = circle
        fixedsize = true
        width = .9
    ]

    bid_draft [
        label = "draft"
        shape = circle
        fixedsize = true
        width = .9
    ]

    bid_active [
        label = "active"
        shape = circle
        fixedsize = true
        width = .9
    ]

    tender_draft -> tender_active_tendering;
    bid_draft -> bid_active;
    bid_active -> create_bid_object;

    create_requirement_response_object [
        label = "Create requirement \nresponses"
        shape = rect
        style = filled
        fillcolor = plum
        fixedsize = true
        height = .5
        width = 2
    ]
    create_bid_object [
        label = "Create bid"
        shape = rect
        style = filled
        fillcolor = moccasin
        fixedsize = true
        height = .25
        width = 2
    ]
    create_criteria_object [
        label = "Create Criteria\n(11 Exclusion criteria \nare required for \nsome procedures)"
        shape = rect
        style = filled
        fillcolor = lightsalmon
        fixedsize = true
        height = 1
        width = 2
    ]
    add_eligible_evidences_object [
        label = "Can be added \neligible evidences"
        shape = rect
        style = filled
        fillcolor = moccasin
        fixedsize = true
        height = .5
        width = 2
    ]

    block_patch_requirement_response_object [
        label = "Can't add or \nupdate requirement \nresponses and evidence"
        shape = rect
        style = filled
        fillcolor = moccasin
        fixedsize = true
        height = .75
        width = 2
    ]

    subgraph cluster_tender {
        label = "Tender"

        subgraph cluster_draft {
            label = ""
            style = filled
            color = plum
            tender_draft
            create_criteria_object
        }
        subgraph cluster_active {
            label = ""
            style = filled
            color = pink
            tender_active_tendering
            create_bid_object
            add_eligible_evidences_object
        }
    }
    subgraph cluster_bid {
        label = "Bid"

        subgraph cluster_draft {
            label = ""
            style = filled
            color = moccasin
            bid_draft
            create_requirement_response_object
        }
        subgraph cluster_active {
            label = ""
            style = filled
            color = mediumaquamarine
            bid_active
            block_patch_requirement_response_object
        }
    }
}

Article 16 criteria

Article 16 criteria are required for the following procedures: aboveThreshold, aboveThresholdUA, aboveThresholdEU, competitiveDialogueUA, competitiveDialogueEU, esco, closeFrameworkAgreementUA.

Standard data, you could get here

You can’t update tender to status active.tendering without at least one of ARTICLE_16 criterion:

Request

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

{
  "data": {
    "status": "active.tendering"
  }
}

Response

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

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Tender must contain one of article 16 criteria: CRITERION.SELECTION.ECONOMIC_FINANCIAL_STANDING, CRITERION.SELECTION.TECHNICAL_PROFESSIONAL_ABILITY.REFERENCES.WORKS_PERFORMANCE, CRITERION.SELECTION.TECHNICAL_PROFESSIONAL_ABILITY.TECHNICAL.EQUIPMENT, CRITERION.SELECTION.TECHNICAL_PROFESSIONAL_ABILITY.TECHNICAL.STAFF_FOR_CARRYING_SCOPE"
    }
  ]
}

LCC criteria

Life cycle cost criteria could be added only for procedures which have awardCriteria field set to lifeCycleCost.

Let’s create procedure with another awardCriteria:

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": "футляри до державних нагород",
    "mainProcurementCategory": "goods",
    "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",
      "signerInfo": {
        "name": "Test Testovich",
        "telephone": "+380950000000",
        "email": "example@email.com",
        "iban": "111111111111111",
        "authorizedBy": "Статут компанії",
        "position": "Генеральний директор"
      }
    },
    "value": {
      "amount": 500,
      "currency": "UAH"
    },
    "items": [
      {
        "id": "ffffffffffffffffffffffffffffffff",
        "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
      }
    ],
    "enquiryPeriod": {
      "endDate": "2023-10-17T00:00:00+02:00"
    },
    "tenderPeriod": {
      "endDate": "2023-10-24T00:00:00+02:00"
    },
    "procurementMethodType": "belowThreshold",
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "code": "prepayment",
        "type": "financing",
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 1,
        "percentage": 45.55
      },
      {
        "title": "deliveryOfGoods",
        "code": "postpayment",
        "type": "financing",
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 2,
        "percentage": 54.45
      }
    ],
    "contractTemplateName": "00000000.0002.01"
  },
  "config": {
    "hasAuction": true,
    "hasAwardingOrder": true,
    "hasValueRestriction": true,
    "valueCurrencyEquality": true,
    "hasPrequalification": false,
    "minBidsNumber": 1,
    "hasPreSelectionAgreement": false,
    "hasTenderComplaints": false,
    "hasAwardComplaints": false,
    "hasCancellationComplaints": false,
    "hasValueEstimation": true,
    "hasQualificationComplaints": false,
    "tenderComplainRegulation": 0,
    "qualificationComplainDuration": 0,
    "awardComplainDuration": 2,
    "cancellationComplainDuration": 0,
    "clarificationUntilDuration": 1,
    "qualificationDuration": 0,
    "minTenderingDuration": 2,
    "hasEnquiries": true,
    "minEnquiriesDuration": 3,
    "enquiryPeriodRegulation": 0,
    "restricted": false
  }
}

Response

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

{
  "data": {
    "mainProcurementCategory": "goods",
    "contractTemplateName": "00000000.0002.01",
    "title": "футляри до державних нагород",
    "status": "draft",
    "awardCriteria": "lowestCost",
    "procuringEntity": {
      "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"
      },
      "kind": "general",
      "signerInfo": {
        "name": "Test Testovich",
        "email": "example@email.com",
        "telephone": "+380950000000",
        "iban": "111111111111111",
        "position": "Генеральний директор",
        "authorizedBy": "Статут компанії"
      }
    },
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "tenderPeriod": {
      "startDate": "2023-10-17T00:00:00+02:00",
      "endDate": "2023-10-24T00:00:00+02:00"
    },
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "type": "financing",
        "code": "prepayment",
        "percentage": 45.55,
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 1
      },
      {
        "id": "c0d67bca7f484cf7ae0e55431ae363cc",
        "title": "deliveryOfGoods",
        "type": "financing",
        "code": "postpayment",
        "percentage": 54.45,
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 2
      }
    ],
    "procurementMethodType": "belowThreshold",
    "enquiryPeriod": {
      "endDate": "2023-10-17T00:00:00+02:00",
      "startDate": "2023-10-10T01:00:00+03:00",
      "clarificationsUntil": "2023-10-19T00:00:00+03:00"
    },
    "items": [
      {
        "id": "ffffffffffffffffffffffffffffffff",
        "description": "футляри до державних нагород",
        "description_en": "Cases with state awards",
        "description_ru": "футляры к государственным наградам",
        "unit": {
          "name": "кілограм",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "quantity": 5.0,
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ]
      }
    ],
    "tenderID": "UA-2023-10-10-000001-a",
    "owner": "broker",
    "procurementMethod": "open",
    "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": "ec07ab81d47743c5a77a27b71d0da2ea"
  },
  "config": {
    "hasAuction": true,
    "hasAwardingOrder": true,
    "hasValueRestriction": true,
    "valueCurrencyEquality": true,
    "hasPrequalification": false,
    "minBidsNumber": 1,
    "hasPreSelectionAgreement": false,
    "hasTenderComplaints": false,
    "hasAwardComplaints": false,
    "hasCancellationComplaints": false,
    "hasValueEstimation": true,
    "hasQualificationComplaints": false,
    "tenderComplainRegulation": 0,
    "qualificationComplainDuration": 0,
    "awardComplainDuration": 2,
    "cancellationComplainDuration": 0,
    "clarificationUntilDuration": 1,
    "qualificationDuration": 0,
    "minTenderingDuration": 2,
    "hasEnquiries": true,
    "minEnquiriesDuration": 3,
    "enquiryPeriodRegulation": 0,
    "restricted": false
  },
  "access": {
    "token": "1f5c55b7a92a4e8f99595ef1a6c7c917",
    "transfer": "f00b5e12b7c846f7a186cbd942115ab1"
  }
}

Then let’s try to add criteria LCC, we see an error:

Request

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

{
  "data": [
    {
      "title": "Витрати, пов’язані з користуванням, грн.",
      "description": "Для розрахунку витрат, пов’язаних з користуванням, замовник визначає в тендерній документації одиницю виміру життєвого циклу та зазначає вартість споживання електроенергії та інших ресурсів (наприклад, поточні ціни на бензин або дані від Національної комісії, що здійснює державне регулювання у сферах енергетики та комунальних послуг, щодо вартості електроенергії тощо)",
      "source": "tenderer",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.COST_OF_USE"
      },
      "relatesTo": "tender",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.6"
        }
      ],
      "requirementGroups": [
        {
          "description": "Підтверджується, що",
          "requirements": [
            {
              "title": "Витрати в частині споживання ресурсу під час користування протягом визначеного замовником періоду оцінки життєвого циклу",
              "dataType": "number",
              "minValue": 0.0,
              "unit": {
                "code": "E50",
                "name": "одиниця"
              }
            }
          ]
        }
      ]
    },
    {
      "title": "Витрати, пов’язані з обслуговуванням, грн.",
      "description": "Для розрахунку витрат, пов’язаних з обслуговуванням, замовник у тендерній документації серед переліку інформації, що надає учасник, може запитати інформацію щодо вартості обслуговування, ремонту та/або заміни складових предмета закупівлі за одиницю виміру життєвого циклу, а також документи від виробника про характеристики предмета закупівлі",
      "source": "tenderer",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.MAINTENANCE_COST"
      },
      "relatesTo": "tender",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.7"
        }
      ],
      "requirementGroups": [
        {
          "description": "Підтверджується, що",
          "requirements": [
            {
              "title": "Витрати пов’язані з обслуговуванням протягом визначеного замовником періоду оцінки життєвого циклу",
              "dataType": "number",
              "minValue": 0.0,
              "unit": {
                "code": "E50",
                "name": "одиниця"
              }
            }
          ]
        }
      ]
    },
    {
      "title": "Витрати, пов’язані з завершенням користування, грн.",
      "description": "Для розрахунку витрат, пов’язаних з завершенням користування, замовник у тендерній документації серед переліку інформації, що надає учасник процедури закупівлі, може запитати інформацію щодо вартості демонтажу, утилізації, переробки та інших витрат",
      "source": "tenderer",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.END_OF_LIFE_COST"
      },
      "relatesTo": "tender",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.8"
        }
      ],
      "requirementGroups": [
        {
          "description": "Підтверджується, щ",
          "requirements": [
            {
              "title": "Витрати пов’язані з завершенням користування",
              "dataType": "number",
              "minValue": 0.0,
              "unit": {
                "code": "E50",
                "name": "одиниця"
              }
            }
          ]
        }
      ]
    },
    {
      "title": "Витрати, пов’язані з захистом навколишнього середовища, грн.",
      "description": "Замовник додатково для розрахунку вартості життєвого циклу може використовувати параметри витрат, пов’язаних із захистом навколишнього природного середовища (вартість екологічних витрат)",
      "source": "tenderer",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.ECOLOGICAL_COST"
      },
      "relatesTo": "tender",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.9"
        }
      ],
      "requirementGroups": [
        {
          "description": "Підтверджується, що",
          "requirements": [
            {
              "title": "Витрати, пов’язані з захистом навколишнього середовища протягом визначеного замовником періоду оцінки життєвого циклу",
              "dataType": "number",
              "minValue": 0.0,
              "unit": {
                "code": "E50",
                "name": "одиниця"
              }
            }
          ]
        }
      ]
    }
  ]
}

Response

HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "classification",
      "description": {
        "id": [
          "CRITERION.OTHER.LIFE_CYCLE_COST.COST_OF_USE is available only with lifeCycleCost awardCriteria"
        ]
      }
    }
  ]
}

Let’s create procedure with awardCriteria set to lifeCycleCost:

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": "футляри до державних нагород",
    "mainProcurementCategory": "goods",
    "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",
      "signerInfo": {
        "name": "Test Testovich",
        "telephone": "+380950000000",
        "email": "example@email.com",
        "iban": "111111111111111",
        "authorizedBy": "Статут компанії",
        "position": "Генеральний директор"
      }
    },
    "value": {
      "amount": 500,
      "currency": "UAH"
    },
    "items": [
      {
        "id": "ffffffffffffffffffffffffffffffff",
        "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
      }
    ],
    "enquiryPeriod": {
      "endDate": "2023-10-17T00:00:00+02:00"
    },
    "tenderPeriod": {
      "endDate": "2023-10-24T00:00:00+02:00"
    },
    "procurementMethodType": "belowThreshold",
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "code": "prepayment",
        "type": "financing",
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 1,
        "percentage": 45.55
      },
      {
        "title": "deliveryOfGoods",
        "code": "postpayment",
        "type": "financing",
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 2,
        "percentage": 54.45
      }
    ],
    "contractTemplateName": "00000000.0002.01",
    "awardCriteria": "lifeCycleCost"
  },
  "config": {
    "hasAuction": true,
    "hasAwardingOrder": true,
    "hasValueRestriction": true,
    "valueCurrencyEquality": true,
    "hasPrequalification": false,
    "minBidsNumber": 1,
    "hasPreSelectionAgreement": false,
    "hasTenderComplaints": false,
    "hasAwardComplaints": false,
    "hasCancellationComplaints": false,
    "hasValueEstimation": true,
    "hasQualificationComplaints": false,
    "tenderComplainRegulation": 0,
    "qualificationComplainDuration": 0,
    "awardComplainDuration": 2,
    "cancellationComplainDuration": 0,
    "clarificationUntilDuration": 1,
    "qualificationDuration": 0,
    "minTenderingDuration": 2,
    "hasEnquiries": true,
    "minEnquiriesDuration": 3,
    "enquiryPeriodRegulation": 0,
    "restricted": false
  }
}

Response

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

{
  "data": {
    "mainProcurementCategory": "goods",
    "contractTemplateName": "00000000.0002.01",
    "title": "футляри до державних нагород",
    "status": "draft",
    "awardCriteria": "lifeCycleCost",
    "procuringEntity": {
      "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"
      },
      "kind": "general",
      "signerInfo": {
        "name": "Test Testovich",
        "email": "example@email.com",
        "telephone": "+380950000000",
        "iban": "111111111111111",
        "position": "Генеральний директор",
        "authorizedBy": "Статут компанії"
      }
    },
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "tenderPeriod": {
      "startDate": "2023-10-17T00:00:00+02:00",
      "endDate": "2023-10-24T00:00:00+02:00"
    },
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "type": "financing",
        "code": "prepayment",
        "percentage": 45.55,
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 1
      },
      {
        "id": "be94921f83ff46f69f542687d749e4f4",
        "title": "deliveryOfGoods",
        "type": "financing",
        "code": "postpayment",
        "percentage": 54.45,
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 2
      }
    ],
    "procurementMethodType": "belowThreshold",
    "enquiryPeriod": {
      "endDate": "2023-10-17T00:00:00+02:00",
      "startDate": "2023-10-10T01:00:00+03:00",
      "clarificationsUntil": "2023-10-19T00:00:00+03:00"
    },
    "items": [
      {
        "id": "ffffffffffffffffffffffffffffffff",
        "description": "футляри до державних нагород",
        "description_en": "Cases with state awards",
        "description_ru": "футляры к государственным наградам",
        "unit": {
          "name": "кілограм",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "quantity": 5.0,
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ]
      }
    ],
    "tenderID": "UA-2023-10-10-000002-a",
    "owner": "broker",
    "procurementMethod": "open",
    "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": "48a630eb6f984c7c9794032a4463cdc8"
  },
  "config": {
    "hasAuction": true,
    "hasAwardingOrder": true,
    "hasValueRestriction": true,
    "valueCurrencyEquality": true,
    "hasPrequalification": false,
    "minBidsNumber": 1,
    "hasPreSelectionAgreement": false,
    "hasTenderComplaints": false,
    "hasAwardComplaints": false,
    "hasCancellationComplaints": false,
    "hasValueEstimation": true,
    "hasQualificationComplaints": false,
    "tenderComplainRegulation": 0,
    "qualificationComplainDuration": 0,
    "awardComplainDuration": 2,
    "cancellationComplainDuration": 0,
    "clarificationUntilDuration": 1,
    "qualificationDuration": 0,
    "minTenderingDuration": 2,
    "hasEnquiries": true,
    "minEnquiriesDuration": 3,
    "enquiryPeriodRegulation": 0,
    "restricted": false
  },
  "access": {
    "token": "2999cb49e38042e58fdfc860f4161ddf",
    "transfer": "e2b79b791d2e469a9608c9fee1afe863"
  }
}

Successfully adding criteria LCC:

Request

POST /api/2.5/tenders/48a630eb6f984c7c9794032a4463cdc8/criteria?acc_token=2999cb49e38042e58fdfc860f4161ddf HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": [
    {
      "title": "Витрати, пов’язані з користуванням, грн.",
      "description": "Для розрахунку витрат, пов’язаних з користуванням, замовник визначає в тендерній документації одиницю виміру життєвого циклу та зазначає вартість споживання електроенергії та інших ресурсів (наприклад, поточні ціни на бензин або дані від Національної комісії, що здійснює державне регулювання у сферах енергетики та комунальних послуг, щодо вартості електроенергії тощо)",
      "source": "tenderer",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.COST_OF_USE"
      },
      "relatesTo": "tender",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.6"
        }
      ],
      "requirementGroups": [
        {
          "description": "Підтверджується, що",
          "requirements": [
            {
              "title": "Витрати в частині споживання ресурсу під час користування протягом визначеного замовником періоду оцінки життєвого циклу",
              "dataType": "number",
              "minValue": 0.0,
              "unit": {
                "code": "E50",
                "name": "одиниця"
              }
            }
          ]
        }
      ]
    },
    {
      "title": "Витрати, пов’язані з обслуговуванням, грн.",
      "description": "Для розрахунку витрат, пов’язаних з обслуговуванням, замовник у тендерній документації серед переліку інформації, що надає учасник, може запитати інформацію щодо вартості обслуговування, ремонту та/або заміни складових предмета закупівлі за одиницю виміру життєвого циклу, а також документи від виробника про характеристики предмета закупівлі",
      "source": "tenderer",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.MAINTENANCE_COST"
      },
      "relatesTo": "tender",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.7"
        }
      ],
      "requirementGroups": [
        {
          "description": "Підтверджується, що",
          "requirements": [
            {
              "title": "Витрати пов’язані з обслуговуванням протягом визначеного замовником періоду оцінки життєвого циклу",
              "dataType": "number",
              "minValue": 0.0,
              "unit": {
                "code": "E50",
                "name": "одиниця"
              }
            }
          ]
        }
      ]
    },
    {
      "title": "Витрати, пов’язані з завершенням користування, грн.",
      "description": "Для розрахунку витрат, пов’язаних з завершенням користування, замовник у тендерній документації серед переліку інформації, що надає учасник процедури закупівлі, може запитати інформацію щодо вартості демонтажу, утилізації, переробки та інших витрат",
      "source": "tenderer",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.END_OF_LIFE_COST"
      },
      "relatesTo": "tender",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.8"
        }
      ],
      "requirementGroups": [
        {
          "description": "Підтверджується, щ",
          "requirements": [
            {
              "title": "Витрати пов’язані з завершенням користування",
              "dataType": "number",
              "minValue": 0.0,
              "unit": {
                "code": "E50",
                "name": "одиниця"
              }
            }
          ]
        }
      ]
    },
    {
      "title": "Витрати, пов’язані з захистом навколишнього середовища, грн.",
      "description": "Замовник додатково для розрахунку вартості життєвого циклу може використовувати параметри витрат, пов’язаних із захистом навколишнього природного середовища (вартість екологічних витрат)",
      "source": "tenderer",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.ECOLOGICAL_COST"
      },
      "relatesTo": "tender",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.9"
        }
      ],
      "requirementGroups": [
        {
          "description": "Підтверджується, що",
          "requirements": [
            {
              "title": "Витрати, пов’язані з захистом навколишнього середовища протягом визначеного замовником періоду оцінки життєвого циклу",
              "dataType": "number",
              "minValue": 0.0,
              "unit": {
                "code": "E50",
                "name": "одиниця"
              }
            }
          ]
        }
      ]
    }
  ]
}

Response

HTTP/1.0 201 Created
Content-Type: application/json

{
  "data": [
    {
      "id": "dc16e0c0a1d44ad792dc8fde4dd1b0d2",
      "description": "Для розрахунку витрат, пов’язаних з користуванням, замовник визначає в тендерній документації одиницю виміру життєвого циклу та зазначає вартість споживання електроенергії та інших ресурсів (наприклад, поточні ціни на бензин або дані від Національної комісії, що здійснює державне регулювання у сферах енергетики та комунальних послуг, щодо вартості електроенергії тощо)",
      "source": "tenderer",
      "relatesTo": "tender",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.COST_OF_USE"
      },
      "title": "Витрати, пов’язані з користуванням, грн.",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.6"
        }
      ],
      "requirementGroups": [
        {
          "id": "febe682636064d84a8b646329b377b43",
          "description": "Підтверджується, що",
          "requirements": [
            {
              "id": "3164c4f433af4ae4be72c0feeb112565",
              "title": "Витрати в частині споживання ресурсу під час користування протягом визначеного замовником періоду оцінки життєвого циклу",
              "dataType": "number",
              "status": "active",
              "unit": {
                "code": "E50",
                "name": "одиниця"
              },
              "minValue": 0.0,
              "datePublished": "2023-10-10T01:00:00+03:00"
            }
          ]
        }
      ]
    },
    {
      "id": "b74e1eebfee9458eac916c215278dc33",
      "description": "Для розрахунку витрат, пов’язаних з обслуговуванням, замовник у тендерній документації серед переліку інформації, що надає учасник, може запитати інформацію щодо вартості обслуговування, ремонту та/або заміни складових предмета закупівлі за одиницю виміру життєвого циклу, а також документи від виробника про характеристики предмета закупівлі",
      "source": "tenderer",
      "relatesTo": "tender",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.MAINTENANCE_COST"
      },
      "title": "Витрати, пов’язані з обслуговуванням, грн.",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.7"
        }
      ],
      "requirementGroups": [
        {
          "id": "045e3944e04a4f34a2ceac5232c947c0",
          "description": "Підтверджується, що",
          "requirements": [
            {
              "id": "5be77099a6954c78b9b96cbb96059dc5",
              "title": "Витрати пов’язані з обслуговуванням протягом визначеного замовником періоду оцінки життєвого циклу",
              "dataType": "number",
              "status": "active",
              "unit": {
                "code": "E50",
                "name": "одиниця"
              },
              "minValue": 0.0,
              "datePublished": "2023-10-10T01:00:00+03:00"
            }
          ]
        }
      ]
    },
    {
      "id": "da230434b7a746e885a5edb8066d6a3e",
      "description": "Для розрахунку витрат, пов’язаних з завершенням користування, замовник у тендерній документації серед переліку інформації, що надає учасник процедури закупівлі, може запитати інформацію щодо вартості демонтажу, утилізації, переробки та інших витрат",
      "source": "tenderer",
      "relatesTo": "tender",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.END_OF_LIFE_COST"
      },
      "title": "Витрати, пов’язані з завершенням користування, грн.",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.8"
        }
      ],
      "requirementGroups": [
        {
          "id": "89b5d2bbbff74bc883f8a987c445f64f",
          "description": "Підтверджується, щ",
          "requirements": [
            {
              "id": "b24eb9b74fe640849061ff1451091422",
              "title": "Витрати пов’язані з завершенням користування",
              "dataType": "number",
              "status": "active",
              "unit": {
                "code": "E50",
                "name": "одиниця"
              },
              "minValue": 0.0,
              "datePublished": "2023-10-10T01:00:00+03:00"
            }
          ]
        }
      ]
    },
    {
      "id": "4efc49d16e694ffdadd4642202170628",
      "description": "Замовник додатково для розрахунку вартості життєвого циклу може використовувати параметри витрат, пов’язаних із захистом навколишнього природного середовища (вартість екологічних витрат)",
      "source": "tenderer",
      "relatesTo": "tender",
      "classification": {
        "scheme": "LCC",
        "id": "CRITERION.OTHER.LIFE_CYCLE_COST.ECOLOGICAL_COST"
      },
      "title": "Витрати, пов’язані з захистом навколишнього середовища, грн.",
      "legislation": [
        {
          "version": "2020-09-28",
          "identifier": {
            "id": "1894",
            "legalName": "Наказ Мінекономіки \"Про затвердження Примірної методики визначення вартості життєвого циклу\"",
            "uri": "https://me.gov.ua/legislativeacts/Detail?lang=uk-UA&id=32140d03-d5eb-4988-8790-6d60d1c84a93"
          },
          "type": "NATIONAL_LEGISLATION",
          "article": "2.9"
        }
      ],
      "requirementGroups": [
        {
          "id": "6e773cdbfe614f47a69edcc5cd2cc48f",
          "description": "Підтверджується, що",
          "requirements": [
            {
              "id": "9cf11dcd179c422b803464943b96708b",
              "title": "Витрати, пов’язані з захистом навколишнього середовища протягом визначеного замовником періоду оцінки життєвого циклу",
              "dataType": "number",
              "status": "active",
              "unit": {
                "code": "E50",
                "name": "одиниця"
              },
              "minValue": 0.0,
              "datePublished": "2023-10-10T01:00:00+03:00"
            }
          ]
        }
      ]
    }
  ]
}