處方購(gòu)藥

簡(jiǎn)介

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

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

服務(wù)細(xì)則

  • 處方有效期

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

  • 處方使用

    問診過程中開具的電子處方，僅可在本平臺(tái)使用，不可使用電子處方圖片在線下進(jìn)行購(gòu)藥

  • 發(fā)票開具

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

服務(wù)接入建議

  • 合作方需在自己的問診頁(yè)面中按照春雨的回調(diào)接口展示出處方的當(dāng)前狀態(tài)，以免用戶有所誤解
  • 處方購(gòu)藥過程用戶必須進(jìn)行實(shí)名認(rèn)證，且用戶在合作方平臺(tái)的實(shí)名信息無(wú)法傳遞到春雨，需在春雨再次實(shí)名
  • 用戶購(gòu)藥成功后，會(huì)生成春雨的訂單詳情，合作方可根據(jù)春雨的回調(diào)，自行在其訂單入口做展示跳轉(zhuǎn)

開發(fā)流程示意圖

處方購(gòu)藥回調(diào)

開處方信息同步

說(shuō)明：當(dāng)醫(yī)生開具處方后，春雨調(diào)用此接口通知合作方

URL：即合作方管理后臺(tái)-賬戶管理-信息配置中填寫的開處方信息同步回調(diào)路徑

請(qǐng)求方式：POST

請(qǐng)求參數(shù):

名稱 說(shuō)明 類型 必要 示例 備注
user_id 用戶id string 是 用戶唯一標(biāo)識(shí),合作方定義（可為字母、數(shù)字、下劃線或其組合）
partner 合作方標(biāo)識(shí) string 是 我要申請(qǐng)
sign 簽名 string 是 必須在服務(wù)器端生成生成方法
atime 時(shí)間戳 long 是 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳(如:137322417)
service_id 服務(wù)id int 是
order_url 處方訂單鏈接 string 否 商城購(gòu)藥h5流程必填，其他場(chǎng)景不必填,用戶側(cè)嵌套 登錄跳轉(zhuǎn)使用
pres_info 處方信息。是json對(duì)象 json 是
pres_no 處方號(hào) string 是 CY1202008031757326679
pres_type 處方類型：中藥處方、普通處方 string 是 normal 西藥
tcm_granules 中藥顆粒
send_time 處方發(fā)送時(shí)間 string 是 2020-01-02 03:04:05
expire_time 處方過期時(shí)間 string 是
pres_url 處方鏈接 string 否
pres_img_url 處方圖片鏈接 string 是
med_rd_no 病歷號(hào) string 是
insurance_type 類型：自費(fèi) string 是
clinic_name 科室名稱 string 是
notice 注意事項(xiàng) 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 是 咳嗽

返回:

名稱 說(shuō)明 類型 必要 示例 備注
error_code 錯(cuò)誤碼 int 是 錯(cuò)誤碼。正常應(yīng)返回0。
error_msg 錯(cuò)誤信息 string 否 錯(cuò)誤提示。正常應(yīng)返回空字符串。

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

說(shuō)明：當(dāng)處方狀態(tài)更新后，春雨調(diào)用此接口通知合作方

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

請(qǐng)求方式：POST

請(qǐng)求參數(shù):

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

返回:

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

訂單支付成功同步

說(shuō)明：當(dāng)醫(yī)生開具處方，用戶購(gòu)買處方訂單支付成功后，春雨調(diào)用此接口通知合作方。

URL：即合作方管理后臺(tái)-賬戶管理-信息配置中填寫的處方訂單支付回調(diào)路徑

請(qǐng)求方式：POST

請(qǐng)求參數(shù):

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

返回:

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

訂單退款成功同步

說(shuō)明：當(dāng)醫(yī)生開具處方，用戶購(gòu)買處方訂單退款成功后，春雨調(diào)用此接口通知合作方。

URL：即合作方管理后臺(tái)-賬戶管理-信息配置中填寫的處方訂單退款回調(diào)路徑

請(qǐng)求方式：POST

請(qǐng)求參數(shù):

名稱 說(shuō)明 類型 必要 示例 備注
user_id 用戶ID string 是 1238096 用戶唯一標(biāo)識(shí),合作方定義（可為字母、數(shù)字、下劃線或其組合）
partner 合作方標(biāo)識(shí) string 是 我要申請(qǐng)
sign 簽名 string 是 必須在服務(wù)器端生成生成方法
atime 時(shí)間戳 long 是 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳(如:137322417)
id 訂單ID int 是
refund_fen 退款金額，單位分 int 是
refund_type_code 退款類型 string 是 2: 部分退款
3：已退款（即全部退款）
refund_type_name 退款類型名稱 string 是

返回:

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

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

說(shuō)明：當(dāng)訂單物流狀態(tài)更新時(shí)，春雨調(diào)用此接口通知合作方。

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

請(qǐng)求方式：POST

請(qǐng)求參數(shù):

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

返回:

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