Изменения

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

== Администрирование ==[http[Файл:Рекизиты_подключения_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>Наименование</redmineth><th>Тип контрагента</th><th>Электронный адрес</th></tr><tr><td>00009726</td><td>Дикий запад</td><td>0</td><td>travel@wildwest.mutecom</td></tr><tr><td>00011345</td><td>Снежный север</td><td>2</td><td>travel@snow-labnorth.com</td></issuestr><tr><td>...</5607 тикет]td><td>...</td><td>...</td><td>...</td></tr></table> При успешном импорте в системе создаются компании и тут же активируются без каких-либо запросов к веб-сервисам 1С. Если какие-то компании не удалось импортировать, об этом выводится сообщение, можно отредактировать файл импорта и импортировать оставшиеся компании. При этом повторный импорт компаний с уже известными 1C кодами произведён не будет. Если в настройках включена рассылка писем, то на электронный адрес менеджера и на электронный адрес компании будет высланы письма об активации компании. ==== Импорт пользователей в определенную группу ==== В файле не указывается ID группы, в которую должны определиться пользователи. 1. Загрузка пользователей из файла возможна только в одну группу, поэтому, если необходимо внести пользователей, например, в две группы, загружать их нужно по отдельности, то есть сначала загрузить файл с пользователями из одной группы, затем из другой. 2. ID группы, в какую нужно зарегистрировать пользователей нужно указать в разделе: Настройки системы - Интеграция - Регистрация и импорт субагентов из 1С - Регистрация компаний. Здесь до загрузки файла нужно внести настройки, как минимум указать ID Группы в поле: "ID группы, в которую включаются активируемые компании". Сохранить и загрузить файл. Далее поменять ID группы и загрузить второй файл. === Список компаний ===

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

== Администрирование === Формат файла экспорта =====

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

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

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

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

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

* {| style="width: 800px" class="wikitable"|-! scope="col" width="250" | Переменная! scope="col" width="550" | Описание|-| %LOGINMANAGER_LOGIN% - логин | Логин менеджера созданного агентства;* |-| %PASSWORDMANAGER_PASSWORD% | Пароль|- пароль;* | %DATE_ACTIVATED% | Дата активации|- дата активации;* | %AGENCY_PROFILE_LINKCOMPANY_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}}, либо с логином неподтверждённой регистрации пользователя.

'''взаимодействие Механизм взаимодействия подробно описан в соответствующей статье: [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С''']