hasItems
Field hasItems is the boolean field that defines if the framework should have items.
Possible values for hasItems field depends on frameworkType field:
frameworkType |
values |
default |
|---|---|---|
dynamicPurchasingSystem |
true,false |
false |
electronicCatalogue |
false |
false |
internationalFinancialInstitutions |
true,false |
false |
hasItems is false
hasItems:false means that items is not allowed for framework.
Let’s create a framework with hasItems set to false with items:
POST /api/2.5/frameworks HTTP/1.0
Authorization: Bearer brokerr
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"name": "Державне управління справами"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2028-02-05T00:00:00+02:00"
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 5,
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
}
}
]
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "items",
"description": "Items are not allowed for framework with hasItems set to false"
}
]
}
We can see error that indicates that items are not allowed for framework with hasItems set to false.
Now let’s create a framework with hasItems set to false without items:
POST /api/2.5/frameworks HTTP/1.0
Authorization: Bearer brokerr
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"name": "Державне управління справами"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2028-02-05T00:00:00+02:00"
}
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/fcd268abac2544a3a34d666a06ffe66b
{
"data": {
"status": "draft",
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2028-02-05T00:00:00+02:00"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "general"
},
"prettyID": "UA-F-2027-01-01-000002",
"owner": "brokerr",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "fcd268abac2544a3a34d666a06ffe66b"
},
"access": {
"token": "7ef83e3c4a0b427ebdb7d52f346b4445",
"transfer": "5a7e636846834903ad61b6594de5e6b5"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
And then activate it:
PATCH /api/2.5/frameworks/fcd268abac2544a3a34d666a06ffe66b?acc_token=7ef83e3c4a0b427ebdb7d52f346b4445 HTTP/1.0
Authorization: Bearer brokerr
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2027-01-01-000002",
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"status": "active",
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"owner": "brokerr",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
},
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "general"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-15T00:00:00+02:00",
"clarificationsUntil": "2027-01-20T00:00:00+02:00"
},
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-01-06T00:00:00+02:00"
},
"next_check": "2027-01-16T00:00:00+02:00",
"id": "fcd268abac2544a3a34d666a06ffe66b"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": false
}
}
We can see that framework created successfully without items.
hasItems is true
hasItems:true means that items are required for framework.
Let’s create a framework with hasItems set to true without items:
POST /api/2.5/frameworks HTTP/1.0
Authorization: Bearer brokerr
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"name": "Державне управління справами"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2028-02-05T00:00:00+02:00"
}
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": true
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/a1454b2ec87748649f92ef1ed17a83fe
{
"data": {
"status": "draft",
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2028-02-05T00:00:00+02:00"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "general"
},
"prettyID": "UA-F-2027-01-01-000003",
"owner": "brokerr",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "a1454b2ec87748649f92ef1ed17a83fe"
},
"access": {
"token": "5832664f8c034fffb5724712a23df9f7",
"transfer": "93c853c91de845b89f71024f09aed5f9"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": true
}
}
And then activate it:
PATCH /api/2.5/frameworks/a1454b2ec87748649f92ef1ed17a83fe?acc_token=5832664f8c034fffb5724712a23df9f7 HTTP/1.0
Authorization: Bearer brokerr
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json
{
"status": "error",
"errors": [
{
"location": "body",
"name": "items",
"description": "Items are required for framework with hasItems set to true"
}
]
}
We can see error that indicates that items are required for framework with hasItems set to true.
Now let’s create a framework with hasItems set to true with items:
POST /api/2.5/frameworks HTTP/1.0
Authorization: Bearer brokerr
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"name": "Державне управління справами"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2028-02-05T00:00:00+02:00"
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Mustard seeds",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кг",
"code": "KGM"
},
"quantity": 5,
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова 1"
}
}
]
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": true
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/e2c427b62ce74eb0a3aad129279e9cb8
{
"data": {
"status": "draft",
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"qualificationPeriod": {
"endDate": "2028-02-05T00:00:00+02:00"
},
"items": [
{
"id": "283029253de8403eba22f14443f421e4",
"description": "футляри до державних нагород",
"quantity": 5.0,
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "кг",
"code": "KGM"
}
}
],
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "general"
},
"prettyID": "UA-F-2027-01-01-000004",
"owner": "brokerr",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"id": "e2c427b62ce74eb0a3aad129279e9cb8"
},
"access": {
"token": "0f2f2fe38721429aa3306518dd9dd942",
"transfer": "fc614221ba5b4cf983ace8ce49d78559"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": true
}
}
And then activate it:
PATCH /api/2.5/frameworks/e2c427b62ce74eb0a3aad129279e9cb8?acc_token=0f2f2fe38721429aa3306518dd9dd942 HTTP/1.0
Authorization: Bearer brokerr
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"prettyID": "UA-F-2027-01-01-000004",
"title": "Узагальнена назва закупівлі",
"description": "Назва предмета закупівлі",
"status": "active",
"items": [
{
"id": "283029253de8403eba22f14443f421e4",
"description": "футляри до державних нагород",
"quantity": 5.0,
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "кг",
"code": "KGM"
}
}
],
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"owner": "brokerr",
"date": "2027-01-01T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00",
"qualificationPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
},
"frameworkType": "dynamicPurchasingSystem",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "general"
},
"enquiryPeriod": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2027-01-15T00:00:00+02:00",
"clarificationsUntil": "2027-01-20T00:00:00+02:00"
},
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-01-06T00:00:00+02:00"
},
"next_check": "2027-01-16T00:00:00+02:00",
"id": "e2c427b62ce74eb0a3aad129279e9cb8"
},
"config": {
"restrictedDerivatives": false,
"clarificationUntilDuration": 3,
"qualificationComplainDuration": 0,
"hasItems": true
}
}
We can see that framework created successfully with items.
Later, when agreement is created, items will be transferred to agreement:
GET /api/2.5/agreements/53179c8e9b7f40699828faa144cd4f7c HTTP/1.0
Authorization: Bearer brokerr
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"agreementID": "UA-2027-01-01-000002",
"frameworkID": "e2c427b62ce74eb0a3aad129279e9cb8",
"agreementType": "dynamicPurchasingSystem",
"status": "active",
"period": {
"startDate": "2027-01-01T00:00:00+02:00",
"endDate": "2028-02-05T00:00:00+02:00"
},
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName": "Назва організації"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000",
"email": "aa@aa.com"
},
"kind": "general"
},
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДК003",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"contracts": [
{
"id": "b68dbac1cb764c26b721248d7c0fa580",
"qualificationID": "670f61175e264618a43b8a4bf7713f07",
"submissionID": "550c00047a64417d8c5357ea2051b696",
"status": "active",
"suppliers": [
{
"name": "Державне управління справами",
"name_en": "State administration",
"scale": "micro",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"legalName_en": "dus.gov.ua",
"uri": "http://www.dus.gov.ua/",
"legalName": "Державне управління справами"
},
"address": {
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220"
},
"contactPoint": {
"name": "Державне управління справами",
"name_en": "State administration",
"telephone": "+0440000000",
"email": "aa@aa.com"
}
}
],
"milestones": [
{
"id": "149e891b6d564af98aba0a11bb624bdc",
"status": "scheduled",
"type": "activation",
"dueDate": "2028-02-05T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
],
"date": "2027-01-01T00:00:00+02:00",
"dateModified": "2027-01-01T00:00:00+02:00"
}
],
"owner": "brokerr",
"dateModified": "2027-01-01T00:00:00+02:00",
"date": "2027-01-01T00:00:00+02:00",
"items": [
{
"id": "283029253de8403eba22f14443f421e4",
"description": "футляри до державних нагород",
"quantity": 5.0,
"classification": {
"description": "Mustard seeds",
"scheme": "ДК021",
"id": "03111600-8"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryDate": {
"startDate": "2027-01-03T00:00:00+02:00",
"endDate": "2027-01-06T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
},
"unit": {
"name": "кг",
"code": "KGM"
}
}
],
"next_check": "2028-02-05T00:00:00+02:00",
"dateCreated": "2027-01-01T00:00:00+02:00",
"id": "53179c8e9b7f40699828faa144cd4f7c"
},
"config": {
"restricted": false
}
}