處方購藥

簡介

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

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

服務細則

  • 處方有效期

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

  • 處方使用

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

  • 發(fā)票開具

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

服務接入建議

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

開發(fā)流程示意圖

處方購藥回調

開處方信息同步

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

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 處方發(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 數量 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

請求參數:

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

訂單支付成功同步

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

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 創(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 代表接口處理成功,其它代表異常，比如參數錯誤
error_msg 錯誤信息 string 否 接口異常錯誤提示。正常應返回空字符串。

訂單退款成功同步

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

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 否 接口異常錯誤提示。正常應返回空字符串。

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

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

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

請求方式：POST

請求參數:

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