简介

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

处方购药服务对接仅针对于通过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	否		接口异常错误提示。正常应返回空字符串。