Multiple Lots Tutorial

Creating tender

Let’s create tender:

POST /api/2.4/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3789
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "tenderPeriod": {
      "endDate": "2017-11-06T17:04:36.741633+03:00"
    },
    "fundingKind": "other",
    "title": "Послуги шкільних їдалень",
    "NBUdiscountRate": 0.22,
    "procurementMethodType": "esco",
    "procuringEntity": {
      "kind": "general",
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "countryName": "Україна",
        "postalCode": "21027",
        "region": "м. Вінниця",
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця"
      },
      "name_en": "School #10 of Vinnytsia",
      "identifier": {
        "scheme": "UA-EDR",
        "legalName_en": "The institution \"Secondary school I-III levels № 10 Vinnitsa City Council\"",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name_en": "Kutsa Svitlana V.",
        "name": "Куца Світлана Валентинівна",
        "availableLanguage": "uk",
        "telephone": "+380 (432) 46-53-02"
      }
    },
    "minimalStepPercentage": 0.006,
    "yearlyPaymentsPercentageRange": 0.8,
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "id": "37810000-9",
          "description": "Test"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-10-26T17:04:36.741503+03:00",
          "endDate": "2017-11-25T17:04:36.741563+03:00"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      },
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "id": "37810000-9",
          "description": "Test"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-10-26T17:04:36.741590+03:00",
          "endDate": "2017-11-25T17:04:36.741610+03:00"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "title_en": "Services in school canteens"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.4/tenders/032ad48817a74526a52bbdc065449884
{
  "access": {
    "token": "b0f3fe41a6644097a0f0c1eebb4442ae"
  },
  "data": {
    "procurementMethod": "open",
    "complaintPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "endDate": "2017-11-02T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "clarificationsUntil": "2017-11-01T17:04:36.741633+03:00",
      "endDate": "2017-10-27T17:04:36.741633+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-11-06T16:04:36.741633+02: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"
    },
    "owner": "broker",
    "title_en": "Services in school canteens",
    "id": "032ad48817a74526a52bbdc065449884",
    "title": "Послуги шкільних їдалень",
    "tenderID": "UA-2017-10-06-000001",
    "minimalStepPercentage": 0.006,
    "yearlyPaymentsPercentageRange": 0.8,
    "dateModified": "2017-10-06T17:05:14.702909+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "endDate": "2017-11-06T17:04:36.741633+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-12-11T17:04:36.741633+03:00"
    },
    "procurementMethodType": "esco",
    "date": "2017-10-06T17:05:14.695076+03:00",
    "NBUdiscountRate": 0.22,
    "minValue": {
      "currency": "UAH",
      "amount": 0.0,
      "valueAddedTaxIncluded": true
    },
    "fundingKind": "other",
    "submissionMethodDetails": "quick(mode:no-auction)",
    "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": "м. Київ"
        },
        "id": "0df1aa24500d476a931f6c47d81dc593",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      },
      {
        "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": "м. Київ"
        },
        "id": "47a9eef36e0f40b8b2b3907f862fd859",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      }
    ],
    "noticePublicationDate": "2017-10-06T17:05:14.674205+03:00",
    "awardCriteria": "ratedCriteria"
  }
}

Now we can see that new object was created. Response code is 201 and Location response header reports the location of the created object. The body of response reveals the information about the created tender: its internal id (that matches the Location segment), its official tenderID and dateModified datestamp stating the moment in time when tender was last modified. Note that tender is created with active.tendering status.

The peculiarity of the ESCO procedure is that procurementMethodType was changed to esco. Also, new fields NBUdiscountRate, minimalStepPercentage, fundingKind, yearlyPaymentsPercentageRange were added to tender object.

There is also no opportunity to set up enquiryPeriod, it will be assigned automatically.

Adding lots

Tender can contain several different lots. We can add lot using the following way:

