Мастер-Сервис:Дополнительный модуль Отправка страховок Sinoasia B&R — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Работа с модулем)
(Работа с модулем)
 
(не показано 6 промежуточных версий этого же участника)
Строка 13: Строка 13:
 
==Настройка заданий модуля==
 
==Настройка заданий модуля==
 
Основные настройки задания происходят в экране '''Основное''':
 
Основные настройки задания происходят в экране '''Основное''':
 +
 +
[[Файл:Nr070.png|Основные настройки задания модуля «Отправка сведений в Sinoasia B&R»]]
 +
 
* Имя сервера SQL – наименование сервера, на котором установлена клиентская база данных.
 
* Имя сервера SQL – наименование сервера, на котором установлена клиентская база данных.
 
* База данных – наименование клиентской базы данных, в которой содержатся страховки для отправления в '''Sinoasia B&R'''.
 
* База данных – наименование клиентской базы данных, в которой содержатся страховки для отправления в '''Sinoasia B&R'''.
Строка 18: Строка 21:
 
* Путь – предоставляемый '''Sinoasia B&R''', адрес FTP-сервера, на который и будут отправляться сведения о страховках.
 
* Путь – предоставляемый '''Sinoasia B&R''', адрес FTP-сервера, на который и будут отправляться сведения о страховках.
 
* Логин и пароль – предоставляемый '''Sinoasia B&R'''.
 
* Логин и пароль – предоставляемый '''Sinoasia B&R'''.
* Имя партнера страхователя – точное совпадающее ''краткое название'' партнера, занесенное в [[Мастер-Тур:База_данных_«Партнеры»|Базу данных «Партнеры»]], сведения об услугах которого должны отправляться в '''Sinoasia B&R'''.
+
* Имя партнера страхователя – точно совпадающее ''краткое название'' партнера, занесенное в [[Мастер-Тур:База_данных_«Партнеры»|Базу данных «Партнеры»]], сведения об услугах которого должны отправляться в '''Sinoasia B&R'''.
 
* Имя услуги неотложной помощи – полное или частичное наименование всех услуг, которые будут считаться услугами оказания неотложной медицинской помощи. К примеру, если указать значение ''мед'' в данном поле, то все страховые услуги из путевки, в названии которых есть данное буквосочетание, попадут в данную категорию.
 
* Имя услуги неотложной помощи – полное или частичное наименование всех услуг, которые будут считаться услугами оказания неотложной медицинской помощи. К примеру, если указать значение ''мед'' в данном поле, то все страховые услуги из путевки, в названии которых есть данное буквосочетание, попадут в данную категорию.
 
* Имя услуги несчастного случая – полное или частичное наименование всех услуг, которые будут считаться услугами страховки от несчастного. К примеру, если указать значение ''несч'' в данном поле, то все страховые услуги из путевки, в названии которых есть данное буквосочетание, попадут в данную категорию.
 
* Имя услуги несчастного случая – полное или частичное наименование всех услуг, которые будут считаться услугами страховки от несчастного. К примеру, если указать значение ''несч'' в данном поле, то все страховые услуги из путевки, в названии которых есть данное буквосочетание, попадут в данную категорию.
Строка 25: Строка 28:
 
