Туторіал

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

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

GET /api/2.5/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.5/auctions?offset=",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions?offset=",
    "offset": ""
  },
  "data": []
}

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

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

POST /api/2.5/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: api-sandbox.ea.openprocurement.org


415 Unsupported Media Type
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "status": "error",
  "errors": [
    {
      "description": "Content-Type header should be one of ['application/json']",
      "location": "header",
      "name": "Content-Type"
    }
  ]
}

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

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

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


422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "status": "error",
  "errors": [
    {
      "description": "Expecting value: line 1 column 1 (char 0)",
      "location": "body",
      "name": "data"
    }
  ]
}

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

Створення аукціону

Створимо аукціон з мінімально допустимим набором даних (тільки параметри обовязкові для заповнення) :

POST /api/2.5/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2087
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-25"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "DGFOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "submissionMethodDetails": "test submissionMethodDetails",
    "dgfDecisionDate": "2016-11-17",
    "dgfID": "219560",
    "dgfDecisionID": "219560",
    "procurementMethodDetails": "quick, accelerator=1440",
    "items": [
      {
        "classification": {
          "scheme": "CAV",
          "id": "06000000-2",
          "description": "Земельні ділянки"
        },
        "quantity": 5,
        "description": "Земля для військовослужбовців",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        }
      }
    ],
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    }
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "68942dd9b0fb4e9b80b9826ec12e79da",
    "token": "0052e89467e54a799389e87c87910599"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-24T23:59:50+03:00",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "bb1795e42a4243ada1433ddb18b4f06f",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.421619+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:07.421641+03:00",
        "id": "779f993a42c54eadadff72d66788fb23"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:07.423925+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-25T00:00:00+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:07.421282+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "314f1cb8d47a46009b5c9537e8974be6",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

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

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-24T23:59:50+03:00",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "bb1795e42a4243ada1433ddb18b4f06f",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.421619+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:07.421641+03:00",
        "id": "779f993a42c54eadadff72d66788fb23"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:07.423925+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-25T00:00:00+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:07.421282+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "314f1cb8d47a46009b5c9537e8974be6",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

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

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

GET /api/2.5/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.164181%2B03%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.164181%2B03%3A00",
    "offset": "2018-07-11T15:06:07.164181+03:00"
  },
  "data": [
    {
      "id": "6287b62b149840a88b47a6fc61cdc4d2",
      "dateModified": "2018-07-11T15:06:07.164181+03:00"
    }
  ]
}

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

Попередній аукціон був створений лише з обов’язковими полями. Тепер додамо аукціон з максимально допустимим набором даних при створенні (аукціон повинен бути у статусі created).

POST /api/2.5/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2116
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-25"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "DGFOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "submissionMethodDetails": "test submissionMethodDetails",
    "dgfDecisionDate": "2016-11-17",
    "dgfID": "219560",
    "title_ru": "футляры к государственным наградам",
    "dgfDecisionID": "219560",
    "procurementMethodDetails": "quick, accelerator=1440",
    "items": [
      {
        "classification": {
          "scheme": "CAV",
          "id": "06000000-2",
          "description": "Земельні ділянки"
        },
        "description": "Земля для військовослужбовців",
        "id": "4d668ec03a46438baaf85cddd1e70378",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "title_en": "Cases with state awards",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    }
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/2713725bc7144374905f7dbc0182bede
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "98dc2fd8c7fc4425b9021a5db91ed497",
    "token": "7145d40df47649258aae10eb7cbe45fe"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000003",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:07.500869+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-24T23:59:50+03:00",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "title_en": "Cases with state awards",
    "id": "2713725bc7144374905f7dbc0182bede",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.501185+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:07.501206+03:00",
        "id": "8ccfb7893cfc474099b81408a9f85e21"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:07.503399+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:07.500869+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-25T00:00:00+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:07.500869+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "description": "Земля для військовослужбовців",
        "id": "4d668ec03a46438baaf85cddd1e70378",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "title_ru": "футляры к государственным наградам",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

І знову код відповіді 201 Created, заголовок Location і тіло з додатковим id, auctionID, та властивість dateModified.

Перевіримо, що містить реєстр аукціонів:

GET /api/2.5/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.423925%2B03%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.423925%2B03%3A00",
    "offset": "2018-07-11T15:06:07.423925+03:00"
  },
  "data": [
    {
      "id": "6287b62b149840a88b47a6fc61cdc4d2",
      "dateModified": "2018-07-11T15:06:07.164181+03:00"
    },
    {
      "id": "bb1795e42a4243ada1433ddb18b4f06f",
      "dateModified": "2018-07-11T15:06:07.423925+03:00"
    }
  ]
}

Дійсно, в нас зараз є дві аукціони.

Creating auction from the given lot

Let’s create a procedure considering the lot created before within the registry:

POST /api/2.5/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2165
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "draft",
    "merchandisingObject": "da232f129d5d448f96e62b81b6bb755c",
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-25"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "DGFOtherAssets",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "submissionMethodDetails": "test submissionMethodDetails",
    "dgfDecisionDate": "2016-11-17",
    "dgfID": "219560",
    "dgfDecisionID": "219560",
    "procurementMethodDetails": "quick, accelerator=1440",
    "items": [
      {
        "classification": {
          "scheme": "CAV",
          "id": "06000000-2",
          "description": "Земельні ділянки"
        },
        "quantity": 5,
        "description": "Земля для військовослужбовців",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        }
      }
    ],
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    }
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/0f514d78026041b8919457f7ae762887
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "eb9215a5bd744ebea47d575256cd0986",
    "token": "395a0e92cc26453a87782b8e1b1a3c3c"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "merchandisingObject": "da232f129d5d448f96e62b81b6bb755c",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:03.936421+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "0f514d78026041b8919457f7ae762887",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:03.936720+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:03.936741+03:00",
        "id": "8ef00a68c36d49e8816401602733a5ae"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-11T15:06:03.938788+03:00",
    "status": "draft",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:03.936421+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "procurementMethodDetails": "quick, accelerator=1440",
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:03.936421+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "597c0fc83beb4f36b74ca596b615f97a",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

Модифікація аукціону

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "tenderPeriod": {
      "endDate": "2018-07-26T15:06:17.585732+03:00"
    }
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "enquiryPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-24T23:59:50+03:00",
    "awardCriteria": "highestCost",
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "bb1795e42a4243ada1433ddb18b4f06f",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.421619+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:07.421641+03:00",
        "id": "779f993a42c54eadadff72d66788fb23"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:07.423925+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-11T15:06:07.421282+03:00",
      "endDate": "2018-07-24T23:59:50+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-25T00:00:00+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:07.421282+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "314f1cb8d47a46009b5c9537e8974be6",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

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

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

