薬 局 ヒヤリ ハット 事 例 収 集 分 析 事 業 システム 事 例 検 索 API 仕 様 公 益 財 団 法 人 日 本 医 療 機 能 評 価 機 構 医 療 事 故 防 止 事 業 部 平 成 25 年 6 月 作 成 Ver.1.2
修 正 履 歴 版 数 修 正 日 修 正 箇 所 修 正 内 容 1.0 2010.01 新 規 作 成 1.1 2010.04 設 定 資 料 1.2 2013.06 設 定 資 料 1 疑 義 照 会 に 関 する XML タグ 名 を 追 記 表 中 No47~51 1 <LSTRELATED> 2 <GRPMEDICINE_A> 3 <DATMEDNAME> 4 <DATMEDCODE> 5 <DATMANNAME> 上 記 1~5のタグを 追 記 1 コード 検 索 のコード 設 定 値 における 誤 字 を 修 正 容 量 変 更 用 量 変 更 - 2 -
目 次 1. リクエストパラメータ...- 4-2. リクエストサンプル...- 5-3. 設 定 資 料...- 6-4. レスポンスフィールド...- 12-5. サンプルレスポンス...- 13 - - 3 -
1. リクエストパラメータ リクエストパラメータは 下 記 URL に 続 けて 指 定 する http://www.yakkyoku-hiyari.jcqhc.or.jp/phsearch/searchreportapi.action? リクエスト 時 に 使 用 するパラメータは 下 記 の 通 り パラメータ 条 件 値 内 容 項 目 内 検 索 条 件 item 任 意 必 須 設 定 資 料 XML タグ 名 参 照 1 検 索 対 象 項 目 名 を 設 定 (item,word,condition のセットで 複 数 設 定 可 能 ) 空 白 の 場 合 全 体 を 検 索 word 必 須 String 検 索 文 字 列 を 設 定 ( 半 角 空 白 にて 複 数 文 字 列 を 指 定 可 能 ) condition 必 須 all(デフォルト) not any 検 索 条 件 を 設 定 all: 全 てを 含 む not:いずれも 含 まない any:いずれかを 含 む 空 白 の 場 合 デフォルト 値 を 使 用 2 fyear 任 意 Integer 4 桁 発 生 年 範 囲 開 始 を 設 定 3 fmonth 任 意 Integer 1~2 桁 発 生 月 範 囲 開 始 を 設 定 4 tyear 任 意 Integer 4 桁 発 生 年 範 囲 終 了 を 設 定 5 tmonth 任 意 Integer 1~2 桁 発 生 月 範 囲 終 了 を 設 定 6 7 8 9 itemcode 任 意 必 須 設 定 資 料 コード 検 索 参 照 code 必 須 設 定 資 料 コード 検 索 参 照 検 索 対 象 とする 項 目 コードを 設 定 ( itemcode,code,text のセットで 複 数 設 定 可 能 ) コードにて 検 索 する 場 合 に 設 定 ( 半 角 空 白 にて 複 数 文 字 列 を 指 定 可 能 ) text のみで 検 索 する 場 合 は 空 白 text 必 須 String 内 容 にて 検 索 する 場 合 に 設 定 ( 半 角 空 白 にて 複 数 文 字 列 を 指 定 可 能 ) code のみで 検 索 する 場 合 は 空 白 start 任 意 Integer 0(デフォル ト) count 任 意 String 10(デフォル ト) all( 全 件 ) order 任 意 Integer 1: 事 例 区 分 (デフォル ト) 2: 発 生 年 月 3:スコア 各 項 目 間 は and 条 件 とする POST 形 式 でのリクエストも 可 能 取 得 する 結 果 リストの 先 頭 レコー ドを 設 定 一 回 のリクエストで 取 得 する 件 数 を 設 定 検 索 結 果 のソート 順 を 設 定 3:スコアを 選 択 した 場 合 に item へ 入 力 が 無 ければ 自 動 的 にデフォル トのソート 順 となる condition による or or - 4 -
2. リクエストサンプル 検 索 を 行 う 際 のクエリストリングのサンプルについて GET パラメータのサンプル 全 文 検 索 時 検 索 項 目 検 索 指 示 内 容 発 生 要 因 過 労 疲 労 いずれかを 含 む クエリストリング http://www.yakkyoku-hiyari.jcqhc.or.jp/phsearch/searchreportapi.action?item=lstfactor&word=%89%df%98j%20%94%e6%98j&co ndition=any 発 生 要 因 に 過 労 もしくは 疲 労 が 含 まれる 事 例 を 検 索 項 目 検 索 時 1 検 索 項 目 事 例 の 概 要 クエリストリング 検 索 指 示 内 容 調 剤 http://www.yakkyoku-hiyari.jcqhc.or.jp/phsearch/searchreportapi.action?itemcode=0090010&code=08&text= 項 目 検 索 時 2 検 索 項 目 ソート 順 発 生 年 月 クエリストリング 検 索 指 示 内 容 発 生 年 月 順 2010 年 12 月 以 降 http://www.yakkyoku-hiyari.jcqhc.or.jp/phsearch/searchreportapi.action?order=2&fyear=2010&fmonth=12 全 文 + 項 目 検 索 時 検 索 項 目 検 索 指 示 内 容 改 善 策 夜 勤 長 時 間 全 てを 含 む 発 生 年 月 2011 年 1 月 以 降 クエリストリング http://www.yakkyoku-hiyari.jcqhc.or.jp/phsearch/searchreportapi.action?item=datimprovementtext&word=%96%e9%8b%ce%20% 92%b7%8e%9e%8a%d4&condition=all&fyear=2011&fmonth=1 項 目 間 は and 条 件 となる - 5 -
3. 設 定 資 料 XML タグ 名 説 明 指 定 項 目 配 下 で 全 文 検 索 を 行 う 場 合 下 記 XML タグ 名 を 指 定 する 上 位 レベルを 指 定 した 場 合 は 含 まれる 下 記 レベルの 文 字 列 も 検 索 対 象 となる 例 :GRPPATIENT を 指 定 した 場 合 は 配 下 の DATPATIENT, DATPATIENTAGE, DATPATIENTSEX に 含 まれる 文 字 列 も 検 索 対 象 となる CODE の 設 定 値 レヘ ル 0 レヘ ル 1 レヘ ル 2 レヘ ル 3 レヘ ル 4 1 全 体 レヘ ル 5 PHARMACY_REPORT 2 バージョン VERSION 3 発 生 年 DATYEAR 4 発 生 月 DATMONTH 5 発 生 曜 日 DATDAY 6 発 生 時 間 帯 DATTIMEZONE 7 治 療 の 実 施 の 有 無 DATEXECUTION 8 治 療 の 程 度 DATLEVEL 9 事 例 の 概 要 DATSUMMARY 10 患 者 の 数 GRPPATIENT 11 患 者 の 数 DATPATIENT 12 患 者 の 年 齢 DATPATIENTAGE 13 患 者 の 性 別 DATPATIENTSEX 14 発 見 者 DATDISCOVERER 15 当 事 者 LSTCONCERNED 16 当 事 者 職 種 DATCATEGORY 17 調 剤 に 関 する 項 目 GRPCOMPOUND 18 発 生 場 面 DATSCENE 19 事 例 の 内 容 DATCONTENTS 20 医 薬 品 情 報 LSTMEDICINE 21 薬 剤 A GRPMEDICINE_A 22 販 売 名 DATMEDNAME 23 厚 労 省 コード DATMEDCODE 24 製 造 販 売 業 者 名 DATMANNAME 25 薬 剤 B GRPMEDICINE_B 26 販 売 名 DATMEDNAME 27 厚 労 省 コード DATMEDCODE 28 製 造 販 売 業 者 名 DATMANNAME 29 関 連 医 薬 品 情 報 LSTRELATED 30 薬 剤 A GRPMEDICINE_A 31 販 売 名 DATMEDNAME 32 厚 労 省 コード DATMEDCODE 33 製 造 販 売 業 者 名 DATMANNAME 34 疑 義 照 会 に 関 する 項 目 GRPDOUBT 35 処 方 の 通 りに 服 用 した 場 合 の 影 響 DATINFLUENCE item - 6 -
36 疑 義 があると 判 断 した 理 由 DATGROUND 37 変 更 内 容 DATCHANGE 38 医 薬 品 情 報 LSTMEDICINE 39 薬 剤 A GRPMEDICINE_A 40 販 売 名 DATMEDNAME 41 厚 労 省 コード DATMEDCODE 42 製 造 販 売 業 者 名 DATMANNAME 43 薬 剤 B GRPMEDICINE_B 44 販 売 名 DATMEDNAME 45 厚 労 省 コード DATMEDCODE 46 製 造 販 売 業 者 名 DATMANNAME 47 医 薬 品 情 報 LSTRELATED 48 薬 剤 A GRPMEDICINE_A 49 販 売 名 DATMEDNAME 50 厚 労 省 コード DATMEDCODE 51 製 造 販 売 業 者 名 DATMANNAME 52 特 定 保 険 医 療 材 料 に 関 する 項 目 GRPMATERIAL 53 発 生 場 面 DATSCENE 54 事 例 の 内 容 DATCONTENTS 55 医 薬 品 情 報 LSTMEDICINE 56 薬 剤 A GRPMEDICINE_A 57 販 売 名 DATMEDNAME 58 厚 労 省 コード DATMEDCODE 59 製 造 販 売 業 者 名 DATMANNAME 60 薬 剤 B GRPMEDICINE_B 61 販 売 名 DATMEDNAME 62 厚 労 省 コード DATMEDCODE 63 製 造 販 売 業 者 名 DATMANNAME 64 関 連 医 薬 品 情 報 LSTRELATED 65 薬 剤 A GRPMEDICINE_A 66 販 売 名 DATMEDNAME 67 厚 労 省 コード DATMEDCODE 68 製 造 販 売 業 者 名 DATMANNAME 69 医 薬 品 の 販 売 に 関 する 項 目 GRPSALES 70 事 例 の 内 容 DATCONTENTS 71 医 薬 品 情 報 LSTSALES_MEDICINE 72 薬 剤 A GRPMEDICINE_A 73 販 売 名 DATMEDNAME 74 厚 労 省 コード DATMEDCODE 75 製 造 販 売 業 者 名 DATMANNAME 76 分 類 DATCLASSIFICATION 77 発 生 要 因 に 関 する 項 目 LSTFACTOR 78 発 生 要 因 DATFACTOR 79 事 例 の 内 容 DATCONTENTTEXT 80 背 景 要 因 DATFACTORTEXT 81 改 善 策 DATIMPROVEMENTTEXT - 7 -
コード 検 索 説 明 コード 値 にて 検 索 を 行 う 場 合 は itemcode,code に 下 記 コードを 設 定 する 選 択 肢 が 存 在 しない 場 合 は 文 字 列 (パラメータ text に 設 定 )にて 部 分 一 致 検 索 となる CODE の 設 定 値 検 索 対 象 項 目 itemcode 選 択 肢 名 code 又 は 文 字 列 1 発 生 年 0010010 文 字 列 2 発 生 月 0020010 1 月 01 2 月 02 3 月 03 4 月 04 5 月 05 6 月 06 7 月 07 8 月 08 9 月 09 10 月 10 11 月 11 12 月 12 3 発 生 曜 日 0030010 日 曜 日 01 月 曜 日 02 火 曜 日 03 水 曜 日 04 木 曜 日 05 金 曜 日 06 土 曜 日 07 4 発 生 時 間 帯 0040010 0:00~1:59 01 2:00~3:59 03 4:00~5:59 05 6:00~7:59 07 8:00~9:59 09 10:00~11:59 11 12:00~13:59 13 14:00~15:59 15 16:00~17:59 17 18:00~19:59 19 20:00~21:59 21 22:00~23:59 23 不 明 90 5 実 施 の 有 無 0050010 実 施 あり 01 実 施 なし 02 6 治 療 の 程 度 0070010 軽 微 な 治 療 02 治 療 なし 03-8 -
不 明 90 7 事 例 の 概 要 0090010 調 剤 08 疑 義 照 会 09 特 定 保 険 医 療 材 料 10 医 薬 品 の 販 売 11 8 患 者 の 数 患 者 の 数 0120010 1 人 01 複 数 02 患 者 の 年 齢 0120020 文 字 列 患 者 の 性 別 0120030 男 01 女 02 9 発 見 者 発 見 者 0160010 当 事 者 本 人 01 同 職 種 者 02 他 職 種 者 03 患 者 本 人 04 家 族 付 き 添 い 05 他 患 者 06 その 他 99 10 当 事 者 当 事 者 職 種 0170020 薬 剤 師 05 登 録 販 売 者 20 事 務 員 21 その 他 99 11 発 生 場 面 調 剤 0190100 調 剤 100100 内 服 薬 調 剤 100101 外 用 薬 調 剤 100102 注 射 薬 調 剤 100103 その 他 の 調 剤 に 関 する 場 面 100199 管 理 0190110 管 理 110100 内 服 薬 管 理 110201 外 用 薬 管 理 110202 注 射 薬 管 理 110203 その 他 の 管 理 に 関 する 場 面 110299 交 付 0190120 交 付 120100 12 事 例 の 内 容 調 剤 0200100 調 剤 忘 れ 100101 処 方 せん 監 査 間 違 い 100102 秤 量 間 違 い 100103 数 量 間 違 い 100104 分 包 間 違 い 100105 規 格 剤 形 間 違 い 100106 薬 剤 取 違 え 100107 説 明 文 書 の 取 違 え 100108 分 包 紙 の 情 報 間 違 い 100109 薬 袋 の 記 載 間 違 い 100110 規 格 間 違 い 100111-9 -
材 料 の 取 違 え 100112 その 他 100199 管 理 0200110 充 填 間 違 い 110101 異 物 混 入 110102 期 限 切 れ 110103 その 他 110199 交 付 0200120 患 者 間 違 い 120101 説 明 間 違 い 120102 交 付 忘 れ 120103 その 他 120199 商 品 の 販 売 0200130 商 品 間 違 い 130101 説 明 違 い 130102 期 限 切 れ 130103 その 他 130199 13 発 生 要 因 0210010 確 認 を 怠 った 010101 報 告 が 遅 れた( 怠 った) 010103 記 録 などに 不 備 があった 010104 連 携 ができていなかった 010105 患 者 への 説 明 が 不 十 分 であった( 怠 った) 010106 判 断 を 誤 った 010107 知 識 が 不 足 していた 020101 技 術 手 技 が 未 熟 だった 020102 勤 務 状 況 が 繁 忙 だった 020103 通 常 とは 異 なる 身 体 的 条 件 下 にあった 020104 通 常 とは 異 なる 心 理 的 状 況 下 にあった 020105 その 他 020199 コンピュータシステム 020201 医 薬 品 020202 施 設 設 備 020204 諸 物 品 020205 患 者 側 020206 その 他 020299 教 育 訓 練 020301 仕 組 み 020302 ルールの 不 備 020303 その 他 020399 14 仮 に 変 更 前 の 処 4010010 患 者 に 健 康 被 害 があったと 推 測 される 01 方 の 通 りに 服 用 患 者 に 健 康 被 害 が 生 じなかったが 医 師 の 意 02 した 場 合 の 影 響 図 した 薬 効 が 得 られなかったと 推 測 される 15 疑 義 があると 4020010 当 該 処 方 せんのみで 判 断 01 判 断 した 理 由 当 該 処 方 せんと 薬 局 で 管 理 している 情 報 で 判 断 02 上 記 以 外 で 判 断 03 16 変 更 内 容 4030010 薬 剤 変 更 01 用 法 変 更 02-10 -
用 量 変 更 03 分 量 変 更 04 薬 剤 削 除 05 その 他 99 17 分 類 4040010 医 療 用 医 薬 品 01 第 一 類 医 薬 品 02 指 定 第 二 類 医 薬 品 03 第 二 類 医 薬 品 04 第 三 類 医 薬 品 05 18 処 方 された 医 薬 品 ( 調 剤 ) 19 間 違 えた 医 薬 品 ( 調 剤 ) 20 関 連 医 薬 品 ( 調 剤 ) 販 売 名 4050010 文 字 列 製 造 販 売 業 者 名 4050030 文 字 列 厚 労 省 コード 4050040 文 字 列 販 売 名 4060010 文 字 列 製 造 販 売 業 者 名 4060030 文 字 列 厚 労 省 コード 4060040 文 字 列 販 売 名 4070010 文 字 列 製 造 販 売 業 者 名 4070030 文 字 列 厚 労 省 コード 4070040 文 字 列 21 処 方 された 医 薬 品 ( 疑 義 照 会 ) 22 変 更 された 医 薬 品 ( 疑 義 照 会 ) 23 処 方 された 特 定 保 険 医 療 材 料 ( 特 定 保 険 医 療 材 料 ) 24 間 違 えた 特 定 保 険 医 療 材 料 ( 特 定 保 険 医 療 材 料 ) 25 関 連 する 特 定 保 険 医 療 材 料 ( 特 定 保 険 医 療 材 料 ) 26 関 連 医 薬 品 ( 医 薬 品 の 販 売 ) 販 売 名 4080010 文 字 列 製 造 販 売 業 者 名 4080030 文 字 列 厚 労 省 コード 4080040 文 字 列 販 売 名 4090010 文 字 列 製 造 販 売 業 者 名 4090030 文 字 列 厚 労 省 コード 4090040 文 字 列 販 売 名 4100010 文 字 列 製 造 販 売 業 者 名 4100030 文 字 列 厚 労 省 コード 4100040 文 字 列 販 売 名 4110010 文 字 列 製 造 販 売 業 者 名 4110030 文 字 列 厚 労 省 コード 4110040 文 字 列 販 売 名 4120010 文 字 列 製 造 販 売 業 者 名 4120030 文 字 列 厚 労 省 コード 4120040 文 字 列 販 売 名 4130010 文 字 列 製 造 販 売 業 者 名 4130030 文 字 列 厚 労 省 コード 4130040 文 字 列 27 事 例 の 内 容 9010010 文 字 列 28 背 景 要 因 9020010 文 字 列 29 改 善 策 9030010 文 字 列 - 11 -
4. レスポンスフィールド レスポンスXMLの 定 義 は 以 下 の 通 り フィールド 説 明 ResultSet XMLのルートノード 以 下 のアトリビュートを 含 む Total: 検 索 条 件 に 対 する 結 果 件 数 Position: 検 索 結 果 に 対 する 現 在 の 返 却 データの 先 頭 位 置 Count: 現 在 の 返 却 データに 含 まれる 件 数 Status: 検 索 結 果 の 状 態 (0: 正 常 1: 異 常 ) Error エラーメッセージ Pharmacy_report 事 例 の 詳 細 情 報 ( 各 項 目 に 関 してはXML 定 義 参 照 ) - 12 -
5. サンプルレスポンス <?xml version="1.0" encoding="shift_jis" standalone="no"?> <ResultSet count="1" position="0" status="0" total="1"> <PHARMACY_REPORT> <VERSION>1.0</VERSION> <DATYEAR>2009</DATYEAR> <DATMONTH CODE="01" /> <DATDAY CODE="01" /> <DATTIMEZONE CODE="01" /> <DATEXECUTION CODE="01" /> <DATLEVEL CODE="02" /> <DATSUMMARY CODE="08" /> <GRPPATIENT> <DATPATIENT CODE="01" /> <DATPATIENTAGE>24</DATPATIENTAGE> <DATPATIENTSEX CODE="01" /> </GRPPATIENT> <DATDISCOVERER CODE="01" /> <LSTCONCERNED> <DATCATEGORY CODE="05" /> <DATCATEGORY CODE="20" /> </LSTCONCERNED> <GRPCOMPOUND> <DATSCENE CODE="100101" /> <DATCONTENTS CODE="100101" /> <LSTRELATED> <GRPMEDICINE_A> <DATMEDCODE>123456789123</DATMEDCODE> <DATMEDNAME>サンプル 関 連 医 薬 品 販 売 名 </DATMEDNAME> <DATMANNAME>サンプル 関 連 医 薬 品 販 売 会 社 </DATMANNAME> </GRPMEDICINE_A> </LSTRELATED> </GRPCOMPOUND> <LSTFACTOR> <DATFACTOR CODE="010101" /> <DATFACTOR CODE="020101" /> </LSTFACTOR> <DATCONTENTTEXT> 処 方 より 多 めに 調 剤 していた( 事 例 の 内 容 を 記 述 ) </DATCONTENTTEXT> <DATFACTORTEXT> 処 方 箋 の 確 認 を 怠 った( 背 景 要 因 を 記 述 ) </DATFACTORTEXT> <DATIMPROVEMENTTEXT> 落 ち 着 いて 対 処 する( 改 善 策 を 記 述 ) </DATIMPROVEMENTTEXT> </PHARMACY_REPORT> </ResultSet> - 13 -