E-pass billing system: відмінності між версіями

Матеріал з partnerdocs
Немає опису редагування
 
(Не показані 2 проміжні версії цього користувача)
Рядок 1: Рядок 1:
<div style="text-align:center;">
  <h1 style="color:#004085; font-size: 2.5em;">💳 Білінгова система</h1>
</div>


= 💳 Білінгова система =
<div style="text-align:center;">
  <h1 style="color:#004085; font-size: 2.5em;">📟 Валідації</h1>
</div>


= 📟 Валідації =
<br>
<blockquote>[[Файл:2026-02-2315.35.39-ezgif.com-video-to-gif-converter.gif|міні|400x400пкс]]Розділ призначений для перегляду всіх фактів використання транспортних квитків у системі. Тут Ви бачите кожну поїздку, яка була зареєстрована валідатором:
<blockquote>[[Файл:2026-02-2315.35.39-ezgif.com-video-to-gif-converter.gif|міні|400x400пкс]]Розділ призначений для перегляду всіх фактів використання транспортних квитків у системі. Тут Ви бачите кожну поїздку, яка була зареєстрована валідатором:


Рядок 82: Рядок 87:


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


= 💸 Платежі =
= 💸 Платежі =
Рядок 127: Рядок 133:


<br>
<br>
= 🧾 Платіжні доручення =
= 🧾 Платіжні доручення =
[[Файл:Ezgif.com-video-to-gif-converter (76).gif|міні|400x400пкс]]
[[Файл:Ezgif.com-video-to-gif-converter (76).gif|міні|400x400пкс]]
<blockquote>Розділ призначений для формування, обліку та контролю виплат постачальникам послуг (перевізникам) на підставі оброблених транзакцій за визначений період. У цьому розділі здійснюється:
<blockquote>Розділ призначений для перегляду сформованих платіжних доручень по нарахуванням за перевезення.
 
* створення платіжних доручень;
* визначення суми нарахування до виплати;
* фіксація дати платіжного документа;
* контроль статусу відправлення;
* перегляд історії нарахувань по адміністративних одиницях та постачальниках.
</blockquote>
 
 
== 🧭 Що ви бачите на сторінці ==
На сторінці відображено список платіжних доручень у вигляді таблиці.
[[Файл:Ezgif.com-video-to-gif-converter (77).gif|міні|600x600px|ліворуч]]
Таблиця містить такі колонки:
 
* '''<code>Адміністративна одиниця</code>''' — місто або регіон, до якого відноситься виплата.
* '''<code>Постачальник послуг</code>''' — перевізник або організація.
* '''<code>Дата транзакції</code>''' — дата, за яку сформовано нарахування.
* '''<code>Дата платіжного доручення</code>''' — дата створення платіжного документа.
* '''<code>Сума нарахування</code>''' — сума коштів до виплати.
* '''<code>Відправлено</code>''' — статус відправлення платіжного доручення.
* '''<code>Деталі</code>''' — якщо користувач у головній таблиці обирає конкретне платіжне доручення, кнопка перенаправляє на сторінку з детальною інформацією та нарахуваннями лише по вибраній адміністративній одиниці та відповідному постачальнику послуг.
 
== 🎮 Як користуватися розділом ==
[[Файл:Ezgif.com-video-to-gif-converter (78).gif|міні|600x600пкс]]
У головній таблиці знайдіть потрібне платіжне доручення.
* Натисніть на кнопку '''«Деталі»''' у відповідному рядку.
* Після цього відкриється сторінка з переліком нарахувань, які входять саме до цього платіжного доручення.
 
Після цього '''ви переходите до розділу «Журнал нарахувань»''', де відображаються всі нарахування, що входять до обраного платіжного доручення.<blockquote>[Інструкція користування розділом Журнал нарахувань]</blockquote>
[[Файл:Ezgif.com-video-to-gif-converter (81).gif|ліворуч|міні|600x600пкс]]
'''✏ Редагування платіжного доручення'''
 
Щоб відредагувати платіжне доручення, у таблиці натисніть на назву '''адміністративної одиниці'''.
 
Після цього відкриється сторінка редагування, де ви можете:
 
* змінити статус '''«Відправлено»''' (Невідомо / Так / Ні);
* відкоригувати '''дату платіжного доручення''';
* за потреби переглянути інші пов’язані дані.
 
Після внесення змін натисніть кнопку '''«Зберегти»''' для застосування оновлень.
 
== ➕ Як додати платіжне доручення ==
[[Файл:Ezgif.com-video-to-gif-converter (82).gif|міні|600x600пкс]]
 
 
 