GET /api/2.5/auctions?opt_pretty=1 HTTP/1.0
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.556898%2B03%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions?offset=2018-07-11T15%3A06%3A07.556898%2B03%3A00",
    "offset": "2018-07-11T15:06:07.556898+03:00"
  },
  "data": [
    {
      "id": "6287b62b149840a88b47a6fc61cdc4d2",
      "dateModified": "2018-07-11T15:06:07.164181+03:00"
    },
    {
      "id": "bb1795e42a4243ada1433ddb18b4f06f",
      "dateModified": "2018-07-11T15:06:07.423925+03:00"
    },
    {
      "id": "2713725bc7144374905f7dbc0182bede",
      "dateModified": "2018-07-11T15:06:07.503399+03:00"
    },
    {
      "id": "2079827e0402455fbe0bf27ef188dd7b",
      "dateModified": "2018-07-11T15:06:07.556898+03:00"
    }
  ]
}

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

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 409
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=8dnERkLYD2IPoGGwxM8T5EEYGGxJ2OW5qIMRC7n1K2CC9QK8Wjd9%2BEqmaBfbfoKw5waUSG2AVMhaNuJ9kX37Dw%3D%3D",
    "format": "application/pdf",
    "documentType": "technicalSpecifications"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/bb517ba5ca544fd7b21eaf894a63afd7
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.649805+03:00",
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-11T15:06:07.649826+03:00",
    "id": "bb517ba5ca544fd7b21eaf894a63afd7"
  }
}

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/bb517ba5ca544fd7b21eaf894a63afd7 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.649805+03:00",
    "previousVersions": [],
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-11T15:06:07.649826+03:00",
    "id": "bb517ba5ca544fd7b21eaf894a63afd7"
  }
}

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 338
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b85f96f321fe44378c76605a075f4f80?KeyID=172d32c8&Signature=fX2WtYTed%2FzWbmhHT9OFfkIxiA%2F%2FPBBxs2ODAvo2ViulEoKQWj9vRcNvCYsD3iRUFlBmoEJP0b5rNcXLWm0LBw%3D%3D",
    "title": "AwardCriteria.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/cf91c283f3b04cb5a76d9368d69c161f
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b85f96f321fe44378c76605a075f4f80?KeyID=172d32c8&Signature=PkSkrOo6heBcy1Yh5exZo2ksJMI%252BZ%252BnflXz065HAzV8GyrYKBR2WKxNwzFVsf3q3DaoDK%252BkDENPI22kcXAmPBg%253D%253D",
    "title": "AwardCriteria.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.703749+03:00",
    "dateModified": "2018-07-11T15:06:07.703770+03:00",
    "id": "cf91c283f3b04cb5a76d9368d69c161f"
  }
}

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.421619+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:07.421641+03:00",
      "id": "779f993a42c54eadadff72d66788fb23"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.649805+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:07.649826+03:00",
      "id": "bb517ba5ca544fd7b21eaf894a63afd7"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b85f96f321fe44378c76605a075f4f80?KeyID=172d32c8&Signature=PkSkrOo6heBcy1Yh5exZo2ksJMI%252BZ%252BnflXz065HAzV8GyrYKBR2WKxNwzFVsf3q3DaoDK%252BkDENPI22kcXAmPBg%253D%253D",
      "title": "AwardCriteria.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.703749+03:00",
      "dateModified": "2018-07-11T15:06:07.703770+03:00",
      "id": "cf91c283f3b04cb5a76d9368d69c161f"
    }
  ]
}

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

PUT /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/cf91c283f3b04cb5a76d9368d69c161f?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 342
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=8eDrypjKBIx1ehurKjEe%2B1ww%2FONYm2AC1P1%2BDdaEeaBUKtK9TlcGlD059rgFQvW3GYOLIcz4n%2Bx6zDaEdHO1Bg%3D%3D",
    "title": "AwardCriteria-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
    "title": "AwardCriteria-2.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.703749+03:00",
    "dateModified": "2018-07-11T15:06:07.765929+03:00",
    "id": "cf91c283f3b04cb5a76d9368d69c161f"
  }
}

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.421619+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:07.421641+03:00",
      "id": "779f993a42c54eadadff72d66788fb23"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.649805+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:07.649826+03:00",
      "id": "bb517ba5ca544fd7b21eaf894a63afd7"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.703749+03:00",
      "dateModified": "2018-07-11T15:06:07.765929+03:00",
      "id": "cf91c283f3b04cb5a76d9368d69c161f"
    }
  ]
}

Завантаження ілюстрації

Організатор може завантажити файли з ілюстраціями у створений аукціон. Завантаження повинно відповідати правилам Завантаження документа.

Для того, щоб вказати порядок відображення ілюстрацій, використовується поле index (див. Document). Оскільки ця ілюстрація повинна бути відображена першою, то вказується "index": 1.

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 432
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "index": 1,
    "hash": "md5:00000000000000000000000000000000",
    "description": "First illustration description",
    "title": "first_illustration.jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=44NDlwGUSjchl%2F1E9rd8cJIkXYeL%2FbHuVYTGAW8qTMiKBcATXGrfJC3TFdBElOlF%2FLmzbRZmQOGj3UmUjE7dBg%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/dbe0ca0c582b422d84c59a2aa93eb948
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 1,
    "hash": "md5:00000000000000000000000000000000",
    "description": "First illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=UPMVnKZTzNNA9AxDywJSZbpPjStBGoee80QWYvawEzzQnVYTxYuijJO8UMScqwMcbt5qrdjYn5jyfUyhvZzkDA%253D%253D",
    "title": "first_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.828825+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-11T15:06:07.828844+03:00",
    "id": "dbe0ca0c582b422d84c59a2aa93eb948"
  }
}

Ми можемо перевірити, чи завантажилась ілюстрація.

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.421619+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:07.421641+03:00",
      "id": "779f993a42c54eadadff72d66788fb23"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.649805+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:07.649826+03:00",
      "id": "bb517ba5ca544fd7b21eaf894a63afd7"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.703749+03:00",
      "dateModified": "2018-07-11T15:06:07.765929+03:00",
      "id": "cf91c283f3b04cb5a76d9368d69c161f"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=UPMVnKZTzNNA9AxDywJSZbpPjStBGoee80QWYvawEzzQnVYTxYuijJO8UMScqwMcbt5qrdjYn5jyfUyhvZzkDA%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.828825+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.828844+03:00",
      "id": "dbe0ca0c582b422d84c59a2aa93eb948"
    }
  ]
}

Організатор може завантажити ще одну ілюстрацію. Ця ілюстрація повинна бути відображена другою, тому має параметр "index": 2.

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 428
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Second illustration description",
    "title": "second_illustration.jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/240fe6c71e5a4291a3c9e39fbfeb460e?KeyID=172d32c8&Signature=aiaYSVot6s3YWRq8zdCetQDBq2FwrP1LstPmGw6EcG5s4bTvKFYjg0EnTewJ7KV14YbTt8DHzOhiPpb0hJirAA%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/402f115c7eb445c3a42eb624d2b45e17
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Second illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/240fe6c71e5a4291a3c9e39fbfeb460e?KeyID=172d32c8&Signature=k8V7cIG6xo5fopPWo%252B%2Fl3mxaliitImmqxRxKPbsJATjwe8Fde63J7%252BzgghykfYCTn9QwuMx1aVg1G6iNu7PNDg%253D%253D",
    "title": "second_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.897398+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-11T15:06:07.897419+03:00",
    "id": "402f115c7eb445c3a42eb624d2b45e17"
  }
}

Додаємо третю ілюстрацію:

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 442
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Third illustration description",
    "title": "third_illustration.jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/e401fae3f2004d11ac67e9b444eb6d09?KeyID=172d32c8&Signature=Mxs%2F2%2B03GvbmBy%2FZePxtBa8qVpaWmWJ1t%2FyuYSRbQTb%2Fm2Pw%2BvhOGL3n%2B2jOpvRdAroJNQHk5OFyYBI3q%2FMvAw%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents/feae4575ced24c718bae0f05d904c810
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Third illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/e401fae3f2004d11ac67e9b444eb6d09?KeyID=172d32c8&Signature=h7%2FVgGCvrQZMhz5xn6tYcxZ809Rxn25ohwJIoTihWblO8DCl2FHeJwFkHE3ZGUZeHBWCQ8ANi5eQEUiyd78qAg%253D%253D",
    "title": "third_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:07.952905+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-11T15:06:07.952925+03:00",
    "id": "feae4575ced24c718bae0f05d904c810"
  }
}

