入院患者医療区分・ADL点数情報

メニュー

更新履歴
概要
テスト方法
リクエスト(POSTリクエスト)サンプル
レスポンスサンプル
リクエスト一覧
レスポンス一覧
Rubyによるリクエストサンプルソース
エラーメッセージ一覧

更新履歴

2026-05-27 「レスポンス一覧」の項目を修正。

2023-10-26 「レスポンス一覧」に項目を追加。

2018-09-25 「レスポンス一覧」に項目を追加。

2018-03-26 「レスポンス一覧」の項目を修正。

2016-04-18 「レスポンス一覧」の項目を修正。

概要

POSTメソッドによる入院患者医療区分およびADL点数情報の取得を行います。

日レセ Ver.4.7.0[第19回パッチ適用] 以降

リクエストおよびレスポンスデータはxml2形式になります。

テスト方法

参考提供されている sample_hspteval_v2.rb 内の変数HOST等を接続環境に合わせます。
sample_hspteval_v2.rb 内の患者番号等を指定します。
ruby sample_hspteval_v2.rb により接続。

リクエスト(POSTリクエスト)サンプル

POST : /api01rv2/hsptevalv2

Content-Type: application/xml

application/xml の場合の文字コードは UTF-8 とします。

<data>
	<private_objects type="record">
		<Patient_ID type="string">40024</Patient_ID>
		<Perform_Month type="string">2013-10</Perform_Month>
	</private_objects>
</data>

処理概要

日レセに設定されている入院患者の医療区分、ADLの詳細内容を返却します。

処理詳細

診療年月の妥当性チェック（未設定の場合は、システム日付を設定）
患者番号の存在チェック

レスポンスサンプル

<xmlio2>
  <private_objects type="record">
    <Information_Date type="string">2013-10-23</Information_Date>
    <Information_Time type="string">15:46:54</Information_Time>
    <Api_Result type="string">00</Api_Result>
    <Api_Result_Message type="string">処理終了</Api_Result_Message>
    <Patient_Information type="record">
      <Patient_ID type="string">40024</Patient_ID>
      <WholeName type="string">テスト　一郎</WholeName>
      <WholeName_inKana type="string">テスト　イチロウ</WholeName_inKana>
      <BirthDate type="string">1925-03-10</BirthDate>
      <Sex type="string">2</Sex>
    </Patient_Information>
    <Admission_Discharge_Date type="array">
      <Admission_Discharge_Date_child type="record">
        <Admission_Date type="string">2013-10-15</Admission_Date>
        <Discharge_Date type="string">2013-10-17</Discharge_Date>
      </Admission_Discharge_Date_child>
      <Admission_Discharge_Date_child type="record">
        <Admission_Date type="string">2013-10-19</Admission_Date>
        <Discharge_Date type="string">9999-12-31</Discharge_Date>
      </Admission_Discharge_Date_child>
    </Admission_Discharge_Date>
    <Perform_Month type="string">2013-10</Perform_Month>
    <Medical_Condition type="array">
      <Medical_Condition_child type="record">
        <Level type="string">2</Level>
        <ID type="string"> 2</ID>
        <Name type="string">　２　尿路感染症に対する治療を実施</Name>
        <Evaluation_Daily type="string">,,,,,,,,,,,,,,1,1,,,,,,,,,,,,,,,</Evaluation_Daily>
      </Medical_Condition_child>
      <Medical_Condition_child type="record">
        <Level type="string">2</Level>
        <ID type="string"> 3</ID>
        <Name type="string">　３　傷病等によりリハビリテーションが必要な状態</Name>
        <Evaluation_Daily type="string">,,,,,,,,,,,,,,,,,,1,1,1,,,,,,,,,,</Evaluation_Daily>
      </Medical_Condition_child>
      <Medical_Condition_child type="record">
        <Level type="string">2</Level>
        <ID type="string">M2</ID>
        <Name type="string">医療区分２の該当有無</Name>
        <Evaluation_Daily type="string">,,,,,,,,,,,,,,1,1,,,1,1,1,,,,,,,,,,</Evaluation_Daily>
      </Medical_Condition_child>
      <Medical_Condition_child type="record">
        <Level type="string">1</Level>
        <ID type="string">M1</ID>
        <Name type="string">医療区分３・２いずれも０（医療区分１）</Name>
        <Evaluation_Daily type="string">,,,,,,,,,,,,,,,,1,,,,,1,1,1,1,1,1,1,1,1,1</Evaluation_Daily>
      </Medical_Condition_child>
    </Medical_Condition>
    <ADL_Score type="array">
      <ADL_Score_child type="record">
        <ID type="string">a</ID>
        <Name type="string">ａ　ベッドの可動性</Name>
        <Evaluation_Daily type="string">,,,,,,,,,,,,,,1,1,1,,1,1,1,1,0,0,0,0,0,0,0,0,0</Evaluation_Daily>
      </ADL_Score_child>
      <ADL_Score_child type="record">
        <ID type="string">b</ID>
        <Name type="string">ｂ　移乗</Name>
        <Evaluation_Daily type="string">,,,,,,,,,,,,,,0,0,0,,0,0,0,0,0,0,0,0,0,0,0,0,0</Evaluation_Daily>
      </ADL_Score_child>
      <ADL_Score_child type="record">
        <ID type="string">c</ID>
        <Name type="string">ｃ　食事</Name>
        <Evaluation_Daily type="string">,,,,,,,,,,,,,,1,1,1,,1,1,1,1,1,1,1,1,1,1,1,1,1</Evaluation_Daily>
      </ADL_Score_child>
      <ADL_Score_child type="record">
        <ID type="string">d</ID>
        <Name type="string">ｄ　トイレの使用</Name>
        <Evaluation_Daily type="string">,,,,,,,,,,,,,,0,0,0,,0,0,0,0,0,0,0,0,0,0,0,0,0</Evaluation_Daily>
      </ADL_Score_child>
    </ADL_Score>
    <Medical_Condition_Level_Daily type="string">,,,,,,,,,,,,,,2,2,1,,2,2,2,1,1,1,1,1,1,1,1,1,1</Medical_Condition_Level_Daily>
    <ADL_Total_Score_Daily type="string">,,,,,,,,,,,,,,2,2,2,,2,2,2,2,1,1,1,1,1,1,1,1,1</ADL_Total_Score_Daily>
    <Patient_Condition type="record">
      <Evaluation_Daily type="string">,,,,,,,,,,,,,,C,C,E,,C,C,C,E,E,E,E,E,E,E,E,E,E</Evaluation_Daily>
      <Evaluation_Difference type="string">,,,,,,,,,,,,,,C,C,C,,B,B,B,B,B,B,B,B,B,B,B,B,B</Evaluation_Difference>
      <Evaluation_Class type="string">,,,,,,,,,,,,,,C,C,C,,B,B,B,B,B,B,B,B,B,B,B,B,B</Evaluation_Class>
    </Patient_Condition>
  </private_objects>
