Welcome to openprocurement.api’s documentation!¶
Please report any problems or suggestions for improvement either via the mailing list or the issue tracker.
Contents:
Overview¶
The Open Procurement API is the only interface to Open Procurement database that is core unit of Open Procurement infrastructure.
The Open Procurement API is a REST-ful interface that provides programmatic access to Tender database of Open Procurement system. It provides predictable URLs for accessing resources, and uses built-in HTTP features to receive commands and return responses. This makes it easy to communicate with.
The API accepts JSON or form-encoded content in requests. It returns JSON content in all of its responses, including errors. Only the UTF-8 character encoding is supported for both requests and responses.
Conventions¶
All API POST and PUT requests expect a top-level object with a single element in it named data. Successful responses will mirror this format. The data element should itself be an object, containing the parameters for the request. In the case of creating a new tender, these are the fields we want to set on the tender itself.
If the request was successful, we will get a response code of 201 indicating the object was created. That response will have a data field at its top level, which will contain complete information on the new tender, including its ID.
If something went wrong during the request, we’ll get a different status code and the JSON returned will have an errors field at the top level containing a list of problems. We look at the first one and print out its message.
Main responsibilities¶
Business logic¶
Project status¶
The project has pre alpha status.
The source repository for this project is on GitHub: https://github.com/openprocurement/openprocurement.api
You can leave feedback by raising a new issue on the issue tracker (GitHub registration necessary).
For general discussion use Open Procurement General maillist.
General information, roadmap, and technical specifications for the Open Procurement project can be found at openprocurement.org.
API stability¶
API is highly unstable, and while API endpoints are expected to remain relatively stable the data exchange formats are expected to be changed a lot. The changes in the API are communicated via Open Procurement API maillist.
Change log¶
0.8¶
Released: 2015-05-12
New features:
- Stand-still period for each of the awards independently
- Added new cancellation API
0.7¶
Released: 2015-03-13
New features:
- Set title, classification and additionalClassifications required
- Added validation identical cpv groups of items
- Added upload tender documents by auction user
- Closing tender by registering contract
- Strict mode for patching operation
- Cancalling active award
Modifications:
- Authenticated couchdb access
- Fixed authentication of PUT and PATCH methods
- Optimized calls to db on start
- Fixed deliveryLocation fields
- Fixed edit format field in Documents
- Fixed restrictions uploading documents of bid
0.6¶
Released: 2014-12-15
New features:
- Token Broker authorization
- Actor token authorization
- Added Item.deliveryLocation
- Pending complaints Tender completion blocking
- Rescheduling of failed auctions
0.5¶
Released: not released
New features:
- Actor token generation
- Added Item.deliveryAddress
- Award sequential review logic
Modifications:
- Tender.deliveryDate moved to Item.deliveryDate
0.4¶
Released: 2014-12-01
New Features:
- Filing Complaint on award
- Complaint attachments
- Tender Cancelling
- Question authors visibility
Modifications:
- Tender status codelist harmonized
0.3¶
Released: 2014-11-21
New Features:
- Asking Questions
- Filing Complaint on tender conditions
- Answer Question
- Publish Complaint resolution
- Retrieve Questions and Answers, Complaints and Resolutions
- Auction Scheduler
- Auction Runner
Modifications:
- Data Standard harmonized with Open Contracting 1.0RC
/bidders/
endpoint renamed into/bids/
modified
property renamed intomodificationDate
0.2¶
Released: 2014-11-07
- Tender Listing Batching (optimized for sync operations)
- Documents retrieval
- Change tracking
- Options: Pretty-print, JSONP
- Introduction of state machine and time-based state switching
0.1¶
Released: 2014-10-24
- Set up general build, testing, deployment, and ci framework.
- Creating/modifying tender
- Adding/modifying/cancelling tender proposal
- Awarding/disqualification of tender proposals
Next steps¶
You might find it helpful to look at the Tutorial, or the API Reference.
Authentication¶
Some of the API requests (especially the ones that are read-only GET requests) do not require any authenication. The other ones, that modify data into the database, require broker authentication via API key. Additionally, owner tokens are issued to facilitate multiple actor roles upon object creation.
API keys¶
API key is username to use with Basic Authenication scheme (see RFC 2617#section-2).
Owner tokens¶
Getting token¶
The token is issued when object is created in the database:
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4164
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"title": "Потужність всмоктування",
"enum": [
{
"value": 0.1,
"title": "До 1000 Вт"
},
{
"value": 0.15,
"title": "Більше 1000 Вт"
}
],
"title_en": "Air Intake",
"relatedItem": "e214fbd9ed204c9bb42f9e1f628109f8",
"featureOf": "item"
},
{
"code": "OCDS-123454-YEARS",
"description": "Кількість років, які організація учасник працює на ринку",
"title": "Років на ринку",
"enum": [
{
"value": 0.05,
"title": "До 3 років"
},
{
"value": 0.1,
"title": "Більше 3 років, менше 5 років"
},
{
"value": 0.15,
"title": "Більше 5 років"
}
],
"title_en": "Years trading",
"featureOf": "tenderer"
}
],
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"enquiryPeriod": {
"endDate": "2017-08-01T17:36:49.331754"
},
"title_en": "Cases with state awards",
"value": {
"currency": "UAH",
"amount": 500
},
"mode": "test",
"procurementMethodType": "belowThreshold",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
},
"title_ru": "футляры к государственным наградам",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"description_en": "Cases with state awards",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"description_ru": "футляры к государственным наградам",
"id": "e214fbd9ed204c9bb42f9e1f628109f8",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"tenderPeriod": {
"endDate": "2017-08-08T17:36:49.331754"
}
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e5d1cd890bd54669972755ca7e8604de
{
"access": {
"token": "1a6350b26a094a39adf455ee9a495f6c"
},
"data": {
"procurementMethod": "open",
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"title": "Потужність всмоктування",
"enum": [
{
"value": 0.1,
"title": "До 1000 Вт"
},
{
"value": 0.15,
"title": "Більше 1000 Вт"
}
],
"title_en": "Air Intake",
"relatedItem": "e214fbd9ed204c9bb42f9e1f628109f8",
"featureOf": "item"
},
{
"code": "OCDS-123454-YEARS",
"description": "Кількість років, які організація учасник працює на ринку",
"title": "Років на ринку",
"enum": [
{
"value": 0.05,
"title": "До 3 років"
},
{
"value": 0.1,
"title": "Більше 3 років, менше 5 років"
},
{
"value": 0.15,
"title": "Більше 5 років"
}
],
"title_en": "Years trading",
"featureOf": "tenderer"
}
],
"enquiryPeriod": {
"startDate": "2017-07-25T17:36:55.784983+03:00",
"endDate": "2017-08-01T17:36:49.331754+03:00"
},
"submissionMethod": "electronicAuction",
"next_check": "2017-08-01T17:36:49.331754+03:00",
"awardCriteria": "lowestCost",
"owner": "broker",
"id": "e5d1cd890bd54669972755ca7e8604de",
"title": "[ТЕСТУВАННЯ] футляри до державних нагород",
"tenderID": "UA-2017-07-25-000002",
"dateModified": "2017-07-25T17:36:55.787215+03:00",
"status": "active.enquiries",
"tenderPeriod": {
"startDate": "2017-08-01T17:36:49.331754+03:00",
"endDate": "2017-08-08T17:36:49.331754+03:00"
},
"procurementMethodType": "belowThreshold",
"title_en": "[TESTING] Cases with state awards",
"date": "2017-07-25T17:36:55.785011+03:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"description_en": "Cases with state awards",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"description_ru": "футляры к государственным наградам",
"id": "e214fbd9ed204c9bb42f9e1f628109f8",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"mode": "test",
"title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
}
}
You can see the access with token in response. Its value can be used to modify objects further under “Owner role”.
Using token¶
You can pass access token in the following ways:
- acc_token URL query string parameter
- X-Access-Token HTTP request header
- access.token in the body of POST/PUT/PATCH request
See the example of the action with token passed as URL query string:
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"tenderPeriod": {
"endDate": "2017-08-09T17:37:05.888957+03:00"
}
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"status": "active.enquiries",
"awardCriteria": "lowestCost",
"tenderPeriod": {
"startDate": "2017-08-01T17:36:49.306344+03:00",
"endDate": "2017-08-09T17:37:05.888957+03:00"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"procurementMethodType": "belowThreshold",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"submissionMethod": "electronicAuction",
"date": "2017-07-25T17:36:55.659566+03:00",
"next_check": "2017-08-01T17:36:49.306344+03:00",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"enquiryPeriod": {
"startDate": "2017-07-25T17:36:55.659520+03:00",
"endDate": "2017-08-01T17:36:49.306344+03:00"
},
"owner": "broker",
"dateModified": "2017-07-25T17:36:55.921421+03:00",
"id": "f3641d0ba0f042e8b49de06d5c7921af",
"tenderID": "UA-2017-07-25-000001"
}
}
Responses¶
After processing API always provides response, reporting either success or failure.
Status Codes¶
In all cases, the API should return an HTTP Status Code that indicates the nature of the failure (see below), with a response body in JSON format containing additional information.
- 200
- Success. If data was requested, it will be available in the data field at the top level of the response body.
- 201
- Success (for object creation). Its information is available in the data field at the top level of the response body. The API URL where the object can be retrieved is also returned in the Location header of the response.
- 400
- Invalid request. This usually occurs because of a missing or malformed parameter. Check the documentation and the syntax of your request and try again.
- 401
- No authorization. A valid API key was not provided with the request, so the API could not associate a user with the request.
- 403
- Forbidden. The API key and request syntax was valid but the server is refusing to complete the request. This can happen if you are trying to read or write to objects or properties that you do not have access to.
- 404
- Not found. Either the request method and path supplied do not specify a known action in the API, or the object specified by the request does not exist.
- 409
- Document update conflict. The request could not be completed due to a conflict with the current state of the target resource. Please repeat your request.
- 410
- Archived. The resource requested is not and will not be available.
- 412
- Precondition Failed. See API in cluster mode.
- 422
- Unprocessable Entity. This status code means the server understands the content type of the request entity. For example, this error condition may occur if a JSON request body contains well-formed (i.e., syntactically correct), but semantically erroneous, JSON instructions.
- 429
- Rate Limit Enforced. See Rate control.
- 500
- Server error. There was a problem on OpenProcurement’s end.
- 501
- Not Implemented. The server either does not recognize the request method, or it lacks the ability to fulfill the request. Re-check the request consistency.
- 502
- Bad Gateway. The server received an invalid response or backend is not ready to handle requests. Repeat request for repeatable operations or check object data with interval 1-5 min.
- 503
- Service Unavailable. The server is currently unavailable (because it is overloaded or down for maintenance). Generally, this is a temporary state.
- 504
- Gateway Time-out. The server did not receive a timely response. Repeat request for repeatable operations or check object data with interval 1-5 min.
- 505
- HTTP Version Not Supported. The server does not support the HTTP protocol version used in the request. Re-check the request consistency.
Success Response¶
Every successful get, create, update, replace request results in response that contains data attribute. That data attribute contains full JSON object representation after the operation. If some data were generated in the result of processing (like new object IDs, or modified date) they are present in the respose.
The listing requests result in similar responses, but instead of single object in data attribute, the JSON response contains collection of objects.
Example Succes Response¶
Here is a response that describes tender
HTTP/1.1 200 OK
{
"data":{
"id": "64e93250be76435397e8c992ed4214d1",
"tenderID": "UA-2014-DUS-156",
"dateModified": "2014-10-27T08:06:58.158Z",
"procuringEntity": {
"name": "ДУС"б
"identifier": {
"name": "Державне управління справами",
"scheme": "UA-EDR",
"uid": "00037256"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
}
},
"value": {
"amount": 500,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CPV",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"quantity": 5,
"unit": {
"name": "item"
},
"deliveryDate": {
"endDate": "2014-11-20T00:00:00"
}
}
],
"clarificationPeriod": {
"endDate": "2014-10-31T00:00:00"
},
"tenderPeriod": {
"startDate": "2014-11-03T00:00:00",
"endDate": "2014-11-06T10:00:00"
},
"minimalStep": {
"amount": 35,
"currency", "UAH",
"valueAddedTaxIncluded": true
}
}
}
Error Response¶
In the event of an error, the response body will contain an errors field at the top level. It contains an array of at least one error object, described below:
location: | Part of the request causing the error. Possible values are header and body. |
---|---|
name: |
|
description: | Verbose (human readable) description of the error. |
Example Error Response¶
Sample below indicates incomplete request.
HTTP/1.1 400 Missing input
{
"status": "error",
"errors": [
{
"location": "body",
"name": "data",
"description": "No JSON object could be decoded"
}
]
}
Options¶
In addition to providing fields and their values in a request, you may also specify options to control how your request is interpreted and how the response is generated. For GET requests, options are specified as URL parameters prefixed with opt_. For POST or PUT requests, options are specified in the body, inside the top-level options object (a sibling of the data object). The option specified in the body overrides the opt_ one from URL parameter.
These options can be used in different combinations in a single request, though some of them may conflict in their impact on the response.
pretty: | ?opt_pretty options: { pretty: true } Provides the response in “pretty” output. In case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable to use this only during debugging. |
---|---|
jsonp: | ?opt_jsonp=myCallback Returns the output in JSON-P format instead of plain JSON. This allows requests to come from within browsers and work around the “same origin policy.” The function named as the value of the opt_jsonp parameter will be called with a single argument, a JavaScript object representing the response. |
fields: | ?opt_fields=comma,separated,field,list List of extra fields to include in response. |
Documents Uploading¶
All of the document uploading API endpoints follow the same set of rules.
Upload document with registration¶
Add document in API:
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0 Authorization: Basic YnJva2VyOg== Content-Length: 334 Content-Type: application/json Host: api-sandbox.openprocurement.org { "data": { "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=3SoLjvN%2Bubc3yUq7E%2F8z%2FT4nhwBCO%2BYejSIqF2ORk3btE1ug052zZDNQQpi4yyd1rj%2FPX09LiTVm%2BoTVYouoCg%3D%3D", "title": "Notice.pdf", "hash": "md5:00000000000000000000000000000000", "format": "application/pdf" } } 201 Created Content-Type: application/json; charset=UTF-8 Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5 { "data": { "hash": "md5:00000000000000000000000000000000", "author": "tender_owner", "title": "Notice.pdf", "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D", "format": "application/pdf", "documentOf": "tender", "datePublished": "2017-07-25T17:36:56.044656+03:00", "id": "8c4f7355fed4463b98eb429237a2e6a5", "dateModified": "2017-07-25T17:36:56.044677+03:00" } }
Upload document w/o registration¶
Add document in API:
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0 Authorization: Basic YnJva2VyOg== Content-Length: 334 Content-Type: application/json Host: api-sandbox.openprocurement.org { "data": { "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=3SoLjvN%2Bubc3yUq7E%2F8z%2FT4nhwBCO%2BYejSIqF2ORk3btE1ug052zZDNQQpi4yyd1rj%2FPX09LiTVm%2BoTVYouoCg%3D%3D", "title": "Notice.pdf", "hash": "md5:00000000000000000000000000000000", "format": "application/pdf" } } 201 Created Content-Type: application/json; charset=UTF-8 Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5 { "data": { "hash": "md5:00000000000000000000000000000000", "author": "tender_owner", "title": "Notice.pdf", "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D", "format": "application/pdf", "documentOf": "tender", "datePublished": "2017-07-25T17:36:56.044656+03:00", "id": "8c4f7355fed4463b98eb429237a2e6a5", "dateModified": "2017-07-25T17:36:56.044677+03:00" } }
Tutorial¶
Exploring basic rules¶
Let’s try exploring the /tenders endpoint:
GET /api/2.3/tenders HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"next_page": {
"path": "/api/2.3/tenders?offset=",
"uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=",
"offset": ""
},
"data": []
}
Just invoking it reveals empty set.
Now let’s attempt creating some tender:
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: api-sandbox.openprocurement.org
415 Unsupported Media Type
Content-Type: application/json; charset=UTF-8
{
"status": "error",
"errors": [
{
"description": "Content-Type header should be one of ['application/json']",
"location": "header",
"name": "Content-Type"
}
]
}
Error states that the only accepted Content-Type is application/json.
Let’s satisfy the Content-type requirement:
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: api-sandbox.openprocurement.org
422 Unprocessable Entity
Content-Type: application/json; charset=UTF-8
{
"status": "error",
"errors": [
{
"description": "No JSON object could be decoded",
"location": "body",
"name": "data"
}
]
}
Error states that no data has been found in JSON body.
Creating tender¶
Let’s create tender with the minimal (only required) data set:
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2359
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"tenderPeriod": {
"endDate": "2017-08-08T17:36:49.306344"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"enquiryPeriod": {
"endDate": "2017-08-01T17:36:49.306344"
},
"procurementMethodType": "belowThreshold",
"value": {
"currency": "UAH",
"amount": 500
},
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344",
"endDate": "2017-07-30T17:36:49.306344"
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
]
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af
{
"access": {
"token": "2ef61fa89e8a451ba4149d2f8e31173b"
},
"data": {
"procurementMethod": "open",
"status": "active.enquiries",
"awardCriteria": "lowestCost",
"tenderPeriod": {
"startDate": "2017-08-01T17:36:49.306344+03:00",
"endDate": "2017-08-08T17:36:49.306344+03:00"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"procurementMethodType": "belowThreshold",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"submissionMethod": "electronicAuction",
"date": "2017-07-25T17:36:55.659566+03:00",
"next_check": "2017-08-01T17:36:49.306344+03:00",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"enquiryPeriod": {
"startDate": "2017-07-25T17:36:55.659520+03:00",
"endDate": "2017-08-01T17:36:49.306344+03:00"
},
"owner": "broker",
"dateModified": "2017-07-25T17:36:55.662421+03:00",
"id": "f3641d0ba0f042e8b49de06d5c7921af",
"tenderID": "UA-2017-07-25-000001"
}
}
Success! Now we can see that new object was 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 tender: its internal id (that matches the Location segment), its official tenderID and dateModified datestamp stating the moment in time when tender was last modified. Pay attention to the procurementMethodType. Note that tender is created with active.enquiries status.
Let’s access the URL of the created object (the Location header of the response):
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"status": "active.enquiries",
"awardCriteria": "lowestCost",
"tenderPeriod": {
"startDate": "2017-08-01T17:36:49.306344+03:00",
"endDate": "2017-08-08T17:36:49.306344+03:00"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"procurementMethodType": "belowThreshold",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"submissionMethod": "electronicAuction",
"date": "2017-07-25T17:36:55.659566+03:00",
"next_check": "2017-08-01T17:36:49.306344+03:00",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"enquiryPeriod": {
"startDate": "2017-07-25T17:36:55.659520+03:00",
"endDate": "2017-08-01T17:36:49.306344+03:00"
},
"owner": "broker",
"dateModified": "2017-07-25T17:36:55.662421+03:00",
"id": "f3641d0ba0f042e8b49de06d5c7921af",
"tenderID": "UA-2017-07-25-000001"
}
}
We can see the same response we got after creating tender.
Let’s see what listing of tenders reveals us:
GET /api/2.3/tenders HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"next_page": {
"path": "/api/2.3/tenders?offset=",
"uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=",
"offset": ""
},
"data": []
}
We do see the internal id of a tender (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/tenders/) and its dateModified datestamp.
The previous tender contained only required fields. Let’s try creating tender with more data (tender has status created):
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4164
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"title": "Потужність всмоктування",
"enum": [
{
"value": 0.1,
"title": "До 1000 Вт"
},
{
"value": 0.15,
"title": "Більше 1000 Вт"
}
],
"title_en": "Air Intake",
"relatedItem": "e214fbd9ed204c9bb42f9e1f628109f8",
"featureOf": "item"
},
{
"code": "OCDS-123454-YEARS",
"description": "Кількість років, які організація учасник працює на ринку",
"title": "Років на ринку",
"enum": [
{
"value": 0.05,
"title": "До 3 років"
},
{
"value": 0.1,
"title": "Більше 3 років, менше 5 років"
},
{
"value": 0.15,
"title": "Більше 5 років"
}
],
"title_en": "Years trading",
"featureOf": "tenderer"
}
],
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"enquiryPeriod": {
"endDate": "2017-08-01T17:36:49.331754"
},
"title_en": "Cases with state awards",
"value": {
"currency": "UAH",
"amount": 500
},
"mode": "test",
"procurementMethodType": "belowThreshold",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
},
"title_ru": "футляры к государственным наградам",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"description_en": "Cases with state awards",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"description_ru": "футляры к государственным наградам",
"id": "e214fbd9ed204c9bb42f9e1f628109f8",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"tenderPeriod": {
"endDate": "2017-08-08T17:36:49.331754"
}
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e5d1cd890bd54669972755ca7e8604de
{
"access": {
"token": "1a6350b26a094a39adf455ee9a495f6c"
},
"data": {
"procurementMethod": "open",
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"title": "Потужність всмоктування",
"enum": [
{
"value": 0.1,
"title": "До 1000 Вт"
},
{
"value": 0.15,
"title": "Більше 1000 Вт"
}
],
"title_en": "Air Intake",
"relatedItem": "e214fbd9ed204c9bb42f9e1f628109f8",
"featureOf": "item"
},
{
"code": "OCDS-123454-YEARS",
"description": "Кількість років, які організація учасник працює на ринку",
"title": "Років на ринку",
"enum": [
{
"value": 0.05,
"title": "До 3 років"
},
{
"value": 0.1,
"title": "Більше 3 років, менше 5 років"
},
{
"value": 0.15,
"title": "Більше 5 років"
}
],
"title_en": "Years trading",
"featureOf": "tenderer"
}
],
"enquiryPeriod": {
"startDate": "2017-07-25T17:36:55.784983+03:00",
"endDate": "2017-08-01T17:36:49.331754+03:00"
},
"submissionMethod": "electronicAuction",
"next_check": "2017-08-01T17:36:49.331754+03:00",
"awardCriteria": "lowestCost",
"owner": "broker",
"id": "e5d1cd890bd54669972755ca7e8604de",
"title": "[ТЕСТУВАННЯ] футляри до державних нагород",
"tenderID": "UA-2017-07-25-000002",
"dateModified": "2017-07-25T17:36:55.787215+03:00",
"status": "active.enquiries",
"tenderPeriod": {
"startDate": "2017-08-01T17:36:49.331754+03:00",
"endDate": "2017-08-08T17:36:49.331754+03:00"
},
"procurementMethodType": "belowThreshold",
"title_en": "[TESTING] Cases with state awards",
"date": "2017-07-25T17:36:55.785011+03:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"description_en": "Cases with state awards",
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"description_ru": "футляры к государственным наградам",
"id": "e214fbd9ed204c9bb42f9e1f628109f8",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"mode": "test",
"title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
}
}
}
And again we have 201 Created response code, Location header and body with extra id, tenderID, and dateModified properties.
Let’s check what tender registry contains:
GET /api/2.3/tenders?mode=__all__ HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"next_page": {
"path": "/api/2.3/tenders?offset=2017-07-25T17%3A36%3A55.662421%2B03%3A00",
"uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=2017-07-25T17%3A36%3A55.662421%2B03%3A00",
"offset": "2017-07-25T17:36:55.662421+03:00"
},
"data": [
{
"id": "f3641d0ba0f042e8b49de06d5c7921af",
"dateModified": "2017-07-25T17:36:55.662421+03:00"
}
]
}
And indeed we have 2 tenders now.
Modifying tender¶
Let’s update tender by supplementing it with all other essential properties:
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"tenderPeriod": {
"endDate": "2017-08-09T17:37:05.888957+03:00"
}
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"status": "active.enquiries",
"awardCriteria": "lowestCost",
"tenderPeriod": {
"startDate": "2017-08-01T17:36:49.306344+03:00",
"endDate": "2017-08-09T17:37:05.888957+03:00"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"procurementMethodType": "belowThreshold",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"submissionMethod": "electronicAuction",
"date": "2017-07-25T17:36:55.659566+03:00",
"next_check": "2017-08-01T17:36:49.306344+03:00",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"enquiryPeriod": {
"startDate": "2017-07-25T17:36:55.659520+03:00",
"endDate": "2017-08-01T17:36:49.306344+03:00"
},
"owner": "broker",
"dateModified": "2017-07-25T17:36:55.921421+03:00",
"id": "f3641d0ba0f042e8b49de06d5c7921af",
"tenderID": "UA-2017-07-25-000001"
}
}
We see the added properies have merged with existing tender data. Additionally, the dateModified property was updated to reflect the last modification datestamp.
Checking the listing again reflects the new modification date:
GET /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"next_page": {
"path": "/api/2.3/tenders?offset=2017-07-25T17%3A36%3A55.824208%2B03%3A00",
"uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=2017-07-25T17%3A36%3A55.824208%2B03%3A00",
"offset": "2017-07-25T17:36:55.824208+03:00"
},
"data": [
{
"id": "f3641d0ba0f042e8b49de06d5c7921af",
"dateModified": "2017-07-25T17:36:55.662421+03:00"
},
{
"id": "f8802ccce4d9409693ae745ea983c59a",
"dateModified": "2017-07-25T17:36:55.824208+03:00"
}
]
}
Procuring entity can set bid guarantee:
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 57
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"guarantee": {
"currency": "USD",
"amount": 8
}
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"status": "active.enquiries",
"awardCriteria": "lowestCost",
"tenderPeriod": {
"startDate": "2017-08-01T17:36:49.306344+03:00",
"endDate": "2017-08-09T17:37:05.888957+03:00"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"procurementMethodType": "belowThreshold",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"submissionMethod": "electronicAuction",
"date": "2017-07-25T17:36:55.659566+03:00",
"next_check": "2017-08-01T17:36:49.306344+03:00",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"enquiryPeriod": {
"startDate": "2017-07-25T17:36:55.659520+03:00",
"endDate": "2017-08-01T17:36:49.306344+03:00"
},
"owner": "broker",
"dateModified": "2017-07-25T17:36:56.017598+03:00",
"guarantee": {
"currency": "USD",
"amount": 8.0
},
"id": "f3641d0ba0f042e8b49de06d5c7921af",
"tenderID": "UA-2017-07-25-000001"
}
}
Uploading documentation¶
Procuring entity can upload PDF files into the created tender. Uploading should follow the Documents Uploading rules.
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 334
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=3SoLjvN%2Bubc3yUq7E%2F8z%2FT4nhwBCO%2BYejSIqF2ORk3btE1ug052zZDNQQpi4yyd1rj%2FPX09LiTVm%2BoTVYouoCg%3D%3D",
"title": "Notice.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.044656+03:00",
"id": "8c4f7355fed4463b98eb429237a2e6a5",
"dateModified": "2017-07-25T17:36:56.044677+03:00"
}
}
201 Created response code and Location header confirm document creation. We can additionally query the documents collection API endpoint to confirm the action:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.044656+03:00",
"previousVersions": [],
"id": "8c4f7355fed4463b98eb429237a2e6a5",
"dateModified": "2017-07-25T17:36:56.044677+03:00"
}
}
The single array element describes the uploaded document. We can upload more documents:
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 337
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=hL8BrNI7MEEHubwh5Eb%2BCvQZFd29l2lZAEcg8C1V42LlydVZf%2Fk%2BshwSYXfpnzT3q1JAZnAx3CaANvSWhCm%2FAA%3D%3D",
"title": "AwardCriteria.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/14f948894bcc4ddc9da4d2129b028116
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "AwardCriteria.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=ysTqp33c7XMcniHmMMRwEbzHqlh7u0B1Xody%2F3MDOvWweLLYYutsDvREJ4lJcsnLkpv9HRVECjPJt2vGmv8GBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.140078+03:00",
"id": "14f948894bcc4ddc9da4d2129b028116",
"dateModified": "2017-07-25T17:36:56.140097+03:00"
}
}
And again we can confirm that there are two documents uploaded.
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description modified",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.044656+03:00",
"author": "tender_owner",
"documentType": "technicalSpecifications",
"id": "8c4f7355fed4463b98eb429237a2e6a5",
"dateModified": "2017-07-25T17:36:56.044677+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "AwardCriteria.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=ysTqp33c7XMcniHmMMRwEbzHqlh7u0B1Xody%2F3MDOvWweLLYYutsDvREJ4lJcsnLkpv9HRVECjPJt2vGmv8GBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.140078+03:00",
"id": "14f948894bcc4ddc9da4d2129b028116",
"dateModified": "2017-07-25T17:36:56.140097+03:00"
}
]
}
Let’s add new documentType field with technicalSpecifications parameter to the previously uploaded document:
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 53
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"documentType": "technicalSpecifications"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.044656+03:00",
"documentType": "technicalSpecifications",
"id": "8c4f7355fed4463b98eb429237a2e6a5",
"dateModified": "2017-07-25T17:36:56.044677+03:00"
}
}
Success! Response code is 200 OK and it confirms that documentType field with technicalSpecifications parameter was added .
Now let’s try to modify any field in our document. For example, description:
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 58
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"description": "document description modified"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"description": "document description modified",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.044656+03:00",
"author": "tender_owner",
"documentType": "technicalSpecifications",
"id": "8c4f7355fed4463b98eb429237a2e6a5",
"dateModified": "2017-07-25T17:36:56.044677+03:00"
}
}
200 OK response was returned. The description was modified successfully.
In case we made an error, we can reupload the document over the older version:
PUT /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/14f948894bcc4ddc9da4d2129b028116?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 337
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=EC1QzFOXAe%2BawGOy%2FJR3YMrURSrxoUXQMtC%2BIIrTcHlCcL26Uj1%2BSbggyBg1H87VOEn9EBtEgBde0s8zxohcDQ%3D%3D",
"title": "AwardCriteria-2.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "AwardCriteria-2.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=76AeflAK4BuZ734jGky7PBC9Tk3HAmi6UmSE1ElFiy2jLkYGA1%2FMdT7NIF7Hto%2F5PmrqAktZ%2FYovZYW6QptFBg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.140078+03:00",
"id": "14f948894bcc4ddc9da4d2129b028116",
"dateModified": "2017-07-25T17:36:56.181719+03:00"
}
}
And we can see that it is overriding the original version:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description modified",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.044656+03:00",
"author": "tender_owner",
"documentType": "technicalSpecifications",
"id": "8c4f7355fed4463b98eb429237a2e6a5",
"dateModified": "2017-07-25T17:36:56.044677+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "AwardCriteria-2.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=76AeflAK4BuZ734jGky7PBC9Tk3HAmi6UmSE1ElFiy2jLkYGA1%2FMdT7NIF7Hto%2F5PmrqAktZ%2FYovZYW6QptFBg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.140078+03:00",
"id": "14f948894bcc4ddc9da4d2129b028116",
"dateModified": "2017-07-25T17:36:56.181719+03:00"
}
]
}
Enquiries¶
When tender is in active.enquiry status, interested parties can ask questions:
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.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; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions/e2e6900f65434252a75741613fe0703b
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137226",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title": "Калорійність",
"date": "2017-07-25T17:36:56.229819+03:00",
"id": "e2e6900f65434252a75741613fe0703b",
"questionOf": "tender"
}
}
Procuring entity can answer them:
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions/e2e6900f65434252a75741613fe0703b?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"dateAnswered": "2017-07-25T17:36:56.273608+03:00",
"title": "Калорійність",
"date": "2017-07-25T17:36:56.229819+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "e2e6900f65434252a75741613fe0703b",
"questionOf": "tender"
}
}
And one can retrieve the questions list:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"description": "Просимо додати таблицю потрібної калорійності харчування",
"dateAnswered": "2017-07-25T17:36:56.273608+03:00",
"title": "Калорійність",
"date": "2017-07-25T17:36:56.229819+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "e2e6900f65434252a75741613fe0703b",
"questionOf": "tender"
}
]
}
And individual answer:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions/e2e6900f65434252a75741613fe0703b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"dateAnswered": "2017-07-25T17:36:56.273608+03:00",
"title": "Калорійність",
"date": "2017-07-25T17:36:56.229819+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "e2e6900f65434252a75741613fe0703b",
"questionOf": "tender"
}
}
Registering bid¶
Step-by-step registration¶
When Tender.tenderingPeriod.startDate
comes, Tender switches to active.tendering status that allows registration of bids.
Bidder can register a bid in draft status:
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 757
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "draft",
"value": {
"amount": 500
},
"tenderers": [
{
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
]
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194
{
"access": {
"token": "1570f17a0a084e29aad2dc9a600e5589"
},
"data": {
"date": "2017-07-25T17:36:56.363108+03:00",
"status": "draft",
"id": "ba18d19f2a3948deb997a7a55dd2f194",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"tenderers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
]
}
}
And activate a bid:
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194?acc_token=1570f17a0a084e29aad2dc9a600e5589 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"date": "2017-07-25T17:36:56.363108+03:00",
"status": "active",
"id": "ba18d19f2a3948deb997a7a55dd2f194",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"tenderers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
]
}
}
And upload proposal document:
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents?acc_token=1570f17a0a084e29aad2dc9a600e5589 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 332
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/9dbee8d173ea4ce0a507c196ee39bf54?KeyID=459f8ecf&Signature=rZYCyINjYNoMJTwUJ1IQ8jTR%2FXiOIAnsLI2fN%2BsEtG8mxyoYq3RiXCYmE%2BZIsQWV4W6gszc8aC2s7lhV%2FxerBw%3D%3D",
"title": "Proposal.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents/2d439b94c3de42e28bb10c9d9576fd27
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents/2d439b94c3de42e28bb10c9d9576fd27?download=9dbee8d173ea4ce0a507c196ee39bf54",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.467858+03:00",
"id": "2d439b94c3de42e28bb10c9d9576fd27",
"dateModified": "2017-07-25T17:36:56.467877+03:00"
}
}
It is possible to check the uploaded documents:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents?acc_token=1570f17a0a084e29aad2dc9a600e5589 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents/2d439b94c3de42e28bb10c9d9576fd27?download=9dbee8d173ea4ce0a507c196ee39bf54",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.467858+03:00",
"id": "2d439b94c3de42e28bb10c9d9576fd27",
"dateModified": "2017-07-25T17:36:56.467877+03:00"
}
]
}
Batch-mode registration¶
Register bid with documents using one request:
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1365
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"documents": [
{
"url": "http://public.docs-sandbox.openprocurement.org/get/331460f91e944a2d83136dee00b94f0f?KeyID=459f8ecf&Signature=TNOpuGEGleAHWS8gmR6mYc9O7e%2BEo2o28db4dVIaESJzcMyQVdTvA9xrfkzNXRGTlP2KUUpib8Bpk3rke2KkDg%3D%3D",
"title": "Proposal_part1.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
},
{
"url": "http://public.docs-sandbox.openprocurement.org/get/3bfc49d63bd44e9488e1270003e52178?KeyID=459f8ecf&Signature=JXeIpHZQQo57b67ncruZEOHjEFrAtoW3GHrmDN4U2vOySIRAS9Hr5VrFh8BDZyhaYsiXjfqcCFWnxCxcPzdpBw%3D%3D",
"title": "Proposal_part2.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
],
"value": {
"amount": 499
},
"tenderers": [
{
"contactPoint": {
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк",
"email": "aagt@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"countryName": "Україна",
"postalCode": "79013",
"region": "м. Львів",
"streetAddress": "вул. Островського, 34",
"locality": "м. Львів"
}
}
]
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3
{
"access": {
"token": "22d01413f6604999a61b174fabe6ffe2"
},
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3/documents/df9dd9b2c3a94843872c990a919137b7?download=331460f91e944a2d83136dee00b94f0f",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.537226+03:00",
"id": "df9dd9b2c3a94843872c990a919137b7",
"dateModified": "2017-07-25T17:36:56.537243+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3/documents/89daa7ea804c40febcbc83bed93587ea?download=3bfc49d63bd44e9488e1270003e52178",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.537686+03:00",
"id": "89daa7ea804c40febcbc83bed93587ea",
"dateModified": "2017-07-25T17:36:56.537703+03:00"
}
],
"value": {
"currency": "UAH",
"amount": 499.0,
"valueAddedTaxIncluded": true
},
"tenderers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"date": "2017-07-25T17:36:56.536644+03:00",
"id": "bfa4b4a0f47f4270b5f139307e217ec3"
}
}
Auction¶
After auction is scheduled anybody can visit it to watch. The auction can be reached at Tender.auctionUrl:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"auctionUrl": "http://auction-sandbox.openprocurement.org/tenders/f3641d0ba0f042e8b49de06d5c7921af",
"enquiryPeriod": {
"startDate": "2017-07-11T17:36:49.306344+03:00",
"endDate": "2017-07-18T17:36:49.306344+03:00"
},
"submissionMethod": "electronicAuction",
"next_check": "2017-07-25T18:12:49.306344+03:00",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"questions": [
{
"description": "Просимо додати таблицю потрібної калорійності харчування",
"dateAnswered": "2017-07-25T17:36:56.273608+03:00",
"title": "Калорійність",
"date": "2017-07-25T17:36:56.229819+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "e2e6900f65434252a75741613fe0703b",
"questionOf": "tender"
}
],
"owner": "broker",
"id": "f3641d0ba0f042e8b49de06d5c7921af",
"guarantee": {
"currency": "USD",
"amount": 8.0
},
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description modified",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.044656+03:00",
"author": "tender_owner",
"documentType": "technicalSpecifications",
"id": "8c4f7355fed4463b98eb429237a2e6a5",
"dateModified": "2017-07-25T17:36:56.044677+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "AwardCriteria.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=ysTqp33c7XMcniHmMMRwEbzHqlh7u0B1Xody%2F3MDOvWweLLYYutsDvREJ4lJcsnLkpv9HRVECjPJt2vGmv8GBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.140078+03:00",
"id": "14f948894bcc4ddc9da4d2129b028116",
"dateModified": "2017-07-25T17:36:56.140097+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "AwardCriteria-2.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=76AeflAK4BuZ734jGky7PBC9Tk3HAmi6UmSE1ElFiy2jLkYGA1%2FMdT7NIF7Hto%2F5PmrqAktZ%2FYovZYW6QptFBg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.140078+03:00",
"id": "14f948894bcc4ddc9da4d2129b028116",
"dateModified": "2017-07-25T17:36:56.181719+03:00"
}
],
"title": "футляри до державних нагород",
"tenderID": "UA-2017-07-25-000001",
"dateModified": "2017-07-25T17:36:56.710634+03:00",
"status": "active.auction",
"tenderPeriod": {
"startDate": "2017-07-18T17:36:49.306344+03:00",
"endDate": "2017-07-25T17:36:49.306344+03:00"
},
"auctionPeriod": {
"startDate": "2017-07-25T17:36:49.306344+03:00",
"shouldStartAfter": "2017-07-26T00:00:00+03:00"
},
"procurementMethodType": "belowThreshold",
"date": "2017-07-25T17:36:55.659566+03:00",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"awardCriteria": "lowestCost"
}
}
And bidders can find out their participation URLs via their bids:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194?acc_token=1570f17a0a084e29aad2dc9a600e5589 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents/2d439b94c3de42e28bb10c9d9576fd27?download=9dbee8d173ea4ce0a507c196ee39bf54",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.467858+03:00",
"id": "2d439b94c3de42e28bb10c9d9576fd27",
"dateModified": "2017-07-25T17:36:56.467877+03:00"
}
],
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"tenderers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"date": "2017-07-25T17:36:56.363108+03:00",
"id": "ba18d19f2a3948deb997a7a55dd2f194",
"participationUrl": "http://auction-sandbox.openprocurement.org/tenders/f3641d0ba0f042e8b49de06d5c7921af?key_for_bid=ba18d19f2a3948deb997a7a55dd2f194"
}
}
See the Bid.participationUrl in the response. Similar, but different, URL can be retrieved for other participants:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3?acc_token=22d01413f6604999a61b174fabe6ffe2 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part1.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3/documents/df9dd9b2c3a94843872c990a919137b7?download=331460f91e944a2d83136dee00b94f0f",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.537226+03:00",
"id": "df9dd9b2c3a94843872c990a919137b7",
"dateModified": "2017-07-25T17:36:56.537243+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "Proposal_part2.pdf",
"url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3/documents/89daa7ea804c40febcbc83bed93587ea?download=3bfc49d63bd44e9488e1270003e52178",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.537686+03:00",
"id": "89daa7ea804c40febcbc83bed93587ea",
"dateModified": "2017-07-25T17:36:56.537703+03:00"
}
],
"value": {
"currency": "UAH",
"amount": 499.0,
"valueAddedTaxIncluded": true
},
"tenderers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"date": "2017-07-25T17:36:56.536644+03:00",
"id": "bfa4b4a0f47f4270b5f139307e217ec3",
"participationUrl": "http://auction-sandbox.openprocurement.org/tenders/f3641d0ba0f042e8b49de06d5c7921af?key_for_bid=bfa4b4a0f47f4270b5f139307e217ec3"
}
}
Confirming qualification¶
Qualification comission registers its decision via the following call:
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/awards/f81f540a2df94c529cdea7cf197b5038?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"complaintPeriod": {
"startDate": "2017-07-25T17:36:57.009762+03:00",
"endDate": "2017-07-27T17:36:57.134318+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"bid_id": "bfa4b4a0f47f4270b5f139307e217ec3",
"value": {
"currency": "UAH",
"amount": 499.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:57.138607+03:00",
"id": "f81f540a2df94c529cdea7cf197b5038"
}
}
Setting contract value¶
By default contract value is set based on the award, but there is a possibility to set custom contract value.
If you want to lower contract value, you can insert new one into the amount field.
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 73
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"contractNumber": "contract #13111",
"value": {
"amount": 238
}
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"suppliers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"contractNumber": "contract #13111",
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:57.134377+03:00",
"awardID": "f81f540a2df94c529cdea7cf197b5038",
"id": "54a174a38f174fb3802e573a9adc66ef",
"contractID": "UA-2017-07-25-000001-1"
}
}
200 OK response was returned. The value was modified successfully.
Setting contract signature date¶
There is a possibility to set custom contract signature date. You can insert appropriate date into the dateSigned field.
If this date is not set, it will be auto-generated on the date of contract registration.
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 60
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"dateSigned": "2017-07-25T17:36:57.724072+03:00"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:57.534210+03:00",
"id": "7fbb37c72038487ea8e66c27da3dac2b",
"dateModified": "2017-07-25T17:36:57.534229+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=sfBQXr48pj4%2FqodFIsxDFzY%2FIkbD7uMFkmZ%2F95OfLvQvtVbVfV056nR%252BbuchmaYFApJfmspyVFlVWRwNSB6rDA%253D%253D",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:57.643439+03:00",
"id": "402f10f3b56f47168f47abfd075676c8",
"dateModified": "2017-07-25T17:36:57.643460+03:00"
}
],
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"suppliers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"contractNumber": "contract #13111",
"period": {
"startDate": "2017-07-25T17:36:49.331754+03:00",
"endDate": "2018-07-25T17:36:49.331754+03:00"
},
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"dateSigned": "2017-07-25T17:36:57.724072+03:00",
"date": "2017-07-25T17:36:57.134377+03:00",
"awardID": "f81f540a2df94c529cdea7cf197b5038",
"id": "54a174a38f174fb3802e573a9adc66ef",
"contractID": "UA-2017-07-25-000001-1"
}
}
Setting contract validity period¶
Setting contract validity period is optional, but if it is needed, you can set appropriate startDate and endDate.
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 106
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"period": {
"startDate": "2017-07-25T17:36:49.331754",
"endDate": "2018-07-25T17:36:49.331754"
}
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"suppliers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"contractNumber": "contract #13111",
"period": {
"startDate": "2017-07-25T17:36:49.331754+03:00",
"endDate": "2018-07-25T17:36:49.331754+03:00"
},
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"dateSigned": "2017-07-25T17:36:57.325183+03:00",
"date": "2017-07-25T17:36:57.134377+03:00",
"awardID": "f81f540a2df94c529cdea7cf197b5038",
"id": "54a174a38f174fb3802e573a9adc66ef",
"contractID": "UA-2017-07-25-000001-1"
}
}
Uploading contract documentation¶
You can upload contract documents. Let’s upload contract document:
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 344
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=i5sHgwSiMfgqUfXlpZdQecZT5mUbIMtSpWhlnZ3UNmBGcYz61cWRSy4t%2FsY1RZjXuKfucViJulmAoeiVnHPFAw%3D%3D",
"title": "contract_first_document.doc",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents/7fbb37c72038487ea8e66c27da3dac2b
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:57.534210+03:00",
"id": "7fbb37c72038487ea8e66c27da3dac2b",
"dateModified": "2017-07-25T17:36:57.534229+03:00"
}
}
201 Created response code and Location header confirm document was added.
Let’s see the list of contract documents:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:57.534210+03:00",
"id": "7fbb37c72038487ea8e66c27da3dac2b",
"dateModified": "2017-07-25T17:36:57.534229+03:00"
}
]
}
We can add another contract document:
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 353
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=%2FX5%2FjNT6bkqCZyl19ZVptb61xQbNg%2FY60bSEcwDSAPoGu8Jc0ymikk7DaCAWERcR35gqbAlwk9AO1R%2B%2BUUJaBQ%3D%3D",
"title": "contract_second_document.doc",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents/402f10f3b56f47168f47abfd075676c8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=sfBQXr48pj4%2FqodFIsxDFzY%2FIkbD7uMFkmZ%2F95OfLvQvtVbVfV056nR%252BbuchmaYFApJfmspyVFlVWRwNSB6rDA%253D%253D",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:57.643439+03:00",
"id": "402f10f3b56f47168f47abfd075676c8",
"dateModified": "2017-07-25T17:36:57.643460+03:00"
}
}
201 Created response code and Location header confirm second document was uploaded.
Let’s see the list of all added contract documents:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:57.534210+03:00",
"id": "7fbb37c72038487ea8e66c27da3dac2b",
"dateModified": "2017-07-25T17:36:57.534229+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=sfBQXr48pj4%2FqodFIsxDFzY%2FIkbD7uMFkmZ%2F95OfLvQvtVbVfV056nR%252BbuchmaYFApJfmspyVFlVWRwNSB6rDA%253D%253D",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:57.643439+03:00",
"id": "402f10f3b56f47168f47abfd075676c8",
"dateModified": "2017-07-25T17:36:57.643460+03:00"
}
]
}
Set contract signature date¶
There is a possibility to set custom contract signature date. If the date is not set it will be generated on contract registration.
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 60
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"dateSigned": "2017-07-25T17:36:57.724072+03:00"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "pending",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:57.534210+03:00",
"id": "7fbb37c72038487ea8e66c27da3dac2b",
"dateModified": "2017-07-25T17:36:57.534229+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=sfBQXr48pj4%2FqodFIsxDFzY%2FIkbD7uMFkmZ%2F95OfLvQvtVbVfV056nR%252BbuchmaYFApJfmspyVFlVWRwNSB6rDA%253D%253D",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:57.643439+03:00",
"id": "402f10f3b56f47168f47abfd075676c8",
"dateModified": "2017-07-25T17:36:57.643460+03:00"
}
],
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"suppliers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"contractNumber": "contract #13111",
"period": {
"startDate": "2017-07-25T17:36:49.331754+03:00",
"endDate": "2018-07-25T17:36:49.331754+03:00"
},
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"dateSigned": "2017-07-25T17:36:57.724072+03:00",
"date": "2017-07-25T17:36:57.134377+03:00",
"awardID": "f81f540a2df94c529cdea7cf197b5038",
"id": "54a174a38f174fb3802e573a9adc66ef",
"contractID": "UA-2017-07-25-000001-1"
}
}
Contract registration¶
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/contracts/54a174a38f174fb3802e573a9adc66ef?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_first_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/c2f1cfdef4ac4d9d9bc34f5cad1ce25d?KeyID=459f8ecf&Signature=8jHN%2FRFnicVD3L77%2FK3DG57f5TUp7JT3YSJNVADYk3Jukk1ixxVF%2FxEFfWn5OAxgea9TjRZipM1RVdany7pNBw%253D%253D",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:57.534210+03:00",
"id": "7fbb37c72038487ea8e66c27da3dac2b",
"dateModified": "2017-07-25T17:36:57.534229+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"title": "contract_second_document.doc",
"url": "http://public.docs-sandbox.openprocurement.org/get/978e15c1b71f48b3a271b8390b86ce80?KeyID=459f8ecf&Signature=sfBQXr48pj4%2FqodFIsxDFzY%2FIkbD7uMFkmZ%2F95OfLvQvtVbVfV056nR%252BbuchmaYFApJfmspyVFlVWRwNSB6rDA%253D%253D",
"format": "application/msword",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:57.643439+03:00",
"id": "402f10f3b56f47168f47abfd075676c8",
"dateModified": "2017-07-25T17:36:57.643460+03:00"
}
],
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"suppliers": [
{
"contactPoint": {
"email": "aagt@gmail.com",
"telephone": "+380 (322) 91-69-30",
"name": "Андрій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137226",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Книга»",
"address": {
"postalCode": "79013",
"countryName": "Україна",
"streetAddress": "вул. Островського, 34",
"region": "м. Львів",
"locality": "м. Львів"
}
}
],
"contractNumber": "contract #13111",
"period": {
"startDate": "2017-07-25T17:36:49.331754+03:00",
"endDate": "2018-07-25T17:36:49.331754+03:00"
},
"value": {
"currency": "UAH",
"amount": 238.0,
"valueAddedTaxIncluded": true
},
"dateSigned": "2017-07-25T17:36:57.724072+03:00",
"date": "2017-07-25T17:36:57.901656+03:00",
"awardID": "f81f540a2df94c529cdea7cf197b5038",
"id": "54a174a38f174fb3802e573a9adc66ef",
"contractID": "UA-2017-07-25-000001-1"
}
}
Cancelling tender¶
Tender creator can cancel tender anytime (except when tender has terminal status e.g. usuccesfull, canceled, complete).
The following steps should be applied:
- Prepare cancellation request
- Fill it with the protocol describing the cancellation reasons
- Cancel the tender with the reasons prepared.
Only the request that has been activated (3rd step above) has power to cancel tender. I.e. you have to not only prepare cancellation request but to activate it as well.
See Cancellation data structure for details.
Preparing the cancellation request¶
You should pass reason, status defaults to pending. id is autogenerated and passed in the Location header of response.
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"reason": "cancellation reason"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873
{
"data": {
"date": "2017-07-25T17:36:58.034107+03:00",
"status": "pending",
"reason": "cancellation reason",
"cancellationOf": "tender",
"id": "8e1908a8ada64ae19ebfa4f2fdd7d873"
}
}
Filling cancellation with protocol and supplementary documentation¶
Upload the file contents
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 322
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/0a4e09e6e3ac4591a91431586bfec51b?KeyID=459f8ecf&Signature=QpcrFFfy9aG4sgHieujyWnjL4ZwH8QFQGpF1JBRo05nDMckRIq6cqW6X2FdHmVjcXWV1LvpYdUaquAxmY1OrBg%3D%3D",
"title": "Notice.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873/documents/56d80bbae8ab41e196922d137c87e20d
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/0a4e09e6e3ac4591a91431586bfec51b?KeyID=459f8ecf&Signature=l7LFxrLX0mB5IFVRX8TZccYKe21EcCllwvCWGH7RdEYrzhMaLep8J9Ae2F5VzMj566FeEGIqh6Cy5wzNVWmPDg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:58.123830+03:00",
"id": "56d80bbae8ab41e196922d137c87e20d",
"dateModified": "2017-07-25T17:36:58.123851+03:00"
}
}
Change the document description and other properties
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873/documents/56d80bbae8ab41e196922d137c87e20d?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 48
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"description": "Changed description"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"description": "Changed description",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/0a4e09e6e3ac4591a91431586bfec51b?KeyID=459f8ecf&Signature=l7LFxrLX0mB5IFVRX8TZccYKe21EcCllwvCWGH7RdEYrzhMaLep8J9Ae2F5VzMj566FeEGIqh6Cy5wzNVWmPDg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:58.123830+03:00",
"id": "56d80bbae8ab41e196922d137c87e20d",
"dateModified": "2017-07-25T17:36:58.123851+03:00"
}
}
Upload new version of the document
PUT /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873/documents/56d80bbae8ab41e196922d137c87e20d?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 328
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/d19863828f684b8393cd9907f2bcb84c?KeyID=459f8ecf&Signature=g6c3S5r43owtO3ERE72E0X6gFjUH9IXXqDEYEAjtDEV3qjaZ7OObLssBCsOg2bZ79nq%2FBZ2H9kmdC7ViVhK%2BAQ%3D%3D",
"title": "Notice-2.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"description": "Changed description",
"title": "Notice-2.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/d19863828f684b8393cd9907f2bcb84c?KeyID=459f8ecf&Signature=OQ48HntXEVhqTjhaHm0k7h7hcQ1fjG0otkUT%2F31%252Bz4gToAobjILCREgVN14ja5Pa0Y3t3o%2FMjeDLaI7V77fRCw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:58.123830+03:00",
"id": "56d80bbae8ab41e196922d137c87e20d",
"dateModified": "2017-07-25T17:36:58.317900+03:00"
}
}
Activating the request and cancelling tender¶
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/cancellations/8e1908a8ada64ae19ebfa4f2fdd7d873?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"description": "Changed description",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/0a4e09e6e3ac4591a91431586bfec51b?KeyID=459f8ecf&Signature=l7LFxrLX0mB5IFVRX8TZccYKe21EcCllwvCWGH7RdEYrzhMaLep8J9Ae2F5VzMj566FeEGIqh6Cy5wzNVWmPDg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:58.123830+03:00",
"id": "56d80bbae8ab41e196922d137c87e20d",
"dateModified": "2017-07-25T17:36:58.123851+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"description": "Changed description",
"title": "Notice-2.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/d19863828f684b8393cd9907f2bcb84c?KeyID=459f8ecf&Signature=OQ48HntXEVhqTjhaHm0k7h7hcQ1fjG0otkUT%2F31%252Bz4gToAobjILCREgVN14ja5Pa0Y3t3o%2FMjeDLaI7V77fRCw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:58.123830+03:00",
"id": "56d80bbae8ab41e196922d137c87e20d",
"dateModified": "2017-07-25T17:36:58.317900+03:00"
}
],
"reason": "cancellation reason",
"date": "2017-07-25T17:36:58.421729+03:00",
"cancellationOf": "tender",
"id": "8e1908a8ada64ae19ebfa4f2fdd7d873"
}
}
Data Standard¶
Data standard is modelled along the Open Contracting Standard with extensions in areas that were not covered by it.
Tender¶
Schema¶
title: | string, multilingual The name of the tender, displayed in listings. You can include the following items:
|
||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
description: | string, multilingual Detailed description of tender. |
||||||||||||||||||||||
tenderID: | string, auto-generated, read-only The tender identifier to refer tender to in “paper” documentation. OpenContracting Description: TenderID should always be the same as the OCID. It is included to make the flattened data structure more convenient. |
||||||||||||||||||||||
procuringEntity: | |||||||||||||||||||||||
ProcuringEntity, required Organization conducting the tender. OpenContracting Description: The entity managing the procurement, which may be different from the buyer who is paying / using the items being procured. |
|||||||||||||||||||||||
value: | Value, required Total available tender budget. Bids greater then OpenContracting Description: The total estimated value of the procurement. |
||||||||||||||||||||||
guarantee: |
Bid guarantee |
||||||||||||||||||||||
date: | string, Date, auto-generated |
||||||||||||||||||||||
items: | list of Item objects, required List that contains single item being procured. OpenContracting Description: The goods and services to be purchased, broken into line items wherever possible. Items should not be duplicated, but a quantity of 2 specified instead. |
||||||||||||||||||||||
features: | list of Feature objects Features of tender. |
||||||||||||||||||||||
documents: | List of Document objects OpenContracting Description: All documents and attachments related to the tender. |
||||||||||||||||||||||
questions: | List of Question objects Questions to |
||||||||||||||||||||||
complaints: | List of Complaint objects Complaints to tender conditions and their resolutions. |
||||||||||||||||||||||
bids: | List of Bid objects A list of all bids placed in the tender with information about tenderers, their proposal and other qualification documentation. OpenContracting Description: A list of all the companies who entered submissions for the tender. |
||||||||||||||||||||||
minimalStep: | Value, required The minimal step of auction (reduction). Validation rules:
|
||||||||||||||||||||||
awards: | List of Award objects All qualifications (disqualifications and awards). |
||||||||||||||||||||||
contracts: | List of Contract objects |
||||||||||||||||||||||
enquiryPeriod: | Period, required Period when questions are allowed. At least endDate has to be provided. OpenContracting Description: The period during which enquiries may be made and will be answered. |
||||||||||||||||||||||
tenderPeriod: | Period, required Period when bids can be submitted. At least endDate has to be provided. OpenContracting Description: The period when the tender is open for submissions. The end date is the closing date for tender submissions. |
||||||||||||||||||||||
auctionPeriod: | Period, read-only Period when Auction is conducted. |
||||||||||||||||||||||
auctionUrl: | url A web address for view auction. |
||||||||||||||||||||||
awardPeriod: | Period, read-only Awarding process period. OpenContracting Description: The date or period on which an award is anticipated to be made. |
||||||||||||||||||||||
status: | string
Status of the Tender. |
||||||||||||||||||||||
lots: | List of Lot objects. Contains all tender lots. |
||||||||||||||||||||||
cancellations: | List of Cancellation objects. Contains 1 object with active status in case of cancelled Tender. The Cancellation object describes the reason of tender cancellation contains accompanying documents if any. |
||||||||||||||||||||||
funders: | List of Organization objects. Optional field. The funder is an entity providing money or finance for contracting process. |
||||||||||||||||||||||
revisions: | List of Revision objects, auto-generated Historical changes to Tender object properties. |
Important
The Tender dates should be sequential:
- Current time
- enquiryPeriod.startDate
- enquiryPeriod.endDate
- tenderPeriod.startDate
- tenderPeriod.endDate
Organization¶
Schema¶
name: | string, multilingual OpenContracting Description: The common name of the organization. |
---|---|
identifier: |
OpenContracting Description: The primary identifier for this organization. |
additionalIdentifiers: | |
List of Identifier objects |
|
address: | Address, required |
contactPoint: | ContactPoint, required |
Identifier¶
Schema¶
scheme: | string OpenContracting Description: Organization identifiers be drawn from an existing identification scheme. This field is used to indicate the scheme or codelist in which the identifier will be found. This value should be drawn from the Organization Identifier Scheme. |
---|---|
id: | string, required OpenContracting Description: The identifier of the organization in the selected scheme. The allowed codes are the ones found in “Organisation Registration Agency” codelist of IATI Standard with addition of UA-EDR code for organizations registered in Ukraine (EDRPOU and IPN). |
legalName: | string, multilingual OpenContracting Description: The legally registered name of the organization. |
uri: | uri OpenContracting Description: A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the url field of the Organization contact point. |
Address¶
Schema¶
streetAddress: | string OpenContracting Description: The street address. For example, 1600 Amphitheatre Pkwy. |
---|---|
locality: | string OpenContracting Description: The locality. For example, Mountain View. |
region: | string OpenContracting Description: The region. For example, CA. |
postalCode: | string OpenContracting Description: The postal code. For example, 94043. |
countryName: | string, multilingual, required OpenContracting Description: The country name. For example, United States. |
ContactPoint¶
Schema¶
name: | string, multilingual, required OpenContracting Description: The name of the contact person, department, or contact point, for correspondence relating to this contracting process. |
---|---|
email: | OpenContracting Description: The e-mail address of the contact point/person. |
telephone: | string OpenContracting Description: The telephone number of the contact point/person. This should include the international dialling code. |
faxNumber: | string OpenContracting Description: The fax number of the contact point/person. This should include the international dialling code. |
url: | url OpenContracting Description: A web address for the contact point/person. |
Either email or telephone field has to be provided.
Item¶
Schema¶
id: | string, auto-generated |
||||||
---|---|---|---|---|---|---|---|
description: | string, multilingual, required OpenContracting Description: A description of the goods, services to be provided. |
||||||
classification: |
OpenContracting Description: The primary classification for the item. See the itemClassificationScheme to identify preferred classification lists, including CPV and GSIN. It is mandatory for classification.scheme to be CPV or ДК021. The classification.id should be valid CPV or ДК021 code. |
||||||
additionalClassifications: | |||||||
List of Classification objects OpenContracting Description: An array of additional classifications for the item. See the itemClassificationScheme codelist for common options to use in OCDS. This may also be used to present codes from an internal classification scheme. It is mandatory to have at least one item with ДКПП as scheme. |
|||||||
unit: |
OpenContracting Description: Description of the unit which the good comes in e.g. hours, kilograms. Made up of a unit name, and the value of a single unit. |
||||||
quantity: | integer OpenContracting Description: The number of units required |
||||||
deliveryDate: |
Period during which the item should be delivered. |
||||||
deliveryAddress: | |||||||
Address, where the item should be delivered. |
|||||||
deliveryLocation: | |||||||
dictionary Geographical coordinates of delivery location. Element consist of the following items:
deliveryLocation usually takes precedence over deliveryAddress if both are present. |
|||||||
relatedLot: | string Id of related Lot. |
Classification¶
Schema¶
scheme: | string OpenContracting Description: A classification should be drawn from an existing scheme or list of codes. This field is used to indicate the scheme/codelist from which the classification is drawn. For line item classifications, this value should represent a known Item Classification Scheme wherever possible. |
---|---|
id: | string OpenContracting Description: The classification code drawn from the selected scheme. |
description: | string OpenContracting Description: A textual description or title for the code. |
uri: | uri OpenContracting Description: A URI to identify the code. In the event individual URIs are not available for items in the identifier scheme this value should be left blank. |
Unit¶
Schema¶
code: | string, required UN/CEFACT Recommendation 20 unit code. |
---|---|
name: | string OpenContracting Description: Name of the unit |
Document¶
Schema¶
id: | string, auto-generated |
---|---|
documentType: | string Possible values for Tender
Possible values for Award
Possible values for Contract
Possible values for Bid
|
title: | string, multilingual OpenContracting Description: The document title. |
description: | string, multilingual OpenContracting Description: A short description of the document. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document. |
format: | string OpenContracting Description: The format of the document taken from the IANA Media Types code list, with the addition of one extra value for ‘offline/print’, used when this document entry is being used to describe the offline publication of a document. |
url: | string, auto-generated OpenContracting Description: Direct link to the document or attachment. |
datePublished: | string, Date OpenContracting Description: The date on which the document was first published. |
dateModified: | string, Date OpenContracting Description: Date that the document was last modified |
language: | string OpenContracting Description: Specifies the language of the linked document using either two-digit ISO 639-1, or extended BCP47 language tags. |
documentOf: | string Possible values are:
|
relatedItem: | string |
Lot¶
Schema¶
id: | string, auto-generated |
||||||||
---|---|---|---|---|---|---|---|---|---|
title: | string, multilingual The name of the tender lot. |
||||||||
description: | string, multilingual Detailed description of tender lot. |
||||||||
value: | Value, required Total available tender lot budget. Bids greater then |
||||||||
guarantee: |
Bid guarantee |
||||||||
date: | string, Date, auto-generated |
||||||||
minimalStep: | Value, required The minimal step of auction (reduction). Validation rules:
|
||||||||
auctionPeriod: | Period, read-only Period when Auction is conducted. |
||||||||
auctionUrl: | url A web address for view auction. |
||||||||
status: | string
Status of the Lot. |
Bid¶
Schema¶
tenderers: | List of Organization objects |
---|---|
date: | string, Date, auto-generated |
id: | uid, auto-generated |
status: | string Possible values are:
|
value: | Value, required Validation rules:
|
documents: | List of Document objects |
parameters: | List of Parameter objects |
lotValues: | List of LotValue objects |
participationUrl: | |
url A web address for participation in auction. |
Parameter¶
Schema¶
code: | string, required Code of the feature. |
---|---|
value: | float, required Value of the feature. |
LotValue¶
Schema¶
value: | Value, required Validation rules:
|
---|---|
relatedLot: | string Id of related Lot. |
date: | string, Date, auto-generated |
participationUrl: | |
url A web address for participation in auction. |
Award¶
Schema¶
id: | string, auto-generated, read-only OpenContracting Description: The identifier for this award. |
---|---|
bid_id: | string, auto-generated, read-only The Id of a bid that the award relates to. |
title: | string, multilingual OpenContracting Description: Award title. |
description: | string, multilingual OpenContracting Description: Award description. |
status: | string OpenContracting Description: The current status of the award drawn from the awardStatus codelist. Possible values are:
|
date: | string, Date, auto-generated, read-only OpenContracting Description: The date of the contract award. |
value: | Value object, auto-generated, read-only OpenContracting Description: The total value of this award. |
suppliers: | List of Organization objects, auto-generated, read-only OpenContracting Description: The suppliers awarded with this award. |
items: | List of Item objects, auto-generated, read-only OpenContracting Description: The goods and services awarded in this award, broken into line items wherever possible. Items should not be duplicated, but the quantity specified instead. |
documents: | List of Document objects OpenContracting Description: All documents and attachments related to the award, including any notices. |
complaints: | List of Complaint objects |
complaintPeriod: | |
The timeframe when complaints can be submitted. |
|
lotID: | string Id of related Lot. |
Question¶
Schema¶
id: | uid, auto-generated |
---|---|
author: | Organization, required Who is asking a question (contactPoint - person, identification - organization that person represents). |
title: | string, required Title of the question. |
description: | string Description of the question. |
date: | string, Date, auto-generated Date of posting. |
dateAnswered: | string, Date, auto-generated Date when answer has been provided. |
answer: | string Answer for the question asked. |
questionOf: | string Possible values are:
|
relatedItem: | string |
Complaint¶
Schema¶
id: | uid, auto-generated |
---|---|
author: | Organization, required Organization filing a complaint (contactPoint - person, identification - organization that person represents). |
title: | string, required Title of the complaint. |
description: | Description of the issue. |
date: | string, Date, auto-generated Date of posting. |
dateSubmitted: | string, Date, auto-generated Date when claim was submitted. |
dateAnswered: | string, Date, auto-generated Date when Procuring entity answered the claim. |
dateEscalated: | string, Date, auto-generated Date of claim to complaint escalation. |
dateDecision: | string, Date, auto-generated Date of complaint decision. |
dateCanceled: | string, Date, auto-generated Date of cancelling. |
status: | string Possible values are:
|
type: | string Possible values of type are:
|
resolution: | string Resolution of Procuring entity. |
resolutionType: | string Possible values of resolution type are:
|
satisfied: | bool Claim is satisfied? |
decision: | string Reviewer decision. |
cancellationReason: | |
string Cancellation reason. |
|
documents: | List of Document objects |
relatedLot: | string Id of related Lot. |
tendererAction: | string Tenderer action. |
tendererActionDate: | |
string, Date, auto-generated Date of tenderer action. |
Contract¶
Schema¶
id: | uid, auto-generated OpenContracting Description: The identifier for this contract. |
---|---|
awardID: | string, required OpenContracting Description: The Award.id against which this contract is being issued. |
contractID: | string, auto-generated, read-only |
contractNumber: | string |
title: | string, required OpenContracting Description: Contract title |
description: | string OpenContracting Description: Contract description |
value: | Value object, auto-generated, read-only OpenContracting Description: The total value of this contract. |
items: | List of Item objects, auto-generated, read-only OpenContracting Description: The goods, services, and any intangible outcomes in this contract. Note: If the items are the same as the award do not repeat. |
suppliers: | List of Organization objects, auto-generated, read-only |
status: | string, required OpenContracting Description: The current status of the contract. Possible values are:
|
period: |
OpenContracting Description: The start and end date for the contract. |
dateSigned: | string, Date OpenContracting Description: The date when the contract was signed. In the case of multiple signatures, the date of the last signature. |
date: | string, Date The date when the contract was changed or activated. |
documents: | List of Document objects OpenContracting Description: All documents and attachments related to the contract, including any notices. |
Period¶
Date¶
Date/time in Date Format: ISO 8601.
Value¶
Schema¶
amount: | float, required OpenContracting Description: Amount as a number. Should be positive. |
---|---|
currency: | string, required OpenContracting Description: The currency in 3-letter ISO 4217 format. |
valueAddedTaxIncluded: | |
bool, required |
Guarantee¶
Schema¶
amount: | float, required OpenContracting Description: Amount as a number. Should be positive. |
---|---|
currency: | string, required, default = UAH OpenContracting Description: The currency in 3-letter ISO 4217 format. |
Cancellation¶
Schema¶
id: | uid, auto-generated |
||||
---|---|---|---|---|---|
reason: | string, multilingual, required The reason, why Tender is being cancelled. |
||||
status: | string
|
||||
documents: | List of Document objects Documents accompanying the Cancellation: Protocol of Tender Committee with decision to cancel the Tender. |
||||
date: | string, Date Cancellation date. |
||||
cancellationOf: | string Possible values are:
|
||||
relatedLot: | string Id of related Lot. |
Feature¶
Schema¶
code: | string, auto-generated Code of the feature. |
||||||
---|---|---|---|---|---|---|---|
featureOf: | string, required Possible values are:
|
||||||
relatedItem: | string Id of related Item or Lot (only if the |
||||||
title: | string, multilingual, required Title of the feature. |
||||||
description: | string, multilingual Description of the feature. |
||||||
enum: | list List of values:
|
ProcuringEntity¶
Schema¶
name: | string, multilingual OpenContracting Description: The common name of the organization. |
---|---|
identifier: |
OpenContracting Description: The primary identifier for this organization. |
additionalIdentifiers: | |
List of Identifier objects |
|
address: | Address, required |
contactPoint: | ContactPoint, required |
kind: | string Type of procuring entity
|
Retrieving Tender Information¶
Getting list of all tenders¶
GET /tenders HTTP/1.1
HTTP/1.1 200 OK
Sorting¶
Tenders retuned are sorted by modification time.
Limiting number of Tenders returned¶
You can control the number of data entries in the tenders feed (batch size) with limit parameter. If not specified, data is being returned in batches of 100 elements.
Batching¶
The response contains next_page element with the following properties:
offset: | This is the parameter you have to add to the original request you made to get next page. |
---|---|
path: | This is path section of URL with original parameters and offset parameter added/replaced above. |
uri: | The full version of URL for next page. |
If next page request returns no data (i.e. empty array) then there is little sense in fetching further pages.
Synchronizing¶
It is often necessary to be able to syncronize central database changes with other database (we’ll call it “local”). The default sorting “by modification date” together with Batching mechanism allows one to implement synchronization effectively. The synchronization process can go page by page until there is no new data returned. Then the synchronizer has to pause for a while to let central database register some changes and attempt fetching subsequent page. The next_page guarantees that all changes from the last request are included in the new batch.
The safe frequency of synchronization requests is once per 5 minutes.
Reading the individual tender information¶
GET /tenders/64e93250be76435397e8c992ed4214d1 HTTP/1.1
HTTP/1.1 200 OK
Reading the tender documents list¶
GET /tenders/64e93250be76435397e8c992ed4214d1/documents HTTP/1.1
HTTP/1.1 200 OK
Example request:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"hash": "md5:00000000000000000000000000000000",
"description": "document description modified",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.044656+03:00",
"author": "tender_owner",
"documentType": "technicalSpecifications",
"id": "8c4f7355fed4463b98eb429237a2e6a5",
"dateModified": "2017-07-25T17:36:56.044677+03:00"
},
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "AwardCriteria.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=ysTqp33c7XMcniHmMMRwEbzHqlh7u0B1Xody%2F3MDOvWweLLYYutsDvREJ4lJcsnLkpv9HRVECjPJt2vGmv8GBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.140078+03:00",
"id": "14f948894bcc4ddc9da4d2129b028116",
"dateModified": "2017-07-25T17:36:56.140097+03:00"
}
]
}
Reading the tender document¶
The document can be retrieved by requesting the url returned in structures from document list request in data[*].url. It is safe to provide the download URL to end user for download.
Procuring Entity Operations¶
Registration of the Tender¶
Tender registration consists of primary record creation and documentation uploading.
Creating primary Tender record¶
When registering tender in the database, one has provide all primary tender details (except binary documents) in payload of request.
POST /tenders HTTP/1.1
The produced response will contain URL of the created tender in Location header of response, and in data.id
of body.
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1
Uploading documentation¶
All tender documentation should be uploaded with the following request - one request per document. You can see supported request types in Documents Uploading section.
POST /tenders/64e93250be76435397e8c992ed4214d1/documents HTTP/1.1
The response produced will have URL of the tender uploaded document in Location header of response and in data.id
of body.
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/documents/6a7d13bd8ec449e08882aeb92180d938
Example request:
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 334
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=3SoLjvN%2Bubc3yUq7E%2F8z%2FT4nhwBCO%2BYejSIqF2ORk3btE1ug052zZDNQQpi4yyd1rj%2FPX09LiTVm%2BoTVYouoCg%3D%3D",
"title": "Notice.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/8c4f7355fed4463b98eb429237a2e6a5
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Notice.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.044656+03:00",
"id": "8c4f7355fed4463b98eb429237a2e6a5",
"dateModified": "2017-07-25T17:36:56.044677+03:00"
}
}
Changing the Tender¶
Procuring Entity can change both the primary record and associated documentation.
Changing primary Tender Record¶
Procuring Entity can change the Tender properties with the following request. Data to change should be in payload of the message.
PATCH /tenders/64e93250be76435397e8c992ed4214d1 HTTP/1.1
HTTP/1.1 200 OK
Changing existing documents¶
Procuring Entity can upload new versions of the tender documentation. You can see supported request types in Documents Uploading section.
PUT /tenders/64e93250be76435397e8c992ed4214d1/documents/6a7d13bd8ec449e08882aeb92180d938 HTTP/1.1
HTTP/1.1 200 OK
Example request:
PUT /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents/14f948894bcc4ddc9da4d2129b028116?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 337
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=EC1QzFOXAe%2BawGOy%2FJR3YMrURSrxoUXQMtC%2BIIrTcHlCcL26Uj1%2BSbggyBg1H87VOEn9EBtEgBde0s8zxohcDQ%3D%3D",
"title": "AwardCriteria-2.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "AwardCriteria-2.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/1e600751d31c434987977980878dbd8b?KeyID=459f8ecf&Signature=76AeflAK4BuZ734jGky7PBC9Tk3HAmi6UmSE1ElFiy2jLkYGA1%2FMdT7NIF7Hto%2F5PmrqAktZ%2FYovZYW6QptFBg%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:56.140078+03:00",
"id": "14f948894bcc4ddc9da4d2129b028116",
"dateModified": "2017-07-25T17:36:56.181719+03:00"
}
}
Uploading additional documents¶
The same as Uploading documentation.
Bidder Operations¶
Registration of Bid proposal¶
POST /tenders/64e93250be76435397e8c992ed4214d1/bids/ HTTP/1.1
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607
Uploading Bid documents¶
POST /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607/documents HTTP/1.1
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607/documents/bd2e4c64179445cab93987fff3d58d23
Update of proposal¶
PATCH /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607 HTTP/1.1
HTTP/1.1 200 OK
Updating Bid documents¶
PUT /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607/documents/bd2e4c64179445cab93987fff3d58d23 HTTP/1.1
HTTP/1.1 200 Created
{
"data": {
...
"id": "ddd45992f1c545b9b03302205962265b",
...
"url": ".../tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607/documents/bd2e4c64179445cab93987fff3d58d23?download=7d56370415484488bbb621b8cea6315b"
}
}
Cancelling the proposal¶
DELETE /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607 HTTP/1.1
HTTP/1.1 200 OK
Bids Listing¶
After auction ends it is possible to get full information about bids and bidders that submitted them:
GET /api/0/tenders/6f73bf0f7f734f459f7e37e3787054a0/bids HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"date": "2014-12-16T04:44:23.569815+02:00",
"documents": [
{
"dateModified": "2014-12-16T04:44:25.010930+02:00",
"datePublished": "2014-12-16T04:44:25.010885+02:00",
"format": "text/plain",
"id": "ff001412c60c4164a0f57101e4eaf8aa",
"title": "Proposal.pdf",
"url": "http://api-sandbox.openprocurement.org/api/0/tenders/6f73bf0f7f734f459f7e37e3787054a0/bids/f7fc1212f9f140bba5c4e3cd4f2b62d9/documents/ff001412c60c4164a0f57101e4eaf8aa?download=4f45bbd414104cd78faf620208efd824"
}
],
"id": "f7fc1212f9f140bba5c4e3cd4f2b62d9",
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"name": "Сергій Олексюк",
"telephone": "+380 (432) 21-69-30"
},
"identifier": {
"id": "13313462",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"scheme": "UA-EDR",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»"
}
],
"value": {
"amount": 475000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"date": "2014-12-16T04:44:26.973605+02:00",
"id": "25261352d2d042ff8639f65b68e95e9f",
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21018",
"region": "м. Вінниця",
"streetAddress": "вул. Юності, 30"
},
"contactPoint": {
"email": "alla.myhailova@i.ua",
"name": "Алла Михайлова",
"telephone": "+380 (432) 460-665"
},
"identifier": {
"id": "13306232",
"legalName": "Державне комунальне підприємство громадського харчування «Меридіан»",
"scheme": "UA-EDR",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Меридіан»"
}
],
"value": {
"amount": 480000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
},
{
"date": "2014-12-16T04:44:27.976478+02:00",
"id": "7ec725815ef448a9b857129024395638",
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21018",
"region": "м. Вінниця",
"streetAddress": "вул. Юності, 30"
},
"contactPoint": {
"email": "alla.myhailova@i.ua",
"name": "Алла Михайлова",
"telephone": "+380 (432) 460-665"
},
"identifier": {
"id": "13306232",
"legalName": "Державне комунальне підприємство громадського харчування «Меридіан»",
"scheme": "UA-EDR",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Меридіан2»"
}
],
"value": {
"amount": 482000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
]
}
Retrieving the proposal¶
Individual bid can be retrieved via its id:
GET /api/0/tenders/6f73bf0f7f734f459f7e37e3787054a0/bids/f7fc1212f9f140bba5c4e3cd4f2b62d9 HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"date": "2014-12-16T04:44:23.569815+02:00",
"documents": [
{
"dateModified": "2014-12-16T04:44:25.010930+02:00",
"datePublished": "2014-12-16T04:44:25.010885+02:00",
"format": "text/plain",
"id": "ff001412c60c4164a0f57101e4eaf8aa",
"title": "Proposal.pdf",
"url": "http://api-sandbox.openprocurement.org/api/0/tenders/6f73bf0f7f734f459f7e37e3787054a0/bids/f7fc1212f9f140bba5c4e3cd4f2b62d9/documents/ff001412c60c4164a0f57101e4eaf8aa?download=4f45bbd414104cd78faf620208efd824"
}
],
"id": "f7fc1212f9f140bba5c4e3cd4f2b62d9",
"tenderers": [
{
"address": {
"countryName": "Україна",
"locality": "м. Вінниця",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33"
},
"contactPoint": {
"email": "soleksuk@gmail.com",
"name": "Сергій Олексюк",
"telephone": "+380 (432) 21-69-30"
},
"identifier": {
"id": "13313462",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"scheme": "UA-EDR",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»"
}
],
"value": {
"amount": 475000.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
}
Most economically advantageous tenders (MEAT)¶
Besides simple price-only tenders it is possible to announce the tender where other factors are valuable. Such tenders define features that procuring entity is interested in and how much different options influence the decision about the winner. Features can describe properties of tenderer, lot or item(s) being procured. Each option offered has numerical value that defines level of its importance compared to price. Bidders are doing self evaluation and provide the Parameters of their proposal (the actual value of each feature) along with financial part of a bid.
For more information read Non-price criteria.
The Feature is a data structure, part of the Tender. Tender can have multiple features associated. Feature can be associated with tenderer, lot or individual Item being procured. Features are identified with code, which are unique within the tender.
[
{
"code":"ee3e24bc17234a41bd3e3a04cc28e9c6",
"featureOf":"tenderer",
"title":"Термін оплати",
"description":"Умови відстрочки платежу після поставки товару",
"enum":[
{
"value":0.15,
"title":"180 днів та більше"
},
{
"value":0.1,
"title":"90-179 днів",
},
{
"value":0.05,
"title":"30-89 днів"
},
{
"value":0,
"title":"Менше 30 днів"
}
]
},
{
"code":"48cfd91612c04125ab406374d7cc8d93",
"featureOf":"item",
"relatedItem":"edd0032574bf4402877ad5f362df225a",
"title":"Сорт",
"description":"Сорт продукції",
"enum":[
{
"value":0.05,
"title":"Вищий"
},
{
"value":0.01,
"title":"Перший",
},
{
"value":0,
"title":"Другий"
}
]
}
]
Parameters provided by bidders should correspond to a set of required features. Parameters are linked to features using their codes.
[
{
"code":"ee3e24bc17234a41bd3e3a04cc28e9c6",
"value":0.1
},
{
"code":"48cfd91612c04125ab406374d7cc8d93",
"value":0.05
}
]
Announcing MEAT¶
Features can be set in Tender pretty the same way as Items are - with POST request.
POST /tenders HTTP/1.1
{"data": {
...
"features": [...],
...
}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1
Changing Features¶
In the case that Features should be changed one can send PATCH that replaces Tender.features with new set:
PATCH /tenders HTTP/1.1
{"data": {
"features": [...]
}
HTTP/1.1 200 OK
Removing Features¶
In case no Features are needed, they can be removed altogether with following request:
PATCH /tenders HTTP/1.1
{"data": {
"features": []
}
HTTP/1.1 200 OK
Bidding in MEAT¶
The same applies to Bid - Parameters of a Bid can be set initially with POST request and modified later with PATCH requests (see more at Bidder Operations).
POST /tenders/64e93250be76435397e8c992ed4214d1/bids HTTP/1.1
{"data": {
...
"parameters": [...],
...
}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/bid/4879d3f8ee2443169b5fbbc9f89fa607
Qualification in MEAT¶
During auction Bidder can bid with his/her bid price and see normalized price of his/her bid against normalized bids of other bidders. Ranking in auction is performed with normalized price where both price value and other Bid.parameters are taken into consideration.
Tenders with multiple Lots¶
When having tender with separate items that can be supplied by different providers it is possible to split the tender into Lots. Each Lot has its own budget (i.e. Lot.value).
For more information read Tender with multiple lots.
{
"lots": [
{
"id": "7d774fbf1e86420484c7d1a005cc283f",
"title": "Lot #1: Kyiv stationey",
"description": "Items for Kyiv office",
"value": {"currency": "UAH", "amount": 8000.0, "valueAddedTaxIncluded": true},
"minimalStep": {"currency": "UAH", "amount": 30.0, "valueAddedTaxIncluded": true},
"status": "active"
}, {
"id": "563ef5d999f34d36a5a0e4e4d91d7be1",
"title": "Lot #1: Lviv stationey",
"description": "Items for Lviv office",
"value": {"currency": "UAH", "amount": 9000.0, "valueAddedTaxIncluded": true},
"minimalStep": {"currency": "UAH", "amount": 35.0, "valueAddedTaxIncluded": true},
"status": "active"
}
]
}
Multilot Tender shares general documentation, and can have lot-specific and even item-specific documentation.
{
"documents": [
{
"format": "application/msword",
"url": "...",
"title": "kyiv-specs.doc",
"datePublished": "2015-10-27T14:01:16.155803+02:00",
"dateModified": "2015-10-27T14:01:16.155844+02:00",
"id": "9491647572294c2bb20bf28f16d14dd8",
"documentOf": "lot",
"relateLot": "7d774fbf1e86420484c7d1a005cc283f"
}
]
}
The same applies to Questions and answers. Question placed in Tender can be general, lot-specific or item-specific.
When bidding, provider can place bid against single lot, multiple lots or even all lots of the tender.
{
"lotValues": [
{
"value": {"currency": "UAH", "amount": 7750.0, "valueAddedTaxIncluded": true},
"reatedLot": "7d774fbf1e86420484c7d1a005cc283f",
"date": "2015-11-01T12:43:12.482645+02:00"
}, {
"value": {"currency": "UAH", "amount": 8125.0, "valueAddedTaxIncluded": true},
"reatedLot": "563ef5d999f34d36a5a0e4e4d91d7be1",
"date": "2015-11-01T12:43:12.482645+02:00"
}
],
"..."
}
Each of the documents attached to the Bid can be general, lot-specific or item-specific.
Each Lot has its own auction and awarding process.
Each Lot can be cancelled individually, not affecting processes that take place in other lots.
Announcing Multilot tender¶
One has to create Multilot tender in several steps. There should be tender created with items.
POST /tenders HTTP/1.1
{"data": {
"items":[
{"description": "", ... },
{"description": "", ... }
],
...
}}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1
{"data": {
"items":[
{"id": "c25264295db0463ba533fd380756cff1", "description": "", ... },
{"id": "f94aa51e2af944e08e02a4063121f93c", "description": "", ... }
],
...
},
...
}
Then all lots have to be added to Tender with separate requests.
POST /tenders/64e93250be76435397e8c992ed4214d1/lots HTTP/1.1
{"data": {..}}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/lots/7d774fbf1e86420484c7d1a005cc283f
2nd lot:
POST /tenders/64e93250be76435397e8c992ed4214d1/lots HTTP/1.1
{"data": {..}}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/lots/563ef5d999f34d36a5a0e4e4d91d7be1
Items should be distributed among the lots.
PATCH /tenders/64e93250be76435397e8c992ed4214d1 HTTP/1.1
{"data": {
"items":[
{"id": "c25264295db0463ba533fd380756cff1", "relatedLot": "7d774fbf1e86420484c7d1a005cc283f"},
{"id": "f94aa51e2af944e08e02a4063121f93c", "relatedLot": "563ef5d999f34d36a5a0e4e4d91d7be1"}
],
...
},
...
}
Bidding in Multilot tender¶
Bid should have lotValues property consisting of multiple LotValue objects. Each should reference lot the bid is placed against via relatedLot property.
POST /tenders/64e93250be76435397e8c992ed4214d1/bids HTTP/1.1
{"data": {
"lotValues": [
{
"value": {"currency": "UAH", "amount": 7750.0, "valueAddedTaxIncluded": true},
"reatedLot": "7d774fbf1e86420484c7d1a005cc283f",
"date": "2015-11-01T12:43:12.482645+02:00"
}, {
"value": {"currency": "UAH", "amount": 8125.0, "valueAddedTaxIncluded": true},
"reatedLot": "563ef5d999f34d36a5a0e4e4d91d7be1",
"date": "2015-11-01T12:43:12.482645+02:00"
}
],
...
}}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/bids/ae836da01ef749e494427dc591d36062
Auction participation URLs are available for each of the submitted lots.
Qualification in Multilot tender¶
After Auctions are over each active lot has its own awarding process started. I.e. there are multiple award objects created in Tender each requiring decision (disqualification or acceptance).
GET /tenders/64e93250be76435397e8c992ed4214d1/awards HTTP/1.1
HTTP/1.1 200 OK
{"data": [
{
"status": "pending",
"bid_id": "ae836da01ef749e494427dc591d36062",
"value": {"currency": "UAH", "amount": 7750.0, "valueAddedTaxIncluded": true},
"id": "c3179dd8609340a7ba9e5fe91762f564",
"lotId": "7d774fbf1e86420484c7d1a005cc283f",
"..."
}, {
"status": "pending",
"bid_id": "ae836da01ef749e494427dc591d36062",
"value": {"currency": "UAH", "amount": 8125.0, "valueAddedTaxIncluded": true},
"id": "c99e30174b10418bac026a77d41288d7",
"lotId": "563ef5d999f34d36a5a0e4e4d91d7be1",
"..."
}
]
}
When all qualification processes end, and all stand still periods end, the whole tender switch state to either complete or unsuccessful (if awads for all lots are unsuccessful).
Qualification Operations¶
When auction is over, the qualification process starts. The status of tender is active.qualification then. Right after results are submitted to Central DB, there is award generated for auction winner.
Listing awards¶
The pending award can be retrieved via request to list all available awards:
GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"status": "pending",
"complaintPeriod": {
"startDate": "2017-07-25T17:36:51.988435+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"bid_id": "ee786a6e8a7d470196a751273f064e78",
"value": {
"currency": "UAH",
"amount": 450.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:51.988424+03:00",
"id": "aec061c3b3234a9981a292ae161d2ece"
}
]
}
When the award is in pending status, it means that procuring entity has to review documents describing the bid and other bidder documents.
Disqualification¶
The protocol of Qualification Committee decision should be uploaded as document into award and later its status should switch to either active (if it is accepted) or unsuccessful (if rejected).
POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/documents?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 337
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=XeHObf%2F36dBstK6OOXGbrtZgI7VnysX79jIYHJFHxhq1sksc3cMVgcCfFY5nt4wR3V1Mn8LLhGuKaqZaxvpHDQ%3D%3D",
"title": "Unsuccessful_Reason.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/documents/0ac19aedb5d2407598d91aa963d6a027
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Unsuccessful_Reason.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=PbVLwL3AMNy7I%2FnhEANHhLSNoOKKay2pvYsHnbBXD%252BBZM60nIqXTk3UDDN6TsctsZ2k0TtSk0XEwlEoFdbKRAQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:52.098854+03:00",
"id": "0ac19aedb5d2407598d91aa963d6a027",
"dateModified": "2017-07-25T17:36:52.098871+03:00"
}
}
The Qualification Committee can upload several documents, for example, decisions to prolong the qualification process - in order to allow the bidder to collect all necessary documents or correct errors. Such documents would help to have procedure as transparent as possible and will reduce risk of cancellation by Complaint Review Body.
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "unsuccessful"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/4983c533470d473aa5769ba399849cb0
{
"data": {
"status": "unsuccessful",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Unsuccessful_Reason.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=PbVLwL3AMNy7I%2FnhEANHhLSNoOKKay2pvYsHnbBXD%252BBZM60nIqXTk3UDDN6TsctsZ2k0TtSk0XEwlEoFdbKRAQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:52.098854+03:00",
"id": "0ac19aedb5d2407598d91aa963d6a027",
"dateModified": "2017-07-25T17:36:52.098871+03:00"
}
],
"complaintPeriod": {
"startDate": "2017-07-25T17:36:51.988435+03:00",
"endDate": "2017-07-27T17:36:52.185900+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"bid_id": "ee786a6e8a7d470196a751273f064e78",
"value": {
"currency": "UAH",
"amount": 450.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:52.191749+03:00",
"id": "aec061c3b3234a9981a292ae161d2ece"
}
}
Note that after award rejection the next bid in the value-sorted bid sequence becomes subject of subsequent award. For convenience you can use the Location response header from the response above that is pointing to an award in “pending” state.
Contract Awarding¶
Protocol upload:
POST /tenders/64e93250be76435397e8c992ed4214d1/awards/{}/documents HTTP/1.1
Confirming the Award:
PATCH /tenders/64e93250be76435397e8c992ed4214d1/awards/{} HTTP/1.1
{
"data":{
"status": "active"
}
}
HTTP/1.1 200 OK
The procuring entity can wait until bidder provides all missing documents (licenses, certificates, statements, etc.) or update original bid documents to correct errors. Alternatively, they can reject the bid if provided documents do not satisfy the pass/fail criteria of tender (even before full package of supplementary documents is available).
Cancelling Active Award¶
Sometimes Bidder refuses to sign the contract even after passing qualification process. In this case Procuring Entity is expected to be able to reject approved award and disqualify Bid afterwards.
After we have Award with active status:
GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/4983c533470d473aa5769ba399849cb0 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "active",
"complaintPeriod": {
"startDate": "2017-07-25T17:36:52.186270+03:00",
"endDate": "2017-07-27T17:36:52.318837+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": "39481e7f97894915832b3b882afdade4",
"value": {
"currency": "UAH",
"amount": 469.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:52.324371+03:00",
"id": "4983c533470d473aa5769ba399849cb0"
}
}
There is need to cancel it:
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/4983c533470d473aa5769ba399849cb0?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "cancelled"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/3ff474e4f3a843fba101c561e5cffb14
{
"data": {
"status": "cancelled",
"complaintPeriod": {
"startDate": "2017-07-25T17:36:52.186270+03:00",
"endDate": "2017-07-25T17:36:52.456668+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": "39481e7f97894915832b3b882afdade4",
"value": {
"currency": "UAH",
"amount": 469.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:52.463690+03:00",
"id": "4983c533470d473aa5769ba399849cb0"
}
}
Note that there is Location header returned that aids in locating the “fresh” award that is most likely subject for disqualification:
POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/3ff474e4f3a843fba101c561e5cffb14/documents?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 341
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/6bd74e04745d4eeb99b4806f1dae82c9?KeyID=1a1ebb61&Signature=LAgDr%2B6y5LMCNb6bB7UPlkjL7JhiesqZ5QFPxZCHsPpJX5xpFFyc%2FYBKfYPhiDlHGcR6l9ObYpar4lpbkJ%2BBDw%3D%3D",
"title": "Cancellation_Reason.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/3ff474e4f3a843fba101c561e5cffb14/documents/6eec6788a5cb494589a9f3cab1661d99
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Cancellation_Reason.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/6bd74e04745d4eeb99b4806f1dae82c9?KeyID=1a1ebb61&Signature=qtr%252BRVTvbXo%2F%252BEsVgsfE%2Ff385WPW6pMjiTja4cwoCt2koVF19VA6%2FiSzHzcY5JvG7UmUl04wQa%2FBZSAmUVTcBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:52.594571+03:00",
"id": "6eec6788a5cb494589a9f3cab1661d99",
"dateModified": "2017-07-25T17:36:52.594591+03:00"
}
}
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/3ff474e4f3a843fba101c561e5cffb14?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "unsuccessful"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/29402437b6c54e97a49bf9179e11fe08
{
"data": {
"status": "unsuccessful",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Cancellation_Reason.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/6bd74e04745d4eeb99b4806f1dae82c9?KeyID=1a1ebb61&Signature=qtr%252BRVTvbXo%2F%252BEsVgsfE%2Ff385WPW6pMjiTja4cwoCt2koVF19VA6%2FiSzHzcY5JvG7UmUl04wQa%2FBZSAmUVTcBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:52.594571+03:00",
"id": "6eec6788a5cb494589a9f3cab1661d99",
"dateModified": "2017-07-25T17:36:52.594591+03:00"
}
],
"complaintPeriod": {
"startDate": "2017-07-25T17:36:52.457048+03:00",
"endDate": "2017-07-27T17:36:52.718103+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": "39481e7f97894915832b3b882afdade4",
"value": {
"currency": "UAH",
"amount": 469.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:52.726245+03:00",
"id": "3ff474e4f3a843fba101c561e5cffb14"
}
}
In the case when there is another Bid for qualification, there will be Location header in the response pointing to its Award.
Influence of Complaint Satisfaction¶
If decision of the procuring entity is unfair any bidder can file complaint and after proper review the whole awarding process can start from the award in question.
Disqualification decision of procuring entity’s qualification committee can be cancelled in the following cases:
- claim for this disqualification has been submitted (claim status is
claim
); - claim has been answered (claim status is
answered
); - complaint is pending review (complaint status is
pending
); - complaint has been satisfied by the Complaint Review Body (complaint status is
resolved
).
After the disqualification decision cancellation it receives cancelled
status. New pending award is generated and procuring entity is obliged to qualify it again (taking into consideration recommendations from the report of Complaint Review Body if there is one).
GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"status": "unsuccessful",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Unsuccessful_Reason.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=PbVLwL3AMNy7I%2FnhEANHhLSNoOKKay2pvYsHnbBXD%252BBZM60nIqXTk3UDDN6TsctsZ2k0TtSk0XEwlEoFdbKRAQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:52.098854+03:00",
"id": "0ac19aedb5d2407598d91aa963d6a027",
"dateModified": "2017-07-25T17:36:52.098871+03:00"
}
],
"complaintPeriod": {
"startDate": "2017-07-25T17:36:51.988435+03:00",
"endDate": "2017-07-27T17:36:52.185900+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"bid_id": "ee786a6e8a7d470196a751273f064e78",
"value": {
"currency": "UAH",
"amount": 450.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:52.191749+03:00",
"complaints": [
{
"status": "resolved",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:53.000914+03:00",
"id": "96ad4bc79c704f6eb094b83bf2ca817a",
"dateModified": "2017-07-25T17:36:53.000946+03:00"
}
],
"description": "complaint description",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"resolutionType": "resolved",
"type": "claim",
"title": "complaint title",
"satisfied": true,
"tendererAction": "Виправлено неконкурентні умови",
"dateAnswered": "2017-07-25T17:36:53.465653+03:00",
"tendererActionDate": "2017-07-25T17:36:53.465668+03:00",
"dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
"complaintID": "UA-2017-07-25-000001.5",
"date": "2017-07-25T17:36:53.605801+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "fc1eef6ef50d4656b981aae8bb181467"
},
{
"status": "resolved",
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"satisfied": false,
"dateAnswered": "2017-07-25T17:36:53.730015+03:00",
"dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
"complaintID": "UA-2017-07-25-000001.6",
"date": "2017-07-25T17:36:53.871088+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "d9f8daa198f44112b4ec51a00598d823"
},
{
"status": "resolved",
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"satisfied": false,
"dateAnswered": "2017-07-25T17:36:54.133250+03:00",
"dateSubmitted": "2017-07-25T17:36:53.993166+03:00",
"complaintID": "UA-2017-07-25-000001.7",
"date": "2017-07-25T17:36:54.279826+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "52fd0b0be7a84115824d49a5f5b915a2"
},
{
"status": "resolved",
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"satisfied": false,
"dateAnswered": "2017-07-25T17:36:54.570422+03:00",
"dateSubmitted": "2017-07-25T17:36:54.418211+03:00",
"complaintID": "UA-2017-07-25-000001.8",
"date": "2017-07-25T17:36:54.762393+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "2d1216c07c35480ea9dbc1d5e537c84b"
}
],
"id": "aec061c3b3234a9981a292ae161d2ece"
},
{
"status": "cancelled",
"complaintPeriod": {
"startDate": "2017-07-25T17:36:52.186270+03:00",
"endDate": "2017-07-25T17:36:52.456668+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": "39481e7f97894915832b3b882afdade4",
"value": {
"currency": "UAH",
"amount": 469.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:52.463690+03:00",
"id": "4983c533470d473aa5769ba399849cb0"
},
{
"status": "unsuccessful",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Cancellation_Reason.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/6bd74e04745d4eeb99b4806f1dae82c9?KeyID=1a1ebb61&Signature=qtr%252BRVTvbXo%2F%252BEsVgsfE%2Ff385WPW6pMjiTja4cwoCt2koVF19VA6%2FiSzHzcY5JvG7UmUl04wQa%2FBZSAmUVTcBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:52.594571+03:00",
"id": "6eec6788a5cb494589a9f3cab1661d99",
"dateModified": "2017-07-25T17:36:52.594591+03:00"
}
],
"complaintPeriod": {
"startDate": "2017-07-25T17:36:52.457048+03:00",
"endDate": "2017-07-27T17:36:52.718103+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": "39481e7f97894915832b3b882afdade4",
"value": {
"currency": "UAH",
"amount": 469.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:52.726245+03:00",
"id": "3ff474e4f3a843fba101c561e5cffb14"
},
{
"status": "pending",
"complaintPeriod": {
"startDate": "2017-07-25T17:36:52.718479+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"bid_id": "784c395f01c84791abb1f43f6360f9b0",
"value": {
"currency": "UAH",
"amount": 475.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:52.718469+03:00",
"id": "29402437b6c54e97a49bf9179e11fe08"
}
]
}
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "cancelled"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/4bf169f2d26d4e0698cf83c1d8f47c8b
{
"data": {
"status": "cancelled",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Unsuccessful_Reason.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=PbVLwL3AMNy7I%2FnhEANHhLSNoOKKay2pvYsHnbBXD%252BBZM60nIqXTk3UDDN6TsctsZ2k0TtSk0XEwlEoFdbKRAQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:52.098854+03:00",
"id": "0ac19aedb5d2407598d91aa963d6a027",
"dateModified": "2017-07-25T17:36:52.098871+03:00"
}
],
"complaintPeriod": {
"startDate": "2017-07-25T17:36:51.988435+03:00",
"endDate": "2017-07-25T17:36:55.073733+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"bid_id": "ee786a6e8a7d470196a751273f064e78",
"value": {
"currency": "UAH",
"amount": 450.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:55.083321+03:00",
"complaints": [
{
"status": "resolved",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:53.000914+03:00",
"id": "96ad4bc79c704f6eb094b83bf2ca817a",
"dateModified": "2017-07-25T17:36:53.000946+03:00"
}
],
"description": "complaint description",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"resolutionType": "resolved",
"type": "claim",
"title": "complaint title",
"satisfied": true,
"tendererAction": "Виправлено неконкурентні умови",
"dateAnswered": "2017-07-25T17:36:53.465653+03:00",
"tendererActionDate": "2017-07-25T17:36:53.465668+03:00",
"dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
"complaintID": "UA-2017-07-25-000001.5",
"date": "2017-07-25T17:36:53.605801+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "fc1eef6ef50d4656b981aae8bb181467"
},
{
"status": "resolved",
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"satisfied": false,
"dateAnswered": "2017-07-25T17:36:53.730015+03:00",
"dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
"complaintID": "UA-2017-07-25-000001.6",
"date": "2017-07-25T17:36:53.871088+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "d9f8daa198f44112b4ec51a00598d823"
},
{
"status": "resolved",
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"satisfied": false,
"dateAnswered": "2017-07-25T17:36:54.133250+03:00",
"dateSubmitted": "2017-07-25T17:36:53.993166+03:00",
"complaintID": "UA-2017-07-25-000001.7",
"date": "2017-07-25T17:36:54.279826+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "52fd0b0be7a84115824d49a5f5b915a2"
},
{
"status": "resolved",
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"satisfied": false,
"dateAnswered": "2017-07-25T17:36:54.570422+03:00",
"dateSubmitted": "2017-07-25T17:36:54.418211+03:00",
"complaintID": "UA-2017-07-25-000001.8",
"date": "2017-07-25T17:36:54.762393+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "2d1216c07c35480ea9dbc1d5e537c84b"
}
],
"id": "aec061c3b3234a9981a292ae161d2ece"
}
}
GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"status": "cancelled",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Unsuccessful_Reason.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=PbVLwL3AMNy7I%2FnhEANHhLSNoOKKay2pvYsHnbBXD%252BBZM60nIqXTk3UDDN6TsctsZ2k0TtSk0XEwlEoFdbKRAQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:52.098854+03:00",
"id": "0ac19aedb5d2407598d91aa963d6a027",
"dateModified": "2017-07-25T17:36:52.098871+03:00"
}
],
"complaintPeriod": {
"startDate": "2017-07-25T17:36:51.988435+03:00",
"endDate": "2017-07-25T17:36:55.073733+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"bid_id": "ee786a6e8a7d470196a751273f064e78",
"value": {
"currency": "UAH",
"amount": 450.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:55.083321+03:00",
"complaints": [
{
"status": "resolved",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:53.000914+03:00",
"id": "96ad4bc79c704f6eb094b83bf2ca817a",
"dateModified": "2017-07-25T17:36:53.000946+03:00"
}
],
"description": "complaint description",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"resolutionType": "resolved",
"type": "claim",
"title": "complaint title",
"satisfied": true,
"tendererAction": "Виправлено неконкурентні умови",
"dateAnswered": "2017-07-25T17:36:53.465653+03:00",
"tendererActionDate": "2017-07-25T17:36:53.465668+03:00",
"dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
"complaintID": "UA-2017-07-25-000001.5",
"date": "2017-07-25T17:36:53.605801+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "fc1eef6ef50d4656b981aae8bb181467"
},
{
"status": "resolved",
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"satisfied": false,
"dateAnswered": "2017-07-25T17:36:53.730015+03:00",
"dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
"complaintID": "UA-2017-07-25-000001.6",
"date": "2017-07-25T17:36:53.871088+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "d9f8daa198f44112b4ec51a00598d823"
},
{
"status": "resolved",
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"satisfied": false,
"dateAnswered": "2017-07-25T17:36:54.133250+03:00",
"dateSubmitted": "2017-07-25T17:36:53.993166+03:00",
"complaintID": "UA-2017-07-25-000001.7",
"date": "2017-07-25T17:36:54.279826+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "52fd0b0be7a84115824d49a5f5b915a2"
},
{
"status": "resolved",
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"satisfied": false,
"dateAnswered": "2017-07-25T17:36:54.570422+03:00",
"dateSubmitted": "2017-07-25T17:36:54.418211+03:00",
"complaintID": "UA-2017-07-25-000001.8",
"date": "2017-07-25T17:36:54.762393+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "2d1216c07c35480ea9dbc1d5e537c84b"
}
],
"id": "aec061c3b3234a9981a292ae161d2ece"
},
{
"status": "cancelled",
"complaintPeriod": {
"startDate": "2017-07-25T17:36:52.186270+03:00",
"endDate": "2017-07-25T17:36:55.073733+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": "39481e7f97894915832b3b882afdade4",
"value": {
"currency": "UAH",
"amount": 469.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:52.463690+03:00",
"id": "4983c533470d473aa5769ba399849cb0"
},
{
"status": "cancelled",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "tender_owner",
"title": "Cancellation_Reason.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/6bd74e04745d4eeb99b4806f1dae82c9?KeyID=1a1ebb61&Signature=qtr%252BRVTvbXo%2F%252BEsVgsfE%2Ff385WPW6pMjiTja4cwoCt2koVF19VA6%2FiSzHzcY5JvG7UmUl04wQa%2FBZSAmUVTcBw%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:52.594571+03:00",
"id": "6eec6788a5cb494589a9f3cab1661d99",
"dateModified": "2017-07-25T17:36:52.594591+03:00"
}
],
"complaintPeriod": {
"startDate": "2017-07-25T17:36:52.457048+03:00",
"endDate": "2017-07-25T17:36:55.073733+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": "39481e7f97894915832b3b882afdade4",
"value": {
"currency": "UAH",
"amount": 469.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:55.083321+03:00",
"id": "3ff474e4f3a843fba101c561e5cffb14"
},
{
"status": "cancelled",
"complaintPeriod": {
"startDate": "2017-07-25T17:36:52.718479+03:00",
"endDate": "2017-07-25T17:36:55.073733+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"bid_id": "784c395f01c84791abb1f43f6360f9b0",
"value": {
"currency": "UAH",
"amount": 475.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:55.083321+03:00",
"id": "29402437b6c54e97a49bf9179e11fe08"
},
{
"status": "pending",
"complaintPeriod": {
"startDate": "2017-07-25T17:36:55.074225+03:00"
},
"suppliers": [
{
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
}
],
"bid_id": "ee786a6e8a7d470196a751273f064e78",
"value": {
"currency": "UAH",
"amount": 450.0,
"valueAddedTaxIncluded": true
},
"date": "2017-07-25T17:36:55.074214+03:00",
"id": "4bf169f2d26d4e0698cf83c1d8f47c8b"
}
]
}
Asking Questions¶
Submitting Questions¶
Anybody (who provides their identity) can ask questions:
POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.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; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions/e2e6900f65434252a75741613fe0703b
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
"id": "00137226",
"uri": "http://sch10.edu.vn.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"title": "Калорійність",
"date": "2017-07-25T17:36:56.229819+03:00",
"id": "e2e6900f65434252a75741613fe0703b",
"questionOf": "tender"
}
}
Retrieving Questions¶
Question author identities are not revealed before auction ends:
GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"description": "Просимо додати таблицю потрібної калорійності харчування",
"dateAnswered": "2017-07-25T17:36:56.273608+03:00",
"title": "Калорійність",
"date": "2017-07-25T17:36:56.229819+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "e2e6900f65434252a75741613fe0703b",
"questionOf": "tender"
}
]
}
Answering¶
Submitting Answers¶
Tender creator can answer questions:
PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/questions/e2e6900f65434252a75741613fe0703b?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"description": "Просимо додати таблицю потрібної калорійності харчування",
"dateAnswered": "2017-07-25T17:36:56.273608+03:00",
"title": "Калорійність",
"date": "2017-07-25T17:36:56.229819+03:00",
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
"id": "e2e6900f65434252a75741613fe0703b",
"questionOf": "tender"
}
}
Complaint Workflow¶
For more detailed information read Complaints.
Tender Conditions Claims/Complaints¶
Claim/Complaint Retrieval¶
Tender Conditions Claim/Complaint Retrieval¶
You can list all Tender Conditions Claims/Complaints:
GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints HTTP/1.0
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"status": "claim",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:50.767640+03:00",
"id": "8ebcc96606e941bc89d601c3d11270d1",
"dateModified": "2017-07-25T17:36:50.767661+03:00"
}
],
"description": "complaint description",
"title": "complaint title",
"dateSubmitted": "2017-07-25T17:36:50.813612+03:00",
"complaintID": "UA-2017-07-25-000001.1",
"date": "2017-07-25T17:36:50.815647+03:00",
"type": "claim",
"id": "3b36519c7e994663a75935a29c0ddbcf"
},
{
"status": "claim",
"description": "complaint description",
"title": "complaint title",
"dateSubmitted": "2017-07-25T17:36:50.854956+03:00",
"complaintID": "UA-2017-07-25-000001.2",
"date": "2017-07-25T17:36:50.854942+03:00",
"type": "claim",
"id": "3382f6727fc94edc947ff016fcedad11"
}
]
}
And check individual complaint or claim:
GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf HTTP/1.0
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "claim",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:50.767640+03:00",
"id": "8ebcc96606e941bc89d601c3d11270d1",
"dateModified": "2017-07-25T17:36:50.767661+03:00"
}
],
"description": "complaint description",
"title": "complaint title",
"dateSubmitted": "2017-07-25T17:36:50.813612+03:00",
"complaintID": "UA-2017-07-25-000001.1",
"date": "2017-07-25T17:36:50.815647+03:00",
"type": "claim",
"id": "3b36519c7e994663a75935a29c0ddbcf"
}
}
Claim Submission¶
If tender conditions are favoriting particular supplier, or in any other viable case, any registered user can submit Tender Conditions Claim.
Tender Conditions Claim Submission (with documents)¶
At first create a claim:
POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 775
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"title": "complaint title",
"description": "complaint description",
"author": {
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf
{
"access": {
"token": "6c52536fdb1b4e0a83ce6b486d2cfd0c"
},
"data": {
"status": "draft",
"description": "complaint description",
"title": "complaint title",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"complaintID": "UA-2017-07-25-000001.1",
"date": "2017-07-25T17:36:50.723953+03:00",
"type": "claim",
"id": "3b36519c7e994663a75935a29c0ddbcf"
}
}
Then upload necessary documents:
POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf/documents?acc_token=6c52536fdb1b4e0a83ce6b486d2cfd0c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 341
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=FiD0BzQgpK6kcZJ5gTBrEkKGKg5QNTNvt3gt%2Fcjbjt5mbmz5BG7l8wTSIKTC4%2Bh2HXjF3WQ7pnRjOwL42gRlBA%3D%3D",
"title": "Complaint_Attachement.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf/documents/8ebcc96606e941bc89d601c3d11270d1
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:50.767640+03:00",
"id": "8ebcc96606e941bc89d601c3d11270d1",
"dateModified": "2017-07-25T17:36:50.767661+03:00"
}
}
Submit tender conditions claim:
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf?acc_token=6c52536fdb1b4e0a83ce6b486d2cfd0c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 29
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "claim"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "claim",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:50.767640+03:00",
"id": "8ebcc96606e941bc89d601c3d11270d1",
"dateModified": "2017-07-25T17:36:50.767661+03:00"
}
],
"description": "complaint description",
"title": "complaint title",
"dateSubmitted": "2017-07-25T17:36:50.813612+03:00",
"complaintID": "UA-2017-07-25-000001.1",
"date": "2017-07-25T17:36:50.815647+03:00",
"type": "claim",
"id": "3b36519c7e994663a75935a29c0ddbcf"
}
}
Tender Conditions Claim Submission (without documents)¶
Create claim that does not need additional documents:
POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 794
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "claim",
"title": "complaint title",
"description": "complaint description",
"author": {
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3382f6727fc94edc947ff016fcedad11
{
"access": {
"token": "463edbad1cd743ad842e367ec778d835"
},
"data": {
"status": "claim",
"description": "complaint description",
"title": "complaint title",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateSubmitted": "2017-07-25T17:36:50.854956+03:00",
"complaintID": "UA-2017-07-25-000001.2",
"date": "2017-07-25T17:36:50.854942+03:00",
"type": "claim",
"id": "3382f6727fc94edc947ff016fcedad11"
}
}
Claim’s Answer¶
Answer to resolved claim¶
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 442
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "answered",
"resolutionType": "resolved",
"tendererAction": "Виправлено неконкурентні умови",
"resolution": "Виправлено неконкурентні умови"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "answered",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:50.767640+03:00",
"id": "8ebcc96606e941bc89d601c3d11270d1",
"dateModified": "2017-07-25T17:36:50.767661+03:00"
}
],
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"tendererAction": "Виправлено неконкурентні умови",
"dateAnswered": "2017-07-25T17:36:50.937282+03:00",
"tendererActionDate": "2017-07-25T17:36:50.937311+03:00",
"dateSubmitted": "2017-07-25T17:36:50.813612+03:00",
"complaintID": "UA-2017-07-25-000001.1",
"date": "2017-07-25T17:36:50.939736+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "3b36519c7e994663a75935a29c0ddbcf"
}
}
Satisfied Claim¶
Satisfying resolution¶
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3b36519c7e994663a75935a29c0ddbcf?acc_token=6c52536fdb1b4e0a83ce6b486d2cfd0c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 51
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "resolved",
"satisfied": true
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "resolved",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/a6eda494834f49f884bc2202b833eb9f?KeyID=1a1ebb61&Signature=HVXI2lfBb%252BTHfNMrSh%2F0cH0hv3YYQ032UDnmB2%252Bu4ntVsOJcqAhScdCfpjFxBUnKOMBTS1co3W35T972IxdpBA%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:50.767640+03:00",
"id": "8ebcc96606e941bc89d601c3d11270d1",
"dateModified": "2017-07-25T17:36:50.767661+03:00"
}
],
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"satisfied": true,
"tendererAction": "Виправлено неконкурентні умови",
"dateAnswered": "2017-07-25T17:36:50.937282+03:00",
"tendererActionDate": "2017-07-25T17:36:50.937311+03:00",
"dateSubmitted": "2017-07-25T17:36:50.813612+03:00",
"complaintID": "UA-2017-07-25-000001.1",
"date": "2017-07-25T17:36:50.991383+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "3b36519c7e994663a75935a29c0ddbcf"
}
}
Disagreement with decision¶
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/complaints/3382f6727fc94edc947ff016fcedad11?acc_token=463edbad1cd743ad842e367ec778d835 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 52
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "resolved",
"satisfied": false
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "resolved",
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"satisfied": false,
"dateAnswered": "2017-07-25T17:36:51.045464+03:00",
"dateSubmitted": "2017-07-25T17:36:50.854956+03:00",
"complaintID": "UA-2017-07-25-000001.2",
"date": "2017-07-25T17:36:51.100829+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "3382f6727fc94edc947ff016fcedad11"
}
}
Tender Award Claims/Complaints¶
Claim/Complaint Retrieval¶
Tender Award Claim/Complaint Retrieval¶
You can list all Tender Award Claims/Complaints:
GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints HTTP/1.0
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": [
{
"status": "claim",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:53.000914+03:00",
"id": "96ad4bc79c704f6eb094b83bf2ca817a",
"dateModified": "2017-07-25T17:36:53.000946+03:00"
}
],
"description": "complaint description",
"title": "complaint title",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
"complaintID": "UA-2017-07-25-000001.5",
"date": "2017-07-25T17:36:53.132891+03:00",
"type": "claim",
"id": "fc1eef6ef50d4656b981aae8bb181467"
},
{
"status": "claim",
"description": "complaint description",
"title": "complaint title",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
"complaintID": "UA-2017-07-25-000001.6",
"date": "2017-07-25T17:36:53.245100+03:00",
"type": "claim",
"id": "d9f8daa198f44112b4ec51a00598d823"
}
]
}
And check individual complaint or claim:
GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467 HTTP/1.0
Host: api-sandbox.openprocurement.org
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "claim",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:53.000914+03:00",
"id": "96ad4bc79c704f6eb094b83bf2ca817a",
"dateModified": "2017-07-25T17:36:53.000946+03:00"
}
],
"description": "complaint description",
"title": "complaint title",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
"complaintID": "UA-2017-07-25-000001.5",
"date": "2017-07-25T17:36:53.132891+03:00",
"type": "claim",
"id": "fc1eef6ef50d4656b981aae8bb181467"
}
}
Claim Submission¶
If tender award is favoriting only one supplier, or in any other viable case, participants can submit Tender Award Claim.
Tender Award Claim Submission (with documents)¶
At first create a claim. Send POST request with bidder’s access token.
POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints?acc_token=86ff28dee48646b58ef3021c532d26fc HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 775
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"title": "complaint title",
"description": "complaint description",
"author": {
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467
{
"access": {
"token": "3df7c9a8797747c0b56aa8ac54c8ac87"
},
"data": {
"status": "draft",
"description": "complaint description",
"title": "complaint title",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"complaintID": "UA-2017-07-25-000001.5",
"date": "2017-07-25T17:36:52.885993+03:00",
"type": "claim",
"id": "fc1eef6ef50d4656b981aae8bb181467"
}
}
Then upload necessary documents:
POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467/documents?acc_token=3df7c9a8797747c0b56aa8ac54c8ac87 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 337
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=i93IbrYeyRrJKcx5js73FlDkfqcsaOgcNT5Zjv9onXJPVdiT8q71zqjBW2CtSrF0VEcBanwp5TK3n71Y6twXCA%3D%3D",
"title": "Complaint_Attachement.pdf",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf"
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467/documents/96ad4bc79c704f6eb094b83bf2ca817a
{
"data": {
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:53.000914+03:00",
"id": "96ad4bc79c704f6eb094b83bf2ca817a",
"dateModified": "2017-07-25T17:36:53.000946+03:00"
}
}
Submit tender award claim:
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467?acc_token=3df7c9a8797747c0b56aa8ac54c8ac87 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 29
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "claim"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "claim",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:53.000914+03:00",
"id": "96ad4bc79c704f6eb094b83bf2ca817a",
"dateModified": "2017-07-25T17:36:53.000946+03:00"
}
],
"description": "complaint description",
"title": "complaint title",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
"complaintID": "UA-2017-07-25-000001.5",
"date": "2017-07-25T17:36:53.132891+03:00",
"type": "claim",
"id": "fc1eef6ef50d4656b981aae8bb181467"
}
}
Tender Award Claim Submission (without documents)¶
You can submit claim that does not need additional documents:
POST /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints?acc_token=86ff28dee48646b58ef3021c532d26fc HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 794
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "claim",
"title": "complaint title",
"description": "complaint description",
"author": {
"contactPoint": {
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк",
"email": "soleksuk@gmail.com"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"countryName": "Україна",
"postalCode": "21100",
"region": "м. Вінниця",
"streetAddress": "вул. Островського, 33",
"locality": "м. Вінниця"
}
}
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/d9f8daa198f44112b4ec51a00598d823
{
"access": {
"token": "3dbf343519cf4f26a01caf880b2d6536"
},
"data": {
"status": "claim",
"description": "complaint description",
"title": "complaint title",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
"complaintID": "UA-2017-07-25-000001.6",
"date": "2017-07-25T17:36:53.245100+03:00",
"type": "claim",
"id": "d9f8daa198f44112b4ec51a00598d823"
}
}
Claim’s Answer¶
Answer to resolved claim¶
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467?acc_token=e96bd05708744828a13d48aa6e282cb9 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 442
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "answered",
"resolutionType": "resolved",
"tendererAction": "Виправлено неконкурентні умови",
"resolution": "Виправлено неконкурентні умови"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "answered",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:53.000914+03:00",
"id": "96ad4bc79c704f6eb094b83bf2ca817a",
"dateModified": "2017-07-25T17:36:53.000946+03:00"
}
],
"description": "complaint description",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"resolutionType": "resolved",
"type": "claim",
"title": "complaint title",
"tendererAction": "Виправлено неконкурентні умови",
"dateAnswered": "2017-07-25T17:36:53.465653+03:00",
"tendererActionDate": "2017-07-25T17:36:53.465668+03:00",
"dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
"complaintID": "UA-2017-07-25-000001.5",
"date": "2017-07-25T17:36:53.471855+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "fc1eef6ef50d4656b981aae8bb181467"
}
}
Satisfied Claim¶
Satisfying resolution¶
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/fc1eef6ef50d4656b981aae8bb181467?acc_token=3df7c9a8797747c0b56aa8ac54c8ac87 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 51
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "resolved",
"satisfied": true
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "resolved",
"documents": [
{
"hash": "md5:00000000000000000000000000000000",
"author": "complaint_owner",
"title": "Complaint_Attachement.pdf",
"url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D",
"format": "application/pdf",
"documentOf": "tender",
"datePublished": "2017-07-25T17:36:53.000914+03:00",
"id": "96ad4bc79c704f6eb094b83bf2ca817a",
"dateModified": "2017-07-25T17:36:53.000946+03:00"
}
],
"description": "complaint description",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"resolutionType": "resolved",
"type": "claim",
"title": "complaint title",
"satisfied": true,
"tendererAction": "Виправлено неконкурентні умови",
"dateAnswered": "2017-07-25T17:36:53.465653+03:00",
"tendererActionDate": "2017-07-25T17:36:53.465668+03:00",
"dateSubmitted": "2017-07-25T17:36:53.127004+03:00",
"complaintID": "UA-2017-07-25-000001.5",
"date": "2017-07-25T17:36:53.605801+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "fc1eef6ef50d4656b981aae8bb181467"
}
}
Disagreement with decision¶
PATCH /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards/aec061c3b3234a9981a292ae161d2ece/complaints/d9f8daa198f44112b4ec51a00598d823?acc_token=3dbf343519cf4f26a01caf880b2d6536 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 52
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "resolved",
"satisfied": false
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"status": "resolved",
"description": "complaint description",
"title": "complaint title",
"resolutionType": "resolved",
"type": "claim",
"author": {
"contactPoint": {
"email": "soleksuk@gmail.com",
"telephone": "+380 (432) 21-69-30",
"name": "Сергій Олексюк"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00137256",
"uri": "http://www.sc.gov.ua/"
},
"name": "ДКП «Школяр»",
"address": {
"postalCode": "21100",
"countryName": "Україна",
"streetAddress": "вул. Островського, 33",
"region": "м. Вінниця",
"locality": "м. Вінниця"
}
},
"satisfied": false,
"dateAnswered": "2017-07-25T17:36:53.730015+03:00",
"dateSubmitted": "2017-07-25T17:36:53.245113+03:00",
"complaintID": "UA-2017-07-25-000001.6",
"date": "2017-07-25T17:36:53.871088+03:00",
"resolution": "Виправлено неконкурентні умови",
"id": "d9f8daa198f44112b4ec51a00598d823"
}
}
Workflow¶
Roles¶
Complainant: | dashed |
---|---|
Procuring entity: | |
plain | |
Chronograph: | dotted |
Statuses¶
draft: | Initial status Complainant can submit claim, upload documents, cancel claim, and re-submit it. |
---|---|
claim: | Procuring entity can upload documents and answer to claim. Complainant can cancel claim. |
answered: | Complainant can cancel claim, upload documents, agree or disagree with decision. |
pending: | Reviewer can upload documents and review complaint. Complainant can cancel claim. |
invalid: | Terminal status Claim recognized as invalid. |
declined: | Terminal status Claim recognized as declined. |
resolved: | Terminal status Claim recognized as resolved. |
cancelled: | Terminal status Claim cancelled by complainant. |
ignored: | Terminal status Claim ignored by procuring entity. |
Performance recommendations¶
Rate Control¶
“Aggressive” IP addresses can be restricted in the speed with which servers are processing CDB requests. In this case CDB will respond with status code 429 to the requests that returned faster than allowed.
Expected client response to such restriction is to repeat requests returned with 429 status code increasing the delay between individual requests sent to the CDB until requests become successful (2xx / 3xx responses).
Such CDB servers behavior is required in order to distribute server resources evenly between clients.
API in cluster mode¶
There is a cluster of several servers that synchronize data between each other. Client should always work with the same server to ensure consistency between separate requests to the CDB. That is why cookie is required while sending POST/PUT/PATCH/DELETE requests. Cookies provide server stickiness. You can get such cookie via GET request and then use it for POST/PUT/PATCH/DELETE.
If during operations the server requested by cookie went down or is unavailable, client will receive status code 412 of request and new cookie to use. Request should be repeated with new cookie.
2 Phase Commit¶
Mechanism of the 2-phase commit¶
The 2-phase commit provides a mechanism for CDB to publish only the tenders that clients are able to control and duplicates of which they have rights to cancel.
The reason for duplicated tenders can be cases when the requester did not receive a response from the server about tender creation and, therefore, repeated the request. Removing such tenders requires administrative intervention.
Creating tender with single-phase commit¶
Sending a single-phase request for a tender creation (POST /tenders) according to the “old” mechanism, that creates a tender already in the active.enquiries
status:
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2359
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"tenderPeriod": {
"endDate": "2017-08-08T17:36:49.306344"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"enquiryPeriod": {
"endDate": "2017-08-01T17:36:49.306344"
},
"procurementMethodType": "belowThreshold",
"value": {
"currency": "UAH",
"amount": 500
},
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344",
"endDate": "2017-07-30T17:36:49.306344"
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
]
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af
{
"access": {
"token": "2ef61fa89e8a451ba4149d2f8e31173b"
},
"data": {
"procurementMethod": "open",
"status": "active.enquiries",
"awardCriteria": "lowestCost",
"tenderPeriod": {
"startDate": "2017-08-01T17:36:49.306344+03:00",
"endDate": "2017-08-08T17:36:49.306344+03:00"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "4ee2b0431a064e0eb155eeb650bdfdd0",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"procurementMethodType": "belowThreshold",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"submissionMethod": "electronicAuction",
"date": "2017-07-25T17:36:55.659566+03:00",
"next_check": "2017-08-01T17:36:49.306344+03:00",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"enquiryPeriod": {
"startDate": "2017-07-25T17:36:55.659520+03:00",
"endDate": "2017-08-01T17:36:49.306344+03:00"
},
"owner": "broker",
"dateModified": "2017-07-25T17:36:55.662421+03:00",
"id": "f3641d0ba0f042e8b49de06d5c7921af",
"tenderID": "UA-2017-07-25-000001"
}
}
Creating tender with 2-phase commit¶
Tender becomes available after the successful completion of the following requests:
- Creation of the tender in the
draft
status. - Transfer of the tender to
active.enquiries
status through a separate request (publication).
Creation of a tender¶
A request POST /tenders creates a tender in status draft
. As a result, an acc_token
is passed for the further tender management.
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2378
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "draft",
"tenderPeriod": {
"endDate": "2017-08-08T17:36:49.306344"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35
},
"enquiryPeriod": {
"endDate": "2017-08-01T17:36:49.306344"
},
"procurementMethodType": "belowThreshold",
"value": {
"currency": "UAH",
"amount": 500
},
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ"
}
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344",
"endDate": "2017-07-30T17:36:49.306344"
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
]
}
}
201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e66dcc48a19e498984e3e5e51131ad68
{
"access": {
"token": "75424b9a8c2842d0a9c24e477ccef649"
},
"data": {
"procurementMethod": "open",
"status": "draft",
"awardCriteria": "lowestCost",
"tenderPeriod": {
"startDate": "2017-08-01T17:36:49.306344+03:00",
"endDate": "2017-08-08T17:36:49.306344+03:00"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "3e25bda8806e4d27a03dc5f9e4805f5e",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"procurementMethodType": "belowThreshold",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"submissionMethod": "electronicAuction",
"date": "2017-07-25T17:36:50.226421+03:00",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"enquiryPeriod": {
"startDate": "2017-07-25T17:36:50.226395+03:00",
"endDate": "2017-08-01T17:36:49.306344+03:00"
},
"owner": "broker",
"dateModified": "2017-07-25T17:36:50.228135+03:00",
"id": "e66dcc48a19e498984e3e5e51131ad68",
"tenderID": "UA-2017-07-25-000001"
}
}
Tender with the draft
status is “invisible” in the GET /tenders list. Chronograph does not “see” it, therefore, does not switch statuses.
Publication of a tender¶
The request PATCH /tenders/{id}?acc_token=... {“data”:{“status”:”active.enquiries”}}
changes status of tender (according to the request), therefore, publishes it (“visualizes” it in the GET /tenders list).
PATCH /api/2.3/tenders/e66dcc48a19e498984e3e5e51131ad68?acc_token=75424b9a8c2842d0a9c24e477ccef649 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 40
Content-Type: application/json
Host: api-sandbox.openprocurement.org
{
"data": {
"status": "active.enquiries"
}
}
200 OK
Content-Type: application/json; charset=UTF-8
{
"data": {
"procurementMethod": "open",
"status": "active.enquiries",
"awardCriteria": "lowestCost",
"tenderPeriod": {
"startDate": "2017-08-01T17:36:49.306344+03:00",
"endDate": "2017-08-08T17:36:49.306344+03:00"
},
"title": "футляри до державних нагород",
"minimalStep": {
"currency": "UAH",
"amount": 35.0,
"valueAddedTaxIncluded": true
},
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "ДК021",
"description": "Cartons",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"deliveryAddress": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"deliveryDate": {
"startDate": "2017-07-27T17:36:49.306344+03:00",
"endDate": "2017-07-30T17:36:49.306344+03:00"
},
"id": "3e25bda8806e4d27a03dc5f9e4805f5e",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"procurementMethodType": "belowThreshold",
"value": {
"currency": "UAH",
"amount": 500.0,
"valueAddedTaxIncluded": true
},
"submissionMethod": "electronicAuction",
"date": "2017-07-25T17:36:50.255342+03:00",
"next_check": "2017-08-01T17:36:49.306344+03:00",
"procuringEntity": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"name": "Державне управління справами",
"kind": "general",
"address": {
"postalCode": "01220",
"countryName": "Україна",
"streetAddress": "вул. Банкова, 11, корпус 1",
"region": "м. Київ",
"locality": "м. Київ"
}
},
"enquiryPeriod": {
"startDate": "2017-07-25T17:36:50.226395+03:00",
"endDate": "2017-08-01T17:36:49.306344+03:00"
},
"owner": "broker",
"dateModified": "2017-07-25T17:36:50.255342+03:00",
"id": "e66dcc48a19e498984e3e5e51131ad68",
"tenderID": "UA-2017-07-25-000001"
}
}
All tenders created in the CDB but not yet published will not be displayed on the web platform and, therefore, will not lead to their announcement.
Repeating of the request for publication in case of problem with receiving a response from the server will not cause errors.
The new mechanism is available along with the “old” one. The “old” is likely to be turned off in one of the later releases.
Work with errors¶
In case of unsuccessful request and/or 5xx errors you should check modified object data (tender, bid, award, etc.), since 5xx error response does not necessarily guarantee that request has not been performed. You should repeat this request with some interval until successful result.
You can view more detailed error description here.
Here is an example of incorrectly formed request. This error indicates that the data is not found in the body of JSON.
POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: api-sandbox.openprocurement.org
422 Unprocessable Entity
Content-Type: application/json; charset=UTF-8
{
"status": "error",
"errors": [
{
"description": "No JSON object could be decoded",
"location": "body",
"name": "data"
}
]
}
Acceleration mode for sandbox¶
Acceleration mode was developed to enable procedures’ testing in the sandbox and to reduce time frames of these procedures.
This mode will work only in the sandbox.
To enable acceleration mode you will need to:
- add additional parameter mode with a value
test
;- set
quick, accelerator=1440
as text value for procurementMethodDetails. This parameter will accelerate auction periods. The number 1440 shows that restrictions and time frames will be reduced in 1440 times.- set
quick
as a value for submissionMethodDetails. This parameter works only withmode = "test"
and will speed up auction start date.
Additional options¶
no-auction option
To enable this option: set quick(mode:no-auction)
as a value for submissionMethodDetails.
no-auction
option allows conducting tender excluding auction stage. This means that active.auction stage will be completed based on the primary bid proposals; auctionURL will not be created, so auction can not be viewed.
fast-forward option
To enable this option: set quick(mode:fast-forward)
as a value for submissionMethodDetails.
fast-forward
option allows skipping auction stage. This means that active.auction stage will be completed based on the primary bid proposals; although auctionURL will be created and auction can be viewed.