Туторіал

Базові правила

Подивимось як працює точка входу /tenders:

GET /api/2.3/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.3/tenders?offset=",
    "uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=",
    "offset": ""
  },
  "data": []
}

При виклику видає пустий набір.

Спробуймо створити нову закупівлю:

POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: api-sandbox.openprocurement.org

Response: 415 Unsupported Media Type
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Content-Type header should be one of ['application/json']",
      "location": "header",
      "name": "Content-Type"
    }
  ]
}

Помилка вказує, що єдиний прийнятний тип вмісту це application/json.

Задовільнимо вимогу типу вмісту:

POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: api-sandbox.openprocurement.org

Response: 422 Unprocessable Entity
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "No JSON object could be decoded",
      "location": "body",
      "name": "data"
    }
  ]
}

Помилка вказує, що data не знайдено у тілі JSON.

Створення закупівлі

Введемо data атрибут у поданому тілі:

POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2508
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "tenderPeriod": {
      "endDate": "2017-07-07T15:53:06.068679+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "id": "37810000-9",
          "description": "Test"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T15:53:06.068598+03:00",
          "endDate": "2017-08-10T15:53:06.068650+03:00"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "procurementMethodType": "aboveThresholdUA",
    "value": {
      "currency": "UAH",
      "amount": 500
    },
    "procuringEntity": {
      "kind": "special",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "address": {
        "countryName": "Україна",
        "postalCode": "21027",
        "region": "м. Вінниця",
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця"
      },
      "name": "ЗОСШ #10 м.Вінниці"
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/1b2ee380634a4d6e9c44d26f6b5003e8
{
  "access": {
    "token": "4a6eb88d7be44a3da2fc039348c2a90c"
  },
  "data": {
    "procurementMethod": "open",
    "status": "active.tendering",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-06-21T15:53:24.829819+03:00",
      "endDate": "2017-07-07T15:53:06.068679+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "enquiryPeriod": {
      "startDate": "2017-06-21T15:53:24.829819+03:00",
      "clarificationsUntil": "2017-07-03T15:53:06.068679+03:00",
      "endDate": "2017-06-27T15:53:06.068679+03:00"
    },
    "complaintPeriod": {
      "startDate": "2017-06-21T15:53:24.829819+03:00",
      "endDate": "2017-07-03T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-06-21T15:53:24.857904+03:00",
    "next_check": "2017-07-07T15:53:06.068679+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-07-08T00:00:00+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-06-21T15:53:24.862584+03:00",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T15:53:06.068598+03:00",
          "endDate": "2017-08-10T15:53:06.068650+03:00"
        },
        "id": "6722b7b18fcb430880214d27464554df",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "id": "1b2ee380634a4d6e9c44d26f6b5003e8",
    "tenderID": "UA-2017-06-21-000002"
  }
}

Успіх! Тепер ми бачимо, що новий об’єкт було створено. Код відповіді 201 та заголовок відповіді Location вказує місцерозташування створеного об’єкта. Тіло відповіді показує інформацію про створену закупівлю, її внутрішнє id (яке співпадає з сегментом Location), її офіційне tenderID та dateModified дату, що показує час, коли закупівля востаннє модифікувалась. Зверніть увагу, що закупівля створюється зі статусом active.enquiries.

Особливість відкритих торгів в тому, що procurementMethodType було змінено з belowThreshold на aboveThresholdUA. Також тут неможливо встановити enquiryPeriod, бо він буде призначений автоматично.

Використаємо URL створеного об’єкта (заголовок відповіді Location):

GET /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9 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.tendering",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-06-21T15:53:20.003863+03:00",
      "endDate": "2017-07-07T15:53:06.068679+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "enquiryPeriod": {
      "startDate": "2017-06-21T15:53:20.003863+03:00",
      "clarificationsUntil": "2017-07-03T15:53:06.068679+03:00",
      "endDate": "2017-06-27T15:53:06.068679+03:00"
    },
    "complaintPeriod": {
      "startDate": "2017-06-21T15:53:20.003863+03:00",
      "endDate": "2017-07-03T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-06-21T15:53:20.034093+03:00",
    "next_check": "2017-07-07T15:53:06.068679+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-07-08T00:00:00+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-06-21T15:53:20.038399+03:00",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T15:53:06.068598+03:00",
          "endDate": "2017-08-10T15:53:06.068650+03:00"
        },
        "id": "fc733ce56c434220bb9e7418b0de6162",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "id": "97dd0ca9a0f741a6ad5628c6873d1de9",
    "tenderID": "UA-2017-06-21-000001"
  }
}

