處方購(gòu)藥

簡(jiǎn)介

處方購(gòu)藥服務(wù)是指用戶(hù)在問(wèn)診中，醫(yī)生可根據(jù)病情為用戶(hù)開(kāi)具電子處方丸凭，用戶(hù)可根據(jù)電子處方購(gòu)買(mǎi)藥品并配送到家福扬。

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

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

  • 處方有效期

    問(wèn)診過(guò)程中開(kāi)具的處方势纺，有效期為3天倔晚，3天后不可購(gòu)買(mǎi)，一次處方僅可購(gòu)買(mǎi)一次

  • 處方使用

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

  • 發(fā)票開(kāi)具

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

服務(wù)接入建議

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

開(kāi)發(fā)流程示意圖

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

開(kāi)處方信息同步

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

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

請(qǐng)求方式：POST

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

名稱(chēng) 說(shuō)明 類(lèi)型 必要 示例 備注
user_id 用戶(hù)id string 是 用戶(hù)唯一標(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)景不必填,用戶(hù)側(cè)嵌套 登錄跳轉(zhuǎn)使用
pres_info 處方信息碰缔。是json對(duì)象 json 是
pres_no 處方號(hào) string 是 CY1202008031757326679
pres_type 處方類(lèi)型：中藥處方账劲、普通處方 string 是 normal 西藥
tcm_granules 中藥顆粒
send_time 處方發(fā)送時(shí)間 string 是 2020-01-02 03:04:05
expire_time 處方過(guò)期時(shí)間 string 是
pres_url 處方鏈接 string 否
pres_img_url 處方圖片鏈接 string 是
med_rd_no 病歷號(hào) string 是
insurance_type 類(lèi)型：自費(fèi) string 是
clinic_name 科室名稱(chēng) string 是
notice 注意事項(xiàng) string 否
doctor_info 醫(yī)生信息 json 是
doctor_name 醫(yī)生姓名 string 是
hospital_name 醫(yī)院名稱(chēng) 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 名稱(chēng) 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 診斷名稱(chēng) string 是 咳嗽

返回:

名稱(chēng) 說(shuō)明 類(lèi)型 必要 示例 備注
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)-賬戶(hù)管理-信息配置中填寫(xiě)的處方狀態(tài)更新回調(diào)路徑

請(qǐng)求方式：POST

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

名稱(chēng) 說(shuō)明 類(lèi)型 必要 示例 備注
user_id 用戶(hù)ID string 是 1238096 用戶(hù)唯一標(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 問(wèn)診ID int 是
status 處方狀態(tài) string 是 expired 已過(guò)期
discard 已作廢
service_type 服務(wù)類(lèi)型（圖文問(wèn)診巫击、電話問(wèn)診禀晓、視頻問(wèn)診） string 是 graph：圖文問(wèn)診
inquiry：電話問(wèn)診
fast_phone：快捷電話
video_inquiry_saas：視頻問(wèn)診

返回:

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

訂單支付成功同步

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

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

請(qǐng)求方式：POST

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

名稱(chēng) 說(shuō)明 類(lèi)型 必要 示例 備注
user_id 用戶(hù)ID string 是 用戶(hù)唯一標(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 是 需要將該鏈接放在登錄接口中,用戶(hù)側(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 否

返回:

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

訂單退款成功同步

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

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

請(qǐng)求方式：POST

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

名稱(chēng) 說(shuō)明 類(lèi)型 必要 示例 備注
user_id 用戶(hù)ID string 是 1238096 用戶(hù)唯一標(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 退款類(lèi)型 string 是 2: 部分退款
3：已退款（即全部退款）
refund_type_name 退款類(lèi)型名稱(chēng) string 是

返回:

名稱(chēng) 說(shuō)明 類(lèi)型 必要 示例 備注
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)-賬戶(hù)管理-信息配置中填寫(xiě)物流狀態(tài)更新回調(diào)路徑

請(qǐng)求方式：POST

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

名稱(chēng) 說(shuō)明 類(lèi)型 必要 示例 備注
user_id 用戶(hù)ID string 是 用戶(hù)唯一標(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 是

返回:

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