TeamProfit.Service

Материал из РосИнфоТех

Английская версия документации

Схема взаимодействия программы

1.Введение

Для учета страховых полисов безвизовых групп и обеспечения взаиморасчетов между российскими страховыми компаниями (далее СК) и китайской СК

China Life создана система TeamProfit (далее TP). Основными задачи системы является:

• автоматический обмен данными о застрахованных лицах между российскими СК и китайской СК China Life
• автоматический учет взаиморасчетов между компаниями

2.Основные понятия

Туристическая компания (ТК) – туристическая организации, имеющие право на направление туристических групп, состоящих из граждан своего государства, и прием туристических групп, состоящих из граждан другого государства. ТК оформляет страховой полис на туристическую группу.

Страховая компания (СК) – российская страховая компания, с которой работает туристическая фирма и которая предоставляет для ТК программный терминал для заполнения страхового полиса.

Страховой полис (СП) – полис медицинского страхования группы выезжающих туристов. Информация о страховом полисе передается из базы данных российских СК через систему Teamprofit в базу данных китайской СК China Life.

Номер страхового полиса - каждый страховой полис обязан иметь свой номер, который может быть как уникальный либо для всей группы застрахованных туристов, либо для каждого застрахованного лица в отдельности.

Туристическая группа (группа) – группа граждан одного государства, не менее 5 и не более 50 человек, совершающих поездку на территорию другого государства с туристическими целями на срок, не превышающий 15 календарных дней.

Номер группы – уникальный в рамках государства номер, который формируется и присваивается туристической группе со стороны СК. Номер состоит из двух частей – уникального кода в рамках каждой СК и уникального кода СК в рамках государства. Пример 1: номер группы ААА020620 , где AAA – код СК, 020620 – код в рамках СК.

Список - список группы российских туристов, выезжающих в КНР установленного образца, подготавливаемый туристической фирмой для его заверении в Органе координации.

Орган координации (ОК) – федеральный орган исполнительной власти в сфере туризма (Ростуризм), а также уполномоченные им органы исполнительной власти субъектов Российской Федерации и осуществляющий учет безвизовых групповых туристических поездок.

Справочник Teamprofit (справочник) – электронная база данных о пунктах пропуска, названиях российских и китайских труфирм, органах координации. Все данные структурированы и имеют код записи, наименование на русском и на английском языках База находится на сервере системы TeamProfit, в системе реализованы сервисы для передачи информации в СК

3.Описание процесса передачи данных

Весь процесс работы по внесению информации о страховом полисе группы и передачи ее от российских СК в китайскую СК China Life можно разделить на следующие этапы

3.1.Заполнение турфирмой данных о полисе группе в терминале СК, присвоение номера группе и присвоение номера полиса

3.2.Выгрузка данных из базы СК в Teamprofit

3.3.Выгрузка данных из базы Teamprofit в базу China Life

3.4.Внесение информации о страховых выплатах со стороны China Life в базу Teamprofit.

Из терминала данные поступают в базу данных СК. Затем СК инициирует процесс выгрузки данных с базы системы Teamprofit. Дважды в сутки China Life инициирует процесс забора данных из базы Teamprofit. С течением времени, если произошел страховой случай, China Life передает информацию о нем в базу Teamprofit.

Рассмотрим процесс взаимодействия более подробно. ТК оформляет полис группы выезжающих туристов в терминале СК. Данные о группе должны содержать полный перечень информации о группе, который необходим для оформления страхового полиса и для регистрации группы в органах координации (список). Терминал позволяет распечатать список на бланке для подачи и заверения его в органах координации (пример бланка в приложении 1).

В тот момент, когда ТК начинает оформлять новую группу, СК автоматически генерирует и присваивается ей новый уникальный номер группы. Туристическая компания может оформлять несколько групп одновременно в течении времени. Терминал СК также должен иметь доступ к справочникам системы Teamprofit, которые содержат полный возможный перечень всех туристических компаний, как российских, так и китайских, а также перечень пунктов пропуска и органов координации.

После того, как туристическая компания окончательно оформила группу, она передает данные в базу данных страховой компании. Страховая компания создает страховой полис и присваивает ему номер. При этом номер группы и номер полиса становят жестко связанными друг с другом.

