hasValueRestriction

Field hasValueRestriction is a boolean field that indicates whether the bid value can exceed tender/lot initial value of the subject of procurement, specified in the announcement.

Possible values for hasValueRestriction field depends on procurementMethodType field:

procurementMethodType	values	default
aboveThreshold	true / false	true
competitiveOrdering	true / false	false
competitiveOrdering.short	true / false	false
competitiveOrdering.long	true / false	false
aboveThresholdEU	true	true
aboveThresholdUA.defense	true	true
aboveThresholdUA	true	true
belowThreshold	true / false	true
closeFrameworkAgreementSelectionUA	true	true
closeFrameworkAgreementUA	true	true
competitiveDialogueEU	true	true
competitiveDialogueEU.stage2	true	true
competitiveDialogueUA	true	true
competitiveDialogueUA.stage2	true	true
esco	true	true
negotiation	true	true
negotiation.quick	true	true
priceQuotation	true	true
reporting	true	true
simple.defense	true	true
requestForProposal	true / false	false

hasValueRestriction is true

hasValueRestriction:true means that bid value can not exceed initial value of the subject of procurement.

Let’s create a tender with lots with hasValueRestriction set to true:

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": [
      {
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "description": "Послуги шкільних їдалень",
        "deliveryDate": {
          "startDate": "2023-10-30T00:00:00+02:00",
          "endDate": "2023-11-29T00:00:00+02:00"
        },
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "locality": "м. Київ",
          "streetAddress": "вул. Банкова 1"
        },
        "classification": {
          "description": "Послуги з харчування у школах",
          "id": "55523100-3",
          "scheme": "ДК021"
        },
        "unit": {
          "code": "KGM",
          "name": "папір",
          "value": {
            "amount": 10
          }
        },
        "quantity": 1,
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6"
      },
      {
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "description": "Послуги шкільних їдалень",
        "description_en": "Services in school canteens",
        "classification": {
          "description": "Послуги з харчування у школах",
          "id": "55523100-3",
          "scheme": "ДК021"
        },
        "deliveryDate": {
          "startDate": "2023-10-30T00:00:00+02:00",
          "endDate": "2023-11-29T00:00:00+02:00"
        },
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "locality": "м. Київ",
          "streetAddress": "вул. Банкова 1"
        },
        "unit": {
          "code": "KGM",
          "name": "кілограм",
          "value": {
            "amount": 6
          }
        },
        "quantity": 1,
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6"
      }
    ],
    "enquiryPeriod": {
      "endDate": "2023-10-17T00:00:00+02:00"
    },
    "tenderPeriod": {
      "endDate": "2023-10-24T00:00:00+02:00"
    },
    "procurementMethodType": "requestForProposal",
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "code": "prepayment",
        "type": "financing",
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 1,
        "percentage": 45.55,
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6"
      },
      {
        "title": "deliveryOfGoods",
        "code": "postpayment",
        "type": "financing",
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 2,
        "percentage": 54.45,
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6"
      }
    ],
    "contractTemplateName": "00000000.0002.01",
    "lots": [
      {
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "value": {
          "amount": 500,
          "currency": "UAH"
        },
        "minimalStep": {
          "amount": 5,
          "currency": "UAH"
        },
        "id": "d7afc0eb4f6d42549557d7b3226417e6"
      },
      {
        "title": "Лот №2",
        "description": "Опис Лот №2",
        "value": {
          "amount": 500,
          "currency": "UAH"
        },
        "minimalStep": {
          "amount": 5,
          "currency": "UAH"
        },
        "id": "6670a4933d854a00afa53a2979728a6d"
      }
    ]
  },
  "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": 4,
    "qualificationDuration": 20,
    "minTenderingDuration": 4,
    "hasEnquiries": true,
    "minEnquiriesDuration": 3,
    "enquiryPeriodRegulation": 3,
    "restricted": false
  }
}

Response

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

{
  "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",
      "valueAddedTaxIncluded": true,
      "amount": 1000.0
    },
    "tenderPeriod": {
      "startDate": "2023-10-17T00:00:00+02:00",
      "endDate": "2023-10-24T00:00:00+02:00"
    },
    "lots": [
      {
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "d7afc0eb4f6d42549557d7b3226417e6",
        "status": "active",
        "value": {
          "currency": "UAH",
          "amount": 500.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStep": {
          "currency": "UAH",
          "amount": 5.0,
          "valueAddedTaxIncluded": true
        },
        "date": "2023-10-10T01:00:00+03:00"
      },
      {
        "title": "Лот №2",
        "description": "Опис Лот №2",
        "id": "6670a4933d854a00afa53a2979728a6d",
        "status": "active",
        "value": {
          "currency": "UAH",
          "amount": 500.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStep": {
          "currency": "UAH",
          "amount": 5.0,
          "valueAddedTaxIncluded": true
        },
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "type": "financing",
        "code": "prepayment",
        "percentage": 45.55,
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 1,
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6"
      },
      {
        "id": "ad63536cbc0d4fd8b7c49031d56cd337",
        "title": "deliveryOfGoods",
        "type": "financing",
        "code": "postpayment",
        "percentage": 54.45,
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 2,
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6"
      }
    ],
    "procurementMethodType": "requestForProposal",
    "enquiryPeriod": {
      "endDate": "2023-10-17T00:00:00+02:00",
      "startDate": "2023-10-10T01:00:00+03:00",
      "clarificationsUntil": "2023-10-22T00:00:00+03:00"
    },
    "items": [
      {
        "id": "c5b0023de71046108dde1a721e00de87",
        "description": "Послуги шкільних їдалень",
        "unit": {
          "name": "папір",
          "value": {
            "amount": 10.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "quantity": 1.0,
        "classification": {
          "description": "Послуги з харчування у школах",
          "scheme": "ДК021",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryDate": {
          "startDate": "2023-10-30T00:00:00+02:00",
          "endDate": "2023-11-29T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6"
      },
      {
        "id": "5cacba5cf95a40b580cedfb21df309ba",
        "description": "Послуги шкільних їдалень",
        "description_en": "Services in school canteens",
        "unit": {
          "name": "кілограм",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          },
          "code": "KGM"
        },
        "quantity": 1.0,
        "classification": {
          "description": "Послуги з харчування у школах",
          "scheme": "ДК021",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryDate": {
          "startDate": "2023-10-30T00:00:00+02:00",
          "endDate": "2023-11-29T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6"
      }
    ],
    "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": "38bca89f7ba4477d97f553d576fd6994"
  },
  "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": 4,
    "qualificationDuration": 20,
    "minTenderingDuration": 4,
    "hasEnquiries": true,
    "minEnquiriesDuration": 3,
    "enquiryPeriodRegulation": 3,
    "restricted": false
  },
  "access": {
    "token": "339cb54465f04f18918ea43e3d45e961",
    "transfer": "5039a828dd514605a834f8325460d027"
  }
}

