Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

--- reminder [2024/02/26 15:12]
bobr [alter.ini опції, що регулюють роботу PBI-інтеграції]
+++ reminder [2024/02/27 00:31] (поточний)
bobr [ОБОВ'ЯЗКОВІ додаткові налаштування]
@@ Рядок 94: / Рядок 94: @@
 ====== PrivatBank Invoices ======
-Починаючи з релізу 1.4.4 в Ubilling доступна інтеграція з сервісом "PrivatBank Invoices"(PBI) від ПриватБанку, яка дозволяє відправляти інвойси нашим користувачам і клієнтам ПриватБанку за сумісництвом. Цей сервіс вигідно відрізняється від СМС своєю **безкоштовністю**(принаймі, станом на 1й квартал 2024го). Варто зазначити, що відтепер Ubilling надає як мінімум 3 опції щодо відправлення нагадувань користувачам стосовно **низького балансу**:
+Починаючи з релізу 1.4.4 в Ubilling доступна інтеграція з сервісом "PrivatBank Invoices"(PBI) від ПриватБанку, яка дозволяє відправляти інвойси нашим користувачам і клієнтам ПриватБанку за сумісництвом. Цей сервіс вигідно відрізняється від СМС своєю **безкоштовністю**(принаймі, станом на 1й квартал 2024го). Варто зазначити, що відтепер Ubilling надає як мінімум 3 опції щодо відправлення нагадувань користувачам стосовно **низького балансу**(тобто - за основною послугою):
   * тільки СМС
   * тільки інвойс
@@ Рядок 101: / Рядок 101: @@
 Останні два варіанти реалізовуються за допомогою відповідних, дуже self-explanatory, опцій alter.ini **REMINDER_PBI_ONLY_TAG_ID** та **REMINDER_PBI_AND_SMS_TAG_ID**. \\
 І тут все доволі просто:
-  * якщо користувачу не присвоєний жодний з двох тегів, регламентованих опціями **REMINDER_PBI_ONLY_TAG_ID** та **REMINDER_PBI_AND_SMS_TAG_ID** - йому буде відправлено звичайне СМС
+  * якщо користувачу не присвоєний жодний з двох тегів, регламентованих опціями **REMINDER_PBI_ONLY_TAG_ID** та **REMINDER_PBI_AND_SMS_TAG_ID** - йому буде відправлятися звичайне СМС
-  * якщо користувачу присвоєний тег **REMINDER_PBI_ONLY_TAG_ID** - йому буде відправлено лише інвойс
+  * якщо користувачу присвоєний тег **REMINDER_PBI_ONLY_TAG_ID** - йому буде відправлятися лише інвойс
-  * якщо користувачу присвоєний тег **REMINDER_PBI_AND_SMS_TAG_ID** - йому буде відправлено як інвойс, так і СМС
+  * якщо користувачу присвоєний тег **REMINDER_PBI_AND_SMS_TAG_ID** - йому буде відправлятися як інвойс, так і СМС
 ===== alter.ini опції, що регулюють роботу PBI-інтеграції =====
 <code ini>
 ; всі опції - НЕОБОВ'ЯЗКОВІ - тому не забуваємо їх розкоментувати
-REMINDER_PRIVATBANK_INVOICE_PUSH=0
+REMINDER_PRIVATBANK_INVOICE_PUSH=1
-REMINDER_PBI_AUTH_LOGIN=""
+REMINDER_PBI_AUTH_LOGIN="your_auth_login_from_PB"
 REMINDER_PBI_URL="https://irc.privatbank.ua/paygatews/invoice/process.ws"
 REMINDER_PBI_DAY_TARIFF_MULTIPLIER=30
@@ Рядок 118: / Рядок 118: @@
 Оскільки майже всі опції вище доволі self-explanatory - детально варто зупинитись, мабуть шо, тільки на останній з них. \\
 Отож, опція REMINDER_PBI_USER_FILTER_PAYSYS_LIST задумувалась як така собі відповідь на питання: "А як зрозуміти, хто з наших користувачів є клієнтом ПриватБанку, а хто ні?", і якось нічого кращого не придумалось, як дивитись чи не приходили від конкретно взятого користувача оплати з певних платіжних систем. І, якщо приходили - вважати такого користувача "умовно підходящим" кандидатом на клієнти ПриватБанку. Чому умовно? - ну, тому що не обов'язково бути клієнтом ПриватБанку, або оплатити послугу через термінал ПриватБанку. Отака механіка. Користуватись нею чи ні - кожний вирішить для себе сам. \\
-Єдине, що ще варто зазначити: ця опція має містити список платіжних **фронтендів**, які на зараз є активними у вашому біллінгу. Назви платіжних систем мають бути точно такі ж, як і в модулі "OpenPayz"(ага, як правило ще й КАПСОМ), мають розділятися комами і НЕ містити пробілів.
+Єдине, що ще варто зазначити: ця опція має містити список платіжних **фронтендів**, які на зараз є активними у вашому біллінгу. Назви платіжних систем мають бути точно такі ж, як і в модулі "OpenPayz"(ага, як правило ще й КАПСОМ), мають розділятися комами і НЕ містити пробілів. \\
+Якщо ж лишаємо цю опцію пустою - ніяких фільтрацій користувачів по платіжним системам відбуватись не буде.
+===== ОБОВ'ЯЗКОВІ додаткові налаштування =====
+Ще раз робимо акцент на тому, що PBI-інтеграція таки працює на базі модулю "Reminder" - тобто у вас, як мінімум має бути включеним і налаштованим функціонал нагадувань(просто читаємо цю статтю від початку до кінця). Так, як мінімум має буть **REMINDER_ENABLED=1**, а також вказаний **REMINDER_TAGID** та **REMINDER_DAYS_THRESHOLD**. \\
+Далі слід зазначити, що сервіс PBI це така штука дуже схожа на платіжні системи і, відповідно, вона прив'язується до конкретного контрагента, а це значить - що? - правильно, те, що конкретно взятий користувач має належати до конкретно взятого контрагента, щоб мати змогу від лиця цього контрагента відправити йому інвойс. А ще це значить, що для додаткових налаштувань сервісу PBI ми використаємо модуль [[contragentextinfo|"Додаткова інформація про контрагента"]]. Отож, після ввімкнення опції **REMINDER_PRIVATBANK_INVOICE_PUSH=1** при спробі додати новий запис в модулі "Додаткова інфо про контрагента" у випадаючому списку "Ім`я платіжної системи" ми побачимо нову опцію **PRIVAT_INVOICE_PUSH**: \\
+{{:reminder_pbi_1.png?500|}}
+Далі вказуємо дані для статичних полів JSON: \\
+{{:reminder_pbi_2.png?500|}}
+JSON же в нас має отаку структуру і **саме на такій структурі JSON-документу ви маєте погодити власну інтеграцію**, коли будете узгоджувати все це з ПриватБанком:
+<hidden onHidden="Invoice JSON" onVisible="Hide">
+<code json>
+{
+    "invoicetype": "S",
+    "comctype": "8",
+    "company": "СуперМегаТелеком",
+    "companyid": "4410221",
+    "servicecod": "202",
+    "serviceid": "4410222",
+    "invname": "СуперМегаТелеком",
+    "destname": "Призначення платежу",
+    "mfod": "87412",
+    "okpod": "369874155",
+    "amount": 150,
+    "clphone": "+380551234567",
+    "invclosingdate": "2024-02-28",
+    "extparams": {
+        "param": [
+            {
+                "name": "bill_identifier",
+                "value": "11223344"
+            }
+        ]
+    }
+}
+</code>
+</hidden>
+\\
+===== Зняття оплати за сервіс нагадувань при ввімкненому сервісі PBI =====
+Якщо ми хочемо бути чесними зі своїми користувачами, то, оскільки PBI сервіс в нас на разі "free of charge" - ми не мали би знімати оплату з користувачів, яким шлемо тільки інвойси, тобто яким присвоєний тег **REMINDER_PBI_ONLY_TAG_ID**. Що, як би - логічно. Отож, якщо ми хочемо виключити таких користувачів з процесу обробки віртуальним сервісом, який у нас знімає оплату за нагадування - робимо наступне:
+. Йдемо у редагування віртуального сервісу, що відповідає за зняття оплати за нагадування
+. В поле "Користувачі зі вказаними тегами будуть виключені з обробки даним сервісом. ID тегів мають відокремлюватись комами." вписуємо ID нашого REMINDER_PBI_ONLY_TAG_ID
+. Зберігаємо зміни
+. PROFIT!1!!!11
+Виглядає це якось так: \\
+{{:reminder_pbi_3.png?500 }}
+{{ :reminder_pbi_4.png?500 }}

Ubilling Wiki

Користувальницькькі налаштування

Налаштування сайту

Розбіжності

Налаштування сторінки