トップ > 日医標準レセプトソフト > 技術情報 > 日医標準レセプトソフト API > 入院患者基本情報

入院患者基本情報（履歴を含む）

メニュー

更新履歴

2018-05-28 （Ver5.0.0以降のみ）「レスポンス一覧」に項目を追加。

2014-08-01 「レスポンス一覧」に項目を追加。
　　　　　　「エラーメッセージ一覧」を追加。

2013-11-26 「レスポンス一覧」の項目名を一部変更。

概要

POSTメソッドにより入院患者の基本情報の取得を行います。

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

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

テスト方法

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

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

POST : /api01rv2/hsptinfv2

Content-Type: application/xml

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

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

処理概要

日レセに設定されている入院患者の基本情報の内容を返却します。

処理詳細

患者番号の存在チェック
入院日の妥当性チェック（未設定の場合は、システム日付を設定）
返却情報は、入退院基本情報の場合最大１００件

基本的に入退院登録業務の登録内容をそのまま返却します。
１レコードは１回の入退歴（入院期間）となります。
複数の入院歴の登録がある場合、新しいものから順に返却を行います。
１回の入院期間中に転科・転棟・転室があった場合、最後の異動分を返却します。
自院歴・他院歴の登録は入院日・退院日・病棟名・初回入院日のみ返却します。
初回入院日は、継続入院の場合に先の入院日を設定します。

レスポンスサンプル

<xmlio2>
  <private_objects type="record">
    <Information_Date type="string">2013-10-24</Information_Date>
    <Information_Time type="string">15:09:43</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">1975-01-01</BirthDate>
      <Sex type="string">1</Sex>
    </Patient_Information>
    <Hospital_Stay_Infomation type="array">
      <Hospital_Stay_Infomation_child type="record">
        <History_Number type="string">001</History_Number>
        <Creation_Type type="record">
          <Label type="string">入院歴作成区分</Label>
          <Data type="string">0</Data>
          <Name type="string">通常登録</Name>
        </Creation_Type>
        <Admission_Date type="string">2013-10-08</Admission_Date>
        <Discharge_Date type="string">2013-10-12</Discharge_Date>
        <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>
        <Department_Code type="record">
          <Label type="string">診療科</Label>
          <Data type="string">10</Data>
          <Name type="string">外科</Name>
        </Department_Code>
        <Doctor type="array">
          <Doctor_child type="record">
            <Label type="string">担当医</Label>
            <Data type="string">10001</Data>
            <Name type="string">日本　一</Name>
          </Doctor_child>
        </Doctor>
        <HealthInsurance_Information type="record">
          <Insurance_Combination_Number type="string">0002</Insurance_Combination_Number>
          <InsuranceProvider_Class type="string">060</InsuranceProvider_Class>
          <InsuranceProvider_Number type="string">138057</InsuranceProvider_Number>
          <InsuranceProvider_WholeName type="string">国保</InsuranceProvider_WholeName>
          <HealthInsuredPerson_Symbol type="string">１２３</HealthInsuredPerson_Symbol>
          <HealthInsuredPerson_Number type="string">４５６</HealthInsuredPerson_Number>
          <PublicInsurance_Information type="array">
            <PublicInsurance_Information_child type="record">
              <PublicInsurance_Class type="string">019</PublicInsurance_Class>
              <PublicInsurance_Name type="string">原爆一般</PublicInsurance_Name>
              <PublicInsurer_Number type="string">19113760</PublicInsurer_Number>
              <PublicInsuredPerson_Number type="string">1234567</PublicInsuredPerson_Number>
            </PublicInsurance_Information_child>
          </PublicInsurance_Information>
        </HealthInsurance_Information>
        <First_Admission_Date type="string">2013-10-08</First_Admission_Date>
        <Moving_From_Nursing type="record">
          <Label type="string">介護からの異動</Label>
          <Data type="string">1</Data>
          <Name type="string">対象外</Name>
        </Moving_From_Nursing>
        <Room_Charge type="record">
          <Label type="string">室料差額</Label>
          <Data type="string">   1000</Data>
          <Name type="string">円</Name>
        </Room_Charge>
        <Over_180days_Hospital_Stay type="record">
          <Label type="string">選定入院</Label>
          <Data type="string">1</Data>
          <Name type="string">選定対象</Name>
        </Over_180days_Hospital_Stay>
        <Hospital_Charge type="record">
          <Label type="string">入院日の入院料</Label>
          <Data type="string">190117710</Data>
          <Name type="string">一般病棟７対１入院基本料</Name>
        </Hospital_Charge>
        <Editing_Hospital_Charge type="record">
          <Label type="string">入院会計</Label>
          <Data type="string">2</Data>
          <Name type="string">入院料を算定する</Name>
        </Editing_Hospital_Charge>
        <Recurring_Billing type="record">
          <Label type="string">定期請求</Label>
          <Data type="string">1</Data>
          <Name type="string">医療機関での設定</Name>
        </Recurring_Billing>
      </Hospital_Stay_Infomation_child>
    </Hospital_Stay_Infomation>
  </private_objects>
