处方购药

简介

处方购药服务是指用户在问诊中，医生可根据病情为用户开具电子处方，用户可根据电子处方购买药品并配送到家。

处方购药服务对接仅针对于通过API方式接入春雨医生图文及电话服务的客户，通过H5方式接入春雨服务的客户可以在问诊过程中进行处方购药，联系春雨侧开通即可，无需进行开发。

服务细则

  • 处方有效期

    问诊过程中开具的处方，有效期为3天，3天后不可购买，一次处方仅可购买一次

  • 处方使用

    问诊过程中开具的电子处方，仅可在本平台使用，不可使用电子处方图片在线下进行购药

  • 发票开具

    处方购药后，如用户需要开具发票，可在页面中通过“联系客服”开具电子发票

服务接入建议

  • 合作方需在自己的问诊页面中按照春雨的回调接口展示出处方的当前状态，以免用户有所误解
  • 处方购药过程用户必须进行实名认证，且用户在合作方平台的实名信息无法传递到春雨，需在春雨再次实名
  • 用户购药成功后，会生成春雨的订单详情，合作方可根据春雨的回调，自行在其订单入口做展示跳转

开发流程示意图

处方购药回调

开处方信息同步

说明：当医生开具处方后，春雨调用此接口通知合作方

URL：即合作方管理后台-账户管理-信息配置中填写的开处方信息同步回调路径

请求方式：POST

请求参数:

名称 说明 类型 必要 示例 备注
user_id 用户id string 是 用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner 合作方标识 string 是 我要申请
sign 签名 string 是 必须在服务器端生成生成方法
atime 时间戳 long 是 当前UNIX TIMESTAMP签名时间戳(如:137322417)
service_id 服务id int 是
order_url 处方订单链接 string 否 商城购药h5流程必填，其他场景不必填,用户侧嵌套 登录跳转使用
pres_info 处方信息。是json对象 json 是
pres_no 处方号 string 是 CY1202008031757326679
pres_type 处方类型：中药处方、普通处方 string 是 normal 西药
tcm_granules 中药颗粒
send_time 处方发送时间 string 是 2020-01-02 03:04:05
expire_time 处方过期时间 string 是
pres_url 处方链接 string 否
pres_img_url 处方图片链接 string 是
med_rd_no 病历号 string 是
insurance_type 类型：自费 string 是
clinic_name 科室名称 string 是
notice 注意事项 string 否
doctor_info 医生信息 json 是
doctor_name 医生姓名 string 是
hospital_name 医院名称 string 是
doctor_signature_url 医生签名 string 是
pharmaceutist 审核医生姓名 string 是
pharmaceutist_signature_url 审核医生签名地址 string 是
reviewed_name 审方医生姓名 string 是
reviewed_signature_url 审方医生签名地址 string 是
patient_info 患者信息 json 是
name 姓名 string 是
age 年龄 string 是
sex 性别 string 是
goods_list 处方商品信息 list 是
goods_id 商品id string 是
count 数量 int 是 2
name 名称 string 是 兰美抒 盐酸特比萘芬片
specification 规格 string 是 0.25克*7片
usage 用法 string 是 口服
single_dosage 单次用量 string 是 1片/次
freq_name 使用频率 string 是 2次/天
usage_detail 详情 string 是
diagnosis_list 诊断列表 list 是
code 诊断编码 string 是 R05
name 诊断名称 string 是 咳嗽

返回:

名称 说明 类型 必要 示例 备注
error_code 错误码 int 是 错误码。正常应返回0。
error_msg 错误信息 string 否 错误提示。正常应返回空字符串。

处方状态更新同步

说明：当处方状态更新后，春雨调用此接口通知合作方

URL：即合作方管理后台-账户管理-信息配置中填写的处方状态更新回调路径

请求方式：POST

请求参数:

名称 说明 类型 必要 示例 备注
user_id 用户ID string 是 1238096 用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner 合作方标识 string 是 我要申请
sign 签名 string 是 必须在服务器端生成生成方法
atime 时间戳 long 是 当前UNIX TIMESTAMP签名时间戳(如:137322417)
pres_no 处方编号 string 是
service_id 问诊ID int 是
status 处方状态 string 是 expired 已过期
discard 已作废
service_type 服务类型（图文问诊、电话问诊、视频问诊） string 是 graph：图文问诊
inquiry：电话问诊
fast_phone：快捷电话
video_inquiry_saas：视频问诊

返回:

名称 说明 类型 必要 示例 备注
error_code 错误码 int 是 0 代表接口处理成功,其它代表异常，比如参数错误
error_msg 错误信息 string 否 接口异常错误提示。正常应返回空字符串。

订单支付成功同步

说明：当医生开具处方，用户购买处方订单支付成功后，春雨调用此接口通知合作方。

URL：即合作方管理后台-账户管理-信息配置中填写的处方订单支付回调路径

请求方式：POST

请求参数:

名称 说明 类型 必要 示例 备注
user_id 用户ID string 是 用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner 合作方标识 string 是 我要申请
sign 签名 string 是 必须在服务器端生成生成方法
atime 时间戳 long 是 当前UNIX TIMESTAMP签名时间戳(如:137322417)
id 订单ID int 是
order_detail_url 订单详情页地址 string 是 需要将该链接放在登录接口中,用户侧嵌套 登录跳转使用
prescription_no 处方号 string 是
created_time 创建时间 string 是
pay_time 支付时间 string 是
price 订单价格 int 是
status_code 订单状态编号 int 是
status 订单状态 string 是
contact_info 物流信息 json 否
address 地址 string 否
city 城市 string 否
city_code 城市编码 string 否
county 区县 string 否
name 收货人姓名 string 否
phone 收货人手机号 string 否
province 省份 string 否
province_code 省份编码 string 否
express_info_list 物流列表 list 否
send_time 发货时间 string 否
express_company 物流公司 string 否
express_no 物流单号 string 否
express_id 物流ID int 否

返回:

名称 说明 类型 必要 示例 备注
error_code 错误码 int 是 0 代表接口处理成功,其它代表异常，比如参数错误
error_msg 错误信息 string 否 接口异常错误提示。正常应返回空字符串。

订单退款成功同步

说明：当医生开具处方，用户购买处方订单退款成功后，春雨调用此接口通知合作方。

URL：即合作方管理后台-账户管理-信息配置中填写的处方订单退款回调路径

请求方式：POST

请求参数:

名称 说明 类型 必要 示例 备注
user_id 用户ID string 是 1238096 用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner 合作方标识 string 是 我要申请
sign 签名 string 是 必须在服务器端生成生成方法
atime 时间戳 long 是 当前UNIX TIMESTAMP签名时间戳(如:137322417)
id 订单ID int 是
refund_fen 退款金额，单位分 int 是
refund_type_code 退款类型 string 是 2: 部分退款
3：已退款（即全部退款）
refund_type_name 退款类型名称 string 是

返回:

名称 说明 类型 必要 示例 备注
error_code 错误码 int 是 0 代表接口处理成功,其它代表异常，比如参数错误
error_msg 错误信息 string 否 接口异常错误提示。正常应返回空字符串。

物流状态更新同步

说明：当订单物流状态更新时，春雨调用此接口通知合作方。

URL：即合作方管理后台-账户管理-信息配置中填写物流状态更新回调路径

请求方式：POST

请求参数:

名称 说明 类型 必要 示例 备注
user_id 用户ID string 是 用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner 合作方标识 string 是 我要申请
sign 签名 string 是 必须在服务器端生成生成方法
atime 时间戳 long 是 当前UNIX TIMESTAMP签名时间戳(如:137322417)
id 订单ID int 是
express_info_list 物流列表 list 是
send_time 发货时间 string 是
express_company 物流公司 string 是
express_no 物流单号 string 是
express_id 物流ID int 是

返回:

名称 说明 类型 必要 示例 备注
error_code 错误码 int 是 0 代表接口处理成功,其它代表异常，比如参数错误
error_msg 错误信息 string 否 接口异常错误提示。正常应返回空字符串。