Embedded Files
1. Первинне налаштування
1. Первинне налаштування
1.1 Отримання merchantId
При реєстрації на сервері Defin, вам повинні видати merchantId (код вашої компанії в базі Defin). Передайте отриманий код своєму менеджеру ant-logistics для активації модуля Defin pay.
1.2 Доступні методи оплати
Визначте дозволені типи оплат у вашій компанії:
готівка
NFC
QR-код
Це можуть бути всі методи або деякі з них.
Передайте компанії Defin перелік необхідних методів. В мобільному застосунку вони з’являться автоматично.
1.3 Реєстрація кас та касирів
Для кожного співробітника, що буде приймати оплати карткою, потрібні два параметри, які ви повинні сформувати самостійно:
cashierID - номера касира;
terminalId - номер каси або будь-який зручний ідентифікатор точки продажу, з якою працює касир (ID терміналу). Якщо є ПРРО – беремо фіскальний номер реєстратора в податковій.
Токен (видає банк) - може бути один для всіх кас, або для кожної різний (якщо декілька клієнтів)
Зверніть увагу! Допустимі символи для terminalId та cashierID: літери латинського алфавіту, цифри та знак підкреслення "_".
1.3.1 Перелік terminalId потрібно передати компанії Defin.
1.3.2 Кожного касира також потрібно зареєструвати на сервісі ant-logistics в довіднику Співробітники.
– в полі Співробітник вкажіть реальні ПІБ людини.
– в полі Фіск. номер каси (вкладка Інші) через вертикальний роздільник | пропишіть terminalId|cashierId касира.
Приклад:
terminalId = 1241, cashierId = 6235
В полі “Фіск.номер каси” пишемо: 1241|5235
Зверніть увагу! Номер каси terminalId може повторюватись, залежно від схеми роботи. Але номера касирів cashierId повинні бути унікальними для кожного співробітника. Це дасть можливість однозначно ідентифікувати особу, що приймає оплату.
2. Прив’язка касирів до маршрутів
2. Прив’язка касирів до маршрутів
При створенні маршрутів співробітники (касири) повинні бути вказані, як водії або експедитори в маршруті, на якому прийматимуться оплати. Це можна зробити через шаблон маршруту або безпосередньо у властивостях маршруту.
Зверніть увагу! Якщо і для Водія, і для Експедитора прописані значення поля Фіск. номер каси, дані Водія мають пріоритет.
3. Передача боргів по API
3. Передача боргів по API
Борги передаються на сервер через API: https://ant-logistics.com/api.html?DEX_MobiAgent_Import_Debts#
Не забудьте передати розрахункову валюту.
4. Заборона проведення оплат без документа Борг
4. Заборона проведення оплат без документа Борг
Ви можете керувати можливістю водіїв самостійно створювати платежі (без оплати документа боргу).
За замовчуванням водії можуть здійснювати оплати як за переданими боргами, так і створювати власні оплати..
Приклад самостійного створення оплати:
При тапі на кнопку відкривається незаповнене вікно Новий платіж, куди водій може сам внести всі необхідні дані:
При тапі на кнопку + відкривається незаповнене вікно Новий платіж, куди водій може сам внести всі необхідні дані:
Щоб встановити заборону на самостійне створення оплат (не по документу боргу):
- оберіть в налаштуваннях таблиць на сервері документ Оплати;
- у властивостях встановіть заборону дії “Додавання нового платежу без боргу” для водія.
Коли заборона встановлена – кнопка + не відображається, і водії можуть проводити платежі тільки за переданими документами боргу. Відповідно, якщо борг для точки не переданий – по ній не можна прийняти оплату.
5. Підготовка мобільного застосунку
5. Підготовка мобільного застосунку
5.1 Налаштування платіжного рішення
Кожний касир у своєму екземплярі мобільного застосунку налаштовує оплати.
Відкрити Налаштування > Загальні. В платіжному рішенні обрати Defin pay.
Якщо все налаштовано правильно, у вікні Нового платежу типи оплати будуть відображатись у вигляді плиточок (Готівка та NFC).
5.2 Відкриття маршруту
Для можливості проведення оплат через Defin pay обов’язково завантажте маршрут на потрібну дату. Перевірте, чи вказаний потрібний співробітник як водій або експедитор. Можна налаштувати видимість поля “Фіск. номер каси”, щоб бачити дані касира та каси, що передані в маршрут.
Зверніть увагу!
В даній реалізації дані касира передаються через маршрут. Це дає можливість однозначно ідентифікувати особу, що приймає оплату. При оплатах використовуються дані каси та касира активного маршруту.
Використовувати Борги та Оплати не через маршрут не рекомендується.
6. Оплати з отриманням фіскального чека в момент продажу
6. Оплати з отриманням фіскального чека в момент продажу
Якщо фіскалізація платежів клієнтів відбувається безпосередньо під час продажу товару, окрім номеру та суми до сплати потрібно передавати перелік товарів (послуг).
6.1 Прив’язка переліку товарів до документа боргу
Щоб при оплаті в чек було передано перелік товарів:
додайте товари до заявки на доставку
Для коректного формування чека обов’язково повинні бути заповнені поля:
назва – назва товару, зареєстрована в довіднику;
кількість – заповнюйте саме поле кількість, як універсальну одиницю розрахунку в чеку (поля Вага та V, м3 в чек не передаються);
ціна – якщо не вказана ціна в заявці, буде використана ціна з довідника товарів.
Метод API: DEX_Import_Request_JSON, параметр Comps_Product, поля Product_Id, Qty, Price_Sale (за необхідності. Інакше береться ціна, вказана в довіднику товарів).
заповніть поле Номер заявки
Обов’язково заповніть поле “Номер заявки”, саме по ньому перелік товарів із заявки прив’язується до документа боргу.
Метод API: DEX_Import_Request_JSON, параметр Comps, поле Request_Num.
зареєструйте документ боргу під тим же номером, що й заявку
Метод API: метод DEX_MobiAgent_Import_Debts, поле DocNumber.
Тепер при оплаті боргу в точці мобільний застосунок буде передавати в чек знайдений по номеру заявки перелік товарів.
Зверніть увагу! Сума до сплати береться не з документа боргу, а розрахується автоматично на підставі переліку товарів та їх цін.
6.2 Заборона редагування товарів в мобільному застосунку
За замовчуванням в мобільному застосунку дозволено редагувати товари в точці маршруту (змінювати кількість виданого товару, додавати нові товари).
Під час оплати боргу в чек передаються всі товари з заповненою кількістю виданого товару (не нульовою).
Якщо не можна змінювати чек при оплаті доставки, встановіть на сервісі заборону на редагування товарів:
Налаштування таблиць > Документ “Маршрути (Товари) > Заборона “Змінювати товари в точці маршруту”.
При встановленій забороні водій:
не зможе редагувати кількість виданого товару;
не зможе додавати нові товари до переліку.
6.3 Відправка чека на телефон клієнта
Заповніть в контактних даних точки поле Телефон у форматі 380991234567, і клієнт автоматично отримає фіскальний чек на вказаний номер.
Зверніть увагу! Якщо формат вказаного телефону відрізняється від вказаного, чек не прийде!
Метод API: DEX_Import_Request_JSON, параметр Comps, поле Phone
Читати далі: Швидкий доступ для водія
Page updated
Report abuse