And add bid to it with value more than initially announced in lot:

Request

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

{
  "data": {
    "status": "draft",
    "tenderers": [
      {
        "address": {
          "countryName": "Україна",
          "locality": "м. Вінниця",
          "postalCode": "21100",
          "region": "Вінницька область",
          "streetAddress": "вул. Островського, 33"
        },
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "name": "Сергій Олексюк",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "scale": "micro",
        "signerInfo": {
          "name": "Test Testovich",
          "telephone": "+380950000000",
          "email": "example@email.com",
          "iban": "111111111111111",
          "authorizedBy": "Статут компанії",
          "position": "Генеральний директор"
        }
      }
    ],
    "lotValues": [
      {
        "value": {
          "amount": 600
        },
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6"
      },
      {
        "value": {
          "amount": 500
        },
        "relatedLot": "6670a4933d854a00afa53a2979728a6d"
      }
    ]
  }
}

Response

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

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "lotValues",
      "description": [
        {
          "value": [
            "value of bid should be less than value of lot"
          ]
        }
      ]
    }
  ]
}

In that case we will have error, that adding bid with exceeded value is forbidden.

Let’s add bid to tender with value less than initially announced in lot:

Request

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

{
  "data": {
    "status": "draft",
    "tenderers": [
      {
        "address": {
          "countryName": "Україна",
          "locality": "м. Вінниця",
          "postalCode": "21100",
          "region": "Вінницька область",
          "streetAddress": "вул. Островського, 33"
        },
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "name": "Сергій Олексюк",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "scale": "micro",
        "signerInfo": {
          "name": "Test Testovich",
          "telephone": "+380950000000",
          "email": "example@email.com",
          "iban": "111111111111111",
          "authorizedBy": "Статут компанії",
          "position": "Генеральний директор"
        }
      }
    ],
    "lotValues": [
      {
        "value": {
          "amount": 500
        },
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6"
      },
      {
        "value": {
          "amount": 500
        },
        "relatedLot": "6670a4933d854a00afa53a2979728a6d"
      }
    ]
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/38bca89f7ba4477d97f553d576fd6994/bids/4b2f22ec008b4f4e88f2f69ea174242c

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "scale": "micro",
        "signerInfo": {
          "name": "Test Testovich",
          "email": "example@email.com",
          "telephone": "+380950000000",
          "iban": "111111111111111",
          "position": "Генеральний директор",
          "authorizedBy": "Статут компанії"
        }
      }
    ],
    "lotValues": [
      {
        "status": "pending",
        "value": {
          "amount": 500.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6",
        "date": "2023-10-10T01:00:00+03:00"
      },
      {
        "status": "pending",
        "value": {
          "amount": 500.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "6670a4933d854a00afa53a2979728a6d",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "status": "draft",
    "id": "4b2f22ec008b4f4e88f2f69ea174242c",
    "date": "2023-10-10T01:00:00+03:00"
  },
  "access": {
    "token": "87879070e6fc47e98110621d6eed0956",
    "transfer": "5f83267d6cf04d448ecb9716d7f443a4"
  }
}

Let’s try to patch bid value to bigger one and we will see error, that it is forbidden with this configuration.

Request

PATCH /api/2.5/tenders/38bca89f7ba4477d97f553d576fd6994/bids/4b2f22ec008b4f4e88f2f69ea174242c?acc_token=87879070e6fc47e98110621d6eed0956 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active",
    "tenderers": [
      {
        "address": {
          "countryName": "Україна",
          "locality": "м. Вінниця",
          "postalCode": "21100",
          "region": "Вінницька область",
          "streetAddress": "вул. Островського, 33"
        },
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "name": "Сергій Олексюк",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "scale": "micro",
        "signerInfo": {
          "name": "Test Testovich",
          "telephone": "+380950000000",
          "email": "example@email.com",
          "iban": "111111111111111",
          "authorizedBy": "Статут компанії",
          "position": "Генеральний директор"
        }
      }
    ],
    "lotValues": [
      {
        "status": "pending",
        "value": {
          "amount": 500
        },
        "relatedLot": "d7afc0eb4f6d42549557d7b3226417e6",
        "date": "2023-10-10T01:00:00+03:00"
      },
      {
        "status": "pending",
        "value": {
          "amount": 700
        },
        "relatedLot": "6670a4933d854a00afa53a2979728a6d",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ]
  }
}

Response

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

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "lotValues",
      "description": [
        {
          "value": [
            "value of bid should be less than value of lot"
          ]
        }
      ]
    }
  ]
}