Конфигурация Crossroad

Настройки Crossroad находятся в глобальной конфигурации ERP и в конфигурациях подключённых экземпляров ABilling. Изменять их следует после проверки потребителей API: многие значения влияют сразу на личный кабинет, мастера и карточки договоров.

Основные настройки

Ключ Значение по умолчанию Назначение

Ключ	Значение по умолчанию	Назначение
`personal.account.api.class`	встроенный `UfanetCustomerApi`	Динамический класс реализации API контрагента.
`regex.phone`	нет	Регулярное выражение допустимого номера телефона.
`crossroad.phone.param.id`	`0`	Id телефонного параметра контрагента. Значение должно быть положительным.
`crossroad.password.billings`	`rb`	Регулярное выражение биллингов, в которых разрешено менять пароль статистики.
`crossroad.password.pattern`	`^\d{10,10}$`	Регулярное выражение нового пароля статистики.
`crossroad.ignored_contracts_pattern`	пусто	Регулярное выражение номеров договоров, исключаемых из результата загрузчика.
`crossroad.contracts.cacheExpire`	`0`	Время жизни базовых данных субдоговора в Redis, секунды. Ноль отключает кеш.
`crossroad.dispatcher.coroutinesMaxLimit`	`20`	Максимальное число параллельных корутин нового загрузчика.
`crossroad.props.modules.supported`	пусто	Список клиентских пакетов ABilling, которые возвращает свойство `modules`.
`crossroad.smarthouse.crawlerbg7.billingIds`	пусто	Биллинги, для которых SmartHouse использует реализацию ABilling 7.
`crossroad.service_processors.tv.skipClosedAccounts`	`false`	Не включать закрытые TV-аккаунты в сведения об услуге.
`crossroad.service_handler.v2.titles`	пусто	Регулярное выражение номеров договоров в конфигурации конкретного ABilling. Для совпавших договоров ABilling 7 сведения об услугах запрашиваются через новый `ServiceInfo` API.
`crossroad.vlt_domains`	пусто	Id доменов ВЛТ, для которых постобработчик переименовывает и перегруппировывает услуги.
`crossroad.vlt.hide_tinkoff`	`false`	Удалять Tinkoff из списка платёжных провайдеров договоров доменов ВЛТ.
`contract.type.<serviceType>.class`	пусто	Динамический класс `ServicePayloadProcessor` для `getServiceDetails`.

personal.account.api.class

встроенный UfanetCustomerApi

Динамический класс реализации API контрагента.

regex.phone

нет

Регулярное выражение допустимого номера телефона.

crossroad.phone.param.id

0

Id телефонного параметра контрагента. Значение должно быть положительным.

crossroad.password.billings

rb

Регулярное выражение биллингов, в которых разрешено менять пароль статистики.

crossroad.password.pattern

^\d{10,10}$

Регулярное выражение нового пароля статистики.

crossroad.ignored_contracts_pattern

пусто

Регулярное выражение номеров договоров, исключаемых из результата загрузчика.

crossroad.contracts.cacheExpire

0

Время жизни базовых данных субдоговора в Redis, секунды. Ноль отключает кеш.

crossroad.dispatcher.coroutinesMaxLimit

20

Максимальное число параллельных корутин нового загрузчика.

crossroad.props.modules.supported

пусто

Список клиентских пакетов ABilling, которые возвращает свойство modules.

crossroad.smarthouse.crawlerbg7.billingIds

пусто

Биллинги, для которых SmartHouse использует реализацию ABilling 7.

crossroad.service_processors.tv.skipClosedAccounts

false

Не включать закрытые TV-аккаунты в сведения об услуге.

crossroad.service_handler.v2.titles

пусто

Регулярное выражение номеров договоров в конфигурации конкретного ABilling. Для совпавших договоров ABilling 7 сведения об услугах запрашиваются через новый ServiceInfo API.

crossroad.vlt_domains

пусто

Id доменов ВЛТ, для которых постобработчик переименовывает и перегруппировывает услуги.

crossroad.vlt.hide_tinkoff

false

Удалять Tinkoff из списка платёжных провайдеров договоров доменов ВЛТ.

contract.type.<serviceType>.class

пусто

Динамический класс ServicePayloadProcessor для getServiceDetails.

Настройки загрузчиков crossroad.props.<id>.* приведены в справочнике свойств.

Переключатели реализации

Все перечисленные переключатели по умолчанию выключены.

Ключ Назначение

Ключ	Назначение
`crossroad.new.parallelism.loading.contracts`	Параллельно загружать договоры, субдоговоры и их свойства через ограниченный dispatcher.
`crossroad.deduplication.request.getFullContractInfo`	Объединять одновременно выполняемые одинаковые запросы списка договоров через SingleFlight.
`crossroad.ul.allow_skipping_subcontracts`	Разрешить ЮЛ-процессору не читать субдоговоры при `showSubcontracts=false`.
`crossroad.ul.parallel_subcontracts_loading`	Параллельно обрабатывать субдоговоры юридических лиц.
`crossroad.ul.loading.with.properties`	Для головного договора ЮЛ `rb` использовать общий набор `properties` вместо жёстко заданного старого набора загрузчиков.

crossroad.new.parallelism.loading.contracts

Параллельно загружать договоры, субдоговоры и их свойства через ограниченный dispatcher.

crossroad.deduplication.request.getFullContractInfo

