搜尋病人 - 用病歷號/身分證號/姓名查詢。

至少需提供 hisno、pidno、name 其中之一。

Args: eip_id: EIP帳號 eip_password: EIP密碼 hisno: 病歷號 pidno: 身分證號 name: 姓名 ward: 病房號 (預設不限)

Returns: 病歷號, 姓名, 性別, 出生日, 病房床號

取得病人門診清單。

Args: hisno: 病歷號 old_than_four_years: 包含 4 年前紀錄

Returns: 門診日期, 門診時間, 門診醫師, 科別, 門診主診斷碼

取得病人完整基本資料。

Returns: 病歷號, 姓名, 生日, 性別, 血型, 身份證號, 科別, 身分, 電話1, 電話2, 行動電話, 地址, 緊急聯絡人等

取得門診 SOAP 病歷。

需先用 patient_opd_list 取得 dt、dept 參數。

Returns: S, O, P, soap, drugs, orders

取得病人已完成的手術紀錄清單。

查詢過去已執行完成的手術。若要查詢未來預定的手術排程，請使用 patient_op_schedule。

Returns: 手術日期, 手術日期_iso, 手術名稱, 主刀醫師

Note: 使用 patient_op_note 時可直接傳入 手術日期_iso 欄位。

取得病人預定的手術排程清單。

查詢未來已排定的手術。若要查詢過去已完成的手術紀錄，請使用 patient_op_list。

Returns: 排程日期, 排程日期_iso, 排程時間, 科別, 房號, 主刀, 手術名稱

取得手術病歷 (HTML)。

Args: dt: 日期 (YYYY-MM-DD)，例如 '2025-11-04'

Returns: 手術病歷 HTML 內容

內部轉換: API 需要民國 8 位格式 (01141104)，會自動轉換。

取得病人住院清單。

Returns: 住院日期, 住院日期_iso, 科別, caseno, adidate

Note: 返回的 caseno 和 住院日期_iso 可用於 patient_ad_note 取得住院病歷詳情。

取得住院病歷摘要 (HTML)。

Args: caseno: 住院案件號，由 patient_ad_list 返回 adidate: 入院日期 (YYYY-MM-DD 或 YYYYMMDD)，由 patient_ad_list 返回的 住院日期_iso

Example: # 步驟 1: 取得住院清單 ad_list = await patient_ad_list(..., hisno) # → [{'住院日期': '20250930', '住院日期_iso': '2025-09-30', 'caseno': '33365977', ...}]

# 步驟 2: 用 caseno 和 住院日期_iso 取得住院病歷
ad_note = await patient_ad_note(..., hisno, caseno='33365977', adidate='2025-09-30')

內部轉換: API 需要 YYYYMMDD 格式，會自動轉換。

取得病人用藥清單。

Returns: 日期, 日期_iso, 類別, 科別, caseno, dt, type, dept, dt1

Note: 返回的參數可用於 patient_drug_content 取得用藥詳情。

取得用藥詳細內容。

Args: caseno: 案件號，由 patient_drug_list 返回 dt: 日期 (YYYY-MM-DD 或 YYYYMMDD) type: 類別 (O=門診, I=住院, E=急診) dept: 科別代碼 dt1: 結束日期 (僅住院需要)，可為空

Returns: 學名, 商品名, 劑量, 單位, 途徑, 頻次, 開始日, 結束日, 狀態, 總量

Example: # 步驟 1: 取得用藥清單 drug_list = await patient_drug_list(..., hisno) # → [{'日期_iso': '2025-12-17', 'caseno': '20251217', 'type': 'O', 'dept': '010', 'dt1': '', ...}]

# 步驟 2: 用參數取得用藥詳情
drug = await patient_drug_content(..., caseno='20251217', dt='2025-12-17', type='O', dept='010')

內部轉換: API 需要 YYYYMMDD 格式，會自動轉換。

取得病人會診清單。

Returns: 會診日期, 會診日期_iso, 病房床號, 所屬科別, 會診科別, 會診醫師一, 會診醫師二, caseno, oseq

Note: 返回的 caseno 和 oseq 可用於 patient_consult_note 取得會診詳情。

取得會診內容 (HTML)。

Args: caseno: 會診案件號，由 patient_consult_list 返回 oseq: 會診序號，由 patient_consult_list 返回

Example: # 步驟 1: 取得會診清單 consult_list = await patient_consult_list(..., hisno) # → [{'會診日期': '20250929', '會診日期_iso': '2025-09-29', 'caseno': 'I3364930', 'oseq': '0001', ...}]

# 步驟 2: 用 caseno 和 oseq 取得會診詳情
consult_note = await patient_consult_note(..., hisno, caseno='I3364930', oseq='0001')

