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

qimen.alibaba.finance.insurance.policy.issuing.new (机构投保出单接口)

场景金融向机构请求投保出单。

公共参数

请求地址：

环境	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	必须	PERFORMANCE_SURETY_BONDS	产品码
insureId	String	必须	010101001178221080402961044	本地业务单据号
amount	String	必须	1018.0	保额
amountOfCny	String	可选	1018.0	人民币保额
currency	String	必须	CNY	币种
currencyRate	String	必须	1.0	汇率
insureTime	String	必须	2021-08-04 15:23:28	yyyy-MM-dd HH:mm:ss
effectTime	String	必须	2021-08-04 15:23:26	生效时间
insurePeriod	Number	可选	40	保期
expireTime	String	必须	2021-09-12 23:59:59	保险结束日期
premium	String	必须	6.36	保费
premiumRate	String	可选	0.00625	保费费率
premiumOfCny	String	必须	6.36	人民币保额费
applicantPayAccount	String	可选	ALIBABA	投保人支付ID
insuredPayAccount	String	可选	123123	被保险人的支付账户ID，一般是支付宝ID
orderSubjectMatterInfo	OrderSubjectMatterInfo	可选		标的物信息
└ sellerId String 可选 3322312336 卖家id └ orderAmount String 可选 101800 订单金额 └ orderTime String 可选 20211002 12:00:00 订单交易时间 └ subjectMatterCategory String 可选包装订单类型 └ sellerName String 可选 xx智能XX 卖家登录id └ subjectMatterId String 可选 2003576043935988528 标的物id └ buyerId String 可选 2944982885 买家id └ buyerName String 可选 t_1500860306662_0776 买家登录昵称 └ subjectMatterName String 可选外贸飞机盒定制印刷包装盒快递打包外箱瓦楞牛皮纸盒订做纸箱定做标的物名称 goodsItemList GoodsItemDTO [] 可选商品详情列表 └ itemPrice String 可选 100.00 单价 └ itemType String 可选服饰商品条目类型 └ itemQuantity Number 可选 10 商品条目商品数量 └ itemCode String 可选 sku123123 skuId └ itemDesc String 可选上衣商品条目描述 └ itemUrlList String [] 可选 itemUrl url └ itemCurrency String 可选 CNY 商品币种 └ itemProperty String 可选订制品商品附件信息 └ logisticCompany String 可选 shunfeng 物流公司 └ logisticNo String 可选 123 物流单号 └ orderType String 可选 PRODUCT,LOGISTICS 订单类型 orderPaymentStreamInfo OrderPaymentStreamInfo 可选标的物支付信息 └ payCurrency String 可选 CNY 支付币种 └ paymentStreamVoucher String 可选 202400000000 支付流水单号 └ payAmount String 可选 10.0 支付金额 └ currencyRate String 可选 1.00 汇率 └ payTime String 可选 2021-09-12 23:59:59 支付时间 └ orderAmountCurrency String 可选 CNY 订单币种 └ buyer_open_uid String 可选 1231123 用户openId
applicantPersonalInfo	ApplicantPersonalInfo	可选		投保人（个人类型）
└ personPhone String 可选 139231232323 电话 └ personName String 可选张三姓名 └ personLicenseNo String 可选 3321231232312342432 个人证件号类型 ALI:阿里ID IDENTITY_CARD:身份证 PASSPORT:护照 └ personAddress String 可选 33xxxx 地址 └ personEmail String 可选 abc@aa.com 邮箱 └ personLicenseType String 可选 IDENTITY_CARD 证件类型 └ userId String 可选 123123 id
applicantCompanyInfo	ApplicantCompanyInfo	可选		投保人公司信息
└ legalPersonLicenseType String 可选身份证法人证件类型 └ companyLicenseType String 可选 UNITY 证件类型:UNITY/GENERAL └ companyName String 可选 xx市xx公司公司名称 └ userId String 可选 33223xxxxx 投保人id └ companyLicenseNo String 可选 9xxxxxxxxxxY74N 公司证件号 └ legalPersonLicenseNo String 可选 4****************3 法人证件号 └ legalPersonName String 可选王XX 法人姓名 └ companyAddress String 可选 xxx 公司地址 └ companyPhone String 可选 130xxx 公司联系电话
insuredPersonalInfo	InsuredPersonalInfo	可选		被保险人（个人类型）
└ personName String 可选 t_1500860306662_0776 个人姓名 └ personLicenseNo String 可选 2944982885 证件号 └ personLicenseType String 可选 ALI 证件号类型。个人证件号类型 ALI:阿里ID IDENTITY_CARD:身份证 PASSPORT:护照 └ userId String 可选 2944982885 个人ID
insuredCompanyInfo	InsuredCompanyInfo	可选		被保人(公司类型)
└ legalPersonLicenseType String 可选身份证法人证件类型 └ companyLicenseType String 可选 UNITY UNITY:统一社会信用证码 GENERAL：工商注册号 └ companyEmail String 可选 test 邮箱 └ companyPhone String 可选 344555 电话 └ companyAddress String 可选 test 地址 └ companyName String 可选 test 公司名称 └ userId String 可选 123 投保人id └ legalPersonLicenseNo String 可选 23423423423 法人证件 └ companyLicenseNo String 可选 91234535345435 公司证件号 └ legalPersonName String 可选张三法人姓名
attrs	Attrs	可选		扩展