POST /api/2.4/tenders/032ad48817a74526a52bbdc065449884/lots?acc_token=b0f3fe41a6644097a0f0c1eebb4442ae HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 175
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "fundingKind": "other",
    "description": "Опис Лот №1",
    "minimalStepPercentage": 0.006,
    "title": "Лот №1"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.4/tenders/032ad48817a74526a52bbdc065449884/lots/0e0d16f25ed5424a9dc07eeee9976392
{
  "data": {
    "status": "active",
    "description": "Опис Лот №1",
    "fundingKind": "other",
    "title": "Лот №1",
    "auctionPeriod": {
      "shouldStartAfter": "2017-12-11T17:04:36.741633+03:00"
    },
    "minValue": {
      "currency": "UAH",
      "amount": 0.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStepPercentage": 0.006,
    "yearlyPaymentsPercentageRange": 0.8,
    "date": "2017-10-06T17:05:14.764545+03:00",
    "id": "0e0d16f25ed5424a9dc07eeee9976392"
  }
}

Let’s add second lot to our tender:

POST /api/2.4/tenders/032ad48817a74526a52bbdc065449884/lots?acc_token=b0f3fe41a6644097a0f0c1eebb4442ae HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 175
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "fundingKind": "other",
    "description": "Опис Лот №2",
    "minimalStepPercentage": 0.006,
    "title": "Лот №2"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.4/tenders/032ad48817a74526a52bbdc065449884/lots/49ec2b91790f4d9ca46623916636f04c
{
  "data": {
    "status": "active",
    "description": "Опис Лот №2",
    "fundingKind": "other",
    "title": "Лот №2",
    "auctionPeriod": {
      "shouldStartAfter": "2017-12-11T17:04:36.741633+03:00"
    },
    "minValue": {
      "currency": "UAH",
      "amount": 0.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStepPercentage": 0.006,
    "yearlyPaymentsPercentageRange": 0.8,
    "date": "2017-10-06T17:05:14.829312+03:00",
    "id": "49ec2b91790f4d9ca46623916636f04c"
  }
}

Also you will need to update tender data about item’s related lots:

PATCH /api/2.4/tenders/032ad48817a74526a52bbdc065449884?acc_token=b0f3fe41a6644097a0f0c1eebb4442ae HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 125
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "items": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392"
      },
      {
        "relatedLot": "49ec2b91790f4d9ca46623916636f04c"
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "complaintPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "endDate": "2017-11-02T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "clarificationsUntil": "2017-11-01T17:04:36.741633+03:00",
      "endDate": "2017-10-27T17:04:36.741633+03:00",
      "invalidationDate": "2017-10-06T17:05:14.958212+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-11-06T16:04:36.741633+02: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"
    },
    "owner": "broker",
    "title_en": "Services in school canteens",
    "id": "032ad48817a74526a52bbdc065449884",
    "title": "Послуги шкільних їдалень",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "fundingKind": "other",
        "title": "Лот №1",
        "auctionPeriod": {
          "shouldStartAfter": "2017-12-11T17:04:36.741633+03:00"
        },
        "minValue": {
          "currency": "UAH",
          "amount": 0.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStepPercentage": 0.006,
        "yearlyPaymentsPercentageRange": 0.8,
        "date": "2017-10-06T17:05:14.764545+03:00",
        "id": "0e0d16f25ed5424a9dc07eeee9976392"
      },
      {
        "status": "active",
        "description": "Опис Лот №2",
        "fundingKind": "other",
        "title": "Лот №2",
        "auctionPeriod": {
          "shouldStartAfter": "2017-12-11T17:04:36.741633+03:00"
        },
        "minValue": {
          "currency": "UAH",
          "amount": 0.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStepPercentage": 0.006,
        "yearlyPaymentsPercentageRange": 0.8,
        "date": "2017-10-06T17:05:14.829312+03:00",
        "id": "49ec2b91790f4d9ca46623916636f04c"
      }
    ],
    "tenderID": "UA-2017-10-06-000001",
    "minimalStepPercentage": 0.006,
    "yearlyPaymentsPercentageRange": 0.8,
    "dateModified": "2017-10-06T17:05:14.962878+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "endDate": "2017-11-06T17:04:36.741633+03:00"
    },
    "NBUdiscountRate": 0.22,
    "procurementMethodType": "esco",
    "date": "2017-10-06T17:05:14.695076+03:00",
    "minValue": {
      "currency": "UAH",
      "amount": 0.0,
      "valueAddedTaxIncluded": true
    },
    "fundingKind": "other",
    "submissionMethodDetails": "quick(mode:no-auction)",
    "items": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "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": "м. Київ"
        },
        "id": "0df1aa24500d476a931f6c47d81dc593",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      },
      {
        "relatedLot": "49ec2b91790f4d9ca46623916636f04c",
        "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": "м. Київ"
        },
        "id": "47a9eef36e0f40b8b2b3907f862fd859",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      }
    ],
    "noticePublicationDate": "2017-10-06T17:05:14.674205+03:00",
    "awardCriteria": "ratedCriteria"
  }
}

