中介平台与第三方合作平台接口说明寿险.docx

中介平台与第三方合作平台接口说明寿险.docx

《中介平台与第三方合作平台接口说明寿险.docx》由会员分享，可在线阅读，更多相关《中介平台与第三方合作平台接口说明寿险.docx（33页珍藏版）》请在冰豆网上搜索。

中介平台与第三方合作平台接口说明寿险

中介平台与第三方合作平台

接口说明（寿险）

文档日期：

2017年05月

文档版本：

本文档所包含的信息在未事先得到书面同意之前，本文档全部或部份内容不得用于其他任何用途或交与第三方。

版本控制表

项目名称：

文件名：

生成日期：

2015.09

版本号

日期

作者

修正章节

变更记录

1.0

2017-09-15

创建一期接口说明文档

1综述

第三方合作平台通过调用安邦中介平台出单接口进行出单。

本文档对出单接口交互方式、报文编码以及报文详细节点信息进行说明。

此文档为初版，可在此基础上跟第三方合作平台技术人员沟通讨论后进行修改。

本文档描述了第三方合作平台与安邦中介平台对接业务处理流程，即出单接口涉及的数据文件的字段定义、格式定义、交互方式等内容。

根据业务实际情况，第三方合作平台与安邦中介平台交互包括以下业务环节：

业务出单：

第三方合作平台将采集到的客户投保信息，包括投被保人信息、险种信息、受益人信息、客户告知信息、业务专管员信息以XML报文形式发送给安邦中介平台，中介平台调用安邦核心业务系统相关接口进行出单处理，处理成功返回投保成功信息，处理失败返回具体失败信息。

1.1通信方式说明

所有接口均使用webservice方式提供，遵守soap协议，接口输入输出通过xml格式的string进行调用。

第三方合作平台通过post方式提交XML报文数据到安邦中介平台出单接口，安邦中介平台系统接收并返回XML报文数据，完成报文数据交换。

1.2接口报文说明

每个接口的请求和响应XML文档为一一对应的，如果不是必须字段，那么设置该节点值为空。

为了兼容生僻字，要求企业客户端发来的xml报文的字符集为GBK，返回报文的字符集也为GBK。

报文开头作如下设置即可：

xmlversion="1.0"encoding="GBK"?

>

序号

提供方

接口名称

接口编码

调用方

接口方式

1

中介平台

投保接口

ContConfirm

第三方合作平台

Webservice

2

中介平台

支付接口

FinfeeModify

第三方合作平台

Webservice

1.3加密方式

请求报文和返回报文均需要进行加密传输；

加密方法说明：

1.根据约定秘钥，采用Des加密算法进行加密生成字节数组；

2.将加密后生成的字节数组采用BASE64算法编码；

解密方法说明：

1.采用BASE64算法对密文进行解码生成字节数组；

2.根据约定的秘钥，对生成的字节数组进行采用Des解密；

对于java开发环境：

1、使用GBK编码取得传输报文的byte序列（字节序列），对取得的byte序列采用des进行加密；

2、对第一步的加密结构使用jdk自带的base64进行加密；

同样解密也行进行两次解密：

1、使用base64对密文进行解密；

2、对第一步解密的结果，使用des进行解密，对解密后的byte序列使用GBK编码，构造一个新的字符串；

加解密的密匙，测试时均使用12dc293d43db3b237849，生产环境的密匙，单独发出；

加解密可使用附件加密类的方法进行加解密：

加密：

DesUtil.encrypt（"明文报文","密匙", "GBK"）;

解密：

DesUtil.decrypt（"密文报文","密匙", "GBK"）;

1.4业务流程说明

实现第三方合作平台与中介平台的对接，实现中介平台与核心系统的对接。

安邦中介平台对第三方合作平台提供投保、支付接口，并实时返回接口交易结果。

中介平台接收到第三方合作平台请求后，调用核心录单、核保、收费信息修改接口、无卡支付接口及签单接口。