</xmlio2>

リクエスト一覧

番号	項目名	内容	例	備考
1	Patient_ID	患者番号	40024
2	Perform_Month	診療年月	2013-10	未設定時はシステム日付を設定

レスポンス一覧

番号	項目名	内容	例	備考
1	Information_Date	実施日	2013-10-23
2	Information_Time	実施時間	15:46:54
3	Api_Result	結果コード（ゼロ以外エラー）	00
4	Api_Result_Message	エラーメッセージ	処理終了
5	Patient_Information	患者情報
5-1	Patient_ID	患者番号	40024
5-2	WholeName	漢字氏名	テスト　一郎
5-3	WholeName_inKana	カナ氏名	テスト　イチロウ
5-4	BirthDate	生年月日	1925-03-10
5-5	Sex	性別（1:男性、2:女性）	2
6	Admission_Discharge_Date	診療年月にかかる入退院日情報（繰り返し　５）
6-1	Admission_Date	入院日	2013-10-15
6-2	Discharge_Date	退院日	2013-10-17
7	Perform_Month	診療年月	2013-10
8	Medical_Condition	医療区分情報（繰り返し　５５）		変更(2026-05-27)
8-1	Level	医療区分コード（3:医療区分３、 2:医療区分２、 1:医療区分３・２に該当しない場合）	2
8-2	ID	医療区分の項目番号（M3:医療区分３の該当有無、 M2:医療区分２の該当有無、 M1:医療区分１、他...）	2
8-3	Name	医療区分の項目名称	２　尿路感染症に対する治療を実施
8-4	Evaluation_Month	頻度が定められていない項目の状態該当有無を"1"、"0"で返却
8-5	Evaluation_Daily	各日の評価をカンマ区切りで返却（該当する場合は"1"、該当しない場合は"0"）	,,,,,,,,,,,,,,1,1,,,,,,,,,,,,,,,
9	ADL_Score	ADL点数情報（繰り返し　４）
9-1	ID	"a"、"b"、"c"、"d"	a
9-2	Name	評価項目の名称	a　ベッドの可動性
9-3	Evaluation_Daily	各日の点数をカンマ区切りで返却	,,,,,,,,,,,,,,1,1,1,,1,1,1,1,0,0,0,0,0,0,0,0,0
10	Medical_Condition_Level_Daily	日毎の医療区分をカンマ区切りで返却	,,,,,,,,,,,,,,2,2,1,,2,2,2,1,1,1,1,1,1,1,1,1,1
11	ADL_Total_Score_Daily	日毎のADLの合計点数をカンマ区切りで返却	,,,,,,,,,,,,,,2,2,2,,2,2,2,2,1,1,1,1,1,1,1,1,1
12	Patient_Condition	患者の状態評価
12-1	Evaluation_Daily	日毎の患者の状態評価をカンマ区切りで返却	,,,,,,,,,,,,,,C,C,E,,C,C,C,E,E,E,E,E,E,E,E,E,E
12-2	Evaluation_Difference	日レセの入院基本料の区分が患者の状態評価と一致しない場合、日レセの入院基本料の区分をカンマ区切りで返却	,,,,,,,,,,,,,,C,C,C,,B,B,B,B,B,B,B,B,B,B,B,B,B
12-3	Evaluation_Difference	日レセで算定されている入院料の区分を返却	,,,,,,,,,,,,,,C,C,C,,B,B,B,B,B,B,B,B,B,B,B,B,B	追加(2023-10-26)
13	Designr_Total_Score_Daily	DESIGN-Rの合計点（深さの点数は加えない）日毎の点数をカンマ区切りで返却	,,,,,,,,,,,,,,,,0,1,2,,,,,,,,,,,,	追加(2018-09-25)

