淘宝开放平台

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
memberId	String	必须	D-member-0001		会员编号
phone	String	可选	ipk3pfmExlzvmicrjs8cq%3d%3d		用户的手机号密文（解密密钥另行给出）
overallInsureType	String	可选	41		投保类型，全部保单（含历史保单）类型汇总，NONE: 未投保，41: 安心保，31: 乙肝保，MULTIPLE: 投保过多个保险
payOrderAndInsureInfo	PayOrderAndInsureInfo []	可选		最大列表长度：999999	分保险产品，购药信息及时间最近的保单信息
└ insureProductId Number 可选 41 保险产品ID └ insureProductName String 可选安心保保险产品名称 └ policyStatus String 可选 IN_PROGRESS 投保状态 NEVER_INSURED:从未投保，IN_PROGRESS:正常在保，SURRENDER: 最新保单已退保，EXPIRED: 最新保单已过期 └ policyId String 可选 2000003202006003350 保单编号 └ agentName String 可选众安保险保司名称 └ effectStartTime String 可选 2023-05-12 00:00:00 当前保单生效时间 └ effectEndTime String 可选 2024-05-11 23:59:59 当前保单到期时间 └ insuredTime String 可选 2023-05-11 16:04:00 投保时间 └ continuousStartDate String 可选 2023-09-12 23:59:59 当前保单可续期时，最早续期时间 └ continuousEndDate String 可选 2023-09-12 23:59:59 当前保单可续期时，最晚续期时间 └ renewalStartDate String 可选 2023-12-12 23:59:59 当前保单可续保时，续保开始时 └ renewalEndDate String 可选 2024-03-12 23:59:59 当前保单可续保时，续保截止时间 └ policyCount Number 可选 1 含往期保单，保单个数 └ currentPolicyInstallmentNo Number 可选 2 当前保单已续期的期数 └ expectAction String 可选 IN_PROGRESS 在保状态，IN_PROGRESS:正常在保，CONTINUOUS:开始续期，CONTINUOUS_GRACE:续期宽限期，RENEWAL:开始续保，RENEWAL_GRACE:续保宽限期 //TERMINATED:已断保（OR CONTINUOUS_TERMINATED:未续期断保，RENEWAL_TERMINATED:未续保断保，SURRENDER_TERMINATED: 主动退保断保） insuredPayOrder PayOrder 可选投保购药单信息 └ payOrderId String 可选 po001 购药单ID，合单时，多个购药单ID以逗号分隔 └ subPayOrderId String 可选 po001Sub1 购药单子ID，发生拆单是和payOrderId不同，无拆单则相同 └ payTime String 可选 2023-06-19 14:00:13 支付时间 └ medicineId String 可选 8129295 药品编码 └ medicineName String 可选 xxx药品药品名称 └ usedMedicineQuantity Number 可选 3 已使用的数量 └ totalMedicineQuantity Number 可选 6 购药数量 └ payOrderTotalAmount Number 可选 10000 支付金额 └ status String 可选 ILLEGAL_INSURE_USED 购药单状态CAN_USE("可用", ""), ILLEGAL_REFUNDED("不可用", "购药单已被退单"), ILLEGAL_REFUND_PAY_ORDER("不可用", "购药单是退单"), ILLEGAL_LESS_QUANTITY("不可用", "购药数量少于要求"), ILLEGAL_INSURE_USED("不可用", "购药单已用于投保"), ILLEGAL_CONTINUOUS_USED("不可用", "购药单已用于续期"), ILLEGAL_PARTICIPANT_USED("不可用", "购药单已经参与投保或续期"), RECOVERY_INSURE_PROGRESS("可修复", "投保流程中"), ILLEGAL_CONTINUOUS_PROGRESS("不可用", "续期流程中"), ILLEGAL_MEDICINE_OFFLINE("不可用", "购药时药品处于下架状态"), ILLEGAL_MEDICINE_COMBINATION_FAIL("不可用", "组方失败"), ILLEGAL_NOT_NEWEST_PAY_ORDER_FAIL("不可用", "不是最新日期的购药单") └ insureType String 可选 41 投保类型，NONE: 未投保，41: 安心保，31: 乙肝保 └ sellerId String 可选 dSeller001 店员ID └ storeNo String 可选 dStore001 门店编码 lastUsedPayOrder PayOrder 可选最近投保/续期使用的购药单信息 └ payOrderId String 可选 po001 购药单ID，合单时，多个购药单ID以逗号分隔 └ subPayOrderId String 可选 po001Sub2 购药单子ID，发生拆单是和payOrderId不同，无拆单则相同 └ payTime String 可选 2023-06-19 14:00:13 支付时间 └ storeNo String 可选 dStore001 门店编码 └ insureType String 可选 41 投保类型，NONE: 未投保，41: 安心保，31: 乙肝保 └ sellerId String 可选 dSeller001 店员编码 └ medicineId String 可选 8129295 药品编码 └ totalMedicineQuantity Number 可选 6 购药数量 └ payOrderTotalAmount Number 可选 10000 支付金额 └ medicineName String 可选 xxx药品药品名称 └ usedMedicineQuantity Number 可选 3 投保/续期使用数量 └ status String 可选 ILLEGAL_CONTINUOUS_USED 购药单状态CAN_USE("可用", ""), ILLEGAL_REFUNDED("不可用", "购药单已被退单"), ILLEGAL_REFUND_PAY_ORDER("不可用", "购药单是退单"), ILLEGAL_LESS_QUANTITY("不可用", "购药数量少于要求"), ILLEGAL_INSURE_USED("不可用", "购药单已用于投保"), ILLEGAL_CONTINUOUS_USED("不可用", "购药单已用于续期"), ILLEGAL_PARTICIPANT_USED("不可用", "购药单已经参与投保或续期"), RECOVERY_INSURE_PROGRESS("可修复", "投保流程中"), ILLEGAL_CONTINUOUS_PROGRESS("不可用", "续期流程中"), ILLEGAL_MEDICINE_OFFLINE("不可用", "购药时药品处于下架状态"), ILLEGAL_MEDICINE_COMBINATION_FAIL("不可用", "组方失败"), ILLEGAL_NOT_NEWEST_PAY_ORDER_FAIL("不可用", "不是最新日期的购药单") lastPayOrder PayOrder [] 可选最近（30天）购药单信息列表 └ payOrderId String 可选 po002 购药单ID，合单时，多个购药单ID以逗号分隔 └ subPayOrderId String 可选 po001 购药单子ID，发生拆单是和payOrderId不同，无拆单则相同 └ payTime String 可选 2023-08-19 14:00:13 支付时间 └ storeNo String 可选 dStore001 门店编码 └ insureType String 可选 NONE 投保类型，NONE: 未投保，41: 安心保，31: 乙肝保 └ sellerId String 可选 dSeller001 店员编码 └ medicineId String 可选 8129295 药品编码 └ totalMedicineQuantity Number 可选 3 销售数量合计 └ payOrderTotalAmount Number 可选 5000 购药单支付金额 └ medicineName String 可选 xxx药品药品名称 └ usedMedicineQuantity Number 可选 3 投保/续期使用数量 └ status String 可选 CAN_USE 购药单状态，CAN_USE("可用", ""), ILLEGAL_REFUNDED("不可用", "购药单已被退单"), ILLEGAL_REFUND_PAY_ORDER("不可用", "购药单是退单"), ILLEGAL_LESS_QUANTITY("不可用", "购药数量少于要求"), ILLEGAL_INSURE_USED("不可用", "购药单已用于投保"), ILLEGAL_CONTINUOUS_USED("不可用", "购药单已用于续期"), ILLEGAL_PARTICIPANT_USED("不可用", "购药单已经参与投保或续期"), RECOVERY_INSURE_PROGRESS("可修复", "投保流程中"), ILLEGAL_CONTINUOUS_PROGRESS("不可用", "续期流程中"), ILLEGAL_MEDICINE_OFFLINE("不可用", "购药时药品处于下架状态"), ILLEGAL_MEDICINE_COMBINATION_FAIL("不可用", "组方失败"), ILLEGAL_NOT_NEWEST_PAY_ORDER_FAIL("不可用", "不是最新日期的购药单")
extra	String	可选	{}		附加信息，JSON 字符串