Зверніть увагу, що параметр index третьої ілюстрації такий же як і у другої: "index": 2. У таких випадках спочатку відображатиметься ілюстрація з ранішою датою публікації.

Можемо перевірити, що є три завантажені ілюстрації.

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
      "url": "http://torgi.fg.gov.ua/prozorrosale",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.421619+03:00",
      "documentType": "x_dgfPlatformLegalDetails",
      "dateModified": "2018-07-11T15:06:07.421641+03:00",
      "id": "779f993a42c54eadadff72d66788fb23"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.649805+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-11T15:06:07.649826+03:00",
      "id": "bb517ba5ca544fd7b21eaf894a63afd7"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.703749+03:00",
      "dateModified": "2018-07-11T15:06:07.765929+03:00",
      "id": "cf91c283f3b04cb5a76d9368d69c161f"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=UPMVnKZTzNNA9AxDywJSZbpPjStBGoee80QWYvawEzzQnVYTxYuijJO8UMScqwMcbt5qrdjYn5jyfUyhvZzkDA%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.828825+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.828844+03:00",
      "id": "dbe0ca0c582b422d84c59a2aa93eb948"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Second illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/240fe6c71e5a4291a3c9e39fbfeb460e?KeyID=172d32c8&Signature=k8V7cIG6xo5fopPWo%252B%2Fl3mxaliitImmqxRxKPbsJATjwe8Fde63J7%252BzgghykfYCTn9QwuMx1aVg1G6iNu7PNDg%253D%253D",
      "title": "second_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.897398+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.897419+03:00",
      "id": "402f115c7eb445c3a42eb624d2b45e17"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Third illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/e401fae3f2004d11ac67e9b444eb6d09?KeyID=172d32c8&Signature=h7%2FVgGCvrQZMhz5xn6tYcxZ809Rxn25ohwJIoTihWblO8DCl2FHeJwFkHE3ZGUZeHBWCQ8ANi5eQEUiyd78qAg%253D%253D",
      "title": "third_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:07.952905+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-11T15:06:07.952925+03:00",
      "id": "feae4575ced24c718bae0f05d904c810"
    }
  ]
}

Уточнення (питання)

Коли закупівля має статус active.tendering, зацікавлені сторони можуть задавати питання:

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "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": "Калорійність"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/questions/a19723c4af2948e48995d4888b25e4a6
X-Content-Type-Options: nosniff

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "uri": "http://sch10.edu.vn.ua/",
        "id": "00137226"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "title": "Калорійність",
    "date": "2018-07-11T15:06:08.106325+03:00",
    "id": "a19723c4af2948e48995d4888b25e4a6",
    "questionOf": "tender"
  }
}

Організатор може на них відповісти:

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/questions/a19723c4af2948e48995d4888b25e4a6?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність",
    "date": "2018-07-11T15:06:08.106325+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "a19723c4af2948e48995d4888b25e4a6",
    "questionOf": "tender"
  }
}

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "description": "Просимо додати таблицю потрібної калорійності харчування",
      "title": "Калорійність",
      "date": "2018-07-11T15:06:08.106325+03:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "id": "a19723c4af2948e48995d4888b25e4a6",
      "questionOf": "tender"
    }
  ]
}

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/questions/a19723c4af2948e48995d4888b25e4a6 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність",
    "date": "2018-07-11T15:06:08.106325+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "a19723c4af2948e48995d4888b25e4a6",
    "questionOf": "tender"
  }
}

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

Учасник може зареєструвати пропозицію у статусі draft (чернетка):

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 776
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "draft",
    "qualified": true,
    "value": {
      "amount": 500
    },
    "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": "м. Вінниця"
        }
      }
    ]
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a
X-Content-Type-Options: nosniff

{
  "access": {
    "token": "035a14661c204ad9a32c92d733351401"
  },
  "data": {
    "status": "draft",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:08.268644+03:00",
    "qualified": 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": "м. Вінниця"
        }
      }
    ],
    "owner": "broker",
    "id": "33e956525782481880696efc0dc83b4a"
  }
}

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a?acc_token=035a14661c204ad9a32c92d733351401 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "active"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:08.268644+03:00",
    "qualified": 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": "м. Вінниця"
        }
      }
    ],
    "owner": "broker",
    "id": "33e956525782481880696efc0dc83b4a"
  }
}

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a/documents?acc_token=035a14661c204ad9a32c92d733351401 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 329
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/c3462446d3094ed599f5980902c2f5dd?KeyID=172d32c8&Signature=ZNCG2Ohe0r0LHYHaGTQ4QWbcGRY39%2BgS0MsqzxHy9MwZM7p65GFqsaKNcRVUX1HxpTWHCoJTJk84l90WOgwKCQ%3D%3D",
    "title": "Proposal.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a/documents/b15abb588cf541c9b6fbd705a42d5790
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a/documents/b15abb588cf541c9b6fbd705a42d5790?download=c3462446d3094ed599f5980902c2f5dd",
    "title": "Proposal.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:08.403731+03:00",
    "dateModified": "2018-07-11T15:06:08.403752+03:00",
    "id": "b15abb588cf541c9b6fbd705a42d5790"
  }
}

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a/documents?acc_token=035a14661c204ad9a32c92d733351401 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a/documents/b15abb588cf541c9b6fbd705a42d5790?download=c3462446d3094ed599f5980902c2f5dd",
      "title": "Proposal.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:08.403731+03:00",
      "dateModified": "2018-07-11T15:06:08.403752+03:00",
      "id": "b15abb588cf541c9b6fbd705a42d5790"
    }
  ]
}

Для найкращого результату (найбільшої економії) аукціон повинен мати багато зареєстрованих учасників.

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 723
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "qualified": true,
    "value": {
      "amount": 501
    },
    "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": "м. Львів"
        }
      }
    ]
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/e17d3f64fe214a6b846c885cdf2aaa9b
X-Content-Type-Options: nosniff

{
  "access": {
    "token": "5477e8a5a5c34db7a482e95104a740e8"
  },
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:08.503786+03:00",
    "qualified": 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": "м. Львів"
        }
      }
    ],
    "owner": "broker",
    "id": "e17d3f64fe214a6b846c885cdf2aaa9b"
  }
}

