淘宝开放平台

请求地址：

环境	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，幂等字段
insureTime	String	必须	2021-08-04 15:23:28	yyyy-MM-dd HH:mm:ss
amount	String	必须	1018.0	保额
premiumRate	String	可选	0.00625	保费费率
premiumOfCny	String	必须	6.36	人民币保额费
applicantPayAccount	String	可选	ALIBABA	投保人支付ID
insurePeriod	Number	可选	40	保期
productCode	String	必须	PERFORMANCE_SURETY_BONDS	产品码
expireTime	String	必须	2021-09-12 23:59:59	保险结束日期
premium	String	必须	6.36	保费
amountOfCny	String	可选	1018.0	人民币保额
orderSubjectMatterInfo	OrderSubjectMatterInfo	可选		标的物信息
└ sellerId String 可选 3322312336 卖家id └ orderAmount String 可选 101800 订单金额 └ subjectMatterCategory String 可选包装订单类型 └ sellerName String 可选 xx智能XX 卖家登录id └ subjectMatterId String 可选 2003576043935988528 标的物id └ buyerId String 可选 2944982885 买家id └ buyerName String 可选 t_1500860306662_0776 买家登录昵称 └ subjectMatterName String 可选外贸飞机盒定制印刷包装盒快递打包外箱瓦楞牛皮纸盒订做纸箱定做标的物名称 └ buyer_open_uid String 可选 123123 用户openid
insureId	String	必须	010101001178221080402961044	本地业务单据号
currency	String	必须	CNY	币种
currencyRate	String	必须	1.0	汇率
effectTime	String	必须	2021-08-04 15:23:26	生效时间
insuredPersonalInfo	InsuredPersonalInfo	可选		被保险人（个人类型）
└ personName String 可选 t_1500860306662_0776 个人姓名 └ personLicenseNo String 可选 2944982885 证件号 └ personLicenseType String 可选 ALI 证件号类型。个人证件号类型 ALI:阿里ID IDENTITY_CARD:身份证 PASSPORT:护照 └ userId String 可选 2944982885 个人ID
insuredCompanyInfo	InsuredCompanyInfo	可选		被保人(公司类型)
└ companyAddress String 可选 test 地址 └ companyEmail String 可选 test 有些 └ companyPhone String 可选 344555 电话 └ legalPersonLicenseNo String 可选 23423423423 法人证件 └ legalPersonName String 可选张三法人姓名 └ companyLicenseType String 可选 UNITY UNITY:统一社会信用证码 GENERAL：工商注册号 └ companyLicenseNo String 可选 91234535345435 公司证件号 └ companyName String 可选 test 公司名称 └ userId String 可选 123 投保人id
applicantPersonalInfo	ApplicantPersonalInfo	可选		投保人（个人类型）
└ personAddress String 可选 33xxxx 地址 └ personEmail String 可选 abc@aa.com 邮箱 └ personPhone String 可选 139231232323 电话 └ personLicenseType String 可选 IDENTITY_CARD 个人证件号类型 ALI:阿里ID IDENTITY_CARD:身份证 PASSPORT:护照 └ personLicenseNo String 可选 3321231232312342432 证件类型 └ personName String 可选张三姓名 └ userId String 可选 123123 id
applicantCompanyInfo	ApplicantCompanyInfo	可选		投保人公司信息
└ companyLicenseType String 可选 UNITY 证件类型:UNITY/GENERAL └ companyName String 可选 xx市xx公司公司名称 └ userId String 可选 33223xxxxx 投保人id └ companyLicenseNo String 可选 9xxxxxxxxxxY74N 公司证件号 └ legalPersonLicenseNo String 可选 4****************3 法人证件号 └ legalPersonName String 可选王XX 法人姓名
attrs	Attrs	可选		扩展
└ premiumFundStreamNo String 可选 2021080410002001660575461643 支付流水id └ agreeOnSendTime String 可选 1628870399000 约定发货时间-交期险必传 └ insuranceTypes String 可选 QUALITY,DELIVERY,APPEARANCE 险种，逗号分割

名称	类型	示例值	描述
errorCode	String	SUCCESS	错误码
context	Context		返回内容
└ policyFileUrl String http://www.xxx.com.cn/xx/policydownload/downloadurl.do?platfromcodes=CPI001462&policyNo=A807627BC8BBC72B386B571FA544D7B33A123719AA8B835455993F67A9A6EAF6&insuredID=xx 电子保单链接 └ policyNo String PBDI20211201Q000Fxxxx 保司保单号
errorMessage	String	OK	错误描述
success	String	true	请求是否成功

{"identifier":"010101004178221080402170019","insureTime":"2021-08-04 15:23:28","amount":"1018.0","applicantPersonalInfo":{"personPhone":"139231232323","personName":"张三","personLicenseNo":"3321231232312342432","personAddress":"33xxxx","personEmail":"abc@aa.com","personLicenseType":"IDENTITY_CARD","userId":"123123"},"premiumRate":"0.00625","premiumOfCny":"6.36","attrs":{"insuranceTypes":"QUALITY,DELIVERY,APPEARANCE","premiumFundStreamNo":"2021080410002001660575461643","agreeOnSendTime":"1628870399000"},"applicantPayAccount":"ALIBABA","insuredPersonalInfo":{"personName":"t_1500860306662_0776","personLicenseNo":"2944982885","personLicenseType":"ALI","userId":"2944982885"},"insurePeriod":40,"productCode":"PERFORMANCE_SURETY_BONDS","expireTime":"2021-09-12 23:59:59","premium":"6.36","insuredCompanyInfo":{"companyLicenseType":"UNITY","companyEmail":"test","companyPhone":"344555","companyAddress":"test","companyName":"test","userId":"123","legalPersonLicenseNo":"23423423423","companyLicenseNo":"91234535345435","legalPersonName":"张三"},"amountOfCny":"1018.0","orderSubjectMatterInfo":{"buyer_open_uid":"123123","sellerId":"3322312336","orderAmount":"101800","subjectMatterCategory":"包装","sellerName":"xx智能XX","subjectMatterId":"2003576043935988528","buyerId":"2944982885","buyerName":"t_1500860306662_0776","subjectMatterName":"外贸飞机盒定制印刷包装盒快递打包外箱瓦楞牛皮纸盒订做纸箱定做"},"insureId":"010101001178221080402961044","currency":"CNY","currencyRate":"1.0","effectTime":"2021-08-04 15:23:26","applicantCompanyInfo":{"companyLicenseType":"UNITY","companyName":"xx市xx公司","userId":"33223xxxxx","companyLicenseNo":"9xxxxxxxxxxY74N","legalPersonLicenseNo":"4****************3","legalPersonName":"王XX"}}

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

{"success":"不等于true","errorMessage":"Illegal request","errorCode":"sign-check-failure"}

错误码	错误描述	解决方案
isp.http-read-timeout

错误码查询工具 SDK下载

场景金融保险

qimen.alibaba.finance.insurance.policy.issuing (场景金融保险出单交互接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