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.10

Released: not released

New features:

0.9

Released: not released

New features:

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:

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:

  1. acc_token URL query string parameter
  2. X-Access-Token HTTP request header
  3. 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:
  • Specific header name that caused the problem (in case of header location)
  • The field name causing the error (in case of body location)
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.

Date Format: ISO 8601

The date format is ISO 8601.

http://imgs.xkcd.com/comics/iso_8601.png

Documents Uploading

All of the document uploading API endpoints follow the same set of rules.

Upload document with registration

  1. Register document upload in document service.

  2. 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"
      }
    }
    
  3. Upload document in document service.

Upload document w/o registration

  1. Register document upload in document service.

  2. 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:

  1. Prepare cancellation request
  2. Fill it with the protocol describing the cancellation reasons
  3. 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:

  • tender code (in procuring organization management system)
  • periodicity of the tender (annual, quarterly, etc.)
  • item being procured
  • some other info
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 value will be rejected.

OpenContracting Description: The total estimated value of the procurement.

guarantee:

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 procuringEntity and answers to them.

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:

  • amount should be less then Tender.value.amount
  • currency should either be absent or match Tender.value.currency
  • valueAddedTaxIncluded should either be absent or match Tender.value.valueAddedTaxIncluded
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

active.enquiries:
 Enquiries period (enquiries)
active.tendering:
 Tendering period (tendering)
active.auction:Auction period (auction)
active.qualification:
 Winner qualification (qualification)
active.awarded:Standstill period (standstill)
unsuccessful:Unsuccessful tender (unsuccessful)
complete:Complete tender (complete)
cancelled:Cancelled tender (cancelled)

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:

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:

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:

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:

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

Period during which the item should be delivered.

deliveryAddress:
 

Address

Address, where the item should be delivered.

deliveryLocation:
 

dictionary

Geographical coordinates of delivery location. Element consist of the following items:

latitude:string, required
longitude:string, required
elevation:string, optional, usually not used

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

  • notice - Tender notice

    The formal notice that gives details of a tender. This may be a link to a downloadable document, to a web page, or to an official gazette in which the notice is contained.

  • biddingDocuments - Bidding Documents

    Information for potential suppliers, describing the goals of the contract (e.g. goods and services to be procured), and the bidding process.

  • technicalSpecifications - Technical Specifications

    Detailed technical information about goods or services to be provided.

  • evaluationCriteria - Evaluation Criteria

    Information about how bids will be evaluated.

  • clarifications - Clarifications to bidders questions

    Including replies to issues raised in pre-bid conferences.

  • eligibilityCriteria - Eligibility Criteria

    Detailed documents about the eligibility of bidders.

  • shortlistedFirms - Shortlisted Firms

  • riskProvisions - Provisions for management of risks and liabilities

  • billOfQuantity - Bill Of Quantity

  • bidders - Information on bidders

    Information on bidders or participants, their validation documents and any procedural exemptions for which they qualify.

  • conflictOfInterest - Conflicts of interest uncovered

  • debarments - Debarments issued

  • contractProforma - Draft contract

Possible values for Award

  • notice - Award Notice

    The formal notice that gives details of the contract award. This may be a link to a downloadable document, to a web page, or to an official gazette in which the notice is contained.

  • evaluationReports - Evaluation report

    Report on the evaluation of the bids and the application of the evaluation criteria, including the justification fo the award.

  • winningBid - Winning Bid

  • complaints - Complaints and decisions

Possible values for Contract

  • notice - Contract notice

    The formal notice that gives details of a contract being signed and valid to start implementation. This may be a link to a downloadable document, to a web page, or to an official gazette in which the notice is contained.

  • contractSigned - Signed Contract

  • contractArrangements - Arrangements for ending contract

  • contractSchedule - Schedules and milestones

  • contractAnnexe - Annexes to the Contract

  • contractGuarantees - Guarantees

  • subContract - Subcontracts

Possible values for Bid

  • commercialProposal - Сommercial proposal
  • qualificationDocuments - Qualification documents
  • eligibilityDocuments - Eligibility documents
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:

  • tender
  • item
  • lot