View tender listing:

GET /api/2.4/tenders?opt_pretty=1 HTTP/1.0
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.4/tenders?offset=2017-10-06T17%3A05%3A14.962878%2B03%3A00",
    "uri": "http://api-sandbox.openprocurement.org/api/2.4/tenders?offset=2017-10-06T17%3A05%3A14.962878%2B03%3A00",
    "offset": "2017-10-06T17:05:14.962878+03:00"
  },
  "data": [
    {
      "id": "032ad48817a74526a52bbdc065449884",
      "dateModified": "2017-10-06T17:05:14.962878+03:00"
    }
  ]
}

or view tender:

GET /api/2.4/tenders/032ad48817a74526a52bbdc065449884 HTTP/1.0
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "complaintPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "endDate": "2017-11-02T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "clarificationsUntil": "2017-11-01T17:04:36.741633+03:00",
      "endDate": "2017-10-27T17:04:36.741633+03:00",
      "invalidationDate": "2017-10-06T17:05:14.958212+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-11-06T16:04:36.741633+02: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"
    },
    "owner": "broker",
    "title_en": "Services in school canteens",
    "id": "032ad48817a74526a52bbdc065449884",
    "title": "Послуги шкільних їдалень",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "fundingKind": "other",
        "title": "Лот №1",
        "auctionPeriod": {
          "shouldStartAfter": "2017-12-11T17:04:36.741633+03:00"
        },
        "minValue": {
          "currency": "UAH",
          "amount": 0.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStepPercentage": 0.006,
        "yearlyPaymentsPercentageRange": 0.8,
        "date": "2017-10-06T17:05:14.764545+03:00",
        "id": "0e0d16f25ed5424a9dc07eeee9976392"
      },
      {
        "status": "active",
        "description": "Опис Лот №2",
        "fundingKind": "other",
        "title": "Лот №2",
        "auctionPeriod": {
          "shouldStartAfter": "2017-12-11T17:04:36.741633+03:00"
        },
        "minValue": {
          "currency": "UAH",
          "amount": 0.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStepPercentage": 0.006,
        "yearlyPaymentsPercentageRange": 0.8,
        "date": "2017-10-06T17:05:14.829312+03:00",
        "id": "49ec2b91790f4d9ca46623916636f04c"
      }
    ],
    "tenderID": "UA-2017-10-06-000001",
    "minimalStepPercentage": 0.006,
    "yearlyPaymentsPercentageRange": 0.8,
    "dateModified": "2017-10-06T17:05:14.962878+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "endDate": "2017-11-06T17:04:36.741633+03:00"
    },
    "NBUdiscountRate": 0.22,
    "procurementMethodType": "esco",
    "date": "2017-10-06T17:05:14.695076+03:00",
    "minValue": {
      "currency": "UAH",
      "amount": 0.0,
      "valueAddedTaxIncluded": true
    },
    "fundingKind": "other",
    "submissionMethodDetails": "quick(mode:no-auction)",
    "items": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "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": "м. Київ"
        },
        "id": "0df1aa24500d476a931f6c47d81dc593",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      },
      {
        "relatedLot": "49ec2b91790f4d9ca46623916636f04c",
        "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": "м. Київ"
        },
        "id": "47a9eef36e0f40b8b2b3907f862fd859",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      }
    ],
    "noticePublicationDate": "2017-10-06T17:05:14.674205+03:00",
    "awardCriteria": "ratedCriteria"
  }
}

Registering bid

Tender status active.tendering allows registration of bids.

