Автоматизація робот з ЕК ДПС: КЕП, звірка податків та прийом вхідної кореспонденції

(проект знаходиться у стадії доробки і тестування)
Розробка серверного модуля для системи (Python/FastAPI, PostgreSQL, Jinja2 UI), який забезпечує автоматизовану взаємодію з Електронним кабінетом ДПС через сертифіковані криптографічні бібліотеки АТ «ІІТ» (EUSignCP). Модуль повинен працювати у контексті існуючої бази клієнтів-ФОП та їхніх податкових даних.

Функціональні блоки:

1. Модуль КЕП (EUSign)

   • Інтеграція бібліотеки EUSignCP (серверна частина) для накладання та перевірки КЕП.
   • Авторизація у приватній частині Електронного кабінету ДПС від імені клієнтів-ФОП, зареєстрованих у системі.
   • Зберігання параметрів КЕП-ключів у існуючій таблиці (або розширення моделі).
   • API-ендпоінти у форматі FastAPI Router, сумісні з поточною архітектурою роутерів.

2. Автоматична звірка з бюджетом

   • Програмне отримання даних про стан розрахунків (нараховано, сплачено, недоїмка, пеня) з кабінету ДПС по списку клієнтів-ФОП.
   • Збереження результатів у нову таблицю PostgreSQL, пов'язану.
   • Інтеграція з існуючим модулем TAX: автоматичне оновлення полів оплати та штрафів.
   • UI-відображення у вкладці TAX через Jinja2 шаблон, узгоджене з поточним дизайном (Bootstrap 5, картки, таблиці).

3. Прийом вхідної документації

   • Моніторинг та автоматичне вивантаження вхідних листів, повідомлень та актів від ДПС з Електронного кабінету.
   • Збереження документів у БД (нова таблиця dps_incoming_documents з полями.
   • Автоматичне сповіщення (прапорець нових документів у UI-інтерфейсі клієнта).
   • Фонова задача (celery/asyncio worker) для періодичної перевірки нових документів.

4. Звітність

   • Формування податкових декларацій у XML-форматі (ЄП, 4ДФ, ЄСВ) на основі даних із існуючих таблиць.
   • Підписання КЕП через EUSignCP та відправка на шлюз ДПС.
   • Контроль отримання квитанцій №1 та №2, автоматичне оновлення статусу.
   • Підтримка типів звітів: ЄП, 4ДФ, ЄСВ, ФО (відповідно до поля у моделі).

5. API-шар інтеграції

   • Усі ендпоінти — FastAPI Router з префіксом /api/dps/.
   • Авторизація через існуючу систему (або API-ключі).
   • Формат відповідей — JSON, сумісний з поточними API.
   • Документація через OpenAPI/Swagger (автоматична у FastAPI).

Технічні вимоги до реалізації:

• Мова/фреймворк: Python 3.11, FastAPI, SQLAlchemy ORM, Pydantic.
• База даних: PostgreSQL (Neon-backed), міграції через SQLAlchemy
• Структура коду: Новий роутер routers/dps.py (або кілька: routers/dps_eusign.py, routers/dps_docs.py, routers/dps_reports.py). Моделі додаються у існуючий models.py.
• UI: Jinja2 шаблони у templates/ui/, підключення через {% include %} у client_detail.html, стилізація Bootstrap 5.
• Черги: Використання asyncio tasks або Celery для масової обробки запитів без блокувань.
• Криптографія: Серверна бібліотека EUSignCP (IIT), підтримка файлових та апаратних ключів.

Вимоги до виконавця:

• Досвід роботи з бібліотеками криптографії EUSignCP (IIT) та протоколами обміну з ДПС.
• Розуміння структури податкових XML-файлів та транспортних протоколів шлюзів.
• Досвід розробки на Python (FastAPI), SQLAlchemy ORM.
• Вміння працювати з чергами запитів для масової обробки без блокувань.
• Готовність дотримуватись існуючих конвенцій коду проєкту (структура роутерів, моделей, шаблонів).