Asking Questions

Submitting Questions

Anybody (who provides their identity) can ask questions:

Request

POST /api/2.5/tenders/2f5e224866d0459cbaa950a15be70946/questions HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "author": {
      "address": {
        "countryName": "Україна",
        "locality": "м. Львів",
        "postalCode": "79013",
        "region": "Львівська область",
        "streetAddress": "вул. Островського, 34"
      },
      "contactPoint": {
        "email": "aagt@gmail.com",
        "name": "Андрій Олексюк",
        "telephone": "+380322916930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
        "id": "00137226",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Книга»"
    },
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2f5e224866d0459cbaa950a15be70946/questions/cf1cf1cf5a394133bad086c408c840a6

{
  "data": {
    "author": {
      "hash": "86c22e7b81c57c77181446cc5eeb3dba"
    },
    "title": "Калорійність",
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "questionOf": "tender",
    "id": "cf1cf1cf5a394133bad086c408c840a6",
    "date": "2023-10-10T01:00:01+03:00"
  }
}

Retrieving Questions

All appeals for clarifications and appeals for the elimination of violations are automatically published in the electronic procurement system without identification of the person who addressed the customer.

Author of question will be hashed with his identifier.id plus access token of the procedure. This gives us a possibility to determine that at the tender level a certain number of questions came from the same author.

Let’s look at asked question:

Request

GET /api/2.5/tenders/2f5e224866d0459cbaa950a15be70946/questions HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "id": "cf1cf1cf5a394133bad086c408c840a6",
      "author": {
        "hash": "86c22e7b81c57c77181446cc5eeb3dba"
      },
      "title": "Калорійність",
      "description": "Просимо додати таблицю потрібної калорійності харчування",
      "date": "2023-10-10T01:00:01+03:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "questionOf": "tender",
      "dateAnswered": "2023-10-10T01:00:01+03:00"
    }
  ]
}

Answering

Submitting Answers

Tender creator can answer questions:

Request

PATCH /api/2.5/tenders/2f5e224866d0459cbaa950a15be70946/questions/cf1cf1cf5a394133bad086c408c840a6?acc_token=f220033fc2004e90a9398defdea66c9f HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "id": "cf1cf1cf5a394133bad086c408c840a6",
    "author": {
      "hash": "86c22e7b81c57c77181446cc5eeb3dba"
    },
    "title": "Калорійність",
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "date": "2023-10-10T01:00:01+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "questionOf": "tender",
    "dateAnswered": "2023-10-10T01:00:01+03:00"
  }
}