personalSubjectMatterInfo	PersonSubjectMatterInfo	可选		标的物：人
└ subjectMatterId String 可选 1234 标的物id └ subjectMatterName String 可选张三标的物名称
paymentChannelVoucher	String	可选	2022xxx	支付宝流水号
payTime	String	可选	2023-12-11 12:23:34	保费支付流水
access_token	String	可选	uuofgfisg16715x	token

响应参数

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

请求示例

{"insureTime":"2021-08-04 15:23:28","payTime":"2023-12-11 12:23:34","insuredPayAccount":"123123","premiumRate":"0.00625","premiumOfCny":"6.36","insuredPersonalInfo":{"personName":"t_1500860306662_0776","personLicenseNo":"2944982885","personLicenseType":"ALI","userId":"2944982885"},"insurePeriod":40,"premium":"6.36","insuredCompanyInfo":{"legalPersonLicenseType":"身份证","companyLicenseType":"UNITY","companyEmail":"test","companyPhone":"344555","companyAddress":"test","companyName":"test","userId":"123","legalPersonLicenseNo":"23423423423","companyLicenseNo":"91234535345435","legalPersonName":"张三"},"orderSubjectMatterInfo":{"logisticNo":"123","orderType":"PRODUCT,LOGISTICS","buyer_open_uid":"1231123","logisticCompany":"shunfeng","orderAmountCurrency":"CNY","sellerName":"xx智能XX","subjectMatterId":"2003576043935988528","buyerId":"2944982885","buyerName":"t_1500860306662_0776","subjectMatterName":"外贸飞机盒定制印刷包装盒快递打包外箱瓦楞牛皮纸盒订做纸箱定做","sellerId":"3322312336","orderAmount":"101800","orderTime":"20211002 12:00:00","subjectMatterCategory":"包装","orderPaymentStreamInfo":{"payAmount":"10.0","payTime":"2021-09-12 23:59:59","payCurrency":"CNY","paymentStreamVoucher":"202400000000","currencyRate":"1.00"},"goodsItemList":[{"itemType":"服饰","itemQuantity":10,"itemCurrency":"CNY","itemCode":"sku123123","itemPrice":"100.00","itemProperty":"订制品","itemDesc":"上衣","itemUrlList":["itemUrl"]}]},"insureId":"010101001178221080402961044","currency":"CNY","paymentChannelVoucher":"2022xxx","applicantCompanyInfo":{"legalPersonLicenseType":"身份证","companyLicenseType":"UNITY","companyPhone":"130xxx","companyName":"xx市xx公司","companyAddress":"xxx","userId":"33223xxxxx","companyLicenseNo":"9xxxxxxxxxxY74N","legalPersonLicenseNo":"4****************3","legalPersonName":"王XX"},"identifier":"010101004178221080402170019","amount":"1018.0","personalSubjectMatterInfo":{"subjectMatterId":"1234","subjectMatterName":"张三"},"applicantPersonalInfo":{"personPhone":"139231232323","personName":"张三","personLicenseNo":"3321231232312342432","personAddress":"33xxxx","personEmail":"abc@aa.com","personLicenseType":"IDENTITY_CARD","userId":"123123"},"attrs":"","applicantPayAccount":"ALIBABA","access_token":"uuofgfisg16715x","productCode":"PERFORMANCE_SURETY_BONDS","expireTime":"2021-09-12 23:59:59","amountOfCny":"1018.0","currencyRate":"1.0","effectTime":"2021-08-04 15:23:26"}

响应示例

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

验签示例

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

错误码解释

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

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

场景金融保险

qimen.alibaba.finance.insurance.policy.issuing.new (机构投保出单接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