Объединять одновременно выполняемые одинаковые запросы списка договоров через SingleFlight.

crossroad.ul.allow_skipping_subcontracts

Разрешить ЮЛ-процессору не читать субдоговоры при showSubcontracts=false.

crossroad.ul.parallel_subcontracts_loading

Параллельно обрабатывать субдоговоры юридических лиц.

crossroad.ul.loading.with.properties

Для головного договора ЮЛ rb использовать общий набор properties вместо жёстко заданного старого набора загрузчиков.

Детализация баланса

crossroad.custom_balance_details.enabled_for_billings=rb,ds
crossroad.custom_balance_details.default_language=eng
crossroad.custom_balance_details.mapping.rus.rb.<operation>.<typeId>=Отображаемое название
crossroad.custom_balance_details.custom_crawler_class=ru.example.CustomBalanceCrawler

enabled_for_billings включает замену подписей операций для выбранных биллингов. Ключ mapping содержит язык, биллинг, имя операции и id типа. custom_crawler_class полностью заменяет стандартный источник детализации динамической реализацией BalanceCrawler.

Пакеты синхронного списания

crossroad.bundle.enabled=true
crossroad.balance.bundle.merge_charge_type_ids=1,2
crossroad.balance.bundle.merge_contract_account_type_ids=3,4

crossroad.bundle.enabled включает свойство bundle для головных и независимых договоров rb. Два списка merge_* определяют типы начислений и счетов, которые объединяются при построении детализации баланса пакета.

Платёжные провайдеры

Ключ crossroad.payment_providers.modules перечисляет имена модулей ABilling, из которых разрешено получать провайдеров. Crossroad поддерживает Yandex, Sberbank, Uniteller, Tinkoff, SberPay и VTB Pay.

crossroad.payment_providers.modules=yamoney,sberbank,uniteller

crossroad.provider.sberpay.enabled=true
crossroad.provider.sberpay.min_amount=10
crossroad.provider.sberpay.ignore.billings=
crossroad.provider.sberpay.ignore.firms=

crossroad.provider_priority.tinkoff.bg.rb=5
crossroad.provider_priority.vtbpay.bg.rb=-1
crossroad.vtb_pay.url=https://example.invalid/pay

Приоритет -1 скрывает провайдера. Ключи приоритета имеют вид crossroad.provider_priority.tinkoff.bg.<billingId> и crossroad.provider_priority.vtbpay.bg.<billingId>. Доступность остальных провайдеров дополнительно зависит от конфигурации соответствующего платёжного модуля ABilling.

Зависимые настройки ABilling

Часть поведения определяется не глобальной конфигурацией ERP, а настройкой конкретного подключения ABilling:

Ключ Назначение

Ключ	Назначение
`module.npay.id`, `module.vpn.id`, `module.ipn.id`, `module.<autopayment>.id`	Id биллинговых модулей абонплаты, VPN, IPN и автоплатежа.
`addressParamId`, `objectAddressParamId`	Параметры адреса договора и объекта договора.
`receiptEmailParamId`, `receiptPhoneParamId`	Параметры контакта для отправки чека.
`trust_credit_option.id`, `stat_ip_option.id`	Тарифные опции доверительного кредита и статического IP.
`migratedToAccountParamId`	Параметр со ссылкой на договор, созданный при миграции.
`bgbilling.firm.<id>`	Отображаемое название организации по id фирмы.

module.npay.id, module.vpn.id, module.ipn.id, module.<autopayment>.id

Id биллинговых модулей абонплаты, VPN, IPN и автоплатежа.

addressParamId, objectAddressParamId

Параметры адреса договора и объекта договора.

receiptEmailParamId, receiptPhoneParamId

Параметры контакта для отправки чека.

trust_credit_option.id, stat_ip_option.id

Тарифные опции доверительного кредита и статического IP.

migratedToAccountParamId

Параметр со ссылкой на договор, созданный при миграции.

bgbilling.firm.<id>

Отображаемое название организации по id фирмы.

На построение отдельных свойств также влияют глобальные ключи autopayment.ipinu.enabled, recSum.oldScheme.billingIds, recSum.oldScheme.fc и system.fiscalization. Они принадлежат соответствующим подсистемам автоплатежа, расчёта рекомендуемой суммы и фискализации, поэтому их значения должны согласовываться с конфигурацией этих подсистем.

Подпись SberOnline

Свойство sber_online_caption возвращает текст для клиента при оплате. Условия подбора и примеры описаны в настройке подписи SberOnline.

Требование сменить пароль

Для каждого биллинга можно указать списковый параметр договора, положительное значение которого означает необходимость смены пароля:

crossroad.props.extra.needPasswordChange.rb.paramId=123

Без положительного paramId свойство need_change_password возвращает false.

Услуги юридических лиц

Для отображения услуг договора ЮЛ Crossroad выбирает процессор из программной конфигурации или crossroad.serviceProcessor.*. Типы процессоров, их параметры и примеры приведены в настройке услуг юридических лиц.

Специальные описания услуг

Тарифы и тарифные опции, которые нужно дополнительно показать в описании услуги, настраиваются по биллингу:

serviceDetails.specialTariff.rb=101,102
serviceDetails.specialTariffOption.rb=201,202

Если текущий тариф или опция входит в список, его название добавляется к описанию результата getServicesByContract.