Ми бачимо ту ж відповідь, що і після створення закупівлі.

Подивимось, що показує список закупівель:

GET /api/2.3/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.3/tenders?offset=",
    "uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=",
    "offset": ""
  },
  "data": []
}

Ми бачимо внутрішнє id закупівлі (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/tenders/) та її dateModified дату.

Редагування закупівлі

Оновимо закупівлю шляхом надання їй усіх інших важливих властивостей:

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "tenderPeriod": {
      "endDate": "2017-07-06T15:53:30.143101+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "status": "active.tendering",
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-06-21T15:53:20.003863+03:00",
      "endDate": "2017-07-06T15:53:30.143101+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "enquiryPeriod": {
      "startDate": "2017-06-21T15:53:20.003863+03:00",
      "clarificationsUntil": "2017-06-30T15:53:30.143101+03:00",
      "endDate": "2017-06-26T15:53:30.143101+03:00",
      "invalidationDate": "2017-06-21T15:53:20.206626+03:00"
    },
    "complaintPeriod": {
      "startDate": "2017-06-21T15:53:20.003863+03:00",
      "endDate": "2017-07-02T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-06-21T15:53:20.034093+03:00",
    "next_check": "2017-07-06T15:53:30.143101+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "auctionPeriod": {
      "shouldStartAfter": "2017-07-07T00:00:00+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-06-21T15:53:20.209544+03:00",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T15:53:06.068598+03:00",
          "endDate": "2017-08-10T15:53:06.068650+03:00"
        },
        "id": "fc733ce56c434220bb9e7418b0de6162",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "id": "97dd0ca9a0f741a6ad5628c6873d1de9",
    "tenderID": "UA-2017-06-21-000001"
  }
}

Ми бачимо, що додаткові властивості об’єднані з існуючими даними закупівлі. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.

Ще одна перевірка списку відображає нову дату модифікації:

GET /api/2.3/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.3/tenders?offset=2017-06-21T15%3A53%3A20.038399%2B03%3A00",
    "uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=2017-06-21T15%3A53%3A20.038399%2B03%3A00",
    "offset": "2017-06-21T15:53:20.038399+03:00"
  },
  "data": [
    {
      "id": "97dd0ca9a0f741a6ad5628c6873d1de9",
      "dateModified": "2017-06-21T15:53:20.038399+03:00"
    }
  ]
}

Замовник не може редагувати закупівлю, якщо залишилось менше 7 днів до завершення періоду подання пропозицій. API таких змін не прийме.

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 38
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "value": {
      "amount": 501.0
    }
  }
}

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