Bidder can register a bid for lot №1:

POST /api/2.4/tenders/032ad48817a74526a52bbdc065449884/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1188
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "selfEligible": true,
    "selfQualified": true,
    "lotValues": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "value": {
          "contractDuration": {
            "years": 7
          },
          "yearlyPaymentsPercentage": 0.87,
          "annualCostsReduction": [
            200,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000
          ]
        },
        "subcontractingDetails": "ДКП «Орфей», Україна"
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.4/tenders/032ad48817a74526a52bbdc065449884/bids/5e7484de25494044b2f974592af01d5f
{
  "access": {
    "token": "6691078b7bb245308b8c71474b328c8c"
  },
  "data": {
    "status": "pending",
    "selfEligible": true,
    "lotValues": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "date": "2017-10-06T17:05:15.214917+03:00",
        "status": "pending",
        "value": {
          "yearlyPaymentsPercentage": 0.87,
          "valueAddedTaxIncluded": true,
          "currency": "UAH",
          "amount": 6059.01,
          "contractDuration": {
            "days": 0,
            "years": 7
          },
          "amountPerformance": 1484.98,
          "annualCostsReduction": [
            200.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0
          ]
        },
        "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-10-06T17:05:15.214276+03:00",
    "id": "5e7484de25494044b2f974592af01d5f"
  }
}

Bidder can register bids for all lots:

POST /api/2.4/tenders/032ad48817a74526a52bbdc065449884/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1454
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "selfEligible": true,
    "selfQualified": true,
    "lotValues": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "value": {
          "contractDuration": {
            "years": 7
          },
          "yearlyPaymentsPercentage": 0.9,
          "annualCostsReduction": [
            700,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600
          ]
        }
      },
      {
        "relatedLot": "49ec2b91790f4d9ca46623916636f04c",
        "value": {
          "contractDuration": {
            "years": 9
          },
          "yearlyPaymentsPercentage": 0.96,
          "annualCostsReduction": [
            600,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200
          ]
        },
        "subcontractingDetails": "ДКП «Укр Прінт», Україна"
      }
    ],
    "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.4/tenders/032ad48817a74526a52bbdc065449884/bids/309506e3a03e4523b5272fedfb04ec3b
{
  "access": {
    "token": "8dd54ed8bad5464f8ba2a9c2b63ae125"
  },
  "data": {
    "status": "pending",
    "selfEligible": true,
    "lotValues": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "date": "2017-10-06T17:05:15.419521+03:00",
        "status": "pending",
        "value": {
          "yearlyPaymentsPercentage": 0.9,
          "valueAddedTaxIncluded": true,
          "currency": "UAH",
          "amount": 10370.71,
          "contractDuration": {
            "days": 0,
            "years": 7
          },
          "amountPerformance": 2249.77,
          "annualCostsReduction": [
            700.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0
          ]
        }
      },
      {
        "relatedLot": "49ec2b91790f4d9ca46623916636f04c",
        "date": "2017-10-06T17:05:15.421522+03:00",
        "status": "pending",
        "value": {
          "yearlyPaymentsPercentage": 0.96,
          "valueAddedTaxIncluded": true,
          "currency": "UAH",
          "amount": 10672.57,
          "contractDuration": {
            "days": 0,
            "years": 9
          },
          "amountPerformance": 1003.31,
          "annualCostsReduction": [
            600.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0
          ]
        },
        "subcontractingDetails": "ДКП «Укр Прінт», Україна"
      }
    ],
    "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-10-06T17:05:15.419057+03:00",
    "id": "309506e3a03e4523b5272fedfb04ec3b"
  }
}

Then bidder should upload technical and private documents of proposal.

We can update tender during active.tendering period. Bids will be invalid after updating tender. For example, let’s change NBUdiscountRate to 0.26.

