Модуль ext_sync

Материал из Felix2
Перейти к: навигация, поиск


Модуль позволяет создавать соответствие между объектами АСР Felix2 и объектами внешних систем (например, 1С:Предприятие). Поддерживается синхронизация следующих объектов: учетные записи пользователей, пополнения счета, списания.



Пример конфигурации модуля

Модуль не требует дополнительных настроек.

    ...
    <module name="ext_sync" file="modules/ext_sync.so" />
    ...

Загрузка модуля ext_sync.


Интеграция с 1С:Предприятие 8.2

Sign-attention.png Не проводите тестирование интеграции с АСР Felix2 на рабочей базе данных 1С:Предприятие! Сделайте копию базы данных и тестируйте на ней.


Первоначальная настройка

  1. Добавляем загрузку модуля ext_sync:
    <module name="ext_sync" file="modules/ext_sync.so" />
  2. Разрешаем подключение к АСР Felix2 с машины на которой установлена 1С:
    Например, если 10.1.1.2 - адрес машины с 1С, то его нужно добавить в список разрешенных адресов:
    <xml_rpc_server allow_ip="127.0.0.1 10.1.1.2">
  3. Скачиваем (ftp://felix2.ru/other/felix2_1c8.epf) и запускаем внешнюю обработку felix2_1c8.epf (на машине с установленной системой 1С). Для этого в 1С выбираем "Файл -> Открыть" и выбираем файл felix2_1c8.epf.


Внешняя обработка для 1С:Предприятие : "Импорт данных из АСР Felix2"


Настройки импорта

При первом запуске внешней обработки felix2_1c8.epf "Импорт данных из АСР Felix2" нужно выполнить настройку параметров импорта данных из АСР Felix2. Для этого в верхнем меню главной формы внешней обработки выберите пункт «Настройки». Откроется форма «Настройки импорта».

На вкладке «Основные» необходимо указать адрес и порт сервера АСР Felix2 к которому будет подключаться внешняя обработка. Для вывода подробной информации о выполняемых операциях отметьте чекбокс «Выводить служебные сообщения».

Настройки импорта : вкладка "Основные"


На вкладке «Импорт Контрагентов» нужно отметить тип импортируемых контрагентов (Юр.Лица и/или Физ.Лица). Далее для каждого выбранного типа контрагентов необходимо выбрать «Группу контрагентов» (в этой группе будут создаваться контрагенты) и «Вид взаиморасчетов».

Настройки импорта : вкладка "Импорт Контрагентов"


На вкладке «Импорт платежей» нужно заполнить список контрагентов через которых переводятся деньги на счета пользователей. Чтобы добавить новую строку в список, нажмите кнопку «Добавить». В поле «Контрагент» укажите контрагента, через которого деньги поступают на счет пользователя. В поле «Договор» выберите договор с данным контрагентом. В поле «Название пополнения счета» укажите наименование типа пополнения счета из АСР Felix2. В поле «Комментарий (часть)» укажите строку при нахождении которой в комментарии к пополнению счета при импорте будет выбран данный контрагент. Если оставить поле пустым, то заданный контрагент будет выбран для всех пополнений указанного типа. В поле «Счет Дт» указываем счет дебета операции, в поле «Счет Кт» - счет кредита (например, 76.09 и 62.02 соответственно).

Настройки импорта : вкладка "Импорт платежей"


На вкладке «Импорт списаний» нужно выбрать номенклатурную группу для проводки, отражающей реализацию услуг связи. Также имеется возможность импортировать списания только после окончания действия тарифного плана (при этом за дату списания/проводки берется дата окончания действия тарифного плана). Для активации данного режима нужно отметить соответствующий чекбокс.

Настройки импорта : вкладка "Импорт списаний"


Для сохранения настроек нажмите кнопку «ОК» внизу формы.


Импорт данных из АСР Felix2

Для импорта данных из АСР Fexli2 запускаем внешнюю обработку из 1С (для этого в 1С выбираем Файл -> Открыть и выбираем файл felix2_1c8.epf) и нажимаем кнопку «Выполнить Импорт» на главной форме модуля импорта. Результат выполнения импорта отображается в области «Отчет» на главной форме.


Выполняемые операции при импорте контрагентов

При импорте контрагентов (пользователей) из АСР Felix2 в 1С:Предприятие выполняются следующие действия:

Создается объект «Контрагент» со следующими значениями полей (для физ. лиц):

  • Наименование – Фамилия и инициалы абонента;
  • Код – значение присваивается автоматически при добавлении контрагента в 1С;
  • Группа контрагентов – Эта группа указывается в настройках импорта, это поле одинаково для всех договоров;
  • ФИО – Фамилия, Имя и Отчество абонента;
  • Документ – паспорт с указанием серии, номера, датой выдачи и кем был выдан.
  • Юридический адрес – адрес регистрации абонента(прописка по паспорту);
  • Фактический адрес – адрес подключения абонента;
  • Телефон – мобильный телефон абонента.


Для каждого объекта «Контрагент» создается объект «Договор» (для физ. лиц) :

  • Код – значение присваивается автоматически при добавлении договора в 1С;
  • Наименование – Строится по шаблону «Договор № Номер_договора от Дата_подключения_абонента»;
  • Вид договора – с покупателем, это поле одинаково для всех договоров;
  • Организация – Наименование основной организации для текущей базы 1С. Это поле одинаково для всех договоров.
  • Контрагент – Фамилия и инициалы абонента;
  • Группа договоров – поле остается пустым;
  • Номер – лицевой счет абонента, он же является номером договора;
  • От – дата заключения договора;
  • Валюта – руб., это поле одинаково для всех договоров;
  • Вид взаиморасчетов – Задается в настройках импорта, это поле одинаково для всех договоров;

Выполняемые операции при импорте платежей

При импорте платежей (пополнений счета) из АСР Felix2 в 1С:Предприятие выполняются следующие действия:

Создается объект «Операция» (проводка) со следующими полями:

  • Счет Дт – Счет дебета операции (задается в настройках импорта)
  • Счет Кт – Счет кредита операции (задается в настройках импорта)
  • СубконтоДт1 – Контрагент, через которого деньги поступают на счет пользователя (задается в настройках импорта).
  • СубконтоДт2 – Договор с данным контрагентом (задается в настройках импорта).
  • СубконтоКт1 – Абонент (контрагент) на счет которого происходит зачисление денежных средств.
  • СубконтоКт2 – Договор с данным абонентом.
  • Сумма – Сумма платежа
  • Содержание – Заполняется по следующему шаблону: «Получен платеж от Дата_платежа от Наименование_абонента»

Выполняемые операции при импорте списаний

При импорте списаний (платежей по тарифам и услугам) из АСР Felix2 в 1С:Предприятие выполняются следующие действия:

Создается объект «Операция» (проводка) со следующими полями:

  • Счет Дт – Счет дебета операции (62.01)
  • Счет Кт – Счет кредита операции (90.01.1)
  • СубконтоДт1 – Абонент (контрагент) на счет которого происходит зачисление денежных средств.
  • СубконтоДт2 – Договор с данным абонентом.
  • СубконтоКт1 – Номенклатурная группа для проводки, отражающая реализацию услуг связи (задается в настройках импорта).
  • СубконтоКт2 – Без НДС
  • Сумма – Сумма списания
  • Содержание – Заполняется по следующему шаблону: «Реализация услуг связи Наименование_абонента»


Создается объект «Операция» (проводка) со следующими полями:

  • Счет Дт – Счет дебета операции (62.02)
  • Счет Кт – Счет кредита операции (62.01)
  • СубконтоДт1, СубконтоКт1 – Абонент (контрагент) на счет которого происходит зачисление денежных средств.
  • СубконтоДт2, СубконтоКт2 – Договор с данным абонентом.
  • Сумма – Сумма списания
  • Содержание – Заполняется по следующему шаблону: «Взаимозачет Наименование_абонента»

Хранение данных о синхронизации в базе данных АСР Felix2

Вся информация о синхронизации (какие объекты АСР Felix2 синхронизированы) хранится в таблице ext_sync в базе данных system. Данная таблица имеет следующие поля:

  • ext_system_id – идентификатор внешней системы с которой производится синхронизация (по умолчанию - 0).
  • object_type_id – тип синхронизируемого объекта: 101 – пользователь (контрагент), 102 – пополнение счета (платеж), 103 – списание денежных средств.
  • int_object_id – идентификатор объекта в АСР Felix2
  • ext_object_id – идентификатор объекта во внешней системе.
  • date_sync – дата синхронизации
  • status – статус синхронизации (в случае успешной синхронизации - 1)