Ендпоінти сервісу requistions-service, які використовуються для роботи з заявкою на збір потреби за методологією та без.

</aside>

Зміст

</aside>

1. Отримання, фільтрація та сортування реєстру заявок поточної організації

<aside> <img src="/icons/move-document_gray.svg" alt="/icons/move-document_gray.svg" width="40px" /> Функціональні вимоги до реєстру заявок описані в розділі **5.2.1.1. Реєстр заявок та панель фільтрації** документу e-Stock | Технічні вимоги.

</aside>

<aside> <img src="/icons/swap-horizontally_gray.svg" alt="/icons/swap-horizontally_gray.svg" width="40px" /> Щоб отримати реєстр заявок на потребу для поточної організації (з фільтрацією / сортуванням або без) необхідно виконати GET запит на ендпоінт /v1/requisitions/current.

<aside> <img src="/icons/arrow-right_gray.svg" alt="/icons/arrow-right_gray.svg" width="40px" /> Параметри запиту

Параметр	Тип	Приклад значення	Обов’язково	Опис
size	int	10	Ні	Кількість записів, які будуть отримані на сторінці. Передається в заголовку.
page	int	0	Ні	Номер сторінки. Передається в заголовку.
conditions[i].fieldName={параметр}	string	status	Ні	Параметр фільтрації. Допустимі значення:

treatmentDirectionName
status
year

Використовується для фільтрації. Передається в заголовку. | | conditions[i].value={значення фільтру} | string | DRAFT | Ні | Значення фільтру.

Використовується для фільтрації. Передається в заголовку. | | conditions[i].operator={значення} | string | EQUALS | Ні | Оператор, за замовчуванням завжди передається значення EQUALS.

Використовується для фільтрації. Передається в заголовку. | | sort={параметр},{напрямок сортування} | string | modifiedAt,asc | Ні | Параметр та напрямок сортування. Допустимі значення:

modifiedAt

Використовується для сортування. Передається в заголовку. |

<aside> <img src="/icons/forward_gray.svg" alt="/icons/forward_gray.svg" width="40px" /> Приклад запиту (без фільтрації)

<https://requisitions-service-qa.es.meddata.com.ua/v1/requisitions/current?size=10&page=0>

</aside>

<aside> <img src="/icons/forward_gray.svg" alt="/icons/forward_gray.svg" width="40px" /> Приклад запиту (з фільтрами)

<https://requisitions-service-qa.es.meddata.com.ua/v1/requisitions/current?size=10&page=0&conditions[0].value=2024&conditions[0].fieldName=year&conditions[0].operator=EQUALS&conditions[1].value=DRAFT&conditions[1].fieldName=status&conditions[1].operator=EQUALS&conditions[2].value=ТЕСТ_ЛАГ&conditions[2].fieldName=treatmentDirectionName&conditions[2].operator=EQUALS>

</aside>

<aside> <img src="/icons/forward_gray.svg" alt="/icons/forward_gray.svg" width="40px" /> Приклад запиту (з сортуванням)

<https://requisitions-service-qa.es.meddata.com.ua/v1/requisitions/current?size=10&page=0&sort=modifiedAt,asc>

</aside>

<aside> <img src="/icons/arrow-left_gray.svg" alt="/icons/arrow-left_gray.svg" width="40px" /> Параметри відповіді

Параметр	Тип	Приклад значення	Опис
content	array	[…]	Основна інформація по створеним потребам.
createdAt	string	"2024-03-22T12:41:57.330338Z”	Дата створення заявки на потребу.
createdBy	string	"Багатозв’яз Гірський”	Автор заявки на потребу.
modifiedAt	string	"2024-03-22T12:41:57.330338Z”	Дата модифікації заявки на потребу.
modifiedBy	string	"Багатозв’яз Гірський”	Автор модифікації заявки на потребу.
id	int	297	Ідентифікатор заявки на потребу.
status	string	"DRAFT”	Статус заявки на потребу.
type	string	"BY_DIRECTION_OF_TREATMENT”	Тип заявки на потребу.
creationType	string	"REGULAR”	Тип створення заявки. Допустимі значення:

