Изменения

<!-- -->При помощи модуля "Регистрация «Регистрация и импорт компаний" агентсво компаний» агентство может импортировать в систему компании, на основании данных которых впоследствии возможно использование системы субагентами, самостоятельная регистрация субагентов и синхронизация данных субагентов с данными в 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|Включить нотификацию по одной компании на строку. Последовательность полей: краткое наименование, тип контрагента (0 - агент, 1 E- субагент, 2 - корпоративный клиент), код 1С, полное юридическое наименование, ИНН, КПП mail}} (само значение в ячейке не обязательно, но столбец должен бытьразделе «Регистрация компаний»), электронный адрес компании, телефон компании, юридический адрес компании, фактический адрес компании, имя ответственного менеджера, фамилия ответственного менеджера, электронный адрес менеджера. При успешном импорте в системе создаются компании и тут же активируются без каких-либо запросов к веб-сервисам 1С. Если в настройках включена рассылка писем, то на электронный адрес менеджера при повторном оповещении будут отправлены нотификации о регистрации и при этом автоматически сменятся пароли на электронный адрес компании будет высланы письма об активации компанииновые.

Список {{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С]