Ось чому потрібно продовжити період подання пропозицій на 7 днів.

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 120
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "tenderPeriod": {
      "endDate": "2017-06-29T15:53:21.108184+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 501
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "complaintPeriod": {
      "startDate": "2017-06-08T15:53:20.921360+03:00",
      "endDate": "2017-06-25T00:00:00+03:00"
    },
    "enquiryPeriod": {
      "startDate": "2017-06-08T15:53:20.921360+03:00",
      "clarificationsUntil": "2017-06-22T15:53:21.108184+03:00",
      "endDate": "2017-06-19T15:53:21.108184+03:00",
      "invalidationDate": "2017-06-21T15:53:21.220290+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-06-29T15:53:21.108184+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "dateAnswered": "2017-06-21T15:53:20.818993+03:00",
        "title": "Калорійність",
        "date": "2017-06-21T15:53:20.738523+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "d490583bca4b41d68e36b2b53a5f4caf",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "id": "97dd0ca9a0f741a6ad5628c6873d1de9",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    },
    "documents": [
      {
        "author": "tender_owner",
        "title": "Notice.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/834ae499148f4eb7996d8db7dcd8fd14?download=6f58464f57364eff809716a21346d568",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T15:53:20.439891+03:00",
        "id": "834ae499148f4eb7996d8db7dcd8fd14",
        "dateModified": "2017-06-21T15:53:20.439925+03:00"
      },
      {
        "author": "tender_owner",
        "title": "AwardCriteria.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/8eb8c964d53342919cf982b74ce28eee?download=1b5689bd04d94e68813052edcc6e9eaa",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T15:53:20.531460+03:00",
        "id": "8eb8c964d53342919cf982b74ce28eee",
        "dateModified": "2017-06-21T15:53:20.531494+03:00"
      },
      {
        "author": "tender_owner",
        "title": "AwardCriteria-2.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/8eb8c964d53342919cf982b74ce28eee?download=70093c4ab022423eb1acf14a6a34ca4b",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T15:53:20.531460+03:00",
        "id": "8eb8c964d53342919cf982b74ce28eee",
        "dateModified": "2017-06-21T15:53:20.635230+03:00"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderID": "UA-2017-06-21-000001",
    "dateModified": "2017-06-21T15:53:21.224504+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2017-06-08T15:53:20.921360+03:00",
      "endDate": "2017-06-29T15:53:21.108184+03:00"
    },
    "auctionPeriod": {
      "startDate": "2017-06-23T15:53:20.921360+03:00",
      "shouldStartAfter": "2017-06-30T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "date": "2017-06-21T15:53:20.034093+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T15:53:06.068598+03:00",
          "endDate": "2017-08-10T15:53:06.068650+03:00"
        },
        "id": "fc733ce56c434220bb9e7418b0de6162",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

Замовник може встановити забезпечення тендерної пропозиції:

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 57
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "guarantee": {
      "currency": "USD",
      "amount": 8
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "status": "active.tendering",
    "auctionPeriod": {
      "shouldStartAfter": "2017-07-07T00:00:00+03:00"
    },
    "awardCriteria": "lowestCost",
    "tenderPeriod": {
      "startDate": "2017-06-21T15:53:20.003863+03:00",
      "endDate": "2017-07-06T15:53:30.143101+03:00"
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T15:53:06.068598+03:00",
          "endDate": "2017-08-10T15:53:06.068650+03:00"
        },
        "id": "fc733ce56c434220bb9e7418b0de6162",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "complaintPeriod": {
      "startDate": "2017-06-21T15:53:20.003863+03:00",
      "endDate": "2017-07-02T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2017-06-21T15:53:20.034093+03:00",
    "next_check": "2017-07-06T15:53:30.143101+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "enquiryPeriod": {
      "startDate": "2017-06-21T15:53:20.003863+03:00",
      "clarificationsUntil": "2017-06-30T15:53:30.143101+03:00",
      "endDate": "2017-06-26T15:53:30.143101+03:00",
      "invalidationDate": "2017-06-21T15:53:20.370180+03:00"
    },
    "owner": "broker",
    "dateModified": "2017-06-21T15:53:20.373086+03:00",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    },
    "id": "97dd0ca9a0f741a6ad5628c6873d1de9",
    "tenderID": "UA-2017-06-21-000001"
  }
}

Завантаження документів

Замовник може завантажити PDF файл у створену закупівлю. Завантаження повинно відбуватись згідно правил Documents Uploading.

POST /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 186
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy219192292822$
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/97dd0ca9a0f741a6ad5628c6873d1de9/documents/834ae499148f4eb7996d8db7dcd8fd14
{
  "data": {
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/834ae499148f4eb7996d8db7dcd8fd14?download=6f58464f57364eff809716a21346d568",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T15:53:20.439891+03:00",
    "id": "834ae499148f4eb7996d8db7dcd8fd14",
    "dateModified": "2017-06-21T15:53:20.439925+03:00"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:

GET /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/834ae499148f4eb7996d8db7dcd8fd14?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/834ae499148f4eb7996d8db7dcd8fd14?download=6f58464f57364eff809716a21346d568",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T15:53:20.439891+03:00",
    "previousVersions": [],
    "id": "834ae499148f4eb7996d8db7dcd8fd14",
    "dateModified": "2017-06-21T15:53:20.439925+03:00"
  }
}

Один елемент масиву описує завантажений документ. Ми можемо завантажити більше документів:

POST /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 193
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy744612241576$
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/97dd0ca9a0f741a6ad5628c6873d1de9/documents/8eb8c964d53342919cf982b74ce28eee
{
  "data": {
    "author": "tender_owner",
    "title": "AwardCriteria.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/8eb8c964d53342919cf982b74ce28eee?download=1b5689bd04d94e68813052edcc6e9eaa",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T15:53:20.531460+03:00",
    "id": "8eb8c964d53342919cf982b74ce28eee",
    "dateModified": "2017-06-21T15:53:20.531494+03:00"
  }
}

І знову можна перевірити, що є два завантажених документа.

GET /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "author": "tender_owner",
      "title": "Notice.pdf",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/834ae499148f4eb7996d8db7dcd8fd14?download=6f58464f57364eff809716a21346d568",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T15:53:20.439891+03:00",
      "id": "834ae499148f4eb7996d8db7dcd8fd14",
      "dateModified": "2017-06-21T15:53:20.439925+03:00"
    },
    {
      "author": "tender_owner",
      "title": "AwardCriteria.pdf",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/8eb8c964d53342919cf982b74ce28eee?download=1b5689bd04d94e68813052edcc6e9eaa",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T15:53:20.531460+03:00",
      "id": "8eb8c964d53342919cf982b74ce28eee",
      "dateModified": "2017-06-21T15:53:20.531494+03:00"
    }
  ]
}

Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:

PUT /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/8eb8c964d53342919cf982b74ce28eee?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 196
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy335652002875$
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "author": "tender_owner",
    "title": "AwardCriteria-2.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/8eb8c964d53342919cf982b74ce28eee?download=70093c4ab022423eb1acf14a6a34ca4b",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T15:53:20.531460+03:00",
    "id": "8eb8c964d53342919cf982b74ce28eee",
    "dateModified": "2017-06-21T15:53:20.635230+03:00"
  }
}

І ми бачимо, що вона перекриває оригінальну версію:

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "author": "tender_owner",
      "title": "Notice.pdf",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/834ae499148f4eb7996d8db7dcd8fd14?download=6f58464f57364eff809716a21346d568",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T15:53:20.439891+03:00",
      "id": "834ae499148f4eb7996d8db7dcd8fd14",
      "dateModified": "2017-06-21T15:53:20.439925+03:00"
    },
    {
      "author": "tender_owner",
      "title": "AwardCriteria-2.pdf",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/8eb8c964d53342919cf982b74ce28eee?download=70093c4ab022423eb1acf14a6a34ca4b",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T15:53:20.531460+03:00",
      "id": "8eb8c964d53342919cf982b74ce28eee",
      "dateModified": "2017-06-21T15:53:20.635230+03:00"
    }
  ]
}

Уточнення і запитання

Якщо закупівля має статус active.tendering та дата завершення періоду подання пропозицій Tender.enqueryPeriod.endDate ще не прийшла , то зацікавлені учасники можуть задавати питання чи просити уточнень умов закупівлі:

POST /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/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/97dd0ca9a0f741a6ad5628c6873d1de9/questions/d490583bca4b41d68e36b2b53a5f4caf
{
  "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-21T15:53:20.738523+03:00",
    "id": "d490583bca4b41d68e36b2b53a5f4caf",
    "questionOf": "tender"
  }
}

Замовник може відповісти на них:

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/questions/d490583bca4b41d68e36b2b53a5f4caf?acc_token=4da34917776743398aa0bb0b7a639d70 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-21T15:53:20.818993+03:00",
    "title": "Калорійність",
    "date": "2017-06-21T15:53:20.738523+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "d490583bca4b41d68e36b2b53a5f4caf",
    "questionOf": "tender"
  }
}

Можна отримати список запитань:

GET /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/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-21T15:53:20.818993+03:00",
      "title": "Калорійність",
      "date": "2017-06-21T15:53:20.738523+03:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "id": "d490583bca4b41d68e36b2b53a5f4caf",
      "questionOf": "tender"
    }
  ]
}

або окрему відповідь:

GET /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/questions/d490583bca4b41d68e36b2b53a5f4caf 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-21T15:53:20.818993+03:00",
    "title": "Калорійність",
    "date": "2017-06-21T15:53:20.738523+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "d490583bca4b41d68e36b2b53a5f4caf",
    "questionOf": "tender"
  }
}

Запитання можна задавати лише протягом періоду уточнень Tender.enqueryPeriod.

POST /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/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"
    }
  ]
}

Реєстрація пропозиції

Статус закупівлі active.tendering дозволяє подання пропозицій.

Bidder can register a bid with draft status:

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

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7
{
  "access": {
    "token": "dc58fc5e3b344a5db77a71f006efff76"
  },
  "data": {
    "status": "active",
    "selfEligible": true,
    "id": "f489e65e56b646f4a5948df764a5a2f7",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "subcontractingDetails": "ДКП «книга», Україна, м. Львів, вул. Островського, 33",
    "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-21T15:53:21.328392+03:00",
    "selfQualified": true
  }
}

Та активувати пропозицію:

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7?acc_token=dc58fc5e3b344a5db77a71f006efff76 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
null

Завантаження пропозиції

Потім учасник повинен завантажити документ(и) пропозиції:

POST /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7/documents?acc_token=dc58fc5e3b344a5db77a71f006efff76 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 186
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy63308102304$
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/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7/documents/85a461ee170a40d2bc84045c973b57b6
{
  "data": {
    "title": "Proposal.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7/documents/85a461ee170a40d2bc84045c973b57b6?download=be65bb83b7124b4e8af2e2d230eb0f53",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T15:53:21.485925+03:00",
    "id": "85a461ee170a40d2bc84045c973b57b6",
    "dateModified": "2017-06-21T15:53:21.485962+03:00"
  }
}

Можна перевірити завантажені документи:

GET /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7/documents?acc_token=dc58fc5e3b344a5db77a71f006efff76 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "Proposal.pdf",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7/documents/85a461ee170a40d2bc84045c973b57b6?download=be65bb83b7124b4e8af2e2d230eb0f53",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-06-21T15:53:21.485925+03:00",
      "id": "85a461ee170a40d2bc84045c973b57b6",
      "dateModified": "2017-06-21T15:53:21.485962+03:00"
    }
  ]
}

Пропозиція стає недійсною

Якщо закупівля була модифікована, статус всіх пропозицій змінюється на invalid (недійсний). Ось так пропозиція буде виглядати після редагування закупівлі:

GET /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7?acc_token=dc58fc5e3b344a5db77a71f006efff76 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": "f489e65e56b646f4a5948df764a5a2f7"
  }
}

Підтвердження пропозиції

Учасник повинен підтвердити свою пропозицію:

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7?acc_token=dc58fc5e3b344a5db77a71f006efff76 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "title": "Proposal.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7/documents/85a461ee170a40d2bc84045c973b57b6?download=be65bb83b7124b4e8af2e2d230eb0f53",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T15:53:21.485925+03:00",
        "id": "85a461ee170a40d2bc84045c973b57b6",
        "dateModified": "2017-06-21T15:53:21.485962+03:00"
      }
    ],
    "selfEligible": true,
    "id": "f489e65e56b646f4a5948df764a5a2f7",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "subcontractingDetails": "ДКП «книга», Україна, м. Львів, вул. Островського, 33",
    "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-21T15:53:21.328392+03:00",
    "selfQualified": true
  }
}

Для того, щоб процедура відкритих торгів відбулась, необхідно хоча б два учасника, тобто хоча б дві пропозиції повинні бути зареєстровані до початку аукціону:

POST /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/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/97dd0ca9a0f741a6ad5628c6873d1de9/bids/52419358b91442179b33c01e2a6f908d
{
  "access": {
    "token": "7bbaca0d8ae649a28c0608a9f4d8e41a"
  },
  "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-21T15:53:21.963775+03:00",
    "id": "52419358b91442179b33c01e2a6f908d"
  }
}

Аукціон

