[关闭]
@tenbentYun 2020-02-04T08:57:16.000000Z 字数 6716 阅读 504

商户中心保单出单-同步保单库流程

腾保商户中心


1.通过商户中心对接的产品出单

通过商户中心对接的产品承保统一出单时调用MerchantOpenService.acceptInsurance()方法

出单流程

1.根据「外部订单号」在「商户交易中心」查询订单是否存在
方法:订单详情 TenbentMerchantTradeClient.detail()
对应表:mongoDBmerchant_order

2.调用「产品中心」出单接口
方法:出单 TenbentPbNocarinsureClient.acceptInsurance()

非实时出单

根据「订单号」修改「商户交易中心」订单状态为「待出单」
方法:更新订单状态 OrderService.updateStatus()
对应表:mongoDBmerchant_order

实时出单

3.根据「产品中心」出单接口是否返回「保单号」判断是否出单成功

失败

修改「商户交易中心」订单状态为「出单失败」
方法:更新订单状态 OrderService.updateStatus()
对应表:mongoDBmerchant_order

成功

调用「商户交易中心」的「创建保单」
方法:创建保单 TenbentMerchantTradeClient.createPolicy()
对应表:mongoDBmerchant_policy

更新订单字段及状态「出单成功」
方法:更新订单 OrderService.updateOrder()
方法:更新订单状态 OrderService.updateStatus()
对应表:mongoDBmerchant_order

最后将保单存入待同步的保单表中(初始状态为“0:未同步”)
方法:PolicySyncRepository.save()
对应表:mongoDBpolicy_sync

2.保单同步「保单库」

保单出单完成后,定时任务「每10分钟」获取未同步保单,执行保单同步任务,同步到保单库,方法入口PolicySyncJobHandler.execute()定时任务可通过定时任务项目随时手动调整执行时间

同步流程

1.获得所有需要同步的保单

2.检查所有待同步保单是否存在

方法:
订单详情 TenbentMerchantTradeClient.detail()
对应表:mongoDBmerchant_order
保单详情 TenbentMerchantTradeClient.policyDetail()
对应表:mongoDBmerchant_policy

3.区分「腾保商户」与「非腾保商户」,腾保商户没有顾问手机号(uid),默认为线上顾问陈炜的手机号:15384029453

4.根据uid查询顾问信息
方法:根据手机号获取顾问信息只查网销中心 TenbentNscAdminClient.addUserAuthority()

5.同步小程序保单

调用 NSC保单录入编辑和CRM保单自动导入 JiadaoMiniproClient.policySync()

