Awarding prolongation (DRAFT)

Опис задачі

Коли в процедурі сформувався award, треба зафіксувати що він створений і є 5 робочих днів на його оцінку та прийняття (status: active або status: unsuccessful). У разі неможливості прийняти рішення за робочих 5 днів замовник може продовжити розгляд до 20 робочих днів шляхом додавання причини продовження (description) та накладання підпису таким чином щоб система змогла сформувати з нього пдф е-протоколу продовження строку авард.

Дані що потрібно зафіксувати в апі

Користувацький інпут:

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

Автоматична генерація:

дата початку розгляду: дата, дата створення аварду
дата кінця розгляду: дата, розраховується як:
- дата початку розгляду + 5 робочих днів, якщо не було продовження
- дата початку розгляду + 20 робочих днів, якщо було продовження
дата продовження строку розгляду: дата, дата створення продовження

Пропозиція щодо реалізації: Період розгляду + майлстоун

Об’єкт period що створюється разом зі створенням аварду і змінює дату dueDate при подовженні строку розгляду.

Продовження строку розгляду відбувається за допомогою створення майлстоуна extensionPeriod.

Крок 1

Разом зі створенням аварду створюється об’єкт period з датами початку та кінця розгляду

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

GET /api/2.5/tenders/acc230d5bfa642958a52d3389b38f7b4/awards/62810a506e7f43a4831dd68565b516ce HTTP/1.0

Authorization: Bearer broker
Content-Length: 2918
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

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

{
  "id": "62810a506e7f43a4831dd68565b516ce",
  "status": "pending",
  "date": "2024-01-01T17:30:00.000000+02:00",
  "value": {...},
  "suppliers": [...],
  "bid_id": "4372bcd7b73b46998819584efe12505d",
  "lotID": "ee93ee67af68971ad033a41fb4e3551d",
  "documents": [...],
  "qualified": true,
  "eligible": true,
  "complaintPeriod": {...},
  "period": {
    "startDate": "2024-01-01T18:39:21.579086+02:00",
    "endDate": "2024-01-26T18:39:21.579086+02:00",
  },
}

де:

дата початку розгляду:

period.startDate

дата кінця розгляду (дата початку розгляду + 5 робочих днів):

period.endDate

Крок 2

продовжимо розгляд шляхом додавання майлстоуна extensionPeriod:

POST /api/2.5/tenders/acc230d5bfa642958a52d3389b38f7b4/awards/62810a506e7f43a4831dd68565b516ce/milestones HTTP/1.0

Authorization: Bearer broker
Content-Length: 2918
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "code": "extensionPeriod",
  "description": "Обгрунтування продовження строку розгляду",
}

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

{
  "id": "ba7457aa4a66410e8873e3129658d62d",
  "date": "2024-01-01T17:30:00.000000+02:00",
  "code": "extensionPeriod",
  "dueDate": "2024-01-26T18:39:21.579086+02:00",
  "description": "Обгрунтування продовження строку розгляду",
}

де:

обгрунтування продовження строку розгляду:

description

дата продовження строку розгляду:

date

дата кінця розгляду (дата початку розгляду + 20 робочих днів):

dueDate

в award система автоматично встановлює новий period.endDate як period.startDate + 20 робочих днів

Крок 3

Додаємо документ підпису на продовження:

POST /api/2.5/tenders/acc230d5bfa642958a52d3389b38f7b4/awards/62810a506e7f43a4831dd68565b516ce/documents HTTP/1.0

Authorization: Bearer broker
Content-Length: 2918
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "id": "f8e45a6ace18463792412fa5e01190c1",
  "title": "sign.p7s",
  "documentType": "extensionReport",
  "url": "http://link_to_file"
}

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

{
  "id": "f8e45a6ace18463792412fa5e01190c1",
  "title": "sign.p7s",
  "documentType": "extensionReport",
  "datePublished": "2024-01-04T17:30:00.000000+02:00",
  "url": "http://link_to_file"
}

Крок 4

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

GET /api/2.5/tenders/acc230d5bfa642958a52d3389b38f7b4/awards/62810a506e7f43a4831dd68565b516ce HTTP/1.0

Authorization: Bearer broker
Content-Length: 2918
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

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

{
  "id": "62810a506e7f43a4831dd68565b516ce",
  "status": "pending",
  "date": "2024-01-01T17:30:00.000000+02:00",
  "value": {...},
  "suppliers": [...],
  "bid_id": "4372bcd7b73b46998819584efe12505d",
  "lotID": "ee93ee67af68971ad033a41fb4e3551d",
  "documents": [
    {
      "id": "f8e45a6ace18463792412fa5e01190c1",
      "title": "sign.p7s",
      "documentType": "extensionReport",
      "datePublished": "2024-01-04T17:30:00.000000+02:00",
      "url": "http://link_to_file"
    }
  ]
  "qualified": true,
  "eligible": true,
  "complaintPeriod": {...},
  "period": {
    "startDate": "2024-01-01T18:39:21.579086+02:00",
    "endDate": "2024-01-26T18:39:21.579086+02:00",
  },
  "milestones": [
    {
      "id": "ba7457aa4a66410e8873e3129658d62d",
      "date": "2024-01-04T17:30:00.000000+02:00",
      "code": "extensionPeriod",
      "dueDate": "2024-01-26T18:39:21.579086+02:00",
      "description": "Обгрунтування продовження строку розгляду",
    }
  ]
}

де:

дата початку розгляду:

period.startDate

дата кінця розгляду (дата початку розгляду + 20 робочих днів):

period.endDate

milestones[?(@.code=='extensionPeriod')].dueDate

обгрунтування продовження строку розгляду:

milestones[?(@.code=='extensionPeriod')].description

дата продовження строку розгляду:

milestones[?(@.code=='extensionPeriod')].date

Warning

↓ непряма ознака

documents[?(@.documentType=='extensionReport')].datePublished

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

documents[?(@.documentType=='extensionReport')]