Затем осуществляется выгрузка данных из базы страховой компании с базу системы Teamprofit. СК самостоятельно инициирует эту выгрузку. Выгрузка состоит из запроса на передачу данных о группе, передачу пакетов информации по каждому члену группы и подтверждение окончания передачи. В случае, если данные по каким либо причинам (например, какие либо данные отсутствуют либо произошел сбой при передаче) не были переданы, система Teamprofit возвращает код ошибки. В этом случае СК должна проинформировать турфирму либо о некорректности данных, либо попробовать повторить передачу. В случае, если система Teamprofit недоступна долгое время, должен быть предусмотрен «ручной» вариант пересылки информации (через Email в Excel файле) (Приложение 2). Однако СК должна предусмотреть техническую возможность повторить выгрузку всех либо только не переданных данных вновь через некоторый момент времени. Система построена таким образом, что уже добавленные данные в систему не попадут. В связи с тем, что менеджер турфирмы, на этапе заполнения данных (но только до выезда группы) может внести ошибку (например, ошибка в написании фамилии застрахованного лица), то в процессе предусмотрен механизм обновления данных. Менеджеру турфирмы при этом понадобится распечатать новые списки групп для заверения в ОК, а система автоматически должна удалить полисы под старыми номерами, присвоит отредактированным данным новый номер группы и сделать повторную передачу. На рисунке 2 зелеными стрелками указан процесс, который происходит в первые. С случае, если даны были отредактированы, то происходит повторная передача данных (синяя стрелка) и запрос на удаление информации (красная). При этом бумажная версия первого, некорректно заполнено бланка, уничтожается – группа фигурирует уже под новым номером.

4.Перечень данных, предоставляемых турфирмой Туристическая фирма должна обеспечить заполнение всех данных, представленных в таблице

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

5.Требования к программному обеспечению СК

Страховая компания должна создать программный интерфейс для ТК и сервис выгрузки данных из своей базы данных в систему Teamprofit.

5.1.Терминал для оформления группы

От страховой компании требуется реализация интерфейса терминала доступа, который позволял бы:

5.1.1.Заполнять и передавать в базу СК информацию о группе, персональные данные застрахованных лиц.

5.1.2.Автоматически создавать и присваивать номера групп

5.1.3.Предоставить автоматический доступ к справочникам системы Teamprofit

5.2.Требования к реализации передачи данных

От страховой компании требуется реализация следующих сервисов по передачи данных:

5.2.1.Сервис «Начало передачи группы»

5.2.2.Сервис «Добавить полис»

5.2.3.Сервис «Окончание передачи группы»

5.2.4.Удаление группы

5.2.5.Получение информации о группе

Общий алгоритм работы следующий. Перед началом работы СК вызывает сервис «Начало передачи группы», в котором указывает номер новой группы. Система Teamprofit по выделенному ля каждой СК уникальному паролю понимает, какая именно СК обращается и проверят, не было ли такого номера группы от данной СК в системе ранее. Если был, то система возвращает код ошибки «номер группы уже существует» и группа с этим номером добавлена не будет ни при каких обстоятельствах. Если номера не был, то система ожидает получение данных. СК вызывает сервис «добавить полис», с помощью которого пересылает поочередно записи о каждом члене данной группы. Если данные некорректны (поля данные заполнены некорректно или отсутствуют), система возвращает ошибку «Отсутствуют обязательные поля данных, данные не добавлены» с расшифровкой, какие именно поля некорректны. После пересылки данных о всех членах группы, СК вызывает сервис «Окончание передачи группы». Если все данные по членам группы были переданы без ошибок и количество переданных данных о группе совпадает с указанным количеством членов группы, то только тогда группа добавляется в базу Teamprofit. Система Teamprofit фиксирует время прихода записи по внутренним часам сервера (московское время GMT+4) и после ближайшего по времени запроса от СК China Life предоставить данные о группе для выгрузке.

В том случае, если данные были отредактированы туристической фирмой и заново отправлены в систему до выезда группы, как уже было сказано выше, необходимо удалить группу под старым номером и переслать группу под новым номером. Это требование позволит избежать дублирующих списков групп, поисков актуального списка, а также позволит взаимодействовать с государственной системой учета туристических групп Ростуризма, системой ГИС. Система Teamprofit либо подтверждает, что группа с запрошенным номером будет удалена, либо возвращает ошибки. Ошибки могут быть следующего плана:

• Группа с данным номером отсутствует в системе

• По данной группе уже были произведены выплаты и информация и China Life заполнила информацию о выплатах.

WCF-служба

Адрес:

http://service.teamprofit.itrf.ru

Добавить полис

Функция добавления полиса, скачать исходный код Файл:Teamprofit WCF Example.zip (Visual Studio 2010)

using (var client = new TeamProfitService.ServiceClient())
{
    client.AddPolicy(
        "*****", 
        "123456",
        new DateTime(2011, 1, 1), 
        new DateTime(2011, 12, 31), 
        365, 
        DateTime.Now,
        "Plane", 
        30000, 
        7,
        "IVANOV IVAN IVANOVIH", 
        "007 123456", 
        new DateTime(1970, 3, 21), 
        "M",
        "Russia, Moscow, Kremlin d. 1", 
        new DateTime(2012, 9, 12),
        "", 
        "S-10", 
        "R-200", 
        "Tourist, The Great Wall of China",
        "Sheremetyevo, F",
        "Sheremetyevo, F",
        new DateTime(2011, 1, 1), 
        new DateTime(2011, 12, 31),
        "EASTLINE",
        "-",
        "PETR IVANOV",
        0,
        1,
        "d76f5bafe5bf53da4cd16f79a8a31bef");
}

