文档中心 > API类目 > 场景金融保险

qimen.alibaba.finance.insurance.policy.insuremulti (保险平台投保接口)

保险平台投保接口，支持多被保人、多标的物

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
identifier	String	必须	010101004178221080402170019		唯一识别id，幂等字段
productCode	String	必须	TMALL_EMPLOYERS_DUTY_INSURANCE		产品码
insureId	String	必须	010101001178221080402961044		保险平台投保单据号
amount	String	必须	1018.0		保额，单位元
premium	String	必须	6.36		保费，单位元
currency	String	必须	CNY		币种
insureTime	String	必须	2024-03-13 15:23:28		投保时间，格式“yyyy-MM-dd HH:mm:ss”
effectTime	String	必须	2024-03-13 15:23:28		保险起期，格式“yyyy-MM-dd HH:mm:ss”
expireTime	String	必须	2024-03-13 15:23:28		保险止期，格式“yyyy-MM-dd HH:mm:ss”
applicantCompanyInfo	ApplicantCompanyInfo	可选			投保人公司信息
└ userId String 可选 33223xxxxx 投保人id └ companyName String 可选 xx市xx公司公司名称 └ companyPhone String 可选 130xxx 公司联系电话 └ companyLicenseType String 可选 UNITY 证件类型:UNITY/GENERAL └ companyLicenseNo String 可选 9xxxxxxxxxxY74N 公司证件号
personalSubjectMatterInfoList	PersonSubjectMatterInfo []	可选		最大列表长度：999	标的物列表：人
└ subjectMatterName String 可选张三标的物姓名 └ subjectMatterId String 可选 1234 标的物id（身份证号、aliId）
insuredPersonalInfoList	InsuredPersonalInfo []	可选		最大列表长度：999	被保人（个人类型）
└ userId String 可选 2944982885 个人ID └ personLicenseType String 可选 ALI 证件号类型。个人证件号类型 ALI:阿里ID IDENTITY_CARD:身份证 PASSPORT:护照 └ personLicenseNo String 可选 2944982885 证件号 └ personName String 可选 t_1500860306662_0776 个人姓名
paymentChannelVoucher	String	可选	2022xxx		支付宝流水号
attrs	Attrs	可选			扩展字段
└ serviceOrderNo String 可选 12345 服务订单号 └ jobType String 可选非高空作业人员工种类型，区分非高空作业人员、高空作业维修人员、高空作业安装人员 └ orderServiceAddress String 可选 xx小区xx幢xx室订单服务地址，上门地址 └ dispatchedWorkersNum String 可选 3 派工人次，服务单中安装人员的数量 └ dispatchTime String 可选 2024-03-13 15:23:28 派工时间，服务订单发起时间，作为投保时间；服务单预约成功时间 └ departureAddress String 可选 xx小区xx幢xx室订单出发地地址，若无法获取真实地址，取门店地址 └ returnAddress String 可选 xx小区xx幢xx室订单结束后返回地址，若无法获取真实地址，取门店地址
access_token	String	可选	uuofgfisg16715x		token

响应参数

名称	类型	示例值	描述
context	Context		返回内容
└ policyNo String PBDI20211201Q000Fxxxx 保司保单号 └ policyFileUrl String http://www.xxx.com.cn/xx/policydownload/downloadurl.do?platfromcodes=CPI001462&policyNo=A807627BC8BBC72B386B571FA544D7B33A123719AA8B835455993F67A9A6EAF6&insuredID=xx 电子保单链接
responseMessage	String	OK	返回描述
responseCode	String	SUCCESS	返回码

请求示例

{"identifier":"010101004178221080402170019","insureTime":"2024-03-13 15:23:28","amount":"1018.0","insuredPersonalInfoList":[{"personName":"t_1500860306662_0776","personLicenseNo":"2944982885","personLicenseType":"ALI","userId":"2944982885"}],"attrs":{"serviceOrderNo":"12345","dispatchTime":"2024-03-13 15:23:28","dispatchedWorkersNum":"3","departureAddress":"xx小区xx幢xx室","jobType":"非高空作业人员","orderServiceAddress":"xx小区xx幢xx室","returnAddress":"xx小区xx幢xx室"},"access_token":"uuofgfisg16715x","productCode":"TMALL_EMPLOYERS_DUTY_INSURANCE","premium":"6.36","expireTime":"2024-03-13 15:23:28","personalSubjectMatterInfoList":[{"subjectMatterId":"1234","subjectMatterName":"张三"}],"insureId":"010101001178221080402961044","currency":"CNY","effectTime":"2024-03-13 15:23:28","paymentChannelVoucher":"2022xxx","applicantCompanyInfo":{"companyLicenseType":"UNITY","companyPhone":"130xxx","companyName":"xx市xx公司","userId":"33223xxxxx","companyLicenseNo":"9xxxxxxxxxxY74N"}}

响应示例

{
    "context":{
        "policyNo":"PBDI20211201Q000Fxxxx",
        "policyFileUrl":"http:\/\/www.xxx.com.cn\/xx\/policydownload\/downloadurl.do?platfromcodes=CPI001462&policyNo=A807627BC8BBC72B386B571FA544D7B33A123719AA8B835455993F67A9A6EAF6&insuredID=xx"
    },
    "responseMessage":"OK",
    "responseCode":"SUCCESS"
}

验签示例

{"responseMessage":"Illegal request","responseCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部