Tutorial¶
Creating auction¶
As long as lot’s rectificationPeriod expires, a procedure is being created automatically:
GET /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2018-06-11-000001",
"minNumberOfQualifiedBids": 1,
"enquiryPeriod": {
"startDate": "2018-06-11T16:35:23.371513+03:00",
"endDate": "2018-06-24T23:59:50+03:00"
},
"submissionMethod": "electronicAuction",
"next_check": "2018-06-24T23:59:50+03:00",
"awardCriteria": "highestCost",
"owner": "concierge",
"id": "84b47bb9907e49fea639a06d4d2bd026",
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2018-06-11T16:35:23.375554+03:00",
"status": "active.tendering",
"tenderPeriod": {
"startDate": "2018-06-11T16:35:23.371513+03:00",
"endDate": "2018-06-24T23:59:50+03:00"
},
"auctionPeriod": {
"shouldStartAfter": "2018-06-25T00:00:00+03:00"
},
"procurementMethodType": "Swiftsure",
"date": "2018-06-11T16:35:23.371513+03:00",
"submissionMethodDetails": "test submissionMethodDetails",
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CPV",
"description": "Земельні ділянки",
"id": "66113000-5"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "e5be8d9cc4ac4505bd7bc1f0867a9f83",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"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": "м. Київ"
}
}
}
}
Note that the procedure initially receives pending.activation status.
Let’s see what listing of auctions reveals us:
GET /api/2.4/auctions HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"next_page": {
"path": "/api/2.4/auctions?offset=2018-06-11T16%3A35%3A23.477068%2B03%3A00",
"uri": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions?offset=2018-06-11T16%3A35%3A23.477068%2B03%3A00",
"offset": "2018-06-11T16:35:23.477068+03:00"
},
"data": [
{
"id": "84b47bb9907e49fea639a06d4d2bd026",
"dateModified": "2018-06-11T16:35:23.477068+03:00"
}
]
}
We do see the auction’s internal id (that can be used to construct full URL https://lb.api-sandbox.ea2.openprocurement.net/api/2.3/auctions/) and its dateModified datestamp.
Procedure activation¶
The initial version of the procedure comes with concierge as an owner, pointing an entity whom the procedure has been originally created by.
You have been given the access_transfer key while creating a lot. Consider that access_transfer is used to retrieve procedure ownership so that to activate the process.
In order to switch the procedure to active.tendering a Transfer object has to be created first:
POST /api/2.4/transfers HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 12
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {}
}
201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"access": {
"transfer": "0f804ec790df46c9a18d29071a78b04e",
"token": "7fe14b58a7324881baa92bad83f2b3c9"
},
"data": {
"date": "2018-06-11T16:35:23.425128+03:00",
"id": "95c65ce36a7aff7333c57c8df7060a98"
}
}
Transfer object contains new access_token & access_transfer. Those are the ones to replace the previous data within the access while changing the ownership of a procedure.
Transfer can be retrieved by id:
GET /api/2.4/transfers/95c65ce36a7aff7333c57c8df7060a98 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"date": "2018-06-11T16:35:23.425128+03:00",
"id": "95c65ce36a7aff7333c57c8df7060a98"
}
}
For the procedure ownership to be changed, you should send POST request to the appropriate /auctions/<id>/ with data section containing id of the Transfer and access_transfer received while creating the lot:
POST /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/ownership HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 100
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"transfer": "1509e1027f004cfdb33a5d932da97bdf",
"id": "95c65ce36a7aff7333c57c8df7060a98"
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2018-06-11-000001",
"minNumberOfQualifiedBids": 1,
"enquiryPeriod": {
"startDate": "2018-06-11T16:35:23.371513+03:00",
"endDate": "2018-06-24T23:59:50+03:00"
},
"submissionMethod": "electronicAuction",
"next_check": "2018-06-24T23:59:50+03:00",
"awardCriteria": "highestCost",
"owner": "broker3",
"id": "84b47bb9907e49fea639a06d4d2bd026",
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2018-06-11T16:35:23.477068+03:00",
"numberOfBids": 0,
"tenderPeriod": {
"startDate": "2018-06-11T16:35:23.371513+03:00",
"endDate": "2018-06-24T23:59:50+03:00"
},
"auctionPeriod": {
"shouldStartAfter": "2018-06-25T00:00:00+03:00"
},
"procurementMethodType": "Swiftsure",
"date": "2018-06-11T16:35:23.371513+03:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CPV",
"description": "Земельні ділянки",
"id": "66113000-5"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "e5be8d9cc4ac4505bd7bc1f0867a9f83",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"submissionMethodDetails": "test submissionMethodDetails",
"status": "active.tendering",
"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": "м. Київ"
}
}
}
}
You should also switch the procedure to active.tendering.
Success! Now we can see that new object has changed its owner and status.
Enquiries¶
When auction is in active.tendering status, interested parties can ask questions:
POST /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"author": {
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137226",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
},
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність"
}
}
201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/questions/bf42ab244b6c42139257c80a6edd5fc5
X-Content-Type-Options: nosniff
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://sch10.edu.vn.ua/",
"id": "00137226"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title": "Калорійність",
"date": "2018-06-11T16:35:40.421990+03:00",
"id": "bf42ab244b6c42139257c80a6edd5fc5",
"questionOf": "tender"
}
}
Organizer can answer them:
PATCH /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/questions/bf42ab244b6c42139257c80a6edd5fc5?acc_token=7fe14b58a7324881baa92bad83f2b3c9 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність",
"date": "2018-06-11T16:35:40.421990+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "bf42ab244b6c42139257c80a6edd5fc5",
"questionOf": "tender"
}
}
And one can retrieve the question list:
GET /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/questions HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": [
{
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність",
"date": "2018-06-11T16:35:40.421990+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "bf42ab244b6c42139257c80a6edd5fc5",
"questionOf": "tender"
}
]
}
Or an individual answer:
GET /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/questions/bf42ab244b6c42139257c80a6edd5fc5 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"title": "Калорійність",
"date": "2018-06-11T16:35:40.421990+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "bf42ab244b6c42139257c80a6edd5fc5",
"questionOf": "tender"
}
}
Registering bid¶
Bidder can register a bid in draft status:
POST /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 881
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "draft",
"qualified": true,
"value": {
"amount": 500
},
"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: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/bids/16da75c44e8a49b89d836fed8d0be4e5
X-Content-Type-Options: nosniff
{
"access": {
"token": "98d7789ed4aa45ce86b85994a80e3ac8"
},
"data": {
"status": "draft",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:40.569023+03:00",
"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": "16da75c44e8a49b89d836fed8d0be4e5"
}
}
And activate a bid:
PATCH /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/bids/16da75c44e8a49b89d836fed8d0be4e5?acc_token=98d7789ed4aa45ce86b85994a80e3ac8 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "active",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:40.569023+03:00",
"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": "16da75c44e8a49b89d836fed8d0be4e5"
}
}
Then upload proposal document:
POST /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/bids/16da75c44e8a49b89d836fed8d0be4e5/documents?acc_token=98d7789ed4aa45ce86b85994a80e3ac8 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 327
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/d870858d9a0647248b2548dba19a040b?KeyID=172d32c8&Signature=sCed49nXCUDChDK7PUhaijNFjQFIWm8aWCRkdv36GT2irKFdSOkWdgOfsm2vegDGOTKrkQFxopGrpmaBGqOvAQ%3D%3D",
"title": "Proposal.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/bids/16da75c44e8a49b89d836fed8d0be4e5/documents/923279c60274492697bac6fc87507c0d
X-Content-Type-Options: nosniff
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/bids/16da75c44e8a49b89d836fed8d0be4e5/documents/923279c60274492697bac6fc87507c0d?download=d870858d9a0647248b2548dba19a040b",
"title": "Proposal.pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:40.701177+03:00",
"dateModified": "2018-06-11T16:35:40.701210+03:00",
"id": "923279c60274492697bac6fc87507c0d"
}
}
It is possible to check the uploaded documents:
GET /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/bids/16da75c44e8a49b89d836fed8d0be4e5/documents?acc_token=98d7789ed4aa45ce86b85994a80e3ac8 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/bids/16da75c44e8a49b89d836fed8d0be4e5/documents/923279c60274492697bac6fc87507c0d?download=d870858d9a0647248b2548dba19a040b",
"title": "Proposal.pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:40.701177+03:00",
"dateModified": "2018-06-11T16:35:40.701210+03:00",
"id": "923279c60274492697bac6fc87507c0d"
}
]
}
For the best effect (biggest economy) auction should have multiple bidders registered:
POST /api/2.4/auctions/97220a271daa48faaae51d29771fbb88/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 881
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "draft",
"qualified": true,
"value": {
"amount": 300
},
"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: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/97220a271daa48faaae51d29771fbb88/bids/a31cfee128dd456a91b18bc89e3751f4
X-Content-Type-Options: nosniff
{
"access": {
"token": "64162bce114841aa821546f0a0f7d199"
},
"data": {
"status": "draft",
"value": {
"currency": "UAH",
"amount": 300.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:43.511922+03:00",
"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": "a31cfee128dd456a91b18bc89e3751f4"
}
}
Activate second bidder:
PATCH /api/2.4/auctions/97220a271daa48faaae51d29771fbb88/bids/a31cfee128dd456a91b18bc89e3751f4?acc_token=64162bce114841aa821546f0a0f7d199 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "active",
"value": {
"currency": "UAH",
"amount": 300.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:43.511922+03:00",
"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": "a31cfee128dd456a91b18bc89e3751f4"
}
}
Upload second bidder proposal:
POST /api/2.4/auctions/97220a271daa48faaae51d29771fbb88/bids/a31cfee128dd456a91b18bc89e3751f4/documents?acc_token=64162bce114841aa821546f0a0f7d199 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 333
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/b79d79e71ad64485b862438165d91952?KeyID=172d32c8&Signature=%2BOQD%2BPwo4VjEY0LCTbXMSSar1YZeQ8Qx%2F95YuCJnJg5PYTSedpHIHDuWO0fFNBknerE2iEm9STvr5kWaGxPtCw%3D%3D",
"title": "Proposal.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/97220a271daa48faaae51d29771fbb88/bids/a31cfee128dd456a91b18bc89e3751f4/documents/c93f6b76b8f8408ba3e4c1809846124d
X-Content-Type-Options: nosniff
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/97220a271daa48faaae51d29771fbb88/bids/a31cfee128dd456a91b18bc89e3751f4/documents/c93f6b76b8f8408ba3e4c1809846124d?download=b79d79e71ad64485b862438165d91952",
"title": "Proposal.pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:43.632323+03:00",
"dateModified": "2018-06-11T16:35:43.632348+03:00",
"id": "c93f6b76b8f8408ba3e4c1809846124d"
}
}
Now procedure is ready for auction stage.
Auction¶
After auction is scheduled anybody can visit it to watch. The auction can be reached at Auction.auctionUrl:
GET /api/2.4/auctions/97220a271daa48faaae51d29771fbb88 HTTP/1.0
Authorization: Basic YXVjdGlvbjo=
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2018-06-11-000001",
"minNumberOfQualifiedBids": 1,
"auctionUrl": "http://auction-sandbox.openprocurement.org/auctions/97220a271daa48faaae51d29771fbb88",
"enquiryPeriod": {
"startDate": "2018-06-04T16:35:13.603823+03:00",
"endDate": "2018-06-11T16:35:13.603823+03:00"
},
"submissionMethod": "electronicAuction",
"next_check": "2018-06-11T17:19:13.603823+03:00",
"awardCriteria": "highestCost",
"owner": "broker3",
"id": "97220a271daa48faaae51d29771fbb88",
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"procurementMethodDetails": "quick, accelerator=1440",
"dateModified": "2018-06-11T16:35:43.805615+03:00",
"status": "active.auction",
"tenderPeriod": {
"startDate": "2018-06-04T16:35:13.603823+03:00",
"endDate": "2018-06-11T16:35:13.603823+03:00"
},
"auctionPeriod": {
"startDate": "2018-06-11T16:35:13.603823+03:00",
"shouldStartAfter": "2018-06-12T00:00:00+03:00"
},
"procurementMethodType": "Swiftsure",
"date": "2018-06-11T16:35:43.188667+03:00",
"submissionMethodDetails": "test submissionMethodDetails",
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CPV",
"description": "Земельні ділянки",
"id": "66113000-5"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "314e112bd02e4d619d4eaf4fc10ac872",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"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": "м. Київ"
}
}
}
}
And bidders can find out their participation URLs via their bids:
GET /api/2.4/auctions/97220a271daa48faaae51d29771fbb88/bids/a509415f03f9484aa644f3afae62fb59?acc_token=9345d09074cb4c01b2983fbb8d7c1bf2 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/97220a271daa48faaae51d29771fbb88/bids/a509415f03f9484aa644f3afae62fb59/documents/ab22c78948584178bbb0b363801118e6?download=c892a93772af4941be65e3d3e900c91f",
"title": "Proposal.pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:43.442548+03:00",
"dateModified": "2018-06-11T16:35:43.442574+03:00",
"id": "ab22c78948584178bbb0b363801118e6"
}
],
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:43.343189+03:00",
"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": "a509415f03f9484aa644f3afae62fb59",
"participationUrl": "https://auction.auction.url/for_bid/a509415f03f9484aa644f3afae62fb59"
}
}
See the Bid.participationUrl in the response. Similar, but different, URL can be retrieved for other participants:
GET /api/2.4/auctions/97220a271daa48faaae51d29771fbb88/bids/a31cfee128dd456a91b18bc89e3751f4?acc_token=64162bce114841aa821546f0a0f7d199 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/97220a271daa48faaae51d29771fbb88/bids/a31cfee128dd456a91b18bc89e3751f4/documents/c93f6b76b8f8408ba3e4c1809846124d?download=b79d79e71ad64485b862438165d91952",
"title": "Proposal.pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:43.632323+03:00",
"dateModified": "2018-06-11T16:35:43.632348+03:00",
"id": "c93f6b76b8f8408ba3e4c1809846124d"
}
],
"value": {
"currency": "UAH",
"amount": 300.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:43.511922+03:00",
"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": "a31cfee128dd456a91b18bc89e3751f4",
"participationUrl": "https://auction.auction.url/for_bid/a31cfee128dd456a91b18bc89e3751f4"
}
}
1 Submitted Proposal¶
If only one bid has been registered the procedure automaticaly changes its status to active.qualification. The award is being created in pending.admission status:
GET /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/awards?acc_token=7fe14b58a7324881baa92bad83f2b3c9 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": [
{
"status": "pending.admission",
"complaintPeriod": {
"startDate": "2018-06-11T16:35:40.861507+03: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": "м. Київ"
}
}
],
"bid_id": "16da75c44e8a49b89d836fed8d0be4e5",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"admissionPeriod": {
"startDate": "2018-06-11T16:35:40.861507+03:00",
"endDate": "2018-06-11T16:40:44.374797+03:00"
},
"date": "2018-06-11T16:35:40.861507+03:00",
"id": "494b2265301e441889f243b820967056"
}
]
}
Pay attention to the admissionPeriod generated. For the process to move forward, you have to upload an admission protocol (documentType: admissionProtocol) in time (up to admissionPeriod.endDate):
POST /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/awards/494b2265301e441889f243b820967056/documents?acc_token=7fe14b58a7324881baa92bad83f2b3c9 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 374
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/cc19957ec3534b4bba83b46c888ccb98?KeyID=172d32c8&Signature=M6twtq070Hbje9AdfEqaCd7huhxcYcpPpOD%2BcNlmBcXvuToQGb1XqhkCJjnt2Pg289jEdevL80zv8RYA8S8ECQ%3D%3D",
"title": "admission_protocol.pdf",
"format": "application/pdf",
"hash": "md5:00000000000000000000000000000000",
"documentType": "auctionProtocol"
}
}
201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/awards/494b2265301e441889f243b820967056/documents/623dab07f4504279b6a64171fa581d72
X-Content-Type-Options: nosniff
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "admission_protocol.pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/cc19957ec3534b4bba83b46c888ccb98?KeyID=172d32c8&Signature=kyYzfvQ13TDcGxqVOD3q7tvvyjalarebLYt9FjTVtUy4cBPNeppMkgrRk6%252B3G7i%2FAsoQ6CN8hTN00B2teb6XCg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:40.962239+03:00",
"documentType": "auctionProtocol",
"dateModified": "2018-06-11T16:35:40.962265+03:00",
"id": "623dab07f4504279b6a64171fa581d72"
}
}
And update it with more details:
PATCH /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/awards/494b2265301e441889f243b820967056/documents/623dab07f4504279b6a64171fa581d72?acc_token=7fe14b58a7324881baa92bad83f2b3c9 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 84
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"description": "admission protocol",
"documentType": "admissionProtocol"
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"dateModified": "2018-06-11T16:35:40.962265+03:00",
"hash": "md5:00000000000000000000000000000000",
"description": "admission protocol",
"author": "auction_owner",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/cc19957ec3534b4bba83b46c888ccb98?KeyID=172d32c8&Signature=kyYzfvQ13TDcGxqVOD3q7tvvyjalarebLYt9FjTVtUy4cBPNeppMkgrRk6%252B3G7i%2FAsoQ6CN8hTN00B2teb6XCg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:40.962239+03:00",
"documentType": "admissionProtocol",
"title": "admission_protocol.pdf",
"id": "623dab07f4504279b6a64171fa581d72"
}
}
With the document being uploaded you have to switch the award to pending status:
PATCH /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/awards/494b2265301e441889f243b820967056?acc_token=7fe14b58a7324881baa92bad83f2b3c9 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "pending"
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "pending",
"documents": [
{
"dateModified": "2018-06-11T16:35:40.962265+03:00",
"hash": "md5:00000000000000000000000000000000",
"description": "admission protocol",
"author": "auction_owner",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/cc19957ec3534b4bba83b46c888ccb98?KeyID=172d32c8&Signature=kyYzfvQ13TDcGxqVOD3q7tvvyjalarebLYt9FjTVtUy4cBPNeppMkgrRk6%252B3G7i%2FAsoQ6CN8hTN00B2teb6XCg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:40.962239+03:00",
"documentType": "admissionProtocol",
"title": "admission_protocol.pdf",
"id": "623dab07f4504279b6a64171fa581d72"
}
],
"verificationPeriod": {
"startDate": "2018-06-11T16:35:41.133133+03:00",
"endDate": "2018-06-11T16:45:44.646234+03:00"
},
"signingPeriod": {
"startDate": "2018-06-11T16:35:41.133133+03:00",
"endDate": "2018-06-11T17:15:44.646234+03: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-06-11T16:35:40.861507+03:00"
},
"bid_id": "16da75c44e8a49b89d836fed8d0be4e5",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"admissionPeriod": {
"startDate": "2018-06-11T16:35:40.861507+03:00",
"endDate": "2018-06-11T16:35:41.133133+03:00"
},
"date": "2018-06-11T16:35:41.142487+03:00",
"id": "494b2265301e441889f243b820967056"
}
}
You can also reject working with a bidder by uploading a document (rejectionProtocol or act) and switching the award to unsuccessful.
With the award being switched to pending, two more periods are being generated. These are verificationPeriod & signingPeriod:
The first thing to be done is auctionProtocol uploading:
POST /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/awards/494b2265301e441889f243b820967056/documents?acc_token=7fe14b58a7324881baa92bad83f2b3c9 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 375
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/d459b307e367467882738de4be3721dd?KeyID=172d32c8&Signature=KSGwiewxJ4bz52Get8ZCBQBUyJJHZCSW4VbGYCOhn1JUT3OdV4xrDOEB5lVVYrcSf0rDbWDUkC1wlTcI0p7OCg%3D%3D",
"title": "SignedAuctionProtocol.pdf",
"format": "application/pdf",
"hash": "md5:00000000000000000000000000000000",
"documentType": "auctionProtocol"
}
}
201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/awards/494b2265301e441889f243b820967056/documents/00230b0270fe48199530593ef70c1a0c
X-Content-Type-Options: nosniff
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "SignedAuctionProtocol.pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/d459b307e367467882738de4be3721dd?KeyID=172d32c8&Signature=QXbB6NJV%2FIeHDRmSOuFD8IvrFfHUj%252BS%252BKthVPfk5oEK1D8Bk5myVyOUrx91BP8WPPPSUe%252Bpx5Drvb%2FUSYZ4%252BDw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:41.214901+03:00",
"documentType": "auctionProtocol",
"dateModified": "2018-06-11T16:35:41.214927+03:00",
"id": "00230b0270fe48199530593ef70c1a0c"
}
}
We can also update it with more details:
PATCH /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/awards/494b2265301e441889f243b820967056/documents/623dab07f4504279b6a64171fa581d72?acc_token=7fe14b58a7324881baa92bad83f2b3c9 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 80
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"description": "auction protocol",
"documentType": "auctionProtocol"
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"dateModified": "2018-06-11T16:35:40.962265+03:00",
"hash": "md5:00000000000000000000000000000000",
"description": "auction protocol",
"author": "auction_owner",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/cc19957ec3534b4bba83b46c888ccb98?KeyID=172d32c8&Signature=kyYzfvQ13TDcGxqVOD3q7tvvyjalarebLYt9FjTVtUy4cBPNeppMkgrRk6%252B3G7i%2FAsoQ6CN8hTN00B2teb6XCg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:40.962239+03:00",
"documentType": "auctionProtocol",
"title": "admission_protocol.pdf",
"id": "623dab07f4504279b6a64171fa581d72"
}
}
With the document being uploaded you have to switch the award to active status:
PATCH /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/awards/494b2265301e441889f243b820967056?acc_token=7fe14b58a7324881baa92bad83f2b3c9 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "active",
"documents": [
{
"dateModified": "2018-06-11T16:35:40.962265+03:00",
"hash": "md5:00000000000000000000000000000000",
"description": "auction protocol",
"author": "auction_owner",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/cc19957ec3534b4bba83b46c888ccb98?KeyID=172d32c8&Signature=kyYzfvQ13TDcGxqVOD3q7tvvyjalarebLYt9FjTVtUy4cBPNeppMkgrRk6%252B3G7i%2FAsoQ6CN8hTN00B2teb6XCg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:40.962239+03:00",
"documentType": "auctionProtocol",
"title": "admission_protocol.pdf",
"id": "623dab07f4504279b6a64171fa581d72"
},
{
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "SignedAuctionProtocol.pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/d459b307e367467882738de4be3721dd?KeyID=172d32c8&Signature=QXbB6NJV%2FIeHDRmSOuFD8IvrFfHUj%252BS%252BKthVPfk5oEK1D8Bk5myVyOUrx91BP8WPPPSUe%252Bpx5Drvb%2FUSYZ4%252BDw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:41.214901+03:00",
"documentType": "auctionProtocol",
"dateModified": "2018-06-11T16:35:41.214927+03:00",
"id": "00230b0270fe48199530593ef70c1a0c"
}
],
"verificationPeriod": {
"startDate": "2018-06-11T16:35:41.133133+03:00",
"endDate": "2018-06-11T16:35:41.385194+03:00"
},
"signingPeriod": {
"startDate": "2018-06-11T16:35:41.133133+03:00",
"endDate": "2018-06-11T17:15:44.646234+03: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-06-11T16:35:40.861507+03:00",
"endDate": "2018-06-11T16:35:41.385194+03:00"
},
"bid_id": "16da75c44e8a49b89d836fed8d0be4e5",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"admissionPeriod": {
"startDate": "2018-06-11T16:35:40.861507+03:00",
"endDate": "2018-06-11T16:35:41.133133+03:00"
},
"date": "2018-06-11T16:35:41.395799+03:00",
"id": "494b2265301e441889f243b820967056"
}
}
Now you can see that the contract object has been created:
GET /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2018-06-11-000001",
"minNumberOfQualifiedBids": 1,
"awardPeriod": {
"startDate": "2018-06-11T16:35:40.861507+03:00",
"endDate": "2018-06-11T16:35:41.385194+03:00"
},
"enquiryPeriod": {
"startDate": "2018-06-04T16:35:13.603823+03:00",
"endDate": "2018-06-11T16:35:13.603823+03:00"
},
"submissionMethod": "electronicAuction",
"next_check": "2018-06-11T17:15:44.646234+03:00",
"awardCriteria": "highestCost",
"questions": [
{
"description": "Просимо додати таблицю потрібної калорійності харчування",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://sch10.edu.vn.ua/",
"id": "00137226"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title": "Калорійність",
"date": "2018-06-11T16:35:40.421990+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "bf42ab244b6c42139257c80a6edd5fc5",
"questionOf": "tender"
}
],
"owner": "broker3",
"id": "84b47bb9907e49fea639a06d4d2bd026",
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"dateModified": "2018-06-11T16:35:41.395799+03:00",
"status": "active.awarded",
"tenderPeriod": {
"startDate": "2018-06-04T16:35:13.603823+03:00",
"endDate": "2018-06-11T16:35:13.603823+03:00"
},
"contracts": [
{
"status": "pending",
"signingPeriod": {
"startDate": "2018-06-11T16:35:41.133133+03:00",
"endDate": "2018-06-11T17:15:44.646234+03:00"
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CPV",
"description": "Земельні ділянки",
"id": "66113000-5"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "e5be8d9cc4ac4505bd7bc1f0867a9f83",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"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": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:41.390965+03:00",
"awardID": "494b2265301e441889f243b820967056",
"id": "a0f6cb3f113243129b14be5a00e28c2e",
"contractID": "UA-EA-2018-06-11-000001-1"
}
],
"procurementMethodDetails": "quick, accelerator=1440",
"procurementMethodType": "Swiftsure",
"awards": [
{
"status": "active",
"documents": [
{
"dateModified": "2018-06-11T16:35:40.962265+03:00",
"hash": "md5:00000000000000000000000000000000",
"description": "auction protocol",
"author": "auction_owner",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/cc19957ec3534b4bba83b46c888ccb98?KeyID=172d32c8&Signature=kyYzfvQ13TDcGxqVOD3q7tvvyjalarebLYt9FjTVtUy4cBPNeppMkgrRk6%252B3G7i%2FAsoQ6CN8hTN00B2teb6XCg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:40.962239+03:00",
"documentType": "auctionProtocol",
"title": "admission_protocol.pdf",
"id": "623dab07f4504279b6a64171fa581d72"
},
{
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "SignedAuctionProtocol.pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/d459b307e367467882738de4be3721dd?KeyID=172d32c8&Signature=QXbB6NJV%2FIeHDRmSOuFD8IvrFfHUj%252BS%252BKthVPfk5oEK1D8Bk5myVyOUrx91BP8WPPPSUe%252Bpx5Drvb%2FUSYZ4%252BDw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:41.214901+03:00",
"documentType": "auctionProtocol",
"dateModified": "2018-06-11T16:35:41.214927+03:00",
"id": "00230b0270fe48199530593ef70c1a0c"
}
],
"verificationPeriod": {
"startDate": "2018-06-11T16:35:41.133133+03:00",
"endDate": "2018-06-11T16:35:41.385194+03:00"
},
"signingPeriod": {
"startDate": "2018-06-11T16:35:41.133133+03:00",
"endDate": "2018-06-11T17:15:44.646234+03: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-06-11T16:35:40.861507+03:00",
"endDate": "2018-06-11T16:35:41.385194+03:00"
},
"bid_id": "16da75c44e8a49b89d836fed8d0be4e5",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"admissionPeriod": {
"startDate": "2018-06-11T16:35:40.861507+03:00",
"endDate": "2018-06-11T16:35:41.133133+03:00"
},
"date": "2018-06-11T16:35:41.395799+03:00",
"id": "494b2265301e441889f243b820967056"
}
],
"date": "2018-06-11T16:35:41.395799+03:00",
"submissionMethodDetails": "test submissionMethodDetails",
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CPV",
"description": "Земельні ділянки",
"id": "66113000-5"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "e5be8d9cc4ac4505bd7bc1f0867a9f83",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"bids": [
{
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/d870858d9a0647248b2548dba19a040b?KeyID=172d32c8&Signature=ovB%2F8iOiP%2F1LReTWJIEpMevbkP8d6vuckYvEKPxuw1gPMGndJexh1ugBgXJKQGLHbIDkHGNgL7qCxHxakiV%2FDg%253D%253D",
"title": "Proposal.pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:40.701177+03:00",
"dateModified": "2018-06-11T16:35:40.701210+03:00",
"id": "923279c60274492697bac6fc87507c0d"
}
],
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:40.569023+03:00",
"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": "16da75c44e8a49b89d836fed8d0be4e5"
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"numberOfBids": 1,
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"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": "м. Київ"
}
}
}
}
To complete the process you have to upload a document (contractSigned):
POST /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/contracts/a0f6cb3f113243129b14be5a00e28c2e/documents?acc_token=7fe14b58a7324881baa92bad83f2b3c9 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 340
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/0514dbbc3b494776859b9cc99f55bec3?KeyID=172d32c8&Signature=JVZtiSKlVRHzQ5A4%2BOyKBgwortzhAHgL6SDsTTTJEMe6DXHlLBv9tm%2BsyYkeCigeVQhM1VDz%2FZSOJZfgwteZCw%3D%3D",
"title": "contract_signed.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/contracts/a0f6cb3f113243129b14be5a00e28c2e/documents/0998e140acd54e18a4a55c28bb3c4cdd
X-Content-Type-Options: nosniff
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/0514dbbc3b494776859b9cc99f55bec3?KeyID=172d32c8&Signature=z%2F9ggZXRc2VBBrVYK3FV0DYkAhOKLSKYNqa%2FaJx%2F9cwTnsK6e2%2F0PBvylJnk5s4FyGGijKepAH%2FU5GzFSoW6DQ%253D%253D",
"title": "contract_signed.pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:41.558740+03:00",
"dateModified": "2018-06-11T16:35:41.558766+03:00",
"id": "0998e140acd54e18a4a55c28bb3c4cdd"
}
}
Setting the correct documentType:
PATCH /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/contracts/a0f6cb3f113243129b14be5a00e28c2e/documents/0998e140acd54e18a4a55c28bb3c4cdd?acc_token=7fe14b58a7324881baa92bad83f2b3c9 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 78
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"description": "contract signed",
"documentType": "contractSigned"
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"description": "contract signed",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/0514dbbc3b494776859b9cc99f55bec3?KeyID=172d32c8&Signature=z%2F9ggZXRc2VBBrVYK3FV0DYkAhOKLSKYNqa%2FaJx%2F9cwTnsK6e2%2F0PBvylJnk5s4FyGGijKepAH%2FU5GzFSoW6DQ%253D%253D",
"title": "contract_signed.pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:41.558740+03:00",
"documentType": "contractSigned",
"dateModified": "2018-06-11T16:35:41.558766+03:00",
"id": "0998e140acd54e18a4a55c28bb3c4cdd"
}
}
Note that dateSigned has to be mentioned as well.
To activate a contract one more POST request should be done:
PATCH /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026/contracts/a0f6cb3f113243129b14be5a00e28c2e?acc_token=7fe14b58a7324881baa92bad83f2b3c9 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"description": "contract signed",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/0514dbbc3b494776859b9cc99f55bec3?KeyID=172d32c8&Signature=z%2F9ggZXRc2VBBrVYK3FV0DYkAhOKLSKYNqa%2FaJx%2F9cwTnsK6e2%2F0PBvylJnk5s4FyGGijKepAH%2FU5GzFSoW6DQ%253D%253D",
"title": "contract_signed.pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:41.558740+03:00",
"documentType": "contractSigned",
"dateModified": "2018-06-11T16:35:41.558766+03:00",
"id": "0998e140acd54e18a4a55c28bb3c4cdd"
}
],
"signingPeriod": {
"startDate": "2018-06-11T16:35:41.133133+03:00",
"endDate": "2018-06-11T17:15:44.646234+03:00"
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CPV",
"description": "Земельні ділянки",
"id": "66113000-5"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "e5be8d9cc4ac4505bd7bc1f0867a9f83",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"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-06-11T16:35:41.726445+03:00",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:41.923408+03:00",
"awardID": "494b2265301e441889f243b820967056",
"id": "a0f6cb3f113243129b14be5a00e28c2e",
"contractID": "UA-EA-2018-06-11-000001-1"
}
}
And finally the procedure is in complete status:
GET /api/2.4/auctions/84b47bb9907e49fea639a06d4d2bd026 HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"procurementMethod": "open",
"auctionID": "UA-EA-2018-06-11-000001",
"minNumberOfQualifiedBids": 1,
"awardPeriod": {
"startDate": "2018-06-11T16:35:40.861507+03:00",
"endDate": "2018-06-11T16:35:41.385194+03:00"
},
"enquiryPeriod": {
"startDate": "2018-06-04T16:35:13.603823+03:00",
"endDate": "2018-06-11T16:35:13.603823+03:00"
},
"submissionMethod": "electronicAuction",
"awardCriteria": "highestCost",
"questions": [
{
"description": "Просимо додати таблицю потрібної калорійності харчування",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"uri": "http://sch10.edu.vn.ua/",
"id": "00137226"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title": "Калорійність",
"date": "2018-06-11T16:35:40.421990+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "bf42ab244b6c42139257c80a6edd5fc5",
"questionOf": "tender"
}
],
"owner": "broker3",
"id": "84b47bb9907e49fea639a06d4d2bd026",
"title": "футляри до державних нагород",
"tenderAttempts": 1,
"dateModified": "2018-06-11T16:35:41.923408+03:00",
"status": "complete",
"tenderPeriod": {
"startDate": "2018-06-04T16:35:13.603823+03:00",
"endDate": "2018-06-11T16:35:13.603823+03:00"
},
"contracts": [
{
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"description": "contract signed",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/0514dbbc3b494776859b9cc99f55bec3?KeyID=172d32c8&Signature=z%2F9ggZXRc2VBBrVYK3FV0DYkAhOKLSKYNqa%2FaJx%2F9cwTnsK6e2%2F0PBvylJnk5s4FyGGijKepAH%2FU5GzFSoW6DQ%253D%253D",
"title": "contract_signed.pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:41.558740+03:00",
"documentType": "contractSigned",
"dateModified": "2018-06-11T16:35:41.558766+03:00",
"id": "0998e140acd54e18a4a55c28bb3c4cdd"
}
],
"signingPeriod": {
"startDate": "2018-06-11T16:35:41.133133+03:00",
"endDate": "2018-06-11T17:15:44.646234+03:00"
},
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CPV",
"description": "Земельні ділянки",
"id": "66113000-5"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "e5be8d9cc4ac4505bd7bc1f0867a9f83",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"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-06-11T16:35:41.726445+03:00",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:41.923408+03:00",
"awardID": "494b2265301e441889f243b820967056",
"id": "a0f6cb3f113243129b14be5a00e28c2e",
"contractID": "UA-EA-2018-06-11-000001-1"
}
],
"procurementMethodDetails": "quick, accelerator=1440",
"procurementMethodType": "Swiftsure",
"awards": [
{
"status": "active",
"documents": [
{
"dateModified": "2018-06-11T16:35:40.962265+03:00",
"hash": "md5:00000000000000000000000000000000",
"description": "auction protocol",
"author": "auction_owner",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/cc19957ec3534b4bba83b46c888ccb98?KeyID=172d32c8&Signature=kyYzfvQ13TDcGxqVOD3q7tvvyjalarebLYt9FjTVtUy4cBPNeppMkgrRk6%252B3G7i%2FAsoQ6CN8hTN00B2teb6XCg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:40.962239+03:00",
"documentType": "auctionProtocol",
"title": "admission_protocol.pdf",
"id": "623dab07f4504279b6a64171fa581d72"
},
{
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "SignedAuctionProtocol.pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/d459b307e367467882738de4be3721dd?KeyID=172d32c8&Signature=QXbB6NJV%2FIeHDRmSOuFD8IvrFfHUj%252BS%252BKthVPfk5oEK1D8Bk5myVyOUrx91BP8WPPPSUe%252Bpx5Drvb%2FUSYZ4%252BDw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:41.214901+03:00",
"documentType": "auctionProtocol",
"dateModified": "2018-06-11T16:35:41.214927+03:00",
"id": "00230b0270fe48199530593ef70c1a0c"
}
],
"verificationPeriod": {
"startDate": "2018-06-11T16:35:41.133133+03:00",
"endDate": "2018-06-11T16:35:41.385194+03:00"
},
"signingPeriod": {
"startDate": "2018-06-11T16:35:41.133133+03:00",
"endDate": "2018-06-11T17:15:44.646234+03: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-06-11T16:35:40.861507+03:00",
"endDate": "2018-06-11T16:35:41.385194+03:00"
},
"bid_id": "16da75c44e8a49b89d836fed8d0be4e5",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"admissionPeriod": {
"startDate": "2018-06-11T16:35:40.861507+03:00",
"endDate": "2018-06-11T16:35:41.133133+03:00"
},
"date": "2018-06-11T16:35:41.395799+03:00",
"id": "494b2265301e441889f243b820967056"
}
],
"date": "2018-06-11T16:35:41.923408+03:00",
"submissionMethodDetails": "test submissionMethodDetails",
"items": [
{
"description": "Земля для військовослужбовців",
"classification": {
"scheme": "CPV",
"description": "Земельні ділянки",
"id": "66113000-5"
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "e5be8d9cc4ac4505bd7bc1f0867a9f83",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"bids": [
{
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/d870858d9a0647248b2548dba19a040b?KeyID=172d32c8&Signature=ovB%2F8iOiP%2F1LReTWJIEpMevbkP8d6vuckYvEKPxuw1gPMGndJexh1ugBgXJKQGLHbIDkHGNgL7qCxHxakiV%2FDg%253D%253D",
"title": "Proposal.pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:40.701177+03:00",
"dateModified": "2018-06-11T16:35:40.701210+03:00",
"id": "923279c60274492697bac6fc87507c0d"
}
],
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:40.569023+03:00",
"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": "16da75c44e8a49b89d836fed8d0be4e5"
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"numberOfBids": 1,
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"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": "м. Київ"
}
}
}
}
2 submitted proposals or more¶
After the competitive auction two awards are created:
GET /api/2.4/auctions/97220a271daa48faaae51d29771fbb88/awards HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Host: api-sandbox.ea.openprocurement.org
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": [
{
"status": "pending",
"verificationPeriod": {
"startDate": "2018-06-11T16:35:43.978129+03:00",
"endDate": "2018-06-11T16:45:47.489255+03:00"
},
"signingPeriod": {
"startDate": "2018-06-11T16:35:43.978129+03:00",
"endDate": "2018-06-11T17:15:47.489255+03: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-06-11T16:35:43.978129+03:00"
},
"bid_id": "a509415f03f9484aa644f3afae62fb59",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:43.978129+03:00",
"id": "41e1409aba4045f8bc887ec7bcb9ac12"
},
{
"status": "pending.waiting",
"complaintPeriod": {
"startDate": "2018-06-11T16:35:43.978129+03: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": "м. Київ"
}
}
],
"bid_id": "a31cfee128dd456a91b18bc89e3751f4",
"value": {
"currency": "UAH",
"amount": 300.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:43.978129+03:00",
"id": "d191c1b6b641439d966ab8aa45d8ef3d"
}
]
}
- for the first candidate (a participant that has submitted the highest valid bid at the auction) - initially has a pending status and awaits auction protocol to be uploaded by the organizer;
- for the second candidate (a participant that has submitted the second highest valid bid at the auction)- initially has a pending.waiting status.
There are two more scenarios that can happen after the competitive auction:
- If the two highest bidders have invalid bids (lower than auction starting price + minimal step), the awards will not be created at all, and the qualification procedure will automatically receive the unsuccessful status.
- If the second highest bidder has a bid that is less than the starting price + minimal step, two awards are created, with one of them receiving a pending status and undergoing the qualification procedure, and the other (with an invalid bid) automatically becoming unsuccessful.
Refusal of waiting by another participant¶
The second candidate (participant that has submitted the second highest valid bid at the auction) can refuse to wait for the disqualification of the first candidate:
PATCH /api/2.4/auctions/97220a271daa48faaae51d29771fbb88/awards/d191c1b6b641439d966ab8aa45d8ef3d?acc_token=64162bce114841aa821546f0a0f7d199 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "cancelled"
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "cancelled",
"complaintPeriod": {
"startDate": "2018-06-11T16:35:43.978129+03:00",
"endDate": "2018-06-11T16:35:44.105665+03: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": "м. Київ"
}
}
],
"bid_id": "a31cfee128dd456a91b18bc89e3751f4",
"value": {
"currency": "UAH",
"amount": 300.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:44.112378+03:00",
"id": "d191c1b6b641439d966ab8aa45d8ef3d"
}
}
Disqualification of a candidate¶
In case of a manual disqualification, the organizer has to upload file with cancellation reason:
POST /api/2.4/auctions/f788c5f54c7148ab976016a6e9fdd99b/awards/a47f6758c4ea47ef8626a287b5be43c6/documents?acc_token=b2343f38d55f4b2c82bf8602023b4faa HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 198
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy315947312362$
Host: api-sandbox.ea.openprocurement.org
201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/f788c5f54c7148ab976016a6e9fdd99b/awards/a47f6758c4ea47ef8626a287b5be43c6/documents/d2192a515f8e42109851528b20caea98
X-Content-Type-Options: nosniff
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "auction_owner",
"title": "rejection_protocol.pdf",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/18f4d31ebb3e4404abdda5c0acd47c0a?KeyID=172d32c8&Signature=ccJuyUi1ypuE5TEl5atUV7fvirNEeb55VxD%252BB4jOzz6ZsINdDaeS4d%252BmIU9R4%252BVNrQL21DS8Tm3v5auhpKDVBg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:18.493856+03:00",
"dateModified": "2018-06-11T16:35:18.493906+03:00",
"id": "d2192a515f8e42109851528b20caea98"
}
}
Update rejection protocol:
PATCH /api/2.4/auctions/f788c5f54c7148ab976016a6e9fdd99b/awards/a47f6758c4ea47ef8626a287b5be43c6/documents/d2192a515f8e42109851528b20caea98?acc_token=b2343f38d55f4b2c82bf8602023b4faa HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 84
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"description": "rejection protocol",
"documentType": "rejectionProtocol"
}
}
200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"dateModified": "2018-06-11T16:35:18.493906+03:00",
"hash": "md5:00000000000000000000000000000000",
"description": "rejection protocol",
"author": "auction_owner",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/18f4d31ebb3e4404abdda5c0acd47c0a?KeyID=172d32c8&Signature=ccJuyUi1ypuE5TEl5atUV7fvirNEeb55VxD%252BB4jOzz6ZsINdDaeS4d%252BmIU9R4%252BVNrQL21DS8Tm3v5auhpKDVBg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:18.493856+03:00",
"documentType": "rejectionProtocol",
"title": "rejection_protocol.pdf",
"id": "d2192a515f8e42109851528b20caea98"
}
}
And disqualify candidate:
PATCH /api/2.4/auctions/f788c5f54c7148ab976016a6e9fdd99b/awards/a47f6758c4ea47ef8626a287b5be43c6?acc_token=b2343f38d55f4b2c82bf8602023b4faa HTTP/1.0
Authorization: Basic YnJva2VyMzo=
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org
{
"data": {
"status": "unsuccessful"
}
}
200 OK
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/f788c5f54c7148ab976016a6e9fdd99b/awards/2e8fb2f78e5d403f8517b80b98894358
X-Content-Type-Options: nosniff
{
"data": {
"status": "unsuccessful",
"documents": [
{
"dateModified": "2018-06-11T16:35:18.493906+03:00",
"hash": "md5:00000000000000000000000000000000",
"description": "rejection protocol",
"author": "auction_owner",
"url": "http://public.docs-sandbox.ea.openprocurement.org/get/18f4d31ebb3e4404abdda5c0acd47c0a?KeyID=172d32c8&Signature=ccJuyUi1ypuE5TEl5atUV7fvirNEeb55VxD%252BB4jOzz6ZsINdDaeS4d%252BmIU9R4%252BVNrQL21DS8Tm3v5auhpKDVBg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2018-06-11T16:35:18.493856+03:00",
"documentType": "rejectionProtocol",
"title": "rejection_protocol.pdf",
"id": "d2192a515f8e42109851528b20caea98"
}
],
"verificationPeriod": {
"startDate": "2018-06-11T16:35:18.145518+03:00",
"endDate": "2018-06-11T16:35:18.733959+03:00"
},
"signingPeriod": {
"startDate": "2018-06-11T16:35:18.145518+03:00",
"endDate": "2018-06-11T17:15:21.674583+03: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-06-11T16:35:18.145518+03:00",
"endDate": "2018-06-11T16:35:18.733959+03:00"
},
"bid_id": "2f76dc5eb2e14b5bbc0ac488c21d43d5",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"date": "2018-06-11T16:35:18.747618+03:00",
"id": "a47f6758c4ea47ef8626a287b5be43c6"
}
}