Tutorial¶
Tender creation¶
- You can create three procedures:
reporting
- reporting with no stand-still periodnegotiation
- negotiation procedure with 10 day stand-still before contract registrationnegotiation.quick
- quick negotiation procedure with 5 day stand-still before contract registration
Creating tender for reporting procedure¶
To create tender for reporting procedure you should set reporting
value for procurementMethodType
.
Let’s create a tender:
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3632
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00: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
}
],
"procurementMethod": "limited",
"procurementMethodType": "reporting",
"status": "draft",
"procuringEntity": {
"kind": "special",
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21027",
"region": "Вінницька область",
"streetAddress": "вул. Стахурського. 22"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"identifier": {
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"scheme": "UA-EDR"
},
"name": "ЗОСШ #10 м.Вінниці"
},
"value": {
"amount": 500000,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
],
"mainProcurementCategory": "services"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0
{
"data": {
"mainProcurementCategory": "services",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"title": "Послуги шкільних їдалень",
"procurementMethodType": "reporting",
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна"
},
"kind": "special"
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"value": {
"amount": 500000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"procurementMethod": "limited",
"status": "draft",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "f3452a23940f48cb9a2eedfb60bba9f6",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"id": "f8573404c1ff4e8bac25fc817a2b68c0"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
},
"access": {
"token": "b1e5d31cae12404789b524b2c946715f",
"transfer": "899af9c0a055434d92d853b4887db747"
}
}
We have 201 Created response code, Location header and body with extra id, tenderID, and dateModified properties.
Let’s check what tender registry contains:
GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [],
"next_page": {
"offset": "",
"path": "/api/2.5/tenders",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders"
}
}
We don’t see internal id of tender, because tender appears in the listing from active status.
Creating tender for negotiation procedure¶
To create tender for negotiation procedure you should set negotiation
value for procurementMethodType
.
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 4179
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00: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
}
],
"procurementMethod": "limited",
"procurementMethodType": "negotiation",
"status": "draft",
"procuringEntity": {
"kind": "special",
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21027",
"region": "Вінницька область",
"streetAddress": "вул. Стахурського. 22"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"identifier": {
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"scheme": "UA-EDR"
},
"name": "ЗОСШ #10 м.Вінниці"
},
"value": {
"amount": 500000,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
],
"mainProcurementCategory": "services",
"cause": "twiceUnsuccessful",
"causeDescription": "оригінальний тендер не вдався двічі",
"causeDescription_en": "original tender has failed twice",
"causeDescription_ru": "оригинальный тендер не получился дважды"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0
{
"data": {
"mainProcurementCategory": "services",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"title": "Послуги шкільних їдалень",
"procurementMethodType": "negotiation",
"procurementMethod": "limited",
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна"
},
"kind": "special"
},
"status": "draft",
"value": {
"amount": 500000.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 1.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"cause": "twiceUnsuccessful",
"causeDescription": "оригінальний тендер не вдався двічі",
"causeDescription_en": "original tender has failed twice",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "f3452a23940f48cb9a2eedfb60bba9f6",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"id": "f8573404c1ff4e8bac25fc817a2b68c0"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
},
"access": {
"token": "b1e5d31cae12404789b524b2c946715f",
"transfer": "899af9c0a055434d92d853b4887db747"
}
}
Creating tender for negotiation.quick procedure¶
To create tender for negotiation.quick procedure you should set negotiation.quick
value for procurementMethodType
.
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 4184
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"description": "Послуги шкільних їдалень",
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00: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
}
],
"procurementMethod": "limited",
"procurementMethodType": "negotiation.quick",
"status": "draft",
"procuringEntity": {
"kind": "special",
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21027",
"region": "Вінницька область",
"streetAddress": "вул. Стахурського. 22"
},
"contactPoint": {
"name": "Куца Світлана Валентинівна",
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/"
},
"identifier": {
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\"",
"scheme": "UA-EDR"
},
"name": "ЗОСШ #10 м.Вінниці"
},
"value": {
"amount": 500000,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"title": "Послуги шкільних їдалень",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0,
"percentage": 45.55
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0,
"percentage": 54.45
}
],
"mainProcurementCategory": "services",
"cause": "twiceUnsuccessful",
"causeDescription": "оригінальний тендер не вдався двічі",
"causeDescription_en": "original tender has failed twice",
"causeDescription_ru": "оригинальный тендер не получился дважды"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0
{
"data": {
"mainProcurementCategory": "services",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"title": "Послуги шкільних їдалень",
"procurementMethod": "limited",
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна"
},
"kind": "special"
},
"status": "draft",
"value": {
"amount": 500000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"causeDescription": "оригінальний тендер не вдався двічі",
"causeDescription_en": "original tender has failed twice",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "f3452a23940f48cb9a2eedfb60bba9f6",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"procurementMethodType": "negotiation.quick",
"cause": "twiceUnsuccessful",
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"date": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"id": "f8573404c1ff4e8bac25fc817a2b68c0"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
},
"access": {
"token": "b1e5d31cae12404789b524b2c946715f",
"transfer": "899af9c0a055434d92d853b4887db747"
}
}
Tender activating¶
For activating reporting, negotiation, negotiation.quick procedures you should update status to active
:
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"date": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"title": "Послуги шкільних їдалень",
"mainProcurementCategory": "services",
"procurementMethodType": "reporting",
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна"
},
"kind": "special"
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"value": {
"amount": 500000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"procurementMethod": "limited",
"status": "active",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "f3452a23940f48cb9a2eedfb60bba9f6",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"id": "f8573404c1ff4e8bac25fc817a2b68c0"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
}
}
Let’s see what listing of tenders reveals us:
GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-01-01T00:00:00+02:00",
"id": "f8573404c1ff4e8bac25fc817a2b68c0"
}
],
"next_page": {
"offset": 1672524000.0,
"path": "/api/2.5/tenders?offset=1672524000.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1672524000.0"
}
}
We do see the internal id of a tender (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/tenders/) and its dateModified datestamp.
Modifying tender¶
Let’s update tender by supplementing it with all other essential properties:
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 1142
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"code": "MON",
"name": "month"
},
"quantity": 9,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"date": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"title": "Послуги шкільних їдалень",
"mainProcurementCategory": "services",
"procurementMethodType": "reporting",
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна"
},
"kind": "special"
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "month",
"code": "MON"
},
"quantity": 9.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"value": {
"amount": 500000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"procurementMethod": "limited",
"status": "active",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "f3452a23940f48cb9a2eedfb60bba9f6",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"id": "f8573404c1ff4e8bac25fc817a2b68c0"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
}
}
We see the added properies have merged with existing tender data. Additionally, the dateModified property was updated to reflect the last modification datestamp.
Checking the listing again reflects the new modification date:
GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"dateModified": "2023-01-01T00:00:00+02:00",
"id": "f8573404c1ff4e8bac25fc817a2b68c0"
}
],
"next_page": {
"offset": 1672524000.0,
"path": "/api/2.5/tenders?offset=1672524000.0",
"uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=1672524000.0"
}
}
Uploading documentation¶
Procuring entity can upload documents and files into the created tender. Uploading should follow the Documents Uploading rules.
POST /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/documents?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 322
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b637535099e452b890198556efb7f70?Signature=z4vCl%2FLtbJ2RpGjssq1HKcQ4DzZJ4QSBdeYcMkt2AzLZUmI8TfP9Hp5fNqcBkQcWjYqnejjnfO4b9mMl%2Foy2BA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/documents/e09d8f26c3b74f8d8aa1f5fbbbc18c9f
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b637535099e452b890198556efb7f70?Signature=Gb0uMtev6EiVhDG%2FUzbdh5NxU8ZGf5XusY8RY9n0C9HplAxVHIPVZ8%2FV5X8I0XUCOjzFPqSAe9CiguZlHkj2CA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "e09d8f26c3b74f8d8aa1f5fbbbc18c9f",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
}
}
201 Created response code and Location header confirm document creation.
In case we made an error, we can reupload the document over the older version:
PUT /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/documents/e09d8f26c3b74f8d8aa1f5fbbbc18c9f?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 324
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice-2.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/42fbf3c4d1f544caa25e5a34bbe882b1?Signature=47RE4R8qDyxZb6C08wNjYQUj6ZW7%2B0JipGGXkhW8S%2BZFQnGUzpdDo7tirAjxYzRpgry87281sD351x2eovzCAw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e09d8f26c3b74f8d8aa1f5fbbbc18c9f",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice-2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/42fbf3c4d1f544caa25e5a34bbe882b1?Signature=vuvQiORGzTDrcMzvBj8DCZALoBAzDuzLP1flCwLHr%2BcWbuA2UqXSwHmtPjhve8Ig1Nro75CiPhiEmob3syjrDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
}
}
Awarding¶
Adding supplier information¶
Addition of supplier information is the same for all procedures.
Procuring entity registers supplier information for reporting procedure:
POST /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 1253
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending",
"suppliers": [
{
"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"
}
],
"value": {
"amount": 475000,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538
{
"data": {
"status": "pending",
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
}
}
],
"value": {
"amount": 475000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"id": "58b618d74671419ab1d4efc881a17538",
"date": "2023-01-01T00:00:00+02:00"
}
}
Procuring entity registers supplier information for negotiation procedure:
POST /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 1254
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending",
"suppliers": [
{
"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"
}
],
"value": {
"amount": 475000,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538
{
"data": {
"status": "pending",
"value": {
"amount": 475000.0,
"valueAddedTaxIncluded": false,
"currency": "UAH"
},
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
},
"scale": "micro"
}
],
"id": "58b618d74671419ab1d4efc881a17538",
"date": "2023-01-01T00:00:00+02:00"
}
}
You can notice that there is complaintPeriod
record with startDate
value generated.
Procuring entity registers supplier information for negotiation.quick procedure:
POST /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 1254
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending",
"suppliers": [
{
"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"
}
],
"value": {
"amount": 475000,
"currency": "UAH",
"valueAddedTaxIncluded": false
}
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538
{
"data": {
"status": "pending",
"value": {
"amount": 475000.0,
"valueAddedTaxIncluded": false,
"currency": "UAH"
},
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
},
"scale": "micro"
}
],
"id": "58b618d74671419ab1d4efc881a17538",
"date": "2023-01-01T00:00:00+02:00"
}
}
Award for negotiation.quick procedure also has complaintPeriod
record with startDate
value.
Uploading award documentation¶
You can upload award documents only before awarding decision is confirmed. Let’s add award document:
POST /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538/documents?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 337
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "award_first_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a150b81d16504ae88167cb5c3cec719f?Signature=%2FHNjmOyAxIbAMh127UziLYrtgWYyjQjuNPeyQCWfv29uMghJ7jnlr3qOS8y3W2mf58GIDfTRPWR4PXUvYpTADQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538/documents/0722227979de4c81a08e7b4b5fe18699
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "award_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a150b81d16504ae88167cb5c3cec719f?Signature=VyqNcmitdo%2BX1ROzZI%2BCiQeLLKhcAI6HyxGzEY%2B8MLH1k%2FV6%2BGyLywy3C8rwBiRTWU2cJK8Csm4tIv7OkwMvCA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "0722227979de4c81a08e7b4b5fe18699",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
}
}
201 Created response code and Location header confirm that document has been added.
Let’s see the list of award documents:
GET /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538/documents?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "award_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a150b81d16504ae88167cb5c3cec719f?Signature=VyqNcmitdo%2BX1ROzZI%2BCiQeLLKhcAI6HyxGzEY%2B8MLH1k%2FV6%2BGyLywy3C8rwBiRTWU2cJK8Csm4tIv7OkwMvCA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "0722227979de4c81a08e7b4b5fe18699",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
}
]
}
We can add another award document:
POST /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538/documents?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 348
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "award_second_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4b2e689a0efb48e09297e8f0781145df?Signature=uyIJ%2BTHvo4UBjeSRy0rzQ%2Fz8YImMzAjg8kZyCdYnrvb%2F5VI1CL55osX%2B43BuScH%2B85zRVCZXE%2BpWy5xfChT7AA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538/documents/a043727d4e1e4c9aa879acb67486ff2e
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "award_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4b2e689a0efb48e09297e8f0781145df?Signature=0K0looxslsU82Br8cYEXz%2BfTVToPT1EghT2hkvYmOjQEXndfnbeD%2BYMkV5jHBzmhrM9WTCuD%2BG5auL%2FLjydTAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "a043727d4e1e4c9aa879acb67486ff2e",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
}
}
201 Created response code and Location header confirm second document has been added.
Let’s see the list of all uploaded award documents:
GET /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538/documents?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "award_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a150b81d16504ae88167cb5c3cec719f?Signature=VyqNcmitdo%2BX1ROzZI%2BCiQeLLKhcAI6HyxGzEY%2B8MLH1k%2FV6%2BGyLywy3C8rwBiRTWU2cJK8Csm4tIv7OkwMvCA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "0722227979de4c81a08e7b4b5fe18699",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "award_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4b2e689a0efb48e09297e8f0781145df?Signature=0K0looxslsU82Br8cYEXz%2BfTVToPT1EghT2hkvYmOjQEXndfnbeD%2BYMkV5jHBzmhrM9WTCuD%2BG5auL%2FLjydTAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "a043727d4e1e4c9aa879acb67486ff2e",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
}
]
}
Award confirmation¶
Procuring entity can confirm awarding decision:
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "58b618d74671419ab1d4efc881a17538",
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"documents": [
{
"id": "0722227979de4c81a08e7b4b5fe18699",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "award_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/a150b81d16504ae88167cb5c3cec719f?Signature=VyqNcmitdo%2BX1ROzZI%2BCiQeLLKhcAI6HyxGzEY%2B8MLH1k%2FV6%2BGyLywy3C8rwBiRTWU2cJK8Csm4tIv7OkwMvCA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
},
{
"id": "a043727d4e1e4c9aa879acb67486ff2e",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "award_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/4b2e689a0efb48e09297e8f0781145df?Signature=0K0looxslsU82Br8cYEXz%2BfTVToPT1EghT2hkvYmOjQEXndfnbeD%2BYMkV5jHBzmhrM9WTCuD%2BG5auL%2FLjydTAA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00",
"author": "tender_owner"
}
],
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
}
}
],
"value": {
"amount": 475000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
}
Award confirmation for negotiation procedure:
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 49
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "58b618d74671419ab1d4efc881a17538",
"qualified": true,
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 475000.0,
"valueAddedTaxIncluded": false,
"currency": "UAH"
},
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
},
"scale": "micro"
}
],
"complaintPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-11T00:00:00+02:00"
}
}
}
The difference between startDate
and endDate
in complaintPeriod
record for negotiation is 10 days.
Award confirmation for negotiation.quick procedure:
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/awards/58b618d74671419ab1d4efc881a17538?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 49
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active",
"qualified": true
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "58b618d74671419ab1d4efc881a17538",
"qualified": true,
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 475000.0,
"valueAddedTaxIncluded": false,
"currency": "UAH"
},
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
},
"scale": "micro"
}
],
"complaintPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-06T00:00:00+02:00"
}
}
}
The difference between startDate
and endDate
in complaintPeriod
record for negotiation.quick is 5 days.
Setting contract value¶
By default contract value is set based on the award, but there is a possibility to set custom contract value.
If you want to lower contract value, you can insert new one into the amount field.
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"value": {
"amount": 238,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "96213625067c4083a43480aa295cd464",
"awardID": "58b618d74671419ab1d4efc881a17538",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "pending",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "month",
"code": "MON"
},
"quantity": 9.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"date": "2023-01-01T00:00:00+02:00",
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
}
}
]
}
}
200 OK response was returned. The value was modified successfully.
Setting value per item’s unit¶
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 1219
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "month",
"code": "MON",
"value": {
"amount": 12,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
"quantity": 9.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
]
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "96213625067c4083a43480aa295cd464",
"awardID": "58b618d74671419ab1d4efc881a17538",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "pending",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "month",
"value": {
"amount": 12.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "MON"
},
"quantity": 9.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"date": "2023-01-01T00:00:00+02:00",
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
}
}
]
}
}
200 OK response was returned with successfully set item.unit.value structure.
Item.unit.value.currency and Item.unit.value.valueAddedTaxIncluded are created using contract.value(if exists), otherwise using tender.value data
Setting a single item unit value¶
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464/items/459dbc30c3324f808330a3b4def58686/unit/value?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 24
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"amount": 13
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"amount": 13.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
200 OK response was returned with successfully set item.unit.value structure.
Item.unit.value.currency and Item.unit.value.valueAddedTaxIncluded are created using contract.value(if exists), otherwise using tender.value data
Setting contract signature date¶
There is a possibility to set custom contract signature date. You can insert appropriate date into the dateSigned field.
If this date is not set, it will be auto-generated on the date of contract registration.
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"dateSigned": "2023-01-01T00:00:00+02:00"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "96213625067c4083a43480aa295cd464",
"awardID": "58b618d74671419ab1d4efc881a17538",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "pending",
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "month",
"value": {
"amount": 13.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "MON"
},
"quantity": 9.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"date": "2023-01-01T00:00:00+02:00",
"dateSigned": "2023-01-01T00:00:00+02:00",
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
}
}
]
}
}
Setting contract validity period¶
Setting contract validity period is optional, but if it is needed, you can set appropriate startDate and endDate.
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2024-01-01T00:00:00+02:00"
}
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "96213625067c4083a43480aa295cd464",
"awardID": "58b618d74671419ab1d4efc881a17538",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "pending",
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2024-01-01T00:00:00+02:00"
},
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "month",
"value": {
"amount": 13.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "MON"
},
"quantity": 9.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"date": "2023-01-01T00:00:00+02:00",
"dateSigned": "2023-01-01T00:00:00+02:00",
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
}
}
]
}
}
Uploading contract documentation¶
Contract documents can be uploaded only up until conclusion of the agreement. Let’s add contract document:
POST /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464/documents?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 342
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_first_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1066f87343c8444996cc74fa9b08ed6e?Signature=nrdrAU%2BGCtJZfGTetxtS6EdxdviOv9UXfUfAj4HtTqAMKTUvBghNtS3Bb4jHopJopORW94dMYa2gN%2BKGDcEbCw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464/documents/f0e8435850454bd0871350e0613bf938
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1066f87343c8444996cc74fa9b08ed6e?Signature=Gl7f%2BSpPCET68M9YYpjCX3P2X4B9O2k9iACh4Jlzhjur0Ugdukq1ga39ULMzp5PfzWjcx73XhVWpn%2FLGxz57BQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "f0e8435850454bd0871350e0613bf938",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
}
201 Created response code and Location header confirm that document has been added.
Let’s see the list of contract documents:
GET /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464/documents?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1066f87343c8444996cc74fa9b08ed6e?Signature=Gl7f%2BSpPCET68M9YYpjCX3P2X4B9O2k9iACh4Jlzhjur0Ugdukq1ga39ULMzp5PfzWjcx73XhVWpn%2FLGxz57BQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "f0e8435850454bd0871350e0613bf938",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
]
}
We can add another contract document:
POST /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464/documents?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 343
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "contract_second_document.doc",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/406d025b64f04b06b7c226963c495758?Signature=JWkZ9wLsiUDWNqJpls1kj7VS%2F1Jp%2B2wkExSIs6jw1s80itwJZ1YRxdyJXWSEnkvgDPYP7eRJMfcXDO2v424KDg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464/documents/2b286c9eeeab4ed888a708e8b46a5315
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/406d025b64f04b06b7c226963c495758?Signature=LC8Q3dTbC0wavOf2OfyJzV3mLWJYIjD%2BX9wxIHyuMu4YZGzWQe15Hk4GepgwHCrcZQDdg6RgTnROKzriF7ThBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "2b286c9eeeab4ed888a708e8b46a5315",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
}
201 Created response code and Location header confirm second document has been added.
Let’s see the list of all uploaded contract documents:
GET /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464/documents?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1066f87343c8444996cc74fa9b08ed6e?Signature=Gl7f%2BSpPCET68M9YYpjCX3P2X4B9O2k9iACh4Jlzhjur0Ugdukq1ga39ULMzp5PfzWjcx73XhVWpn%2FLGxz57BQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "f0e8435850454bd0871350e0613bf938",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/406d025b64f04b06b7c226963c495758?Signature=LC8Q3dTbC0wavOf2OfyJzV3mLWJYIjD%2BX9wxIHyuMu4YZGzWQe15Hk4GepgwHCrcZQDdg6RgTnROKzriF7ThBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "2b286c9eeeab4ed888a708e8b46a5315",
"datePublished": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:00+02:00"
}
]
}
Contract registration¶
Reporting tender contract can be registered immediately after award confirmation:
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "96213625067c4083a43480aa295cd464",
"awardID": "58b618d74671419ab1d4efc881a17538",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "active",
"period": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2024-01-01T00:00:00+02:00"
},
"value": {
"amount": 238.0,
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amountNet": 230.0
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "month",
"value": {
"amount": 13.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "MON"
},
"quantity": 9.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"date": "2023-01-01T00:00:01+02:00",
"documents": [
{
"id": "f0e8435850454bd0871350e0613bf938",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/1066f87343c8444996cc74fa9b08ed6e?Signature=Gl7f%2BSpPCET68M9YYpjCX3P2X4B9O2k9iACh4Jlzhjur0Ugdukq1ga39ULMzp5PfzWjcx73XhVWpn%2FLGxz57BQ%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00"
},
{
"id": "2b286c9eeeab4ed888a708e8b46a5315",
"datePublished": "2023-01-01T00:00:00+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"format": "application/msword",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/406d025b64f04b06b7c226963c495758?Signature=LC8Q3dTbC0wavOf2OfyJzV3mLWJYIjD%2BX9wxIHyuMu4YZGzWQe15Hk4GepgwHCrcZQDdg6RgTnROKzriF7ThBg%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:00+02:00"
}
],
"dateSigned": "2023-01-01T00:00:00+02:00",
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"scale": "micro",
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
}
}
]
}
}
Negotiation tender contract can be registered only after the stand-still (10 day period after the award confirmation):
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "96213625067c4083a43480aa295cd464",
"awardID": "58b618d74671419ab1d4efc881a17538",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "active",
"value": {
"amount": 475000.0,
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amountNet": 475000.0
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 1.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:01+02:00",
"dateSigned": "2023-01-01T00:00:01+02:00"
}
}
GET /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0 HTTP/1.0
Authorization: Bearer chronograph
Host: public-api-sandbox.prozorro.gov.ua
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"mainProcurementCategory": "services",
"title_en": "Services in school canteens",
"title_ru": "Услуги школьных столовых",
"description_en": "Services in school canteens",
"description_ru": "Услуги школьных столовых",
"title": "Послуги шкільних їдалень",
"procurementMethodType": "negotiation",
"procurementMethod": "limited",
"procuringEntity": {
"name": "ЗОСШ #10 м.Вінниці",
"identifier": {
"scheme": "UA-EDR",
"id": "21725150",
"legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
},
"address": {
"streetAddress": "вул. Стахурського. 22",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21027",
"countryName": "Україна"
},
"contactPoint": {
"telephone": "+380432465302",
"url": "http://sch10.edu.vn.ua/",
"name": "Куца Світлана Валентинівна"
},
"kind": "special"
},
"status": "active",
"value": {
"amount": 500000.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 1.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"cause": "twiceUnsuccessful",
"causeDescription": "оригінальний тендер не вдався двічі",
"causeDescription_en": "original tender has failed twice",
"causeDescription_ru": "оригинальный тендер не получился дважды",
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 0
},
{
"id": "f3452a23940f48cb9a2eedfb60bba9f6",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 0
}
],
"tenderID": "UA-2023-01-01-000001-a",
"owner": "broker",
"date": "2023-01-01T00:00:01+02:00",
"dateCreated": "2023-01-01T00:00:00+02:00",
"dateModified": "2023-01-01T00:00:01+02:00",
"awards": [
{
"id": "58b618d74671419ab1d4efc881a17538",
"qualified": true,
"status": "active",
"date": "2023-01-01T00:00:00+02:00",
"value": {
"amount": 475000.0,
"valueAddedTaxIncluded": false,
"currency": "UAH"
},
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
},
"scale": "micro"
}
],
"complaintPeriod": {
"startDate": "2023-01-01T00:00:00+02:00",
"endDate": "2023-01-01T00:00:00+02:00"
}
}
],
"contracts": [
{
"id": "96213625067c4083a43480aa295cd464",
"awardID": "58b618d74671419ab1d4efc881a17538",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "active",
"value": {
"amount": 475000.0,
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amountNet": 475000.0
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": false
},
"code": "KGM"
},
"quantity": 1.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:01+02:00",
"dateSigned": "2023-01-01T00:00:01+02:00"
}
],
"cancellations": [
{
"id": "2ecd03fb325c4855b463947269871bf5",
"status": "draft",
"date": "2023-01-01T00:00:00+02:00",
"reasonType": "dateViolation",
"reason": "cancellation reason",
"cancellationOf": "tender"
}
],
"id": "f8573404c1ff4e8bac25fc817a2b68c0"
},
"config": {
"hasAuction": false,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"minBidsNumber": 1
}
}
Negotiation.quick tender contract can be registered after the stand-still (5 day period after the award confirmation):
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/contracts/96213625067c4083a43480aa295cd464?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "active"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "96213625067c4083a43480aa295cd464",
"awardID": "58b618d74671419ab1d4efc881a17538",
"contractID": "UA-2023-01-01-000001-a-1",
"status": "active",
"value": {
"amount": 475000.0,
"currency": "UAH",
"valueAddedTaxIncluded": false,
"amountNet": 475000.0
},
"items": [
{
"id": "459dbc30c3324f808330a3b4def58686",
"description": "Послуги шкільних їдалень",
"classification": {
"description": "Послуги з харчування у школах",
"scheme": "ДК021",
"id": "55523100-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "Послуги шкільних їдалень"
}
],
"unit": {
"name": "папір",
"value": {
"amount": 10.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 1.0,
"deliveryDate": {
"startDate": "2023-01-21T00:00:00+02:00",
"endDate": "2023-02-20T00:00:00+02:00"
},
"deliveryAddress": {
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "79000",
"countryName": "Україна"
}
}
],
"suppliers": [
{
"name": "ДКП «Школяр»",
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://www.sc.gov.ua/"
},
"address": {
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця",
"region": "Вінницька область",
"postalCode": "21100",
"countryName": "Україна"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380432216930",
"name": "Сергій Олексюк"
},
"scale": "micro"
}
],
"date": "2023-01-01T00:00:01+02:00",
"dateSigned": "2023-01-01T00:00:01+02:00"
}
}
Cancelling tender¶
Tender creator can cancel tender anytime (except when tender in status active.auction or in terminal status e.g. unsuccessful, canceled, complete).
The following steps should be applied:
- Prepare cancellation request
- Fill it with the protocol describing the cancellation reasons
- Passing complaint period(10 days),only for negotiation and negotiation.quick
- Cancel the tender with the reasons prepared.
Only the request that has been activated (4th step above) has power to cancel tender. I.e. you have to not only prepare cancellation request but to activate it as well.
For cancelled cancellation you need to update cancellation status to unsuccessful from draft or pending.
See Cancellation data structure for details.
Preparing the cancellation request for reporting procedure¶
You should pass reason and reasonType, status defaults to draft.
There are four possible types of cancellation reason - tender was noDemand, unFixable, forceMajeure and expensesCut.
id is autogenerated and passed in the Location header of response.
POST /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 69
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reason": "cancellation reason",
"reasonType": "noDemand"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations/e69d23d2cdd74a2897b262e00d4c375d
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "e69d23d2cdd74a2897b262e00d4c375d",
"date": "2023-01-01T00:00:01+02:00",
"cancellationOf": "tender",
"status": "draft"
}
}
You can change reasonType
value to any of the above.
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations/e69d23d2cdd74a2897b262e00d4c375d?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 37
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "unFixable"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e69d23d2cdd74a2897b262e00d4c375d",
"status": "draft",
"date": "2023-01-01T00:00:01+02:00",
"reasonType": "unFixable",
"reason": "cancellation reason",
"cancellationOf": "tender"
}
}
Preparing the cancellation request for negotiation and negotiation.quick procedures¶
There are five possible types of cancellation reason - tender was noObjectiveness, unFixable, noDemand, expensesCut, dateViolation.
POST /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 69
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reason": "cancellation reason",
"reasonType": "noDemand"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations/2ecd03fb325c4855b463947269871bf5
{
"data": {
"reasonType": "noDemand",
"reason": "cancellation reason",
"id": "2ecd03fb325c4855b463947269871bf5",
"date": "2023-01-01T00:00:00+02:00",
"cancellationOf": "tender",
"status": "draft"
}
}
You can change reasonType
value to any of the above.
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations/2ecd03fb325c4855b463947269871bf5?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 41
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"reasonType": "dateViolation"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "2ecd03fb325c4855b463947269871bf5",
"status": "draft",
"date": "2023-01-01T00:00:00+02:00",
"reasonType": "dateViolation",
"reason": "cancellation reason",
"cancellationOf": "tender"
}
}
Filling cancellation with protocol and supplementary documentation¶
This step is required. Without documents you can’t update tender status.
Upload the file contents
POST /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations/e69d23d2cdd74a2897b262e00d4c375d/documents?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 322
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b637535099e452b890198556efb7f70?Signature=z4vCl%2FLtbJ2RpGjssq1HKcQ4DzZJ4QSBdeYcMkt2AzLZUmI8TfP9Hp5fNqcBkQcWjYqnejjnfO4b9mMl%2Foy2BA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations/e69d23d2cdd74a2897b262e00d4c375d/documents/e09d8f26c3b74f8d8aa1f5fbbbc18c9f
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b637535099e452b890198556efb7f70?Signature=Gb0uMtev6EiVhDG%2FUzbdh5NxU8ZGf5XusY8RY9n0C9HplAxVHIPVZ8%2FV5X8I0XUCOjzFPqSAe9CiguZlHkj2CA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"id": "e09d8f26c3b74f8d8aa1f5fbbbc18c9f",
"datePublished": "2023-01-01T00:00:01+02:00",
"dateModified": "2023-01-01T00:00:01+02:00"
}
}
Change the document description and other properties
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations/e69d23d2cdd74a2897b262e00d4c375d/documents/e09d8f26c3b74f8d8aa1f5fbbbc18c9f?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 48
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"description": "Changed description"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"description": "Changed description",
"id": "e09d8f26c3b74f8d8aa1f5fbbbc18c9f",
"datePublished": "2023-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/6b637535099e452b890198556efb7f70?Signature=Gb0uMtev6EiVhDG%2FUzbdh5NxU8ZGf5XusY8RY9n0C9HplAxVHIPVZ8%2FV5X8I0XUCOjzFPqSAe9CiguZlHkj2CA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:01+02:00"
}
}
Upload new version of the document
PUT /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations/e69d23d2cdd74a2897b262e00d4c375d/documents/e09d8f26c3b74f8d8aa1f5fbbbc18c9f?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 324
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "Notice-2.pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/42fbf3c4d1f544caa25e5a34bbe882b1?Signature=47RE4R8qDyxZb6C08wNjYQUj6ZW7%2B0JipGGXkhW8S%2BZFQnGUzpdDo7tirAjxYzRpgry87281sD351x2eovzCAw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"description": "Changed description",
"id": "e09d8f26c3b74f8d8aa1f5fbbbc18c9f",
"datePublished": "2023-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice-2.pdf",
"format": "application/pdf",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/42fbf3c4d1f544caa25e5a34bbe882b1?Signature=vuvQiORGzTDrcMzvBj8DCZALoBAzDuzLP1flCwLHr%2BcWbuA2UqXSwHmtPjhve8Ig1Nro75CiPhiEmob3syjrDA%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:01+02:00"
}
}
Passing Complaint Period(only for negotiation and negotiation.quick)¶
For activate complaint period, you need to update cancellation from draft to pending.
PATCH /api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations/e69d23d2cdd74a2897b262e00d4c375d?acc_token=b1e5d31cae12404789b524b2c946715f HTTP/1.0
Authorization: Bearer broker
Content-Length: 31
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"status": "pending"
}
}
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"id": "e69d23d2cdd74a2897b262e00d4c375d",
"status": "pending",
"date": "2023-01-01T00:00:01+02:00",
"reasonType": "unFixable",
"reason": "cancellation reason",
"cancellationOf": "tender",
"documents": [
{
"description": "Changed description",
"id": "e09d8f26c3b74f8d8aa1f5fbbbc18c9f",
"datePublished": "2023-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations/e69d23d2cdd74a2897b262e00d4c375d/documents/e09d8f26c3b74f8d8aa1f5fbbbc18c9f?download=6b637535099e452b890198556efb7f70",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:01+02:00"
},
{
"description": "Changed description",
"id": "e09d8f26c3b74f8d8aa1f5fbbbc18c9f",
"datePublished": "2023-01-01T00:00:01+02:00",
"hash": "md5:00000000000000000000000000000000",
"title": "Notice-2.pdf",
"format": "application/pdf",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/f8573404c1ff4e8bac25fc817a2b68c0/cancellations/e69d23d2cdd74a2897b262e00d4c375d/documents/e09d8f26c3b74f8d8aa1f5fbbbc18c9f?download=42fbf3c4d1f544caa25e5a34bbe882b1",
"documentOf": "tender",
"dateModified": "2023-01-01T00:00:01+02:00"
}
],
"complaintPeriod": {
"startDate": "2023-01-01T00:00:01+02:00",
"endDate": "2023-01-12T00:00:00+02:00"
}
}
}
When cancellation in pending status the tender owner is prohibited from all actions on the tender.
Activating the request and cancelling tender¶
if the complaint period(duration 10 days) is over and there were no complaints or all complaints are canceled, then cancellation will automatically update status to active.