E-pass billing system

📟 Валідації

Розділ призначений для перегляду всіх фактів використання транспортних квитків у системі. Тут Ви бачите кожну поїздку, яка була зареєстрована валідатором:

• коли саме відбулася поїздка,
• який сервіс використано (автобус / тролейбус),
• номер документа,
• рейс,
• тариф, комісію, метод оплати,
• статус обробки.

Це основний розділ для контролю фактичного споживання транспортних послуг.

🧭 Що Ви бачите на сторінці

Таблиця валідацій

На сторінці відображена таблиця з переліком усіх валідацій, у якій Ви бачите такі колонки:

• Чекбокс вибору— дозволяє обрати одну або декілька валідацій для виконання масових операцій.
• Час реєстрації — дата та час, коли поїздка була зареєстрована в системі.
• Статус обробки — результат обробки транзакції (наприклад, Успішно).
• Сервіс — місто та тип транспорту (наприклад, Рівне | Поїздка на тролейбусі або Рівне | Поїздка на автобусі).
• Номер документа — унікальний номер квитка або транзакції.
• Рейс — номер маршруту, модель або інвентар транспорту, дата та період активності рейсу.
• Ticket product — тип квитка (наприклад, разовий, пільговий, транспортна картка).
• Оплачена вартість — фактично сплачена сума за поїздку.
• Тариф — встановлена тарифна вартість поїздки.
• Комісія — сума комісії, що була нарахована згідно з договором.
• Тип транспорту — bus / trolleybus тощо.
• Інвентарний номер пристрою — ідентифікатор валідатора або пристрою, яким зафіксовано поїздку.
• Метод оплати — спосіб оплати (наприклад, bankcard, transport_card, cash, qr).
• Компенсація — кнопка «Компенсувати», якщо поїздка підлягає компенсації.
• EasyPay - це спроба з якої вдалось відправити в платіжну систему інформацію щодо банківської транзакції по протоколу InfoPartners

🎮 Як працювати з розділом

👁 Перехід до деталей валідації

1. У таблиці знайдіть потрібну валідацію (за датою, номером документа або через фільтри).
2. У колонці «Час реєстрації» натисніть на дату та час потрібного запису.
3. Після натискання відкриється сторінка з детальною інформацією по обраній валідації.

На сторінці деталей Ви можете переглянути:

• адміністративну одиницю та постачальника послуг,
• сервіс (тип транспорту),
• пов’язану транзакцію,
• користувача,
• час на пристрої та час реєстрації,
• номер документа,
• тип квитка,
• тариф і комісію,
• статус обробки.

На цій сторінці Ви можете відредагувати всі поля валідації. Це дозволяє Вам повністю скоригувати дані у випадку помилки або неточностей у валідації.

🔄 Виконання компенсації валідації

Якщо виникла ситуація, коли потрібно повернути кошти за поїздку (наприклад, технічна помилка, подвійне списання або інша обґрунтована причина), Ви можете виконати компенсацію безпосередньо з цього розділу.

1. Знайдіть потрібну валідацію у таблиці (за датою, номером документа або через фільтри).
2. У колонці «Компенсація» натисніть кнопку «Компенсувати» навпроти відповідного запису.
3. На сторінці компенсації перевірте:
   • номер документа,
   • дату валідації,
   • тариф,
   • тип квитка,
   • ціну квитка. Переконайтесь, що це саме та поїздка, яку потрібно компенсувати.
4. У полі «Причина компенсації» вкажіть обґрунтовану причину (це обов’язкове поле).
5. У полі «Сума компенсації» ввведіть суму, яку необхідно компенсувати — повну або часткову.
6. Натисніть «Підтвердити компенсацію» для завершення операції.

Якщо Ви передумали — натисніть «Скасувати», і компенсація не буде виконана.

💸 Платежі

Розділ призначений для перегляду та аналізу фінансових операцій, пов’язаних із купівлею квитків.

Тут Ви можете перевірити суму платежу, продукт, кількість квитків, клієнта та зв’язок платежу з конкретною транзакцією.

Розділ використовується для фінансової перевірки, аналізу спірних ситуацій та звірки даних із банком.

🧭 Що Ви бачите на сторінці

На сторінці відображена таблиця з такими колонками:

• Дата створення — дата та час формування платежу.
• Номер платежу — унікальний номер у системі.
• Сума — загальна сума платежу.
• Продукт — тип квитка або тариф.

У верхній частині сторінки розташований пошук, який дозволяє знайти платіж за номером.

Праворуч знаходиться блок «Відфільтрувати», де Ви можете відсортувати платежі за:

• датою створення,
• продуктом,
• перевізником,
• типом транзакції (Payment and Validation, Payment, Validation, Cash Collection).

🎮 Як працювати з розділом

Перегляд платежу

На сторінці відображається детальна інформація:

• Адміністративна одиниця — місто, до якого належить платіж (можна перейти до розділу).
• Постачальник послуг — перевізник (активне посилання).
• is deleted — статус видалення платежу.
• Транзакція — пов’язана транзакція (можна перейти до її деталей).
• Номер платежу — номер у системі банку.
• Сума — сума платежу.
• Кількість квитків — скільки квитків придбано.
• Час проведення платежу банком — якщо зафіксовано.
• Продукт — тип квитка (можна перейти до продукту).
• Клієнт — користувач, який здійснив оплату (активне посилання).
• Час обробки — технічний час обробки.

🧾 Платіжні доручення

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

• створення платіжних доручень;
• визначення суми нарахування до виплати;
• фіксація дати платіжного документа;
• контроль статусу відправлення;
• перегляд історії нарахувань по адміністративних одиницях та постачальниках.

🧭 Що ви бачите на сторінці

На сторінці відображено список платіжних доручень у вигляді таблиці.

Таблиця містить такі колонки:

• Адміністративна одиниця — місто або регіон, до якого відноситься виплата.
• Постачальник послуг — перевізник або організація.
• Дата транзакції — дата, за яку сформовано нарахування.
• Дата платіжного доручення — дата створення платіжного документа.
• Сума нарахування — сума коштів до виплати.
• Відправлено — статус відправлення платіжного доручення.
• Деталі — якщо користувач у головній таблиці обирає конкретне платіжне доручення, кнопка перенаправляє на сторінку з детальною інформацією та нарахуваннями лише по вибраній адміністративній одиниці та відповідному постачальнику послуг.

🎮 Як користуватися розділом

У головній таблиці знайдіть потрібне платіжне доручення.

• Натисніть на кнопку «Деталі» у відповідному рядку.
• Після цього відкриється сторінка з переліком нарахувань, які входять саме до цього платіжного доручення.

Після цього ви переходите до розділу «Журнал нарахувань», де відображаються всі нарахування, що входять до обраного платіжного доручення.

[Інструкція користування розділом Журнал нарахувань]

✏ Редагування платіжного доручення

Щоб відредагувати платіжне доручення, у таблиці натисніть на назву адміністративної одиниці.

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

• змінити статус «Відправлено» (Невідомо / Так / Ні);
• відкоригувати дату платіжного доручення;
• за потреби переглянути інші пов’язані дані.

Після внесення змін натисніть кнопку «Зберегти» для застосування оновлень.

➕ Як додати платіжне доручення

Щоб створити нове платіжне доручення:

1. У розділі «Платіжні доручення» натисніть кнопку «Додати платіжне доручення».
2. Відкриється форма створення.

Відправлено

Статус, який показує, чи було платіжне доручення фактично відправлене.

• Невідомо — статус ще не визначений / немає підтвердження.
• Так — доручення відправлено.
• Ні — доручення не відправлено.

Дата платіжного доручення

Дата, на яку формується платіжне доручення (як правило — наступний робочий день).

• Можете ввести дату вручну або вибрати через календар.
• Поруч доступна кнопка «Сьогодні» для швидкого заповнення.
• Примітка під полем повідомляє, що час у формі може відображатися з різницею на 1 годину відносно серверного часу.

Uid

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

• Генерується автоматично.
• Використовується для технічної ідентифікації запису (пошук, інтеграції, аудит)

---

Адміністративна одиниця

Місто / район / область, для якої сформовано платіжне доручення.

• Визначає, до якої території належать нарахування, що увійдуть у доручення.
• Якщо поле порожнє, воно підтягнеться після прив’язки нарахувань або вибору відповідних даних (залежить від логіки системи).

---

Постачальник послуг

