双录系统接口规范
保险销售行为管理系统,简称“双录系统“。
本文档编写目的是为了规范保险公司与双录系统的交互过程, 明确规定业务对接字段、接入方式、接口流程及接口定义。
保险公司的业务数据目前包含银保数据、保险公司数据和非银行类中介机构数据。
{
transId:””, //交易流水号
clientCode: ”JL”, //调用系统
sign:””, //签名(字符串), 以下将说明签名规则
timeStamp:””, //当前时间戳(字符串),毫秒形式
param:””, //业务参数(字符串json形式),详见- 3.业务接口;此项须统一加密,详见- 2.1.4.数据统一加解密方式
event:”” //交易代码(字符串),详见- 2.1.5.业务列表
}
签名 = md5(加密后的参数 + 秘钥 + 时间戳);
sign = md5 (param(加密后) + key + timestamp);
秘钥(key):Kdis!@#002SL(双方约定,勿修改)
示例:sign = md5(“32A0B538EF4155E811041444EC8B” + “Kdis!@#002SL” + “1597201766737”);
{
resCode:””, //返回码(数字)
resMsg:””, //提示信息(字符串)
resBody:”” //具体数据(json字符串)此项将统一加密,详见- 2.1.4.数据统一加解密方式
}
重要数据将采用des方式进行加解密,请引入以下java类,进行数据加解密,具体使用方式见类中测试方法:
序号 | 交易代码 | 交易名称 | 备注 |
| 110 | 投保单双录状态查询接口 | 双录系统接口 |
| 111 | 双录任务同步接口 | 双录系统接口 |
| 112 | 短信发送接口 | |
| 113 | 短信验证码验证接口 | |
| 21001 | 代理人信息同步 | |
| 21002 | 保单详情同步 | |
| 114 | 双录app唤醒链接获取接口 | 双录系统接口 |
| 115 | 投屏链接状态同步接口 | 双录系统接口 |
| 机构信息同步接口 | 双录系统接口 | |
| 116 | 投保单信息记录接口 | |
| 117 | 身份证OBS图片获取 | |
| 118 | 龙易保签字信息获取 |
保险公司需要根据双录任务的状态进行投保流程控制,因此,保险公司需通过该接口进行双录任务的状态查询。
请求URL:
http://XXXX/aidr-front-quisition/third/interface/QUERY_PROPOSAL_STATUS
请求格式:JSON
请求入参:
参数名 | 是否必选 | 类型 | 说明 |
applicationNo | 必选 | string | 投保单号 |
请求示例:
|
返参说明:
参数名 | 类型 | 说明 | 父节点 |
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":"未录制" } } |
展业平台投保流程进行到需双录环节时,向双录系统推送保单信息,创建双录任务
请求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 |
请求示例:
|
返回参数:
参数名 | 类型 | 说明 |
resCode | string | 统一状态码 |
resMsg | string | 统一状态信息 |
返回成功示例:
1、新建任务
|
2、更新任务
|
3、下发问题件并新建任务
|
返回失败示例:
1、新建任务
|
2、更新任务
|
3、下发问题件并新建任务
|
4、双录未查询到代理人
|