Щоб створити нове платіжне доручення:
 
# У розділі '''«Платіжні доручення»''' натисніть кнопку '''«Додати платіжне доручення»'''.
# Відкриється форма створення.
 
 
 
----
[[Файл:Ezgif.com-video-to-gif-converter (83).gif|міні|600x600пкс]]
'''<code>Відправлено</code>'''
 
Статус, який показує, чи було платіжне доручення фактично відправлене.
 
* '''<code>Невідомо</code>''' — статус ще не визначений / немає підтвердження.
* '''<code>Так</code>''' — доручення відправлено.
* '''<code>Ні</code>''' — доручення не відправлено.
 
 
 
 
----'''<code>Дата платіжного доручення</code>'''
 
Дата, на яку формується платіжне доручення (як правило — '''наступний робочий день''').
 
* Можете ввести дату вручну або вибрати через '''календар'''.
* Поруч доступна кнопка '''«Сьогодні»''' для швидкого заповнення.
* Примітка під полем повідомляє, що час у формі може відображатися з різницею '''на 1 годину''' відносно серверного часу.
 
'''<code>Uid</code>'''
 
Унікальний ідентифікатор платіжного доручення в системі.
 
* Генерується автоматично.
* Використовується для технічної ідентифікації запису (пошук, інтеграції, аудит)
 
----'''<code>Адміністративна одиниця</code>'''
 
Місто / район / область, для якої сформовано платіжне доручення.
 
* Визначає, до якої території належать нарахування, що увійдуть у доручення.
* Якщо поле порожнє, воно підтягнеться після прив’язки нарахувань або вибору відповідних даних (залежить від логіки системи).
 
----'''<code>Постачальник послуг</code>'''
 
Перевізник або постачальник, на користь якого буде здійснено виплату.
 
* Відображає конкретну організацію (наприклад, КП/ТОВ).
* Зазвичай заповнюється автоматично відповідно до обраної адміністративної одиниці або прив’язаних нарахувань.
 
----'''<code>Договір</code>'''
 
Договір, за яким здійснюються нарахування та оплата постачальнику послуг.
 
* Потрібний для коректного формування виплат і фінансових документів.
* Може заповнюватися автоматично, якщо в системі налаштовані зв’язки “постачальник → договір”.
 
----'''<code>Дата транзакції</code>'''


Дата обробки транзакцій, за які сформовано нарахування.
Тут Ви можете відслідковувати суми, дати транзакцій та статус відправки доручень.</blockquote>


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


----'''<code>Сума нарахування</code>'''
Загальна сума, яку потрібно перерахувати за цим платіжним дорученням.
* Формується на основі пов’язаних нарахувань/операцій.
* Якщо немає прив’язаних нарахувань — поле може залишатися порожнім.
----'''<code>Коментар</code>'''
Додаткове пояснення або службова примітка до платіжного доручення.
* Наприклад: причина змін, уточнення по періоду, внутрішні примітки для команди.
= 📙 Журнал нарахувань компенсацій =
<blockquote>Розділ призначений для перегляду, створення та редагування '''нарахувань компенсацій перевізникам''' за здійснені поїздки (валідації), штрафи або інші типи компенсацій.
Тут Ви можете:
* переглянути всі створені нарахування;
* відфільтрувати їх за датами, адміністративною одиницею, перевізником або типом;
* відкрити конкретне нарахування та змінити його;
* створити нове нарахування компенсації вручну.
Це фактично фінансовий журнал взаєморозрахунків із перевізниками.</blockquote>


== 🧭 Що ви бачите на сторінці ==
== 🧭 Що ви бачите на сторінці ==
У центральній частині сторінки розташована розширена таблиця з повною інформацією по кожному нарахуванню.
На сторінці відображено список платіжних доручень у вигляді таблиці. На сторінці відображається таблиця з переліком платіжних доручень, яка містить:
[[Файл:Ezgif.com-video-to-gif-converter (77).gif|міні|500x500px|ліворуч]]'''<code>Адміністративна одиниця</code>''' — регіон, до якого відноситься нарахування


Таблиця містить такі колонки:
* '''<code>Постачальник послуг</code>''' — інтеграція або система (наприклад, E-PASS)
* '''<code>Дата транзакції</code>''' — дата, за яку сформовані дані
* '''<code>Дата платіжного доручення</code>''' — дата формування доручення
* '''<code>Сума нарахування</code>''' — загальна сума
* '''<code>Відправлено</code>''' — статус відправки доручення
* '''<code>Деталі</code>''' — кнопка для переходу до повної інформації


