入院患者食事等情報
メニュー
更新履歴
2018-03-26 「レスポンス一覧」の項目を修正。
2018-02-26 (Ver5.0.0以降のみ)「レスポンス一覧」に項目を追加。
2016-04-18 「レスポンス一覧」の項目を修正。
概要
POSTメソッドによる入院患者の食事等の情報取得を行います。
日レセ Ver.4.7.0[第19回パッチ適用] 以降
リクエストおよびレスポンスデータはxml2形式になります。
テスト方法
- 参考提供されている sample_hsmeal_v2.rb 内の変数HOST等を接続環境に合わせます。
- sample_hsmeal_v2.rb 内の患者番号等の必要な情報を設定します。
- ruby sample_hsmeal_v2.rb により接続。
リクエスト(POSTリクエスト)サンプル
POST : /api01rv2/hsmealv2
Content-Type: application/xml
application/xml の場合の文字コードは UTF-8 とします。
<data>
<private_objects type="record">
<Patient_ID type="string">12</Patient_ID>
<Perform_Month type="string"></Perform_Month>
</private_objects>
</data>
処理概要
患者番号や診療年月を元に日レセに登録されている該当患者の該当月の食事、外泊、室料差額等のひと月分の情報を返却します。
処理詳細
- 患者番号の存在チェック
- 診療年月日の妥当性チェック(未設定の場合は、システム日付を設定)
日々の保険組合せ情報は、組合せ番号を設定しています。
対応する保険組合せ情報は、最後に出現させています。
レスポンスサンプル
<?xml version="1.0" encoding="UTF-8"?>
<xmlio2>
<private_objects type="record">
<Information_Date type="string">2018-01-31</Information_Date>
<Information_Time type="string">09:21:52</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">00012</Patient_ID>
<WholeName type="string">日医 太郎</WholeName>
<WholeName_inKana type="string">ニチイ タロウ</WholeName_inKana>
<BirthDate type="string">1958-01-10</BirthDate>
<Sex type="string">1</Sex>
</Patient_Information>
<Admission_Discharge_Date type="array">
<Admission_Discharge_Date_child type="record">
<Admission_Date type="string">2018-01-10</Admission_Date>
<Discharge_Date type="string">2018-01-11</Discharge_Date>
</Admission_Discharge_Date_child>
</Admission_Discharge_Date>
<Perform_Month type="string">2018-01</Perform_Month>
<Monthly_Information type="array">
<Monthly_Information_child type="record">
<Perform_Date type="string">2018-01-10</Perform_Date>
<Department_Code type="record">
<Label type="string">診療科</Label>
<Data type="string">01</Data>
<Name type="string">内科</Name>
</Department_Code>
<Ward_Number type="record">
<Label type="string">病棟番号</Label>
<Data type="string">01</Data>
</Ward_Number>
<Ward_Name type="record">
<Label type="string">病棟名</Label>
<Data type="string">北病棟</Data>
</Ward_Name>
<Room_Number type="record">
<Label type="string">病室番号</Label>
<Data type="string">101</Data>
</Room_Number>
<Insurance_Combination_Number type="string">0001</Insurance_Combination_Number>
<Patient_Status type="record">
<Label type="string">外泊・他医療機関受診情報等</Label>
<Data type="string">00</Data>
<Name type="string">入院中</Name>
</Patient_Status>
<Morning_Meal type="record">
<Label type="string">朝食</Label>
<Data type="string">01</Data>
<Name type="string">食事あり</Name>
</Morning_Meal>
<Lunch_Meal type="record">
<Label type="string">昼食</Label>
<Data type="string">01</Data>
<Name type="string">食事あり</Name>
</Lunch_Meal>
<Evening_Meal type="record">
<Label type="string">夕食</Label>
<Data type="string">01</Data>
<Name type="string">食事あり</Name>
</Evening_Meal>
<Room_Charge type="record">
<Label type="string">室料差額</Label>
<Data type="string"> 0</Data>
<Name type="string">円</Name>
</Room_Charge>
<Hospital_Charge_Information type="record">
<Label type="string">入院基本料等</Label>
<Hospital_Charge type="array">
<Hospital_Charge_child type="record">
<Data type="string">190077410</Data>
<Name type="string">一般病棟10対1入院基本料</Name>
</Hospital_Charge_child>
<Hospital_Charge_child type="record">
<Data type="string">190079470</Data>
<Name type="string">一般病棟入院期間加算(14日以内)</Name>
</Hospital_Charge_child>
</Hospital_Charge>
</Hospital_Charge_Information>
<Additional_Hospital_Charge type="array">
<Additional_Hospital_Charge_child type="record">
<Label type="string">入院加算</Label>
<Data type="string">190120510</Data>
<Name type="string">医療安全対策加算1</Name>
</Additional_Hospital_Charge_child>
<Additional_Hospital_Charge_child type="record">
<Label type="string">入院加算</Label>
<Data type="string">190147510</Data>
<Name type="string">患者サポート体制充実加算</Name>
</Additional_Hospital_Charge_child>
</Additional_Hospital_Charge>
</Monthly_Information_child>
<Monthly_Information_child type="record">
<Perform_Date type="string">2018-01-11</Perform_Date>
<Department_Code type="record">
<Label type="string">診療科</Label>
<Data type="string">01</Data>
<Name type="string">内科</Name>
</Department_Code>
<Ward_Number type="record">
<Label type="string">病棟番号</Label>
<Data type="string">01</Data>
</Ward_Number>
<Ward_Name type="record">
<Label type="string">病棟名</Label>
<Data type="string">北病棟</Data>
</Ward_Name>
<Room_Number type="record">
<Label type="string">病室番号</Label>
<Data type="string">101</Data>
</Room_Number>
<Insurance_Combination_Number type="string">0001</Insurance_Combination_Number>
<Patient_Status type="record">
<Label type="string">外泊・他医療機関受診情報等</Label>
<Data type="string">00</Data>
<Name type="string">入院中</Name>
</Patient_Status>
<Morning_Meal type="record">
<Label type="string">朝食</Label>
<Data type="string">01</Data>
<Name type="string">食事あり</Name>
</Morning_Meal>
<Lunch_Meal type="record">
<Label type="string">昼食</Label>
<Data type="string">01</Data>
<Name type="string">食事あり</Name>
</Lunch_Meal>
<Evening_Meal type="record">
<Label type="string">夕食</Label>
<Data type="string">01</Data>
<Name type="string">食事あり</Name>
</Evening_Meal>
<Room_Charge type="record">
<Label type="string">室料差額</Label>
<Data type="string"> 0</Data>
<Name type="string">円</Name>
</Room_Charge>
<Hospital_Charge_Information type="record">
<Label type="string">入院基本料等</Label>
<Hospital_Charge type="array">
<Hospital_Charge_child type="record">
<Data type="string">190077410</Data>
<Name type="string">一般病棟10対1入院基本料</Name>
</Hospital_Charge_child>
<Hospital_Charge_child type="record">
<Data type="string">190079470</Data>
<Name type="string">一般病棟入院期間加算(14日以内)</Name>
</Hospital_Charge_child>
</Hospital_Charge>
</Hospital_Charge_Information>
</Monthly_Information_child>
</Monthly_Information>
<Insurance_Information type="array">
<Insurance_Information_child type="record">
<Insurance_Combination_Number type="string">0001</Insurance_Combination_Number>
<InsuranceProvider_Class type="string">009</InsuranceProvider_Class>
<InsuranceProvider_WholeName type="string">協会</InsuranceProvider_WholeName>
<HealthInsuredPerson_Symbol type="string">99010101</HealthInsuredPerson_Symbol>
<HealthInsuredPerson_Number type="string">990001</HealthInsuredPerson_Number>
</Insurance_Information_child>
</Insurance_Information>
</private_objects>
</xmlio2>
リクエスト一覧
番号 | 項目名 | 内容 | 例 | 備考 |
---|---|---|---|---|
1 | Patient_ID | 患者番号 | 12 | |
2 | Perform_Month | 診療年月 | 2003-01 | 未設定はシステム日付(年月のみ) |
レスポンス一覧
番号 | 項目名 | 内容 | 例 | 備考 |
---|---|---|---|---|
1 | Information_Date | 実施日 | 2013-10-09 | |
2 | Information_Time | 実施時間 | 11:34:22 | |
3 | Api_Result | 結果コード(ゼロ以外エラー) | 00 | |
4 | Api_Result_Message | エラーメッセージ | 処理終了 | |
5 | Patient_Information | 患者情報 | ||
5-1 | Patient_ID | 患者番号 | 00012 | |
5-2 | WholeName | 漢字氏名 | 日医 太郎 | |
5-3 | WholeName_inKana | カナ氏名 | ニチイ タロウ | |
5-4 | BirthDate | 生年月日 | 1975-01-01 | |
5-5 | Sex | 性別 (1:男性、2:女性) | 1 | |
6 | Admission_Discharge_Date | 診療年月にかかる入退院日情報(繰り返し 5) | ||
6-1 | Admission_Date | 入院日 | 2013-10-08 | |
6-2 | Discharge_Date | 退院日 | 2013-10-09 | |
7 | Perform_Month | 診療年月 | 2013-10 | |
8 | Monthly_Information | カレンダー情報(繰り返し 31) | ||
8-1 | Perform_Date | 診療日 | 2013-10-08 | |
8-2 | Department_Code | 診療科情報 | | |
8-2-1 | Label | 内容の名称 | 診療科 | |
8-2-2 | Data | 診療科コード ※1 (01:内科) | 01 | |
8-2-3 | Name | 診療科名称 | 内科 | |
8-3 | Ward_Number | 病棟番号情報 | ||
8-3-1 | Label | 内容の名称 | 病棟番号 | |
8-3-2 | Data | 病棟番号 | 01 | |
8-4 | Ward_Name | 病棟名情報 | ||
8-4-1 | Label | 内容の名称 | 病棟名 | |
8-4-2 | Data | 病棟名 | 北病棟 | |
8-5 | Room_Number | 病室番号情報 | ||
8-5-1 | Label | 内容の名称 | 病室番号 | |
8-5-2 | Data | 病室番号 | 101 | |
8-6 | Insurance_Combination_Number | 保険組合せ番号 | 0002 | |
8-7 | Patient_Status | 外泊・他医療機関受診情報等 | ||
8-7-1 | Label | 内容の名称 | 外泊・他医療機関受診情報等 | |
8-7-2 | Data | コード | 00 | |
8-7-3 | Name | 名称 (コード:名称) (Data:Name) 診療年月が平成30年4月以降の場合 00:入院中 01:外泊 02:治療の為の外泊 03:選定入院中の外泊 04:他医療機関受診40%減算 05:他医療機関受診10%減算 06:他医療機関受診20%減算 08:特定時間退院減算 09:特定曜日入退院減算 13:特定曜日入退院減算+他医療機関受診10%減算 14:他医療機関受診5%減算 15:他医療機関受診35%減算 16:他医療機関受診15%減算 17:特定曜日入退院減算+他医療機関受診5%減算 診療年月が平成30年3月以前の場合 00:入院中 01:外泊 02:治療の為の外泊 03:選定入院中の外泊 04:他医療機関受診40%減算 05:他医療機関受診10%減算 06:他医療機関受診20%減算 08:特定時間退院減算 09:特定曜日入退院減算 13:特定曜日入退院減算+他医療機関受診10%減算 | 入院中 | 変更(2018-03-26) |
8-8 | Morning_Meal | 朝食 | ||
8-8-1 | Label | 内容の名称 | 朝食 | |
8-8-2 | Data | コード | 01 | |
8-8-3 | Name | 名称 (コード:名称) 00:食事なし 01:食事あり 02:食事あり(特別食) 03:食事あり(流動食) | 食事あり | 変更(2016-04-18) |
8-9 | Lunch_Meal | 昼食 | ||
8-9-1 | Label | 内容の名称 | 昼食 | |
8-9-2 | Data | コード | 01 | |
8-9-3 | Name | 名称 (コード:名称) 00:食事なし 01:食事あり 02:食事あり(特別食) 03:食事あり(流動食) | 食事あり | 変更(2016-04-18) |
8-10 | Evening_Meal | 夕食 | ||
8-10-1 | Label | 内容の名称 | 夕食 | |
8-10-2 | Data | コード | 01 | |
8-10-3 | Name | 名称 (コード:名称) 00:食事なし 01:食事あり 02:食事あり(特別食) 03:食事あり(流動食) | 食事あり | 変更(2016-04-18) |
8-11 | Room_Charge | 室料差額情報 | ||
8-11-1 | Label | 内容の名称 | 室料差額 | |
8-11-2 | Data | 室料差額 | 1000 | |
8-11-3 | Name | 単位(円) | 円 | |
8-12 | Hospital_Charge_Information | 入院基本料等情報 | Ver5.0.0以降のみ追加 (2018-02-26) | |
8-12-1 | Label | 内容の名称を返却 | 入院基本料等 | Ver5.0.0以降のみ追加 (2018-02-26) |
8-12-2 | Hospital_Charge | 入院基本料等(繰り返し 最大20) | 初期加算等の注加算も併せて返却します。 Ver5.0.0以降のみ追加 (2018-02-26) | |
8-12-2-1 | Data | 入院基本料等の診療コードを返却 | 190077410 | Ver5.0.0以降のみ追加 (2018-02-26) |
8-12-2-2 | Name | 入院基本料等の名称を返却 | 一般病棟10対1入院基本料 | Ver5.0.0以降のみ追加 (2018-02-26) |
8-13 | Additional_Hospital_Charge | 入院加算(繰り返し 最大20) | Ver5.0.0以降のみ追加 (2018-02-26) | |
8-13-1 | Label | 内容の名称を返却 | 入院加算 | Ver5.0.0以降のみ追加 (2018-02-26) |
8-13-2 | Data | 入院加算の診療コードを返却 | 190172170 | Ver5.0.0以降のみ追加 (2018-02-26) |
8-13-3 | Name | 入院加算の名称を返却 | 診療録管理体制加算1 | Ver5.0.0以降のみ追加 (2018-02-26) |
9 | Insurance_Information | 診療年月の保険組合せ詳細情報(繰り返し 10) | ||
9-1 | Insurance_Combination_Number | 保険組合せ番号 | 0002 | |
9-2 | InsuranceProvider_Class | 保険の種類 | 060 | |
9-3 | InsuranceProvider_Number | 保険者番号 | 138057 | |
9-4 | InsuranceProvider_WholeName | 保険の制度名称 | 国保 | |
9-5 | HealthInsuredPerson_Symbol | 記号 | 01 | |
9-6 | HealthInsuredPerson_Number | 番号 | 123456 | |
9-7 | PublicInsurance_Information | 公費情報(繰り返し 4) | ||
9-7-1 | PublicInsurance_Class | 公費の種類 | 019 | |
9-7-2 | PublicInsurance_Name | 公費の制度名称 | 原爆一般 | |
9-7-3 | PublicInsurer_Number | 負担者番号 | 19113760 | |
9-7-4 | PublicInsuredPerson_Number | 受給者番号 | 1234566 |
※1:システム管理マスタの診療科目情報の診療科コードを参照して下さい。
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 -*-
#!/usr/bin/ruby
# -*- coding: utf-8 -*-
#------ 入院患者食事等情報返却
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/hsmealv2")
#
# 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 | 入院会計情報の取得に失敗しました |
89 | 職員情報が取得できません |
医療機関情報が取得できません | |
システム日付が取得できません | |
患者番号構成情報が取得できません | |
グループ医療機関が不整合です。処理を終了して下さい | |
システム項目が設定できません | |
92 | 診療年月は平成20年(2008年)4月以降を指定してください |
97 | 送信内容に誤りがあります |
98 | 送信内容の読込ができませんでした |
99 | ユーザIDが未登録です |
それ以外 | 返却情報の編集でエラーが発生しました |