Аукціон

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-11-000002",
    "auctionUrl": "http://auction-sandbox.openprocurement.org/auctions/bb1795e42a4243ada1433ddb18b4f06f",
    "enquiryPeriod": {
      "startDate": "2018-07-04T15:06:01.997072+03:00",
      "endDate": "2018-07-11T15:06:01.997072+03:00"
    },
    "submissionMethod": "electronicAuction",
    "dgfDecisionDate": "2016-11-17",
    "next_check": "2018-07-11T15:50:01.997072+03:00",
    "awardCriteria": "highestCost",
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "title": "Калорійність",
        "date": "2018-07-11T15:06:08.106325+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "a19723c4af2948e48995d4888b25e4a6",
        "questionOf": "tender"
      }
    ],
    "dgfDecisionID": "219560",
    "owner": "broker",
    "id": "bb1795e42a4243ada1433ddb18b4f06f",
    "documents": [
      {
        "title": "Місце та форма прийому заяв на участь в аукціоні та банківські реквізити для зарахування гарантійних внесків",
        "url": "http://torgi.fg.gov.ua/prozorrosale",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.421619+03:00",
        "documentType": "x_dgfPlatformLegalDetails",
        "dateModified": "2018-07-11T15:06:07.421641+03:00",
        "id": "779f993a42c54eadadff72d66788fb23"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cca399506447ed928a0d54f2f7be6c?KeyID=172d32c8&Signature=mKn74kqdS1gCIQ9BYDZNP8bHiXS%252BBKgRnCOaCo4ZsT7riQl2NEPUoJfa6wN%2Fwo2VccvpcIdRhvRrQL8NFtBsCg%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.649805+03:00",
        "documentType": "technicalSpecifications",
        "dateModified": "2018-07-11T15:06:07.649826+03:00",
        "id": "bb517ba5ca544fd7b21eaf894a63afd7"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b85f96f321fe44378c76605a075f4f80?KeyID=172d32c8&Signature=PkSkrOo6heBcy1Yh5exZo2ksJMI%252BZ%252BnflXz065HAzV8GyrYKBR2WKxNwzFVsf3q3DaoDK%252BkDENPI22kcXAmPBg%253D%253D",
        "title": "AwardCriteria.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.703749+03:00",
        "dateModified": "2018-07-11T15:06:07.703770+03:00",
        "id": "cf91c283f3b04cb5a76d9368d69c161f"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a8b26fa32cb42f3a69ba72c28d5db51?KeyID=172d32c8&Signature=y9meT2iCjfA5YdUhT1lSEZ1%252BIFYd6mMcv5sauCMDJCQAoifkdIUo4zgmMqZ%2FzGbJJlixeUdA5n5%252BFhLTkfDOCQ%253D%253D",
        "title": "AwardCriteria-2.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.703749+03:00",
        "dateModified": "2018-07-11T15:06:07.765929+03:00",
        "id": "cf91c283f3b04cb5a76d9368d69c161f"
      },
      {
        "index": 1,
        "hash": "md5:00000000000000000000000000000000",
        "description": "First illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/da7171338cfd40daaf0a363d1da7be8c?KeyID=172d32c8&Signature=UPMVnKZTzNNA9AxDywJSZbpPjStBGoee80QWYvawEzzQnVYTxYuijJO8UMScqwMcbt5qrdjYn5jyfUyhvZzkDA%253D%253D",
        "title": "first_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.828825+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-11T15:06:07.828844+03:00",
        "id": "dbe0ca0c582b422d84c59a2aa93eb948"
      },
      {
        "index": 2,
        "hash": "md5:00000000000000000000000000000000",
        "description": "Second illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/240fe6c71e5a4291a3c9e39fbfeb460e?KeyID=172d32c8&Signature=k8V7cIG6xo5fopPWo%252B%2Fl3mxaliitImmqxRxKPbsJATjwe8Fde63J7%252BzgghykfYCTn9QwuMx1aVg1G6iNu7PNDg%253D%253D",
        "title": "second_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.897398+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-11T15:06:07.897419+03:00",
        "id": "402f115c7eb445c3a42eb624d2b45e17"
      },
      {
        "index": 2,
        "hash": "md5:00000000000000000000000000000000",
        "description": "Third illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/e401fae3f2004d11ac67e9b444eb6d09?KeyID=172d32c8&Signature=h7%2FVgGCvrQZMhz5xn6tYcxZ809Rxn25ohwJIoTihWblO8DCl2FHeJwFkHE3ZGUZeHBWCQ8ANi5eQEUiyd78qAg%253D%253D",
        "title": "third_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:07.952905+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-11T15:06:07.952925+03:00",
        "id": "feae4575ced24c718bae0f05d904c810"
      },
      {
        "title": "Familiarization with bank asset",
        "format": "offline/on-site-examination",
        "accessDetails": "Familiar with asset: days, time, address",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:08.031929+03:00",
        "documentType": "x_dgfAssetFamiliarization",
        "dateModified": "2018-07-11T15:06:08.031952+03:00",
        "id": "af860bef04d8419191bd242fbfbd4fc6"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "procurementMethodDetails": "quick, accelerator=1440",
    "dateModified": "2018-07-11T15:06:08.724401+03:00",
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2018-07-04T15:06:01.997072+03:00",
      "endDate": "2018-07-11T15:06:01.997072+03:00"
    },
    "auctionPeriod": {
      "startDate": "2018-07-11T15:06:01.997072+03:00",
      "shouldStartAfter": "2018-07-12T00:00:00+03:00"
    },
    "procurementMethodType": "DGFOtherAssets",
    "dgfID": "219560",
    "date": "2018-07-11T15:06:07.421282+03:00",
    "submissionMethodDetails": "test submissionMethodDetails",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "314f1cb8d47a46009b5c9537e8974be6",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a?acc_token=035a14661c204ad9a32c92d733351401 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/33e956525782481880696efc0dc83b4a/documents/b15abb588cf541c9b6fbd705a42d5790?download=c3462446d3094ed599f5980902c2f5dd",
        "title": "Proposal.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:08.403731+03:00",
        "dateModified": "2018-07-11T15:06:08.403752+03:00",
        "id": "b15abb588cf541c9b6fbd705a42d5790"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:08.268644+03:00",
    "qualified": 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": "м. Вінниця"
        }
      }
    ],
    "owner": "broker",
    "id": "33e956525782481880696efc0dc83b4a",
    "participationUrl": "http://auction-sandbox.openprocurement.org/auctions/bb1795e42a4243ada1433ddb18b4f06f?key_for_bid=33e956525782481880696efc0dc83b4a"
  }
}

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

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/bids/e17d3f64fe214a6b846c885cdf2aaa9b?acc_token=5477e8a5a5c34db7a482e95104a740e8 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:08.503786+03:00",
    "qualified": 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": "м. Львів"
        }
      }
    ],
    "owner": "broker",
    "id": "e17d3f64fe214a6b846c885cdf2aaa9b",
    "participationUrl": "http://auction-sandbox.openprocurement.org/auctions/bb1795e42a4243ada1433ddb18b4f06f?key_for_bid=e17d3f64fe214a6b846c885cdf2aaa9b"
  }
}

Кваліфікація

After the competitive auction two awards are created: * for the first candidate (a participant that has submitted the highest valid bid at the auction) - initially has a pending status and awaits auction protocol to be uploaded by the organizer; * for the second candidate (a participant that has submitted the second highest valid bid at the auction)- initially has a pending.waiting status.

Існує ще два сценарії, що можуть мати місце після закінчення аукціону:
  • If the two highest bidders have invalid bids (lower than auction starting price + minimal step), the awards will not be created at all, and the qualification procedure will automatically receive the unsuccessful status.
  • If the second highest bidder has a bid that is less than the starting price + minimal step, two awards are created, with one of them receiving a pending.verification status and undergoing the qualification procedure, and the other (with an invalid bid) automatically becoming unsuccessful.
GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "status": "pending",
      "verificationPeriod": {
        "startDate": "2018-07-11T15:06:09.034064+03:00",
        "endDate": "2018-07-11T15:10:16.111147+03:00"
      },
      "signingPeriod": {
        "startDate": "2018-07-11T15:06:09.034064+03:00",
        "endDate": "2018-07-11T15:26:15.444480+03:00"
      },
      "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": "2018-07-11T15:06:09.034064+03:00"
      },
      "bid_id": "e17d3f64fe214a6b846c885cdf2aaa9b",
      "value": {
        "currency": "UAH",
        "amount": 501.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2018-07-11T15:06:09.034064+03:00",
      "id": "3d052a44e86147129b0b01e3cbec1c14"
    },
    {
      "status": "pending.waiting",
      "complaintPeriod": {
        "startDate": "2018-07-11T15:06:09.034064+03:00"
      },
      "suppliers": [
        {
          "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": "м. Вінниця"
          }
        }
      ],
      "bid_id": "33e956525782481880696efc0dc83b4a",
      "value": {
        "currency": "UAH",
        "amount": 500.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2018-07-11T15:06:09.034064+03:00",
      "id": "f0b67608db9b41f6bef95fc82a62f7c1"
    }
  ]
}

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

The organizer must upload and confirm the auction protocol auctionProtocol and add it to the award within 4 business days after the start of the qualification procedure. The candidate still has a possibility to upload the protocol, but it is neither mandatory, nor sufficient to move to the next status. If the auction protocol has not been uploaded before the end of verificationPeriod, the award is automatically transferred to the unsuccessful status.

It is the organizer’s duty to upload and confirm the protocol, as well as to switch the award to active status.

Otherwise, the award will automatically become unsuccessful”

Contract prolongation

Organizer can prolong contract signing period by creating a prolongation object:

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 172
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "decisionID": "ZM-937-99-92",
    "reason": "other",
    "documents": [],
    "description": "Prolongation description",
    "datePublished": "2018-07-11T15:06:02.303212+03:00"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "draft",
    "decisionID": "ZM-937-99-92",
    "description": "Prolongation description",
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "reason": "other",
    "datePublished": "2018-07-11T15:06:02.303212+03:00",
    "id": "22c7acbefec94ec6b8c4b1ad6807a078"
  }
}

For the object to be prolonged the next data has to be included:

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 440
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "title": "ProlongationDocument.doc",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=iBGMtFVPcxjwLQS%2B1XymFi9uNV2G1hWEFRtJ%2BYXylcEIRiYyQ9fy8ZI%2B%2FbX%2F%2FUNHwTbywemLWThl9ijrtjUjCA%3D%3D",
    "format": "application/pdf",
    "documentType": "prolongationProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078/documents/60bfda57b0844971a14ac7dabd950f4e
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=O%2FzNlUmCYhxxyhquaaU61uu7KTePQJsk93f9n0mu63TPpO4J%2Fc0DPjukind8shAJcOSAf7tTgB8NT1zPbPXyDw%253D%253D",
    "title": "ProlongationDocument.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:10.305330+03:00",
    "documentType": "prolongationProtocol",
    "dateModified": "2018-07-11T15:06:10.305361+03:00",
    "id": "60bfda57b0844971a14ac7dabd950f4e"
  }
}

Created prolongation has status “draft” by default, so there is a need to active it:

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "applied"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "applied",
    "decisionID": "ZM-937-99-92",
    "description": "Prolongation description",
    "datePublished": "2018-07-11T15:06:02.303212+03:00",
    "reason": "other",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "content_with_prolongation_data",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=O%2FzNlUmCYhxxyhquaaU61uu7KTePQJsk93f9n0mu63TPpO4J%2Fc0DPjukind8shAJcOSAf7tTgB8NT1zPbPXyDw%253D%253D",
        "title": "ProlongationDocument.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:10.305330+03:00",
        "documentType": "prolongationProtocol",
        "dateModified": "2018-07-11T15:06:10.305361+03:00",
        "id": "60bfda57b0844971a14ac7dabd950f4e"
      }
    ],
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "id": "22c7acbefec94ec6b8c4b1ad6807a078"
  }
}

When a contract has been prolongated for first time, a short prolongation period (42 business days) is applied. It’s also possible to apply a long-term (132 business days) prolongation: just create new Prolongation for the already prolongated Contract, and apply it.

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 179
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "decisionID": "ZM-937-99-92-2",
    "reason": "other",
    "documents": [],
    "description": "Long prolongation description",
    "datePublished": "2018-07-11T15:06:02.303227+03:00"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "draft",
    "decisionID": "ZM-937-99-92-2",
    "description": "Long prolongation description",
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "reason": "other",
    "datePublished": "2018-07-11T15:06:02.303227+03:00",
    "id": "eb7e1d4d47c041c0882cd91c00952c65"
  }
}
POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 436
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "title": "LongProlongationDocument.doc",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=H7WL7UZ1K6NrB9XB4DIHHdHFcwYLL%2F6M8HqBzoZX8jgTJQBx8z6aPv2xyyaCYm%2F3q08eNLwtb44fL65Rm9QmBw%3D%3D",
    "format": "application/pdf",
    "documentType": "prolongationProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65/documents/4e70262362014335b439cd227e5de663
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=g7WWF%2FKSpXzPjRxD2wpet8scNkNCRE%2FNxccqW7Shk4CqmN1i%252Blig00sv80Kuvl0EXTBk3UBjI2umKuFZ8jL7CQ%253D%253D",
    "title": "LongProlongationDocument.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:10.675174+03:00",
    "documentType": "prolongationProtocol",
    "dateModified": "2018-07-11T15:06:10.675194+03:00",
    "id": "4e70262362014335b439cd227e5de663"
  }
}
PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "applied"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "applied",
    "decisionID": "ZM-937-99-92-2",
    "description": "Long prolongation description",
    "datePublished": "2018-07-11T15:06:02.303227+03:00",
    "reason": "other",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "content_with_prolongation_data",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=g7WWF%2FKSpXzPjRxD2wpet8scNkNCRE%2FNxccqW7Shk4CqmN1i%252Blig00sv80Kuvl0EXTBk3UBjI2umKuFZ8jL7CQ%253D%253D",
        "title": "LongProlongationDocument.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:10.675174+03:00",
        "documentType": "prolongationProtocol",
        "dateModified": "2018-07-11T15:06:10.675194+03:00",
        "id": "4e70262362014335b439cd227e5de663"
      }
    ],
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "id": "eb7e1d4d47c041c0882cd91c00952c65"
  }
}

Дискваліфікація кандидата.

У випадку ручної дискваліфікації, організатор повинен завантажити файл з поясненням причини дискваліфікації кандидата.

POST /api/2.5/auctions/d703c42df3b9428c91119666efc96d32/awards/1af9e5d03c144172a542e0a9b736f5ff/documents?acc_token=a2774a39522b480fb72b3b6f8d291c96 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 394
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a792e87740b44405b4ab9341659886af?KeyID=172d32c8&Signature=WJZUGD%2FrehJ%2FHMc2FF88pjA%2FbN%2FQvM8hd5fX%2FKXQr0NAOeD2WItWk2FSokhKqovJmOa954%2BzDTha7h%2Bfpn19BQ%3D%3D",
    "title": "Disqualified_reason.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "description": "Disqualification reason",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/d703c42df3b9428c91119666efc96d32/awards/1af9e5d03c144172a542e0a9b736f5ff/documents/aed404c5e956422f90d00d8f255b4198
X-Content-Type-Options: nosniff

