Modifying tender

On first stage you set procurementMethodType to CompetitiveDialogueEU then on second stage you have tender which similar to Open UE procedure.

You can modify only tenderPeriod.endDate and deliveryDate for items. Another changes will not be saved. Let’s update tender by supplementing it with all other essential properties:

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "tenderPeriod": {
      "endDate": "2017-07-21T17:05:32.086781+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "draft.stage2",
    "procurementMethod": "selective",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-06-21T17:05:21.942397+03:00",
      "endDate": "2017-07-21T17:05:32.086781+03:00"
    },
    "title": "Послуги шкільних їдалень",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "enquiryPeriod": {
      "startDate": "2017-06-21T17:05:21.942397+03:00",
      "clarificationsUntil": "2017-07-14T17:05:32.086781+03:00",
      "endDate": "2017-07-11T17:05:32.086781+03:00"
    },
    "complaintPeriod": {
      "startDate": "2017-06-21T17:05:21.942397+03:00",
      "endDate": "2017-07-17T00:00:00+03:00"
    },
    "title_en": "Services in school canteens",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "shortlistedFirms": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137228",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "«Кенгуру»"
      }
    ],
    "date": "2017-06-21T17:05:22.050098+03:00",
    "procurementMethodType": "competitiveDialogueEU.stage2",
    "procuringEntity": {
      "kind": "general",
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name_en": "Kutsa Svitlana V.",
        "name": "Куца Світлана Валентинівна",
        "availableLanguage": "uk",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name_en": "School #10 of Vinnytsia"
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418860+03:00",
          "endDate": "2017-08-10T17:04:37.418883+03:00"
        },
        "id": "deaf5398b54e4bd5abc5cca172a40d15",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      },
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418917+03:00",
          "endDate": "2017-08-10T17:04:37.418938+03:00"
        },
        "id": "0a0eefea19c14635ab119c2ca32c4109",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "owner": "broker",
    "dateModified": "2017-06-21T17:05:22.177644+03:00",
    "id": "2332d7f2a08e47d7a9d115ad1fee1eb8",
    "tenderID": "UA-2017-06-21-000001"
  }
}

We see the added properties have merged with existing tender data. Additionally, the dateModified property was updated to reflect the last modification timestamp.

Also we must set tender status to active.tendering for adding access to supplier

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 40
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "active.tendering"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "selective",
    "complaintPeriod": {
      "startDate": "2017-06-21T17:05:21.942397+03:00",
      "endDate": "2017-07-17T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2017-06-21T17:05:21.942397+03:00",
      "clarificationsUntil": "2017-07-14T17:05:32.086781+03:00",
      "endDate": "2017-07-11T17:05:32.086781+03:00",
      "invalidationDate": "2017-06-21T17:05:22.307607+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-07-21T17:05:32.086781+03:00",
    "awardCriteria": "lowestCost",
    "owner": "broker",
    "title_en": "Services in school canteens",
    "id": "2332d7f2a08e47d7a9d115ad1fee1eb8",
    "title": "Послуги шкільних їдалень",
    "shortlistedFirms": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137228",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "«Кенгуру»"
      }
    ],
    "tenderID": "UA-2017-06-21-000001",
    "dateModified": "2017-06-21T17:05:22.311551+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-06-21T17:05:21.942397+03:00",
      "endDate": "2017-07-21T17:05:32.086781+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-08-26T00:00:00+03:00"
    },
    "procurementMethodType": "competitiveDialogueEU.stage2",
    "date": "2017-06-21T17:05:22.311551+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418860+03:00",
          "endDate": "2017-08-10T17:04:37.418883+03:00"
        },
        "id": "deaf5398b54e4bd5abc5cca172a40d15",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      },
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418917+03:00",
          "endDate": "2017-08-10T17:04:37.418938+03:00"
        },
        "id": "0a0eefea19c14635ab119c2ca32c4109",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "procuringEntity": {
      "kind": "general",
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name_en": "Kutsa Svitlana V.",
        "name": "Куца Світлана Валентинівна",
        "availableLanguage": "uk",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name_en": "School #10 of Vinnytsia"
    }
  }
}

Checking the listing again reflects the new modification date:

GET /api/2.3/tenders HTTP/1.0
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.3/tenders?offset=2017-06-21T17%3A05%3A22.311551%2B03%3A00",
    "uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=2017-06-21T17%3A05%3A22.311551%2B03%3A00",
    "offset": "2017-06-21T17:05:22.311551+03:00"
  },
  "data": [
    {
      "id": "2332d7f2a08e47d7a9d115ad1fee1eb8",
      "dateModified": "2017-06-21T17:05:22.311551+03:00"
    }
  ]
}

Procuring entity can not change tender if there are less than 7 days before tenderPeriod ends. Changes will not be accepted by API.

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 88
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "items": [
      {
        "deliveryDate": {
          "endDate": "2017-07-21T17:05:33.111966+03:00"
        }
      }
    ]
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "tenderPeriod should be extended by 7 days",
      "location": "body",
      "name": "data"
    }
  ]
}

That is why tenderPeriod has to be extended by 7 days.

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 153
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "items": [
      {
        "deliveryDate": {
          "endDate": "2017-07-21T17:05:33.111966+03:00"
        }
      }
    ],
    "tenderPeriod": {
      "endDate": "2017-06-29T17:05:23.269042+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "selective",
    "complaintPeriod": {
      "startDate": "2017-05-24T17:05:23.055180+03:00",
      "endDate": "2017-06-25T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2017-05-24T17:05:23.055180+03:00",
      "clarificationsUntil": "2017-06-22T17:05:23.269042+03:00",
      "endDate": "2017-06-19T17:05:23.269042+03:00",
      "invalidationDate": "2017-06-21T17:05:23.394986+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-06-29T17:05:23.269042+03:00",
    "procuringEntity": {
      "kind": "general",
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name_en": "Kutsa Svitlana V.",
        "name": "Куца Світлана Валентинівна",
        "availableLanguage": "uk",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name_en": "School #10 of Vinnytsia"
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "dateAnswered": "2017-06-21T17:05:22.936772+03:00",
        "title": "Калорійність",
        "date": "2017-06-21T17:05:22.844259+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "bde54af3cda441318b0bc1e6d2eaca50",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "title_en": "Services in school canteens",
    "id": "2332d7f2a08e47d7a9d115ad1fee1eb8",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "Notice.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/f8910e202a3f451a904ae67142358a74?KeyID=d8e133db&Signature=gWwLvym6za8Ii%252BfpoueQoftCtQSE4M%2FyyNKu%2FtLjuy96l%2FYJoH%252BUFQ4Up8YpoFnppZo1mHxGOuZ2XMOK49ZLDg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.481301+03:00",
        "id": "95a16064160d49fe820a8bee63fff415",
        "dateModified": "2017-06-21T17:05:22.481335+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "AwardCriteria.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/ce58586989224de490b806440143b41d?KeyID=d8e133db&Signature=b9Xyx9Qm%2F3JUf4IAH2qKtQ7%252B%2FfwQRi9tS7Yt9oO8xik8aADhYrFkseVF%252B6qbOqHpRvLifBng3TvOtW2m8%2F7fAA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.579293+03:00",
        "id": "cdf2efa990af4673a6d98331cf0c9652",
        "dateModified": "2017-06-21T17:05:22.579325+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/2efac33fede54b789b8bdc5c9bafb582?KeyID=d8e133db&Signature=0Y21zun5rS5AtRSEHnc0FGr%252B%252BoEq9iM3NZxfhyWEwbjnHBljzh%252BBBcBaLD%2F3hRwl8OWp6rlw5%2FaaPN1JAlU%2FBg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.579293+03:00",
        "id": "cdf2efa990af4673a6d98331cf0c9652",
        "dateModified": "2017-06-21T17:05:22.687041+03:00"
      }
    ],
    "title": "Послуги шкільних їдалень",
    "shortlistedFirms": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137228",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "«Кенгуру»"
      }
    ],
    "tenderID": "UA-2017-06-21-000001",
    "dateModified": "2017-06-21T17:05:23.399658+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-05-24T17:05:23.055180+03:00",
      "endDate": "2017-06-29T17:05:23.269042+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-08-04T00:00:00+03:00"
    },
    "procurementMethodType": "competitiveDialogueEU.stage2",
    "date": "2017-06-21T17:05:22.311551+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418860+03:00",
          "endDate": "2017-07-21T17:05:33.111966+03:00"
        },
        "id": "deaf5398b54e4bd5abc5cca172a40d15",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

Uploading documentation

Procuring entity can upload PDF files into the created tender. Uploading should follow the Documents Uploading rules.

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/documents?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 186
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy823892585233$
Host: api-sandbox.openprocurement.org


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/documents/95a16064160d49fe820a8bee63fff415
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "language": "uk",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/f8910e202a3f451a904ae67142358a74?KeyID=d8e133db&Signature=gWwLvym6za8Ii%252BfpoueQoftCtQSE4M%2FyyNKu%2FtLjuy96l%2FYJoH%252BUFQ4Up8YpoFnppZo1mHxGOuZ2XMOK49ZLDg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T17:05:22.481301+03:00",
    "id": "95a16064160d49fe820a8bee63fff415",
    "dateModified": "2017-06-21T17:05:22.481335+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/2332d7f2a08e47d7a9d115ad1fee1eb8/documents/95a16064160d49fe820a8bee63fff415?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "language": "uk",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/f8910e202a3f451a904ae67142358a74?KeyID=d8e133db&Signature=gWwLvym6za8Ii%252BfpoueQoftCtQSE4M%2FyyNKu%2FtLjuy96l%2FYJoH%252BUFQ4Up8YpoFnppZo1mHxGOuZ2XMOK49ZLDg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T17:05:22.481301+03:00",
    "previousVersions": [],
    "id": "95a16064160d49fe820a8bee63fff415",
    "dateModified": "2017-06-21T17:05:22.481335+03:00"
  }
}