relatedItem:

string

Id of related Lot or Item.

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 value will be rejected.

guarantee:

Guarantee

Bid guarantee

date:

string, Date, auto-generated

minimalStep:

Value, required

The minimal step of auction (reduction). Validation rules:

  • amount should be less then Lot.value.amount
  • currency should either be absent or match Lot.value.currency
  • valueAddedTaxIncluded should either be absent or match Lot.value.valueAddedTaxIncluded
auctionPeriod:

Period, read-only

Period when Auction is conducted.

auctionUrl:

url

A web address for view auction.

status:

string

active:Active tender lot (active)
unsuccessful:Unsuccessful tender lot (unsuccessful)
complete:Complete tender lot (complete)
cancelled:Cancelled tender lot (cancelled)

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:

  • draft
  • active
value:

Value, required

Validation rules:

  • amount should be less than Tender.value.amout
  • currency should either be absent or match Tender.value.currency
  • valueAddedTaxIncluded should either be absent or match Tender.value.valueAddedTaxIncluded
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:

  • amount should be less than Lot.value.amout
  • currency should either be absent or match Lot.value.currency
  • valueAddedTaxIncluded should either be absent or match Lot.value.valueAddedTaxIncluded
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:

  • pending - the award is under review of qualification committee
  • unsuccessful - the award has been rejected by qualification committee
  • active - the tender is awarded to the bidder from the bid_id
  • cancelled - the award has been cancelled by complaint review body
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:
 

Period

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:

  • tender
  • item
  • lot
relatedItem:

string

Id of related Lot or Item.

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:

  • draft
  • claim
  • answered
  • pending
  • invalid
  • declined
  • resolved
  • cancelled
type:

string

Possible values of type are:

  • claim
  • complaint
resolution:

string

Resolution of Procuring entity.

resolutionType:

string

Possible values of resolution type are:

  • invalid
  • declined
  • resolved
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:

  • pending - this contract has been proposed, but is not yet in force. It may be awaiting signature.
  • active - this contract has been signed by all the parties, and is now legally in force.
  • cancelled - this contract has been cancelled prior to being signed.
period:

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

Schema

startDate:

string, Date

OpenContracting Description: The start date for the period.

endDate:

string, Date

OpenContracting Description: The end date for the period.

startDate should always precede endDate.

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

Revision

Schema

date:

string, Date

Date when changes were recorded.

changes:

List of Change objects

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

Possible values are:
pending:Default. The request is being prepared.
active:Cancellation activated.
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:

  • tender
  • lot
relatedLot:

string

Id of related Lot.

Feature

Schema

code:

string, auto-generated

Code of the feature.

featureOf:

string, required

Possible values are:

  • tenderer
  • lot
  • item
relatedItem:

string

Id of related Item or Lot (only if the featureOf value is item or lot).

title:

string, multilingual, required

Title of the feature.

description:

string, multilingual

Description of the feature.

enum:

list

List of values:

value:

float, required

Value of the feature.

title:

string, multilingual, required

Title of the value.

description:

string, multilingual

Description of the value.

ProcuringEntity

Schema

name:

string, multilingual

OpenContracting Description: The common name of the organization.

identifier:

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

Possible values:
  • general - Procuring entity (general)
  • special - Procuring entity that operates in certain spheres of economic activity
  • defense - Procuring entity that conducts procurement for the defense needs
  • other - Legal persons that are not procuring entities in the sense of the Law, but are state, utility, public enterprises, economic partnerships or associations of enterprises in which state or public utility share is 50 percent or more

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

digraph G {
    claim -> answered;
    edge[style=dashed];
    draft -> claim;
    answered -> resolved;
    {draft,claim,answered} -> cancelled;
    edge[label="3d" style=dotted];
    answered -> {resolved, invalid, declined};
    edge[label="complete" style=dotted];
    claim -> ignored;
    edge[label="auto" style=dotted];
    pending -> ignored;
    pending -> {resolved, invalid, declined};
}

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:

  1. Creation of the tender in the draft status.
  2. 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 with mode = "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.

API Reference

Indices and tables