Після того, як аукціон заплановано, будь-хто може його відвідати для перегляду. Аукціон можна подивитись за допомогою Tender.auctionUrl:

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "open",
    "complaintPeriod": {
      "startDate": "2017-06-05T15:53:05.318541+03:00",
      "endDate": "2017-06-17T00:00:00+03:00"
    },
    "auctionUrl": "http://auction-sandbox.openprocurement.org/tenders/97dd0ca9a0f741a6ad5628c6873d1de9",
    "enquiryPeriod": {
      "startDate": "2017-06-05T15:53:05.318541+03:00",
      "clarificationsUntil": "2017-06-15T00:00:00+03:00",
      "endDate": "2017-06-11T15:53:05.318541+03:00",
      "invalidationDate": "2017-06-21T15:53:21.710428+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2017-06-21T16:29:05.318541+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "dateAnswered": "2017-06-21T15:53:20.818993+03:00",
        "title": "Калорійність",
        "date": "2017-06-21T15:53:20.738523+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "d490583bca4b41d68e36b2b53a5f4caf",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "id": "97dd0ca9a0f741a6ad5628c6873d1de9",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    },
    "documents": [
      {
        "author": "tender_owner",
        "title": "Notice.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/834ae499148f4eb7996d8db7dcd8fd14?download=6f58464f57364eff809716a21346d568",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T15:53:20.439891+03:00",
        "id": "834ae499148f4eb7996d8db7dcd8fd14",
        "dateModified": "2017-06-21T15:53:20.439925+03:00"
      },
      {
        "author": "tender_owner",
        "title": "AwardCriteria.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/8eb8c964d53342919cf982b74ce28eee?download=1b5689bd04d94e68813052edcc6e9eaa",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T15:53:20.531460+03:00",
        "id": "8eb8c964d53342919cf982b74ce28eee",
        "dateModified": "2017-06-21T15:53:20.531494+03:00"
      },
      {
        "author": "tender_owner",
        "title": "AwardCriteria-2.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/documents/8eb8c964d53342919cf982b74ce28eee?download=70093c4ab022423eb1acf14a6a34ca4b",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T15:53:20.531460+03:00",
        "id": "8eb8c964d53342919cf982b74ce28eee",
        "dateModified": "2017-06-21T15:53:20.635230+03:00"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderID": "UA-2017-06-21-000001",
    "dateModified": "2017-06-21T15:53:22.246710+03:00",
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2017-06-05T15:53:05.318541+03:00",
      "endDate": "2017-06-21T15:53:05.318541+03:00"
    },
    "auctionPeriod": {
      "startDate": "2017-06-21T15:53:05.318541+03:00",
      "shouldStartAfter": "2017-06-22T00:00:00+03:00"
    },
    "procurementMethodType": "aboveThresholdUA",
    "date": "2017-06-21T15:53:20.034093+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T15:53:06.068598+03:00",
          "endDate": "2017-08-10T15:53:06.068650+03:00"
        },
        "id": "fc733ce56c434220bb9e7418b0de6162",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 1
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

Учасники можуть дізнатись свої URL-адреси для участі через свої пропозиції:

GET /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7?acc_token=dc58fc5e3b344a5db77a71f006efff76 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": [
      {
        "title": "Proposal.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/f489e65e56b646f4a5948df764a5a2f7/documents/85a461ee170a40d2bc84045c973b57b6?download=be65bb83b7124b4e8af2e2d230eb0f53",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T15:53:21.485925+03:00",
        "id": "85a461ee170a40d2bc84045c973b57b6",
        "dateModified": "2017-06-21T15:53:21.485962+03:00"
      }
    ],
    "selfEligible": true,
    "id": "f489e65e56b646f4a5948df764a5a2f7",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "subcontractingDetails": "ДКП «книга», Україна, м. Львів, вул. Островського, 33",
    "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-21T15:53:21.328392+03:00",
    "selfQualified": true,
    "participationUrl": "http://auction-sandbox.openprocurement.org/tenders/97dd0ca9a0f741a6ad5628c6873d1de9?key_for_bid=f489e65e56b646f4a5948df764a5a2f7"
  }
}

Дивіться на Bid.participationUrl у відповіді. Схожу, але іншу, URL-адресу можна отримати для інших учасників.

GET /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/bids/52419358b91442179b33c01e2a6f908d?acc_token=7bbaca0d8ae649a28c0608a9f4d8e41a 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
    },
    "id": "52419358b91442179b33c01e2a6f908d",
    "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-21T15:53:21.963775+03:00",
    "selfQualified": true,
    "participationUrl": "http://auction-sandbox.openprocurement.org/tenders/97dd0ca9a0f741a6ad5628c6873d1de9?key_for_bid=52419358b91442179b33c01e2a6f908d"
  }
}

Підтвердження кваліфікації

Кваліфікаційна комісія реєструє своє рішення:

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/awards/62e97a4e15234f899c0ecc9c56860603?acc_token=4da34917776743398aa0bb0b7a639d70 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-21T15:53:22.597972+03:00",
      "endDate": "2017-07-02T00:00:00+03:00"
    },
    "bid_id": "52419358b91442179b33c01e2a6f908d",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "qualified": true,
    "date": "2017-06-21T15:53:22.785694+03:00",
    "id": "62e97a4e15234f899c0ecc9c56860603"
  }
}

Встановлення вартості угоди

За замовчуванням вартість угоди встановлюється на основі рішення про визначення переможця, але є можливість змінити це значення.

Якщо ви хочете знизити вартість угоди, ви можете встановити нове значення для поля amount.

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/contracts/c7cf2c266b524616bac79e27f7eef475?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "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"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T15:53:06.068598+03:00",
          "endDate": "2017-08-10T15:53:06.068650+03:00"
        },
        "id": "fc733ce56c434220bb9e7418b0de6162",
        "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": "м. Львів"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "awardID": "62e97a4e15234f899c0ecc9c56860603",
    "id": "c7cf2c266b524616bac79e27f7eef475",
    "contractID": "UA-2017-06-21-000001-1"
  }
}

Було повернуто код відповіді 200 OK. Значення змінено успішно.