The single array element describes the uploaded document. We can upload more documents:

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/documents?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 193
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy753193821554$
Host: api-sandbox.openprocurement.org


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/documents/cdf2efa990af4673a6d98331cf0c9652
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "language": "uk",
    "title": "AwardCriteria.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/ce58586989224de490b806440143b41d?KeyID=d8e133db&Signature=b9Xyx9Qm%2F3JUf4IAH2qKtQ7%252B%2FfwQRi9tS7Yt9oO8xik8aADhYrFkseVF%252B6qbOqHpRvLifBng3TvOtW2m8%2F7fAA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T17:05:22.579293+03:00",
    "id": "cdf2efa990af4673a6d98331cf0c9652",
    "dateModified": "2017-06-21T17:05:22.579325+03:00"
  }
}

And again we can confirm that there are two documents uploaded.

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/documents?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "language": "uk",
      "title": "Notice.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/f8910e202a3f451a904ae67142358a74?KeyID=d8e133db&Signature=gWwLvym6za8Ii%252BfpoueQoftCtQSE4M%2FyyNKu%2FtLjuy96l%2FYJoH%252BUFQ4Up8YpoFnppZo1mHxGOuZ2XMOK49ZLDg%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T17:05:22.481301+03:00",
      "id": "95a16064160d49fe820a8bee63fff415",
      "dateModified": "2017-06-21T17:05:22.481335+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "language": "uk",
      "title": "AwardCriteria.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/ce58586989224de490b806440143b41d?KeyID=d8e133db&Signature=b9Xyx9Qm%2F3JUf4IAH2qKtQ7%252B%2FfwQRi9tS7Yt9oO8xik8aADhYrFkseVF%252B6qbOqHpRvLifBng3TvOtW2m8%2F7fAA%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T17:05:22.579293+03:00",
      "id": "cdf2efa990af4673a6d98331cf0c9652",
      "dateModified": "2017-06-21T17:05:22.579325+03:00"
    }
  ]
}

In case we made an error, we can reupload the document over the older version:

PUT /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/documents/cdf2efa990af4673a6d98331cf0c9652?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 196
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy801683233515$
Host: api-sandbox.openprocurement.org


Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "language": "uk",
    "title": "AwardCriteria-2.pdf",
    "url": "http://public.docs-sandbox.openprocurement.org/get/2efac33fede54b789b8bdc5c9bafb582?KeyID=d8e133db&Signature=0Y21zun5rS5AtRSEHnc0FGr%252B%252BoEq9iM3NZxfhyWEwbjnHBljzh%252BBBcBaLD%2F3hRwl8OWp6rlw5%2FaaPN1JAlU%2FBg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T17:05:22.579293+03:00",
    "id": "cdf2efa990af4673a6d98331cf0c9652",
    "dateModified": "2017-06-21T17:05:22.687041+03:00"
  }
}

And we can see that it is overriding the original version:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "language": "uk",
      "title": "Notice.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/f8910e202a3f451a904ae67142358a74?KeyID=d8e133db&Signature=gWwLvym6za8Ii%252BfpoueQoftCtQSE4M%2FyyNKu%2FtLjuy96l%2FYJoH%252BUFQ4Up8YpoFnppZo1mHxGOuZ2XMOK49ZLDg%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T17:05:22.481301+03:00",
      "id": "95a16064160d49fe820a8bee63fff415",
      "dateModified": "2017-06-21T17:05:22.481335+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "language": "uk",
      "title": "AwardCriteria-2.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/2efac33fede54b789b8bdc5c9bafb582?KeyID=d8e133db&Signature=0Y21zun5rS5AtRSEHnc0FGr%252B%252BoEq9iM3NZxfhyWEwbjnHBljzh%252BBBcBaLD%2F3hRwl8OWp6rlw5%2FaaPN1JAlU%2FBg%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T17:05:22.579293+03:00",
      "id": "cdf2efa990af4673a6d98331cf0c9652",
      "dateModified": "2017-06-21T17:05:22.687041+03:00"
    }
  ]
}

Enquiries

When tender has active.tendering status and Tender.enqueryPeriod.endDate hasn’t come yet, interested parties can ask questions: Ask question can only participants which were approved on first stage, someone else try ask, he catch error

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1057
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "author": {
      "contactPoint": {
        "telephone": "+380 (452) 21-69-31",
        "name": "Вільям Поле",
        "email": "pole@gmail.com"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "ТОВ Бур",
        "id": "00137230",
        "uri": "http://pole.edu.vn.ua/"
      },
      "name": "ТОВ \"Бур\"",
      "address": {
        "countryName": "Україна",
        "postalCode": "21100",
        "region": "м. Львів",
        "streetAddress": "вул. Поле, 33",
        "locality": "м. Львів"
      }
    },
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність"
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Author can't create question",
      "location": "body",
      "name": "author"
    }
  ]
}

Now participant from first stage try create question.

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "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": "Калорійність"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/questions/bde54af3cda441318b0bc1e6d2eaca50
{
  "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-06-21T17:05:22.844259+03:00",
    "id": "bde54af3cda441318b0bc1e6d2eaca50",
    "questionOf": "tender"
  }
}

Procuring entity can answer them:

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/questions/bde54af3cda441318b0bc1e6d2eaca50?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "dateAnswered": "2017-06-21T17:05:22.936772+03:00",
    "title": "Калорійність",
    "date": "2017-06-21T17:05:22.844259+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "bde54af3cda441318b0bc1e6d2eaca50",
    "questionOf": "tender"
  }
}

One can retrieve either questions list:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "description": "Просимо додати таблицю потрібної калорійності харчування",
      "dateAnswered": "2017-06-21T17:05:22.936772+03:00",
      "title": "Калорійність",
      "date": "2017-06-21T17:05:22.844259+03:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "id": "bde54af3cda441318b0bc1e6d2eaca50",
      "questionOf": "tender"
    }
  ]
}

or individual answer:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/questions/bde54af3cda441318b0bc1e6d2eaca50 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "dateAnswered": "2017-06-21T17:05:22.936772+03:00",
    "title": "Калорійність",
    "date": "2017-06-21T17:05:22.844259+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "bde54af3cda441318b0bc1e6d2eaca50",
    "questionOf": "tender"
  }
}

Enquiries can be made only during Tender.enqueryPeriod

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "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": "Калорійність"
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Can add question only in enquiryPeriod",
      "location": "body",
      "name": "data"
    }
  ]
}

Registering bid

Tender status active.tendering allows registration of bids. Bidder can register a bid with draft status.

Like with question only approved participants can register bid. If participant which did not was on first stage try create bid, he will catch error

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 871
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "draft",
    "selfEligible": true,
    "value": {
      "amount": 500
    },
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "tenderers": [
      {
        "contactPoint": {
          "telephone": "+380 (452) 21-69-31",
          "name": "Вільям Поле",
          "email": "pole@gmail.com"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "ТОВ Бур",
          "id": "00137230",
          "uri": "http://pole.edu.vn.ua/"
        },
        "name": "ТОВ \"Бур\"",
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Львів",
          "streetAddress": "вул. Поле, 33",
          "locality": "м. Львів"
        }
      }
    ],
    "selfQualified": true
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Firm can't create bid",
      "location": "body",
      "name": "data"
    }
  ]
}

Get error, now participant from first stage try

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 936
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "draft",
    "selfEligible": true,
    "value": {
      "amount": 500
    },
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "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": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "selfQualified": true
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690
{
  "access": {
    "token": "6924864ccd3c4ab7a63cfad5f123b5f1"
  },
  "data": {
    "status": "draft",
    "selfEligible": true,
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "selfQualified": 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-06-21T17:05:23.537907+03:00",
    "id": "b20022ca69d243eb917e5ff3217b6690"
  }
}

and approve to pending status:

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690?acc_token=6924864ccd3c4ab7a63cfad5f123b5f1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "pending"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "selfEligible": true,
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "selfQualified": 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-06-21T17:05:23.537907+03:00",
    "id": "b20022ca69d243eb917e5ff3217b6690"
  }
}

Proposal Uploading

Then bidder should upload proposal technical document(s):

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents?acc_token=6924864ccd3c4ab7a63cfad5f123b5f1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 188
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy294481539282$
Host: api-sandbox.openprocurement.org


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/04c9706c7da9437aa10ad604cdb303fb
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "confidentiality": "public",
    "language": "uk",
    "title": "Proposal.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/04c9706c7da9437aa10ad604cdb303fb?download=840d9651238e4aecb276d74f5c5232e1",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T17:05:23.746947+03:00",
    "id": "04c9706c7da9437aa10ad604cdb303fb",
    "dateModified": "2017-06-21T17:05:23.746988+03:00"
  }
}

Confidentiality

Documents can be either public or private:

  1. Privacy settings can be changed only for the latest version of the document.
  2. When you upload new version of the document, privacy settings are copied from the previous version.
  3. Privacy settings can be changed only during tenderPeriod (with active.tendering status).
  4. If tender has status active.qualification winner can upload only public documents.

Let’s upload private document:

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents?acc_token=6924864ccd3c4ab7a63cfad5f123b5f1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 200
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy353139828206$
Host: api-sandbox.openprocurement.org


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "confidentiality": "public",
    "language": "uk",
    "title": "Proposal_top_secrets.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451?download=cfc5737256d04935bfd99398ec7b861c",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T17:05:23.847161+03:00",
    "id": "91b40d8996d24aee9836d57ea3285451",
    "dateModified": "2017-06-21T17:05:23.847195+03:00"
  }
}

To define the document as “private” - confidentiality and confidentialityRationale fields should be set.

confidentiality field value can be either buyerOnly (document is private) or public (document is publicly accessible).

Content of private documents (buyerOnly) can be accessed only by procuring entity or by participant who uploaded them.

confidentialityRationale field is required only for private documents and should contain at least 30 characters.

Let’s mark the document as “private”:

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451?acc_token=6924864ccd3c4ab7a63cfad5f123b5f1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 120
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "confidentialityRationale": "Only our company sells badgers with pink hair.",
    "confidentiality": "buyerOnly"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "confidentiality": "buyerOnly",
    "language": "uk",
    "format": "application/pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451?download=cfc5737256d04935bfd99398ec7b861c",
    "confidentialityRationale": "Only our company sells badgers with pink hair.",
    "title": "Proposal_top_secrets.pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T17:05:23.847161+03:00",
    "id": "91b40d8996d24aee9836d57ea3285451",
    "dateModified": "2017-06-21T17:05:23.847195+03:00"
  }
}

