- トップ
- 日医標準レセプトソフト ご利用中の方へ
- 技術情報
- 日医標準レセプトソフト API
- 日医標準レセプトソフト 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) |
※１：分娩区分と直接支払制度の項目は産科または産婦人科に入院している女性の患者のみ返却します。
※２：該当患者が特定入院料(a)の算定要件に該当しない場合、算定要件非該当区分に"1”、入院日の入院料には特定入院料(a)を返却します。
※３：入退院登録APIの入院登録リクエスト又は入退院登録画面の入院登録処理で算定した入院加算を返却します。
※４：Meal_Typeの食事の種類区分が”B:変更なし（個別指示）"または"C:個別指示"の場合に返却を行います。
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/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が未登録です |
| それ以外 | 返却情報の編集でエラーが発生しました |