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

患者基本情報の取得

メニュー

更新履歴

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

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

2017-04-26 「レスポンス一覧」に項目を追加。
　　　　　　　「レスポンス一覧」の保険組合せ情報の件数を20→30に変更。

2017-03-27 引数（format）を追加。

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

2016-10-20 「レスポンス一覧」に項目を追加。
　　　　　　　「レスポンス一覧」の介護認定情報の件数を10→50に変更。

2015-01-27 労災（自賠、アフターケア）情報を追加。
　　　　　　　「レスポンス一覧」に項目を追加。

2014-11-25 　「レスポンス一覧」に項目を追加。
　　　　　　　「レスポンスサンプル」に「初来院日、最終来院日の情報について」を追加。
　　　　　　　「レスポンスサンプル」に「保険組合せの負担割合情報、保険の最終確認日について」を追加。

2014-07-14 「エラーメッセージ一覧」を追加。

2014-05-20 「レスポンス一覧」に項目を追加。

2013-12-24 「レスポンス一覧」に項目を追加。

概要

GETメソッドによる患者基本情報の取得を行います。

レスポンスデータはxml2形式になります。

テスト方法

以下のURLにアクセスするとAPIとして処理され患者基本情報が返却されます。

http://ホスト名:ポート番号(デフォルト8000)/api01rv2/patientgetv2?id=xxxx　(xxxx:患者番号）

ex)

http://localhost:8000/api01rv2/patientgetv2?id=1233

ver 5.0以降では引数のformatによってJSON形式でも返却を可能とします。

ex)

http://localhost:8000/api01rv2/patientgetv2?id=1233&format=json

レスポンスサンプル

<xmlio2>
  <patientinfores type="record">
    <Information_Date type="string">2015-01-16</Information_Date>
    <Information_Time type="string">12:12:42</Information_Time>
    <Api_Result type="string">00</Api_Result>
    <Api_Result_Message type="string">処理終了</Api_Result_Message>
    <Reskey type="string">Patient Info</Reskey>
    <Patient_Information type="record">
      <Patient_ID type="string">00017</Patient_ID>
      <WholeName type="string">日医　太郎</WholeName>
      <WholeName_inKana type="string">ニチイ　タロウ</WholeName_inKana>
      <BirthDate type="string">1975-01-01</BirthDate>
      <Sex type="string">1</Sex>
      <HouseHolder_WholeName type="string">日医　太郎</HouseHolder_WholeName>
      <Community_Cid_Agree type="string">False</Community_Cid_Agree>
      <FirstVisit_Date type="string">2014-01-06</FirstVisit_Date>
      <LastVisit_Date type="string">2014-06-03</LastVisit_Date>
      <HealthInsurance_Information type="array">
        <HealthInsurance_Information_child type="record">
          <Insurance_Combination_Number type="string">0001</Insurance_Combination_Number>
          <InsuranceCombination_Rate_Admission type="string">0.00</InsuranceCombination_Rate_Admission>
          <InsuranceCombination_Rate_Outpatient type="string">0.00</InsuranceCombination_Rate_Outpatient>
          <InsuranceProvider_Class type="string">971</InsuranceProvider_Class>
          <InsuranceProvider_WholeName type="string">労災保険</InsuranceProvider_WholeName>
          <HealthInsuredPerson_Symbol type="string">短期給付</HealthInsuredPerson_Symbol>
          <HealthInsuredPerson_Number type="string">右手指</HealthInsuredPerson_Number>
          <Certificate_StartDate type="string">2014-08-12</Certificate_StartDate>
          <Certificate_ExpiredDate type="string">9999-12-31</Certificate_ExpiredDate>
          <Accident_Insurance_Information type="record">
            <Accident_Insurance_WholeName type="string">短期給付</Accident_Insurance_WholeName>
            <Disease_Location type="string">右手指</Disease_Location>
            <Disease_Date type="string">2014-08-12</Disease_Date>
            <Accident_Insurance_Number type="string">12345678901</Accident_Insurance_Number>
            <Accident_Class type="string">業務中の災害</Accident_Class>
            <Labor_Station_Code type="string">32101</Labor_Station_Code>
            <Labor_Station_Code_Name type="string">松江</Labor_Station_Code_Name>
            <Liability_Office_Information type="record">
              <L_WholeName type="string">オルカ建設</L_WholeName>
              <Prefecture_Information type="record">
                <P_WholeName type="string">島根</P_WholeName>
                <P_Class type="string">4</P_Class>
                <P_Class_Name type="string">県</P_Class_Name>
              </Prefecture_Information>
              <City_Information type="record">
                <C_WholeName type="string">松江</C_WholeName>
                <C_Class type="string">2</C_Class>
                <C_Class_Name type="string">市</C_Class_Name>
              </City_Information>
            </Liability_Office_Information>
          </Accident_Insurance_Information>
        </HealthInsurance_Information_child>
      </HealthInsurance_Information>
    </Patient_Information>
  </patientinfores>
