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

患者基本情報の取得

メニュー

更新履歴

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)により該当患者の基本情報取得を行います。

処理詳細

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

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

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

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

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

 

レスポンス一覧

番号項目名内容備考
1Information_Date実施日2015-01-16 
2Information_Time実施時間12:12:42
 
3Api_Result結果コード(ゼロ以外エラー)00 
4Api_Result_Messageエラーメッセージ処理終了 
5Reskey Patient Info 
6Patient_Information患者基本情報  
6-1Patient_ID患者番号00017 
6-2WholeName患者氏名日医 太郎 
6-3WholeName_inKana患者カナ氏名ニチイ タロウ 
6-4BirthDate生年月日1975-01-01 
6-5Sex性別
(1:男性、2:女性)
1 
6-6
HouseHolder_WholeName世帯主名
日医 太郎 
6-7Relationship
続柄
本人
 
6-8Home_Address_Information自宅住所情報  
6-8-1Address_ZipCode郵便番号1130021 
6-8-2WholeAddress1住所1東京都文京区本駒込 
6-8-3WholeAddress2住所26−16−3 
6-8-4PhoneNumber1自宅電話番号03-3333-2222
 
6-8-5PhoneNumber2連絡先電話番号03-3333-1133
 
6-9WorkPlace_Information勤務先情報
 追加
(2016-10-20)
6-9-1WholeName勤務先名てすと 株式会社追加
(2016-10-20)
6-9-2Address_ZipCode郵便番号1130022追加
(2016-10-20)
6-9-3WholeAddress1住所東京都文京区本駒込追加
(2016-10-20)
6-9-4WholeAddress2番地番号5−12−11追加
(2016-10-20)
6-9-5PhoneNumber
電話番号03-3333-2211追加
(2016-10-20)
6-10Contact_Information連絡先情報 追加
(2016-10-20)
6-10-1WholeName連絡先名称
日医 太郎追加
(2016-10-20)
6-10-2Relationship続柄
本人
追加
(2016-10-20)
6-10-3Address_ZipCode
郵便番号
1130021追加
(2016-10-20)
6-10-4WholeAddress1住所
東京都文京区本駒込追加
(2016-10-20)
6-10-5WholeAddress2番地番号6−16−3追加
(2016-10-20)
6-10-6PhoneNumber1電話番号(昼)
03-3333-2222追加
(2016-10-20)
6-10-7PhoneNumber2電話番号(夜)03-3333-1133追加
(2016-10-20)
6-11Home2_Information
帰省先情報 追加
(2016-10-20)
6-11-1WholeName
帰省先名称
実家追加
(2016-10-20)
6-11-2Address_ZipCode郵便番号6900051追加
(2016-10-20)
6-11-3WholeAddress1住所島根県松江市横浜町追加
(2016-10-20)
6-11-4WholeAddress2番地番号1155追加
(2016-10-20)
6-11-5PhoneNumber電話番号0852-22-2222
追加
(2016-10-20)
6-12Contraindication1
禁忌1
禁忌
 
6-13Contraindication2
禁忌2
  
6-14
Allergy1
アレルギー1
アレルギー
 
6-15
Allergy2
アレルギー2
  
6-16
Infection1
感染症1
感染症
 
6-17
Infection2
感染症2
  
6-18
Comment1
コメント1
コメント
 
6-19
Comment2
コメント2
  
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-25FaxNumber FAX番号
 追加
