Модуль Gorod
Назначение модуля
Модуль предназначен для интеграции системы с платёжной системой ГОРОД. Модуль поддерживает выгрузку реестров 3, 7 и 9.
Настройка модуля
Установите модуль на сервер, обновите клиент биллинга. Затем создайте экземпляр модуля.
Создайте в редакторе конфигурации модуля новую конфигурацию, скопируйте туда приведённый ниже текст, подправьте под ваши нужды параметры и сделайте данную конфигурацию активной.
#шаблон реестра по умолчанию
register.pattern=[${fio}][;${city}][,${street}][,${house}][${frac}][,${flat}][;${contractTitle}][;${summ}][;;;;${account}][:${contractId}]
#шаблоны, привязанные к тегам, в формате register.pattern.<tag_id>. Если для тега не будет указан шаблон, то будет использоваться шаблон по умолчанию!
register.pattern.1=[${fio}][;${city}][,${street}][,${house}][,${flat}][; ${dateTo}][;${contractTitle}][;${summ}][;;;;${account}][:${contractId}][;${dateFrom}]
register.pattern.2=[;${dateFrom}][;${city}][,${street}][; ${dateTo}][;${contractTitle}][;;;;${account}][:${contractId}][${fio}][;${summ}]
register.pattern.3=[;${city}][${fio}][dateTo: ${dateTo}][;${contractTitle}][;${summ}][;dateFrom:${dateFrom}][;${account}][:${contractId}]
#Кодировка реестра (по умолчанию, если параметр не задан, кодировка ставится как cp866)
register.encoding=Cp1251
#Кодировка реестра с привязкой к тегу. Если для тега не указана кодировка, то используется кодировка по умолчанию.
register.encoding.1=Cp1251
register.encoding.2=cp866
#формат даты для параметров шаблона dateFrom и dateTo
register.date.format=dd/MM/yyyy
#флаг, устанавливающий в заголовок реестра поле NOTE
param.note=1
#В поле NOTE ставится <дата_составления_реестра> (0 - поле пустое)
param.note.content.date=1
#в параметре summ прописывается название макроса, по которому вычисляется сумма для каждой строки реестра
#В данный момент доступны 2 варианта:
#SALDO( стандартный режим - остаток по балансу - используется по умолчанию )
#IS_GREATER_ZERO - в строках реестра будет стоять либо 0.0 в случае положительного остатка, либо отрицательное значение остатка
register.summ.macros=SALDO
#Чтобы узнать коды параметров "Адрес" и "Полное имя" откройте справочник "Параметры договоров"
#и выберите коды из левого столбца. Параметр "Полное имя" должен быть в договоре обязательно,
#а адреса может не быть - в этом случае подставится значение по умолчанию.
param.address=<код параметра адрес>
param.fullname=<код параметра "Полное имя">
#это будет подставлено в адрес по умолчанию. Можно использовать подстановку ${cid} - код договора
default.address=Уфа,ДС,0,${cid}
#битовая маска групп, для которых выгружаются реестры. Определяется следующим образом: откройте справочник групп,
#выделите позиции групп, начинающиеся с 0. Затем посчитайте выражение mask = 1<<gr1 | 1<<gr2...| 1<<grN
group.mask=262144
#счёт, подставляемый в файл реестра для тега с кодом 1 (Код тега можно узнать на вкладке Теги в модуле Город)
account.1=175
#счёт, подставляемый для договора с группой по маске 3 (т.е для договоров где (gr&3)>0)
#если счёт по группе договора не найден, используется счёт по фирме
account.gr.3=176
Для настройки шаблона реестра можно использовать следующие макроподстановки:
-
[${ fio }] - ФИО клиента;
-
[${ city }] - город;
-
[${ street }] - улица;
-
[${ house }] - дом;
-
[${ frac }] - дробь дома;
-
[${ flat }] - квартира;
-
[${ contractTitle }] - название договора;
-
[${ summ }] - сумма;
-
[${ account }] - счет;
-
[${ contractId }] - id контракта;
-
[${ dateFrom }] - дата начала периода оплаты (ставится начало месяца );
-
[${ dateTo }] - дата окончания периода оплаты (ставится дата формирования реестра ).
Каждая макроподстановка может встречаться в реестре только 1 раз. В шаблон не обязательно включать все поля - только те, что реально нужны. Между полями возможно вставить любой текст - он попадет в реестр в каждую строку. Важно! Квадратные скобки у полей обязательны!
Для того, чтобы настроить выгрузку реестров для договоров у них должен быть проставлен параметр Тег. Редактор тегов открывается с помощью меню Модули⇒Город⇒Вкладка Теги. Добавление, удаление и изменение тегов доступно через основную панель инструментов клиента биллинга c помощью кнопок Добавить, Удалить, Изменить.
Работа с реестрами
Для каждого дня должен быть зафиксирован реестр-сальдо 7, на основании 2х сальдовых реестров может быть созданы реестры 3 (изменений) и 9 (удаление).
Как видно из скриншота, интерфейс очевиден и сложности не представляет: в левом верхнем углу расположен фильтр, позволяющий выбрать реестры лишь за определённый период. Выбранный реестр можно сохранить в указанный в правом верхнем углу файл.
При создании реестра 7 достаточно указать дату и тег, для создания реестров 3 и 9 - период и тег, для дат из периода должны существовать 7-ые реестры.
Использование модуля
Подключите экземпляр модуля к договору. Слева в дереве договора в разделе Модули появится экземпляр модуля Город. Выберите его. Справа появится возможность привязки тегов к договору.
Привязка не должна вызывать трудностей. Необходимо из списка Доступные теги выбрать те теги, которые нужно привязать к договору, затем нажать кнопку с изображением знака меньше "<". Выбранные теги появятся в списке Выбранные теги.
Удаление происходит аналогично добавлению тегов: из левого списка Выбранные теги необходимо отметить те теги, которые нужно удалить, а затем нажать кнопку с изображением знака больше ">". Удаленные теги появятся в правом списке Доступные теги.
При создании договора возможна установка первоначального набора тегов и автоматическое подключение модуля Город. Это осуществляется путем добавления модуля Город в шаблон создания договора. Там же устанавливаются теги, автоматически прикрепляемые к создаваемому договору.