</xmlio2>

リクエスト一覧

番号	項目名	内容	例	備考
1	Patient_ID	患者番号	12
2	Admission_Date	入院日	2013-10-08	※１

レスポンス一覧

番号	項目名	内容	例	備考
1	Information_Date	実施日	2013-10-24
2	Information_Time	実施時間	15:09:43
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	Hospital_Stay_Infomation	入退院情報（繰り返し　１００）
6-1	History_Number	履歴番号	001	追加 (2014-08-01)
6-2	Creation_Type	入院歴作成区分
6-2-1	Label	内容の名称	入院歴作成区分
6-2-2	Data	入院歴作成区分コード	0
6-2-3	Name	入院歴作成区分の内容（Data：Name、 0：通常登録、 1：自院歴、 2：他院歴、 3：他院歴(特別な関係にある医療機関)）	通常登録
6-3	Admission_Date	入院日	2013-10-08
6-4	Admission_Meal_Start	入院日の食事開始時間		Ver5.0.0以降のみ追加 (2018-05-28)
6-4-1	Label	内容の名称	入院日の食事開始時間	Ver5.0.0以降のみ追加 (2018-05-28)
6-4-2	Data	入院日の食事開始時間コード	1	Ver5.0.0以降のみ追加 (2018-05-28)
6-4-3	Name	内容（Data：Name 0:食事なし 1:朝食から 2:昼食から 3:夕食から）	朝食から	Ver5.0.0以降のみ追加 (2018-05-28)
6-5	Discharge_Date	退院日	2013-10-12
6-6	Discharge_Type	退院事由
6-6-1	Label	内容の名称	退院事由
6-6-2	Data	退院事由の区分番号	02
6-6-3	Name	退院事由の名称	完治
6-7	Ward_Number	病棟番号
6-7-1	Label	内容の名称	病棟番号
6-7-2	Data	病棟番号情報	01
6-8	Ward_Name	病棟名
6-8-1	Label	内容の名称	病棟名
6-8-2	Data	病棟名	北病棟
6-9	Room_Number	病室番号
6-9-1	Label	内容の名称	病室番号
6-9-2	Data	病室番号	101
6-10	Department_Code	診療科
6-10-1	Label	内容の名称	診療科
6-10-2	Data	診療科コード	10
6-10-3	Name	診療科名称	外科
6-11	Doctor	担当医（繰り返し　３）
6-11-1	Label	内容の名称	担当医
6-11-2	Data	ドクターコード	10001
6-11-3	Name	担当医の氏名	日本　一
6-12	HealthInsurance_Information	保険組合せ情報
6-12-1	Insurance_Combination_Number	保険組合せ番号	0002
6-12-2	InsuranceProvider_Class	保険の種類	060
6-12-3	InsuranceProvider_Number	保険者番号	138057
6-12-4	InsuranceProvider_WholeName	保険の制度名称	国保
6-12-5	HealthInsuredPerson_Symbol	記号	１２３
6-12-6	HealthInsuredPerson_Number	番号	４５６
6-12-7	PublicInsurance_Information	公費情報（繰り返し　４）
6-12-7-1	PublicInsurance_Class	公費の種類	019
6-12-7-2	PublicInsurance_Name	公費の制度名称	原爆一般
6-12-7-3	PublicInsurer_Number	負担者番号	19113760
6-12-7-4	PublicInsuredPerson_Number	受給者番号	1234567
6-13	First_Admission_Date	初回入院日	2013-10-08
6-14	Moving_From_Nursing	介護からの異動
6-14-1	Label	内容の名称	介護からの異動
6-14-2	Data	コード	1
6-14-3	Name	内容（Data：Name、 1：対象外、 2：急性増悪により）	対象外
6-15	Room_Charge	室料差額		変更 (2013-11-26)
6-15-1	Label	内容の名称	室料差額
6-15-2	Data	室料差額	1000
6-15-3	Name	単位（円）	円
6-16	Over_180days_Hospital_Stay	選定入院
6-16-1	Label	内容の名称	選定入院
6-16-2	Data	コード	1
6-16-3	Name	内容（Data：Name、 1：選定対象、 2：選定対象外）	選定対象
6-17	Hospital_Charge	入院日の入院料		※２
6-17-1	Label	内容の名称	入院日の入院料
6-17-2	Data	入院料コード	190117710
6-17-3	Name	入院料名称	一般病棟７対１入院基本料
6-18	Hospital_Charge_NotApplicable	算定要件非該当区分		特定入院料のみ返却　※２ Ver5.0.0以降のみ追加 (2018-05-28)
6-18-1	Label	内容の名称	算定要件非該当区分	Ver5.0.0以降のみ追加 (2018-05-28)
6-18-2	Data	算定要件非該当区分	0	Ver5.0.0以降のみ追加 (2018-05-28)
6-18-3	Name	内容（Data：Name 0:算定要件に該当する患者 1:算定要件に該当しない患者）	算定要件に該当する患者	Ver5.0.0以降のみ追加 (2018-05-28)
6-19	Additional_Hospital_Charge	入院日の入院加算（繰り返し　最大３）		※３ Ver5.0.0以降のみ追加 (2018-05-28)
6-19-1	Label	内容の名称	入院日の入院加算	Ver5.0.0以降のみ追加 (2018-05-28)
6-19-2	Data	入院加算コード	190142970	Ver5.0.0以降のみ追加 (2018-05-28)
6-19-3	Name	入院加算名称	救急・在宅等支援病床初期加算（地域一般入院基本料）	Ver5.0.0以降のみ追加 (2018-05-28)
6-20	Editing_Hospital_Charge	入院会計
6-20-1	Label	内容の名称	入院会計
6-20-2	Data	コード	2
6-20-3	Name	内容（Data：Name、 1：入院料を算定しない、 2：入院料を算定する）	入院料を算定する
6-21	Delivery	分娩区分		※１
6-21-1	Label	内容の名称	分娩区分
6-21-2	Data	コード	0
6-21-3	Name	内容（Data：Name、 0：分娩入院でない、 1：正常分娩、 2：異常分娩）	分娩入院でない
6-22	Direct_Payment	直接支払制度		※１
6-22-1	Label	内容の名称	直接支払制度
6-22-2	Data	コード	1
6-22-3	Name	内容（Data：Name、 0：利用しない、 1：利用する）	利用する
6-23	Recurring_Billing	定期請求
6-23-1	Label	内容の名称	定期請求
6-23-2	Data	コード	1
6-23-3	Name	内容（Data：Name、 1：医療機関での設定、 2：月末時のみ請求、 3：定期請求しない）	医療機関での設定
6-24	Search_Function	検索時患者表示		Ver5.0.0以降のみ追加 (2018-05-28)
6-24-1	Label	内容の名称	検索時患者表示	Ver5.0.0以降のみ追加 (2018-05-28)
6-24-2	Data	検索時患者表示区分	1	Ver5.0.0以降のみ追加 (2018-05-28)
6-24-3	Name	内容（Data：Name 1：表示可 2：表示不可）	表示可	Ver5.0.0以降のみ追加 (2018-05-28)
6-25	Meal_Type	食事の種類		Ver5.0.0以降のみ追加 (2018-05-28)
6-25-1	Label	内容の名称	食事の種類	Ver5.0.0以降のみ追加 (2018-05-28)
6-25-2	Data	食事の種類区分	C	Ver5.0.0以降のみ追加 (2018-05-28)
6-25-3	Name	内容（Data：Name 0:食事なし 1:食事あり 2:食事あり（特別食） 3:食事あり（流動食） A:変更なし B:変更なし（個別指示） C:個別指示）	個別指示	Ver5.0.0以降のみ追加 (2018-05-28)
6-26	Morning_Meal	食事の種類（朝）		※４ Ver5.0.0以降のみ追加 (2018-05-28)
6-26-1	Label	内容の名称	食事の種類（朝）	Ver5.0.0以降のみ追加 (2018-05-28)
6-26-2	Data	食事の種類区分	1	Ver5.0.0以降のみ追加 (2018-05-28)
6-26-3	Name	内容（Data：Name 0:食事なし 1:食事あり 2:食事あり（特別食） 3:食事あり（流動食））	食事あり	Ver5.0.0以降のみ追加 (2018-05-28)
6-27	Lunch_Meal	食事の種類（昼）		※４ Ver5.0.0以降のみ追加 (2018-05-28)
6-27-1	Label	内容の名称	食事の種類（昼）	Ver5.0.0以降のみ追加 (2018-05-28)
6-27-2	Data	食事の種類区分	1	Ver5.0.0以降のみ追加 (2018-05-28)
6-27-3	Name	内容（Data：Name 0:食事なし 1:食事あり 2:食事あり（特別食） 3:食事あり（流動食））	食事あり	Ver5.0.0以降のみ追加 (2018-05-28)
6-28	Evening_Meal	食事の種類（夕）		※４ Ver5.0.0以降のみ追加 (2018-05-28)
6-28-1	Label	内容の名称	食事の種類（夕）	Ver5.0.0以降のみ追加 (2018-05-28)
6-28-2	Data	食事の種類区分	1	Ver5.0.0以降のみ追加 (2018-05-28)
6-28-3	Name	内容（Data：Name 0:食事なし 1:食事あり 2:食事あり（特別食） 3:食事あり（流動食））	食事あり	Ver5.0.0以降のみ追加 (2018-05-28)

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_hsptinf_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/hsptinfv2")
#
# 1.患者番号    Patient_ID      (REQUIRED)
# 2.入院日      Admission_Date  (IMPLIED)
#
# REQUIRED : 必須   IMPLIED : 任意
#
BODY = <<EOF

<data>
	<private_objects type="record">
		<Patient_ID type="string">12</Patient_ID>
		<Admission_Date type="string"></Admission_Date>
	</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	指定された入院日の入院情報が存在しません
89	職員情報が取得できません
	医療機関情報が取得できません
	システム日付が取得できません
	患者番号構成情報が取得できません
	グループ医療機関が不整合です。処理を終了して下さい
	システム項目が設定できません
92	診療年月は平成２０年（２００８年）４月以降を指定してください
97	送信内容に誤りがあります
98	送信内容の読込ができませんでした
99	ユーザIDが未登録です
それ以外	返却情報の編集でエラーが発生しました

トップ > 日医標準レセプトソフト > 技術情報 > 日医標準レセプトソフト API > 入院患者基本情報