REGULAR: регулярна заявка, створювана ЗОЗ
AGGREGATED: агрегована заявка ДОЗ / МОЗ | | facilityName | string | "ТЕСТ ФО з РНОКПП” | Назва організації, що створила заявку на потребу. | | facilityTaxNumber | string | "9876543210” | Код організації, що створила заявку на потребу. | | requisitionNumber | string | "RQAO24297” | Номер заявки на потребу. | | totalCommentsQty | int | 0 | Кількість коменатрів в заявці на потребу. | | directionOfTreatmentDictionaryId | int | 56 | Ідентифікатор напрямку лікування. | | year | int | 2024 | Рік подання заявки на потребу. | | directionTypeName | string | "test_jra” | Назва типу напрямку лікування. | | medicalGuaranteeProgram | bool | false | Ознака покриття заявки на потребу програмою медичних гарантій. | | byMethodology | bool | true | Ознака збору потреби по методології. | | treatmentDirectionName | string | "ТЕСТ_ЮРА” | Назва напрямку лікування. | | organizationId | int | 69 | Ідентифікатор організації. | | emergencyName | string | null | Не використовується. | | organizationType | string | "ZOZ” | Тип організації. | | pageable | object | {…} | Інформація про сторінки, по яким відображаються заявки на потребу. | | pageable.sort | object | {…} | Сортування заявок на потребу. | | pageable.offset | int | 0 | Кількість записів, які “вже відображались” на попередніх сторінках. | | pageable.pageNumber | int | 0 | Порядковий номер сторінки. | | pageable.pageSize | int | 10 | Розмір сторінки (кількість записів на сторінці). | | pageable.paged | bool | true | Ознака розбиття заявок по сторінкам. | | pageable.unpaged | bool | false | Ознака не розбиття заявок по сторінкам. | | last | bool | true | Ознака останньої сторінки. | | totalPages | int | 1 | Загальна кількість сторінок. | | totalElements | int | 4 | Загальна кількість заявок на потребу. | | size | int | 10 | Розмір сторінки (кількість записів на сторінці). | | number | int | 0 | Порядковий номер сторінки. | | sort | object | {…} | Сортування заявок на потребу. | | first | bool | true | Ознака першої сторінки. | | numberOfElements | int | 4 | Кількість елементів (заявок на потребу) на сторінц. | | empty | bool | false | Ознака пустої сторінки (відсутності на ній заявок на потребу). |

<aside> <img src="/icons/backward_gray.svg" alt="/icons/backward_gray.svg" width="40px" /> Приклад відповіді

{
    "content": 
        {
            "createdAt": "2024-03-22T12:41:57.330338Z",
            "createdBy": "Багатозв’яз Гірський",
            "modifiedAt": "2024-03-22T12:41:57.384444Z",
            "modifiedBy": "Багатозв’яз Гірський",
            "id": 297,
            "status": "DRAFT", 
            "type": "BY_DIRECTION_OF_TREATMENT",
            "creationType": "REGULAR",
            "facilityName": "ТЕСТ ФО з РНОКПП", 
            "facilityTaxNumber": "9876543210", 
            "requisitionNumber": "RQAO24297",
            "totalCommentsQty": 0,
            "directionOfTreatmentDictionaryId": 56
            "year": 2024, // рік збору потреби
            "directionTypeName": "test_jra",
            "medicalGuaranteeProgram": false,
            "byMethodology": true,
            "treatmentDirectionName": "ТЕСТ_ЮРА",
            "organizationId": 69,
            "emergencyName": null,
            "organizationType": "ZOZ"
        },
        {
            "createdAt": "2024-03-22T12:00:11.667610Z",
            "createdBy": "Багатозв’яз Гірський",
            "modifiedAt": "2024-03-22T12:35:28.941145Z",
            "modifiedBy": "Багатозв’яз Гірський",
            "id": 296,
            "status": "DRAFT",
            "type": "BY_DIRECTION_OF_TREATMENT",
            "creationType": "REGULAR",
            "facilityName": "ТЕСТ ФО з РНОКПП",
            "facilityTaxNumber": "9876543210",
            "requisitionNumber": "RQAO24296",
            "totalCommentsQty": 0,
            "directionOfTreatmentDictionaryId": 73,
            "year": 2024,
            "directionTypeName": "test_donorstvo",
            "medicalGuaranteeProgram": false,
            "byMethodology": false,
            "treatmentDirectionName": "ТЕСТ - Донорство",
            "organizationId": 69,
            "emergencyName": null,
            "organizationType": "ZOZ"
        },
        {
            "createdAt": "2024-03-21T09:13:46.060705Z",
            "createdBy": "Багатозв’яз Гірський",
            "modifiedAt": "2024-03-21T09:13:46.204259Z",
            "modifiedBy": "Багатозв’яз Гірський",
            "id": 286,
            "status": "DRAFT",
            "type": "BY_DIRECTION_OF_TREATMENT",
            "creationType": "REGULAR",
            "facilityName": "ТЕСТ ФО з РНОКПП",
            "facilityTaxNumber": "9876543210",
            "requisitionNumber": "RQAO24286",
            "totalCommentsQty": 0,
            "directionOfTreatmentDictionaryId": 57,
            "year": 2024,
            "directionTypeName": "test_lag",
            "medicalGuaranteeProgram": false,
            "byMethodology": true,
            "treatmentDirectionName": "ТЕСТ_ЛАГ",
            "organizationId": 69,
            "emergencyName": null,
            "organizationType": "ZOZ"
        },
        {
            "createdAt": "2024-02-26T10:09:07.303585Z",
            "createdBy": "Багатозв’яз Гірський",
            "modifiedAt": "2024-02-26T10:12:15.189188Z",
            "modifiedBy": "Багатозв’яз Гірський",
            "id": 58,
            "status": "APPROVED",
            "type": "BY_DIRECTION_OF_TREATMENT",
            "creationType": "REGULAR",
            "facilityName": "ТЕСТ ФО з РНОКПП",
            "facilityTaxNumber": "9876543210",
            "requisitionNumber": "RQAO2458",
            "totalCommentsQty": 0,
            "directionOfTreatmentDictionaryId": 77,
            "year": 2024,
            "directionTypeName": "test_injuries_mv",
            "medicalGuaranteeProgram": false,
            "byMethodology": false,
            "treatmentDirectionName": "ТЕСТ - Медичні вироби для лікування травм, в тому числі бойових",
            "organizationId": 69,
            "emergencyName": null,
            "organizationType": "ZOZ"
        }
    ],
    "pageable": {
        "sort": {
            "empty": false,
            "sorted": true,
            "unsorted": false
        },
        "offset": 0,
        "pageNumber": 0,
        "pageSize": 10,
        "paged": true,
        "unpaged": false
    },
    "last": true,
    "totalPages": 1,
    "totalElements": 4,
    "size": 10,
    "number": 0,
    "sort": {
        "empty": false,
        "sorted": true,
        "unsorted": false
    },
    "first": true, 
    "numberOfElements": 4,
    "empty": false
}