名称	类型	示例值	描述
errMessage	String	未知错误	错误消息
data	Boolean	true	数据
errCode	String	000	错误码，正常响应（包括checkedexception）不要设置
status	String	SUCCESS	相应状态

{"overallInsureType":"41","phone":"ipk3pfmExlzvmicrjs8cq%3d%3d","extra":"{}","payOrderAndInsureInfo":[{"continuousEndDate":"2023-09-12 23:59:59","lastPayOrder":[{"payOrderId":"po002","storeNo":"dStore001","insureType":"NONE","sellerId":"dSeller001","payTime":"2023-08-19 14:00:13","medicineId":"8129295","totalMedicineQuantity":3,"payOrderTotalAmount":5000,"medicineName":"xxx药品","usedMedicineQuantity":3,"subPayOrderId":"po001","status":"CAN_USE"}],"renewalStartDate":"2023-12-12 23:59:59","effectStartTime":"2023-05-12 00:00:00","currentPolicyInstallmentNo":2,"lastUsedPayOrder":{"payOrderId":"po001","storeNo":"dStore001","insureType":"41","sellerId":"dSeller001","payTime":"2023-06-19 14:00:13","medicineId":"8129295","totalMedicineQuantity":6,"payOrderTotalAmount":10000,"medicineName":"xxx药品","usedMedicineQuantity":3,"subPayOrderId":"po001Sub2","status":"ILLEGAL_CONTINUOUS_USED"},"agentName":"众安保险","expectAction":"IN_PROGRESS","effectEndTime":"2024-05-11 23:59:59","renewalEndDate":"2024-03-12 23:59:59","policyStatus":"IN_PROGRESS","continuousStartDate":"2023-09-12 23:59:59","insureProductName":"安心保","policyId":"2000003202006003350","policyCount":1,"insuredPayOrder":{"payOrderId":"po001","storeNo":"dStore001","insureType":"41","sellerId":"dSeller001","payTime":"2023-06-19 14:00:13","medicineId":"8129295","totalMedicineQuantity":6,"payOrderTotalAmount":10000,"medicineName":"xxx药品","usedMedicineQuantity":3,"subPayOrderId":"po001Sub1","status":"ILLEGAL_INSURE_USED"},"insureProductId":41,"insuredTime":"2023-05-11 16:04:00"}],"memberId":"D-member-0001"}

{
    "errMessage":"未知错误",
    "data":true,
    "errCode":"000",
    "status":"SUCCESS"
}

{"errCode":"不等于null","errMessage":"Illegal request","status":"sign-check-failure"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

阿里健康保险-信息交互

qimen.alibaba.alihealth.insurance.drugstore.user.profile.sync (向连锁药店同步会员投保信息的功能)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