{
  "data": {
    "dateModified": "2018-07-11T15:06:06.085849+03:00",
    "hash": "md5:00000000000000000000000000000000",
    "description": "Disqualification reason",
    "author": "auction_owner",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a792e87740b44405b4ab9341659886af?KeyID=172d32c8&Signature=DXm2Ng5SUJpzDB0RA6H3TScf122R9VY7fRBS4JkzO1FYghCTcKxSngm0YcI%252BVrCyXFTwEKmFHFqSv3wRpn3tCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:06.085830+03:00",
    "title": "Disqualified_reason.pdf",
    "id": "aed404c5e956422f90d00d8f255b4198"
  }
}

Та дискваліфікувати кандидата:

PATCH /api/2.5/auctions/d703c42df3b9428c91119666efc96d32/awards/1af9e5d03c144172a542e0a9b736f5ff?acc_token=a2774a39522b480fb72b3b6f8d291c96 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 146
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "unsuccessful",
    "description": "Candidate didn’t sign the auction protocol in 3 business days",
    "title": "Disqualified"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "unsuccessful",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "bid_owner",
        "title": "auction_protocol.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/0e9d83c40bda4ee686b1ee770f4ae29d?KeyID=172d32c8&Signature=KF2%2F0siIuSjSWeLo4w1mQYg4aXF9E996sRRLaLZQyMpPSVReZ69CQ%2F1k43228sZWTwytyB3JVPnA%2FlmZvNYGBw%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:05.985154+03:00",
        "documentType": "auctionProtocol",
        "dateModified": "2018-07-11T15:06:05.985173+03:00",
        "id": "d5f65b961f574b25acf9cbfa7a6ccf95"
      },
      {
        "dateModified": "2018-07-11T15:06:06.085849+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "description": "Disqualification reason",
        "author": "auction_owner",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a792e87740b44405b4ab9341659886af?KeyID=172d32c8&Signature=DXm2Ng5SUJpzDB0RA6H3TScf122R9VY7fRBS4JkzO1FYghCTcKxSngm0YcI%252BVrCyXFTwEKmFHFqSv3wRpn3tCQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:06.085830+03:00",
        "title": "Disqualified_reason.pdf",
        "id": "aed404c5e956422f90d00d8f255b4198"
      }
    ],
    "verificationPeriod": {
      "startDate": "2018-07-11T15:06:05.868405+03:00",
      "endDate": "2018-07-11T15:06:06.195718+03:00"
    },
    "description": "Candidate didn’t sign the auction protocol in 3 business days",
    "title": "Disqualified",
    "suppliers": [
      {
        "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": "м. Вінниця"
        }
      }
    ],
    "complaintPeriod": {
      "startDate": "2018-07-11T15:06:05.564780+03:00",
      "endDate": "2018-07-11T15:06:06.195718+03:00"
    },
    "bid_id": "7decb4064e5846949180ea56c86da1c0",
    "value": {
      "currency": "UAH",
      "amount": 475.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:06.204752+03:00",
    "id": "1af9e5d03c144172a542e0a9b736f5ff",
    "signingPeriod": {
      "startDate": "2018-07-11T15:06:05.868405+03:00",
      "endDate": "2018-07-11T15:26:12.281599+03:00"
    }
  }
}

Within 20 business days since becoming candidate a new candidate must confirm qualification with steps described above (Кваліфікація).

Відмова очікування іншим учасником

Другий кандидат (учасник, чия ставка є другою найвищою валідною ставкою) може відмовитись очікувати дискваліфікації першого кандидата:

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/awards/f0b67608db9b41f6bef95fc82a62f7c1?acc_token=035a14661c204ad9a32c92d733351401 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "cancelled"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "cancelled",
    "complaintPeriod": {
      "startDate": "2018-07-11T15:06:09.034064+03:00",
      "endDate": "2018-07-11T15:06:09.218067+03:00"
    },
    "suppliers": [
      {
        "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": "м. Вінниця"
        }
      }
    ],
    "bid_id": "33e956525782481880696efc0dc83b4a",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:09.224192+03:00",
    "id": "f0b67608db9b41f6bef95fc82a62f7c1"
  }
}

Підписання угоди

The candidate has 20 business days after becoming a candidate to conclude a contract with the bank based on the results of electronic auction.

Завантаження документів щодо укладання угоди

Спробуємо завантажити документ пов’язаний з угодою:

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 345
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/46cb517bd7684c1a9779bc6c6b61aa3b?KeyID=172d32c8&Signature=obA0anF8xK3cwzh7atz0SLsB9v9i7qTz08XHuJ0oYnsui4uYlKDN3YdI8BCQ5MltDGz4AHsb39J71XMQO09sAQ%3D%3D",
    "title": "contract_first_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents/ed5631e083de4bb78654b925d57868b5
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/46cb517bd7684c1a9779bc6c6b61aa3b?KeyID=172d32c8&Signature=XvKnw4LjI6hr76DvKNP0ErxWYsLQfH2zRLwnDcs056LoQkSA92m2ch1bsVlfVzGADUyXv4zaoFuwEJMtnVN%252BCQ%253D%253D",
    "title": "contract_first_document.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:09.858414+03:00",
    "dateModified": "2018-07-11T15:06:09.858435+03:00",
    "id": "ed5631e083de4bb78654b925d57868b5"
  }
}

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

Переглянемо список завантажених документів:

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/46cb517bd7684c1a9779bc6c6b61aa3b?KeyID=172d32c8&Signature=XvKnw4LjI6hr76DvKNP0ErxWYsLQfH2zRLwnDcs056LoQkSA92m2ch1bsVlfVzGADUyXv4zaoFuwEJMtnVN%252BCQ%253D%253D",
      "title": "contract_first_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:09.858414+03:00",
      "dateModified": "2018-07-11T15:06:09.858435+03:00",
      "id": "ed5631e083de4bb78654b925d57868b5"
    }
  ]
}

Тепер спробуємо додати ще один документ щодо укладанням угоди:

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 350
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/91892b0c6fed455bb136447fb6f9e03c?KeyID=172d32c8&Signature=oSIvQw4xaTFtxOjnX1C4fWJYZiGQ7INXf9VH1C496FsjWMZAA6UwLGpvhnOX6tW1DQ%2BmoQTpSi5wvI%2FuOGhFDw%3D%3D",
    "title": "contract_second_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents/bf57bef28c0548d7aac002e48b85d4a1
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/91892b0c6fed455bb136447fb6f9e03c?KeyID=172d32c8&Signature=LNrfV4IvqjUYzlQKQB6degrvA%2FNfGIS%2FgbgbF09lzg26JZ%2FGx8kh7iwpJ7R%2Fxu5YB51EVq%2F5j7GaC2thrQXbDA%253D%253D",
    "title": "contract_second_document.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:10.026475+03:00",
    "dateModified": "2018-07-11T15:06:10.026498+03:00",
    "id": "bf57bef28c0548d7aac002e48b85d4a1"
  }
}

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

Тепер переглянемо знову усі документи пов’язані із укладанням угоди:

GET /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/46cb517bd7684c1a9779bc6c6b61aa3b?KeyID=172d32c8&Signature=XvKnw4LjI6hr76DvKNP0ErxWYsLQfH2zRLwnDcs056LoQkSA92m2ch1bsVlfVzGADUyXv4zaoFuwEJMtnVN%252BCQ%253D%253D",
      "title": "contract_first_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:09.858414+03:00",
      "dateModified": "2018-07-11T15:06:09.858435+03:00",
      "id": "ed5631e083de4bb78654b925d57868b5"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/91892b0c6fed455bb136447fb6f9e03c?KeyID=172d32c8&Signature=LNrfV4IvqjUYzlQKQB6degrvA%2FNfGIS%2FgbgbF09lzg26JZ%2FGx8kh7iwpJ7R%2Fxu5YB51EVq%2F5j7GaC2thrQXbDA%253D%253D",
      "title": "contract_second_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-11T15:06:10.026475+03:00",
      "dateModified": "2018-07-11T15:06:10.026498+03:00",
      "id": "bf57bef28c0548d7aac002e48b85d4a1"
    }
  ]
}

Contract prolongation

Organizer can prolongate contract signing period by creating prolongation

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 172
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "decisionID": "ZM-937-99-92",
    "reason": "other",
    "documents": [],
    "description": "Prolongation description",
    "datePublished": "2018-07-11T15:06:02.303212+03:00"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "draft",
    "decisionID": "ZM-937-99-92",
    "description": "Prolongation description",
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "reason": "other",
    "datePublished": "2018-07-11T15:06:02.303212+03:00",
    "id": "22c7acbefec94ec6b8c4b1ad6807a078"
  }
}

Prolongation must have documents attached to be prepared for activation

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 440
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "title": "ProlongationDocument.doc",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=iBGMtFVPcxjwLQS%2B1XymFi9uNV2G1hWEFRtJ%2BYXylcEIRiYyQ9fy8ZI%2B%2FbX%2F%2FUNHwTbywemLWThl9ijrtjUjCA%3D%3D",
    "format": "application/pdf",
    "documentType": "prolongationProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078/documents/60bfda57b0844971a14ac7dabd950f4e
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=O%2FzNlUmCYhxxyhquaaU61uu7KTePQJsk93f9n0mu63TPpO4J%2Fc0DPjukind8shAJcOSAf7tTgB8NT1zPbPXyDw%253D%253D",
    "title": "ProlongationDocument.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:10.305330+03:00",
    "documentType": "prolongationProtocol",
    "dateModified": "2018-07-11T15:06:10.305361+03:00",
    "id": "60bfda57b0844971a14ac7dabd950f4e"
  }
}

Created prolongation has status “draft” by default, so there is a need to set status to “applied” to make it active.

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/22c7acbefec94ec6b8c4b1ad6807a078?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "applied"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "applied",
    "decisionID": "ZM-937-99-92",
    "description": "Prolongation description",
    "datePublished": "2018-07-11T15:06:02.303212+03:00",
    "reason": "other",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "content_with_prolongation_data",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=O%2FzNlUmCYhxxyhquaaU61uu7KTePQJsk93f9n0mu63TPpO4J%2Fc0DPjukind8shAJcOSAf7tTgB8NT1zPbPXyDw%253D%253D",
        "title": "ProlongationDocument.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:10.305330+03:00",
        "documentType": "prolongationProtocol",
        "dateModified": "2018-07-11T15:06:10.305361+03:00",
        "id": "60bfda57b0844971a14ac7dabd950f4e"
      }
    ],
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "id": "22c7acbefec94ec6b8c4b1ad6807a078"
  }
}

When a contract has been prolongated for first time, a short prolongation period applies. It is equal to 42 working days. It’s also possible to apply long-term (132 days) prolongation: just create new Prolongation for the already prolongated Contract, and apply it.

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 179
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "decisionID": "ZM-937-99-92-2",
    "reason": "other",
    "documents": [],
    "description": "Long prolongation description",
    "datePublished": "2018-07-11T15:06:02.303227+03:00"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "draft",
    "decisionID": "ZM-937-99-92-2",
    "description": "Long prolongation description",
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "reason": "other",
    "datePublished": "2018-07-11T15:06:02.303227+03:00",
    "id": "eb7e1d4d47c041c0882cd91c00952c65"
  }
}
POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 436
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "title": "LongProlongationDocument.doc",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=H7WL7UZ1K6NrB9XB4DIHHdHFcwYLL%2F6M8HqBzoZX8jgTJQBx8z6aPv2xyyaCYm%2F3q08eNLwtb44fL65Rm9QmBw%3D%3D",
    "format": "application/pdf",
    "documentType": "prolongationProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65/documents/4e70262362014335b439cd227e5de663
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "content_with_prolongation_data",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=g7WWF%2FKSpXzPjRxD2wpet8scNkNCRE%2FNxccqW7Shk4CqmN1i%252Blig00sv80Kuvl0EXTBk3UBjI2umKuFZ8jL7CQ%253D%253D",
    "title": "LongProlongationDocument.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:10.675174+03:00",
    "documentType": "prolongationProtocol",
    "dateModified": "2018-07-11T15:06:10.675194+03:00",
    "id": "4e70262362014335b439cd227e5de663"
  }
}
PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec/prolongations/eb7e1d4d47c041c0882cd91c00952c65?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "applied"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "applied",
    "decisionID": "ZM-937-99-92-2",
    "description": "Long prolongation description",
    "datePublished": "2018-07-11T15:06:02.303227+03:00",
    "reason": "other",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "content_with_prolongation_data",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=g7WWF%2FKSpXzPjRxD2wpet8scNkNCRE%2FNxccqW7Shk4CqmN1i%252Blig00sv80Kuvl0EXTBk3UBjI2umKuFZ8jL7CQ%253D%253D",
        "title": "LongProlongationDocument.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:10.675174+03:00",
        "documentType": "prolongationProtocol",
        "dateModified": "2018-07-11T15:06:10.675194+03:00",
        "id": "4e70262362014335b439cd227e5de663"
      }
    ],
    "dateCreated": "2018-07-11T15:06:01.969656+03:00",
    "id": "eb7e1d4d47c041c0882cd91c00952c65"
  }
}