Rubyによるリクエストサンプルソース

Rubyのバージョンが1.9.2以前の環境の場合、HTTPのバージョン指定を1.1に変更する必要があります。
Rubyのバージョンを確認後、以下のように該当箇所を変更して下さい。

Ruby1.9.2以降の場合
```
Net::HTTP.version_1_2 
```
Ruby1.9.2以前の場合
```
Net::HTTP.version_1_1 
```

Rubyのバージョンが1.9.1以降の環境(日レセ4.8以降の環境)ではソースファイル内の文字コードの指定が必要になります。
サンプルソース内に以下の一行が記述されていることを確認して下さい。

# -*- coding: utf-8 -*-

sample_hspteval_v2.rb

#!/usr/bin/ruby
# -*- coding: utf-8 -*-

#------ 入院患者基本区分・ADL点数情報返却


require 'uri'
require 'net/http'

Net::HTTP.version_1_2

HOST = "localhost"
PORT = "8000"
USER = "ormaster"
PASSWD = "ormaster"
CONTENT_TYPE = "application/xml"

req = Net::HTTP::Post.new("/api01rv2/hsptevalv2")
#
# 1.患者番号        Patient_ID      (REQUIRED)
# 2.診療年月        Perform_Month   (IMPLIED)
#
# REQUIRED : 必須  IMPLIED : 任意
#
BODY = <<EOF

<data>
	<private_objects type="record">
		<Patient_ID type="string">12</Patient_ID>
		<Perform_Month type="string"></Perform_Month>
	</private_objects>
</data>

EOF

req.content_length = BODY.size
req.content_type = CONTENT_TYPE
req.body = BODY
req.basic_auth(USER, PASSWD)
  puts req.body

Net::HTTP.start(HOST, PORT) {|http|
  res = http.request(req)
  puts res.body
}

エラーメッセージ一覧

エラーコード	エラーメッセージ	備考
00	処理終了
01	診療年月の設定に誤りがあります
02	患者番号の設定に誤りがあります
03	入退院情報の取得に失敗しました
04	入院会計情報の取得に失敗しました
05	医療区分・ADL点数情報の取得に失敗しました
06	療養病棟入院基本料が算定されていません	病院の場合
06	有床診療所療養病床入院基本料が算定されていません	有床診療所の場合
89	職員情報が取得できません
	医療機関情報が取得できません
	システム日付が取得できません
	患者番号構成情報が取得できません
	グループ医療機関が不整合です。処理を終了して下さい
	システム項目が設定できません
92	診療年月は平成２４年（２０１２年）４月以降を指定してください
97	送信内容に誤りがあります
98	送信内容の読込ができませんでした
99	ユーザIDが未登録です
それ以外	返却情報の編集でエラーが発生しました