发送电子保单服务接口规范说明.docx

发送电子保单服务接口规范说明

版本编号
版本日期
修改人
说明

V 1.0
2019-06-15
袁军超
创立基准文档

V 1. 1
2019-07-02
袁军超
添加性别cSex,保单满期 日 cExpireTm

VI. 2
2019-08-15
袁军超
添加产品号cProdN,邮件 发送方cSender<0代表互 联网，1代表核心），添加 郎件类型10：孕中险承保 邮件，11：孕中险续保邮 件

1.引言1.1.目的
本文档是瑞华互•联网平台发送电了•保单服务接口说明文档。
主要用来规定发送电子保单业务数据进行数据交互时的数据统一及格式要求,1.2.文档说明
暂无2.接口概述
互联网平台提供接口服务，通过平台接受调用方的数据清求，实现电子保单发送功能.并在处理后返回给调用方相应的处理结果.数据接口格式为 JSON数据报文，在每次接口的交易中，都包含了请求的JSON数据与平台返回的JSON数据。
接口列表和基本格式如下：
2.1.接口列表
环节
接口名称
服务方法
功能描述
发送电子保单
发送电子保单
sendEletronicEmail (String reqJson)
发送电子保单服务接口
2.2.报文格式
数据文件采用标准的JSON格式，字符编码为UTF-8:标准JSON报文的梃值对组成,23.数据类型
类型
在JSON中的数据类型有以下几种：
描述
VARCHAR
文本信息，标明Jit大的长.度。该长度是按单字节进行计算的.对丁•双字节 数据按照长度为2为计
V
CHAR
字符信息，长度I
C
NUMBER
有正负符号的整数和小数两种：1、整数.标明最大的位数-2、小数.标 明p精度（位数）和s等级（小数盅后位数）,如；（3,2）说明[999.+9.99],
N
DATE
泛指日期＜Date）和时间（Time）,根据使用的情况可以仅包含H期局部， 也可能包含小时、分钟等局部：格式为：年月日时分秒.YYYY-MM-DD HH-MM-SS.
D
BOOL
代表了一个两价逻辑值（或者假）, 用0,代表假或否；用1，代表真或是
B
2. 4.失败报文格式
报文为服务抛出的异常,由调用方白身捕获。服务提供了不同业务场景所需的业务性异常。
3.发送电子保单服务接口.请求数据
说明：主要包含基本信息
No.
字段名
类型
必填
长度
默认值
说明
1
cToMailAdd
arr
Y

发送邮箱
2
cToMailAddCopy
Arr
N

杪送邮箱
3
cContent
V
N
255

发送内容
4
cType
V
Y
20

邮件类型00：普通邮件，01承保邮件， 08：续保邮件,10：孕中险承保邮件，11：

孕中险续保邮件
5
cOrderld
V
Y
50

保单号
6
cAmount
N
Y
10,2

保费
7
cUserName
V
Y
50

投保人
8
cProductName
V
Y
SO

产品名称例如：瑞华户外运动综合意外 保障计划，（多个产品名称以分号进行分 割）
9
cTmpIFlag
V
Y
2

贿险标志1是贿险，0非贿险
10
clnsuYear
V
Y
10

保险期间
11
cOrderTm
T
Y
yyyy-MM-dd HH:mm:ss

投保日期
12
cStartTm
T

yyyy-MM-dd HH:mm:ss

保险起期
13
cEndTm
T
Y
yyyy-MM-dd HH:mm:ss

保险止期
14
eSubject
V
Y
50

主题例如："承保邮件”
15
cAttach
arr
N

附件
16
cSex
V
N
10

性别m-男,f-女，续保必填
17
cExpireTm
T
N
yyyy-MM-dd HH:mm:ss

保单满期日，续保必填
18
cProdNo
V
Y
255

产品号（多个以分号进行分割）
19
cSender
V
Y
10

邮件发送方，0代表互联网，1代表核心
3.1.2.返回数据
对应请求返回模型
序号
代码
名称
非空
备注
1
errorCode
返回码
N

2
(?rrorMsg
错误信息

3.1.3.交互范例
3.1.3.1.请求报文
"cToMailAdd":[
IHI
L"cToMailAddCopy":[], "cContenf:
"cType": "01","cStartTm": "2019-08-03 00:00:00",
"cAmount": "239.00","cUserName":"测试"，
"cProductName":"瑞华美瑞宝女性孕育综合医疗保险","cTmpIFlag": "0”，
■,clnsuYear": "106","cOrderTm": "2019 08 03 00:00:00",
"cEndTm": "2020-08-02 24:00:00", "cOrderld":
"eSubject"："承保邮件”，"cAttach ■：(],
"cSex":", "cExpireTm": "cProdNo": "htl006"3.1.3.2.返回报文
例如:
「daia”：r‘erwr€ode":'0000“.-errorMsg":“发送成功"}."siaius": “success") 或者
("ErrorMessage":"邮件类型 cType 不能为空!",”staius"「error”} 或者rdata”:{"crrorCodc”:"4000",-crrorMsg":"邮箱格式不正确 ”},”siauis”:”success"}