It is possible to check the uploaded documents:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents?acc_token=6924864ccd3c4ab7a63cfad5f123b5f1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "confidentiality": "public",
      "language": "uk",
      "title": "Proposal.pdf",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/04c9706c7da9437aa10ad604cdb303fb?download=840d9651238e4aecb276d74f5c5232e1",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T17:05:23.746947+03:00",
      "id": "04c9706c7da9437aa10ad604cdb303fb",
      "dateModified": "2017-06-21T17:05:23.746988+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "confidentiality": "buyerOnly",
      "language": "uk",
      "format": "application/pdf",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451?download=cfc5737256d04935bfd99398ec7b861c",
      "confidentialityRationale": "Only our company sells badgers with pink hair.",
      "title": "Proposal_top_secrets.pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T17:05:23.847161+03:00",
      "id": "91b40d8996d24aee9836d57ea3285451",
      "dateModified": "2017-06-21T17:05:23.847195+03:00"
    }
  ]
}

Financial documents uploading

Financial documents are also a part of Bid but are located in different end-points.

In order to create and/or get financial document financial_documents end-point should be used:

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents?acc_token=6924864ccd3c4ab7a63cfad5f123b5f1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 191
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy803990521657$
Host: api-sandbox.openprocurement.org


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents/7057c22c715e4754a6e44deca8a3beb1
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "confidentiality": "public",
    "language": "uk",
    "title": "financial_doc.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents/7057c22c715e4754a6e44deca8a3beb1?download=0797f04b09374fd99ddd490ce36a5498",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T17:05:24.125000+03:00",
    "id": "7057c22c715e4754a6e44deca8a3beb1",
    "dateModified": "2017-06-21T17:05:24.125046+03:00"
  }
}

Get financial documents:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents?acc_token=6924864ccd3c4ab7a63cfad5f123b5f1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "confidentiality": "public",
      "language": "uk",
      "title": "financial_doc.pdf",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents/7057c22c715e4754a6e44deca8a3beb1?download=0797f04b09374fd99ddd490ce36a5498",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T17:05:24.125000+03:00",
      "id": "7057c22c715e4754a6e44deca8a3beb1",
      "dateModified": "2017-06-21T17:05:24.125046+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "confidentiality": "public",
      "language": "uk",
      "title": "financial_doc2.pdf",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents/eccb2caf274542baa27a7aa9969dbd05?download=5683971956124d43899986b84da70eb9",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T17:05:24.251934+03:00",
      "id": "eccb2caf274542baa27a7aa9969dbd05",
      "dateModified": "2017-06-21T17:05:24.251972+03:00"
    }
  ]
}

Financial documents will be publicly accessible after the auction.

Here is bidder proposal with all documents.

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690?acc_token=6924864ccd3c4ab7a63cfad5f123b5f1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "Proposal.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/04c9706c7da9437aa10ad604cdb303fb?download=840d9651238e4aecb276d74f5c5232e1",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:23.746947+03:00",
        "id": "04c9706c7da9437aa10ad604cdb303fb",
        "dateModified": "2017-06-21T17:05:23.746988+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "buyerOnly",
        "language": "uk",
        "format": "application/pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451?download=cfc5737256d04935bfd99398ec7b861c",
        "confidentialityRationale": "Only our company sells badgers with pink hair.",
        "title": "Proposal_top_secrets.pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:23.847161+03:00",
        "id": "91b40d8996d24aee9836d57ea3285451",
        "dateModified": "2017-06-21T17:05:23.847195+03:00"
      }
    ],
    "selfEligible": true,
    "id": "b20022ca69d243eb917e5ff3217b6690",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "selfQualified": true,
    "financialDocuments": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "financial_doc.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents/7057c22c715e4754a6e44deca8a3beb1?download=0797f04b09374fd99ddd490ce36a5498",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:24.125000+03:00",
        "id": "7057c22c715e4754a6e44deca8a3beb1",
        "dateModified": "2017-06-21T17:05:24.125046+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "financial_doc2.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents/eccb2caf274542baa27a7aa9969dbd05?download=5683971956124d43899986b84da70eb9",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:24.251934+03:00",
        "id": "eccb2caf274542baa27a7aa9969dbd05",
        "dateModified": "2017-06-21T17:05:24.251972+03:00"
      }
    ],
    "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-06-21T17:05:23.537907+03:00",
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "qualificationDocuments": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "qualification_document.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/qualification_documents/d9d88ad159e742d396257362cd3d4f1b?download=8d3e83edaeda49cfa17ad86459fe51a5",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:24.427305+03:00",
        "id": "d9d88ad159e742d396257362cd3d4f1b",
        "dateModified": "2017-06-21T17:05:24.427338+03:00"
      }
    ]
  }
}

Note that financial documents are stored in financialDocuments attributes of Bid second stage.

Bid invalidation

If tender is modified, status of all bid proposals will be changed to invalid. Bid proposal will look the following way after tender has been modified:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690?acc_token=6924864ccd3c4ab7a63cfad5f123b5f1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "invalid",
    "id": "b20022ca69d243eb917e5ff3217b6690"
  }
}

Bid confirmation

Bidder should confirm bid proposal:

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690?acc_token=6924864ccd3c4ab7a63cfad5f123b5f1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "pending"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "Proposal.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/04c9706c7da9437aa10ad604cdb303fb?download=840d9651238e4aecb276d74f5c5232e1",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:23.746947+03:00",
        "id": "04c9706c7da9437aa10ad604cdb303fb",
        "dateModified": "2017-06-21T17:05:23.746988+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "buyerOnly",
        "language": "uk",
        "format": "application/pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451?download=cfc5737256d04935bfd99398ec7b861c",
        "confidentialityRationale": "Only our company sells badgers with pink hair.",
        "title": "Proposal_top_secrets.pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:23.847161+03:00",
        "id": "91b40d8996d24aee9836d57ea3285451",
        "dateModified": "2017-06-21T17:05:23.847195+03:00"
      }
    ],
    "selfEligible": true,
    "id": "b20022ca69d243eb917e5ff3217b6690",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "selfQualified": true,
    "financialDocuments": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "financial_doc.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents/7057c22c715e4754a6e44deca8a3beb1?download=0797f04b09374fd99ddd490ce36a5498",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:24.125000+03:00",
        "id": "7057c22c715e4754a6e44deca8a3beb1",
        "dateModified": "2017-06-21T17:05:24.125046+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "financial_doc2.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents/eccb2caf274542baa27a7aa9969dbd05?download=5683971956124d43899986b84da70eb9",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:24.251934+03:00",
        "id": "eccb2caf274542baa27a7aa9969dbd05",
        "dateModified": "2017-06-21T17:05:24.251972+03:00"
      }
    ],
    "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-06-21T17:05:23.537907+03:00",
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "qualificationDocuments": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "qualification_document.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/qualification_documents/d9d88ad159e742d396257362cd3d4f1b?download=8d3e83edaeda49cfa17ad86459fe51a5",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:24.427305+03:00",
        "id": "d9d88ad159e742d396257362cd3d4f1b",
        "dateModified": "2017-06-21T17:05:24.427338+03:00"
      }
    ]
  }
}

Second stage EU Competitive Dialogue procedure demands at least two bidders, so there should be at least two bid proposals registered to move to auction stage:

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 749
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "selfEligible": true,
    "selfQualified": true,
    "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": "м. Львів"
        }
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/f8c0332fc19b4723a6b2f279c81dc7a0
{
  "access": {
    "token": "17cfcc23652a432882ded40441115511"
  },
  "data": {
    "status": "pending",
    "selfEligible": true,
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "selfQualified": 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-06-21T17:05:25.080950+03:00",
    "id": "f8c0332fc19b4723a6b2f279c81dc7a0"
  }
}

Batch-mode bid registration