</xmlio2>

処理概要

引数(id)により該当患者の基本情報取得を行います。

処理詳細

送信された患者番号による患者の存在チェック。

初来院日、最終来院日の情報について

返却項目として初来院日、最終来院日を返却します。
当日が退院日の場合のみ、退院日を設定します。
但し以下の場合は、初回、最終来院日は設定しません。
初回は受診履歴の登録が１件もない場合は設定しません。
最終来院日は、入院日・退院日の設定がある場合は設定しません。
該当患者が入院中の場合は、入院日および入外区分を入院中として返却します。

保険組合せの負担割合情報、保険の最終確認日について

返却項目として保険組合せの負担割合情報を返却します。
設定する内容は、日レセの「21 診療行為」と同等のものとします。
返却項目として保険の最終確認日を返却します。

レスポンス一覧

番号	項目名	内容	例	備考
1	Information_Date	実施日	2015-01-16
2	Information_Time	実施時間	12:12:42
3	Api_Result	結果コード（ゼロ以外エラー）	00
4	Api_Result_Message	エラーメッセージ	処理終了
5	Reskey		Patient Info
6	Patient_Information	患者基本情報
6-1	Patient_ID	患者番号	00017
6-2	WholeName	患者氏名	日医　太郎
6-3	WholeName_inKana	患者カナ氏名	ニチイ　タロウ
6-4	BirthDate	生年月日	1975-01-01
6-5	Sex	性別 (1:男性、2:女性)	1
6-6	HouseHolder_WholeName	世帯主名	日医　太郎
6-7	Relationship	続柄	本人
6-8	Home_Address_Information	自宅住所情報
6-8-1	Address_ZipCode	郵便番号	1130021
6-8-2	WholeAddress1	住所1	東京都文京区本駒込
6-8-3	WholeAddress2	住所2	６−１６−３
6-8-4	PhoneNumber1	自宅電話番号	03-3333-2222
6-8-5	PhoneNumber2	連絡先電話番号	03-3333-1133
6-9	WorkPlace_Information	勤務先情報		追加 (2016-10-20)
6-9-1	WholeName	勤務先名	てすと　株式会社	追加 (2016-10-20)
6-9-2	Address_ZipCode	郵便番号	1130022	追加 (2016-10-20)
6-9-3	WholeAddress1	住所	東京都文京区本駒込	追加 (2016-10-20)
6-9-4	WholeAddress2	番地番号	５−１２−１１	追加 (2016-10-20)
6-9-5	PhoneNumber	電話番号	03-3333-2211	追加 (2016-10-20)
6-10	Contact_Information	連絡先情報		追加 (2016-10-20)
6-10-1	WholeName	連絡先名称	日医　太郎	追加 (2016-10-20)
6-10-2	Relationship	続柄	本人	追加 (2016-10-20)
6-10-3	Address_ZipCode	郵便番号	1130021	追加 (2016-10-20)
6-10-4	WholeAddress1	住所	東京都文京区本駒込	追加 (2016-10-20)
6-10-5	WholeAddress2	番地番号	６−１６−３	追加 (2016-10-20)
6-10-6	PhoneNumber1	電話番号（昼）	03-3333-2222	追加 (2016-10-20)
6-10-7	PhoneNumber2	電話番号（夜）	03-3333-1133	追加 (2016-10-20)
6-11	Home2_Information	帰省先情報		追加 (2016-10-20)
6-11-1	WholeName	帰省先名称	実家	追加 (2016-10-20)
6-11-2	Address_ZipCode	郵便番号	6900051	追加 (2016-10-20)
6-11-3	WholeAddress1	住所	島根県松江市横浜町	追加 (2016-10-20)
6-11-4	WholeAddress2	番地番号	１１５５	追加 (2016-10-20)
6-11-5	PhoneNumber	電話番号	0852-22-2222	追加 (2016-10-20)
6-12	Contraindication1	禁忌１	禁忌
6-13	Contraindication2	禁忌２
6-14	Allergy1	アレルギー１	アレルギー
6-15	Allergy2	アレルギー２
6-16	Infection1	感染症１	感染症
6-17	Infection2	感染症２
6-18	Comment1	コメント１	コメント
6-19	Comment2	コメント２
6-20	TestPatient_Flag	テスト患者区分 (0:患者、1:テスト患者)	0	追加 (2017-05-25)
6-21	Death_Flag	死亡区分 (1:死亡)		追加 (2017-05-25)
6-22	Occupation	職業		追加 (2017-04-26)
6-23	NickName	通称名		追加 (2017-04-26)
6-24	CellularNumber	携帯電話番号		追加 (2017-04-26)
6-25	FaxNumber	ＦＡＸ番号		追加 (2017-04-26)
6-26	EmailAddress	電子メールアドレス		追加 (2017-04-26)
6-27	Reduction_Reason	減免事由番号		追加 (2017-04-26)
6-28	Reduction_Reason_Name	減免事由		追加 (2017-04-26)
6-29	Discount	割引率		追加 (2017-04-26)
6-30	Discount_Name	割引率		追加 (2017-04-26)
6-31	Condition1	状態番号１		追加 (2017-04-26)
6-32	Condition1_Name	状態１		追加 (2017-04-26)
6-33	Condition2	状態番号２		追加 (2017-04-26)
6-34	Condition2_Name	状態２		追加 (2017-04-26)
6-35	Condition3	状態番号３		追加 (2017-04-26)
6-36	Condition3_Name	状態３		追加 (2017-04-26)
6-37	Ic_Code	入金方法区分		追加 (2017-04-26)
6-38	Ic_Code_Name	入金方法		追加 (2017-04-26)
6-39	Community_Cid	地域連携ID		追加 (2013-12-24)
6-40	Community_Cid_Agree	同意フラグ（True：同意する、False：それ以外）	False	追加 (2013-12-24)
6-41	FirstVisit_Date	初回受診日	2014-01-06	追加 (2014-11-25)
6-42	LastVisit_Date	最終受診日		追加 (2014-11-25)
6-43	Outpatient_Class	入院中	1	追加 (2014-11-25)
6-44	Admission_Date	入院日	2014-06-03	追加 (2014-11-25)
6-45	Discharge_Date	退院日		追加 (2014-11-25)
6-46	HealthInsurance_Information	保険組合せ情報(繰り返し　２０）		(2017-04-26 パッチ適用以降繰り返し３０)
6-46-1	Insurance_Combination_Number	保険組合せ番号	0001
6-46-2	InsuranceCombination_Rate_Admission	入院負担割合	0.30	追加 (2014-11-25)
6-46-3	InsuranceCombination_Rate_Outpatient	外来負担割合	0.30	追加 (2014-11-25)
6-46-4	Insurance_Nondisplay	保険組合せ非表示区分 (O:外来非表示、I:入院非表示、N:非表示無し)		追加 (2017-04-26)
6-46-5	InsuranceProvider_Class	保険の種類(060:国保)	060
6-46-6	InsuranceProvider_Number	保険者番号	138057
6-46-7	InsuranceProvider_WholeName	保険の制度名称	国保
6-46-8	HealthInsuredPerson_Symbol	記号	０１
6-46-9	HealthInsuredPerson_Number	番号	１２３４５６７
6-46-10	HealthInsuredPerson_Continuation	継続区分 (1:継続療養、 2:任意継続)
6-46-11	HealthInsuredPerson_Assistance	補助区分 (詳細については、「日医標準レセプトソフトデータベーステーブル定義書」を参照して下さい。)	3
6-46-12	HealthInsuredPerson_Assistance_Name	補助区分名称	３割
6-46-13	RelationToInsuredPerson	本人家族区分 (1:本人、 2:家族)	1
6-46-14	HealthInsuredPerson_WholeName	被保険者名	日医　太郎
6-46-15	Certificate_StartDate	適用開始日	2010-05-01
6-46-16	Certificate_ExpiredDate	適用終了日	9999-12-31
6-46-17	Insurance_CheckDate	最終確認日	2014-01-06	追加 (2014-11-25)
6-46-18	PublicInsurance_Information	公費情報（繰り返し 4）
6-46-18-1	PublicInsurance_Class	公費の種類	019
6-46-18-2	PublicInsurance_Name	公費の種類名称	原爆一般
6-46-18-3	PublicInsurer_Number	負担者番号	19113760
6-46-18-4	PublicInsuredPerson_Number	受給者番号	1234566
6-46-18-5	Rate_Admission	入院ー負担率(割)	0.00
6-46-18-6	Money_Admission	入院ー固定額	0
6-46-18-7	Rate_Outpatient	外来ー負担率(割)	0.00
6-46-18-8	Money_Outpatient	外来ー固定額	0
6-46-18-9	Certificate_IssuedDate	適用開始日	2010-05-01
6-46-18-10	Certificate_ExpiredDate	適用終了日	9999-12-31
6-46-19	Accident_Insurance_Information	労災情報		追加 (2015-01-27)
6-46-19-1	Accident_Insurance_WholeName	労災自賠保険区分	短期給付	追加 (2015-01-27)
6-46-19-2	Disease_Location	傷病の部位	右手指	追加 (2015-01-27)
6-46-19-3	Disease_Date	傷病年月日	2014-08-12	追加 (2015-01-27)
6-46-19-4	Accident_Insurance_Number	労働保険番号	12345678901	追加 (2015-01-27)
6-46-19-5	PensionCertificate_Number	年金証書番号	123456789	追加 (2015-01-27)
6-46-19-6	Accident_Class	災害区分	業務中の災害	追加 (2015-01-27)
6-46-19-7	Labor_Station_Code	労働基準監督署コード	32101	追加 (2015-01-27)
6-46-19-8	Labor_Station_Code_Name	労働基準監督署	松江	追加 (2015-01-27)
6-46-19-9	Liability_Office_Information	事業所情報		追加 (2015-01-27)
6-46-19-9-1	L_WholeName	事業所名称	オルカ建設	追加 (2015-01-27)
6-46-19-9-2	Prefecture_Information	所在地都道府県情報		追加 (2015-01-27)
6-46-19-9-2-1	P_WholeName	都道府県名	島根	追加 (2015-01-27)
6-46-19-9-2-2	P_Class	都道府県コード	4	追加 (2015-01-27)
6-46-19-9-2-3	P_Class_Name	都道府県の区分	県	追加 (2015-01-27)
6-46-19-9-3	City_Information	所在地郡市区情報		追加 (2015-01-27)
6-46-19-9-3-1	C_WholeName	郡市区名	松江	追加 (2015-01-27)
6-46-19-9-3-2	C_Class	郡市区コード	2	追加 (2015-01-27)
6-46-19-9-3-3	C_Class_Name	郡市の区分	市	追加 (2015-01-27)
6-46-19-10	Liability_Insurance_Office_Name	自賠責保険会社名	オルカ自賠責保険	追加 (2015-01-27)
6-46-19-11	PersonalHealthRecord_Number	アフターケア　健康管理手帳番号	1234567890123	追加 (2015-01-27)
6-46-19-12	Damage_Class	アフターケア　損傷区分情報		追加 (2015-01-27)
6-46-19-12-1	D_Code	損傷区分コード	14	追加 (2015-01-27)
6-46-19-12-2	D_WholeName	損傷区分	外傷による末梢神経損傷	追加 (2015-01-27)
6-47	Care_Information	介護情報		追加 (2014-05-20)
6-47-1	Insurance	介護保険情報（繰り返し　１０）		追加 (2014-05-20)
6-47-1-1	InsuranceProvider_Number	保険者番号	123456	追加 (2014-05-20)
6-47-1-2	HealthInsuredPerson_Number	被保険者番号	098765	追加 (2014-05-20)
6-47-1-3	Certificate_StartDate	開始	2014-05-13	追加 (2014-05-20)
6-47-1-4	Certificate_ExpiredDate	終了	2015-12-31	追加 (2014-05-20)
6-47-2	Certification	介護認定情報（繰り返し　５０）		追加 (2014-05-20)変更 (2016-10-20)
6-47-2-1	Need_Care_State_Code	要介護状態コード	11	追加 (2014-05-20)
6-47-2-2	Need_Care_State	要介護状態	要支援	追加 (2014-05-20)
6-47-2-3	Certification_Date	認定日	2014-05-13	追加 (2014-05-20)
6-47-2-4	Certificate_StartDate	開始	2014-05-13	追加 (2014-05-20)
6-47-2-5	Certificate_ExpiredDate	終了	2015-05-12	追加 (2014-05-20)
6-47-3	Community_Disease	地域包括診療対象疾病（繰り返し　４）		追加 (2014-05-20)
6-47-3-1	Target_Disease	高血圧症、糖尿病、脂質異常症、認知症の順に内容を表示（True：対象病名である、False：対象でない）	False	追加 (2014-05-20) ※１
6-48	Personally_Information	患者個別情報		Ver5.0.0以降のみ追加 (2018-03-26)
6-48-1	Pregnant_Class	妊婦区分		Ver5.0.0以降のみ追加 (2018-03-26)
6-49	Individual_Number	個人番号情報（繰り返し　２０）		追加 (2017-01-26)
6-49-1	In_Id	Id_key		追加 (2017-01-26)
6-49-2	In_Number	個人番号		追加 (2017-01-26)
6-49-3	In_Description	備考（説明）		追加 (2017-01-26)

※１：高血圧症、糖尿病、脂質異常症、認知症のいずれかにTrueが存在する場合のみ表示します。

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 
```

sample_patientget_v2.rb (xml2)

#!/usr/bin/ruby

require 'uri'
require 'net/http'

Net::HTTP.version_1_2
HOST = "localhost"
PORT = "8000"
USER = "ormaster"
PASSWD = "ormaster"
ID = ARGV[0]

req = Net::HTTP::Get.new("/api01rv2/patientgetv2?id=#{ID}")

req.basic_auth(USER, PASSWD)

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

C#による患者基本情報の取得サンプルソース

Windowsでの実行環境

Microsoft Visual Studio 2008以降
.NET Framework 2.0 SDK(C#コンパイラを含む.NET Frameworkの開発ツール)
(Microsoft Visual Studioに含まれています)

Ubuntuでの実行環境

MonoDevelop 2.2(1.0でも実行可能)
mono-gmcs(C#コンパイラ)
(MonoDevelopと一緒にインストールされます)

sample_patientget_v2.cs (xml2)

using System;
using System.IO;
using System.Net;
using System.Text;

namespace Patientget
{
	class MainClass
	{
		public static void Main (string[] args)
		{
			string HOST = "localhost";
			string PORT = "8000";
			string USER = "ormaster";
			string PASSWD = "ormaster";
			string ID = "0";
			
            		if (args.Length > 0)
            		{
                		ID = args[0];
            		}

			// Version4.7
			string URL = "http://" + HOST + ":" + PORT + "/api01rv2/patientgetv2?id=" + ID;
			
			HttpWebRequest req = (HttpWebRequest) HttpWebRequest.Create(URL);
			//req.ProtocolVersion = HttpVersion.Version11;
			
			req.Method = "GET";
			req.Credentials = new NetworkCredential(USER, PASSWD);
			
			HttpWebResponse res = null;
			try
			{
				res = (HttpWebResponse) req.GetResponse();
				
				Console.WriteLine(res.ResponseUri);
				Console.WriteLine("Response server => {0}", res.Server);
				Console.WriteLine(res.StatusDescription);
			}
			catch(WebException wex)
			{
				if (wex.Status == WebExceptionStatus.ProtocolError)
				{
					HttpWebResponse err = (HttpWebResponse) wex.Response;
					
					int errcode = (int) err.StatusCode;
					
					Console.WriteLine(err.ResponseUri);
					Console.WriteLine("Response server => {0}", err.Server);
					Console.WriteLine("{0}:{1}", errcode, err.StatusDescription);
					
					err.Close();
				}
				else
				{
					Console.WriteLine(wex.Message);
				}
			}
				
			if (res != null)
			{
				Stream str = res.GetResponseStream();
				StreamReader strread = new StreamReader(str);
			
				string FILE_NAME = "foo.xml";
				File.WriteAllText(FILE_NAME, strread.ReadToEnd());
					
				strread.Close();
				str.Close();
				res.Close();
			}
		}
	}
}

エラーメッセージ一覧

エラーコード	エラーメッセージ
01	患者番号の設定がありません
10	患者番号に該当する患者が存在しません
89	職員情報が取得できません
	医療機関情報が取得できません
	システム日付が取得できません
	患者番号構成情報が取得できません
	グループ医療機関が不整合です。処理を終了して下さい
	システム項目が設定できません
90	他端末使用中
91	処理区分未設定
97	送信内容に誤りがあります
98	送信内容の読込ができませんでした
99	ユーザID未登録

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