6.同步成功之后,更新「同步成功状态」(即:修改mongoDBpolicy_sync表的status1

3.第三方系统方法

3.1 商户中心订单管理

3.1.1 订单详情

GET /api/merchant/order/detail/{orderNo}
orderNo:订单号

响应体

详见 MerchantResponse

3.1.2 更新订单

PUT /api/merchant/order/updateOrder

请求体
属性 类型 是否必传 含义
OrderUpdateDTO OrderUpdateDTO 订单更新DTO
响应体

详见 MerchantResponse

3.1.3 更新订单状态

PUT /api/merchant/order/updateStatus

请求体
属性 类型 是否必传 含义
orderNo String 订单号
orderStatus Integer 订单状态
响应体

详见 MerchantResponse

3.1.4 创建保单

POST /api/merchant/policy/createPolicy

请求体
属性 类型 是否必传 含义
MerchantPolicyDTO MerchantPolicyDTO 创建保单.请求对象
响应体

详见 MerchantResponse

3.1.5 保单详情

GET /api/merchant/policy/detail/{policyId}
policyId:保单ID

响应体

详见 MerchantResponse

3.2 产品中心

3.2.1 承保(即:出单)

POST /api/noCarInsure/accept/insurance

请求体
属性 类型 是否必传 含义
AcceptInsuranceRequest AcceptInsuranceRequest 承保.请求对象
响应体

详见 MerchantResponse

3.3 JiadaoMinipro

3.3.1 NSC保单录入编辑和CRM保单自动导入

POST /api/policy/nsc

请求体
属性 类型 是否必传 含义
PolicyNscDTO PolicyNscDTO 保单同步.请求对象
响应体

详见 JdResponse

3.4 网销中心「NSC」

3.4.1 根据手机号获取顾问信息(只查网销中心)

GET /api/user/nsc/{mobile_no}
mobile_no:手机号

响应体

详见 UserDTO

4.对象视图

ProductCode

保险产品编码

参照com.tenbent.merchant.service.product.domain.enums.ProductCode

AcceptInsuranceRequest

通过商户中心对接的产品出单时的请求对象

属性 类型 是否必传 含义
productCode ProductCode 产品编码
channelId String 渠道ID
sign String 签名
outOrderNo String 外部订单号(标识渠道订单唯一标识,渠道要保证本渠道唯一性)
paymentSerialNumber String 支付流水号(即:交易号)「现康惠保必填」
orderNo String 订单号
healthNo String 补充健康问卷批次号或者智能核保问卷号「现康惠保使用」
extension String 额外增加的部分

MerchantResponse

商户中心统一封装response类

属性 类型 含义
code String 业务状态码
errorMsg String 返回的信息
result T 返回的数据
success boolean 是否成功

JdResponse

驾到统一封装response类

属性 类型 含义
code String 业务状态码
msg String 返回的信息
result T 返回的数据

OrderDetailDTO

订单详情DTO

属性 类型 含义
id Integer 订单id
orderNo String 订单号
payOrderNo String 支付流水号
merchantId String 商户id
merchantNo String 商户号
productId String 产品ID 产品中心
productCode String 产品code
packCode String 套餐计划
productName String 产品名称
companyId String 保险公司ID
companyName String 保险公司名称
orderMerchantSource Integer 订单商户平台来源 0:api ; 1 h5 2: 全部 3: 易保
orderStatus Integer 订单状态(0:待核保,1:核保失败,2:待支付,3:取消支付,4:待出单,5:出单成功,6:出单失败,7:已退款 8:支付成功,9:验证成功,10:验证失败,11:签约成功,2:签约失败
orderCount Integer 购买产品数量
unitPrice BigDecimal 单价
discountType String 优惠方式 0:红包券 1现金抵扣券 2 满减等
discountValue BigDecimal 优惠面额值 如 10元
orderAmount BigDecimal 订单金额
orderPayAmount BigDecimal 实际支付金额
orderTime Date 下单时间
paymentTime Date 支付时间
remark String 备注
uid String 用户id
phone String 用户电话
outOrderNo String 外部订单号
policyId Integer 保单id
holderInfo String 投保人信息 json
insuredInfo String 主被保人信息 json
safeguardInfo String 套餐信息 json
tablesInfo String 表单信息 json
healthyInfo String 健康告知信息json
otherInfo String 其他信息 json
sendInfo String 寄送信息
payInfo String 支付信息 json
uwInfo String 核保信息 json
legalBeneficiary Integer 是否为法定受益人 (1 是法定受益人 0 指定受益人)
skuInfo String sku信息 json
beneficiaryInfo String 收益人信息 json
renewalPaymentAccountInfo String 续期缴费账户信息 json
hesitationPeriod String 犹豫期
safeguardDate String 保障期限
failedReason String 失败原因
gmtModified String 更新时间
smartUnderwritingState String 智能核保状态

OrderUpdateDTO

订单更新DTO

属性 类型 含义
orderNo String 订单号
orderCount Integer 购买产品数量
unitPrice String 单价
discountType String 优惠方式 0:红包券 1现金抵扣券 2 满减等
discountValue BigDecimal 优惠面额值 如 10元
remark String 备注
holderInfo String 投保人信息 json
insuredInfo String 主被保人信息 json
safeguardInfo String 套餐信息 json
tablesInfo String 表单信息 json
healthyInfo String 健康告知信息json
otherInfo String 其他信息 json
sendInfo String 寄送信息
payInfo String 支付信息 json
uwInfo String 核保信息 json
legalBeneficiary Integer 是否为法定受益人 (1 是法定受益人 0 指定受益人)
skuInfo String sku信息 json
policyId Integer 保单id
brokerageInfo String 商户产品佣金信息 json
phone String 用户电话
beneficiaryInfo String 收益人信息 json
renewalPaymentAccountInfo String 续期缴费账户信息 json
outOrderNo String 外部订单号
failedReason String 失败原因
smartUnderwritingState String 智能核保状态

MerchantPolicyDTO

创建保单请求

属性 类型 含义
id Integer 保单id
merchantId String 商户id
merchantNo String 商户号
orderNo String 订单号
policyNo String 保单号
holderInfo String 投保人信息 json
insuredInfo String 主被保人信息 json
safeguardInfo String 套餐信息 json
tablesInfo String 表单信息 json
healthyInfo String 健康告知信息json
otherInfo String 其他信息 json
policyAmount BigDecimal 总保费
productId Integer 主险产品id
outDate String 出单时间
startDate String 生效时间
legalBeneficiary Integer 是否为法定受益人 (1 是法定受益人 0 指定受益人)
policyStatus Integer 保单状态
settlementStatus Integer 结算状态
skuInfo String sku信息 json
beneficiaryInfo String 收益人信息 json
renewalPaymentAccountInfo String 续期缴费账户信息 json
policySource String 保单来源 2:默认商户中心 3:易保
productCode String 产品code
productName String 产品名称

PolicyNscDTO

保单同步请求

属性 类型 含义
annualPremium String 年缴保费
attaches List<Attache> 保单附件
benefits List<Benefit> 受益人信息,如果为空的话为法定
companyName String 保险公司名称
companyPhone String 保险公司电话
guaranteeItems List<GuaranteeItem> 保障项目
guaranteeStartTime Date 保障生效时间
guaranteeUnit String 保障期限单位:YEAR,年;MONTH,月,DAY,天;AGE,岁 = ['YEAR', 'MONTH', 'DAY', 'AGE']
guaranteeYears String 保障期限
holderPerson PolicyUserInfo 投保人信息
insuranceType List 保障类型 0:重疾险 1:医疗险 2:意外险 3:人寿险 4:养老险 5:教育险 6:理财险
insuredPersons List<PolicyUserInfo> 被保人信息
nsc PolicyNsc 保单的NSC信息
paymentYears String 交费年限
policyId String 保单ID
policyNo String 保单号
productCode String 商户中心的产品Code,根据该Code查询保险公司
productName String 保险产品名称
remark String 备注
total BigDecimal 总保额

PolicyUserInfo

属性 类型 含义
address Address 联系地址
birthday String 出生日期
email String 邮箱
height String 身高:cm 支持小数
idNo String 身份证号
income String 年收入:元
mobileNo String 手机号
occupation String 职业
realName String 真实姓名
relation String 和投保人关系:0,本人;1,丈夫;2,妻子;3,父亲;4,母亲;5,儿子;6,女儿
sex String 性别 = ['MALE', 'FEMALE']
weight String 体重:kg 支持小数

GuaranteeItem

保障项目

属性 类型 含义
amount String 保障额
item String 保障项

Benefit

受益人信息

属性 类型 含义
name String 保障额
ratio String 保障项
relation Integer 被保人关系:1,丈夫;2,妻子;3,父亲;4,母亲;5,儿子;6,女儿

Attache

文件信息

属性 类型 含义
fileName String 文件名称
fileType String 文件类型
fileUrl String 文件路径

PolicyNsc

保单的NSC信息

属性 类型 含义
inputChannel String 录入渠道:NSC,网销支撑系统;MC_TB,商户中心——腾保;MC,商户中心——非腾保
inputType String 录入方式:BATCH,批量录入;AUTO:自动录入;MANUAL:手动录入
inputUserId String 录单人ID,jiadao的LoginId
outPlatform String 出单平台
outTime String 出单时间
outUserId String 出单人ID,jiadao的LoginId
outUserName String 出单人姓名
outUserPhone String 出单人手机号

UserDTO

用户信息DTO

属性 类型 含义
loginId String
mobileNo String 手机号
realName String 真实姓名
idNo String 身份证号
cerNo String 执业证号
jiadaoLoginId String 驾到LoginId
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注