Register one more bid with documents using single request (batch-mode):

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2628
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "documents": [
      {
        "url": "http://public.docs-sandbox.openprocurement.org/get/c5c2fc1b3eb540898cbc9fb85613e00c?KeyID=d8e133db&Signature=xvxzhI%2FElA%2Fc6CcCj4Rb9kyoV%2B%2BC0IltXlbEFtKoBcB8gK9lTf%2BiPCWSIi3pHOtpKq%2FyYtkoeow4kG82uKziBg%3D%3D",
        "title": "Proposal_part1.pdf",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "buyerOnly",
        "title": "Proposal_part2.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/752877b3e3fe4d2e864edb3bd41b43c7?KeyID=d8e133db&Signature=t6qOz4d2uS2UQaCMULRnDyRrzcyuTs1lxmGQWtee2H3ctFlExhwiB4SCfMriPFiKrUbTLEdJGKurFQcUWE8QCg%3D%3D",
        "confidentialityRationale": "Only our company sells badgers with pink hair.",
        "format": "application/pdf"
      }
    ],
    "eligibilityDocuments": [
      {
        "url": "http://public.docs-sandbox.openprocurement.org/get/5e5958cbd3744e45b38a1ac0219a1e3b?KeyID=d8e133db&Signature=6oKf9AyXS53nxY5kWZRZFcK6ea0O4w0x56apEcqgroAbhZkXfvKekD%2FRRP%2BzYmSkHpynLxc6OoYd0aSw64vcAA%3D%3D",
        "title": "eligibility_doc.pdf",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      }
    ],
    "selfEligible": true,
    "value": {
      "amount": 5
    },
    "selfQualified": true,
    "financialDocuments": [
      {
        "url": "http://public.docs-sandbox.openprocurement.org/get/3de37f6a21d24960ae6305236fd95778?KeyID=d8e133db&Signature=qgYgWTEKu9XddBidbuujltcg43%2FOegqk9KzXpWWWr9Nxa7vnt4wGksoV0Fu8Unbz%2BvZ%2Bm7tQrHNm2PkB0SZ6DQ%3D%3D",
        "title": "financial_doc.pdf",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "email": "fake@mail.com",
          "telephone": "+380 (322) 12-34-56",
          "name": "Іван Карпенко"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137228",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "«Кенгуру»",
        "address": {
          "countryName": "Україна",
          "postalCode": "79013",
          "region": "м. Запоріжжя",
          "streetAddress": "вул. Коцюбинського, 15",
          "locality": "м. Запоріжя"
        }
      }
    ],
    "qualificationDocuments": [
      {
        "url": "http://public.docs-sandbox.openprocurement.org/get/c0cdd8c158e34d46b53ea992aeb8a8b1?KeyID=d8e133db&Signature=kGG8WqAhlBCM6K0XjOT7gvtfCaVuYN9BuHyAPuO8QlqUY2C%2FgJctZtUfq%2Fl1eys7GgYEnHbn44FADzJSKgoqAg%3D%3D",
        "title": "qualification_document.pdf",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44
{
  "access": {
    "token": "c78c14ab6595492a94f427332b7646e9"
  },
  "data": {
    "status": "pending",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "Proposal_part1.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44/documents/2db5d8034cbe4f35bd79070d35f56d96?download=c5c2fc1b3eb540898cbc9fb85613e00c",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:25.237642+03:00",
        "id": "2db5d8034cbe4f35bd79070d35f56d96",
        "dateModified": "2017-06-21T17:05:25.237674+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "buyerOnly",
        "language": "uk",
        "format": "application/pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44/documents/a61142ae42264111a7e2777ea98d9d73?download=752877b3e3fe4d2e864edb3bd41b43c7",
        "confidentialityRationale": "Only our company sells badgers with pink hair.",
        "title": "Proposal_part2.pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:25.238576+03:00",
        "id": "a61142ae42264111a7e2777ea98d9d73",
        "dateModified": "2017-06-21T17:05:25.238607+03:00"
      }
    ],
    "eligibilityDocuments": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "eligibility_doc.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44/eligibility_documents/7a9e8cb3065140e6a71dc636da084e49?download=5e5958cbd3744e45b38a1ac0219a1e3b",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:25.240462+03:00",
        "id": "7a9e8cb3065140e6a71dc636da084e49",
        "dateModified": "2017-06-21T17:05:25.240493+03:00"
      }
    ],
    "selfEligible": true,
    "id": "9b6ebf9b1b604decadf2ee8ba69f6d44",
    "value": {
      "currency": "UAH",
      "amount": 5.0,
      "valueAddedTaxIncluded": true
    },
    "selfQualified": true,
    "financialDocuments": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "financial_doc.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44/financial_documents/c5ccb37065744bfa913f3ef980377f06?download=3de37f6a21d24960ae6305236fd95778",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:25.239529+03:00",
        "id": "c5ccb37065744bfa913f3ef980377f06",
        "dateModified": "2017-06-21T17:05:25.239560+03:00"
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "email": "fake@mail.com",
          "telephone": "+380 (322) 12-34-56",
          "name": "Іван Карпенко"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137228",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "«Кенгуру»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Коцюбинського, 15",
          "region": "м. Запоріжжя",
          "locality": "м. Запоріжя"
        }
      }
    ],
    "date": "2017-06-21T17:05:25.236560+03:00",
    "qualificationDocuments": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "qualification_document.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44/qualification_documents/a9cdc9933c49414f9fcb9dc8a815f2da?download=c0cdd8c158e34d46b53ea992aeb8a8b1",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:25.244714+03:00",
        "id": "a9cdc9933c49414f9fcb9dc8a815f2da",
        "dateModified": "2017-06-21T17:05:25.244766+03:00"
      }
    ]
  }
}

Bid Qualification

On second stage in Competitive Dialogue procedure requires bid qualification.

Let’s list qualifications:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "selective",
    "status": "active.pre-qualification",
    "complaintPeriod": {
      "startDate": "2017-05-21T17:04:37.384821+03:00",
      "endDate": "2017-06-17T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2017-05-21T17:04:37.384821+03:00",
      "clarificationsUntil": "2017-06-15T00:00:00+03:00",
      "endDate": "2017-06-11T17:04:37.384821+03:00",
      "invalidationDate": "2017-06-21T17:05:24.738173+03:00"
    },
    "submissionMethod": "electronicAuction",
    "procuringEntity": {
      "kind": "general",
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name_en": "Kutsa Svitlana V.",
        "name": "Куца Світлана Валентинівна",
        "availableLanguage": "uk",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name_en": "School #10 of Vinnytsia"
    },
    "questions": [
      {
        "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-06-21T17:05:22.844259+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "dateAnswered": "2017-06-21T17:05:22.936772+03:00",
        "id": "bde54af3cda441318b0bc1e6d2eaca50",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "title_en": "Services in school canteens",
    "id": "2332d7f2a08e47d7a9d115ad1fee1eb8",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "Notice.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/f8910e202a3f451a904ae67142358a74?KeyID=d8e133db&Signature=gWwLvym6za8Ii%252BfpoueQoftCtQSE4M%2FyyNKu%2FtLjuy96l%2FYJoH%252BUFQ4Up8YpoFnppZo1mHxGOuZ2XMOK49ZLDg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.481301+03:00",
        "id": "95a16064160d49fe820a8bee63fff415",
        "dateModified": "2017-06-21T17:05:22.481335+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "AwardCriteria.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/ce58586989224de490b806440143b41d?KeyID=d8e133db&Signature=b9Xyx9Qm%2F3JUf4IAH2qKtQ7%252B%2FfwQRi9tS7Yt9oO8xik8aADhYrFkseVF%252B6qbOqHpRvLifBng3TvOtW2m8%2F7fAA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.579293+03:00",
        "id": "cdf2efa990af4673a6d98331cf0c9652",
        "dateModified": "2017-06-21T17:05:22.579325+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/2efac33fede54b789b8bdc5c9bafb582?KeyID=d8e133db&Signature=0Y21zun5rS5AtRSEHnc0FGr%252B%252BoEq9iM3NZxfhyWEwbjnHBljzh%252BBBcBaLD%2F3hRwl8OWp6rlw5%2FaaPN1JAlU%2FBg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.579293+03:00",
        "id": "cdf2efa990af4673a6d98331cf0c9652",
        "dateModified": "2017-06-21T17:05:22.687041+03:00"
      }
    ],
    "title": "Послуги шкільних їдалень",
    "qualificationPeriod": {
      "startDate": "2017-06-21T17:05:25.702974+03:00"
    },
    "shortlistedFirms": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137228",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "«Кенгуру»"
      }
    ],
    "tenderID": "UA-2017-06-21-000001",
    "dateModified": "2017-06-21T17:05:25.715881+03:00",
    "numberOfBids": 3,
    "tenderPeriod": {
      "startDate": "2017-05-21T17:04:37.384821+03:00",
      "endDate": "2017-06-21T17:04:37.384821+03:00"
    },
    "qualifications": [
      {
        "status": "pending",
        "eligible": false,
        "qualified": false,
        "bidID": "b20022ca69d243eb917e5ff3217b6690",
        "date": "2017-06-21T17:05:25.703823+03:00",
        "id": "42905e11333041e28283033b6665157f"
      },
      {
        "status": "pending",
        "eligible": false,
        "qualified": false,
        "bidID": "f8c0332fc19b4723a6b2f279c81dc7a0",
        "date": "2017-06-21T17:05:25.704221+03:00",
        "id": "bdd5f929a40f4f85b1eacb2aafca8630"
      },
      {
        "status": "pending",
        "eligible": false,
        "qualified": false,
        "bidID": "9b6ebf9b1b604decadf2ee8ba69f6d44",
        "date": "2017-06-21T17:05:25.704587+03:00",
        "id": "d44f5f78147b493ebdbe98ae275f9e9e"
      }
    ],
    "procurementMethodType": "competitiveDialogueEU.stage2",
    "date": "2017-06-21T17:05:25.715881+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418860+03:00",
          "endDate": "2017-07-21T17:05:33.111966+03:00"
        },
        "id": "deaf5398b54e4bd5abc5cca172a40d15",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "bids": [
      {
        "status": "pending",
        "documents": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "public",
            "language": "uk",
            "title": "Proposal.pdf",
            "url": "http://public.docs-sandbox.openprocurement.org/get/840d9651238e4aecb276d74f5c5232e1?KeyID=d8e133db&Signature=k5ryxv5psu9N0pCKmN4usarO%252BnzmUIJAdSQMCd31FIbxPLUwcHX2jJ4rN3%252BcED%252BzGgYiscOCH9VMxaRl1ZK8AQ%253D%253D",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:23.746947+03:00",
            "id": "04c9706c7da9437aa10ad604cdb303fb",
            "dateModified": "2017-06-21T17:05:23.746988+03:00"
          },
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "buyerOnly",
            "language": "uk",
            "format": "application/pdf",
            "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451?download=cfc5737256d04935bfd99398ec7b861c",
            "confidentialityRationale": "Only our company sells badgers with pink hair.",
            "title": "Proposal_top_secrets.pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:23.847161+03:00",
            "id": "91b40d8996d24aee9836d57ea3285451",
            "dateModified": "2017-06-21T17:05:23.847195+03:00"
          }
        ],
        "id": "b20022ca69d243eb917e5ff3217b6690",
        "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": "м. Вінниця"
            }
          }
        ]
      },
      {
        "status": "pending",
        "id": "f8c0332fc19b4723a6b2f279c81dc7a0",
        "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": "м. Львів"
            }
          }
        ]
      },
      {
        "status": "pending",
        "documents": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "public",
            "language": "uk",
            "title": "Proposal_part1.pdf",
            "url": "http://public.docs-sandbox.openprocurement.org/get/c5c2fc1b3eb540898cbc9fb85613e00c?KeyID=d8e133db&Signature=JjnzyrMFnY4JiLWZa%252BGqPKnXIgsXfFhzPEU9Wh6woF49752EH8Dxirg1wG0GeONKFeiluD1xAVibhxp5wqp6BA%253D%253D",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:25.237642+03:00",
            "id": "2db5d8034cbe4f35bd79070d35f56d96",
            "dateModified": "2017-06-21T17:05:25.237674+03:00"
          },
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "buyerOnly",
            "language": "uk",
            "format": "application/pdf",
            "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44/documents/a61142ae42264111a7e2777ea98d9d73?download=752877b3e3fe4d2e864edb3bd41b43c7",
            "confidentialityRationale": "Only our company sells badgers with pink hair.",
            "title": "Proposal_part2.pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:25.238576+03:00",
            "id": "a61142ae42264111a7e2777ea98d9d73",
            "dateModified": "2017-06-21T17:05:25.238607+03:00"
          }
        ],
        "tenderers": [
          {
            "contactPoint": {
              "email": "fake@mail.com",
              "telephone": "+380 (322) 12-34-56",
              "name": "Іван Карпенко"
            },
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137228",
              "uri": "http://www.sc.gov.ua/"
            },
            "name": "«Кенгуру»",
            "address": {
              "postalCode": "79013",
              "countryName": "Україна",
              "streetAddress": "вул. Коцюбинського, 15",
              "region": "м. Запоріжжя",
              "locality": "м. Запоріжя"
            }
          }
        ],
        "id": "9b6ebf9b1b604decadf2ee8ba69f6d44",
        "eligibilityDocuments": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "public",
            "language": "uk",
            "title": "eligibility_doc.pdf",
            "url": "http://public.docs-sandbox.openprocurement.org/get/5e5958cbd3744e45b38a1ac0219a1e3b?KeyID=d8e133db&Signature=YVHjUWlvZArEujrKOTwhQd81P9E7Jy9tRr%252Bztst7QCkAmQovpaZqFnCIq8wQFwyVZAORk7zMyNTys8gIXYhrAA%253D%253D",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:25.240462+03:00",
            "id": "7a9e8cb3065140e6a71dc636da084e49",
            "dateModified": "2017-06-21T17:05:25.240493+03:00"
          }
        ]
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

