Назначение модуля
Модуль Mango Office предназначен для интеграции биллинга с ООО «Манго Телеком» для перепродажи их услуг.
Настройка модуля
# Код услуги модуля, под которым будет происходить начисление наработки
defaultService=302
# API МангоБиллинг: Домен, Логин, Пароль ( все выдается Mango )
apiDomenMango=http://billing-api-test.ru
apiLogin=
apiPassword=
# FTP: ip, Логин, Пароль, Путь до приватного ssh ключа( все выдается Mango )
ftpIP=
ftpLogin=
ftpPassword=
ftpSshPathKey=
# Если надо, то можно указать путь в ftp по которому будет происходить поиск csv с наработками
#ftpPath=
# Тарифы для продуктов, перечисляются таким образом - <код1>=<название1>;<код2>=<название2>
tariffs=400000088=ТП Базовая;400000089=ТП Расширенная;400000090 – ТП Максимальная
# Коды параметров договора для ф/л, которые будут переданы в Mango при регистрации клиента
# Лимит кредита на месяц
f.creditLimit=100
# Код параметра договора для - Наименование контрагента
f.personName=
# Код параметра договора для - Серия паспорта
f.psptseries=
# Код параметра договора для - Номер паспорта
f.psptnumber=
# Код параметра договора для - Кем выдан паспорт
f.psptissuedby=
# Код параметра договора для - Дата выдачи паспорта
f.psptissueddt=
# Код параметра договора для - Код подразделения
f.psptissuedcode=
# Код параметра договора для - Контактный телефон
f.contactPhone=
# Код параметра договора для - Контактный email. Необязательное
f.email=
# Коды параметров договора для ю/л, которые будут переданы в Mango при регистрации клиента
# Текстовые параметры можно указать брать из модуля бухгалтерии, для этого например вместо u.inn=23 ,
# можно указать bill.u.inn=65:inn, где в данном примере 65- это код модуля бухгалтерии, а inn - это наименование реквизита
# Лимит кредита на месяц
u.creditLimit=1000
# Код параметра договора для - Наименование контрагента
u.personName=
# Код параметра договора для - Офиц.наим-е контрагента
u.legalName=
# Код параметра договора для - ИНН
u.inn=
# Код параметра договора для - Лицо(сотрудник фирмы-контрагента)
u.contactName=
# Код параметра договора для - Телефон
u.contactPhone=
# Код параметра договора типа адрес для - Юр адрес( код, город, полный адрес )
u.legalAddress=
# Код параметра договора типа адрес для - Адрес выставления счета( код, город, полный адрес )
u.invoiceAddress=
# Код параметра договора для - E-mail
u.email=
# Не обязательные параметры для ю/л
# Код параметра договора для - КПП
u.kpp=
# Код параметра договора для - ОГРН
u.ogrn=
# Код параметра договора для - Имя руководителя
u.directorTitle=
# Код параметра договора для - Имя руководителя в род. падеже
u.directorTitleGenitive=
# Код параметра договора для - Должность руководителя
u.directorFullName=
# Код параметра договора для - Должность руководителя в род падеже
u.directorFullNameGenitive=
# Код параметра договора для - Наименование банка
u.bankName=
# Код параметра договора для - Город банка ( если это значение совподает с u.bankName то биллинг попытается распарсить из него город )
u.bankCity=
# Код параметра договора для - Бик
u.bankBic=
# Код параметра договора для - Текущий счет в банке
u.bankCurrentAccount=
# Код параметра договора для - Кор. счет
u.bankCorrAccount=
# Код параметра договора типа адрес для - Факт адрес( код, город, полный адрес )
u.actualAddress=
После установки модуля в клиенте биллинга перейдите в "Модули -> Редактор модулей и услуг" и добавьте модуль Mango Office. Далее в модуле добавьте как минимум одну услугу и ее код внесите в конфигурацию модулю в параметр defaultService.
После создания конфигурации в модуле не забудьте установить её активной.
Регистрация клиента
После того как вы произвели интеграцию с Манго( вас зарегистрировали как агента, вы загрузили тарифы и получили данные для доступа) и заполнили все требуемые параметры в конфигурации, можно приступать к регистрации клиента - вашего абонента. Для этого, в первую очередь, добавьте ранее созданный экземпляр модуля в договор абонента.
После вам будет доступны два варианта:
- Создание новых учетных данных
- Привязка существующих учетных данных к договору(вводится accountId)
После одной из этих операций, вам будет доступен логин, пароль, accountId(идентификатор клиента Манго), а так же отображен статус клиента и его баланс.
Начисления
Начисления производятся задачей планировщика "Загрузка начислений с FTP". Данную задачу нужно настроить на запуск каждый день, она будет производить обращения на указанный в конфигурации ftp и считывать файл формата "fees_<YYYY-MM-dd>.csv" за предыдущие сутки.
Так же данную операцию можно запустить в ручную в модуле, указав дату обработки. Перед каждой наработкой производится удаление наработки за обрабатываемые сутки, по этому задачу можно запускать несколько раз без риска задвоения начислений.