入院患者食事等情報

メニュー

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

更新履歴

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">一般病棟１０対１入院基本料</Name>
            </Hospital_Charge_child>
            <Hospital_Charge_child type="record">
              <Data type="string">190079470</Data>
              <Name type="string">一般病棟入院期間加算（１４日以内）</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">医療安全対策加算１</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">一般病棟１０対１入院基本料</Name>
            </Hospital_Charge_child>
            <Hospital_Charge_child type="record">
              <Data type="string">190079470</Data>
              <Name type="string">一般病棟入院期間加算（１４日以内）</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">９９０１０１０１</HealthInsuredPerson_Symbol>
        <HealthInsuredPerson_Number type="string">９９０００１</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	診療年月にかかる入退院日情報（繰り返し５）
6-1	Admission_Date	入院日	2013-10-08
6-2	Discharge_Date	退院日	2013-10-09
7	Perform_Month	診療年月	2013-10
8	Monthly_Information	カレンダー情報（繰り返し３１）
8-1	Perform_Date	診療日	2013-10-08
8-2	Department_Code	診療科情報
8-2-1	Label	内容の名称	診療科
8-2-2	Data	診療科コード ※１（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:他医療機関受診４０％減算　05:他医療機関受診１０％減算　06:他医療機関受診２０％減算　08:特定時間退院減算　09:特定曜日入退院減算　13:特定曜日入退院減算＋他医療機関受診１０％減算　14:他医療機関受診５％減算　15:他医療機関受診３５％減算　16:他医療機関受診１５％減算　17:特定曜日入退院減算＋他医療機関受診５％減算診療年月が平成30年3月以前の場合　00:入院中　01:外泊　02:治療の為の外泊　03:選定入院中の外泊　04:他医療機関受診４０％減算　05:他医療機関受診１０％減算　06:他医療機関受診２０％減算　08:特定時間退院減算　09:特定曜日入退院減算　13:特定曜日入退院減算＋他医療機関受診１０％減算	入院中	変更(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	入院基本料等（繰り返し　最大２０）		初期加算等の注加算も併せて返却します。 Ver5.0.0以降のみ追加 (2018-02-26)
8-12-2-1	Data	入院基本料等の診療コードを返却	190077410	Ver5.0.0以降のみ追加 (2018-02-26)
8-12-2-2	Name	入院基本料等の名称を返却	一般病棟１０対１入院基本料	Ver5.0.0以降のみ追加 (2018-02-26)
8-13	Additional_Hospital_Charge	入院加算（繰り返し　最大２０）		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	入院加算の名称を返却	診療録管理体制加算１	Ver5.0.0以降のみ追加 (2018-02-26)
9	Insurance_Information	診療年月の保険組合せ詳細情報（繰り返し１０）
9-1	Insurance_Combination_Number	保険組合せ番号	0002
9-2	InsuranceProvider_Class	保険の種類	060
9-3	InsuranceProvider_Number	保険者番号	138057
9-4	InsuranceProvider_WholeName	保険の制度名称	国保
9-5	HealthInsuredPerson_Symbol	記号	０１
9-6	HealthInsuredPerson_Number	番号	１２３４５６
9-7	PublicInsurance_Information	公費情報（繰り返し４）
9-7-1	PublicInsurance_Class	公費の種類	019
9-7-2	PublicInsurance_Name	公費の制度名称	原爆一般
9-7-3	PublicInsurer_Number	負担者番号	19113760
9-7-4	PublicInsuredPerson_Number	受給者番号	1234566

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_hsmeal_v2.rb

#!/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	診療年月は平成２０年（２００８年）４月以降を指定してください
97	送信内容に誤りがあります
98	送信内容の読込ができませんでした
99	ユーザIDが未登録です
それ以外	返却情報の編集でエラーが発生しました