Approve first two bids through qualification objects:

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/qualifications/42905e11333041e28283033b6665157f?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 67
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "active",
    "qualified": true,
    "eligible": true
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "eligible": true,
    "qualified": true,
    "bidID": "b20022ca69d243eb917e5ff3217b6690",
    "date": "2017-06-21T17:05:25.976984+03:00",
    "id": "42905e11333041e28283033b6665157f"
  }
}
PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/qualifications/bdd5f929a40f4f85b1eacb2aafca8630?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 67
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "active",
    "qualified": true,
    "eligible": true
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "eligible": true,
    "qualified": true,
    "bidID": "f8c0332fc19b4723a6b2f279c81dc7a0",
    "date": "2017-06-21T17:05:26.161606+03:00",
    "id": "bdd5f929a40f4f85b1eacb2aafca8630"
  }
}

We can also reject bid:

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/qualifications/d44f5f78147b493ebdbe98ae275f9e9e?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "unsuccessful"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "unsuccessful",
    "eligible": false,
    "qualified": false,
    "bidID": "9b6ebf9b1b604decadf2ee8ba69f6d44",
    "date": "2017-06-21T17:05:26.342558+03:00",
    "id": "d44f5f78147b493ebdbe98ae275f9e9e"
  }
}

And check that qualified bids are switched to active:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "status": "active",
      "documents": [
        {
          "hash": "md5:00000000000000000000000000000000",
          "confidentiality": "public",
          "language": "uk",
          "title": "Proposal.pdf",
          "url": "http://public.docs-sandbox.openprocurement.org/get/840d9651238e4aecb276d74f5c5232e1?KeyID=d8e133db&Signature=k5ryxv5psu9N0pCKmN4usarO%252BnzmUIJAdSQMCd31FIbxPLUwcHX2jJ4rN3%252BcED%252BzGgYiscOCH9VMxaRl1ZK8AQ%253D%253D",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2017-06-21T17:05:23.746947+03:00",
          "id": "04c9706c7da9437aa10ad604cdb303fb",
          "dateModified": "2017-06-21T17:05:23.746988+03:00"
        },
        {
          "hash": "md5:00000000000000000000000000000000",
          "confidentiality": "buyerOnly",
          "language": "uk",
          "format": "application/pdf",
          "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451?download=cfc5737256d04935bfd99398ec7b861c",
          "confidentialityRationale": "Only our company sells badgers with pink hair.",
          "title": "Proposal_top_secrets.pdf",
          "documentOf": "tender",
          "datePublished": "2017-06-21T17:05:23.847161+03:00",
          "id": "91b40d8996d24aee9836d57ea3285451",
          "dateModified": "2017-06-21T17:05:23.847195+03:00"
        }
      ],
      "id": "b20022ca69d243eb917e5ff3217b6690",
      "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": "м. Вінниця"
          }
        }
      ]
    },
    {
      "status": "active",
      "id": "f8c0332fc19b4723a6b2f279c81dc7a0",
      "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": "м. Львів"
          }
        }
      ]
    },
    {
      "status": "unsuccessful",
      "documents": [
        {
          "hash": "md5:00000000000000000000000000000000",
          "confidentiality": "public",
          "language": "uk",
          "title": "Proposal_part1.pdf",
          "url": "http://public.docs-sandbox.openprocurement.org/get/c5c2fc1b3eb540898cbc9fb85613e00c?KeyID=d8e133db&Signature=JjnzyrMFnY4JiLWZa%252BGqPKnXIgsXfFhzPEU9Wh6woF49752EH8Dxirg1wG0GeONKFeiluD1xAVibhxp5wqp6BA%253D%253D",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2017-06-21T17:05:25.237642+03:00",
          "id": "2db5d8034cbe4f35bd79070d35f56d96",
          "dateModified": "2017-06-21T17:05:25.237674+03:00"
        },
        {
          "hash": "md5:00000000000000000000000000000000",
          "confidentiality": "buyerOnly",
          "language": "uk",
          "format": "application/pdf",
          "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44/documents/a61142ae42264111a7e2777ea98d9d73?download=752877b3e3fe4d2e864edb3bd41b43c7",
          "confidentialityRationale": "Only our company sells badgers with pink hair.",
          "title": "Proposal_part2.pdf",
          "documentOf": "tender",
          "datePublished": "2017-06-21T17:05:25.238576+03:00",
          "id": "a61142ae42264111a7e2777ea98d9d73",
          "dateModified": "2017-06-21T17:05:25.238607+03:00"
        }
      ],
      "eligibilityDocuments": [
        {
          "hash": "md5:00000000000000000000000000000000",
          "confidentiality": "public",
          "language": "uk",
          "title": "eligibility_doc.pdf",
          "url": "http://public.docs-sandbox.openprocurement.org/get/5e5958cbd3744e45b38a1ac0219a1e3b?KeyID=d8e133db&Signature=YVHjUWlvZArEujrKOTwhQd81P9E7Jy9tRr%252Bztst7QCkAmQovpaZqFnCIq8wQFwyVZAORk7zMyNTys8gIXYhrAA%253D%253D",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2017-06-21T17:05:25.240462+03:00",
          "id": "7a9e8cb3065140e6a71dc636da084e49",
          "dateModified": "2017-06-21T17:05:25.240493+03:00"
        }
      ],
      "selfEligible": true,
      "selfQualified": true,
      "tenderers": [
        {
          "contactPoint": {
            "email": "fake@mail.com",
            "telephone": "+380 (322) 12-34-56",
            "name": "Іван Карпенко"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137228",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "«Кенгуру»",
          "address": {
            "postalCode": "79013",
            "countryName": "Україна",
            "streetAddress": "вул. Коцюбинського, 15",
            "region": "м. Запоріжжя",
            "locality": "м. Запоріжя"
          }
        }
      ],
      "id": "9b6ebf9b1b604decadf2ee8ba69f6d44"
    }
  ]
}

Rejected bid is not shown in bids/ listing.

We can access rejected bid by id:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "unsuccessful",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "Proposal_part1.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/c5c2fc1b3eb540898cbc9fb85613e00c?KeyID=d8e133db&Signature=JjnzyrMFnY4JiLWZa%252BGqPKnXIgsXfFhzPEU9Wh6woF49752EH8Dxirg1wG0GeONKFeiluD1xAVibhxp5wqp6BA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:25.237642+03:00",
        "id": "2db5d8034cbe4f35bd79070d35f56d96",
        "dateModified": "2017-06-21T17:05:25.237674+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "buyerOnly",
        "language": "uk",
        "format": "application/pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44/documents/a61142ae42264111a7e2777ea98d9d73?download=752877b3e3fe4d2e864edb3bd41b43c7",
        "confidentialityRationale": "Only our company sells badgers with pink hair.",
        "title": "Proposal_part2.pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:25.238576+03:00",
        "id": "a61142ae42264111a7e2777ea98d9d73",
        "dateModified": "2017-06-21T17:05:25.238607+03:00"
      }
    ],
    "eligibilityDocuments": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "eligibility_doc.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/5e5958cbd3744e45b38a1ac0219a1e3b?KeyID=d8e133db&Signature=YVHjUWlvZArEujrKOTwhQd81P9E7Jy9tRr%252Bztst7QCkAmQovpaZqFnCIq8wQFwyVZAORk7zMyNTys8gIXYhrAA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:25.240462+03:00",
        "id": "7a9e8cb3065140e6a71dc636da084e49",
        "dateModified": "2017-06-21T17:05:25.240493+03:00"
      }
    ],
    "selfEligible": true,
    "selfQualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "fake@mail.com",
          "telephone": "+380 (322) 12-34-56",
          "name": "Іван Карпенко"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137228",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "«Кенгуру»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Коцюбинського, 15",
          "region": "м. Запоріжжя",
          "locality": "м. Запоріжя"
        }
      }
    ],
    "id": "9b6ebf9b1b604decadf2ee8ba69f6d44"
  }
}