</aside>

<aside> <img src="/icons/no_gray.svg" alt="/icons/no_gray.svg" width="40px" /> Помилки

Параметр	Опис
status	Статус відповіді.
detail	Деталі відповіді.
code	Код помилки. Можливі коди помилок можна переглянути за посиланням.
localizedMessage	Локалізований текст помилки.

<aside> <img src="/icons/backward_gray.svg" alt="/icons/backward_gray.svg" width="40px" /> Приклад відповіді

</aside>

2. Створення нової заявки на потребу

<aside> <img src="/icons/move-document_gray.svg" alt="/icons/move-document_gray.svg" width="40px" /> Форма створення нової заявки на потребу описана в розділі **5.2.1.3.4. Базові вимоги** документу e-Stock | Технічні вимоги.

</aside>

<aside> <img src="/icons/info-alternate_gray.svg" alt="/icons/info-alternate_gray.svg" width="40px" /> Для створення нової заявки на потребу необхідно попередньо отримати перелік напрямків лікування, по яким поточному ЗОЗ доступне формування потреби.

</aside>

2.1. Отримання переліку доступних напрямків лікування

<aside> <img src="/icons/swap-horizontally_gray.svg" alt="/icons/swap-horizontally_gray.svg" width="40px" /> Щоб отримати перелік активних напрямків лікування необхідно виконати GET запит на /v1/dictionary/directionsOfTreatment.

</aside>

2.2. Створення заявки на потребу

<aside> <img src="/icons/swap-horizontally_gray.svg" alt="/icons/swap-horizontally_gray.svg" width="40px" /> Щоб створити заявку на потребу необхідно надіслати обраний бюджетний рік та напрям лікування POST запитом на /v1/requisitions.

</aside>

<aside> <img src="/icons/new-document_gray.svg" alt="/icons/new-document_gray.svg" width="40px" /> В результаті буде сформована заявка на потребу, яка заповниться відповідним обраному напрямку переліком номенклатур та додатковими даними (номер заявки, автор тощо).

</aside>

3. Отримання повної інформації по заявці

<aside> <img src="/icons/move-document_gray.svg" alt="/icons/move-document_gray.svg" width="40px" /> Функціональні вимоги до відображення інформації в заявці на потребу описані в розділі 5.2.1.3.5. Картка потреби документу e-Stock | Технічні вимоги.

</aside>

<aside> <img src="/icons/swap-horizontally_gray.svg" alt="/icons/swap-horizontally_gray.svg" width="40px" /> Щоб отримати повну інформацію по заявці на потребу (основна інформація та перелік номенклатур) необхідно надіслати GET запит на /v1/requisitions/{id}.

</aside>

4. Коментування заявки

<aside> <img src="/icons/move-document_gray.svg" alt="/icons/move-document_gray.svg" width="40px" /> Функціональні вимоги до реалізації чату (коментарів) в заявці на потребу описані в розділі 5.2.3. Чат документу e-Stock | Технічні вимоги.

</aside>

4.1. Додавання коментаря до заявки

<aside> <img src="/icons/swap-horizontally_gray.svg" alt="/icons/swap-horizontally_gray.svg" width="40px" /> Щоб додати новий коментар необхідно надіслати POST запит на /v1/requisitions/{id}/comment.

</aside>