PATCH /api/2.4/tenders/032ad48817a74526a52bbdc065449884?acc_token=b0f3fe41a6644097a0f0c1eebb4442ae HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 35
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "NBUdiscountRate": 0.26
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "complaintPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "endDate": "2017-11-02T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "clarificationsUntil": "2017-11-01T17:04:36.741633+03:00",
      "endDate": "2017-10-27T17:04:36.741633+03:00",
      "invalidationDate": "2017-10-06T17:05:15.819153+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-11-06T16:04:36.741633+02: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"
    },
    "owner": "broker",
    "title_en": "Services in school canteens",
    "id": "032ad48817a74526a52bbdc065449884",
    "title": "Послуги шкільних їдалень",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "fundingKind": "other",
        "title": "Лот №1",
        "auctionPeriod": {
          "shouldStartAfter": "2017-12-11T17:04:36.741633+03:00"
        },
        "minValue": {
          "currency": "UAH",
          "amount": 0.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStepPercentage": 0.006,
        "yearlyPaymentsPercentageRange": 0.8,
        "date": "2017-10-06T17:05:14.764545+03:00",
        "id": "0e0d16f25ed5424a9dc07eeee9976392"
      },
      {
        "status": "active",
        "description": "Опис Лот №2",
        "fundingKind": "other",
        "title": "Лот №2",
        "auctionPeriod": {
          "shouldStartAfter": "2017-12-11T17:04:36.741633+03:00"
        },
        "minValue": {
          "currency": "UAH",
          "amount": 0.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStepPercentage": 0.006,
        "yearlyPaymentsPercentageRange": 0.8,
        "date": "2017-10-06T17:05:14.829312+03:00",
        "id": "49ec2b91790f4d9ca46623916636f04c"
      }
    ],
    "tenderID": "UA-2017-10-06-000001",
    "minimalStepPercentage": 0.006,
    "yearlyPaymentsPercentageRange": 0.8,
    "dateModified": "2017-10-06T17:05:15.856939+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-10-06T17:05:14.661702+03:00",
      "endDate": "2017-11-06T17:04:36.741633+03:00"
    },
    "NBUdiscountRate": 0.26,
    "procurementMethodType": "esco",
    "date": "2017-10-06T17:05:14.695076+03:00",
    "minValue": {
      "currency": "UAH",
      "amount": 0.0,
      "valueAddedTaxIncluded": true
    },
    "fundingKind": "other",
    "submissionMethodDetails": "quick(mode:no-auction)",
    "items": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "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": "м. Київ"
        },
        "id": "0df1aa24500d476a931f6c47d81dc593",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      },
      {
        "relatedLot": "49ec2b91790f4d9ca46623916636f04c",
        "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": "м. Київ"
        },
        "id": "47a9eef36e0f40b8b2b3907f862fd859",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      }
    ],
    "noticePublicationDate": "2017-10-06T17:05:14.674205+03:00",
    "awardCriteria": "ratedCriteria"
  }
}

Here is the bidder’s proposal after tender was updated. It’s status is invalid.

GET /api/2.4/tenders/032ad48817a74526a52bbdc065449884/bids/5e7484de25494044b2f974592af01d5f?acc_token=6691078b7bb245308b8c71474b328c8c 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": "5e7484de25494044b2f974592af01d5f"
  }
}

Firstly bidder has to renew bid, even if he was placing a bid just for a lot №1.

PATCH /api/2.4/tenders/032ad48817a74526a52bbdc065449884/bids/5e7484de25494044b2f974592af01d5f?acc_token=6691078b7bb245308b8c71474b328c8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 418
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "pending",
    "lotValues": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "value": {
          "contractDuration": {
            "years": 7
          },
          "yearlyPaymentsPercentage": 0.87,
          "annualCostsReduction": [
            200,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000,
            1000
          ]
        },
        "subcontractingDetails": "ДКП «Орфей»"
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "selfEligible": true,
    "lotValues": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "date": "2017-10-06T17:05:15.214917+03:00",
        "status": "pending",
        "value": {
          "yearlyPaymentsPercentage": 0.87,
          "valueAddedTaxIncluded": true,
          "currency": "UAH",
          "amount": 6059.01,
          "contractDuration": {
            "days": 0,
            "years": 7
          },
          "amountPerformance": 1121.86,
          "annualCostsReduction": [
            200.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0,
            1000.0
          ]
        },
        "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-10-06T17:05:15.214276+03:00",
    "id": "5e7484de25494044b2f974592af01d5f"
  }
}