Procuring entity approves qualifications by switching to next status:

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 60
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "active.pre-qualification.stand-still"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "selective",
    "status": "active.pre-qualification.stand-still",
    "complaintPeriod": {
      "startDate": "2017-05-21T17:04:37.384821+03:00",
      "endDate": "2017-06-17T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2017-05-21T17:04:37.384821+03:00",
      "clarificationsUntil": "2017-06-15T00:00:00+03:00",
      "endDate": "2017-06-11T17:04:37.384821+03:00",
      "invalidationDate": "2017-06-21T17:05:24.738173+03:00"
    },
    "submissionMethod": "electronicAuction",
    "procurementMethodType": "competitiveDialogueEU.stage2",
    "procuringEntity": {
      "kind": "general",
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name_en": "Kutsa Svitlana V.",
        "name": "Куца Світлана Валентинівна",
        "availableLanguage": "uk",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name_en": "School #10 of Vinnytsia"
    },
    "questions": [
      {
        "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-06-21T17:05:22.844259+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "dateAnswered": "2017-06-21T17:05:22.936772+03:00",
        "id": "bde54af3cda441318b0bc1e6d2eaca50",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "title_en": "Services in school canteens",
    "id": "2332d7f2a08e47d7a9d115ad1fee1eb8",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "Notice.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/f8910e202a3f451a904ae67142358a74?KeyID=d8e133db&Signature=gWwLvym6za8Ii%252BfpoueQoftCtQSE4M%2FyyNKu%2FtLjuy96l%2FYJoH%252BUFQ4Up8YpoFnppZo1mHxGOuZ2XMOK49ZLDg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.481301+03:00",
        "id": "95a16064160d49fe820a8bee63fff415",
        "dateModified": "2017-06-21T17:05:22.481335+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "AwardCriteria.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/ce58586989224de490b806440143b41d?KeyID=d8e133db&Signature=b9Xyx9Qm%2F3JUf4IAH2qKtQ7%252B%2FfwQRi9tS7Yt9oO8xik8aADhYrFkseVF%252B6qbOqHpRvLifBng3TvOtW2m8%2F7fAA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.579293+03:00",
        "id": "cdf2efa990af4673a6d98331cf0c9652",
        "dateModified": "2017-06-21T17:05:22.579325+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/2efac33fede54b789b8bdc5c9bafb582?KeyID=d8e133db&Signature=0Y21zun5rS5AtRSEHnc0FGr%252B%252BoEq9iM3NZxfhyWEwbjnHBljzh%252BBBcBaLD%2F3hRwl8OWp6rlw5%2FaaPN1JAlU%2FBg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.579293+03:00",
        "id": "cdf2efa990af4673a6d98331cf0c9652",
        "dateModified": "2017-06-21T17:05:22.687041+03:00"
      }
    ],
    "title": "Послуги шкільних їдалень",
    "qualificationPeriod": {
      "startDate": "2017-06-21T17:05:25.702974+03:00",
      "endDate": "2017-06-26T17:05:26.890661+03:00"
    },
    "shortlistedFirms": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137228",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "«Кенгуру»"
      }
    ],
    "tenderID": "UA-2017-06-21-000001",
    "dateModified": "2017-06-21T17:05:26.900302+03:00",
    "numberOfBids": 2,
    "tenderPeriod": {
      "startDate": "2017-05-21T17:04:37.384821+03:00",
      "endDate": "2017-06-21T17:04:37.384821+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-06-27T00:00:00+03:00"
    },
    "qualifications": [
      {
        "status": "active",
        "eligible": true,
        "qualified": true,
        "bidID": "b20022ca69d243eb917e5ff3217b6690",
        "date": "2017-06-21T17:05:25.976984+03:00",
        "id": "42905e11333041e28283033b6665157f"
      },
      {
        "status": "active",
        "eligible": true,
        "qualified": true,
        "bidID": "f8c0332fc19b4723a6b2f279c81dc7a0",
        "date": "2017-06-21T17:05:26.161606+03:00",
        "id": "bdd5f929a40f4f85b1eacb2aafca8630"
      },
      {
        "status": "unsuccessful",
        "eligible": false,
        "qualified": false,
        "bidID": "9b6ebf9b1b604decadf2ee8ba69f6d44",
        "date": "2017-06-21T17:05:26.342558+03:00",
        "id": "d44f5f78147b493ebdbe98ae275f9e9e"
      }
    ],
    "date": "2017-06-21T17:05:26.900302+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418860+03:00",
          "endDate": "2017-07-21T17:05:33.111966+03:00"
        },
        "id": "deaf5398b54e4bd5abc5cca172a40d15",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "bids": [
      {
        "status": "active",
        "documents": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "public",
            "language": "uk",
            "title": "Proposal.pdf",
            "url": "http://public.docs-sandbox.openprocurement.org/get/840d9651238e4aecb276d74f5c5232e1?KeyID=d8e133db&Signature=k5ryxv5psu9N0pCKmN4usarO%252BnzmUIJAdSQMCd31FIbxPLUwcHX2jJ4rN3%252BcED%252BzGgYiscOCH9VMxaRl1ZK8AQ%253D%253D",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:23.746947+03:00",
            "id": "04c9706c7da9437aa10ad604cdb303fb",
            "dateModified": "2017-06-21T17:05:23.746988+03:00"
          },
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "buyerOnly",
            "language": "uk",
            "format": "application/pdf",
            "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451?download=cfc5737256d04935bfd99398ec7b861c",
            "confidentialityRationale": "Only our company sells badgers with pink hair.",
            "title": "Proposal_top_secrets.pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:23.847161+03:00",
            "id": "91b40d8996d24aee9836d57ea3285451",
            "dateModified": "2017-06-21T17:05:23.847195+03:00"
          }
        ],
        "id": "b20022ca69d243eb917e5ff3217b6690",
        "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": "м. Вінниця"
            }
          }
        ]
      },
      {
        "status": "active",
        "id": "f8c0332fc19b4723a6b2f279c81dc7a0",
        "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": "м. Львів"
            }
          }
        ]
      },
      {
        "status": "unsuccessful",
        "documents": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "public",
            "language": "uk",
            "title": "Proposal_part1.pdf",
            "url": "http://public.docs-sandbox.openprocurement.org/get/c5c2fc1b3eb540898cbc9fb85613e00c?KeyID=d8e133db&Signature=JjnzyrMFnY4JiLWZa%252BGqPKnXIgsXfFhzPEU9Wh6woF49752EH8Dxirg1wG0GeONKFeiluD1xAVibhxp5wqp6BA%253D%253D",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:25.237642+03:00",
            "id": "2db5d8034cbe4f35bd79070d35f56d96",
            "dateModified": "2017-06-21T17:05:25.237674+03:00"
          },
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "buyerOnly",
            "language": "uk",
            "format": "application/pdf",
            "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44/documents/a61142ae42264111a7e2777ea98d9d73?download=752877b3e3fe4d2e864edb3bd41b43c7",
            "confidentialityRationale": "Only our company sells badgers with pink hair.",
            "title": "Proposal_part2.pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:25.238576+03:00",
            "id": "a61142ae42264111a7e2777ea98d9d73",
            "dateModified": "2017-06-21T17:05:25.238607+03:00"
          }
        ],
        "eligibilityDocuments": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "public",
            "language": "uk",
            "title": "eligibility_doc.pdf",
            "url": "http://public.docs-sandbox.openprocurement.org/get/5e5958cbd3744e45b38a1ac0219a1e3b?KeyID=d8e133db&Signature=YVHjUWlvZArEujrKOTwhQd81P9E7Jy9tRr%252Bztst7QCkAmQovpaZqFnCIq8wQFwyVZAORk7zMyNTys8gIXYhrAA%253D%253D",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:25.240462+03:00",
            "id": "7a9e8cb3065140e6a71dc636da084e49",
            "dateModified": "2017-06-21T17:05:25.240493+03:00"
          }
        ],
        "selfEligible": true,
        "selfQualified": true,
        "tenderers": [
          {
            "contactPoint": {
              "email": "fake@mail.com",
              "telephone": "+380 (322) 12-34-56",
              "name": "Іван Карпенко"
            },
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137228",
              "uri": "http://www.sc.gov.ua/"
            },
            "name": "«Кенгуру»",
            "address": {
              "postalCode": "79013",
              "countryName": "Україна",
              "streetAddress": "вул. Коцюбинського, 15",
              "region": "м. Запоріжжя",
              "locality": "м. Запоріжя"
            }
          }
        ],
        "id": "9b6ebf9b1b604decadf2ee8ba69f6d44"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "next_check": "2017-06-26T17:05:26.890661+03:00",
    "awardCriteria": "lowestCost"
  }
}

You may notice 10 day stand-still time set in qualificationPeriod.

Auction

