文档中心 > API类目 > 天猫优品

qimen.taobao.tmyp.cts.policy.modify (天猫优品保单批改接口)

天猫优品给第三方保司提交保单批改请求(例如人保等)

公共参数

请求参数

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

    响应参数

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

    请求示例

    {"modifyType":"active","insuredPersonName":"天猫优品","effectStartTime":"2024-07-04 00:00:00","insuredPersonContactName":"张三","applicantAddress":"XX地址","applicantContactPhone":"18888888888","policyNo":"PZGJ20233300QA00B44000","effectEndTime":"2025-07-04 00:00:00","applicantName":"天猫优品","insuredPersonCertNo":"XXX","insuredPersonCertType":"23","insuredPersonAddress":"XX地址","insuredPersonContactPhone":"18888888888","insuredItems":[{"itemCatNamePath":"大家电-热水器-电热水器","itemName":"XX热水器","buyAmount":"1","factoryInsEndTime":"2024-07-03 23:59:59","itemPrice":"199900","itemCatPath":"50022703-50013474-50013475"}],"applicantCertNo":"XXX","applicantContactName":"张三","tmypPolicyNo":"209718","extParamList":[{"value":"v1","key":"k1"}],"insurancePeriodMonth":"12","applicantCertType":"23","tradeId":"3383382097003298556"}

    响应示例

    {
        "success":true,
        "returnCode":"success",
        "returnMsg":"投保成功"
    }

    验签示例

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

    错误码解释

    错误码 错误描述 解决方案

    API工具

    FAQ

    返回
    顶部