Изменения

<!-- -->При помощи модуля "Регистрация «Регистрация и импорт компаний" агентсво компаний» агентство может импортировать в систему компании, на основании данных которых впоследствии возможно использование системы субагентами, самостоятельная регистрация субагентов и синхронизация данных субагентов с данными в 1С агентства при помощи веб-сервиса, "в «в асинхронном режиме получать из системы 1С данные о счете, выставленном в системе 1С" (см. тикет 5609)1С».

== Администрирование ==[[Файл:Рекизиты_подключения_1С.png|400px|thumb|right|Рекизиты подключения 1С]][[Файл:Регистрация_и_импорт_компаний_-_Настройки.png|400px|thumb|right|Настройки регистрации и импорта компаний]][[Файл:Регистрация_и_импорт_компаний_-_Импорт_-_Файл_не_выбран.png|400px|thumb|right|Импорт компаний — выбор файла данных]] Модуль включается на странице "Администрирование" - "Модули"«Для техподдержки» → «Модули» — {{Setting|Взаимодействие с 1С}}. После включения , функционал саморегистрации становится доступен агентствам и администраторам (но не субагентствам). На главной странице агентства в шапке появляется ссылка "Регистрация компаний"«Регистрация компаний». Для менеджеров агентства отображаются пункты меню "Администрирование" - "Регистрация «Настройки системы» → «Интеграция» → «Регистрация и импорт компаний" субагентов из 1С» (внутри находятся группы - "Настройки"— «Регистрация компаний», "Импорт"«Импорт компаний», "Список компаний"«Список компаний»). Администраторам доступен выбор агентства. На странице "Администрирование" - "Формы «Для техподдержки» → «Устаревшие настройки» → «Формы ввода данных" данных» можно управлять списком полей формы самостоятельной регистрации компании . В разделе «Настройки системы» → «Нотификации» → «Шаблоны электронных писем» можно создать шаблоны писем, отправляемых при регистрации и активации компании. На странице «Для техподдержки» → «Устаревшие настройки» → «Реквизиты подключения» можно ввести данные, необходимые для использования веб-сервиса агентством:* {{Setting|Адрес веб-сервиса 1С}}* {{Setting|Логин к веб-сервису 1С}}* {{Setting|Ключ к веб-сервису 1С}} === Настройки ===На странице настроек («Настройки системы» → «Интеграция» → «Регистрация и импорт субагентов из 1С» → «Регистрация компаний») можно включить или отключить рассылку писем, настроить сообщения, отображаемые при самостоятельной регистрации компаний. === Импорт === На странице «Импорт» можно загрузить файл в формате XLS со списком компаний, экспортированным из базы 1C агентства.  {{Attention|Импортируются либо все компании, либо ни одной, если в файле обнаружены ошибки, например отсутствуют необходимые поля, есть компании с уже имеющимися в базе ИНН или электронным адресом компании (т.е. не может случиться так, что импортировалась только половина компаний из файла).}} ==== Формат файла импорта ====На данный момент используется следующий формат файла: все компании записаны в первый рабочий лист файла по одной компании на строку. Последовательность полей: код 1С, краткое наименование, тип контрагента («0» — субагент, «2» — корпоративный клиент), электронный адрес компании. <table border="Заказы1" - celpadding="3" cellspacing="0" class="Шаблоны электронных писемwikitable" ><tr><th>Код 1С</th><th>Наименование</th><th>Тип контрагента</th><th>Электронный адрес</th></tr><tr><td>00009726</td><td>Дикий запад</td><td>0</td><td>travel@wildwest.com</td></tr><tr><td>00011345</td><td>Снежный север</td><td>2</td><td>travel@snow-north.com</td></tr><tr><td>...</td><td>...</td><td>...</td><td>...</td></tr></table> При успешном импорте в системе создаются компании и тут же активируются без каких-либо запросов к веб-сервисам 1С. Если какие-то компании не удалось импортировать, об этом выводится сообщение, можно создать шаблоны отредактировать файл импорта и импортировать оставшиеся компании. При этом повторный импорт компаний с уже известными 1C кодами произведён не будет. Если в настройках включена рассылка писем, отправляемых при регистрации то на электронный адрес менеджера и на электронный адрес компании будет высланы письма об активации компании. ==== Импорт пользователей в определенную группу ====