Удалить группу

using (var client = new TeamProfitService.ServiceClient())
{
    client.DeleteGroup(
        "*****", //password
        "11111"); //Номер группы
}

Проверить группу

Функция, проверки выгруженной группы, если найдены ошибки группа удаляется. Ответ сервера "5 - Не хватает данных, запись не добавлена".

using (var client = new TeamProfitService.ServiceClient())
{
    client.ValidGroup(
        "*****", //password
        "11111"); //Номер группы
}

Существование группы

Функция, проверки существования группы. Если группа существует то возвращается число фактически загруженных полисов, если группа не существует возвращается -1.

using (var client = new TeamProfitService.ServiceClient())
{
    client.IsGroup(
        "*****", //password
        "11111"); //Номер группы
}

HTTP-запрос

Добавить полис

Для добавления необходимо вызвать методом GET или POST адрес:

http://service.teamprofit.itrf.ru/add/?password=<password>
     &PolicyNumber=<PolicyNumber>
     &PolicyPeriodFrom=<PolicyPeriodFrom>
     &PolicyPeriodTill=<PolicyPeriodTill>
     &PolicyTerm=<PolicyTerm>
     &DtCreated=<DtCreated>
     &TransportType=<TransportType>
     &AmountAtRisk=<AmountAtRisk>
     &PremCurrency=<PremCurrency>
     &FIO=<FIO>
     &Passport=<Passport>
     &DateOfBirth=<DateOfBirth>
     &SexCode=<SexCode>
     &BirthPlace=<BirthPlace>
     &ExpirationDate=<ExpirationDate>
     &GroupNumber=<GroupNumber>
     &SentTravelAgencies=<SentTravelAgencies>
     &ReceiveTravelAgencies=<ReceiveTravelAgencies>
     &Description=<Description>
     &PointOfEntryAirport=<PointOfEntryAirport>
     &ItemDepartureAirport=<ItemDepartureAirport>
     &DateArrival=<DateArrival>
     &DateDeparture=<DateDeparture>
     &SendingOperator=<SendingOperator>
     &CoordinationAuthority=<CoordinationAuthority>
     &NameGroupLeader=<NameGroupLeader>
     &NumberPeopleGroup=<NumberPeopleGroup>
     &PersonOrder=<PersonOrder>
     &Md5Hash=<Md5Hash>

Пример вызова:

http://service.teamprofit.itrf.ru/add/?password=***
     &PolicyNumber=123456
     &PolicyPeriodFrom=01.01.2011
     &PolicyPeriodTill=31.12.2011
     &PolicyTerm=365
     &DtCreated=03.11.2011
     &TransportType=Plane
     &AmountAtRisk=30000
     &PremCurrency=7
     &FIO=IVANOV IVAN IVANOVIH
     &Passport=007 123456
     &DateOfBirth=21.03.1970
     &SexCode=M
     &BirthPlace=Russia, Moscow, Kremlin d. 1
     &ExpirationDate=12.09.2012
     &GroupNumber=
     &SentTravelAgencies=S-10
     &ReceiveTravelAgencies=R-200
     &Description=Tourist, The Great Wall of China
     &PointOfEntryAirport=Sheremetyevo, F
     &ItemDepartureAirport=Sheremetyevo, F
     &DateArrival=01.01.2011
     &DateDeparture=31.12.2011
     &SendingOperator=EASTLINE
     &CoordinationAuthority=-
     &NameGroupLeader=PETR IVANOV
     &NumberPeopleGroup=0
     &PersonOrder=1
     &Md5Hash=d76f5bafe5bf53da4cd16f79a8a31bef

Удалить группу

Для удаления необходимо вызвать методом GET или POST адрес:

http://service.teamprofit.itrf.ru/delete/?password=<password>&GroupNumber=<GroupNumber>

Пример вызова:

http://service.teamprofit.itrf.ru/delete/?password=***&GroupNumber=1111

Проверить группу

Для проверки выгрузки группы необходимо вызвать методом GET или POST адрес:

http://service.teamprofit.itrf.ru/valid/?password=<password>&GroupNumber=<GroupNumber>

Пример вызова:

http://service.teamprofit.itrf.ru/valid/?password=***&GroupNumber=1111

Существование группы

Для проверки существования группы необходимо вызвать методом GET или POST адрес:

http://service.teamprofit.itrf.ru/is/?password=<password>&GroupNumber=<GroupNumber>

Пример вызова:

http://service.teamprofit.itrf.ru/is/?password=***&GroupNumber=1111

Описание параметров, передаваемых Серверу

Список турфирм

Скачать Файл:Travel agency list.xls

Список пунктов пропуска

Скачать Файл:Checkpoints.xls

Коды ошибок

Система управления

Перейдите по ссылке для ознакомления с полной инструкцией TeamProfit.Service:Система управления