Модуль 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-ые реестры.

Использование модуля

Подключите экземпляр модуля к договору. Слева в дереве договора в разделе Модули появится экземпляр модуля Город. Выберите его. Справа появится возможность привязки тегов к договору.

Привязка тегов

Привязка не должна вызывать трудностей. Необходимо из списка Доступные теги выбрать те теги, которые нужно привязать к договору, затем нажать кнопку с изображением знака меньше "<". Выбранные теги появятся в списке Выбранные теги.

Удаление происходит аналогично добавлению тегов: из левого списка Выбранные теги необходимо отметить те теги, которые нужно удалить, а затем нажать кнопку с изображением знака больше ">". Удаленные теги появятся в правом списке Доступные теги.

При создании договора возможна установка первоначального набора тегов и автоматическое подключение модуля Город. Это осуществляется путем добавления модуля Город в шаблон создания договора. Там же устанавливаются теги, автоматически прикрепляемые к создаваемому договору.