Модуль 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 помощью кнопок Добавить, Удалить, Изменить.

images/download/attachments/43385564/gorod_tag_list.png

Работа с реестрами

Для каждого дня должен быть зафиксирован реестр-сальдо 7, на основании 2х сальдовых реестров может быть созданы реестры 3 (изменений) и 9 (удаление).

images/download/attachments/43385564/gorod_register.png

Как видно из скриншота, интерфейс очевиден и сложности не представляет: в левом верхнем углу расположен фильтр, позволяющий выбрать реестры лишь за определённый период. Выбранный реестр можно сохранить в указанный в правом верхнем углу файл.

При создании реестра 7 достаточно указать дату и тег, для создания реестров 3 и 9 - период и тег, для дат из периода должны существовать 7-ые реестры.

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

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

images/download/attachments/43385564/gorod_contract.png

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

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

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