В файле не указывается ID группы, в которую должны определиться пользователи. 1. Загрузка пользователей из файла возможна только в одну группу, поэтому, если необходимо внести пользователей, например, в две группы, загружать их нужно по отдельности, то есть сначала загрузить файл с пользователями из одной группы, затем из другой. 2. ID группы, в какую нужно зарегистрировать пользователей нужно указать в разделе: Настройки системы - Интеграция - Регистрация и импорт субагентов из 1С - Регистрация компаний. Здесь до загрузки файла нужно внести настройки, как минимум указать ID Группы в поле: "ID группы, в которую включаются активируемые компании". Сохранить и загрузить файл. Далее поменять ID группы и загрузить второй файл. == Администрирование =Список компаний === Список компаний содержит название компании и ИНН. Список разбит на две таблицы с независимой пагинацией. В первой таблице отображаются компании зарегистрированные, но не активные, во второй — активные. Для неактивных компаний по ссылке доступна ручная активация, для активированных — ссылка на профиль соответствующего субагентства. Администраторам по умолчанию отображаются все компании всех агентств и доступен выбор агентства (если надо отобразить компании только одного агентства).

На странице "Импорт" можно загрузить файл с формате xls (строго говоря, в любом формате, который может быть разобран с помощью библиотеки PHPExcel) со списком компаний, экспортированным из базы 1C агентства. Импотрируются либо все компании, либо ни одной, если в файле обнаружены ошибки, отсутствуют необходымые поля, есть компании с уже имеющимися в базе ИНН или электронным адресом компании (т.е. не может случиться так, что импортировалось ==== Повторное оповещение ====Повторное оповещение работает только половина для активированных компаний из файла). На данный момент используется следующий формат файла. Все компании записаны в первый рабочий лист файла Вне зависимости от значения настройки {{Setting|Включить нотификацию по одной компании на строку. Последовательность полей: код 1С, краткое наименование, тип контрагента E-mail}} (0 - агент, 1 - субагент, 2 - корпоративный клиентв разделе «Регистрация компаний») электронный адрес компании. При успешном импорте в системе создаются компании и тут же активируются без каких-либо запросов к веб-сервисам 1С. Если какие-то компании не удалось импортировать, об этом выводится сообщение, можно отредактировать файл импорта - при повторном оповещении будут отправлены нотификации о регистрации и импортировать оставшиеся компании. При при этом повторный импорт компаний с уже известными 1C кодами произведён не будет. Если в настройках включена рассылка писем, то на электронный адрес менеджера и автоматически сменятся пароли на электронный адрес компании будет высланы письма об активации компанииновые.

Список {{Attention|Выполнение скрипта импорта может сопровождаться нотификацией пользователей об активации, если включена настройка {{Setting|Включить нотификацию по E-mail}}. Процесс импорта компаний содержит название компании из файла может выполняться от нескольких минут до нескольких часов (это зависит от количества компаний, работы почтового сервера и ИННдругих факторов). Список разбит на две таблицы с независимой пагинацией. В первой таблице отображаются компании зарегистрированныеНи в коем случае нельзя нажимать обновление или перезагрузку страницы (в том числе и при выданной ошибке браузера) до тех пор, но пока вы не активныеубедитесь в том, что скрипт отработал, во второй - активные. Для неактивных компаний по ссылке доступна ручная активацияиначе это приведет к одновременному выполнению нескольких процессов оповещения, для активированых - ссылка на профиль соответствующего субагентства. Администраторам по умолчанию отображаются все компании всех нагрузке почтового сервера и путанице в письмах у нотифицируемых агентств и доступен выбор агентства (если надо отобразить компании только одного агентства). }}

== Шаблоны электронных писем ==На странице "Заказы" - "Шаблоны «Настройки системы» → «Нотификации» → «Шаблоны электронных писем" писем» менеджер агентства может (выбрав соответствующее название шаблона) задать шаблоны писем, высылаемых при регистрации и при активации компаний. В обоих шаблонах доступны переменные:

* {| style="width: 800px" class="wikitable"|-! scope="col" width="250" | Переменная! scope="col" width="550" | Описание|-| %SHORT_NAME% - краткое | Краткое наименование компании;* |-| %LEGAL_NAME% - полной | Полной юридическое название компании;* |-| %COMPANY_TYPE% - тип | Тип компании (агент/субагент/корпоративный клиент);* |-| %COMPANY_INN% | ИНН|- ИНН;* | %COMPANY_KPP% | КПП|- КПП; * | %COMPANY_EMAIL% - электронный | Электронный адрес компании;* |-| %COMPANY_PHONE% | Телефон компании|- телефон компании;* | %MANAGER_NAME% - имя | Имя ответственного менеджера;* |-| %MANAGER_SURNAME% - фамилия | Фамилия ответственного менеджера;* |-| %DATE_REGISTERED% - дата | Дата регистрации компании.|}

