Исходный код вики Настройка для клиентов
Версия 1.1 от Ярослава Ерина на 2025/06/27 13:45
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | **ВНИМАНИЕ! Перед настройкой Топаз-АЗС необходимо обновить ее до актуальной версии. Последнюю актуальную версию можно запросить в техподдержке или **[[**скачать на сайте**>>url:https://wiki.topazelectro.ru/pages/viewpage.action?pageId=1180234]]**.** | ||
| 2 | |||
| 3 | |||
| 4 | ~1. **Зарегистрируйтесь на сайте "Топаз-Web Office" и проведите первоначальную настройку**: (см. статью [[https:~~/~~/wiki.topazoffice.ru/xwiki/bin/view/nachalo_raboty/start/>>url:https://wiki.topazoffice.ru/xwiki/bin/view/nachalo_raboty/start/]] ) | ||
| 5 | 2.** Активируйте АЗС** (см. статью [[https:~~/~~/wiki.topazoffice.ru/xwiki/bin/view/nachalo_raboty/azs/actyvaciya/>>url:https://wiki.topazoffice.ru/xwiki/bin/view/nachalo_raboty/azs/actyvaciya/]] ) | ||
| 6 | |||
| 7 | 3. **Создайте в "Топаз АЗС" экземпляр устройства и вид оплаты "Регистрация внешних заказов" и настройте их.** | ||
| 8 | |||
| 9 | Для этого: | ||
| 10 | |||
| 11 | a. Создайте экземпляр устройства "Прочие устройства" -> "WebOfficeActiveDevice. Если ранее экземпляр был создан, повторно добавлять не нужно. | ||
| 12 | |||
| 13 | [[image:1751031592033-405.png]] | ||
| 14 | |||
| 15 | b. Создайте вид оплаты "Дисконтный центр Web-офис". | ||
| 16 | |||
| 17 | [[image:1751031592036-909.png]] | ||
| 18 | |||
| 19 | c. Для данного вида оплаты установите необходимые Вам параметры. | ||
| 20 | |||
| 21 | **Описание параметров вида оплаты «Дисконтный центр Web-офис».** | ||
| 22 | |||
| 23 | [[image:1751031592037-742.png]] | ||
| 24 | |||
| 25 | **__Раздел «Общие настройки»__** | ||
| 26 | |||
| 27 | **Номер секции (отдела)** – позволяет устанавливать номер секции ФР (от 1 до 16) для печати чеков по данному виду оплаты. Секция может браться из настроек топлива, либо задана вручную для всех продаж по данному виду оплаты. | ||
| 28 | |||
| 29 | **Номер категории оплаты на ФР** – позволяет задавать категорию оплаты на ФР. Для большинства ФР платежи по категории оплаты 0 регистрируются как наличный расчет. Платежи по остальным категориям оплаты регистрируются как безнал. | ||
| 30 | |||
| 31 | **Признак способа расчета** – указывает, какая схема оплаты была использована при заключении сделки. | ||
| 32 | |||
| 33 | **Чек возврата на полную сумму **– позволяет настроить вид оформления возврата. Если настройка включена (пометка установлена), то используется классическая схема оформления возврата (чек возврата на полную сумму заказа и затем чек прихода на сумму отпущенного топлива). Если настройка выключена (пометка снята) - при неполном отпуске печатается чек возврата на недопоставленное количество. | ||
| 34 | |||
| 35 | **Печатать чек залога** – позволяет настроить печать чека. Если настройка включена (пометка установлена), то перед отпуском топлива будет отпечатан чек (нефискальный) на сумму заказа. Если настройка выключена (пометка снята) - чек залога не печатается. | ||
| 36 | |||
| 37 | **Запретить ПБ без залога** – позволят разрешить или запретить вид заказа "Полный бак". Если настройка включена (пометка установлена), то оператору запрещено отпускать топливо в режиме "Полный бак" без указания суммы залога. Если настройка выключена (пометка снята) - оператору разрешено пользоваться видом заказа "Полный бак" без указания залога. | ||
| 38 | |||
| 39 | **Полный чек при заказе на сумму** – позволяет настроить вид чека ФР при использовании заказа на сумму. Настройка работает, только если в контроллере ТРК установлен тип округления "с переливом" или "с переливом 106К". Если настройка включена (пометка установлена), то на ФР печатается чек ровно на ту сумму, которая была внесена в поле "задание дозы". При соответствующей настройке оборудования возможно отображение "круглой" суммы заказа на индикации колонки. Если настройка выключена (пометка снята) - чек печатается на сумму заказа с учетом дискретности и выбранного вида округления. Возможность печати полного чека должна поддерживаться фискальным регистратором. Данная настройка имеет смысл только при оплате наличными. | ||
| 40 | |||
| 41 | **Использовать вид оплаты** – позволяет ограничить применение вида оплаты. Если значение равно "Не использовать" – вид оплаты сохраняется в настройках, но не отображается в окне "Выбор вида оплаты" в режиме "Управление". Если значение равно "Только для нефтепродуктов" – данный вид оплаты может использоваться только для отпуска ГСМ. Если значение равно "Для нефтепродуктов и магазина" – данный вид оплаты может использоваться для отпуска ГСМ, сопутствующих товаров и услуг в модуле "Магазин". Если значение равно "Только для магазина" - данный вид оплаты может использоваться только для отпуска сопутствующих товаров и услуг в модуле "Магазин". | ||
| 42 | |||
| 43 | **Использовать для видов топлива** – позволяет настроить вид оплаты для использования только с определенными видами нефтепродуктов. Значение настройки представляет собой строку, содержащую обозначения видов нефтепродуктов через запятую. Контролируется наличие в наименовании вида нефтепродукта одной из последовательности символов, перечисленных в этой настройке. Пустая строка означает, что данный вид оплаты будет использоваться со всеми видами нефтепродуктов. | ||
| 44 | |||
| 45 | **Произвольная строка в чеке** – любая информация до 40 символов, которая будет отпечатана в чеке, например: "Счастливого пути!!!". | ||
| 46 | |||
| 47 | **Печатать в чеке информацию о примененных скидках** – позволяет отображать в чеке ФР информацию о размере и сумме скидки. | ||
| 48 | |||
| 49 | **Запрет одновременного обслуживания заказов по одной карте** – позволяет запретить одновременное выполнение двух и более заказов по одной и той же карте. | ||
| 50 | |||
| 51 | **Запрет обслуживания заказов подряд по одной карте** – позволяет запретить выполнение нескольких заказов подряд по одной и той же карте. | ||
| 52 | |||
| 53 | [[image:1751031592038-558.png]] | ||
| 54 | |||
| 55 | **__Раздел «Оборудование и интерфейс»__** | ||
| 56 | |||
| 57 | В разделе **"Оборудование и интерфейс" **можно подключить платежный терминал для безналичной оплаты и указать фискальный регистратор для печати чеков и/или квитанций. | ||
| 58 | |||
| 59 | Если используется автономный банковский терминал (не подключенный к компьютеру), нужно установить галочку в настройке **"Для оплаты используется внешний терминал"**, иначе все чеки будут формироваться некорректно (за наличный расчет при безналичной оплате). | ||
| 60 | |||
| 61 | Пометка в блоке **"Разрешить панель выбора смешанной оплаты"** позволяет выводить дополнительное окно для оплаты части заказа наличными денежными средствами, части - безналичными (банковскими картами). | ||
| 62 | |||
| 63 | [[image:1751031592039-790.png]] | ||
| 64 | |||
| 65 | **__Раздел "Web-офис"__** | ||
| 66 | |||
| 67 | Раздел **"Web-офис"** содержит в себе: | ||
| 68 | |||
| 69 | – Поле **Действия при потере связи с Web-офис в случае изменения состава заказа при фактическом наливе** (имеет значения "Перерасчет по последнему ответу сервера" и "Отгружать по тарифам АЗС"). Если при неполном наливе в конце заказа требуется пересчитать фактический размер скидки, то возможны по умолчанию два варианта: основываясь на последнем ответе сервера (данные, полученные при начале заказа) или оформление заказа по цене АЗС, без применения скидки; | ||
| 70 | |||
| 71 | – Поле **Методы округления Дисконтного Центра** (в большую сторону, в меньшую сторону) | ||
| 72 | |||
| 73 | – Поле **Способ применения бонусов к топливу**, которое позволяет задавать способ применения скидки. Если значение настройки равно "к объему", то увеличивается объем отпускаемого топлива на величину скидки, сумма заказа остается неизменной. Если равно "к цене" - уменьшается цена топлива на величину скидки, объем заказа остается неизменным. Если равно "по виду заказа топлива" - способ компенсации скидки выбирается автоматически в зависимости от вида заказа; | ||
| 74 | |||
| 75 | – Чекбокс **Проверять соединение с Web-офис перед каждым обслуживанием клиента (при плохом качестве интернет-соединения возможны начальные задержки)** - перед каждым заказом будет дополнительно проверяться соединение с Webофис для предоставления актуальных данных; | ||
| 76 | |||
| 77 | – Чекбокс **Разрешить списывать имеющиеся бонусы клиента** - настройка разрешает списывать бонусы с карты клиента; | ||
| 78 | |||
| 79 | – Чекбокс **Разрешить Web-офис начислять бонусы клиенту** - настройка разрешает начислять бонусы на карту клиента; | ||
| 80 | |||
| 81 | – Чекбокс **Вести лог обмена с Web-офис** включает ведение логов обмена с Web-офис для отладочных нужд. При штатной работе не требуется. | ||
| 82 | |||
| 83 | 4. **Убедитесь, что в видах нефтепродуктов каждый вид топлива имеет уникальный внешний код **(столбец “Код” в настройках видов топлива). | ||
| 84 | |||
| 85 | **ВНИМАНИЕ ! Внешние коды топлива должны быть числовыми** | ||
| 86 | |||
| 87 | [[image:1751031592040-983.png]] | ||
| 88 | |||
| 89 | Если вы хотите, **чтобы частично налитые заказы автоматически завершались после того, как был повешен кран**, установите флажок в поле «Таймер ожидания продолжения заказа, с:» и укажите необходимое время (в секундах) от момента возврата пистолета в колонку до автоматического закрытия заказа. | ||
| 90 | |||
| 91 | [[image:1751031592041-759.png]] | ||
| 92 | |||
| 93 | 5. **Откройте смену.** | ||
| 94 | |||
| 95 | 6.** Оформите подписку.** | ||
| 96 | |||
| 97 | a. Зайдите во вкладку "Подписки". | ||
| 98 | |||
| 99 | b. В таблице "Ваши подписки на плагины" **в колонке с названием Вашей внешней интеграции выберите подписку на интересующий срок.** | ||
| 100 | |||
| 101 | [[image:1751031592042-563.png]] | ||
| 102 | |||
| 103 | c. Нажмите кнопку «Продлить на выбранный период». | ||
| 104 | |||
| 105 | d. Перейдите в меню "Главная" → "Дисконтный центр" → "Внешние ДЦ" → выбрать нужную внешнюю интеграцию из выпадающего списка. | ||
| 106 | |||
| 107 | [[image:1751031592042-372.png]] | ||
| 108 | |||
| 109 | e. В блоке “Настройки компании” введите апикей Вашей сети АЗС, который Вам выдал интегратор. | ||
| 110 | |||
| 111 | [[image:1751031592043-292.png]] | ||
| 112 | |||
| 113 | |||
| 114 | Нажмите на кнопку **"+"** под блоком** "Настройки компании"** и добавьте вид оплаты для внешнего налива. | ||
| 115 | |||
| 116 | В поле **"Тип заказа"** введите значение "contractId", полученный от интегратора, а в поле "код вида оплаты" - внешний код из п. 3.c. | ||
| 117 | |||
| 118 | [[image:1751031592044-329.png]] | ||
| 119 | |||
| 120 | Нажмите кнопку «Сохранить» [[image:1751031592044-735.png]] | ||
| 121 | |||
| 122 | |||
| 123 | g. В блоке** “Настройки АЗС” **выберите необходимую АЗС. | ||
| 124 | |||
| 125 | **Чтобы увидеть коды вида оплаты, смена должна быть открыта.** | ||
| 126 | |||
| 127 | Убедитесь, что в появившейся таблице виды топлива, цены и внешние коды совпадают с указанными на АЗС (п.4). | ||
| 128 | |||
| 129 | [[image:1751031592044-337.png]] | ||
| 130 | |||
| 131 | Настройте последний столбец таблицы в соответствии с видами топлива интегратора. | ||
| 132 | |||
| 133 | [[image:1751031592045-708.png]] | ||
| 134 | |||
| 135 | Нажмите кнопку “Сохранить” под блоком “Настройки АЗС”. | ||
| 136 | |||
| 137 | [[image:1751031592045-111.png]] | ||
| 138 | |||
| 139 | 7. **Сообщите интегратору, что настройка со стороны WEB Офиса завершена. ** | ||
| 140 | |||
| 141 | Если настройка была произведена корректно, то интегратор должен увидеть конфигурацию Ваших АЗС (ид АЗС, виды топлива и цены). | ||
| 142 | |||
| 143 |