业务流程可以参加下面业务流程图（第三方平台只关注第三方平台接口即可）：

第三方合作平台与安邦中介平台两步交易：

第一步：

投保请求

投保人在第三方合作平台录入投保信息，第三方合作平台进行基本校验，然后向安邦中介平台发送投保请求。

中介平台接收到第三方合作平台请求之后，调用单证系统生成投保单号，然后调用核心投保接口、核保接口，并反馈交易结果给第三方合作平台。

如果核保失败，则投保流程结束。

客户可以修改信息再次发起投保请求。

第二步：

支付请求

如果第一步交易核保成功，则客户录入缴费账户信息，第三方合作平台向安邦中介平台发送支付请求，中介平台依次调用核心收费信息修改接口、财务支付接口、签单接口，并反馈交易结果给第三方合作平台。

如果签单成功，客户会收到安邦寿险发送的承保短信和邮件（包含电子保单）。

从第三方合作平台投保安邦寿险产品成功后，后续保全（包括犹豫期内退保）和理赔操作都需要投保人来我保险公司进行申请。

1.5产品基本信息

待定

2安邦中介平台-投保接口（寿险）

2.1接口说明

以下接口说明是对第三方合作平台传给中介平台的报文内容约定，不涉及第三方合作平台方的投保页面相关要求，第三方合作平台方投保页面具体要求及页面规则由业务部门单独提供。

另，报文具体结点，后期开发联调时可以根据实际情况进行调整。

2.2请求报文

2.2.1报文定义

采用xml数据格式，数据采用GBK编码。

2.2.2报文框架

节点

记录数

说明

BaseInfo

交易代码、交易时间

1

ContInfo

LCCont

保单基本信息

1.1

Agents

AgentCount

业务员数

1.1

Agent

业务员基本信息

n

LCAppnt

投保人基本信息

1.1

LCAddress

投保人地址

1.1

LCAppntImparts

LCAppntImpartCount

投保人告知数目

1.1.1

LCAppntImpart

投保人告知信息

n

LCInsureds

LCInsuredCount

被保人数

1.1

LCInsured

每个被保人信息及所包含的险种信息

n

LCAddress

被保人地址

1.1

LCInsureImparts

LCInsureImpartCount

被保人告知数目

1.1

LCInsureImpart

被保人告知信息

n

Risks

RiskCount

每个被保人投保险种数

1.1

Risk

险种详细信息

n

Dutys

DutyCount

责任个数

1.1

Duty

责任信息

n

LCBnfs

LCBnfCount

受益人数目

LCBnf

受益人信息

2.2.3样例

xmlversion="1.0"encoding="GBK"?

>

--接口编码-->

--请求时间yyyy-mm-ddhh:

mm:

ss-->

--响应时间yyyy-mm-ddhh:

mm:

ss-->

--##报文任务保单基本信息##-->

—原订单号-->

--订单号-->

--主体公司标示-->

--投保单投保日期-->

--保单所属机构-->

--操作员-->

—保单接收方式-->

--渠道销售方式（11-网销）-->

--销售渠道7-网销-->

--九大业务渠道06-移动互联渠道-->

—保单来源-->

—业务来源-->

--##报文任务保单业务员信息##-->

--业务员信息，此处用于支持多业务员情况--->

--业务员编码-->

--业务员姓名-->

--业务员银行代理机构-->

--业务员组别-->

--业务员分佣比例-->

--##报文任务保单投保人信息##-->

--投保人姓名-->

--投保人性别-->

--投保人生日-->

--投保人证件类型-->

--投保人证件号码-->

--投保人证件有效起期-->

--投保人证件有效止期-->

--投保人婚姻状况-->

--投保人国籍-->

--投保人职业类别-->

--投保人职业代码-->

--地址信息-->

--联系地址（省）-->

--联系地址（市）-->

--联系地址（区/县）-->

--联系地址（街道号码