双录系统接口规范第一部分

双录系统接口规范详解
原创 已于 2023-09-07 19:03:52 修改 · 291 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#java #数据库 #开发语言 #软件需求

于 2023-09-07 19:01:04 首次发布
本文档旨在规范保险公司与双录系统的交互，明确业务对接字段、接入方式等。介绍了请求和返回参数格式、签名规则、数据加解密方式，还说明了投保单双录状态查询接口和双录任务同步接口的请求与返回情况，使用 Java 进行数据加解密。

双录系统接口规范

  1. 概述

保险销售行为管理系统，简称“双录系统“。

本文档编写目的是为了规范保险公司与双录系统的交互过程， 明确规定业务对接字段、接入方式、接口流程及接口定义。

保险公司的业务数据目前包含银保数据、保险公司数据和非银行类中介机构数据。

  1. 参数说明
    1. 请求参数格式

{

transId:””, //交易流水号
clientCode: ”JL”, //调用系统

sign:””, //签名（字符串）， 以下将说明签名规则

timeStamp:””, //当前时间戳（字符串），毫秒形式

param:””, //业务参数（字符串json形式），详见- 3.业务接口；此项须统一加密，详见- 2.1.4.数据统一加解密方式

event:”” //交易代码（字符串），详见- 2.1.5.业务列表

}

    1. 签名规则

签名 = md5(加密后的参数 + 秘钥 + 时间戳);

sign = md5 (param（加密后） + key + timestamp);

秘钥（key）：Kdis!@#002SL（双方约定，勿修改）