After auction is scheduled anybody can visit it to watch. The auction can be reached at Tender.auctionUrl:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "selective",
    "status": "active.auction",
    "complaintPeriod": {
      "startDate": "2017-05-11T17:04:37.384821+03:00",
      "endDate": "2017-06-07T00:00:00+03:00"
    },
    "auctionUrl": "http://auction-sandbox.openprocurement.org/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8",
    "enquiryPeriod": {
      "startDate": "2017-05-11T17:04:37.384821+03:00",
      "clarificationsUntil": "2017-06-07T17:04:37.384821+03:00",
      "endDate": "2017-06-01T17:04:37.384821+03:00",
      "invalidationDate": "2017-06-21T17:05:24.738173+03:00"
    },
    "submissionMethod": "electronicAuction",
    "procurementMethodType": "competitiveDialogueEU.stage2",
    "procuringEntity": {
      "kind": "general",
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name_en": "Kutsa Svitlana V.",
        "name": "Куца Світлана Валентинівна",
        "availableLanguage": "uk",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name_en": "School #10 of Vinnytsia"
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "dateAnswered": "2017-06-21T17:05:22.936772+03:00",
        "title": "Калорійність",
        "date": "2017-06-21T17:05:22.844259+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "bde54af3cda441318b0bc1e6d2eaca50",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "title_en": "Services in school canteens",
    "id": "2332d7f2a08e47d7a9d115ad1fee1eb8",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "Notice.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/f8910e202a3f451a904ae67142358a74?KeyID=d8e133db&Signature=gWwLvym6za8Ii%252BfpoueQoftCtQSE4M%2FyyNKu%2FtLjuy96l%2FYJoH%252BUFQ4Up8YpoFnppZo1mHxGOuZ2XMOK49ZLDg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.481301+03:00",
        "id": "95a16064160d49fe820a8bee63fff415",
        "dateModified": "2017-06-21T17:05:22.481335+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "AwardCriteria.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/ce58586989224de490b806440143b41d?KeyID=d8e133db&Signature=b9Xyx9Qm%2F3JUf4IAH2qKtQ7%252B%2FfwQRi9tS7Yt9oO8xik8aADhYrFkseVF%252B6qbOqHpRvLifBng3TvOtW2m8%2F7fAA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.579293+03:00",
        "id": "cdf2efa990af4673a6d98331cf0c9652",
        "dateModified": "2017-06-21T17:05:22.579325+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/2efac33fede54b789b8bdc5c9bafb582?KeyID=d8e133db&Signature=0Y21zun5rS5AtRSEHnc0FGr%252B%252BoEq9iM3NZxfhyWEwbjnHBljzh%252BBBcBaLD%2F3hRwl8OWp6rlw5%2FaaPN1JAlU%2FBg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:22.579293+03:00",
        "id": "cdf2efa990af4673a6d98331cf0c9652",
        "dateModified": "2017-06-21T17:05:22.687041+03:00"
      }
    ],
    "title": "Послуги шкільних їдалень",
    "qualificationPeriod": {
      "startDate": "2017-06-11T17:04:37.384821+03:00",
      "endDate": "2017-06-21T17:04:37.384821+03:00"
    },
    "shortlistedFirms": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137228",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "«Кенгуру»"
      }
    ],
    "tenderID": "UA-2017-06-21-000001",
    "dateModified": "2017-06-21T17:05:27.421253+03:00",
    "numberOfBids": 2,
    "tenderPeriod": {
      "startDate": "2017-05-11T17:04:37.384821+03:00",
      "endDate": "2017-06-11T17:04:37.384821+03:00"
    },
    "auctionPeriod": {
      "startDate": "2017-06-21T17:04:37.384821+03:00",
      "shouldStartAfter": "2017-06-22T00:00:00+03:00"
    },
    "qualifications": [
      {
        "status": "active",
        "eligible": true,
        "qualified": true,
        "bidID": "b20022ca69d243eb917e5ff3217b6690",
        "date": "2017-06-21T17:05:25.976984+03:00",
        "id": "42905e11333041e28283033b6665157f"
      },
      {
        "status": "active",
        "eligible": true,
        "qualified": true,
        "bidID": "f8c0332fc19b4723a6b2f279c81dc7a0",
        "date": "2017-06-21T17:05:26.161606+03:00",
        "id": "bdd5f929a40f4f85b1eacb2aafca8630"
      },
      {
        "status": "unsuccessful",
        "eligible": false,
        "qualified": false,
        "bidID": "9b6ebf9b1b604decadf2ee8ba69f6d44",
        "date": "2017-06-21T17:05:26.342558+03:00",
        "id": "d44f5f78147b493ebdbe98ae275f9e9e"
      }
    ],
    "date": "2017-06-21T17:05:26.900302+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418860+03:00",
          "endDate": "2017-07-21T17:05:33.111966+03:00"
        },
        "id": "deaf5398b54e4bd5abc5cca172a40d15",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "bids": [
      {
        "status": "active",
        "documents": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "public",
            "language": "uk",
            "title": "Proposal.pdf",
            "url": "http://public.docs-sandbox.openprocurement.org/get/840d9651238e4aecb276d74f5c5232e1?KeyID=d8e133db&Signature=k5ryxv5psu9N0pCKmN4usarO%252BnzmUIJAdSQMCd31FIbxPLUwcHX2jJ4rN3%252BcED%252BzGgYiscOCH9VMxaRl1ZK8AQ%253D%253D",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:23.746947+03:00",
            "id": "04c9706c7da9437aa10ad604cdb303fb",
            "dateModified": "2017-06-21T17:05:23.746988+03:00"
          },
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "buyerOnly",
            "language": "uk",
            "format": "application/pdf",
            "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451?download=cfc5737256d04935bfd99398ec7b861c",
            "confidentialityRationale": "Only our company sells badgers with pink hair.",
            "title": "Proposal_top_secrets.pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:23.847161+03:00",
            "id": "91b40d8996d24aee9836d57ea3285451",
            "dateModified": "2017-06-21T17:05:23.847195+03:00"
          }
        ],
        "id": "b20022ca69d243eb917e5ff3217b6690",
        "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": "м. Вінниця"
            }
          }
        ]
      },
      {
        "status": "active",
        "id": "f8c0332fc19b4723a6b2f279c81dc7a0",
        "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": "м. Львів"
            }
          }
        ]
      },
      {
        "status": "unsuccessful",
        "documents": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "public",
            "language": "uk",
            "title": "Proposal_part1.pdf",
            "url": "http://public.docs-sandbox.openprocurement.org/get/c5c2fc1b3eb540898cbc9fb85613e00c?KeyID=d8e133db&Signature=JjnzyrMFnY4JiLWZa%252BGqPKnXIgsXfFhzPEU9Wh6woF49752EH8Dxirg1wG0GeONKFeiluD1xAVibhxp5wqp6BA%253D%253D",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:25.237642+03:00",
            "id": "2db5d8034cbe4f35bd79070d35f56d96",
            "dateModified": "2017-06-21T17:05:25.237674+03:00"
          },
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "buyerOnly",
            "language": "uk",
            "format": "application/pdf",
            "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/9b6ebf9b1b604decadf2ee8ba69f6d44/documents/a61142ae42264111a7e2777ea98d9d73?download=752877b3e3fe4d2e864edb3bd41b43c7",
            "confidentialityRationale": "Only our company sells badgers with pink hair.",
            "title": "Proposal_part2.pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:25.238576+03:00",
            "id": "a61142ae42264111a7e2777ea98d9d73",
            "dateModified": "2017-06-21T17:05:25.238607+03:00"
          }
        ],
        "eligibilityDocuments": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "confidentiality": "public",
            "language": "uk",
            "title": "eligibility_doc.pdf",
            "url": "http://public.docs-sandbox.openprocurement.org/get/5e5958cbd3744e45b38a1ac0219a1e3b?KeyID=d8e133db&Signature=YVHjUWlvZArEujrKOTwhQd81P9E7Jy9tRr%252Bztst7QCkAmQovpaZqFnCIq8wQFwyVZAORk7zMyNTys8gIXYhrAA%253D%253D",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-21T17:05:25.240462+03:00",
            "id": "7a9e8cb3065140e6a71dc636da084e49",
            "dateModified": "2017-06-21T17:05:25.240493+03:00"
          }
        ],
        "selfEligible": true,
        "selfQualified": true,
        "tenderers": [
          {
            "contactPoint": {
              "email": "fake@mail.com",
              "telephone": "+380 (322) 12-34-56",
              "name": "Іван Карпенко"
            },
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137228",
              "uri": "http://www.sc.gov.ua/"
            },
            "name": "«Кенгуру»",
            "address": {
              "postalCode": "79013",
              "countryName": "Україна",
              "streetAddress": "вул. Коцюбинського, 15",
              "region": "м. Запоріжжя",
              "locality": "м. Запоріжя"
            }
          }
        ],
        "id": "9b6ebf9b1b604decadf2ee8ba69f6d44"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "next_check": "2017-06-21T17:40:37.384821+03:00",
    "awardCriteria": "lowestCost"
  }
}

Bidders can find out their participation URLs via their bids:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690?acc_token=6924864ccd3c4ab7a63cfad5f123b5f1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "Proposal.pdf",
        "url": "http://public.docs-sandbox.openprocurement.org/get/840d9651238e4aecb276d74f5c5232e1?KeyID=d8e133db&Signature=k5ryxv5psu9N0pCKmN4usarO%252BnzmUIJAdSQMCd31FIbxPLUwcHX2jJ4rN3%252BcED%252BzGgYiscOCH9VMxaRl1ZK8AQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:23.746947+03:00",
        "id": "04c9706c7da9437aa10ad604cdb303fb",
        "dateModified": "2017-06-21T17:05:23.746988+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "buyerOnly",
        "language": "uk",
        "format": "application/pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/documents/91b40d8996d24aee9836d57ea3285451?download=cfc5737256d04935bfd99398ec7b861c",
        "confidentialityRationale": "Only our company sells badgers with pink hair.",
        "title": "Proposal_top_secrets.pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:23.847161+03:00",
        "id": "91b40d8996d24aee9836d57ea3285451",
        "dateModified": "2017-06-21T17:05:23.847195+03:00"
      }
    ],
    "selfEligible": true,
    "id": "b20022ca69d243eb917e5ff3217b6690",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "selfQualified": true,
    "financialDocuments": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "financial_doc.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents/7057c22c715e4754a6e44deca8a3beb1?download=0797f04b09374fd99ddd490ce36a5498",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:24.125000+03:00",
        "id": "7057c22c715e4754a6e44deca8a3beb1",
        "dateModified": "2017-06-21T17:05:24.125046+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "financial_doc2.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/financial_documents/eccb2caf274542baa27a7aa9969dbd05?download=5683971956124d43899986b84da70eb9",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:24.251934+03:00",
        "id": "eccb2caf274542baa27a7aa9969dbd05",
        "dateModified": "2017-06-21T17:05:24.251972+03:00"
      }
    ],
    "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-06-21T17:05:23.537907+03:00",
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "qualificationDocuments": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "confidentiality": "public",
        "language": "uk",
        "title": "qualification_document.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/b20022ca69d243eb917e5ff3217b6690/qualification_documents/d9d88ad159e742d396257362cd3d4f1b?download=8d3e83edaeda49cfa17ad86459fe51a5",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:24.427305+03:00",
        "id": "d9d88ad159e742d396257362cd3d4f1b",
        "dateModified": "2017-06-21T17:05:24.427338+03:00"
      }
    ],
    "participationUrl": "http://auction-sandbox.openprocurement.org/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8?key_for_bid=b20022ca69d243eb917e5ff3217b6690"
  }
}

See the Bid.participationUrl in the response. Similar, but different, URL can be retrieved for other participants:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/bids/f8c0332fc19b4723a6b2f279c81dc7a0?acc_token=17cfcc23652a432882ded40441115511 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "selfEligible": true,
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "selfQualified": 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-06-21T17:05:25.080950+03:00",
    "id": "f8c0332fc19b4723a6b2f279c81dc7a0",
    "participationUrl": "http://auction-sandbox.openprocurement.org/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8?key_for_bid=f8c0332fc19b4723a6b2f279c81dc7a0"
  }
}

Confirming qualification

