Bidder Operations

Registration of Bid proposal

POST /tenders/64e93250be76435397e8c992ed4214d1/bids/ HTTP/1.1
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607
Also documents could be uploaded if:
  • exists award in status active

  • tender has criterion CRITERION.OTHER.CONTRACT.GUARANTEE

  • document has type contractGuarantees

Request

POST /api/2.5/tenders/24660b6d159d42adb6aaba9d978575c7/bids/7d0b2418ff254e1c827ffe021c832900/documents?acc_token=f0760e708e124c8fb9f34e562dbf59cf HTTP/1.0
Authorization: Bearer token
Content-Length: 1551
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description modified",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "author": "tender_owner",
    "documentType": "contractGuarantees"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json; charset=UTF-8

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description modified",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=RknHmCXe1C0T0rP4bqC%2FqybCY9mL8hD6Dj7IQuhLLET6hzGrSV4kuDo0XooVwu2rqKYCdVGKOqr0us8W8RLSBw%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2021-01-10T23:06:03.375403+02:00",
    "documentType": "contractGuarantees",
    "id": "89f61e167b004d8ebc8038b16341db8a",
    "dateModified": "2021-01-10T23:06:03.375436+02:00"
  }
}

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
        }
    }
}