Встановлення дати підписання угоди

Є можливість встановити дату підписання угоди. Для цього вставте відповідну дату в поле dateSigned.

Якщо ви не встановите дату підписання, то вона буде згенерована автоматично під час реєстрації угоди.

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/contracts/c7cf2c266b524616bac79e27f7eef475?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 60
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "dateSigned": "2017-06-21T15:53:23.113026+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"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T15:53:06.068598+03:00",
          "endDate": "2017-08-10T15:53:06.068650+03:00"
        },
        "id": "fc733ce56c434220bb9e7418b0de6162",
        "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": "м. Львів"
        }
      }
    ],
    "dateSigned": "2017-06-21T15:53:23.113026+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "awardID": "62e97a4e15234f899c0ecc9c56860603",
    "id": "c7cf2c266b524616bac79e27f7eef475",
    "contractID": "UA-2017-06-21-000001-1"
  }
}

Встановлення терміну дії угоди

Встановлення терміну дії угоди необов’язкове, але, якщо є необхідність, ви можете встановити відповідну дату початку startDate та кінця endDate терміну дії.

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/contracts/c7cf2c266b524616bac79e27f7eef475?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 118
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "period": {
      "startDate": "2017-06-21T15:53:23.281777+03:00",
      "endDate": "2018-06-21T15:53:23.281840+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"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T15:53:06.068598+03:00",
          "endDate": "2017-08-10T15:53:06.068650+03:00"
        },
        "id": "fc733ce56c434220bb9e7418b0de6162",
        "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": "м. Львів"
        }
      }
    ],
    "period": {
      "startDate": "2017-06-21T15:53:23.281777+03:00",
      "endDate": "2018-06-21T15:53:23.281840+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-06-21T15:53:23.113026+03:00",
    "awardID": "62e97a4e15234f899c0ecc9c56860603",
    "id": "c7cf2c266b524616bac79e27f7eef475",
    "contractID": "UA-2017-06-21-000001-1"
  }
}

Завантаження документації по угоді

Ви можете завантажити документи угоди для процедури відкритих торгів.

Завантажимо документ угоди:

POST /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/contracts/c7cf2c266b524616bac79e27f7eef475/documents?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 200
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy836632394277$
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/97dd0ca9a0f741a6ad5628c6873d1de9/contracts/c7cf2c266b524616bac79e27f7eef475/documents/cb09b38bf7824c42a1524feb5b89924d
{
  "data": {
    "title": "contract_document.doc",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/contracts/c7cf2c266b524616bac79e27f7eef475/documents/cb09b38bf7824c42a1524feb5b89924d?download=fa84f06ca8cf4503bce422717ca1b169",
    "format": "application/msword",
    "datePublished": "2017-06-21T15:53:23.528314+03:00",
    "dateModified": "2017-06-21T15:53:23.528351+03:00",
    "id": "cb09b38bf7824c42a1524feb5b89924d"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ було додано.

Подивимось на список документів пов’язаних з угодою:

GET /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/contracts/c7cf2c266b524616bac79e27f7eef475?acc_token=4da34917776743398aa0bb0b7a639d70 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": [
      {
        "title": "contract_document.doc",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/contracts/c7cf2c266b524616bac79e27f7eef475/documents/cb09b38bf7824c42a1524feb5b89924d?download=fa84f06ca8cf4503bce422717ca1b169",
        "format": "application/msword",
        "datePublished": "2017-06-21T15:53:23.528314+03:00",
        "dateModified": "2017-06-21T15:53:23.528351+03:00",
        "id": "cb09b38bf7824c42a1524feb5b89924d"
      }
    ],
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Test",
          "id": "37810000-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-07-11T15:53:06.068598+03:00",
          "endDate": "2017-08-10T15:53:06.068650+03:00"
        },
        "id": "fc733ce56c434220bb9e7418b0de6162",
        "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": "м. Львів"
        }
      }
    ],
    "period": {
      "startDate": "2017-06-21T15:53:23.281777+03:00",
      "endDate": "2018-06-21T15:53:23.281840+03:00"
    },
    "dateSigned": "2017-06-21T15:53:23.113026+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "awardID": "62e97a4e15234f899c0ecc9c56860603",
    "id": "c7cf2c266b524616bac79e27f7eef475",
    "contractID": "UA-2017-06-21-000001-1"
  }
}

Скасування закупівлі

