處方購藥

簡介

處方購藥服務是指用戶在問診中,醫(yī)生可根據(jù)病情為用戶開具電子處方,用戶可根據(jù)電子處方購買藥品并配送到家。

處方購藥服務對接僅針對于通過API方式接入春雨醫(yī)生圖文及電話服務的客戶,通過H5方式接入春雨服務的客戶可以在問診過程中進行處方購藥,聯(lián)系春雨側開通即可,無需進行開發(fā)。

服務細則

  • 處方有效期

    問診過程中開具的處方,有效期為3天,3天后不可購買,一次處方僅可購買一次

  • 處方使用

    問診過程中開具的電子處方,僅可在本平臺使用,不可使用電子處方圖片在線下進行購藥

  • 發(fā)票開具

    處方購藥后,如用戶需要開具發(fā)票,可在頁面中通過“聯(lián)系客服”開具電子發(fā)票

服務接入建議

  • 合作方需在自己的問診頁面中按照春雨的回調接口展示出處方的當前狀態(tài),以免用戶有所誤解
  • 處方購藥過程用戶必須進行實名認證,且用戶在合作方平臺的實名信息無法傳遞到春雨,需在春雨再次實名
  • 用戶購藥成功后,會生成春雨的訂單詳情,合作方可根據(jù)春雨的回調,自行在其訂單入口做展示跳轉

開發(fā)流程示意圖

處方購藥回調

開處方信息同步

說明:當醫(yī)生開具處方后,春雨調用此接口通知合作方

URL:即合作方管理后臺-賬戶管理-信息配置中填寫的開處方信息同步回調路徑

請求方式:POST

請求參數(shù):

名稱 說明 類型 必要 示例 備注
user_id 用戶id string 用戶唯一標識,合作方定義(可為字母、數(shù)字、下劃線或其組合)
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 處方發(fā)送時間 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 醫(yī)生信息 json
doctor_name 醫(yī)生姓名 string
hospital_name 醫(yī)院名稱 string
doctor_signature_url 醫(yī)生簽名 string
pharmaceutist 審核醫(yī)生姓名 string
pharmaceutist_signature_url 審核醫(yī)生簽名地址 string
reviewed_name 審方醫(yī)生姓名 string
reviewed_signature_url 審方醫(yī)生簽名地址 string
patient_info 患者信息 json
name 姓名 string
age 年齡 string
sex 性別 string
goods_list 處方商品信息 list
goods_id 商品id string
count 數(shù)量 int 2
name 名稱 string 蘭美抒 鹽酸特比萘芬片
specification 規(guī)格 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 錯誤提示。正常應返回空字符串。

處方狀態(tài)更新同步

說明:當處方狀態(tài)更新后,春雨調用此接口通知合作方

URL:即合作方管理后臺-賬戶管理-信息配置中填寫的處方狀態(tài)更新回調路徑

請求方式:POST

請求參數(shù):

名稱 說明 類型 必要 示例 備注
user_id 用戶ID string 1238096 用戶唯一標識,合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標識 string 我要申請
sign 簽名 string 必須在服務器端生成生成方法
atime 時間戳 long 當前UNIX TIMESTAMP簽名時間戳(如:137322417)
pres_no 處方編號 string
service_id 問診ID int
status 處方狀態(tài) string expired 已過期
discard 已作廢
service_type 服務類型(圖文問診、電話問診、視頻問診) string graph:圖文問診
inquiry:電話問診
fast_phone:快捷電話
video_inquiry_saas:視頻問診

返回:

名稱 說明 類型 必要 示例 備注
error_code 錯誤碼 int 0 代表接口處理成功,其它代表異常,比如參數(shù)錯誤
error_msg 錯誤信息 string 接口異常錯誤提示。正常應返回空字符串。

訂單支付成功同步

說明:當醫(yī)生開具處方,用戶購買處方訂單支付成功后,春雨調用此接口通知合作方。

URL:即合作方管理后臺-賬戶管理-信息配置中填寫的處方訂單支付回調路徑

請求方式:POST

請求參數(shù):

名稱 說明 類型 必要 示例 備注
user_id 用戶ID string 用戶唯一標識,合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標識 string 我要申請
sign 簽名 string 必須在服務器端生成生成方法
atime 時間戳 long 當前UNIX TIMESTAMP簽名時間戳(如:137322417)
id 訂單ID int
order_detail_url 訂單詳情頁地址 string 需要將該鏈接放在登錄接口中,用戶側嵌套 登錄跳轉使用
prescription_no 處方號 string
created_time 創(chuàng)建時間 string
pay_time 支付時間 string
price 訂單價格 int
status_code 訂單狀態(tài)編號 int
status 訂單狀態(tài) string
contact_info 物流信息 json
address 地址 string
city 城市 string
city_code 城市編碼 string
county 區(qū)縣 string
name 收貨人姓名 string
phone 收貨人手機號 string
province 省份 string
province_code 省份編碼 string
express_info_list 物流列表 list
send_time 發(fā)貨時間 string
express_company 物流公司 string
express_no 物流單號 string
express_id 物流ID int

返回:

名稱 說明 類型 必要 示例 備注
error_code 錯誤碼 int 0 代表接口處理成功,其它代表異常,比如參數(shù)錯誤
error_msg 錯誤信息 string 接口異常錯誤提示。正常應返回空字符串。

訂單退款成功同步

說明:當醫(yī)生開具處方,用戶購買處方訂單退款成功后,春雨調用此接口通知合作方。

URL:即合作方管理后臺-賬戶管理-信息配置中填寫的處方訂單退款回調路徑

請求方式:POST

請求參數(shù):

名稱 說明 類型 必要 示例 備注
user_id 用戶ID string 1238096 用戶唯一標識,合作方定義(可為字母、數(shù)字、下劃線或其組合)
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 代表接口處理成功,其它代表異常,比如參數(shù)錯誤
error_msg 錯誤信息 string 接口異常錯誤提示。正常應返回空字符串。

物流狀態(tài)更新同步

說明:當訂單物流狀態(tài)更新時,春雨調用此接口通知合作方。

URL:即合作方管理后臺-賬戶管理-信息配置中填寫物流狀態(tài)更新回調路徑

請求方式:POST

請求參數(shù):

名稱 說明 類型 必要 示例 備注
user_id 用戶ID string 用戶唯一標識,合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標識 string 我要申請
sign 簽名 string 必須在服務器端生成生成方法
atime 時間戳 long 當前UNIX TIMESTAMP簽名時間戳(如:137322417)
id 訂單ID int
express_info_list 物流列表 list
send_time 發(fā)貨時間 string
express_company 物流公司 string
express_no 物流單號 string
express_id 物流ID int

返回:

名稱 說明 類型 必要 示例 備注
error_code 錯誤碼 int 0 代表接口處理成功,其它代表異常,比如參數(shù)錯誤
error_msg 錯誤信息 string 接口異常錯誤提示。正常應返回空字符串。