Qualification commission registers its decision via the following call:

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/awards/7514340e56294579afe4843f6acffb2c?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 67
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "active",
    "qualified": true,
    "eligible": true
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "eligible": true,
    "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": "м. Львів"
        }
      }
    ],
    "complaintPeriod": {
      "startDate": "2017-06-21T17:05:28.116246+03:00",
      "endDate": "2017-07-02T00:00:00+03:00"
    },
    "bid_id": "f8c0332fc19b4723a6b2f279c81dc7a0",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "qualified": true,
    "date": "2017-06-21T17:05:28.429403+03:00",
    "id": "7514340e56294579afe4843f6acffb2c"
  }
}

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/2332d7f2a08e47d7a9d115ad1fee1eb8/contracts/a5adbe0ebe494994ae44b6f5df0066a4?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 68
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "contractNumber": "contract#1",
    "value": {
      "amount": 238
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418860+03:00",
          "endDate": "2017-07-21T17:05:33.111966+03:00"
        },
        "id": "deaf5398b54e4bd5abc5cca172a40d15",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "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#1",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "awardID": "7514340e56294579afe4843f6acffb2c",
    "id": "a5adbe0ebe494994ae44b6f5df0066a4",
    "contractID": "UA-2017-06-21-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/2332d7f2a08e47d7a9d115ad1fee1eb8/contracts/a5adbe0ebe494994ae44b6f5df0066a4?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 60
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "dateSigned": "2017-06-21T17:05:28.900492+03:00"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418860+03:00",
          "endDate": "2017-07-21T17:05:33.111966+03:00"
        },
        "id": "deaf5398b54e4bd5abc5cca172a40d15",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "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#1",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-06-21T17:05:28.900492+03:00",
    "awardID": "7514340e56294579afe4843f6acffb2c",
    "id": "a5adbe0ebe494994ae44b6f5df0066a4",
    "contractID": "UA-2017-06-21-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/2332d7f2a08e47d7a9d115ad1fee1eb8/contracts/a5adbe0ebe494994ae44b6f5df0066a4?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 118
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "period": {
      "startDate": "2017-06-21T17:05:29.145094+03:00",
      "endDate": "2018-06-21T17:05:29.145144+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418860+03:00",
          "endDate": "2017-07-21T17:05:33.111966+03:00"
        },
        "id": "deaf5398b54e4bd5abc5cca172a40d15",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "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#1",
    "period": {
      "startDate": "2017-06-21T17:05:29.145094+03:00",
      "endDate": "2018-06-21T17:05:29.145144+03:00"
    },
    "dateSigned": "2017-06-21T17:05:28.900492+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "awardID": "7514340e56294579afe4843f6acffb2c",
    "id": "a5adbe0ebe494994ae44b6f5df0066a4",
    "contractID": "UA-2017-06-21-000001-1"
  }
}

Uploading contract documentation

Let’s upload contract document:

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/contracts/a5adbe0ebe494994ae44b6f5df0066a4/documents?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 206
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy955390164099$
Host: api-sandbox.openprocurement.org


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/contracts/a5adbe0ebe494994ae44b6f5df0066a4/documents/b046a1032f264cfe8b4634d25af6701e
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "language": "uk",
    "title": "contract_first_document.doc",
    "url": "http://public.docs-sandbox.openprocurement.org/get/8f7ef2d7ed7645e9969422b23ab7f68b?KeyID=d8e133db&Signature=8wLZj59BcDtUIl%2FWGtgeoK6KlIO2rxMEsFQy5CbVY25e6eDqzi%2FK3OzRGCQH3F76g4HAPZXPz6EfWnCB75HFAg%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-06-21T17:05:29.503615+03:00",
    "id": "b046a1032f264cfe8b4634d25af6701e",
    "dateModified": "2017-06-21T17:05:29.503659+03:00"
  }
}

201 Created response code and Location header confirm that this document was added.

Let’s see the list of contract documents:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/contracts/a5adbe0ebe494994ae44b6f5df0066a4/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "language": "uk",
      "title": "contract_first_document.doc",
      "url": "http://public.docs-sandbox.openprocurement.org/get/8f7ef2d7ed7645e9969422b23ab7f68b?KeyID=d8e133db&Signature=8wLZj59BcDtUIl%2FWGtgeoK6KlIO2rxMEsFQy5CbVY25e6eDqzi%2FK3OzRGCQH3F76g4HAPZXPz6EfWnCB75HFAg%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-06-21T17:05:29.503615+03:00",
      "id": "b046a1032f264cfe8b4634d25af6701e",
      "dateModified": "2017-06-21T17:05:29.503659+03:00"
    }
  ]
}

We can upload another contract document:

POST /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/contracts/a5adbe0ebe494994ae44b6f5df0066a4/documents?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 209
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy0115947275353$
Host: api-sandbox.openprocurement.org


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/contracts/a5adbe0ebe494994ae44b6f5df0066a4/documents/1d846fe1d19048d7a92c300fa1f92f1e
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "language": "uk",
    "title": "contract_second_document.doc",
    "url": "http://public.docs-sandbox.openprocurement.org/get/111f40dc6a464cb88700b558980259b1?KeyID=d8e133db&Signature=OpR94xXZYzGPfbsKJyId%252B0c7QWtQUZyi0NFCVV%252BalfdWRBVRWUz36fqlAF5UepzOmxXTLSeQ0VH1D%252BTqd5GEBg%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-06-21T17:05:29.837548+03:00",
    "id": "1d846fe1d19048d7a92c300fa1f92f1e",
    "dateModified": "2017-06-21T17:05:29.837587+03:00"
  }
}

201 Created response code and Location header confirm that the second document was uploaded.

By default, document language is Ukrainian. You can can change it and set another language for the document by assigning appropriate language code to the language field (available options: uk, en, ru). You can also set document’s title (e.g. title_en) and description (e.g. description_en) fields. See Document data structure for details.

PATCH /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/contracts/a5adbe0ebe494994ae44b6f5df0066a4/documents/1d846fe1d19048d7a92c300fa1f92f1e?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 106
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "title_en": "Title of Document",
    "language": "en",
    "description_en": "Description of Document"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "language": "en",
    "title": "contract_second_document.doc",
    "url": "http://public.docs-sandbox.openprocurement.org/get/111f40dc6a464cb88700b558980259b1?KeyID=d8e133db&Signature=OpR94xXZYzGPfbsKJyId%252B0c7QWtQUZyi0NFCVV%252BalfdWRBVRWUz36fqlAF5UepzOmxXTLSeQ0VH1D%252BTqd5GEBg%253D%253D",
    "format": "application/msword",
    "title_en": "Title of Document",
    "description_en": "Description of Document",
    "datePublished": "2017-06-21T17:05:29.837548+03:00",
    "documentOf": "tender",
    "id": "1d846fe1d19048d7a92c300fa1f92f1e",
    "dateModified": "2017-06-21T17:05:29.837587+03:00"
  }
}

Let’s see the list of all added contract documents:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/contracts/a5adbe0ebe494994ae44b6f5df0066a4/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "language": "uk",
      "title": "contract_first_document.doc",
      "url": "http://public.docs-sandbox.openprocurement.org/get/8f7ef2d7ed7645e9969422b23ab7f68b?KeyID=d8e133db&Signature=8wLZj59BcDtUIl%2FWGtgeoK6KlIO2rxMEsFQy5CbVY25e6eDqzi%2FK3OzRGCQH3F76g4HAPZXPz6EfWnCB75HFAg%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-06-21T17:05:29.503615+03:00",
      "id": "b046a1032f264cfe8b4634d25af6701e",
      "dateModified": "2017-06-21T17:05:29.503659+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "language": "en",
      "title": "contract_second_document.doc",
      "url": "http://public.docs-sandbox.openprocurement.org/get/111f40dc6a464cb88700b558980259b1?KeyID=d8e133db&Signature=OpR94xXZYzGPfbsKJyId%252B0c7QWtQUZyi0NFCVV%252BalfdWRBVRWUz36fqlAF5UepzOmxXTLSeQ0VH1D%252BTqd5GEBg%253D%253D",
      "format": "application/msword",
      "title_en": "Title of Document",
      "description_en": "Description of Document",
      "datePublished": "2017-06-21T17:05:29.837548+03:00",
      "documentOf": "tender",
      "id": "1d846fe1d19048d7a92c300fa1f92f1e",
      "dateModified": "2017-06-21T17:05:29.837587+03:00"
    }
  ]
}

Let’s view separate contract document:

GET /api/2.3/tenders/2332d7f2a08e47d7a9d115ad1fee1eb8/contracts/a5adbe0ebe494994ae44b6f5df0066a4?acc_token=e77ee989307e43bb9481309d328df6d1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "uk",
        "title": "contract_first_document.doc",
        "url": "http://public.docs-sandbox.openprocurement.org/get/8f7ef2d7ed7645e9969422b23ab7f68b?KeyID=d8e133db&Signature=8wLZj59BcDtUIl%2FWGtgeoK6KlIO2rxMEsFQy5CbVY25e6eDqzi%2FK3OzRGCQH3F76g4HAPZXPz6EfWnCB75HFAg%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-06-21T17:05:29.503615+03:00",
        "id": "b046a1032f264cfe8b4634d25af6701e",
        "dateModified": "2017-06-21T17:05:29.503659+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "language": "en",
        "title": "contract_second_document.doc",
        "url": "http://public.docs-sandbox.openprocurement.org/get/111f40dc6a464cb88700b558980259b1?KeyID=d8e133db&Signature=OpR94xXZYzGPfbsKJyId%252B0c7QWtQUZyi0NFCVV%252BalfdWRBVRWUz36fqlAF5UepzOmxXTLSeQ0VH1D%252BTqd5GEBg%253D%253D",
        "format": "application/msword",
        "title_en": "Title of Document",
        "description_en": "Description of Document",
        "datePublished": "2017-06-21T17:05:29.837548+03:00",
        "documentOf": "tender",
        "id": "1d846fe1d19048d7a92c300fa1f92f1e",
        "dateModified": "2017-06-21T17:05:29.837587+03:00"
      }
    ],
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T17:04:37.418860+03:00",
          "endDate": "2017-07-21T17:05:33.111966+03:00"
        },
        "id": "deaf5398b54e4bd5abc5cca172a40d15",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "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#1",
    "period": {
      "startDate": "2017-06-21T17:05:29.145094+03:00",
      "endDate": "2018-06-21T17:05:29.145144+03:00"
    },
    "dateSigned": "2017-06-21T17:05:28.900492+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "awardID": "7514340e56294579afe4843f6acffb2c",
    "id": "a5adbe0ebe494994ae44b6f5df0066a4",
    "contractID": "UA-2017-06-21-000001-1"
  }
}