* **<code>Дата оплати покриття**</code> — дата фактичного покриття (оплати) нарахування.
=== 👁️ Перегляд платіжного доручення ===
* '''<code>Дата нарахування</code>''' — дата створення нарахування в системі.
Щоб переглянути деталі платіжного доручення, у таблиці натисніть на '''назву адміністративної одиниці'''.
* '''<code>Адміністративна одиниця</code>''' — місто / регіон.
[[Файл:Ezgif.com-video-to-gif-converter (32).gif|міні|500x500пкс]]
* '''<code>Постачальник послуг</code>''' — перевізник.
Після цього відкриється сторінка з інформацією про платіжне доручення, де Ви можете переглянути:
* '''<code>Тип нарахування</code>''' — Компенсація / Штраф / Валідація.
* '''<code>Сума</code>''' — сума нарахування.
* '''<code>Підстава</code>''' — причина створення нарахування.
* '''<code>Квиток / Проїзний</code>''' — повна назва продукту з датою.
* '''<code>Назва продукту</code>''' — тип квитка (наприклад, Стандартний, Разовий).
* '''<code>ID продукту</code>''' — системний ідентифікатор продукту.
* '''<code>Назва сервісу</code>''' — сервіс, в рамках якого здійснена поїздка.
* '''<code>ID сервісу</code>''' — технічний ідентифікатор сервісу.
* '''<code>Тип транспорту</code>''' — bus / trolleybus / tram.
* '''<code>Номер транспорту</code>''' — бортовий номер транспортного засобу.


== 🎮 Як працювати з розділом ==
* статус «Відправлено»;
Натисніть на '''дату в колонці "Дата оплати покриття"''', щоб перейти в режим редагування.
* дату платіжного доручення;
* UID;
* адміністративну одиницю та постачальника послуг;
* договір;
* дату транзакції;
* суму нарахування;
* коментар (за наявності).


== ➕ Як додати нарахування компенсації ==
💡 На цій сторінці доступний '''лише перегляд даних''' — редагування платіжного доручення не передбачено.
У верхньому правому куті натисніть кнопку '''«Додати нарахування компенсації»'''.


'''<code>Адміністративна одиниця</code>'''


Оберіть місто або регіон, до якого відноситься нарахування.
<div style="text-align:center;">
  <h1 style="color:#004085; font-size: 2.5em;">📙 Журнал нарахувань компенсацій</h1>
</div>


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


'''<code>Постачальник послуг</code>'''
<br>
[[Файл:Ezgif.com-video-to-gif-converter (33).gif|міні|400x400пкс]]


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


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


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


'''<code>Тип нарахування</code>'''
=== 🧭 Що Ви бачите на сторінці ===
На сторінці відображається таблиця з переліком нарахувань, яка містить:
[[Файл:Ezgif.com-video-to-gif-converter (34).gif|ліворуч|міні|600x600пкс]]


Оберіть один із варіантів:
* '''Дата оплати покриття''' — дата, коли нарахування включено до виплати
* '''Дата нарахування''' — дата створення нарахування
* '''Адміністративна одиниця''' — регіон
* '''Постачальник послуг''' — система або інтеграція
* '''Тип нарахування''' — наприклад, компенсація, штраф або валідація
* '''Сума''' — розмір нарахування
* '''Підстава''' — причина нарахування (наприклад, компенсація за валідацію)
* '''Квиток / проїзний''' — квиток, до якого відноситься нарахування


* '''Компенсація''' — стандартне відшкодування;
Праворуч доступні фільтри, де Ви можете:
* '''Штраф''' — фінансове утримання;
* '''Валідація''' — компенсація за конкретну поїздку.


'''<code>Підстава</code>'''
* обрати період створення або дату платіжного доручення,
* відфільтрувати за адміністративною одиницею або перевізником,
* обрати тип нарахування (компенсація, штраф, валідація).


У текстовому полі вкажіть причину нарахування.
=== 🎮 Як працювати з розділом ===
Розділ використовується '''для перегляду та аналізу нарахувань'''.


Наприклад:
* Кожен рядок у таблиці — це окреме нарахування
* Дані допомагають зрозуміти, за що саме була нарахована сума та до якого квитка вона відноситься


'''<code>Компенсація за валідацію СААА-467768</code>'''
💡 У цьому розділі '''редагування або створення нарахувань не передбачено''' — всі записи формуються автоматично на основі даних системи.
Щоб переглянути деталі нарахування: натисніть на '''дату оплати покриття''' у таблиці


Пишіть чітко і конкретно — це поле використовується при аудитах та звірках.
[[Файл:Ezgif.com-video-to-gif-converter (35).gif|міні|600x600пкс]]
Після цього відкриється сторінка з детальною інформацією про нарахування, де Ви можете переглянути:


'''<code>Сума</code>'''
* адміністративну одиницю та постачальника послуг,
 
* тип нарахування,
Вкажіть суму нарахування.
* підставу нарахування,
 
* суму,
Перевірте:
* дату нарахування,
 
* пов’язане платіжне доручення,
* чи відповідає вона тарифу;
* квиток або проїзний,
* чи не дублює попередні нарахування.
* пов’язану валідацію.
 
'''<code>Дата нарахування</code>'''
 
Оберіть дату вручну або натисніть '''«Сьогодні»'''.
 
📌 Зверніть увагу: система може показувати примітку про різницю з серверним часом.
 
'''<code>Платіжне доручення</code>'''
 
Це поле використовується для '''прив’язки нарахування до конкретного платіжного документа''', яким буде оплачена ця компенсація перевізнику.
 
'''<code>Квиток / Проїзний</code>'''
 
Це '''продукт''', за який була здійснена поїздка:
 
* разовий квиток
* стандартний квиток
* проїзний абонемент
 
Якщо нарахування створюється '''на основі конкретної поїздки''', система може автоматично підтягнути сюди відповідний квиток.
 
Якщо Ви створюєте нарахування вручну (не з валідації), поле може залишитися порожнім.
 
'''<code>Валідація</code>'''
 
У цьому полі відображається пов’язаний об’єкт валідації (Validation object).
 
Якщо нарахування створене на основі конкретної валідації, система відображає відповідний об’єкт.
 
Якщо зв’язок відсутній, поле містить «–». Поле є інформаційним і не заповнюється вручну.

Поточна версія на 21:51, 14 квітня 2026

💳 Білінгова система

📟 Валідації


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

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

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

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

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

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

  • Чекбокс вибору— дозволяє обрати одну або декілька валідацій для виконання масових операцій.
  • Час реєстрації — дата та час, коли поїздка була зареєстрована в системі.
  • Статус обробки — результат обробки транзакції (наприклад, Успішно).
  • Сервіс — місто та тип транспорту (наприклад, Рівне | Поїздка на тролейбусі або Рівне | Поїздка на автобусі).
  • Номер документа — унікальний номер квитка або транзакції.
  • Рейс — номер маршруту, модель або інвентар транспорту, дата та період активності рейсу.
  • 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 — статус видалення платежу.
  • Транзакція — пов’язана транзакція (можна перейти до її деталей).
  • Номер платежу — номер у системі банку.
  • Сума — сума платежу.
  • Кількість квитків — скільки квитків придбано.
  • Час проведення платежу банком — якщо зафіксовано.
  • Продукт — тип квитка (можна перейти до продукту).
  • Клієнт — користувач, який здійснив оплату (активне посилання).
  • Час обробки — технічний час обробки.


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

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


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

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

Адміністративна одиниця — регіон, до якого відноситься нарахування

  • Постачальник послуг — інтеграція або система (наприклад, E-PASS)
  • Дата транзакції — дата, за яку сформовані дані
  • Дата платіжного доручення — дата формування доручення
  • Сума нарахування — загальна сума
  • Відправлено — статус відправки доручення
  • Деталі — кнопка для переходу до повної інформації

👁️ Перегляд платіжного доручення

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

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

  • статус «Відправлено»;
  • дату платіжного доручення;
  • UID;
  • адміністративну одиницю та постачальника послуг;
  • договір;
  • дату транзакції;
  • суму нарахування;
  • коментар (за наявності).

💡 На цій сторінці доступний лише перегляд даних — редагування платіжного доручення не передбачено.


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




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

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

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

  • Дата оплати покриття — дата, коли нарахування включено до виплати
  • Дата нарахування — дата створення нарахування
  • Адміністративна одиниця — регіон
  • Постачальник послуг — система або інтеграція
  • Тип нарахування — наприклад, компенсація, штраф або валідація
  • Сума — розмір нарахування
  • Підстава — причина нарахування (наприклад, компенсація за валідацію)
  • Квиток / проїзний — квиток, до якого відноситься нарахування

Праворуч доступні фільтри, де Ви можете:

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

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

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

  • Кожен рядок у таблиці — це окреме нарахування
  • Дані допомагають зрозуміти, за що саме була нарахована сума та до якого квитка вона відноситься

💡 У цьому розділі редагування або створення нарахувань не передбачено — всі записи формуються автоматично на основі даних системи. Щоб переглянути деталі нарахування: натисніть на дату оплати покриття у таблиці

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

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