(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-30Discount_Name
割引率
 追加
(2017-04-26)
6-31Condition1
状態番号1
 追加
(2017-04-26)
6-32
Condition1_Name 状態1
 追加
(2017-04-26)
6-33
Condition2
状態番号2
 追加
(2017-04-26)
6-34
Condition2_Name
状態2
 追加
(2017-04-26)
6-35
Condition3
状態番号3
 追加
(2017-04-26)
6-36
Condition3_Name
状態3 追加
(2017-04-26)
6-37
Ic_Code
入金方法区分
 追加
(2017-04-26)
6-38
Ic_Code_Name
入金方法 追加
(2017-04-26)
6-39Community_Cid
地域連携ID
 追加
(2013-12-24)
6-40Community_Cid_Agree
同意フラグ
(True:同意する、False:それ以外)
False
追加
(2013-12-24)
6-41FirstVisit_Date
初回受診日
2014-01-06
追加
(2014-11-25)
6-42LastVisit_Date
最終受診日
 追加
(2014-11-25)
6-43Outpatient_Class
入院中
1
追加
(2014-11-25)
6-44Admission_Date
入院日
2014-06-03
追加
(2014-11-25)
6-45Discharge_Date
退院日
 追加
(2014-11-25)
6-46HealthInsurance_Information保険組合せ情報(繰り返し 20) (2017-04-26 パッチ適用以降 繰り返し 30)
6-46-1Insurance_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-5InsuranceProvider_Class保険の種類(060:国保)060 
6-46-6InsuranceProvider_Number保険者番号138057 
6-46-7InsuranceProvider_WholeName保険の制度名称国保 
6-46-8HealthInsuredPerson_Symbol記号01
 
6-46-9HealthInsuredPerson_Number番号1234567
 
6-46-10HealthInsuredPerson_Continuation継続区分
(1:継続療養、 2:任意継続)
 
 
6-46-11HealthInsuredPerson_Assistance補助区分
(詳細については、「日医標準レセプトソフトデータベーステーブル定義書」を参照して下さい。)
3 
6-46-12HealthInsuredPerson_Assistance_Name
補助区分名称
3割
 
6-46-13RelationToInsuredPerson本人家族区分
(1:本人、 2:家族)
1 
6-46-14HealthInsuredPerson_WholeName被保険者名日医 太郎 
6-46-15Certificate_StartDate適用開始日2010-05-01 
6-46-16Certificate_ExpiredDate適用終了日9999-12-31 
6-46-17Insurance_CheckDate
最終確認日
2014-01-06
追加
(2014-11-25)
6-46-18PublicInsurance_Information公費情報(繰り返し 4)  
6-46-18-1PublicInsurance_Class 公費の種類
019 
6-46-18-2PublicInsurance_Name公費の種類名称
原爆一般
 
6-46-18-3PublicInsurer_Number負担者番号19113760
 
6-46-18-4PublicInsuredPerson_Number受給者番号1234566 
6-46-18-5
Rate_Admission
入院ー負担率(割)
0.00
 
6-46-18-6Money_Admission
入院ー固定額
0
 
6-46-18-7
Rate_Outpatient
外来ー負担率(割)
0.00
 
6-46-18-8
Money_Outpatient
外来ー固定額
0
 
6-46-18-9Certificate_IssuedDate適用開始日2010-05-01 
6-46-18-10Certificate_ExpiredDate適用終了日9999-12-31 
6-46-19Accident_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-47Care_Information
介護情報
 追加
(2014-05-20)
6-47-1
Insurance
介護保険情報(繰り返し 10)
 追加
(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
介護認定情報(繰り返し 50)
 追加
(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
地域包括診療対象疾病(繰り返し 4)
 追加
(2014-05-20)
6-47-3-1
Target_Disease 高血圧症、糖尿病、脂質異常症、認知症の順に内容を表示
(True:対象病名である、False:対象でない)
False
追加
(2014-05-20)

※1
6-48Individual_Number個人番号情報(繰り返し 20) 追加
(2017-01-26)
6-48-1In_IdId_key 追加
(2017-01-26)
6-48-2In_Number個人番号 追加
(2017-01-26)
6-48-3In_Description備考(説明)
 追加
(2017-01-26)

 ※1:高血圧症、糖尿病、脂質異常症、認知症のいずれかに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 患者基本情報

このページのトップへ