Реєстрація угоди

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/contracts/538cb657fbe54c93973e858feffa3dec?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 80
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "active",
    "dateSigned": "2018-07-11T15:06:10.900112+03:00"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "prolongations": [
      {
        "status": "applied",
        "decisionID": "ZM-937-99-92",
        "description": "Prolongation description",
        "datePublished": "2018-07-11T15:06:02.303212+03:00",
        "reason": "other",
        "documents": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "description": "content_with_prolongation_data",
            "format": "application/pdf",
            "url": "http://public.docs-sandbox.ea.openprocurement.org/get/cd21460130854aebaa3706c137ac1d9b?KeyID=172d32c8&Signature=O%2FzNlUmCYhxxyhquaaU61uu7KTePQJsk93f9n0mu63TPpO4J%2Fc0DPjukind8shAJcOSAf7tTgB8NT1zPbPXyDw%253D%253D",
            "title": "ProlongationDocument.doc",
            "documentOf": "tender",
            "datePublished": "2018-07-11T15:06:10.305330+03:00",
            "documentType": "prolongationProtocol",
            "dateModified": "2018-07-11T15:06:10.305361+03:00",
            "id": "60bfda57b0844971a14ac7dabd950f4e"
          }
        ],
        "dateCreated": "2018-07-11T15:06:01.969656+03:00",
        "id": "22c7acbefec94ec6b8c4b1ad6807a078"
      },
      {
        "status": "applied",
        "decisionID": "ZM-937-99-92-2",
        "description": "Long prolongation description",
        "datePublished": "2018-07-11T15:06:02.303227+03:00",
        "reason": "other",
        "documents": [
          {
            "hash": "md5:00000000000000000000000000000000",
            "description": "content_with_prolongation_data",
            "format": "application/pdf",
            "url": "http://public.docs-sandbox.ea.openprocurement.org/get/f4ad6c106f6c4184bf812be2025e438e?KeyID=172d32c8&Signature=g7WWF%2FKSpXzPjRxD2wpet8scNkNCRE%2FNxccqW7Shk4CqmN1i%252Blig00sv80Kuvl0EXTBk3UBjI2umKuFZ8jL7CQ%253D%253D",
            "title": "LongProlongationDocument.doc",
            "documentOf": "tender",
            "datePublished": "2018-07-11T15:06:10.675174+03:00",
            "documentType": "prolongationProtocol",
            "dateModified": "2018-07-11T15:06:10.675194+03:00",
            "id": "4e70262362014335b439cd227e5de663"
          }
        ],
        "dateCreated": "2018-07-11T15:06:01.969656+03:00",
        "id": "eb7e1d4d47c041c0882cd91c00952c65"
      }
    ],
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/46cb517bd7684c1a9779bc6c6b61aa3b?KeyID=172d32c8&Signature=XvKnw4LjI6hr76DvKNP0ErxWYsLQfH2zRLwnDcs056LoQkSA92m2ch1bsVlfVzGADUyXv4zaoFuwEJMtnVN%252BCQ%253D%253D",
        "title": "contract_first_document.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:09.858414+03:00",
        "dateModified": "2018-07-11T15:06:09.858435+03:00",
        "id": "ed5631e083de4bb78654b925d57868b5"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/91892b0c6fed455bb136447fb6f9e03c?KeyID=172d32c8&Signature=LNrfV4IvqjUYzlQKQB6degrvA%2FNfGIS%2FgbgbF09lzg26JZ%2FGx8kh7iwpJ7R%2Fxu5YB51EVq%2F5j7GaC2thrQXbDA%253D%253D",
        "title": "contract_second_document.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:10.026475+03:00",
        "dateModified": "2018-07-11T15:06:10.026498+03:00",
        "id": "bf57bef28c0548d7aac002e48b85d4a1"
      }
    ],
    "signingPeriod": {
      "startDate": "2018-07-11T15:06:09.034064+03:00",
      "endDate": "2018-07-11T17:18:16.277790+03:00"
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV",
          "description": "Земельні ділянки",
          "id": "06000000-2"
        },
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "id": "314f1cb8d47a46009b5c9537e8974be6",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "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": "2018-07-11T15:06:02.303178+03:00",
      "endDate": "2019-07-11T15:06:02.303178+03:00"
    },
    "dateSigned": "2018-07-11T15:06:10.900112+03:00",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-11T15:06:10.997720+03:00",
    "awardID": "3d052a44e86147129b0b01e3cbec1c14",
    "id": "538cb657fbe54c93973e858feffa3dec",
    "contractID": "UA-EA-2018-07-11-000002-1"
  }
}

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

Організатор (ліквідатор) може скасувати аукціон на будь-якому етапі окрім аукціону в термінальних статусах (unsuccessful, cancelled, complete).

Для цього потрібно виконати наступні кроки:

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

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

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

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

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

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

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

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "reason": "cancellation reason"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c
X-Content-Type-Options: nosniff

{
  "data": {
    "date": "2018-07-11T15:06:11.226624+03:00",
    "status": "pending",
    "reason": "cancellation reason",
    "cancellationOf": "tender",
    "id": "8d13337163de4a51b8caad7efab95a9c"
  }
}

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

Завантаження вмісту файлу:

POST /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c/documents?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 331
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/118a47764259485dbae4a2f0dfdcf557?KeyID=172d32c8&Signature=%2Fj1rim2kHN5gKzTvpi5jE%2BfTFPpjHI4knANQ8y1FOR1saL8y71%2FjwULEOsHC1bqG7ncpba3CXB0zOFte7BN0BQ%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c/documents/dd88f21f3fe049d1a769423cecefb3d2
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/118a47764259485dbae4a2f0dfdcf557?KeyID=172d32c8&Signature=ph2AmQzrfCHKMX0naRz1v0Vyxvy4rYfslqOzoXaVXs7mr9v1%2FubZMtr0ev5BR6IFOr5TZju1tE1HMiqMGcfLBw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:11.358918+03:00",
    "dateModified": "2018-07-11T15:06:11.358938+03:00",
    "id": "dd88f21f3fe049d1a769423cecefb3d2"
  }
}

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c/documents/dd88f21f3fe049d1a769423cecefb3d2?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 48
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "description": "Changed description"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/118a47764259485dbae4a2f0dfdcf557?KeyID=172d32c8&Signature=ph2AmQzrfCHKMX0naRz1v0Vyxvy4rYfslqOzoXaVXs7mr9v1%2FubZMtr0ev5BR6IFOr5TZju1tE1HMiqMGcfLBw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:11.358918+03:00",
    "dateModified": "2018-07-11T15:06:11.358938+03:00",
    "id": "dd88f21f3fe049d1a769423cecefb3d2"
  }
}

Завантаження нової версії документа:

PUT /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c/documents/dd88f21f3fe049d1a769423cecefb3d2?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 329
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a07fc742725b4d368494f4e2acd5c446?KeyID=172d32c8&Signature=tZ1R7cquRGVWzK8FixEZdZ882pPynH5tcuPMNBOCfHcwnXY8WcsxnQiwIdH%2BassrCOekTqalUVZXHEPeiY46CQ%3D%3D",
    "title": "Notice-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a07fc742725b4d368494f4e2acd5c446?KeyID=172d32c8&Signature=w2R5JkOzRaWcwNBhCcnzZyBWCq23J09QvRckHrhhbtYNKhjVXgIHnfc%252BTPeo0fROyF2XEYxEgLk5SpdUWRKTBA%253D%253D",
    "title": "Notice-2.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-11T15:06:11.358918+03:00",
    "dateModified": "2018-07-11T15:06:11.640471+03:00",
    "id": "dd88f21f3fe049d1a769423cecefb3d2"
  }
}

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

PATCH /api/2.5/auctions/bb1795e42a4243ada1433ddb18b4f06f/cancellations/8d13337163de4a51b8caad7efab95a9c?acc_token=0052e89467e54a799389e87c87910599 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "active"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/118a47764259485dbae4a2f0dfdcf557?KeyID=172d32c8&Signature=ph2AmQzrfCHKMX0naRz1v0Vyxvy4rYfslqOzoXaVXs7mr9v1%2FubZMtr0ev5BR6IFOr5TZju1tE1HMiqMGcfLBw%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:11.358918+03:00",
        "dateModified": "2018-07-11T15:06:11.358938+03:00",
        "id": "dd88f21f3fe049d1a769423cecefb3d2"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a07fc742725b4d368494f4e2acd5c446?KeyID=172d32c8&Signature=w2R5JkOzRaWcwNBhCcnzZyBWCq23J09QvRckHrhhbtYNKhjVXgIHnfc%252BTPeo0fROyF2XEYxEgLk5SpdUWRKTBA%253D%253D",
        "title": "Notice-2.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-11T15:06:11.358918+03:00",
        "dateModified": "2018-07-11T15:06:11.640471+03:00",
        "id": "dd88f21f3fe049d1a769423cecefb3d2"
      }
    ],
    "reason": "cancellation reason",
    "date": "2018-07-11T15:06:11.804922+03:00",
    "cancellationOf": "tender",
    "id": "8d13337163de4a51b8caad7efab95a9c"
  }
}