Then bidder has to renew bid for both lots.

PATCH /api/2.4/tenders/032ad48817a74526a52bbdc065449884/bids/309506e3a03e4523b5272fedfb04ec3b?acc_token=8dd54ed8bad5464f8ba2a9c2b63ae125 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 762
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "pending",
    "lotValues": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "value": {
          "contractDuration": {
            "years": 7
          },
          "yearlyPaymentsPercentage": 0.9,
          "annualCostsReduction": [
            700,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600,
            1600
          ]
        }
      },
      {
        "relatedLot": "49ec2b91790f4d9ca46623916636f04c",
        "value": {
          "contractDuration": {
            "years": 9
          },
          "yearlyPaymentsPercentage": 0.96,
          "annualCostsReduction": [
            600,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200,
            1200
          ]
        },
        "subcontractingDetails": "ДКП «Укр Прінт», Україна"
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "selfEligible": true,
    "lotValues": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "date": "2017-10-06T17:05:15.419521+03:00",
        "status": "pending",
        "value": {
          "yearlyPaymentsPercentage": 0.9,
          "valueAddedTaxIncluded": true,
          "currency": "UAH",
          "amount": 10370.71,
          "contractDuration": {
            "days": 0,
            "years": 7
          },
          "amountPerformance": 1684.39,
          "annualCostsReduction": [
            700.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0,
            1600.0
          ]
        }
      },
      {
        "relatedLot": "49ec2b91790f4d9ca46623916636f04c",
        "date": "2017-10-06T17:05:15.421522+03:00",
        "status": "pending",
        "value": {
          "yearlyPaymentsPercentage": 0.96,
          "valueAddedTaxIncluded": true,
          "currency": "UAH",
          "amount": 10672.57,
          "contractDuration": {
            "days": 0,
            "years": 9
          },
          "amountPerformance": 705.17,
          "annualCostsReduction": [
            600.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0,
            1200.0
          ]
        },
        "subcontractingDetails": "ДКП «Укр Прінт», Україна"
      }
    ],
    "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-10-06T17:05:15.419057+03:00",
    "id": "309506e3a03e4523b5272fedfb04ec3b"
  }
}

Bid Qualification

ESCO procedure requires bid’s value qualification.

Let’s view tender:

GET /api/2.4/tenders/032ad48817a74526a52bbdc065449884?acc_token=b0f3fe41a6644097a0f0c1eebb4442ae HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "status": "active.pre-qualification",
    "complaintPeriod": {
      "startDate": "2017-09-06T17:05:16.623255+03:00",
      "endDate": "2017-10-02T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2017-09-06T17:05:16.623255+03:00",
      "clarificationsUntil": "2017-09-29T17:05:16.623255+03:00",
      "endDate": "2017-09-26T17:05:16.623255+03:00",
      "invalidationDate": "2017-10-06T17:05:15.819153+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"
    },
    "owner": "broker",
    "title_en": "Services in school canteens",
    "id": "032ad48817a74526a52bbdc065449884",
    "title": "Послуги шкільних їдалень",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "fundingKind": "other",
        "title": "Лот №1",
        "minValue": {
          "currency": "UAH",
          "amount": 0.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStepPercentage": 0.006,
        "yearlyPaymentsPercentageRange": 0.8,
        "date": "2017-10-06T17:05:14.764545+03:00",
        "id": "0e0d16f25ed5424a9dc07eeee9976392"
      },
      {
        "status": "unsuccessful",
        "description": "Опис Лот №2",
        "fundingKind": "other",
        "title": "Лот №2",
        "minValue": {
          "currency": "UAH",
          "amount": 0.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStepPercentage": 0.006,
        "yearlyPaymentsPercentageRange": 0.8,
        "date": "2017-10-06T17:05:16.926698+03:00",
        "id": "49ec2b91790f4d9ca46623916636f04c"
      }
    ],
    "qualificationPeriod": {
      "startDate": "2017-10-06T17:05:16.886342+03:00"
    },
    "tenderID": "UA-2017-10-06-000001",
    "minimalStepPercentage": 0.006,
    "yearlyPaymentsPercentageRange": 0.8,
    "dateModified": "2017-10-06T17:05:16.926698+03:00",
    "numberOfBids": 2,
    "tenderPeriod": {
      "startDate": "2017-09-06T17:05:16.623255+03:00",
      "endDate": "2017-10-06T17:05:16.623255+03:00"
    },
    "qualifications": [
      {
        "status": "pending",
        "lotID": "0e0d16f25ed5424a9dc07eeee9976392",
        "eligible": false,
        "qualified": false,
        "bidID": "5e7484de25494044b2f974592af01d5f",
        "date": "2017-10-06T17:05:16.887359+03:00",
        "id": "525fe80947ff4a25b772d2bea5e0ca83"
      },
      {
        "status": "pending",
        "lotID": "0e0d16f25ed5424a9dc07eeee9976392",
        "eligible": false,
        "qualified": false,
        "bidID": "309506e3a03e4523b5272fedfb04ec3b",
        "date": "2017-10-06T17:05:16.887696+03:00",
        "id": "ae90cc470c0a4671a914704b78e63cb1"
      }
    ],
    "procurementMethodType": "esco",
    "date": "2017-10-06T17:05:16.926698+03:00",
    "NBUdiscountRate": 0.26,
    "minValue": {
      "currency": "UAH",
      "amount": 0.0,
      "valueAddedTaxIncluded": true
    },
    "fundingKind": "other",
    "submissionMethodDetails": "quick(mode:no-auction)",
    "items": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "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": "м. Київ"
        },
        "id": "0df1aa24500d476a931f6c47d81dc593",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      },
      {
        "relatedLot": "49ec2b91790f4d9ca46623916636f04c",
        "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": "м. Київ"
        },
        "id": "47a9eef36e0f40b8b2b3907f862fd859",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      }
    ],
    "bids": [
      {
        "status": "pending",
        "id": "5e7484de25494044b2f974592af01d5f",
        "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": "309506e3a03e4523b5272fedfb04ec3b",
        "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": "м. Львів"
            }
          }
        ]
      }
    ],
    "noticePublicationDate": "2017-10-06T17:05:14.674205+03:00",
    "awardCriteria": "ratedCriteria"
  }
}

Let’s list qualifications:

GET /api/2.4/tenders/032ad48817a74526a52bbdc065449884/qualifications?acc_token=b0f3fe41a6644097a0f0c1eebb4442ae HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "status": "pending",
      "lotID": "0e0d16f25ed5424a9dc07eeee9976392",
      "eligible": false,
      "qualified": false,
      "bidID": "5e7484de25494044b2f974592af01d5f",
      "date": "2017-10-06T17:05:16.887359+03:00",
      "id": "525fe80947ff4a25b772d2bea5e0ca83"
    },
    {
      "status": "pending",
      "lotID": "0e0d16f25ed5424a9dc07eeee9976392",
      "eligible": false,
      "qualified": false,
      "bidID": "309506e3a03e4523b5272fedfb04ec3b",
      "date": "2017-10-06T17:05:16.887696+03:00",
      "id": "ae90cc470c0a4671a914704b78e63cb1"
    }
  ]
}

Approve bid’s value through qualification objects:

PATCH /api/2.4/tenders/032ad48817a74526a52bbdc065449884/qualifications/525fe80947ff4a25b772d2bea5e0ca83?acc_token=b0f3fe41a6644097a0f0c1eebb4442ae 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",
    "lotID": "0e0d16f25ed5424a9dc07eeee9976392",
    "eligible": true,
    "qualified": true,
    "bidID": "5e7484de25494044b2f974592af01d5f",
    "date": "2017-10-06T17:05:17.262396+03:00",
    "id": "525fe80947ff4a25b772d2bea5e0ca83"
  }
}

Procuring entity approves qualifications by switching to next status:

PATCH /api/2.4/tenders/032ad48817a74526a52bbdc065449884?acc_token=b0f3fe41a6644097a0f0c1eebb4442ae 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": "open",
    "status": "active.pre-qualification.stand-still",
    "complaintPeriod": {
      "startDate": "2017-09-06T17:05:16.623255+03:00",
      "endDate": "2017-10-02T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2017-09-06T17:05:16.623255+03:00",
      "clarificationsUntil": "2017-09-29T17:05:16.623255+03:00",
      "endDate": "2017-09-26T17:05:16.623255+03:00",
      "invalidationDate": "2017-10-06T17:05:15.819153+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-10-12T00:00:00+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"
    },
    "owner": "broker",
    "title_en": "Services in school canteens",
    "id": "032ad48817a74526a52bbdc065449884",
    "title": "Послуги шкільних їдалень",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "fundingKind": "other",
        "title": "Лот №1",
        "auctionPeriod": {
          "shouldStartAfter": "2017-10-12T00:00:00+03:00"
        },
        "minValue": {
          "currency": "UAH",
          "amount": 0.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStepPercentage": 0.006,
        "yearlyPaymentsPercentageRange": 0.8,
        "date": "2017-10-06T17:05:14.764545+03:00",
        "id": "0e0d16f25ed5424a9dc07eeee9976392"
      },
      {
        "status": "unsuccessful",
        "description": "Опис Лот №2",
        "fundingKind": "other",
        "title": "Лот №2",
        "minValue": {
          "currency": "UAH",
          "amount": 0.0,
          "valueAddedTaxIncluded": true
        },
        "minimalStepPercentage": 0.006,
        "yearlyPaymentsPercentageRange": 0.8,
        "date": "2017-10-06T17:05:16.926698+03:00",
        "id": "49ec2b91790f4d9ca46623916636f04c"
      }
    ],
    "qualificationPeriod": {
      "startDate": "2017-10-06T17:05:16.886342+03:00",
      "endDate": "2017-10-12T00:00:00+03:00"
    },
    "tenderID": "UA-2017-10-06-000001",
    "minimalStepPercentage": 0.006,
    "yearlyPaymentsPercentageRange": 0.8,
    "dateModified": "2017-10-06T17:05:17.885321+03:00",
    "numberOfBids": 2,
    "tenderPeriod": {
      "startDate": "2017-09-06T17:05:16.623255+03:00",
      "endDate": "2017-10-06T17:05:16.623255+03:00"
    },
    "qualifications": [
      {
        "status": "active",
        "lotID": "0e0d16f25ed5424a9dc07eeee9976392",
        "eligible": true,
        "qualified": true,
        "bidID": "5e7484de25494044b2f974592af01d5f",
        "date": "2017-10-06T17:05:17.262396+03:00",
        "id": "525fe80947ff4a25b772d2bea5e0ca83"
      },
      {
        "status": "active",
        "lotID": "0e0d16f25ed5424a9dc07eeee9976392",
        "eligible": true,
        "qualified": true,
        "bidID": "309506e3a03e4523b5272fedfb04ec3b",
        "date": "2017-10-06T17:05:17.485338+03:00",
        "id": "ae90cc470c0a4671a914704b78e63cb1"
      }
    ],
    "procurementMethodType": "esco",
    "date": "2017-10-06T17:05:17.885321+03:00",
    "NBUdiscountRate": 0.26,
    "minValue": {
      "currency": "UAH",
      "amount": 0.0,
      "valueAddedTaxIncluded": true
    },
    "fundingKind": "other",
    "submissionMethodDetails": "quick(mode:no-auction)",
    "items": [
      {
        "relatedLot": "0e0d16f25ed5424a9dc07eeee9976392",
        "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": "м. Київ"
        },
        "id": "0df1aa24500d476a931f6c47d81dc593",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      },
      {
        "relatedLot": "49ec2b91790f4d9ca46623916636f04c",
        "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": "м. Київ"
        },
        "id": "47a9eef36e0f40b8b2b3907f862fd859",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        }
      }
    ],
    "bids": [
      {
        "status": "active",
        "id": "5e7484de25494044b2f974592af01d5f",
        "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": "309506e3a03e4523b5272fedfb04ec3b",
        "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": "м. Львів"
            }
          }
        ]
      }
    ],
    "noticePublicationDate": "2017-10-06T17:05:14.674205+03:00",
    "awardCriteria": "ratedCriteria"
  }
}

There is 10 day stand-still period set in qualificationPeriod.