淘宝开放平台

登录
文档中心 > API类目 >

qimen.taobao.tmyp.cts.policy.apply (天猫优品投保接口)

天猫优品给第三方保司提交投保申请（例如人保等）

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
applicantName String 必须 天猫优品 投保主体名称
applicantAddress String 必须 XX地址 投保主体地址
applicantCertNo String 必须 XXX 投保主体证件号码（社会统一代码号）
applicantCertType String 必须 23 投保主体证件类型
applicantContactName String 必须 张三 投保主体联系人姓名
applicantContactPhone String 必须 18888888888 投保主体联系人手机号
insuredPersonName String 必须 天猫优品 被投保主体名称
insuredPersonAddress String 必须 XX地址 被投保主体地址
insuredPersonCertNo String 必须 XXX 被投保主体证件号码（社会统一代码号）
insuredPersonCertType String 必须 23 被投保主体证件类型
insuredPersonContactName String 必须 张三 被投保主体联系人姓名
insuredPersonContactPhone String 必须 18888888888 被投保主体联系人手机号
productCode String 必须 testCode 投保险种代码
productSubCode String 可选 testSubCode 投保险种子代码
productName String 可选 测试保险 投保产品名称
productType String 可选 testType 投保产品类别
tmypPolicyNo String 必须 209718 天猫优品保单号
insurancePeriodMonth String 必须 12 保障期限-月
effectStartTime String 必须 2024-07-04 00:00:00 起保时间
effectEndTime String 必须 2025-07-04 00:00:00 终保时间
insuranceLimit String 必须 199900 保额-分
insuranceFee String 必须 6997 保费-分
tradeId String 必须 3383382097003298556 淘宝交易订单号
extParamList ExtParam [] 必须
  • 最大列表长度：999
    		•  扩展参数,双方约定的扩展字段,k-v格式
    • └ value
    • String
    • 必须
    • v1
    • value
    • └ key
    • String
    • 必须
    • k1
    • key
    insuredItems ItemInfo [] 必须
  • 最大列表长度：999
    		•  保险商品信息
    • └ factoryInsEndTime
    • String
    • 可选
    • 2024-07-03 23:59:59
    • 商品厂保结束时间
    • └ itemCatNamePath
    • String
    • 必须
    • 大家电-热水器-电热水器
    • 商品类目名称
    • └ itemCatPath
    • String
    • 必须
    • 50022703-50013474-50013475
    • 商品类目Id路径
    • └ buyAmount
    • String
    • 必须
    • 1
    • 商品数量
    • └ itemPrice
    • String
    • 必须
    • 199900
    • 商品单价-分
    • └ itemName
    • String
    • 必须
    • XX热水器
    • 商品名称

    响应参数

    名称 类型 示例值 描述
    success Boolean true 系统参数，本次调用是否成功
    returnCode String success 返回Code,签名错误:sign-check-failure 其他:由实现方确定
    returnMsg String 投保成功 返回信息,通常为对应于returnCode的文本描述，例如错误原因
    policyNo String XXX 保司侧保单号
    insuranceLimit String 199900 保司侧实际保额
    insuranceFee String 3000 保司侧实际保费

    请求示例

    {"productSubCode":"testSubCode","insuredPersonName":"天猫优品","effectStartTime":"2024-07-04 00:00:00","insuredPersonContactName":"张三","applicantContactPhone":"18888888888","effectEndTime":"2025-07-04 00:00:00","insuredPersonCertNo":"XXX","productName":"测试保险","insuredPersonAddress":"XX地址","insuredItems":[{"itemCatNamePath":"大家电-热水器-电热水器","itemName":"XX热水器","buyAmount":"1","factoryInsEndTime":"2024-07-03 23:59:59","itemPrice":"199900","itemCatPath":"50022703-50013474-50013475"}],"applicantCertNo":"XXX","applicantContactName":"张三","extParamList":[{"value":"v1","key":"k1"}],"insurancePeriodMonth":"12","applicantCertType":"23","productType":"testType","applicantAddress":"XX地址","applicantName":"天猫优品","insuredPersonCertType":"23","insuredPersonContactPhone":"18888888888","productCode":"testCode","insuranceFee":"6997","tmypPolicyNo":"209718","insuranceLimit":"199900","tradeId":"3383382097003298556"}

    响应示例

    {
    "success":true,
    "returnCode":"success",
    "returnMsg":"投保成功",
    "policyNo":"XXX",
    "insuranceLimit":"199900",
    "insuranceFee":"3000"
}

    验签示例

    {"returnCode":"sign-check-failure","returnMsg":"Illegal request","success":"false"}

    错误码解释

    错误码 错误描述 解决方案

    API工具

    错误码查询工具 SDK下载

    FAQ

    有用( 0 ) 我要提问
    返回
    顶部