Tutorial¶
create procedure¶
Let’s create some procedure:
POST /api/2.5/auctions
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"status": "draft",
"bankAccount": {
"description": "Test Bank Account",
"accountIdentification": [
{
"scheme": "UA-EDR",
"id": "66113000-5",
"description": "Test"
}
],
"bankName": "Test bank name"
},
"lotHolder": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
},
"description": "test procuredure",
"contractTerms": {
"type": "lease",
"leaseTerms": {
"leaseDuration": "P10Y"
}
},
"lotIdentifier": "219560",
"minimalStep": {
"currency": "UAH",
"amount": 42
},
"auctionPeriod": {
"startDate": "2018-11-20"
},
"tenderAttempts": 1,
"title": "футляри до державних нагород",
"procurementMethodType": "landlease",
"value": {
"currency": "UAH",
"amount": 100
},
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"registrationFee": {
"currency": "UAH",
"amount": 700.87
},
"budgetSpent": {
"currency": "UAH",
"amount": 35
},
"guarantee": {
"currency": "UAH",
"amount": 35
}
}
}
201 Created
Content-Type: application/json
Location: /api/2.5/auctions/91e3e7946529494389c69b74ff4bdf56
{
"access": {
"transfer": "a1786e07f1604e2daebed660d40955af",
"token": "7f9a013b46af452ea3528fbd89043be3"
},
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2018-11-06-000001",
"minNumberOfQualifiedBids": 2,
"registrationFee": {
"currency": "UAH",
"amount": 700.87
},
"submissionMethod": "electronicAuction",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"owner": "broker",
"id": "91e3e7946529494389c69b74ff4bdf56",
"guarantee": {
"currency": "UAH",
"amount": 35
},
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"auctionParameters": {
"type": "texas"
},
"dateModified": "2018-11-06T14:33:24.274844+02:00",
"status": "draft",
"lotHolder": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"description": "test procuredure",
"auctionPeriod": {
"startDate": "2018-11-20T00:00:00+02:00"
},
"procurementMethodType": "landlease",
"date": "2018-11-06T14:33:24.271809+02:00",
"lotIdentifier": "219560",
"contractTerms": {
"type": "lease",
"leaseTerms": {
"leaseDuration": "P10Y"
}
},
"minimalStep": {
"currency": "UAH",
"amount": 42,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "8c602eba07104554b02a8fe77566e8b9",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
}
}
}
Success! Now we can see that new object has been created. Response code is 201 and Location response header reports the location of the created object. The body of response reveals the information about the created auction: its internal id (that matches the Location segment), its official auctionID and dateModified datestamp stating the moment in time when auction has been last modified. Pay attention to the procurementMethodType. Note that auction is created with draft status.
status: draft¶
get procedure¶
You can GET the auction as long as it’s been created
GET /api/2.5/auctions/1d5b55103d1f4188822add80bb4dbc99
Authorization: Basic YnJva2VyOg==
200 OK
Content-Type: application/json
{
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2018-09-20-000001",
"minNumberOfQualifiedBids": 2,
"registrationFee": {
"currency": "UAH",
"amount": 700.87
},
"submissionMethod": "electronicAuction",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"owner": "broker",
"id": "1d5b55103d1f4188822add80bb4dbc99",
"guarantee": {
"currency": "UAH",
"amount": 35
},
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"auctionParameters": {
"type": "texas"
},
"dateModified": "2018-11-06T14:33:20.036604+02:00",
"status": "draft",
"lotHolder": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"description": "test procuredure",
"auctionPeriod": {
"startDate": "2018-11-20T14:33:20.036604+02:00"
},
"procurementMethodType": "landlease",
"date": "2018-11-06T14:33:20.036604+02:00",
"lotIdentifier": "219560",
"contractTerms": {
"type": "lease",
"leaseTerms": {
"leaseDuration": "P10Y"
}
},
"minimalStep": {
"currency": "UAH",
"amount": 42,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
}
}
}
two-phase commit¶
For the procedure to be activated you should apply a two-phase commit (manually switch procedure to active.rectification status)
PATCH /api/2.5/auctions/1d5b55103d1f4188822add80bb4dbc99?acc_token=2bf83e2d5c58424e83e48d3e6e3ed6b3
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"status": "active.rectification"
}
}
200 OK
Content-Type: application/json
{
"data": {
"bankAccount": {
"description": "Test Bank Account",
"accountIdentification": [
{
"scheme": "UA-EDR",
"id": "66113000-5",
"description": "Test"
}
],
"bankName": "Test bank name"
},
"auctionID": "UA-EA-2018-09-20-000001",
"minNumberOfQualifiedBids": 2,
"enquiryPeriod": {
"startDate": "2018-11-06T14:33:25.920043+02:00",
"endDate": "2018-11-19T20:00:00+02:00"
},
"registrationFee": {
"currency": "UAH",
"amount": 700.87
},
"submissionMethod": "electronicAuction",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"owner": "broker",
"id": "1d5b55103d1f4188822add80bb4dbc99",
"tenderPeriod": {
"startDate": "2018-11-08T14:33:25.920043+02:00",
"endDate": "2018-11-14T20:00:00+02:00"
},
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"auctionParameters": {
"type": "texas"
},
"guarantee": {
"currency": "UAH",
"amount": 35
},
"dateModified": "2018-11-06T14:33:25.923179+02:00",
"status": "active.rectification",
"lotHolder": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"description": "test procuredure",
"auctionPeriod": {
"shouldStartAfter": "2018-11-20T00:00:00+02:00"
},
"procurementMethodType": "landlease",
"date": "2018-11-06T14:33:25.923179+02:00",
"budgetSpent": {
"currency": "UAH",
"amount": 35,
"valueAddedTaxIncluded": true
},
"lotIdentifier": "219560",
"rectificationPeriod": {
"startDate": "2018-11-06T14:33:25.920043+02:00",
"endDate": "2018-11-08T14:33:25.920043+02:00"
},
"contractTerms": {
"type": "lease",
"leaseTerms": {
"leaseDuration": "P10Y"
}
},
"minimalStep": {
"currency": "UAH",
"amount": 42,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"procurementMethod": "open",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"awardCriteria": "highestCost"
}
}
We can see what new fields were generated in auction:
- rectificationPeriod
- it lasts for 2 days. During this period, you can change some fields
- tenderPeriod
- this period ends at 8:00 pm 3 business days before the auction starts. During this period, it is allowed to add documents, work with bids & questions
- enquiryPeriod
- this period ends at 8:00 pm the days before the auction starts During this period, it is allowed to add documents, work with bids & questions
status: active.rectification¶
auctions¶
change fields¶
After the procedure is activated, it receives active.rectification status. During this term you can edit the next data:
- title
- description
- tenderAttempts
- lotIdentifier
- value
- minimalStep
- guarantee
- items
- budgetSpent
- registrationFee
- procuringEntity
- lotHolder
- bankAccount
- contractTerms
Example:
PATCH /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817?acc_token=2bf83e2d5c58424e83e48d3e6e3ed6b3
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"title": "Test"
}
}
200 OK
Content-Type: application/json
{
"data": {
"bankAccount": {
"description": "Test Bank Account",
"accountIdentification": [
{
"scheme": "UA-EDR",
"id": "66113000-5",
"description": "Test"
}
],
"bankName": "Test bank name"
},
"auctionID": "UA-EA-2018-09-20-000001",
"minNumberOfQualifiedBids": 2,
"enquiryPeriod": {
"startDate": "2018-11-06T14:33:20.039212+02:00",
"endDate": "2018-11-19T20:00:00+02:00"
},
"registrationFee": {
"currency": "UAH",
"amount": 700.87
},
"submissionMethod": "electronicAuction",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"owner": "broker",
"id": "ef8ee87d4c8e4fe0950dfad142792817",
"tenderPeriod": {
"startDate": "2018-11-08T14:33:20.039212+02:00",
"endDate": "2018-11-16T20:00:00+02:00"
},
"title": "Test",
"tenderAttempts": 1,
"auctionParameters": {
"type": "texas"
},
"guarantee": {
"currency": "UAH",
"amount": 35
},
"dateModified": "2018-11-06T14:33:27.547334+02:00",
"status": "active.rectification",
"lotHolder": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"description": "test procuredure",
"auctionPeriod": {
"startDate": "2018-11-20T14:33:20.039212+02:00",
"shouldStartAfter": "2018-11-20T00:00:00+02:00"
},
"procurementMethodType": "landlease",
"date": "2018-11-04T14:33:20.039212+02:00",
"budgetSpent": {
"currency": "UAH",
"amount": 35,
"valueAddedTaxIncluded": true
},
"lotIdentifier": "219560",
"rectificationPeriod": {
"startDate": "2018-11-06T14:33:20.039212+02:00",
"endDate": "2018-11-08T14:33:20.039212+02:00"
},
"contractTerms": {
"type": "lease",
"leaseTerms": {
"leaseDuration": "P10Y"
}
},
"minimalStep": {
"currency": "UAH",
"amount": 42,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"procurementMethod": "open",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"awardCriteria": "highestCost"
}
}
auctions documents¶
add document¶
Example:
POST /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/documents?acc_token=2bf83e2d5c58424e83e48d3e6e3ed6b3
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"url": "http://localhost/get/d57821532e9b46d295696014178892b0?KeyID=172d32c8&Signature=rBcgRg5%2Frnun80dPpfe2MAQn6B5oq9FN4YNz7qmuTqEeorsCb5nf4K8kfA34xYxzD9cF4LsIMSE4PLlIqCBBCQ%3D%3D",
"format": "application/msword",
"hash": "md5:00000000000000000000000000000000",
"title": "укр.doc"
}
}
201 Created
Content-Type: application/json
Location: /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/documents/ddfc8a3006804aec82fe711b0f0a1021
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "укр.doc",
"url": "http://localhost/get/d57821532e9b46d295696014178892b0?KeyID=172d32c8&Signature=0st1L6VAfrJIzTPvBpSr2tCR4Zqfc0Kpuyc79Ld3LBKg4A3MLeTBOh%2FoKSgwIdlup8HGR1eUFCyXXh9GYhOcBg%253D%253D",
"format": "application/msword",
"documentOf": "auction",
"datePublished": "2018-11-06T14:33:26.727372+02:00",
"dateModified": "2018-11-06T14:33:26.727434+02:00",
"id": "ddfc8a3006804aec82fe711b0f0a1021"
}
}
status: active.tendering¶
In active.tendering we can:
- add auctions documents
- work with questions
- work with bids
work with questions¶
ask question¶
Bidders can ask questions within the enquiryPeriod:
POST /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/questions
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"author": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
},
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність"
}
}
201 Created
Content-Type: application/json
Location: /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/questions/b1cc28d0329748a094464826069a7698
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"author": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"title": "Калорійність",
"date": "2018-11-06T14:33:30.195431+02:00",
"id": "b1cc28d0329748a094464826069a7698",
"questionOf": "tender"
}
}
answer question¶
The Organizer can provide the answer:
PATCH /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/questions/7c9385ceafc140c788115b218251bd5e?acc_token=2bf83e2d5c58424e83e48d3e6e3ed6b3
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"answer": "Test answer"
}
}
200 OK
Content-Type: application/json
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність",
"date": "2018-11-06T15:15:20.046860+02:00",
"answer": "Test answer",
"id": "7c9385ceafc140c788115b218251bd5e",
"questionOf": "tender"
}
}
We can see the answer field appeared
work with bids¶
add bid¶
In active.tendering status, we can add bids:
POST /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"status": "draft",
"qualified": true,
"value": {
"currency": "UAH",
"amount": 100
},
"tenderers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
}
]
}
}
201 Created
Content-Type: application/json
Location: /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/2d9045ffe37f4c2b8a09db0bfbb0d281
{
"access": {
"token": "0b1527eaf3ca4c80a3124bcfee62a090"
},
"data": {
"owner": "broker",
"status": "draft",
"id": "2d9045ffe37f4c2b8a09db0bfbb0d281",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"tenderers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
]
}
}
get bid¶
You can also GET the created bid:
GET /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/592ed4dc43ae49b787a24c6ee1eb3c01?acc_token=8fcf9c79ba8342b9b8a9a256489346f5
Authorization: Basic YnJva2VyOg==
200 OK
Content-Type: application/json
{
"data": {
"status": "pending",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"qualified": false,
"tenderers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"owner": "broker",
"id": "592ed4dc43ae49b787a24c6ee1eb3c01"
}
}
activate¶
The bid is created in draft status. Use pending status for its activation:
PATCH /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/146bf425b2bb4fbe9e96fbbd4ab6aa11?acc_token=8fcf9c79ba8342b9b8a9a256489346f5
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"status": "pending"
}
}
200 OK
Content-Type: application/json
{
"data": {
"status": "pending",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"date": "2018-11-06T14:33:28.689238+02:00",
"qualified": false,
"tenderers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"owner": "broker",
"id": "146bf425b2bb4fbe9e96fbbd4ab6aa11"
}
}
We can see that the following fields have been generated:
- date
- id
- owner
- qualified: false
make active status¶
As long as a pre-qualification process has been performed out of the system, bid owner should add the next data
- attach document with documentType: eligibilityDocuments
- patch bid, set qualified: true
- patch bid, set bidNumber - integer
- patch bid, set status - active
The last 3 actions can be performed either using separate PATCHs, or applying the one
Let’s complete bid activation
Attach document with documentType: eligibilityDocuments:
POST /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/592ed4dc43ae49b787a24c6ee1eb3c01/documents?acc_token=8fcf9c79ba8342b9b8a9a256489346f5
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"url": "http://localhost/get/6bd4cfd5be94484dbb794dd4ea390a64?KeyID=172d32c8&Signature=oIRhqQQyVTG1LRYmMOSMO6PDBHlzJoQbq4n%2FKjIyy5vDswGw6XxmV%2BNZ4odczBQ5VEqBbJ3OVRFnFarprCaPCg%3D%3D",
"format": "application/msword",
"title": "укр.doc",
"hash": "md5:00000000000000000000000000000000",
"documentType": "eligibilityDocuments"
}
}
201 Created
Content-Type: application/json
Location: /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/592ed4dc43ae49b787a24c6ee1eb3c01/documents/405d176d7ae94b7fa7f4b7ae872f59fb
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "укр.doc",
"url": "http://localhost/api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/592ed4dc43ae49b787a24c6ee1eb3c01/documents/405d176d7ae94b7fa7f4b7ae872f59fb?download=6bd4cfd5be94484dbb794dd4ea390a64",
"format": "application/msword",
"documentOf": "bid",
"datePublished": "2018-11-06T14:33:29.461768+02:00",
"documentType": "eligibilityDocuments",
"dateModified": "2018-11-06T14:33:29.461822+02:00",
"id": "405d176d7ae94b7fa7f4b7ae872f59fb"
}
}
Patch with required data for a complete bid activation:
PATCH /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/592ed4dc43ae49b787a24c6ee1eb3c01?acc_token=8fcf9c79ba8342b9b8a9a256489346f5
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"status": "active",
"qualified": true,
"bidNumber": 1
}
}
200 OK
Content-Type: application/json
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "укр.doc",
"url": "http://localhost/api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/592ed4dc43ae49b787a24c6ee1eb3c01/documents/405d176d7ae94b7fa7f4b7ae872f59fb?download=6bd4cfd5be94484dbb794dd4ea390a64",
"format": "application/msword",
"documentOf": "bid",
"datePublished": "2018-11-06T14:33:29.461768+02:00",
"documentType": "eligibilityDocuments",
"dateModified": "2018-11-06T14:33:29.461822+02:00",
"id": "405d176d7ae94b7fa7f4b7ae872f59fb"
}
],
"bidNumber": 1,
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"qualified": true,
"tenderers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"owner": "broker",
"id": "592ed4dc43ae49b787a24c6ee1eb3c01"
}
}
Now we can see completely activated bid:
GET /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/592ed4dc43ae49b787a24c6ee1eb3c01?acc_token=8fcf9c79ba8342b9b8a9a256489346f5
Authorization: Basic YnJva2VyOg==
200 OK
Content-Type: application/json
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "укр.doc",
"url": "http://localhost/api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/592ed4dc43ae49b787a24c6ee1eb3c01/documents/405d176d7ae94b7fa7f4b7ae872f59fb?download=6bd4cfd5be94484dbb794dd4ea390a64",
"format": "application/msword",
"documentOf": "bid",
"datePublished": "2018-11-06T14:33:29.461768+02:00",
"documentType": "eligibilityDocuments",
"dateModified": "2018-11-06T14:33:29.461822+02:00",
"id": "405d176d7ae94b7fa7f4b7ae872f59fb"
}
],
"bidNumber": 1,
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"qualified": true,
"tenderers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"owner": "broker",
"id": "592ed4dc43ae49b787a24c6ee1eb3c01"
}
}
We can delete bid:
DELETE /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/592ed4dc43ae49b787a24c6ee1eb3c01?acc_token=8fcf9c79ba8342b9b8a9a256489346f5
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
200 OK
Content-Type: application/json
{
"data": {
"status": "pending",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"qualified": false,
"tenderers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"owner": "broker",
"id": "592ed4dc43ae49b787a24c6ee1eb3c01"
}
}
status: active.enquiry¶
In active.enquiry we can:
- adding adding auction documents
- work with questions
- work with bids
- allowed:
- pending-> active
- pending-> deleted
- active-> deleted
- is prohibited:
- create a draft
status: active.auction¶
After auction is scheduled anybody can visit it to watch. The auction can be reached at Auction.auctionUrl:
GET /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817
Authorization: Basic YXVjdGlvbjo=
200 OK
Content-Type: application/json
{
"data": {
"bankAccount": {
"description": "Test Bank Account",
"accountIdentification": [
{
"scheme": "UA-EDR",
"id": "66113000-5",
"description": "Test"
}
],
"bankName": "Test bank name"
},
"auctionID": "UA-EA-2018-09-20-000001",
"minNumberOfQualifiedBids": 2,
"auctionUrl": "http://auction-sandbox.openprocurement.org/auctions/ef8ee87d4c8e4fe0950dfad142792817",
"enquiryPeriod": {
"startDate": "2018-10-19T14:33:20.066118+02:00",
"endDate": "2018-11-05T20:00:00+02:00"
},
"registrationFee": {
"currency": "UAH",
"amount": 700.87
},
"submissionMethod": "electronicAuction",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"owner": "broker",
"id": "ef8ee87d4c8e4fe0950dfad142792817",
"tenderPeriod": {
"startDate": "2018-10-21T14:33:20.066118+02:00",
"endDate": "2018-11-02T20:00:00+02:00"
},
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"auctionParameters": {
"type": "texas"
},
"guarantee": {
"currency": "UAH",
"amount": 35
},
"dateModified": "2018-11-06T14:33:20.039212+02:00",
"status": "active.auction",
"lotHolder": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"description": "test procuredure",
"auctionPeriod": {
"startDate": "2018-11-06T14:33:20.066118+02:00",
"shouldStartAfter": "2018-11-06T00:00:00+02:00"
},
"procurementMethodType": "landlease",
"date": "2018-10-17T14:33:20.066118+02:00",
"budgetSpent": {
"currency": "UAH",
"amount": 35,
"valueAddedTaxIncluded": true
},
"lotIdentifier": "219560",
"rectificationPeriod": {
"startDate": "2018-10-19T14:33:20.066118+02:00",
"endDate": "2018-10-23T14:33:20.066118+02:00"
},
"contractTerms": {
"type": "lease",
"leaseTerms": {
"leaseDuration": "P10Y"
}
},
"minimalStep": {
"currency": "UAH",
"amount": 42,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"procurementMethod": "open",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"awardCriteria": "highestCost"
}
}
We can see what auctionUrl were generated in procedure
And bidders can find out their participation URLs via their bids:
GET /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/bids/8ef6c80be5f440329695167c7b81499b?acc_token=8fcf9c79ba8342b9b8a9a256489346f5
Authorization: Basic YnJva2VyOg==
200 OK
Content-Type: application/json
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "укр.doc",
"url": "http://localhost/get/dd2c4773c24148bcafb37c15e48b788d?KeyID=172d32c8&Signature=SXQigJFdovYi%2F9VhVcZvgq%252BuPPwe37qsEfHgszqwAhC8fN6gH4ZQvJNagEAwHujmd%252BXDhDYXFWsiHW8v6fwrAg%253D%253D",
"format": "application/msword",
"documentOf": "bid",
"datePublished": "2018-11-06T14:33:20.036272+02:00",
"documentType": "eligibilityDocuments",
"dateModified": "2018-11-06T14:33:20.036272+02:00",
"id": "beff27f2339342b78124ac5db1ba8519"
}
],
"bidNumber": 1,
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"qualified": true,
"tenderers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"owner": "broker",
"id": "8ef6c80be5f440329695167c7b81499b",
"participationUrl": "http://auction-sandbox.openprocurement.org/auctions/ef8ee87d4c8e4fe0950dfad142792817?key_for_bid=8ef6c80be5f440329695167c7b81499b"
}
}
We can see what participationUrl were generated in bid
status: active.qualification¶
Auction owner can upload auction protocol:
Bidder owner can upload auction protocol:
POST /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/awards/18271aa9e8d943538583f22b6eb4ef1c/documents?acc_token=2bf83e2d5c58424e83e48d3e6e3ed6b3
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"url": "http://localhost/get/dd787430745540f48a51eba965ae7a31?KeyID=172d32c8&Signature=XvNBXgMbq1Y1aFnYZeOOcLltRg%2FfgTazCfHpDBplzRLqF9%2BPA0bGt38EdJwYlUSsLqad4EWvauL5a%2Fzk%2Bm9CAA%3D%3D",
"format": "application/msword",
"title": "укр.doc",
"hash": "md5:00000000000000000000000000000000",
"documentType": "auctionProtocol"
}
}
201 Created
Content-Type: application/json
Location: /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/awards/18271aa9e8d943538583f22b6eb4ef1c/documents/dc61f10c7d7b44b3adad406138e1b334
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "укр.doc",
"url": "http://localhost/get/dd787430745540f48a51eba965ae7a31?KeyID=172d32c8&Signature=BvQnToPoxVuNfHibniCdrmUEMVKy5v48JMDFJ%2FXTMLZWeeoRgk5I89e6rzpjfG8NJVhM1thzgFjkHYKZUVdZAg%253D%253D",
"format": "application/msword",
"documentOf": "auction",
"datePublished": "2018-11-06T14:33:22.237613+02:00",
"documentType": "auctionProtocol",
"dateModified": "2018-11-06T14:33:22.237639+02:00",
"id": "dc61f10c7d7b44b3adad406138e1b334"
}
}
Auction owner can activate award:
Award after its activation:
GET /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/awards/18271aa9e8d943538583f22b6eb4ef1c
Authorization: Basic YnJva2VyOg==
200 OK
Content-Type: application/json
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "укр.doc",
"url": "http://localhost/get/525adddf3d414dc49e4d75a574e6108c?KeyID=172d32c8&Signature=DIbVBCNX98G7n766bL5tVECaBMhXJc1ZSvU4KsZv2FhfU9jUdrvQTz089GKy6e9IOcisW6%252B4BzIq2r%252Bc5TLLBQ%253D%253D",
"format": "application/msword",
"documentOf": "auction",
"datePublished": "2018-11-06T14:33:22.359533+02:00",
"documentType": "auctionProtocol",
"dateModified": "2018-11-06T14:33:22.359565+02:00",
"id": "6d739ff7bccf45ae81968c20adc22189"
}
],
"verificationPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-06T14:33:22.433777+02:00"
},
"signingPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T23:59:00+02:00"
},
"suppliers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"complaintPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-06T14:33:22.433777+02:00"
},
"bid_id": "8ef6c80be5f440329695167c7b81499b",
"value": {
"currency": "UAH",
"amount": 200.0,
"valueAddedTaxIncluded": true
},
"date": "2018-11-06T14:33:22.443527+02:00",
"id": "18271aa9e8d943538583f22b6eb4ef1c"
}
}
Contract after award activation:
GET /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/contracts
Authorization: Basic YnJva2VyOg==
200 OK
Content-Type: application/json
{
"data": [
{
"status": "pending",
"signingPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T23:59:00+02:00"
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"suppliers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"value": {
"currency": "UAH",
"amount": 200.0,
"valueAddedTaxIncluded": true
},
"date": "2018-11-06T14:33:22.438163+02:00",
"awardID": "18271aa9e8d943538583f22b6eb4ef1c",
"id": "67b67c6785234e29a12cefa9a7570d9c",
"contractID": "UA-EA-2018-09-20-000001-1"
}
]
}
Auction after award activation:
GET /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817
Authorization: Basic YnJva2VyOg==
200 OK
Content-Type: application/json
{
"data": {
"bankAccount": {
"description": "Test Bank Account",
"accountIdentification": [
{
"scheme": "UA-EDR",
"id": "66113000-5",
"description": "Test"
}
],
"bankName": "Test bank name"
},
"auctionID": "UA-EA-2018-09-20-000001",
"minNumberOfQualifiedBids": 2,
"awardPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-06T14:33:22.433777+02:00"
},
"enquiryPeriod": {
"startDate": "2018-10-17T16:00:00+02:00",
"endDate": "2018-11-03T20:00:00+02:00"
},
"registrationFee": {
"currency": "UAH",
"amount": 700.87
},
"submissionMethod": "electronicAuction",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"owner": "broker",
"id": "ef8ee87d4c8e4fe0950dfad142792817",
"tenderPeriod": {
"startDate": "2018-10-21T16:00:00+02:00",
"endDate": "2018-11-01T16:00:00+02:00"
},
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"auctionParameters": {
"type": "texas"
},
"guarantee": {
"currency": "UAH",
"amount": 35
},
"dateModified": "2018-11-06T14:33:20.039212+02:00",
"status": "active.awarded",
"lotHolder": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"description": "test procuredure",
"contracts": [
{
"status": "pending",
"signingPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T23:59:00+02:00"
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"suppliers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"value": {
"currency": "UAH",
"amount": 200.0,
"valueAddedTaxIncluded": true
},
"date": "2018-11-06T14:33:22.438163+02:00",
"awardID": "18271aa9e8d943538583f22b6eb4ef1c",
"id": "67b67c6785234e29a12cefa9a7570d9c",
"contractID": "UA-EA-2018-09-20-000001-1"
}
],
"auctionPeriod": {
"startDate": "2018-11-05T10:00:00+02:00",
"endDate": "2018-11-05T16:00:00+02:00"
},
"procurementMethodType": "landlease",
"awards": [
{
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "укр.doc",
"url": "http://localhost/get/525adddf3d414dc49e4d75a574e6108c?KeyID=172d32c8&Signature=DIbVBCNX98G7n766bL5tVECaBMhXJc1ZSvU4KsZv2FhfU9jUdrvQTz089GKy6e9IOcisW6%252B4BzIq2r%252Bc5TLLBQ%253D%253D",
"format": "application/msword",
"documentOf": "auction",
"datePublished": "2018-11-06T14:33:22.359533+02:00",
"documentType": "auctionProtocol",
"dateModified": "2018-11-06T14:33:22.359565+02:00",
"id": "6d739ff7bccf45ae81968c20adc22189"
}
],
"verificationPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-06T14:33:22.433777+02:00"
},
"signingPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T23:59:00+02:00"
},
"suppliers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"complaintPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-06T14:33:22.433777+02:00"
},
"bid_id": "8ef6c80be5f440329695167c7b81499b",
"value": {
"currency": "UAH",
"amount": 200.0,
"valueAddedTaxIncluded": true
},
"date": "2018-11-06T14:33:22.443527+02:00",
"id": "18271aa9e8d943538583f22b6eb4ef1c"
}
],
"date": "2018-11-06T14:33:22.443527+02:00",
"budgetSpent": {
"currency": "UAH",
"amount": 35,
"valueAddedTaxIncluded": true
},
"lotIdentifier": "219560",
"rectificationPeriod": {
"startDate": "2018-10-17T16:00:00+02:00",
"endDate": "2018-10-21T16:00:00+02:00"
},
"contractTerms": {
"type": "lease",
"leaseTerms": {
"leaseDuration": "P10Y"
}
},
"minimalStep": {
"currency": "UAH",
"amount": 42,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"procurementMethod": "open",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"numberOfBids": 1,
"awardCriteria": "highestCost"
}
}
status: active.awarded¶
Auction owner have to patch contract with dateSigned to activate contract:
PATCH /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/contracts/b86ec3fd2be144eabf04076471e99131?acc_token=2bf83e2d5c58424e83e48d3e6e3ed6b3
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"dateSigned": "2018-11-06T14:33:23.435376+02:00"
}
}
200 OK
Content-Type: application/json
{
"data": {
"status": "pending",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "Auction Contract",
"url": "http://localhost/get/ec59520826574794a52ab4e1e2768d4f?KeyID=172d32c8&Signature=YNMV1qHNv2Jys3OhHPlrX44eio8qLm5nW7AOuasefwQiV03CKhIeoIesXmxub7jF1PT8oQGMFtr%252ByocDj%2FrKCg%253D%253D",
"format": "application/msword",
"documentOf": "auction",
"datePublished": "2018-11-06T14:33:20.036272+02:00",
"documentType": "contractSigned",
"dateModified": "2018-11-06T14:33:20.036272+02:00",
"id": "0065439c0b84448f83f9c2ae8c7d598d"
}
],
"signingPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T23:59:00+02:00"
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"suppliers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"dateSigned": "2018-11-06T14:33:23.435376+02:00",
"value": {
"currency": "UAH",
"amount": 200.0,
"valueAddedTaxIncluded": true
},
"date": "2018-11-05T16:00:00+02:00",
"awardID": "8f124f792d19402aae70b68bf0f37e05",
"id": "b86ec3fd2be144eabf04076471e99131",
"contractID": "UA-EA-2018-09-20-000001-1"
}
}
Auction owner can activate contract, after patching contract with dateSigned :
PATCH /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/contracts/b86ec3fd2be144eabf04076471e99131?acc_token=2bf83e2d5c58424e83e48d3e6e3ed6b3
Authorization: Basic YnJva2VyOg==
Content-Type: application/json
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "Auction Contract",
"url": "http://localhost/get/ec59520826574794a52ab4e1e2768d4f?KeyID=172d32c8&Signature=YNMV1qHNv2Jys3OhHPlrX44eio8qLm5nW7AOuasefwQiV03CKhIeoIesXmxub7jF1PT8oQGMFtr%252ByocDj%2FrKCg%253D%253D",
"format": "application/msword",
"documentOf": "auction",
"datePublished": "2018-11-06T14:33:20.036272+02:00",
"documentType": "contractSigned",
"dateModified": "2018-11-06T14:33:20.036272+02:00",
"id": "0065439c0b84448f83f9c2ae8c7d598d"
}
],
"signingPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T23:59:00+02:00"
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"suppliers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"dateSigned": "2018-11-06T14:33:23.435376+02:00",
"value": {
"currency": "UAH",
"amount": 200.0,
"valueAddedTaxIncluded": true
},
"date": "2018-11-06T14:33:23.647386+02:00",
"awardID": "8f124f792d19402aae70b68bf0f37e05",
"id": "b86ec3fd2be144eabf04076471e99131",
"contractID": "UA-EA-2018-09-20-000001-1"
}
}
Contract after its activation:
GET /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817/contracts/b86ec3fd2be144eabf04076471e99131
Authorization: Basic YnJva2VyOg==
200 OK
Content-Type: application/json
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "Auction Contract",
"url": "http://localhost/get/ec59520826574794a52ab4e1e2768d4f?KeyID=172d32c8&Signature=YNMV1qHNv2Jys3OhHPlrX44eio8qLm5nW7AOuasefwQiV03CKhIeoIesXmxub7jF1PT8oQGMFtr%252ByocDj%2FrKCg%253D%253D",
"format": "application/msword",
"documentOf": "auction",
"datePublished": "2018-11-06T14:33:20.036272+02:00",
"documentType": "contractSigned",
"dateModified": "2018-11-06T14:33:20.036272+02:00",
"id": "0065439c0b84448f83f9c2ae8c7d598d"
}
],
"signingPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T23:59:00+02:00"
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"suppliers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"dateSigned": "2018-11-06T14:33:23.435376+02:00",
"value": {
"currency": "UAH",
"amount": 200.0,
"valueAddedTaxIncluded": true
},
"date": "2018-11-06T14:33:23.647386+02:00",
"awardID": "8f124f792d19402aae70b68bf0f37e05",
"id": "b86ec3fd2be144eabf04076471e99131",
"contractID": "UA-EA-2018-09-20-000001-1"
}
}
Auction after award activation:
GET /api/2.5/auctions/ef8ee87d4c8e4fe0950dfad142792817
Authorization: Basic YnJva2VyOg==
200 OK
Content-Type: application/json
{
"data": {
"bankAccount": {
"description": "Test Bank Account",
"accountIdentification": [
{
"scheme": "UA-EDR",
"id": "66113000-5",
"description": "Test"
}
],
"bankName": "Test bank name"
},
"auctionID": "UA-EA-2018-09-20-000001",
"minNumberOfQualifiedBids": 2,
"awardPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T17:00:00+02:00"
},
"enquiryPeriod": {
"startDate": "2018-10-17T17:00:00+02:00",
"endDate": "2018-11-03T20:00:00+02:00"
},
"registrationFee": {
"currency": "UAH",
"amount": 700.87
},
"submissionMethod": "electronicAuction",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"owner": "broker",
"id": "ef8ee87d4c8e4fe0950dfad142792817",
"tenderPeriod": {
"startDate": "2018-10-21T17:00:00+02:00",
"endDate": "2018-11-01T17:00:00+02:00"
},
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"auctionParameters": {
"type": "texas"
},
"guarantee": {
"currency": "UAH",
"amount": 35
},
"dateModified": "2018-11-06T14:33:20.039212+02:00",
"status": "complete",
"lotHolder": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"description": "test procuredure",
"contracts": [
{
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "Auction Contract",
"url": "http://localhost/get/ec59520826574794a52ab4e1e2768d4f?KeyID=172d32c8&Signature=YNMV1qHNv2Jys3OhHPlrX44eio8qLm5nW7AOuasefwQiV03CKhIeoIesXmxub7jF1PT8oQGMFtr%252ByocDj%2FrKCg%253D%253D",
"format": "application/msword",
"documentOf": "auction",
"datePublished": "2018-11-06T14:33:20.036272+02:00",
"documentType": "contractSigned",
"dateModified": "2018-11-06T14:33:20.036272+02:00",
"id": "0065439c0b84448f83f9c2ae8c7d598d"
}
],
"signingPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T23:59:00+02:00"
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"suppliers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"dateSigned": "2018-11-06T14:33:23.435376+02:00",
"value": {
"currency": "UAH",
"amount": 200.0,
"valueAddedTaxIncluded": true
},
"date": "2018-11-06T14:33:23.647386+02:00",
"awardID": "8f124f792d19402aae70b68bf0f37e05",
"id": "b86ec3fd2be144eabf04076471e99131",
"contractID": "UA-EA-2018-09-20-000001-1"
}
],
"auctionPeriod": {
"startDate": "2018-11-05T10:00:00+02:00",
"endDate": "2018-11-05T16:00:00+02:00"
},
"procurementMethodType": "landlease",
"awards": [
{
"status": "pending",
"verificationPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T17:00:00+02:00"
},
"signingPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T23:59:00+02:00"
},
"suppliers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"complaintPeriod": {
"startDate": "2018-11-05T16:00:00+02:00",
"endDate": "2018-11-05T17:00:00+02:00"
},
"bid_id": "8ef6c80be5f440329695167c7b81499b",
"value": {
"currency": "UAH",
"amount": 200.0,
"valueAddedTaxIncluded": true
},
"date": "2018-11-05T16:00:00+02:00",
"id": "8f124f792d19402aae70b68bf0f37e05"
}
],
"date": "2018-11-06T14:33:23.647386+02:00",
"budgetSpent": {
"currency": "UAH",
"amount": 35,
"valueAddedTaxIncluded": true
},
"lotIdentifier": "219560",
"rectificationPeriod": {
"startDate": "2018-10-17T17:00:00+02:00",
"endDate": "2018-10-21T17:00:00+02:00"
},
"contractTerms": {
"type": "lease",
"leaseTerms": {
"leaseDuration": "P10Y"
}
},
"minimalStep": {
"currency": "UAH",
"amount": 42,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CAV-PS",
"id": "06110000-6",
"description": "Земельні ділянки"
},
"additionalClassifications": [
{
"scheme": "kvtspz",
"id": "01.04",
"description": "Test"
},
{
"scheme": "cadastralNumber",
"id": "42",
"description": "Test"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "3e1b5bec9f3846eea93e02c70c95d693",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5.0001
}
],
"bids": [
{
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "укр.doc",
"url": "http://localhost/api/2.5/auctions/d1bc378e15ae4e319a9154001a7c703b/bids/1775e5e75f924a879545379d4dc7b642/documents/ae4b1e94961742e4bacd4c695ecad43f?download=dd2c4773c24148bcafb37c15e48b788d",
"format": "application/msword",
"documentOf": "bid",
"datePublished": "2018-11-06T14:33:20.036272+02:00",
"documentType": "eligibilityDocuments",
"dateModified": "2018-11-06T14:33:20.036272+02:00",
"id": "beff27f2339342b78124ac5db1ba8519"
}
],
"bidNumber": 1,
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"qualified": true,
"owner_token": "8fcf9c79ba8342b9b8a9a256489346f5",
"tenderers": [
{
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
],
"owner": "broker",
"id": "8ef6c80be5f440329695167c7b81499b"
}
],
"procurementMethod": "open",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"numberOfBids": 1,
"awardCriteria": "highestCost"
}
}