Изменения

<!-- -->При помощи модуля '''"Регистрация «Регистрация и импорт компаний"''' компаний» агентство может импортировать в систему компании, на основании данных которых впоследствии возможно использование системы субагентами, самостоятельная регистрация субагентов и синхронизация данных субагентов с данными в 1С агентства при помощи веб-сервиса, "в «в асинхронном режиме получать из системы 1С данные о счете, выставленном в системе 1С".  Модуль включается на странице '''"Администрирование"''' ⇨ '''"Модули"''' ⇨ ''"Взаимодействие с 1С"''. После включения, функционал саморегистрации становится доступен агентствам и администраторам (но не субагентствам). На главной странице агентства в шапке появляется ссылка '''"Регистрация компаний"'''. Для менеджеров агентства отображаются пункты меню '''"Администрирование"''' ⇨ '''"Регистрация и импорт компаний"''' (внутри находятся группы - '''"Настройки"''', '''"Импорт"''', '''"Список компаний"'''). Администраторам доступен выбор агентства. На странице '''"Администрирование"''' ⇨ '''"Формы ввода данных"''' можно управлять списком полей формы самостоятельной регистрации компании. На странице '''"Заказы"''' ⇨ '''"Шаблоны электронных писем"''' можно создать шаблоны писем, отправляемых при регистрации и активации компании1С».

[[Файл:Регистрация_и_импорт_компаний_-_Импорт_-_Файл_не_выбран.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С* Логин к веб-сервису* Ключ к веб-сервису в которую должны определиться пользователи.

На странице настроек ('''"Администрирование"''' ⇨ '''"Регистрация и импорт компаний"''' ⇨ '''"Настройки"''') можно 1. Загрузка пользователей из файла возможна только в одну группу, поэтому, включить или отключить рассылку писемесли необходимо внести пользователей, например, в две группы, загружать их нужно по отдельности, настроить сообщениято есть сначала загрузить файл с пользователями из одной группы, отображаемые при самостоятельной регистрации компанийзатем из другой.

На странице '''"Импорт"''' можно загрузить файл в формате '''''XLS''''' <span style="border: 1px solid #F00; background-color: #F30;">(строго говоря, в любом формате, который может быть разобран с помощью библиотеки PHPExcel)</span> со списком компаний, экспортированным из базы 1C агентства2. Импортируются либо все компании, либо ни одной, если в файле обнаружены ошибки, отсутствуют необходимые поляID группы, есть компании с уже имеющимися в базе ИНН или электронным адресом компании (т.е. не может случиться так, что импортировалась только половина компаний из файла). На данный момент используется следующий формат файла. Все компании записаны какую нужно зарегистрировать пользователей нужно указать в первый рабочий лист файла по одной компании на строку. Последовательность полейразделе: код 1С, краткое наименование, тип контрагента (0 - агент, 1 Настройки системы - субагент, 2 Интеграция - корпоративный клиент) электронный адрес компании. При успешном импорте в системе создаются компании Регистрация и тут же активируются без каких-либо запросов к веб-сервисам импорт субагентов из 1С. Если какие-то компании не удалось импортировать, об этом выводится сообщение, можно отредактировать файл импорта - и импортировать оставшиеся компании. При этом повторный импорт Регистрация компаний с уже известными 1C кодами произведён не будет. Если в настройках включена рассылка писем, то на электронный адрес менеджера и на электронный адрес компании будет высланы письма об активации компании.

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

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

* {| 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. Кроме того, периодически запрашиваются данные компаний из 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С и настройки соответствующих субагентств меняются согласно данным, полученным из 1С.]