* Код страны резиденства – числовой код ISO 3166-1 из [[Мастер-Тур:Справочники#Страны|Справочника стран]], соответствующий той стране, гражданин которой является резидентом в полюсе страховой фирмы.
 
* Код страны резиденства – числовой код ISO 3166-1 из [[Мастер-Тур:Справочники#Страны|Справочника стран]], соответствующий той стране, гражданин которой является резидентом в полюсе страховой фирмы.
 
* Имя профиля отчета – наименование того профиля отчета 4080 «Страховки», который отвечает за создание полюсов, отправляемых в '''Sinoasia B&R'''.
 
* Имя профиля отчета – наименование того профиля отчета 4080 «Страховки», который отвечает за создание полюсов, отправляемых в '''Sinoasia B&R'''.
 +
* Префикс номера полиса – в этом качестве используется номер серии бланка страхового полюса, задаваемый в настройке того профиля отчета 4080 «Страховки», который отвечает за создание полюсов, отправляемых в '''Sinoasia B&R'''.
  
[[Файл:Nr070.png|Основные настройки задания модуля «Отправка сведений в Sinoasia B&R»]]
+
[[Файл:Nr102.png|Настройка серии бланка в профиле отчета]]
  
 
Помимо этого, в настройках задания есть экран '''Валюты'''. В данном экранах можно увидеть таблицу ISO-кодов валют, сведения о которых обрабатываются сервисом '''Sinoasia B&R'''. Код должен совпадать с аналогичным кодом в [[Мастер-Тур:Справочники#Справочники валют и их курсов друг к другу|справочнике Валюты]] и кодировке валюты в [https://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%B4%D1%8B_%D0%B8_%D0%BA%D0%BB%D0%B0%D1%81%D1%81%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D1%8B_%D0%B2%D0%B0%D0%BB%D1%8E%D1%82#%D0%A1%D1%80%D0%B0%D0%B2%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%B0%D1%8F_%D1%82%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D0%B0_%D0%BA%D0%BE%D0%B4%D0%BE%D0%B2 международном стандарте ISO 4217]. Редактирование существующих и занесение новых данных можно осуществлять как через табличную часть, так и посредством выгрузки и загрузки xml-файла со всеми кодами.
 
Помимо этого, в настройках задания есть экран '''Валюты'''. В данном экранах можно увидеть таблицу ISO-кодов валют, сведения о которых обрабатываются сервисом '''Sinoasia B&R'''. Код должен совпадать с аналогичным кодом в [[Мастер-Тур:Справочники#Справочники валют и их курсов друг к другу|справочнике Валюты]] и кодировке валюты в [https://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%B4%D1%8B_%D0%B8_%D0%BA%D0%BB%D0%B0%D1%81%D1%81%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D1%8B_%D0%B2%D0%B0%D0%BB%D1%8E%D1%82#%D0%A1%D1%80%D0%B0%D0%B2%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%B0%D1%8F_%D1%82%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D0%B0_%D0%BA%D0%BE%D0%B4%D0%BE%D0%B2 международном стандарте ISO 4217]. Редактирование существующих и занесение новых данных можно осуществлять как через табличную часть, так и посредством выгрузки и загрузки xml-файла со всеми кодами.
Строка 41: Строка 45:
 
* В путевке обязательно должны быть услуги неотложной помощи и несчастного случая.
 
* В путевке обязательно должны быть услуги неотложной помощи и несчастного случая.
 
* У туристов обязательно должны быть заполнены следующие данные:  
 
* У туристов обязательно должны быть заполнены следующие данные:  
** Фамилия
+
** Фамилия (только для граждан страны, установленной как резидентство)
** Имя
+
** Фамилия на латинице
** Отчество
+
** Имя (только для граждан страны, установленной как резидентство)
** Пол
+
** Имя на латинице
 +
** Отчество (только для граждан страны, установленной как резидентство)
 +
** Отчество на латинице
 
** Дата Рождения  
 
** Дата Рождения  
** Гражданство. Для корректной работы плагина ''необходимо'', чтобы указанная в графе "Гражданство" страна имела заполненный ISO-код в [[Мастер-Тур:Справочники#Страны|справочнике Страны]].
+
** Гражданство
 
** E-mail
 
** E-mail
 
** Серия загран. паспорта
 
** Серия загран. паспорта
 
** Номер загран. паспорта
 
** Номер загран. паспорта
** Дата выдачи загран. паспорта
+
** ID туриста/ИНН (только для граждан страны, установленной как резидентство).
** Кем выдан загран. паспорт
+
 
** Серия паспорта
+
[[Файл: am_063.png|left|Предупреждение]]<br />
** Номер паспорта
+
Для корректной работы плагина необходимо, чтобы страна гражданства туриста, а также страна, указанная в путевке как место прибытия, имели заполненные ISO-коды в [[Мастер-Тур:Справочники#Страны|справочнике Страны]].
** Дата выдачи паспорта
+
<br />
** Кем выдан паспорт
 
** ID туриста (ИНН).
 
  
 
В случае корректной настройки задания модуля и занесения всех необходимых сведений, плагин отправит в страховую компанию '''Sinoasia B&R''' сведения о туристе, его страховых услугах и полисе. Для этого плагин формирует файл отчета формата xml, в котором будут указаны следующие параметры:
 
В случае корректной настройки задания модуля и занесения всех необходимых сведений, плагин отправит в страховую компанию '''Sinoasia B&R''' сведения о туристе, его страховых услугах и полисе. Для этого плагин формирует файл отчета формата xml, в котором будут указаны следующие параметры:
* number – номер страхового полюса
+
* prefix – префикс номера страхового полюса
 +
* number – номер путевки, по которой оформлен страховой полюс
 +
* number_add – код туриста по путевке
 
* date_of_creation – дата создания полюса
 
* date_of_creation – дата создания полюса
 
* first_name – имя туриста в кириллице (только для резидентов)
 
* first_name – имя туриста в кириллице (только для резидентов)
Строка 67: Строка 73:
 
* passport – серия и номер заграничного паспорта
 
* passport – серия и номер заграничного паспорта
 
* iin – ID туриста (только для резидента)
 
* iin – ID туриста (только для резидента)
 +
* region - ISO-код страны прибытия по путевке
 
* period_beg – дата начала действия полюса
 
* period_beg – дата начала действия полюса
 
* period_end – дата конца действия полюса
 
* period_end – дата конца действия полюса

Текущая версия на 09:45, 9 декабря 2019

Версия статьи от 9.12.2019.

Введение

Дополнительные модули в службе заданий «Мастер-Сервис» дают возможность автоматизировать рассылку необходимых отчетных форм, а также эффективно организовать работу с путевками в ПК «Мастер-Тур».

Данный модуль позволяет в автоматическом режиме отсылать в страховую компанию "Sinoasia B&R" сведения о страховых услугах и страховых полисах, занесенных в базу данных ПК «Мастер-Тур».

Установка модуля

Модуль разработан для ПК «Мастер-Тур» 15.3 и выше. Установочный файл — Megatec.MasterService.Plugins.MasterTour.InsuranceAutoSendSinoasiaBR.dll.

Для установки модуля в экране «Мастер-Сервис Админ» нажмите кнопку Добавить/обновить модуль «Добавить/обновить модуль» и выберите необходимый установочный файл. После этого нужно перезапустить службу заданий. Модуль появится в списке доступных модулей, в дереве: Таблицы → Модули, под названием «Отправка сведений в Sinoasia B&R».

Настройка заданий модуля

Основные настройки задания происходят в экране Основное:

Основные настройки задания модуля «Отправка сведений в Sinoasia B&R»

  • Имя сервера SQL – наименование сервера, на котором установлена клиентская база данных.
  • База данных – наименование клиентской базы данных, в которой содержатся страховки для отправления в Sinoasia B&R.
  • Логин и пароль – под которыми пользователь работает с базой данных.
  • Путь – предоставляемый Sinoasia B&R, адрес FTP-сервера, на который и будут отправляться сведения о страховках.
  • Логин и пароль – предоставляемый Sinoasia B&R.
  • Имя партнера страхователя – точно совпадающее краткое название партнера, занесенное в Базу данных «Партнеры», сведения об услугах которого должны отправляться в Sinoasia B&R.
  • Имя услуги неотложной помощи – полное или частичное наименование всех услуг, которые будут считаться услугами оказания неотложной медицинской помощи. К примеру, если указать значение мед в данном поле, то все страховые услуги из путевки, в названии которых есть данное буквосочетание, попадут в данную категорию.
  • Имя услуги несчастного случая – полное или частичное наименование всех услуг, которые будут считаться услугами страховки от несчастного. К примеру, если указать значение несч в данном поле, то все страховые услуги из путевки, в названии которых есть данное буквосочетание, попадут в данную категорию.
  • Статус путевки – допустимые статусы путевок, при которых привязанные к ним страховки будут отправляться в Sinoasia B&R.
  • Email для уведомлений – почтовый адрес, на который будут отсылаться ошибки, связанные с работой плагина. Для отправки писем предварительно нужно установить и настроить Дополнительные модули Подготовка e-mail сообщений и Отправка e-mail сообщений.
  • Код страны резиденства – числовой код ISO 3166-1 из Справочника стран, соответствующий той стране, гражданин которой является резидентом в полюсе страховой фирмы.
  • Имя профиля отчета – наименование того профиля отчета 4080 «Страховки», который отвечает за создание полюсов, отправляемых в Sinoasia B&R.
  • Префикс номера полиса – в этом качестве используется номер серии бланка страхового полюса, задаваемый в настройке того профиля отчета 4080 «Страховки», который отвечает за создание полюсов, отправляемых в Sinoasia B&R.

Настройка серии бланка в профиле отчета

Помимо этого, в настройках задания есть экран Валюты. В данном экранах можно увидеть таблицу ISO-кодов валют, сведения о которых обрабатываются сервисом Sinoasia B&R. Код должен совпадать с аналогичным кодом в справочнике Валюты и кодировке валюты в международном стандарте ISO 4217. Редактирование существующих и занесение новых данных можно осуществлять как через табличную часть, так и посредством выгрузки и загрузки xml-файла со всеми кодами.
Экран «Валюты» настроек задания «Отправка сведений в Sinoasia B&R»

Работа с модулем

Модуль «Отправка сообщения покупателю» осуществляет отправку сведений по страховым услугам из экранов Турпутевка и Туристы. Для корректной отправки сведений необходимо соблюдать следующие условия:

  • В базе данных должны быть заведены страховые полиса по всем услугам, сведения о которых планируются к отправлению. Страховые полиса оформляются при помощи Отчета 4080 «Страховки».
  • Дата начала тура, по которому был оформлен страховой полис, не должна быть ранее даты отправки.
  • Доп. описание 1 страховой услуги должно выглядеть таким образом: «Программа страхования»/«Страховая сумма»/«Код валюты цены услуги ISO», например: P1/10000/EU.
  • У всех страховых услуг в путевке должна быть заведена актуальная цена нетто или брутто.
  • В путевке обязательно должны быть услуги неотложной помощи и несчастного случая.
  • У туристов обязательно должны быть заполнены следующие данные:
    • Фамилия (только для граждан страны, установленной как резидентство)
    • Фамилия на латинице
    • Имя (только для граждан страны, установленной как резидентство)
    • Имя на латинице
    • Отчество (только для граждан страны, установленной как резидентство)
    • Отчество на латинице
    • Дата Рождения
    • Гражданство
    • E-mail
    • Серия загран. паспорта
    • Номер загран. паспорта
    • ID туриста/ИНН (только для граждан страны, установленной как резидентство).
Предупреждение


Для корректной работы плагина необходимо, чтобы страна гражданства туриста, а также страна, указанная в путевке как место прибытия, имели заполненные ISO-коды в справочнике Страны.


В случае корректной настройки задания модуля и занесения всех необходимых сведений, плагин отправит в страховую компанию Sinoasia B&R сведения о туристе, его страховых услугах и полисе. Для этого плагин формирует файл отчета формата xml, в котором будут указаны следующие параметры:

  • prefix – префикс номера страхового полюса
  • number – номер путевки, по которой оформлен страховой полюс
  • number_add – код туриста по путевке
  • date_of_creation – дата создания полюса
  • first_name – имя туриста в кириллице (только для резидентов)
  • second_name – фамилия туриста в кириллице (только для резидентов)
  • first_name_eng – имя туриста в латинице
  • second_name_eng – фамилия туриста в латинице
  • passport – серия и номер заграничного паспорта
  • iin – ID туриста (только для резидента)
  • region - ISO-код страны прибытия по путевке
  • period_beg – дата начала действия полюса
  • period_end – дата конца действия полюса
  • resident – является ли турист резидентом (1, если является или 0, если не является)
  • resident-iso – ISO-код страны туриста
  • email – адрес электронной почты туриста

Также информацию об отправленных данных можно увидеть в файле MasterServiceLog.txt в папке Logs.