示例：sign = md5(“32A0B538EF4155E811041444EC8B” + “Kdis!@#002SL” + “1597201766737”);
    1. 返回参数格式

{

resCode:””, //返回码（数字）

resMsg:””, //提示信息（字符串）

resBody:”” //具体数据（json字符串）此项将统一加密，详见- 2.1.4.数据统一加解密方式

}

    1. 数据统一加解密方式

重要数据将采用des方式进行加解密，请引入以下java类，进行数据加解密，具体使用方式见类中测试方法：

    1. 业务代码

序号

交易代码

交易名称

备注

110

投保单双录状态查询接口

双录系统接口

111

双录任务同步接口

双录系统接口

112

短信发送接口

113

短信验证码验证接口

21001

代理人信息同步

21002

保单详情同步

114

双录app唤醒链接获取接口

双录系统接口

115

投屏链接状态同步接口

双录系统接口

机构信息同步接口

双录系统接口

116

投保单信息记录接口

117

身份证OBS图片获取

118

龙易保签字信息获取

  1. 业务接口说明
    1. 投保单双录状态查询接口
      1. 简要描述

保险公司需要根据双录任务的状态进行投保流程控制，因此，保险公司需通过该接口进行双录任务的状态查询。

      1. 接口请求

请求URL：

http://XXXX/aidr-front-quisition/third/interface/QUERY_PROPOSAL_STATUS

请求格式：JSON

请求入参：

参数名

是否必选

类型

说明

applicationNo

必选

string

投保单号

请求示例：

{
    "transId":"20210407001",
    "sign":"xxxxxxxxxx",
    "event":"110",
    "clientCode":"SL",
    "param":{//此项需按规则加密
        "applicationNo":"234234"
    }
}
      1. 接口返回

返参说明：

参数名

类型

说明

父节点

resCode

string

统一状态码

-

resMsg

string

统一状态信息

-

resBody

Object

统一返回体

-

doubleRecordStatus

INTEGER

双录状态码0，未录制 1，已录制未上传 2，待质检 3，问题件待审核 4，质检通过 5，问题件下发

resBody

doubleRecordStatusDesc

string

双录状态描述

resBody

返回示例：

{
    "resCode":"0000",
    "resMsg":"成功",
    "resBody":{//此项加密
        "doubleRecordStatus":0,
        "doubleRecordStatusDesc":"未录制"
    }
}
    1. 双录任务同步接口
      1. 简要描述

展业平台投保流程进行到需双录环节时，向双录系统推送保单信息，创建双录任务

      1. 接口请求

请求URL：

http://XXXX/aidr-front-quisition/third/interface/JL_AUTO_CREATE_TASK

请求格式：JSON

请求入参：

参数名

是否必选

类型

说明

码值对应

示例

备注

父节点

applicationNo

必选

string

投保单号

-

20200526000000000000

-

-

userCode

可选

string

代理人工号

-

P0088

-

-

userCertifyType

必选

string

代理人证件类型

-

0

-

-

userCertifyCode

必选

string

代理人证件号

-

130705XXXX281340

-

-

channelCode

必选

string

渠道代码

-

1

-

-

totalFee

必选

string

整单首期保费

-

763

-

-

firstInsuranceCode

必选

string

第一主险代码

-

L11208

-

-

applicantName

必选

string

投保人姓名

-

测试一

-

-

applicantGender

必选

string

投保人性别

先生/女士

先生

-

-

applicantAge

必选

string

投保人年龄

-

20

-

-

applicantBirthday

必选

string

投保人生日

-

1997-07-28

-

-

applicantCertifyType

必选

string

投保人证件类型

-

0

-

-

applicantCertifyCode

必选

string

投保人证件号

-

130705199707281340

-

-

selfInsurance

必选

string

是否为自保件

Y:是 N:否

Y

-

-

isArtifactCreate

必选

string

是否手工单

0:非手工单 1:手工单

-

直接传0

-

airSig

必选

string

投保链接

-

-

-

-

taskOrigin

必选

string

任务来源

-

展业平台

-

currentPrice

可选

String

现价

带单位

insurantInfoList

必选

array

被保人信息集合

-

-

-

-

insuredRelationship

必选

string

投被保人关系

0被投保人为一人 1父母 2其他 3子女 4配偶

0

-

insurantInfoList

insurantName

必选

string

被保人姓名

-

测试二

-

insurantInfoList

insurantAge

必选

string

被保人年龄

-

20

-

insurantInfoList

insurantBirthday

必选

string

被保人生日

-

1997-08-29

-

insurantInfoList

insurantGender

必选

string

被保人性别

先生/女士

先生

-

insurantInfoList

insurantCertifyType

必选

string

被保人证件类型

-

0

-

insurantInfoList

insurantCertifyCode

必选

string

被保人证件号

-

130705199708291236

-

insurantInfoList

insuranceInfoList

必选

array

险种信息集合（包含各主险及其附加险）

-

-

-

insurantInfoList

insuranceName

必选

string

险种名称

-

终身寿险

-

insuranceInfoList

insuranceCode

必选

string

险种代码

-

11010

-

insuranceInfoList

insuranceType

必选

string

险种级别

1:主险 2:附加险

1

-

insuranceInfoList

periodPrem

必选

string

期交保费

-

88

-

insuranceInfoList

coverageYear

必选

string

保险期间

-

15年/至60周岁/终身

带单位“年/至-周岁”

insuranceInfoList

chargeType

必选

string

缴费方式

期缴:Q 趸交:D

Q

-

insuranceInfoList

chargeYear

可选

string

缴费期间

-

10年（趸交）

带单位“年”

insuranceInfoList

instalment

可选

string

期缴方式

月缴:1/年缴:12/季缴:3/半年缴:6

1

-

insuranceInfoList

请求示例：

{
    "transId":"20210407001",
    "sign":"xxxxxxxxxx",
    "event":"111",
    "clientCode":"SL",
"param":{//此项需按规则加密

        "currentPrice":"500元",

        "applicationNo":"A11111222223333",
        "userCode":"P0090",
        "userCertifyType":"0",
        "userCertifyCode":"130705199707281340",
        "channelCode":"02",
        "totalFee":"100",
        "firstInsuranceCode":"12030",
        "applicantName":"徐",
        "applicantGender":"女士",
        "applicantAge":"23",
        "applicantCertifyType":"0",
        "applicantCertifyCode":"130781234",
        "selfInsurance":"Y",
        "isArtifactCreate":"N",
        "applicantBirthday":"1997-07-28",
        "airSig":"https://www.baidu.com",
        "taskOrigin":"展业平台",
        "insurantInfoList":[
            {
                "insuredRelationship":"4",
                "insurantName":"王",
                "insurantAge":"23",
                "insurantBirthday":"1997-08-29",
                "insurantGender":"先生",
                "insurantCertifyType":"0",
                "insurantCertifyCode":"1307058291234",
                "insuranceInfoList":[
                    {
                        "insuranceName":"终身寿险",
                        "insuranceCode":"11111",
                        "insuranceType":"1",
                        "periodPrem":"100",
                        "chargeType":"D",
                        "chargeYear":"",
                        "coverageYear":"终身",
                        "instalment":"",
                        "hesitatePeriod":"十天"
                    }
                ]
            }
        ]
    }
}
      1. 接口返回

返回参数：

参数名

类型

说明

resCode

string

统一状态码

resMsg

string

统一状态信息

返回成功示例：

1、新建任务

{
    "resCode":"0000",
    "resMsg":"新建任务成功",
    "resBody":{}

}

2、更新任务

{
    "resCode":"5016",
    "resMsg":"更新任务成功",
    "resBody":{}
}

3、下发问题件并新建任务

{
    "resCode":"5015",
    "resMsg":"重新生成任务成功",
    "resBody":{}

}

返回失败示例：

1、新建任务

{
    "resCode":"5001",
    "resMsg":"新建任务失败",
"resBody":{}
}

2、更新任务

{
    "resCode":"5014",
    "resMsg":"更新任务失败",
    "resBody":{}

}

3、下发问题件并新建任务

{
    "resCode":"5013",
    "resMsg":"重新生成任务失败",
    "resBody":{}

}

4、双录未查询到代理人

 {
    "resCode":"5012",
    "resMsg":"当前代理人尚未同步到双录系统中",
    "resBody":{}

}

manclub
关注
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值