取得科別掃描病歷清單。

搜尋門診清單 (支援 regex 過濾)。

Args: doc_regex: 醫師過濾 (如 "王|李") dept_regex: 科別過濾 (如 "OPH|眼")

查詢醫師的手術排程。

Args: query: 醫師燈號 (如 "4050") date: 日期 (YYYY-MM-DD)，空白=今天。例如 '2025-12-23'

Returns: 手術日期, 時間, 病歷號, 姓名, 病房床號, 科部, 開刀房號, 主刀, 狀態, link, 術前診斷, 手術名稱, 麻醉

內部轉換: API 需要民國 7 位格式，會自動轉換。

查詢科別的手術排程。

Args: query: 科別代碼 (如 "OPH") date: 日期 (YYYY-MM-DD)，空白=今天。例如 '2025-12-23'

Returns: 同 surgery_doc_schedule_list

內部轉換: API 需要民國 7 位格式，會自動轉換。

取得手術詳細資訊。

需先用 surgery_*_schedule_list 取得 link_url。

Returns: 病歷號, 姓名, 性別, 年齡, 手術科部, 病房床號, 手術日期, 時間, 房號, 主刀, 助手, 麻醉方式, 術前診斷, 手術方式, 手術室資訊, 已開同意書

取得醫師過去看診名單。

注意: 僅能查詢過去日期。查詢當天或未來日期將無法取得資料。

Args: date: 單一日期 (YYYY-MM-DD)，例如 '2025-12-08' date_start/date_end: 日期範圍 (YYYY-MM-DD)

Returns: 病歷號, 姓名, 門診日期, 門診時間, 門診科別, 門診醫師, 主診斷(ICD9), 主診斷(IC10), date_iso

內部轉換: API 需要 YYYYMMDD 格式，會自動轉換。

取得醫師未來門診掛號日期清單。

Returns: 掛號日期, 掛號日期_iso, 時段, 科代碼, 診間代碼, 醫師, 科診名稱, 科診位置, 掛號數

Note: 返回的 掛號日期_iso, 科代碼, 診間代碼 可用於 doc_opd_patient_list_appointment 取得該時段的掛號名單。

取得醫師特定門診時段的掛號名單。

Args: date: 門診日期 (YYYY-MM-DD)，由 doc_opd_schedule 返回的 掛號日期_iso ect: 科代碼，由 doc_opd_schedule 返回 (如 '010') room: 診間代碼，由 doc_opd_schedule 返回 (如 '08')

Returns: 號碼, 病歷號, 姓名, 性別, 生日, 身份, 電話

Example: # 步驟 1: 取得門診掛號日期清單 schedule = await doc_opd_schedule(...) # → [{'掛號日期_iso': '2025-12-22', '科代碼': '010', '診間代碼': '08', '掛號數': '61', ...}]

# 步驟 2: 用參數取得該時段的掛號名單
patients = await doc_opd_patient_list_appointment(..., date='2025-12-22', ect='010', room='08')

內部轉換: API 需要 YYYYMMDD 格式，會自動轉換。

批次取得門診 SOAP (耗時操作)。

Args: date_start: 開始日期 (YYYY-MM-DD) date_end: 結束日期 (YYYY-MM-DD)，預設同 date_start limit: 最大處理數量 (預設 50) target_depts: 科別代碼清單，預設眼科 ['010', '110', '0PH', '1PH']

Returns: 含 S, O, P, soap, drugs 欄位

防護機制: - 基本延遲 1 秒 + 隨機 0~0.5 秒 - 每 50 筆額外休息 10 秒 - 錯誤時加倍延遲，連續 3 錯暫停 30 秒

查詢病人手術排程 (同意書系統)。

Returns: 排程日期, 手術名稱, 主刀醫師, 預定時間

取得病人同意書清單。

Args: start_date: YYYY-MM-DD (預設 40 天前) end_date: YYYY-MM-DD (預設今天)

Returns: jobs 陣列，含 JOB_DOC_ID, TEMP_NAME, JOB_STATUS

搜尋同意書 (預設眼科+已完成)。

Args: target_keyword: 關鍵字 (預設 "手術") return_id: 只回傳 JOB_DOC_ID

下載同意書 PDF (Base64)。

需先用 consent_search 取得 jid。

從 CKS 下載 IVI 排程。

不允許查詢未來日期。

Args: date: 單一日期 (YYYY-MM-DD) start_date/end_date: 日期範圍

Returns: hisno, name, schedule_name, schedule_date, vs_code, vs_name, op_start, op_end, diagnosis, side, drug, charge_type, raw_content