Перевізник або постачальник, на користь якого буде здійснено виплату.

• Відображає конкретну організацію (наприклад, КП/ТОВ).
• Зазвичай заповнюється автоматично відповідно до обраної адміністративної одиниці або прив’язаних нарахувань.

---

Договір

Договір, за яким здійснюються нарахування та оплата постачальнику послуг.

• Потрібний для коректного формування виплат і фінансових документів.
• Може заповнюватися автоматично, якщо в системі налаштовані зв’язки “постачальник → договір”.

---

Дата транзакції

Дата обробки транзакцій, за які сформовано нарахування.

• Це дата, за яку система “зібрала” дані по транзакціях для подальших нарахувань.
• Поле допомагає зрозуміти, за який період/день сформовані суми.

---

Сума нарахування

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

• Формується на основі пов’язаних нарахувань/операцій.
• Якщо немає прив’язаних нарахувань — поле може залишатися порожнім.

---

Коментар

Додаткове пояснення або службова примітка до платіжного доручення.

• Наприклад: причина змін, уточнення по періоду, внутрішні примітки для команди.

📙 Журнал нарахувань компенсацій

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

Тут Ви можете:

• переглянути всі створені нарахування;
• відфільтрувати їх за датами, адміністративною одиницею, перевізником або типом;
• відкрити конкретне нарахування та змінити його;
• створити нове нарахування компенсації вручну.

Це фактично фінансовий журнал взаєморозрахунків із перевізниками.

🧭 Що ви бачите на сторінці

У центральній частині сторінки розташована розширена таблиця з повною інформацією по кожному нарахуванню.

Таблиця містить такі колонки:

• **Дата оплати покриття** — дата фактичного покриття (оплати) нарахування.
• Дата нарахування — дата створення нарахування в системі.
• Адміністративна одиниця — місто / регіон.
• Постачальник послуг — перевізник.
• Тип нарахування — Компенсація / Штраф / Валідація.
• Сума — сума нарахування.
• Підстава — причина створення нарахування.
• Квиток / Проїзний — повна назва продукту з датою.
• Назва продукту — тип квитка (наприклад, Стандартний, Разовий).
• ID продукту — системний ідентифікатор продукту.
• Назва сервісу — сервіс, в рамках якого здійснена поїздка.
• ID сервісу — технічний ідентифікатор сервісу.
• Тип транспорту — bus / trolleybus / tram.
• Номер транспорту — бортовий номер транспортного засобу.

🎮 Як працювати з розділом

Натисніть на дату в колонці "Дата оплати покриття", щоб перейти в режим редагування.

➕ Як додати нарахування компенсації

У верхньому правому куті натисніть кнопку «Додати нарахування компенсації».

Адміністративна одиниця

Оберіть місто або регіон, до якого відноситься нарахування.

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

Постачальник послуг

Оберіть перевізника зі списку.

Переконайтеся, що:

• перевізник працює в обраній адміністративній одиниці;
• Ви не створюєте дубль існуючого нарахування.

Тип нарахування

Оберіть один із варіантів:

• Компенсація — стандартне відшкодування;
• Штраф — фінансове утримання;
• Валідація — компенсація за конкретну поїздку.

Підстава

У текстовому полі вкажіть причину нарахування.

Наприклад:

Компенсація за валідацію СААА-467768

Пишіть чітко і конкретно — це поле використовується при аудитах та звірках.

Сума

Вкажіть суму нарахування.

Перевірте:

• чи відповідає вона тарифу;
• чи не дублює попередні нарахування.

Дата нарахування

Оберіть дату вручну або натисніть «Сьогодні».

📌 Зверніть увагу: система може показувати примітку про різницю з серверним часом.

Платіжне доручення

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

Квиток / Проїзний

Це продукт, за який була здійснена поїздка:

• разовий квиток
• стандартний квиток
• проїзний абонемент

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

Якщо Ви створюєте нарахування вручну (не з валідації), поле може залишитися порожнім.

Валідація

У цьому полі відображається пов’язаний об’єкт валідації (Validation object).

Якщо нарахування створене на основі конкретної валідації, система відображає відповідний об’єкт.

Якщо зв’язок відсутній, поле містить «–». Поле є інформаційним і не заповнюється вручну.