Той, хто створив закупівлю, може скасувати її у будь-який момент. Для цього виконайте наступні кроки:

  1. Приготуйте запит на скасування.

  2. Наповніть його протоколом про причини скасування.

  3. Скасуйте закупівлю через подані причини.

Запит на скасування, який не пройшов активації (3-й крок), не матиме сили, тобто, для скасування закупівлі буде обов’язковим не тільки створити заявку, але і активувати її.

Дивіться структуру запиту Cancellation для більш детальної інформації.

Формування запиту на скасування

Ви повинні передати змінні reason, status у стані pending.

id генерується автоматично і повертається у додатковому заголовку відповіді Location:

POST /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "reason": "cancellation reason"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2
{
  "data": {
    "status": "pending",
    "reason": "cancellation reason",
    "reasonType": "cancelled",
    "date": "2017-06-21T15:53:23.742688+03:00",
    "cancellationOf": "tender",
    "id": "76718472024b4f2ca5de2893c07cd7b2"
  }
}

При скасуванні, замовник має визначити один з двох типів reasonType: торги відмінені - cancelled, або торги не відбулися - unsuccessful. За замовчуванням, значення reasonType рівне cancelled.

Ви можете виправити тип на unsuccessful (торги не відбулися).

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 40
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "reasonType": "unsuccessful"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "reason": "cancellation reason",
    "reasonType": "unsuccessful",
    "date": "2017-06-21T15:53:23.935784+03:00",
    "cancellationOf": "tender",
    "id": "76718472024b4f2ca5de2893c07cd7b2"
  }
}

Наповнення протоколом та іншою супровідною документацією

Завантажити вміст файлу

POST /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2/documents?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 186
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy146192052318$
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/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2/documents/6009105ed2a04ad6a38ddb0a76854ef9
{
  "data": {
    "title": "Notice.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2/documents/6009105ed2a04ad6a38ddb0a76854ef9?download=f78f4064cd6a46dbb7e02fbbaa170ae5",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T15:53:24.144949+03:00",
    "id": "6009105ed2a04ad6a38ddb0a76854ef9",
    "dateModified": "2017-06-21T15:53:24.145023+03:00"
  }
}

Зміна опису документа та інших властивостей

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2/documents/6009105ed2a04ad6a38ddb0a76854ef9?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 48
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "description": "Changed description"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "description": "Changed description",
    "title": "Notice.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2/documents/6009105ed2a04ad6a38ddb0a76854ef9?download=f78f4064cd6a46dbb7e02fbbaa170ae5",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T15:53:24.144949+03:00",
    "id": "6009105ed2a04ad6a38ddb0a76854ef9",
    "dateModified": "2017-06-21T15:53:24.145023+03:00"
  }
}

Завантажити нову версію документа

PUT /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2/documents/6009105ed2a04ad6a38ddb0a76854ef9?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 189
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy358421017266$
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "description": "Changed description",
    "title": "Notice-2.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2/documents/6009105ed2a04ad6a38ddb0a76854ef9?download=55931e2acaac419484e7fc8070aa385c",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-21T15:53:24.144949+03:00",
    "id": "6009105ed2a04ad6a38ddb0a76854ef9",
    "dateModified": "2017-06-21T15:53:24.522331+03:00"
  }
}

Активація запиту та скасування закупівлі

PATCH /api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2?acc_token=4da34917776743398aa0bb0b7a639d70 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "description": "Changed description",
        "title": "Notice.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2/documents/6009105ed2a04ad6a38ddb0a76854ef9?download=f78f4064cd6a46dbb7e02fbbaa170ae5",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T15:53:24.144949+03:00",
        "id": "6009105ed2a04ad6a38ddb0a76854ef9",
        "dateModified": "2017-06-21T15:53:24.145023+03:00"
      },
      {
        "description": "Changed description",
        "title": "Notice-2.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/97dd0ca9a0f741a6ad5628c6873d1de9/cancellations/76718472024b4f2ca5de2893c07cd7b2/documents/6009105ed2a04ad6a38ddb0a76854ef9?download=55931e2acaac419484e7fc8070aa385c",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-21T15:53:24.144949+03:00",
        "id": "6009105ed2a04ad6a38ddb0a76854ef9",
        "dateModified": "2017-06-21T15:53:24.522331+03:00"
      }
    ],
    "reason": "cancellation reason",
    "reasonType": "unsuccessful",
    "date": "2017-06-21T15:53:24.721063+03:00",
    "cancellationOf": "tender",
    "id": "76718472024b4f2ca5de2893c07cd7b2"
  }
}