* {| style="width: 800px" class="wikitable"|-! scope="col" width="250" | Переменная! scope="col" width="550" | Описание|-| %MANAGER_LOGIN% - логин | Логин менеджера созданного агентства;* |-| %MANAGER_PASSWORD% | Пароль|- пароль;* | %DATE_ACTIVATED% | Дата активации|- дата активации;* | %COMPANY_PROFILE_LINK% - ссылка | Ссылка на профиль агентства, созданного при активации;* |-| %USER_PROFILE_LINK%' - ссылка | Ссылка на профиль менеджера созданного агентства (на этой странице можно сменить пароль).|}

Для агентств, для которых модуль включён, в шапке главной страницы отображается ссылка "Регистрация компаний"«Регистрация компаний». По ссылке отображается форма самостоятельной регистрации компании. После успешного отправления формы производится запрос к 1С на регистрацию компании. Если запрос выполнился успешно, то в Немо {{NameSystem}} также регистрируется компания и создаётся соответствующее субагентство, высылаются письмо об активации компании и компания может использовать систему. Если запрос выполнился неудачно, то компания регистритуется регистрируется только в Немо{{NameSystem}}, субагентство для этой компании не создаётся, компания не может использовать систему, высылаются письма о регистрации компании в Немо{{NameSystem}}. Впоследствии менеджер агентства или администратор может вручгую вручную активировать компанию, предоставив идентификатор компании в 1С. === Настройка формы регистрации компаний === На странице «Для техподдержки» → «Устаревшие настройки» → «Формы ввода данных» можно задать перечень полей на регистрационной форме компании. {| style="width: 500px" border="1" cellpadding="3" cellspacing="0" class="wikitable"|-! scope="col" | Наименование поля! scope="col" | Наличие поля|-| Краткое наименование юридического лица| обязательное|-| Полное официальное наименование юридического лица| обязательное|-| Тип сотрудничества| обязательное|-| ИНН| обязательное|-| КПП| обязательное <br/>необязательное <br/>не показывать|-| Адрес электронной почты компании| обязательное|-| Телефон компании | обязательное <br/>необязательное <br/>не показывать|-| Юридический адрес (страна) | обязательное|-| Юридический адрес (город) | обязательное|-| Юридический адрес | обязательное|-| Фактический адрес (страна)| обязательное|-| Фактический адрес (город) | обязательное|-| Фактический адрес | обязательное|-| Имя ответственного менеджера| обязательное|-| Фамилия ответственного менеджера | обязательное|-| Адрес электронной почты ответственного менеджера| обязательное <br/>необязательное <br/>не показывать|} === Обмен данными ===Обмен данными происходит по XML протоколу следующей спецификации:Пример XML запроса, передаваемого в 1С при регистрации компании:  <action>add</action> <company id=”company_id”> <attribute1> данные компании </attribute1> <attribute2> данные компании </attribute2> <attribute3> данные компании </attribute3> </company> </request> Ответ на запрос регистрации  <action>add</action> <company id=”company_id”> <status>OK</status> <error_desc>ID</error_desc> </company> </response> === Проверка электронного адреса компании === Поскольку при активации компании в системе {{NameSystem}} создаётся пользователь, логин которого есть электронный адрес компании, то к этому адресу применяются те же проверки, что и к логину пользователя при создании нового пользователя. Во избежании ошибок при активации, проверка производится на этапе регистрации. То есть система не позволит зарегистрировать компанию, чей электронный адрес совпадает с логином какого-либо пользователя системы {{NameSystem}}, либо с логином неподтверждённой регистрации пользователя.

При изменении настроек субагентства (Название агентства,Официальное название, Адрес электронной почты, Телефон агентства) или электронного адреса менеджера субагентства отправляется запрос к 1С на изменение данных компанииМеханизм взаимодействия подробно описан в соответствующей статье: [http://support. Сохранение настроек пройдёт успешно только если в ответ на запрос придёт подтверждение успешного измененияnemo. Кроме того, периодически запрашиваются данные компаний из 1С и настройки соответствующих субагентств меняются согласно данным, полученным из travel/ru/%D0%92%D0%B7%D0%B0%D0%B8%D0%BC%D0%BE%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5_%D1%81_1%D0%A1 Взаимодействие с 1С]